plogme 1.0.0

package/lib/Utils/rich-message-utils.js

@@ -0,0 +1,942 @@
+/**
+ * Lia@Changes 09-04-26 [WIP]
+ * Adds support for tables and code blocks with richResponseMessage (wrapped inside botForwardedMessage).
+ *
+ * If you use or copy this code, please credit my name or project. AND DO NOT CHANGE THIS NOTE
+ */
+import { getRandomValues, randomUUID, randomBytes } from 'crypto';
+import { DONATE_URL, LEXER_REGEX } from '../Defaults/index.js';
+import { LANGUAGE_KEYWORDS } from '../WABinary/constants.js';
+import { CodeHighlightType, RichSubMessageType } from '../Types/RichType.js';
+import { proto } from '../../WAProto/index.js';
+import { unixTimestampSeconds } from './generics.js';
+const NOOP = new Set([]);
+export const tokenizeCode = (code, language = 'javascript') => {
+    const keywords = LANGUAGE_KEYWORDS[language] || NOOP;
+    const blocks = [];
+    LEXER_REGEX.lastIndex = 0;
+    let match;
+    while ((match = LEXER_REGEX.exec(code)) !== null) {
+        if (match[1]) {
+            blocks.push({ highlightType: CodeHighlightType.COMMENT, codeContent: match[1] });
+        }
+        else if (match[2]) {
+            blocks.push({ highlightType: CodeHighlightType.STRING, codeContent: match[2] });
+        }
+        else if (match[3]) {
+            blocks.push({
+                highlightType: keywords.has(match[3]) ? CodeHighlightType.KEYWORD : CodeHighlightType.METHOD,
+                codeContent: match[3],
+            });
+        }
+        else if (match[4]) {
+            blocks.push({
+                highlightType: keywords.has(match[4]) ? CodeHighlightType.KEYWORD : CodeHighlightType.DEFAULT,
+                codeContent: match[4],
+            });
+        }
+        else if (match[5]) {
+            blocks.push({ highlightType: CodeHighlightType.NUMBER, codeContent: match[5] });
+        }
+        else {
+            blocks.push({ highlightType: CodeHighlightType.DEFAULT, codeContent: match[6] });
+        }
+    }
+    return blocks;
+};
+// Lia@Changes 09-04-26 --- Inject buffer into unifiedResponse.data to support proper rendering of rich messages (ex: tables and code blocks)
+export const toUnified = (submessages, uuid) => ({
+    response_id: uuid || randomUUID(),
+    sections: submessages.map((submessage) => {
+        switch (submessage.messageType) {
+            case RichSubMessageType.CODE: {
+                const codeMetadata = submessage.codeMetadata || {};
+                return {
+                    view_model: {
+                        primitive: {
+                            language: codeMetadata.codeLanguage || 'javascript',
+                            code_blocks: (codeMetadata.codeBlocks || []).map((block) => ({ content: block.codeContent, type: CodeHighlightType[block.highlightType] || 'DEFAULT' })),
+                            __typename: 'GenAICodeUXPrimitive'
+                        },
+                        __typename: 'GenAISingleLayoutViewModel'
+                    }
+                };
+            }
+            case RichSubMessageType.CONTENT_ITEMS: {
+                const items = submessage.contentItemsMetadata?.itemsMetadata || [];
+                const primitives = items.map((item) => {
+                    const reel = item?.reelItem || item || {};
+                    return {
+                        reels_url: reel.videoUrl || reel.reels_url || reel.url || '',
+                        thumbnail_url: reel.thumbnailUrl || reel.thumbnail_url || '',
+                        creator: reel.creator || reel.title || '',
+                        avatar_url: reel.profileIconUrl || reel.avatar_url || '',
+                        reels_title: reel.title || reel.reels_title || '',
+                        likes_count: reel.likesCount ?? reel.likes_count ?? 0,
+                        shares_count: reel.sharesCount ?? reel.shares_count ?? 0,
+                        view_count: reel.viewCount ?? reel.view_count ?? 0,
+                        reel_source: reel.reelSource || reel.reel_source || 'IG',
+                        is_verified: !!(reel.isVerified ?? reel.is_verified),
+                        __typename: 'GenAIReelPrimitive'
+                    };
+                }).filter((item) => item.reels_url || item.thumbnail_url || item.reels_title);
+                return {
+                    view_model: {
+                        primitives,
+                        __typename: 'GenAIHScrollLayoutViewModel'
+                    }
+                };
+            }
+            case RichSubMessageType.INLINE_IMAGE: {
+                const image = submessage.imageMetadata || {};
+                const media = mediaPrimitive({ url: image.imageUrl || image.url, mime_type: image.mimeType || image.mime_type, width: image.width, height: image.height });
+                return media ? { view_model: { primitive: media, __typename: 'GenAISingleLayoutViewModel' } } : {};
+            }
+            case RichSubMessageType.LATEX: {
+                const metadata = submessage.latexMetadata || {};
+                const expression = (metadata.expressions || [])[0] || {};
+                const item = {
+                    latex_expression: expression.latexExpression || expression.expression || '',
+                    font_height: expression.fontHeight,
+                    padding: expression.padding ?? 15,
+                    latex_image: {
+                        url: expression.url || '',
+                        width: expression.width || 388,
+                        height: expression.height || 160
+                    }
+                };
+                return {
+                    view_model: {
+                        primitive: { item, ...item, __typename: 'GenAILatexUXPrimitive' },
+                        __typename: 'GenAISingleLayoutViewModel'
+                    }
+                };
+            }
+            case RichSubMessageType.TABLE: {
+                const tableMetadata = submessage.tableMetadata || {};
+                return {
+                    view_model: {
+                        primitive: {
+                            title: tableMetadata.title || '',
+                            rows: (tableMetadata.rows || []).map((row) => ({
+                                is_header: !!row.isHeading,
+                                cells: row.items || [],
+                                markdown_cells: (row.items || []).map((item) => ({ text: item }))
+                            })),
+                            __typename: 'GenATableUXPrimitive'
+                        },
+                        __typename: 'GenAISingleLayoutViewModel'
+                    }
+                };
+            }
+            case RichSubMessageType.TEXT:
+                return {
+                    view_model: {
+                        primitive: {
+                            text: submessage.messageText || '',
+                            inline_entities: submessage.inlineEntities || [],
+                            __typename: 'GenAIMarkdownTextUXPrimitive'
+                        },
+                        __typename: 'GenAISingleLayoutViewModel'
+                    }
+                };
+            default:
+                return submessage;
+        }
+    })
+});
+/**
+ * Build the Meta-style AI image/video primitive used for generation states.
+ * This is intentionally additive: existing reels, tables, links, and menus keep
+ * their current wire format.
+ */
+export const buildImaginePrimitive = ({
+    mediaType = 'video',
+    url = '',
+    thumbnail,
+    mimeType,
+    fileLength = 0,
+    duration = 0,
+    status = 'GENERATING',
+    estimatedMs,
+    imagineType
+} = {}) => {
+    const normalizedType = String(mediaType).toLowerCase() === 'image' ? 'IMAGE' : 'ANIMATE';
+    const primitive = {
+        media: {
+            url: url || '',
+            mime_type: mimeType || (normalizedType === 'IMAGE' ? 'image/jpeg' : 'video/mp4'),
+            file_length: fileLength || 0,
+            duration: duration || 0
+        },
+        imagine_type: imagineType || normalizedType,
+        status: { status: String(status || 'GENERATING').toUpperCase() },
+        __typename: 'GenAIImaginePrimitive'
+    };
+    if (estimatedMs != null) {
+        primitive.status.estimated_completion_time = Math.floor((Date.now() + Number(estimatedMs)) / 1000);
+    }
+    if (thumbnail) primitive.thumbnail = { raw_media: thumbnail };
+    return primitive;
+};
+
+/**
+ * Prepare a native rich-response message containing a generation primitive.
+ * `itemId` is returned to callers so a later edit can replace the same item.
+ */
+export const prepareRichGenerationMessage = ({
+    text = '',
+    mediaType = 'video',
+    url = '',
+    thumbnail,
+    mimeType,
+    fileLength = 0,
+    duration = 0,
+    status = 'GENERATING',
+    estimatedMs,
+    itemId = `imagine_${randomUUID()}`,
+    responseId = randomUUID(),
+    forwarded = true
+} = {}) => {
+    const sections = [];
+    if (text) {
+        sections.push({ view_model: { primitive: { text: String(text), inline_entities: [], __typename: 'GenAIMarkdownTextUXPrimitive' }, __typename: 'GenAISingleLayoutViewModel' } });
+    }
+    sections.push({ view_model: { primitive: buildImaginePrimitive({ mediaType, url, thumbnail, mimeType, fileLength, duration, status, estimatedMs }), __typename: 'GenAISingleLayoutViewModel', id: itemId } });
+    const submessages = text ? [{ messageType: RichSubMessageType.TEXT, messageText: String(text) }] : [];
+    const richResponseMessage = proto.AIRichResponseMessage.create({
+        submessages,
+        messageType: proto.AIRichResponseMessageType.AI_RICH_RESPONSE_TYPE_STANDARD,
+        unifiedResponse: { data: Buffer.from(JSON.stringify({ response_id: responseId, sections })) },
+        contextInfo: forwarded ? { isForwarded: true, forwardingScore: 1, forwardedAiBotMessageInfo: { botJid: '867051314767696@bot' }, forwardOrigin: 4 } : {}
+    });
+    const message = wrapToBotForwardedMessage(richResponseMessage);
+    message.messageContextInfo = message.messageContextInfo || {};
+    message.messageContextInfo.botMetadata = {
+        ...(message.messageContextInfo.botMetadata || {}),
+        botResponseId: responseId
+    };
+    return { message, responseId, itemId };
+};
+
+// Lia@Note 17-04-26 --- WIP
+export const buildAdditionalBotMetadataContext = (submessages) => {
+    const sources = [];
+    const mediaDetailsMetadataList = [];
+    for (let i = 0; i < submessages.length; i++) {
+        const submessage = submessages[i];
+        switch (submessage.messageType) {
+            case RichSubMessageType.CONTENT_ITEMS: {
+                const itemsMetadata = submessage.contentItemsMetadata?.itemsMetadata || [];
+                for (let n = 0; n < itemsMetadata.length; n++) {
+                    const reelItem = itemsMetadata[n]?.reelItem || itemsMetadata[n] || {};
+                    sources.push({
+                        provider: 0,
+                        thumbnailCdnUrl: reelItem.thumbnailUrl || reelItem.thumbnail_url || '',
+                        sourceProviderUrl: reelItem.videoUrl || reelItem.reels_url || reelItem.url || '',
+                        sourceQuery: '',
+                        faviconCdnUrl: reelItem.profileIconUrl || reelItem.avatar_url || '',
+                        citationNumber: i + 1,
+                        sourceTitle: reelItem.title || reelItem.reels_title || reelItem.creator || ''
+                    });
+                    mediaDetailsMetadataList.push({
+                        id: randomBytes(32).toString('hex'),
+                        previewMedia: {
+                            fileSha256: '',
+                            mediaKey: '',
+                            fileEncSha256: '',
+                            directPath: '',
+                            mediaKeyTimestamp: unixTimestampSeconds(),
+                            mimetype: 'image/jpeg'
+                        }
+                    });
+                }
+                break;
+            }
+            case RichSubMessageType.LATEX:
+                const expressions = submessage.latexMetadata.expressions;
+                for (let n = 0; n < expressions.length; n++) {
+                    const expression = expressions[n];
+                    mediaDetailsMetadataList.push({
+                        id: randomBytes(32).toString('hex'),
+                        previewMedia: {
+                            fileSha256: '',
+                            mediaKey: '',
+                            fileEncSha256: '',
+                            directPath: '',
+                            mediaKeyTimestamp: unixTimestampSeconds(),
+                            mimetype: 'image/jpeg'
+                        }
+                    });
+                }
+                break;
+        }
+    }
+    return { sources, mediaDetailsMetadataList };
+}
+const richMenuToolId = () => randomBytes(8).toString('hex');
+
+const mediaPrimitive = (image, inline = false, padding = 4) => {
+    if (!image?.url) return null;
+    const media = {
+        __typename: 'GenAIMediaItem',
+        mime_type: image.mime_type || image.mimeType || 'image/png',
+        url: image.url,
+        url_fallback: image.url,
+        width: image.width || (inline ? 500 : undefined),
+        height: image.height || (inline ? 500 : undefined),
+        expiration_timestamp_ms: Date.now() + 86400000,
+    };
+    if (inline) {
+        return {
+            __typename: 'GenAIMarkdownTextUXPrimitive',
+            text: '{{header}}.{{/header}}',
+            inline_entities: [{
+                __typename: 'GenAITextInlineEntity',
+                key: 'header',
+                metadata: {
+                    __typename: 'GenAILatexItem',
+                    latex_expression: '.',
+                    font_height: 24,
+                    padding,
+                    latex_image: media,
+                },
+            }],
+        };
+    }
+    return {
+        __typename: 'GenAIImagePrimitive',
+        preview_image: media,
+        full_image: media,
+    };
+};
+
+const richMenuButton = (button, toast = '') => {
+    const label = typeof button === 'string' ? button : (button?.text || button?.label || button?.id || 'Option');
+    return {
+        label: String(label),
+        state: 'PENDING',
+        kind: 'OTHER',
+        // Preserve supplied IDs so WhatsApp CTA replies are routable.
+        // Legacy string-only buttons retain generated IDs for compatibility.
+        tool_call_id: typeof button === 'object' && button?.id != null
+            ? String(button.id)
+            : richMenuToolId(),
+        toast: {
+            label: typeof button === 'object' && button?.toast != null ? String(button.toast) : String(toast || ''),
+            __typename: 'GenAIExtWidgetToast',
+        },
+        __typename: 'GenAI3PExtWidgetCTA',
+    };
+};
+
+/**
+ * Builds the Meta AI-style rich menu envelope used by vansnowi/baileys.
+ * This is an experimental WhatsApp rich-response format, not a standard
+ * buttonsMessage/nativeFlowMessage payload.
+ */
+export const prepareRichMenuMessage = (content = {}) => {
+    const { header = {}, body = {}, footer = {} } = content || {};
+    const sections = [];
+    const title = header?.title || '';
+    if (title) {
+        sections.push({
+            __typename: 'GenAIUnifiedResponseSection',
+            view_model: {
+                __typename: 'GenAISingleLayoutViewModel',
+                primitive: { __typename: 'FOATextPrimitive', text: '# ' + title },
+            },
+        });
+    }
+    const headerImage = mediaPrimitive(header?.image, Boolean(header?.image?.inline));
+    if (headerImage) {
+        sections.push({
+            __typename: 'GenAIUnifiedResponseSection',
+            view_model: { __typename: 'GenAISingleLayoutViewModel', primitive: headerImage },
+        });
+    }
+    if (header?.disclaimer) {
+        sections.push({
+            __typename: 'GenAIUnifiedResponseSection',
+            view_model: {
+                __typename: 'GenAISingleLayoutViewModel',
+                primitive: { __typename: 'GenAIMarkdownTextUXPrimitive', text: header.disclaimerText || ' ' },
+            },
+        });
+    }
+    const cards = Array.isArray(body?.cards) ? body.cards : [];
+    const buttons = Array.isArray(body?.buttons) ? body.buttons : [];
+    if (cards.length) {
+        sections.push({
+            __typename: 'GenAIUnifiedResponseSection',
+            view_model: {
+                primitives: cards.map(card => ({
+                    __typename: 'GenAI3PExtWidgetPrimitive',
+                    header: { __typename: 'GenAI3PExtWidgetStandardHeader', title: card?.title || '' },
+                    body: {
+                        __typename: 'GenAI3PExtCalendarEventList',
+                        ctas: (Array.isArray(card?.buttons) ? card.buttons : []).map(button => richMenuButton(button, card?.toast)),
+                        sections: [],
+                    },
+                })),
+                __typename: body.carousel ? 'GenAIHScrollLayoutViewModel' : 'GenAIActionRowLayoutViewModel',
+            },
+        });
+    } else if (buttons.length) {
+        sections.push({
+            __typename: 'GenAIUnifiedResponseSection',
+            view_model: {
+                __typename: 'GenAISingleLayoutViewModel',
+                primitive: {
+                    __typename: 'GenAI3PExtWidgetPrimitive',
+                    header: { __typename: 'GenAI3PExtWidgetStandardHeader', title: body.title || '' },
+                    body: {
+                        __typename: 'GenAI3PExtCalendarEventList',
+                        ctas: buttons.map(button => richMenuButton(button, body.toast)),
+                        sections: [],
+                    },
+                },
+            },
+        });
+    }
+    if (footer?.text || footer?.url || footer?.image?.url) {
+        const footerImage = mediaPrimitive(footer.image, true, -5);
+        sections.push({
+            view_model: {
+                primitives: [
+                    { __typename: 'GenAIFooterActionPrimitive', cta_text: footer.text || 'Open', cta_type: 'OPEN_URL', cta_url: footer.url || '' },
+                    ...(footerImage ? [footerImage] : []),
+                ],
+                __typename: 'GenAIActionRowLayoutViewModel',
+            },
+        });
+    }
+    const unified = { response_id: randomUUID(), sections };
+    const richResponseMessage = proto.AIRichResponseMessage.create({
+        submessages: [],
+        messageType: proto.AIRichResponseMessageType.AI_RICH_RESPONSE_TYPE_STANDARD,
+        unifiedResponse: { data: Buffer.from(JSON.stringify(unified)) },
+        contextInfo: { isForwarded: true, forwardingScore: 1, forwardOrigin: 4 },
+    });
+    return wrapToBotForwardedMessage(richResponseMessage);
+};
+
+/**
+ * Builds a GenAI copy-to-clipboard rich response message.
+ * Renders a text label with a dark circular copy icon (addon_action_type: COPY_TO_CLIPBOARD).
+ *
+ * @param {Object} options
+ * @param {string} options.text - The text to display (and copy when tapped)
+ * @param {string} [options.label] - Optional display label (defaults to text)
+ * @param {'END'|'START'|'CENTER'} [options.alignment='END'] - Button alignment
+ * @returns {Object} Wrapped botForwardedMessage ready for relayMessage
+ */
+export const prepareCopyToClipboardMessage = (options = {}) => {
+    const { text = '', label, alignment = 'END' } = options;
+    const displayText = label || text;
+    const sections = [
+        {
+            __typename: 'GenAIUnifiedResponseSection',
+            view_model: {
+                __typename: 'GenAIAddonActionLayoutViewModel',
+                addon_action_type: 'COPY_TO_CLIPBOARD',
+                addon_action_alignment: alignment,
+                primitives: [
+                    {
+                        __typename: 'GenAIMarkdownTextUXPrimitive',
+                        text: String(displayText),
+                        inline_entities: [],
+                    },
+                ],
+            },
+        },
+    ];
+    const unified = { response_id: randomUUID(), sections };
+    const richResponseMessage = proto.AIRichResponseMessage.create({
+        submessages: [],
+        messageType: proto.AIRichResponseMessageType.AI_RICH_RESPONSE_TYPE_STANDARD,
+        unifiedResponse: { data: Buffer.from(JSON.stringify(unified)) },
+        contextInfo: { isForwarded: true, forwardingScore: 1, forwardOrigin: 4 },
+    });
+    return wrapToBotForwardedMessage(richResponseMessage);
+};
+
+/**
+ * Builds a GenAI rich text message — plain text rendered inside a forwarded rich response.
+ * Uses GenAIMarkdownTextUXPrimitive inside a GenAISingleLayoutViewModel.
+ *
+ * @param {Object} options
+ * @param {string} options.text - The text content to display
+ * @returns {Object} Wrapped botForwardedMessage ready for relayMessage
+ */
+export const prepareRichTextMessage = (options = {}) => {
+    const { text = '' } = options;
+    const sections = [
+        {
+            __typename: 'GenAIUnifiedResponseSection',
+            view_model: {
+                __typename: 'GenAISingleLayoutViewModel',
+                primitive: {
+                    __typename: 'GenAIMarkdownTextUXPrimitive',
+                    text: String(text),
+                    inline_entities: [],
+                },
+            },
+        },
+    ];
+    const unified = { response_id: randomUUID(), sections };
+    const richResponseMessage = proto.AIRichResponseMessage.create({
+        submessages: [],
+        messageType: proto.AIRichResponseMessageType.AI_RICH_RESPONSE_TYPE_STANDARD,
+        unifiedResponse: { data: Buffer.from(JSON.stringify(unified)) },
+        contextInfo: { isForwarded: true, forwardingScore: 1, forwardOrigin: 4 },
+    });
+    return wrapToBotForwardedMessage(richResponseMessage);
+};
+
+/**
+ * Builds a GenAI rich image message — an image rendered inside a forwarded rich response.
+ * Uses GenAIImagePrimitive with preview and full image variants.
+ *
+ * @param {Object} options
+ * @param {string} options.url - Image URL
+ * @param {string} [options.mimeType='image/png'] - MIME type
+ * @returns {Object} Wrapped botForwardedMessage ready for relayMessage
+ */
+export const prepareRichImageMessage = (options = {}) => {
+    const { url = '', mimeType = 'image/png' } = options;
+    const media = {
+        __typename: 'GenAIMediaItem',
+        mime_type: mimeType,
+        url,
+        url_fallback: url,
+    };
+    const sections = [
+        {
+            __typename: 'GenAIUnifiedResponseSection',
+            view_model: {
+                __typename: 'GenAISingleLayoutViewModel',
+                primitive: {
+                    __typename: 'GenAIImagePrimitive',
+                    preview_image: media,
+                    full_image: media,
+                },
+            },
+        },
+    ];
+    const unified = { response_id: randomUUID(), sections };
+    const richResponseMessage = proto.AIRichResponseMessage.create({
+        submessages: [],
+        messageType: proto.AIRichResponseMessageType.AI_RICH_RESPONSE_TYPE_STANDARD,
+        unifiedResponse: { data: Buffer.from(JSON.stringify(unified)) },
+        contextInfo: { isForwarded: true, forwardingScore: 1, forwardOrigin: 4 },
+    });
+    return wrapToBotForwardedMessage(richResponseMessage);
+};
+
+
+/**
+ * Builds a GenAI rich link message — inline hyperlinks rendered inside a forwarded rich response.
+ * Uses GenAIInlineLinkItem for simple clickable text links (not citation-style).
+ *
+ * @param {Object} options
+ * @param {Array<Object>} options.links - Array of { text, url, displayName?, isTrusted? }
+ * @returns {Object} Wrapped botForwardedMessage ready for relayMessage
+ */
+export const prepareRichLinkMessage = (options = {}) => {
+    const { links = [], text: fallbackText } = options;
+    const sections = [];
+    const allInlineEntities = [];
+    let combinedText = '';
+    
+    links.forEach((link, index) => {
+        const key = `INLINE_HYPERLINK_${index}`;
+        const displayText = link.text || link.displayName || link.url || '';
+        const url = link.url || '';
+        const isTrusted = link.isTrusted !== false;
+        
+        combinedText += `{{${key}}}${displayText}{{/${key}}}`;
+        allInlineEntities.push({
+            key,
+            metadata: {
+                display_name: displayText,
+                is_trusted: isTrusted,
+                url,
+                __typename: 'GenAIInlineLinkItem',
+            },
+        });
+    });
+    
+    sections.push({
+        __typename: 'GenAIUnifiedResponseSection',
+        view_model: {
+            __typename: 'GenAISingleLayoutViewModel',
+            primitive: {
+                __typename: 'GenAIMarkdownTextUXPrimitive',
+                text: combinedText || fallbackText || '',
+                inline_entities: allInlineEntities,
+            },
+        },
+    });
+    if (sections.length === 0) {
+        sections.push({
+            __typename: 'GenAIUnifiedResponseSection',
+            view_model: {
+                __typename: 'GenAISingleLayoutViewModel',
+                primitive: {
+                    __typename: 'GenAIMarkdownTextUXPrimitive',
+                    text: '',
+                    inline_entities: [],
+                },
+            },
+        });
+    }
+    const unified = { response_id: randomUUID(), sections };
+    const richResponseMessage = proto.AIRichResponseMessage.create({
+        submessages: [],
+        messageType: proto.AIRichResponseMessageType.AI_RICH_RESPONSE_TYPE_STANDARD,
+        unifiedResponse: { data: Buffer.from(JSON.stringify(unified)) },
+        contextInfo: { isForwarded: true, forwardingScore: 1, forwardOrigin: 4 },
+    });
+    return wrapToBotForwardedMessage(richResponseMessage);
+};
+
+export const prepareRichResponseMessage = (content) => {
+    const { alignment, code, contentText, disclaimerText, footerText, headerText, imageText, inlineImage, inlineVideo, items, language, latex, links, noDonation, noHeading, posts, products, reels, sources: sourceInputs, suggested, richResponse, table, tapLinkUrl, title } = content;
+    let submessages = [];
+    if (Array.isArray(richResponse)) {
+        submessages = richResponse.map((submessage) => {
+            if (submessage.text) {
+                return {
+                    messageType: RichSubMessageType.TEXT,
+                    messageText: submessage.text,
+                    inlineEntities: submessage.inlineEntities
+                };
+            }
+            else if (submessage.code) {
+                return {
+                    messageType: RichSubMessageType.CODE,
+                    codeMetadata: {
+                        codeLanguage: submessage.language,
+                        codeBlocks: submessage.code
+                    }
+                };
+            }
+            else if (submessage.items) {
+                return {
+                    messageType: RichSubMessageType.CONTENT_ITEMS,
+                    contentItemsMetadata: {
+                        itemsMetadata: submessage.items,
+                        contentType: proto.AIRichResponseContentItemsMetadata.ContentType.CAROUSEL
+                    }
+                };
+            }
+            else if (submessage.inlineImage) {
+                return {
+                    messageType: RichSubMessageType.INLINE_IMAGE,
+                    imageMetadata: {
+                        imageUrl: submessage.inlineImage,
+                        imageText: submessage.imageText,
+                        alignment: submessage.alignment,
+                        tapLinkUrl: submessage.tapLinkUrl
+                    }
+                };
+            }
+            else if (submessage.inlineVideo) {
+                return {
+                    messageType: RichSubMessageType.TEXT,
+                    messageText: 'INLINE_VIDEO'
+                };
+            }
+            else if (submessage.latex) {
+                return {
+                    messageType: RichSubMessageType.LATEX,
+                    latexMetadata: {
+                        text: submessage.text,
+                        expressions: submessage.latex
+                    }
+                };
+            }
+            else if (submessage.posts) {
+                return {
+                    messageType: RichSubMessageType.TEXT,
+                    messageText: 'POSTS'
+                };
+            }
+            else if (submessage.products) {
+                return {
+                    messageType: RichSubMessageType.TEXT,
+                    messageText: 'PRODUCTS'
+                };
+            }
+            else if (submessage.suggested) {
+                return {
+                    messageType: RichSubMessageType.TEXT,
+                    messageText: 'SUGGESTED_PROMPT'
+                };
+            }
+            else if (submessage.table) {
+                return {
+                    messageType: RichSubMessageType.TABLE,
+                    tableMetadata: {
+                        title: submessage.title,
+                        rows: submessage.table
+                    }
+                };
+            }
+            return submessage;
+        });
+    }
+    else {
+        if (headerText) {
+            submessages.push({
+                messageType: RichSubMessageType.TEXT,
+                messageText: headerText
+            });
+        }
+        if (contentText) {
+            submessages.push({
+                messageType: RichSubMessageType.TEXT,
+                messageText: contentText
+            });
+        }
+        if (code) {
+            language ||= 'javascript';
+            submessages.push({
+                messageType: RichSubMessageType.CODE,
+                codeMetadata: {
+                    codeLanguage: language,
+                    codeBlocks: tokenizeCode(code, language)
+                }
+            });
+        }
+        const reelItems = Array.isArray(reels) ? reels.map((reel) => ({ reelItem: {
+            title: reel?.title || reel?.reels_title || '',
+            creator: reel?.creator || '',
+            videoUrl: reel?.videoUrl || reel?.reels_url || reel?.url || '',
+            thumbnailUrl: reel?.thumbnailUrl || reel?.thumbnail_url || '',
+            profileIconUrl: reel?.profileIconUrl || reel?.avatar_url || '',
+            likesCount: reel?.likesCount ?? reel?.likes_count ?? 0,
+            sharesCount: reel?.sharesCount ?? reel?.shares_count ?? 0,
+            viewCount: reel?.viewCount ?? reel?.view_count ?? 0,
+            reelSource: reel?.reelSource || reel?.reel_source || 'IG',
+            isVerified: !!(reel?.isVerified ?? reel?.is_verified)
+        } })) : [];
+        const resolvedItems = items || reelItems;
+        if (resolvedItems?.length) {
+            submessages.push({
+                messageType: RichSubMessageType.CONTENT_ITEMS,
+                contentItemsMetadata: {
+                    itemsMetadata: resolvedItems,
+                    contentType: proto.AIRichResponseContentItemsMetadata.ContentType.CAROUSEL
+                }
+            });
+        }
+        if (inlineImage) {
+            submessages.push({
+                messageType: RichSubMessageType.INLINE_IMAGE,
+                imageMetadata: {
+                    imageUrl: inlineImage,
+                    imageText,
+                    alignment,
+                    tapLinkUrl
+                }
+            });
+        }
+        if (inlineVideo) {
+            submessages.push({
+                messageType: RichSubMessageType.TEXT,
+                messageText: 'INLINE_VIDEO'
+            });
+        }
+        if (latex) {
+            submessages.push({
+                messageType: RichSubMessageType.LATEX,
+                latexMetadata: {
+                    text: contentText || '',
+                    expressions: latex
+                }
+            });
+        }
+        const defaultDonationLink = {
+            text: '',
+            url: DONATE_URL,
+            title: 'PAIR CRYSN⚉VA AI ⩇⩇:⩇⩇',
+            displayName: 'pair bot'
+        };
+        const sourceLinks = (sourceInputs || links || []).map((linkField) => {
+            if (typeof linkField === 'string') return { text: '', url: linkField, displayName: linkField };
+            return { text: linkField?.text || linkField?.displayName || linkField?.title || '', ...linkField };
+        });
+        const resolvedLinks = noDonation ? sourceLinks : [...sourceLinks, defaultDonationLink];
+        if (resolvedLinks) {
+            resolvedLinks.forEach((linkField, index) => {
+                const prefix = 'SS_' + index;
+                const url = linkField.url || DONATE_URL;
+                const sources = linkField.sources?.map((sourceField) => ({
+                    source_type: 'THIRD_PARTY',
+                    source_display_name: sourceField.displayName || 'pair bot',
+                    source_subtitle: sourceField.subtitle || 'crysnovax',
+                    source_url: sourceField.url || url
+                }));
+                submessages.push({
+                    messageType: RichSubMessageType.TEXT,
+                    messageText: String(linkField.text || '') + ` {{${prefix}}}¹{{/${prefix}}} `,
+                    inlineEntities: [{
+                            key: prefix,
+                            metadata: {
+                                reference_id: index + 1,
+                                reference_url: url,
+                                reference_title: linkField.title || 'Get your own bot',
+                                reference_display_name: linkField.displayName || 'pair',
+                                sources: sources || [],
+                                __typename: 'GenAISearchCitationItem'
+                            }
+                        }]
+                });
+            });
+        }
+        if (posts) {
+            submessages.push({
+                messageType: RichSubMessageType.TEXT,
+                messageText: 'POSTS'
+            });
+        }
+        if (products) {
+            submessages.push({
+                messageType: RichSubMessageType.TEXT,
+                messageText: 'PRODUCTS'
+            });
+        }
+        if (suggested) {
+            submessages.push({
+                messageType: RichSubMessageType.TEXT,
+                messageText: 'SUGGESTED_PROMPT'
+            });
+        }
+        if (table) {
+            submessages.push({
+                messageType: RichSubMessageType.TABLE,
+                tableMetadata: {
+                    title,
+                    rows: table.map((items, index) => ({
+                        isHeading: !noHeading && index == 0,
+                        items
+                    }))
+                }
+            });
+        }
+        if (footerText) {
+            submessages.push({
+                messageType: RichSubMessageType.TEXT,
+                messageText: footerText
+            });
+        }
+    }
+    const uuid = randomUUID();
+    const unified = toUnified(submessages, uuid);
+    const richResponseMessage = proto.AIRichResponseMessage.create({
+        submessages,
+        messageType: proto.AIRichResponseMessageType.AI_RICH_RESPONSE_TYPE_STANDARD,
+        unifiedResponse: {
+            data: Buffer.from(JSON.stringify(unified)) // Lia@Note 25-04-26 --- Expects "ArrayBufferLike"
+        },
+        contextInfo: {
+            isForwarded: true,
+            forwardingScore: 1,
+            forwardedAiBotMessageInfo: { botJid: '867051314767696@bot' },
+            forwardOrigin: 4
+        }
+    });
+    const message = wrapToBotForwardedMessage(richResponseMessage);
+    const botMetadata = message.messageContextInfo.botMetadata;
+    // Lia@Note 13-05-26 --- Add disclaimer text on richResponseMessage
+    if (disclaimerText) {
+        botMetadata.messageDisclaimerText = disclaimerText;
+    }
+    // Lia@Note 15-05-26 --- Add responseId from unified directly to botMetadata
+    botMetadata.botResponseId = uuid;
+    // Lia@Note 17-04-26 --- TODO: Fill mediaDetailsMetadataList and sources field
+    const { sources, mediaDetailsMetadataList } = buildAdditionalBotMetadataContext(submessages);
+    if (sources.length > 0) {
+        botMetadata.richResponseSourcesMetadata = { sources };
+    }
+    if (mediaDetailsMetadataList.length > 0) {
+        botMetadata.unifiedResponseMutation = { mediaDetailsMetadataList };
+    }
+    return message;
+};
+// Lia@Note 17-04-26 --- signature and certificateChain for proofs[] field
+export const botMetadataSignature = () => {
+    const signature = new Uint8Array(64);
+    getRandomValues(signature);
+    return signature;
+};
+export const botMetadataCertificate = (length = 685) => {
+    const certificate = new Uint8Array(length);
+    certificate[0] = 48;
+    certificate[1] = 130;
+    getRandomValues(certificate.subarray(2));
+    return certificate;
+};
+/**
+ * Builds a GenAI HTML primitive message — renders raw HTML inside a forwarded rich response.
+ * Uses FOAHtmlPrimitiveDemoDONOTUSE for full HTML rendering inside the chat bubble.
+ *
+ * This is the game-changer: you can render games, forms, dashboards, and anything
+ * else that HTML/CSS/JS can do, directly inside WhatsApp!
+ *
+ * @param {Object} options
+ * @param {string} options.html - Raw HTML string to render
+ * @param {Array} [options.trustedSources=[]] - Trusted source URLs for security
+ * @returns {Object} Wrapped botForwardedMessage ready for relayMessage
+ */
+export const prepareHtmlMessage = (options = {}) => {
+    const { html = '', trustedSources = [] } = options;
+    const sections = [
+        {
+            __typename: 'GenAIUnifiedResponseSection',
+            view_model: {
+                __typename: 'GenAISingleLayoutViewModel',
+                primitive: {
+                    __typename: 'FOAHtmlPrimitiveDemoDONOTUSE',
+                    trusted_sources: trustedSources,
+                    payload: String(html).trim()
+                }
+            }
+        }
+    ];
+    const unified = { response_id: randomUUID(), sections };
+    const richResponseMessage = proto.AIRichResponseMessage.create({
+        submessages: [],
+        messageType: proto.AIRichResponseMessageType.AI_RICH_RESPONSE_TYPE_STANDARD,
+        unifiedResponse: { data: Buffer.from(JSON.stringify(unified)) },
+        contextInfo: { isForwarded: true, forwardingScore: 1, forwardOrigin: 4 },
+    });
+    return wrapToBotForwardedMessage(richResponseMessage);
+};
+
+export const wrapToBotForwardedMessage = (richResponseMessage) => ({
+    messageContextInfo: {
+        botMetadata: {
+            // Lia@Note 09-04-26 --- TODO: Fill verificationMetadata field
+            verificationMetadata: {
+                proofs: [
+                    {
+                        certificateChain: [
+                            botMetadataCertificate(),
+                            botMetadataCertificate(892)
+                        ],
+                        version: 1,
+                        useCase: 1,
+                        signature: botMetadataSignature()
+                    }
+                ]
+            }
+        }
+    },
+    botForwardedMessage: {
+        message: { richResponseMessage }
+    }
+});
+//# sourceMappingURL=rich-message-utils.js.map