PlatformAPI.getLinkPreview

fixtures/unfurlLink.json

@@ -0,0 +1,33 @@
+{
+  "ok": true,
+  "attachments": {
+    "https://texts.com/": {
+      "from_url": "https://texts.com/",
+      "title": "Texts",
+      "title_link": "https://texts.com/",
+      "text": "The ultimate messaging app",
+      "image_url": "https://texts.com/ogcover.png",
+      "image_width": 500,
+      "image_height": 250,
+      "image_bytes": 139283,
+      "fallback": "Texts",
+      "service_icon": "https://texts.com/favicon.ico",
+      "service_name": "texts.com",
+      "id": 1,
+      "original_url": "https://texts.com/"
+    }
+  },
+  "response_metadata": {
+    "scopes": [
+      "identify",
+      "read",
+      "post",
+      "client",
+      "apps",
+      "admin"
+    ],
+    "acceptedScopes": [
+      "read"
+    ]
+  }
+}

src/api.ts

@@ -1,6 +1,6 @@
-import { InboxName, PaginationArg, Paginated, Thread, Message, PlatformAPI, OnServerEventCallback, LoginResult, ReAuthError, ActivityType, MessageContent, AccountInfo, CustomEmojiMap, ServerEventType, LoginCreds, texts, NotificationsInfo } from '@textshq/platform-sdk'
+import { InboxName, PaginationArg, Paginated, Thread, Message, PlatformAPI, OnServerEventCallback, LoginResult, ReAuthError, ActivityType, MessageContent, AccountInfo, CustomEmojiMap, ServerEventType, LoginCreds, texts, NotificationsInfo, MessageLink } from '@textshq/platform-sdk'
 import { CookieJar } from 'tough-cookie'
-import { mapCurrentUser, mapThreads, mapMessage, mapParticipant } from './mappers'
+import { mapCurrentUser, mapThreads, mapMessage, mapParticipant, mapLinkAttachment } from './mappers'
 import { MESSAGE_REPLY_THREAD_PREFIX } from './constants'
 import { textsTime } from './util'
 
@@ -217,6 +217,12 @@ export default class Slack implements PlatformAPI {
     }
   }
 
+  getLinkPreview = async (link: string): Promise<MessageLink> => {
+    const res = await this.api.unfurlLink(link)
+    const att = res.attachments[link]
+    if (att) return mapLinkAttachment(att)
+  }
+
   sendReadReceipt = (threadID: string, messageID: string) =>
     this.api.sendReadReceipt(threadID, messageID)
 

src/lib/slack.ts

@@ -461,6 +461,9 @@ export default class SlackAPI {
     await this.webClient.conversations.mark({ channel: threadID, ts: messageID })
   }
 
+  unfurlLink = (link: string) =>
+    this.webClient.apiCall('chat.unfurlLink', { url: link })
+
   addReaction = async (channel: string, timestamp: string, reactionKey: string) => {
     const name = emojiToShortcode(reactionKey) || reactionKey
     await this.webClient.reactions.add({ name, channel, timestamp })

src/mappers.ts

@@ -181,7 +181,7 @@ const ACTION_MESSAGE_TYPES = new Set([
   'joiner_notification_for_inviter',
 ])
 
-const mapLinkAttachment = ({
+export const mapLinkAttachment = ({
   title,
   title_link,
   text,