@larksuite/openclaw-lark 2026.3.9

package/src/messaging/converters/content-converter.js

@@ -0,0 +1,107 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Content converter for Feishu messages.
+ *
+ * Each message type (text, post, image, etc.) has a dedicated converter
+ * function that parses raw JSON content into an AI-friendly text
+ * representation plus a list of resource descriptors.
+ *
+ * This module is a general-purpose message parsing utility — usable
+ * from inbound handling, outbound formatting, and skills.
+ */
+import { converters } from './index';
+import { escapeRegExp } from './utils';
+import { getUserNameCache } from '../inbound/user-name-cache';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/** 从 mention 的 id 字段提取 open_id（兼容事件推送的对象格式和 API 响应的字符串格式） */
+export function extractMentionOpenId(id) {
+    if (typeof id === 'string')
+        return id;
+    if (id != null && typeof id === 'object' && 'open_id' in id) {
+        const openId = id.open_id;
+        return typeof openId === 'string' ? openId : '';
+    }
+    return '';
+}
+// ---------------------------------------------------------------------------
+// Convert
+// ---------------------------------------------------------------------------
+/**
+ * Convert raw message content using the converter for the given message
+ * type. Falls back to the "unknown" converter for unrecognised types.
+ *
+ * Returns a Promise because some converters (e.g. merge_forward) perform
+ * async operations. Synchronous converters are awaited transparently.
+ */
+export async function convertMessageContent(raw, messageType, ctx) {
+    const fn = converters.get(messageType) ?? converters.get('unknown');
+    if (!fn) {
+        return { content: raw, resources: [] };
+    }
+    return fn(raw, ctx);
+}
+// ---------------------------------------------------------------------------
+// ConvertContext from API item
+// ---------------------------------------------------------------------------
+/**
+ * Build a {@link ConvertContext} from a raw Feishu API message item.
+ *
+ * Extracts the `mentions` array that the IM API returns on each message
+ * item and maps it into the key→MentionInfo / openId→MentionInfo
+ * structures the converter system expects.
+ */
+export function buildConvertContextFromItem(item, fallbackMessageId, accountId) {
+    const mentions = new Map();
+    const mentionsByOpenId = new Map();
+    for (const m of item.mentions ?? []) {
+        const openId = extractMentionOpenId(m.id);
+        if (!openId)
+            continue;
+        const info = {
+            key: m.key,
+            openId,
+            name: m.name ?? '',
+            isBot: false,
+        };
+        mentions.set(m.key, info);
+        mentionsByOpenId.set(openId, info);
+    }
+    return {
+        mentions,
+        mentionsByOpenId,
+        messageId: item.message_id ?? fallbackMessageId,
+        accountId,
+        resolveUserName: accountId ? (openId) => getUserNameCache(accountId).get(openId) : undefined,
+    };
+}
+// ---------------------------------------------------------------------------
+// Mention resolution helper
+// ---------------------------------------------------------------------------
+/**
+ * Resolve mention placeholders in text.
+ *
+ * - Bot mentions: remove the placeholder key and any preceding `@botName`
+ *   entirely (with trailing whitespace).
+ * - Non-bot mentions: replace the placeholder key with readable `@name`.
+ */
+export function resolveMentions(text, ctx) {
+    if (ctx.mentions.size === 0)
+        return text;
+    let result = text;
+    for (const [key, info] of ctx.mentions) {
+        if (info.isBot && ctx.stripBotMentions) {
+            // 仅在事件推送场景才删除 bot mention
+            result = result.replace(new RegExp(`@${escapeRegExp(info.name)}\\s*`, 'g'), '').trim();
+            result = result.replace(new RegExp(escapeRegExp(key) + '\\s*', 'g'), '').trim();
+        }
+        else {
+            result = result.replace(new RegExp(escapeRegExp(key), 'g'), `@${info.name}`);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=content-converter.js.map

package/src/messaging/converters/content-converter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-converter.js","sourceRoot":"","sources":["../../../../src/messaging/converters/content-converter.ts"],"names":[],"mappings":"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"}

package/src/messaging/converters/file.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Converter for "file" message type.
+ */
+import type { ContentConverterFn } from './types';
+export declare const convertFile: ContentConverterFn;
+//# sourceMappingURL=file.d.ts.map

package/src/messaging/converters/file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../../../src/messaging/converters/file.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAGlD,eAAO,MAAM,WAAW,EAAE,kBAoBzB,CAAC"}

package/src/messaging/converters/file.js

@@ -0,0 +1,21 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Converter for "file" message type.
+ */
+import { safeParse } from './utils';
+export const convertFile = (raw) => {
+    const parsed = safeParse(raw);
+    const fileKey = parsed?.file_key;
+    if (!fileKey) {
+        return { content: '[file]', resources: [] };
+    }
+    const fileName = parsed?.file_name ?? '';
+    const nameAttr = fileName ? ` name="${fileName}"` : '';
+    return {
+        content: `<file key="${fileKey}"${nameAttr}/>`,
+        resources: [{ type: 'file', fileKey, fileName: fileName || undefined }],
+    };
+};
+//# sourceMappingURL=file.js.map

package/src/messaging/converters/file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.js","sourceRoot":"","sources":["../../../../src/messaging/converters/file.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC,MAAM,CAAC,MAAM,WAAW,GAAuB,CAAC,GAAG,EAAE,EAAE;IACrD,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAKf,CAAC;IAEd,MAAM,OAAO,GAAG,MAAM,EAAE,QAAQ,CAAC;IACjC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;IAC9C,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,EAAE,SAAS,IAAI,EAAE,CAAC;IACzC,MAAM,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC,UAAU,QAAQ,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAEvD,OAAO;QACL,OAAO,EAAE,cAAc,OAAO,IAAI,QAAQ,IAAI;QAC9C,SAAS,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,IAAI,SAAS,EAAE,CAAC;KACxE,CAAC;AACJ,CAAC,CAAC"}

package/src/messaging/converters/folder.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Converter for "folder" message type.
+ */
+import type { ContentConverterFn } from './types';
+export declare const convertFolder: ContentConverterFn;
+//# sourceMappingURL=folder.d.ts.map

package/src/messaging/converters/folder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"folder.d.ts","sourceRoot":"","sources":["../../../../src/messaging/converters/folder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAGlD,eAAO,MAAM,aAAa,EAAE,kBAoB3B,CAAC"}

package/src/messaging/converters/folder.js

@@ -0,0 +1,21 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Converter for "folder" message type.
+ */
+import { safeParse } from './utils';
+export const convertFolder = (raw) => {
+    const parsed = safeParse(raw);
+    const fileKey = parsed?.file_key;
+    if (!fileKey) {
+        return { content: '[folder]', resources: [] };
+    }
+    const fileName = parsed?.file_name ?? '';
+    const nameAttr = fileName ? ` name="${fileName}"` : '';
+    return {
+        content: `<folder key="${fileKey}"${nameAttr}/>`,
+        resources: [{ type: 'file', fileKey, fileName: fileName || undefined }],
+    };
+};
+//# sourceMappingURL=folder.js.map

package/src/messaging/converters/folder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"folder.js","sourceRoot":"","sources":["../../../../src/messaging/converters/folder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC,MAAM,CAAC,MAAM,aAAa,GAAuB,CAAC,GAAG,EAAE,EAAE;IACvD,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAKf,CAAC;IAEd,MAAM,OAAO,GAAG,MAAM,EAAE,QAAQ,CAAC;IACjC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;IAChD,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,EAAE,SAAS,IAAI,EAAE,CAAC;IACzC,MAAM,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC,UAAU,QAAQ,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAEvD,OAAO;QACL,OAAO,EAAE,gBAAgB,OAAO,IAAI,QAAQ,IAAI;QAChD,SAAS,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,IAAI,SAAS,EAAE,CAAC;KACxE,CAAC;AACJ,CAAC,CAAC"}

package/src/messaging/converters/hongbao.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Converter for "hongbao" (red packet) message type.
+ */
+import type { ContentConverterFn } from './types';
+export declare const convertHongbao: ContentConverterFn;
+//# sourceMappingURL=hongbao.d.ts.map

package/src/messaging/converters/hongbao.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hongbao.d.ts","sourceRoot":"","sources":["../../../../src/messaging/converters/hongbao.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAGlD,eAAO,MAAM,cAAc,EAAE,kBAc5B,CAAC"}

package/src/messaging/converters/hongbao.js

@@ -0,0 +1,17 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Converter for "hongbao" (red packet) message type.
+ */
+import { safeParse } from './utils';
+export const convertHongbao = (raw) => {
+    const parsed = safeParse(raw);
+    const text = parsed?.text;
+    const textAttr = text ? ` text="${text}"` : '';
+    return {
+        content: `<hongbao${textAttr}/>`,
+        resources: [],
+    };
+};
+//# sourceMappingURL=hongbao.js.map

package/src/messaging/converters/hongbao.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hongbao.js","sourceRoot":"","sources":["../../../../src/messaging/converters/hongbao.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC,MAAM,CAAC,MAAM,cAAc,GAAuB,CAAC,GAAG,EAAE,EAAE;IACxD,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAIf,CAAC;IAEd,MAAM,IAAI,GAAG,MAAM,EAAE,IAAI,CAAC;IAC1B,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,UAAU,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAE/C,OAAO;QACL,OAAO,EAAE,WAAW,QAAQ,IAAI;QAChC,SAAS,EAAE,EAAE;KACd,CAAC;AACJ,CAAC,CAAC"}

package/src/messaging/converters/image.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Converter for "image" message type.
+ */
+import type { ContentConverterFn } from './types';
+export declare const convertImage: ContentConverterFn;
+//# sourceMappingURL=image.d.ts.map

package/src/messaging/converters/image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image.d.ts","sourceRoot":"","sources":["../../../../src/messaging/converters/image.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAGlD,eAAO,MAAM,YAAY,EAAE,kBAY1B,CAAC"}

package/src/messaging/converters/image.js

@@ -0,0 +1,19 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Converter for "image" message type.
+ */
+import { safeParse } from './utils';
+export const convertImage = (raw) => {
+    const parsed = safeParse(raw);
+    const imageKey = parsed?.image_key;
+    if (!imageKey) {
+        return { content: '[image]', resources: [] };
+    }
+    return {
+        content: `![image](${imageKey})`,
+        resources: [{ type: 'image', fileKey: imageKey }],
+    };
+};
+//# sourceMappingURL=image.js.map

package/src/messaging/converters/image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image.js","sourceRoot":"","sources":["../../../../src/messaging/converters/image.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC,MAAM,CAAC,MAAM,YAAY,GAAuB,CAAC,GAAG,EAAE,EAAE;IACtD,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAuC,CAAC;IACpE,MAAM,QAAQ,GAAG,MAAM,EAAE,SAAS,CAAC;IAEnC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;IAC/C,CAAC;IAED,OAAO;QACL,OAAO,EAAE,YAAY,QAAQ,GAAG;QAChC,SAAS,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;KAClD,CAAC;AACJ,CAAC,CAAC"}

package/src/messaging/converters/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Content converter mapping for all Feishu message types.
+ */
+import type { ContentConverterFn } from './types';
+export declare const converters: ReadonlyMap<string, ContentConverterFn>;
+//# sourceMappingURL=index.d.ts.map

package/src/messaging/converters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/messaging/converters/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAqBlD,eAAO,MAAM,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,kBAAkB,CAwB7D,CAAC"}

package/src/messaging/converters/index.js

@@ -0,0 +1,51 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Content converter mapping for all Feishu message types.
+ */
+import { convertText } from './text';
+import { convertPost } from './post';
+import { convertImage } from './image';
+import { convertFile } from './file';
+import { convertAudio } from './audio';
+import { convertVideo } from './video';
+import { convertSticker } from './sticker';
+import { convertInteractive } from './interactive/index';
+import { convertShareChat, convertShareUser } from './share';
+import { convertLocation } from './location';
+import { convertMergeForward } from './merge-forward';
+import { convertFolder } from './folder';
+import { convertSystem } from './system';
+import { convertHongbao } from './hongbao';
+import { convertShareCalendarEvent, convertCalendar, convertGeneralCalendar } from './calendar';
+import { convertVideoChat } from './video-chat';
+import { convertTodo } from './todo';
+import { convertVote } from './vote';
+import { convertUnknown } from './unknown';
+export const converters = new Map([
+    ['text', convertText],
+    ['post', convertPost],
+    ['image', convertImage],
+    ['file', convertFile],
+    ['audio', convertAudio],
+    ['video', convertVideo],
+    ['media', convertVideo],
+    ['sticker', convertSticker],
+    ['interactive', convertInteractive],
+    ['share_chat', convertShareChat],
+    ['share_user', convertShareUser],
+    ['location', convertLocation],
+    ['merge_forward', convertMergeForward],
+    ['folder', convertFolder],
+    ['system', convertSystem],
+    ['hongbao', convertHongbao],
+    ['share_calendar_event', convertShareCalendarEvent],
+    ['calendar', convertCalendar],
+    ['general_calendar', convertGeneralCalendar],
+    ['video_chat', convertVideoChat],
+    ['todo', convertTodo],
+    ['vote', convertVote],
+    ['unknown', convertUnknown],
+]);
+//# sourceMappingURL=index.js.map

package/src/messaging/converters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/messaging/converters/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,yBAAyB,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAChG,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAE3C,MAAM,CAAC,MAAM,UAAU,GAA4C,IAAI,GAAG,CAAC;IACzE,CAAC,MAAM,EAAE,WAAW,CAAC;IACrB,CAAC,MAAM,EAAE,WAAW,CAAC;IACrB,CAAC,OAAO,EAAE,YAAY,CAAC;IACvB,CAAC,MAAM,EAAE,WAAW,CAAC;IACrB,CAAC,OAAO,EAAE,YAAY,CAAC;IACvB,CAAC,OAAO,EAAE,YAAY,CAAC;IACvB,CAAC,OAAO,EAAE,YAAY,CAAC;IACvB,CAAC,SAAS,EAAE,cAAc,CAAC;IAC3B,CAAC,aAAa,EAAE,kBAAkB,CAAC;IACnC,CAAC,YAAY,EAAE,gBAAgB,CAAC;IAChC,CAAC,YAAY,EAAE,gBAAgB,CAAC;IAChC,CAAC,UAAU,EAAE,eAAe,CAAC;IAC7B,CAAC,eAAe,EAAE,mBAAmB,CAAC;IACtC,CAAC,QAAQ,EAAE,aAAa,CAAC;IACzB,CAAC,QAAQ,EAAE,aAAa,CAAC;IACzB,CAAC,SAAS,EAAE,cAAc,CAAC;IAC3B,CAAC,sBAAsB,EAAE,yBAAyB,CAAC;IACnD,CAAC,UAAU,EAAE,eAAe,CAAC;IAC7B,CAAC,kBAAkB,EAAE,sBAAsB,CAAC;IAC5C,CAAC,YAAY,EAAE,gBAAgB,CAAC;IAChC,CAAC,MAAM,EAAE,WAAW,CAAC;IACrB,CAAC,MAAM,EAAE,WAAW,CAAC;IACrB,CAAC,SAAS,EAAE,cAAc,CAAC;CAC5B,CAAC,CAAC"}

package/src/messaging/converters/interactive/card-converter.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+import type { Obj, RawCardContent, ConvertCardResult } from './types';
+export declare const MODE: {
+    readonly Concise: 0;
+    readonly Detailed: 1;
+};
+type Mode = (typeof MODE)[keyof typeof MODE];
+export declare class CardConverter {
+    private mode;
+    private attachment;
+    constructor(mode: Mode);
+    convert(input: RawCardContent): ConvertCardResult;
+    private extractBody;
+    private extractHeaderTitle;
+    private convertBody;
+    convertElements(elements: unknown[], depth: number): string;
+    convertElement(elem: Obj, depth: number): string;
+    extractProperty(elem: Obj): Obj;
+    extractTextContent(textElem: unknown): string;
+    private extractTextFromProperty;
+    convertPlainText(prop: Obj): string;
+    convertMarkdown(prop: Obj): string;
+    convertMarkdownV1(elem: Obj, prop: Obj): string;
+    convertMarkdownElements(elements: unknown[]): string;
+    convertDiv(prop: Obj, _id: string): string;
+    convertNote(prop: Obj): string;
+    convertLink(prop: Obj): string;
+    convertEmoji(prop: Obj): string;
+    convertLocalDatetime(prop: Obj): string;
+    convertList(prop: Obj): string;
+    convertBlockquote(prop: Obj): string;
+    convertCodeBlock(prop: Obj): string;
+    convertCodeSpan(prop: Obj): string;
+    convertHeading(prop: Obj): string;
+    convertFallbackText(prop: Obj): string;
+    convertTextTag(prop: Obj): string;
+    convertNumberTag(prop: Obj): string;
+    convertUnknown(prop: Obj | undefined, tag: string): string;
+    convertColumnSet(prop: Obj, depth: number): string;
+    convertColumn(prop: Obj, depth: number): string;
+    convertForm(prop: Obj, _id: string): string;
+    convertCollapsiblePanel(prop: Obj, _id: string): string;
+    convertInteractiveContainer(prop: Obj, _id: string): string;
+    convertRepeat(prop: Obj): string;
+    convertButton(prop: Obj, _id: string): string;
+    convertActions(prop: Obj): string;
+    convertSelect(prop: Obj, _id: string, isMulti: boolean): string;
+    convertSelectImg(prop: Obj, _id: string): string;
+    convertInput(prop: Obj, _id: string): string;
+    convertDatePicker(prop: Obj, _id: string, pickerType: string): string;
+    convertChecker(prop: Obj, _id: string): string;
+    convertOverflow(prop: Obj): string;
+    convertPerson(prop: Obj, _id: string): string;
+    convertPersonV1(prop: Obj, _id: string): string;
+    convertPersonList(prop: Obj): string;
+    convertAvatar(prop: Obj, _id: string): string;
+    convertAt(prop: Obj): string;
+    convertImage(prop: Obj, _id: string): string;
+    convertImgCombination(prop: Obj): string;
+    convertChart(prop: Obj, _id: string): string;
+    private extractChartSummary;
+    private extractLineBarSummary;
+    private extractPieSummary;
+    private extractGenericSummary;
+    convertAudio(prop: Obj, _id: string): string;
+    convertVideo(prop: Obj, _id: string): string;
+    convertTable(prop: Obj): string;
+    private extractTableCellValue;
+    private extractTextStyle;
+    private applyTextStyle;
+    private getImageToken;
+}
+export {};
+//# sourceMappingURL=card-converter.d.ts.map

package/src/messaging/converters/interactive/card-converter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"card-converter.d.ts","sourceRoot":"","sources":["../../../../../src/messaging/converters/interactive/card-converter.ts"],"names":[],"mappings":"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"}