@rennzsync/baileys 10.4.0 → 10.5.0

package/lib/Utils/a2ui.js

@@ -0,0 +1,210 @@
+/**
+ * a2ui.js — widget A2UI (Agent-to-UI) lewat interactiveMessage.bloksWidget.
+ *
+ * Builder deklaratif (Text, Image, Video, Button, Card, Column, Row, Divider,
+ * CheckBox, TextField, ChoicePicker) + listCard, lalu dikirim sebagai
+ * interactiveMessage dengan field bloksWidget (proto field 8) dan node <biz>
+ * native_flow.
+ *
+ * PERINGATAN (sama seperti rich-*.js): format ini internal WhatsApp dan tidak
+ * dijamin dirender di semua client — relayMessage bisa sukses tanpa error
+ * walau widget tidak tampil di sisi penerima.
+ *
+ * Pakai:
+ *   const ui = new A2UI()
+ *   const t = ui.text('Halo', { variant: 'h1' })
+ *   ui.root([t])
+ *   await sock.sendA2UI(jid, { a2ui: ui, bodyText: 'Widget' })
+ *   // atau: sendA2UIWidget(sock, jid, { a2ui: ui })
+ */
+import { randomBytes, randomUUID } from 'crypto';
+
+const DEFAULT_CATALOG_ID = 'https://a2ui.org/specification/v0_9/catalogs/basic/catalog.json';
+
+export class A2UI {
+    constructor({ catalogId = DEFAULT_CATALOG_ID, version = 'v0.9' } = {}) {
+        this._version = version;
+        this._catalogId = catalogId;
+        this._components = new Map();
+        this._counter = 0;
+        this._rootChildren = [];
+    }
+    #nextId(prefix) {
+        return `${prefix}_${(this._counter++).toString(36)}`;
+    }
+    #reg(id, component, extra = {}) {
+        id ??= this.#nextId(component.toLowerCase());
+        if (this._components.has(id))
+            throw new Error(`Component id "${id}" already used`);
+        this._components.set(id, { id, component, ...extra });
+        return id;
+    }
+    text(text, { id, variant = 'body' } = {}) {
+        return this.#reg(id, 'Text', { text, variant });
+    }
+    image(url, { id, variant, fit = 'cover' } = {}) {
+        return this.#reg(id, 'Image', { url, ...(variant ? { variant } : {}), fit });
+    }
+    video(url, { id } = {}) {
+        return this.#reg(id, 'Video', { url });
+    }
+    checkbox(label, { id, value = false } = {}) {
+        return this.#reg(id, 'CheckBox', { label, value });
+    }
+    textField(label, { id, variant = 'text' } = {}) {
+        return this.#reg(id, 'TextField', { label, variant });
+    }
+    button(childId, { id, variant = 'primary', action } = {}) {
+        if (!childId)
+            throw new TypeError('button(childId) requires the id of a child component (e.g. from .text())');
+        return this.#reg(id, 'Button', { child: childId, variant, ...(action ? { action } : {}) });
+    }
+    card(childId, { id } = {}) {
+        return this.#reg(id, 'Card', { child: childId });
+    }
+    column(children = [], { id, justify, align } = {}) {
+        if (!children.length)
+            throw new TypeError('column(children) requires at least one child id');
+        return this.#reg(id, 'Column', { children, ...(justify ? { justify } : {}), ...(align ? { align } : {}) });
+    }
+    row(children = [], { id } = {}) {
+        if (!children.length)
+            throw new TypeError('row(children) requires at least one child id');
+        return this.#reg(id, 'Row', { children });
+    }
+    divider({ id } = {}) {
+        return this.#reg(id, 'Divider', {});
+    }
+    choicePicker(label, options, { id, variant = 'mutuallyExclusive', value, displayStyle = 'checkbox', filterable = false } = {}) {
+        if (!Array.isArray(options) || !options.length) {
+            throw new TypeError('choicePicker(label, options) requires a non-empty options array of {label, value}');
+        }
+        return this.#reg(id, 'ChoicePicker', {
+            label,
+            variant,
+            ...(value !== undefined ? { value } : {}),
+            options,
+            displayStyle,
+            filterable
+        });
+    }
+    root(children) {
+        if (!Array.isArray(children) || !children.length) {
+            throw new TypeError('root(children) requires a non-empty array of top-level component ids');
+        }
+        this._rootChildren = children;
+        return this;
+    }
+    listCard({ title, items, fallbackText, uuid = randomUUID() } = {}) {
+        if (!title)
+            throw new TypeError('listCard requires a title');
+        if (!Array.isArray(items) || !items.length) {
+            throw new TypeError('listCard requires a non-empty items array');
+        }
+        this._listCardPayload = {
+            uuid,
+            data: JSON.stringify({
+                type: 'list_card',
+                title,
+                fallback_text: fallbackText ?? '',
+                items: items.map(it => ({
+                    asset_id: it.assetId ?? randomUUID().replace(/-/g, '').slice(0, 17),
+                    asset_type: it.assetType ?? 'PRODUCT_ITEM',
+                    title: it.title,
+                    trailing_label: it.price ?? it.trailingLabel ?? '',
+                    trailing_emphasis: it.emphasis ?? 'strong'
+                }))
+            }),
+            type: 'im_a2ui',
+            fallback: fallbackText ?? ''
+        };
+        return this;
+    }
+    build({ uuid = randomUUID(), surfaceId, type = 'im_a2ui', wrapped = true } = {}) {
+        if (this._listCardPayload)
+            return this._listCardPayload;
+        if (!this._rootChildren.length)
+            throw new Error('Call root([...ids]) before build()');
+        const root = { id: 'root', component: 'Column', children: this._rootChildren };
+        const components = [root, ...this._components.values()];
+        const data = wrapped
+            ? {
+                version: this._version,
+                createSurface: {
+                    surfaceId: surfaceId ?? `starcore-widget=${uuid}`,
+                    catalogId: this._catalogId,
+                    components
+                }
+            }
+            : { components };
+        return {
+            uuid,
+            data: JSON.stringify(data),
+            type
+        };
+    }
+}
+
+/** Ambil jid user dari sock / objek user / string (sama seperti normalizeUserJid di rich-classic.js). */
+const resolveUserJid = (client) => client?.user?.id || client?.authState?.creds?.me?.id;
+
+/**
+ * Kirim widget A2UI.
+ * @param {object} client  socket (butuh relayMessage; opsional user.id)
+ * @param {string} jid
+ * @param {object} options { a2ui, bodyText, footer, buttons, contextInfo, expiration, quoted, type, wrapped, singleScreen }
+ */
+export async function sendA2UIWidget(client, jid, { a2ui, bodyText = '', footer = '', buttons = [], contextInfo = {}, expiration, quoted, type = 'im_a2ui', wrapped = true, singleScreen = false } = {}) {
+    if (!client || typeof client.relayMessage !== 'function')
+        throw new Error('Socket is required');
+    if (!(a2ui instanceof A2UI))
+        throw new TypeError('a2ui must be an A2UI instance');
+    const { generateWAMessageFromContent } = await import('./messages.js');
+    const nativeFlowMessage = buttons && buttons.length
+        ? {
+            buttons: buttons.map(b => ({
+                name: b.name ?? 'cta_url',
+                buttonParamsJson: typeof b.params === 'string' ? b.params : JSON.stringify(b.params ?? {})
+            })),
+            messageParamsJson: '{}',
+            messageVersion: 1
+        }
+        : { messageParamsJson: '' };
+    const ctx = expiration || Object.keys(contextInfo).length
+        ? { contextInfo: { ...(expiration ? { expiration } : {}), ...contextInfo } }
+        : {};
+    const interactiveMessage = singleScreen
+        ? {
+            nativeFlowMessage,
+            bloksWidget: a2ui.build({ type, wrapped }),
+            ...ctx
+        }
+        : {
+            ...(footer !== undefined ? { header: { hasMediaAttachment: false } } : {}),
+            ...(bodyText !== undefined ? { body: { text: bodyText } } : {}),
+            ...(footer !== undefined ? { footer: { text: footer } } : {}),
+            nativeFlowMessage,
+            bloksWidget: a2ui.build({ type, wrapped }),
+            ...ctx
+        };
+    const msg = generateWAMessageFromContent(jid, {
+        messageContextInfo: { messageSecret: randomBytes(32) },
+        interactiveMessage
+    }, { quoted, userJid: resolveUserJid(client) });
+    await client.relayMessage(msg.key.remoteJid, msg.message, {
+        messageId: msg.key.id,
+        additionalNodes: [
+            {
+                tag: 'biz',
+                attrs: { actual_actors: '2', host_storage: '2', privacy_mode_ts: String(Math.floor(Date.now() / 1e3)) },
+                content: [
+                    { tag: 'interactive', attrs: { type: 'native_flow', v: '1' }, content: [{ tag: 'native_flow', attrs: { v: '9', name: 'mixed' } }] },
+                    { tag: 'quality_control', attrs: { decision_id: randomUUID().replace(/-/g, ''), source_type: 'third_party' }, content: [{ tag: 'decision_source', attrs: { value: 'df' } }] }
+                ]
+            }
+        ]
+    });
+    return msg;
+}
+
+export default { A2UI, sendA2UIWidget };

package/lib/Utils/index.js

@@ -23,5 +23,7 @@ export * from './media-processor.js';
 export * from './rich-webui.js';
 export * from './rich-classic.js';
 export * from './rich-carousel.js';
+export * from './rich-menu.js';
+export * from './a2ui.js';
 export * from './use-sqlite-auth-state.js';
 //# sourceMappingURL=index.js.map

package/lib/Utils/messages.js

@@ -563,6 +563,39 @@ export const generateWAMessageContent = async (message, options) => {
             }
         };
     }
+    // viewOnceV2 / viewOnceV2Extension: bungkus pesan (termasuk teks) ke
+    // viewOnceMessageV2 / viewOnceMessageV2Extension. Untuk teks, flag viewOnce
+    // di dalam extendedTextMessage ikut di-set (sama seperti plugin `vo`).
+    const wantV2Ext = hasOptionalProperty(message, 'viewOnceV2Extension') && !!message.viewOnceV2Extension;
+    const wantV2 = hasOptionalProperty(message, 'viewOnceV2') && !!message.viewOnceV2;
+    if (wantV2Ext || wantV2) {
+        const innerType = Object.keys(m)[0];
+        const inner = m[innerType];
+        if (inner && typeof inner === 'object') {
+            if (innerType === 'extendedTextMessage') {
+                inner.viewOnce = true;
+            }
+            if (innerType === 'extendedTextMessage' || 'contextInfo' in inner) {
+                inner.contextInfo = inner.contextInfo || {};
+                if (inner.contextInfo.forwardingScore === undefined) {
+                    inner.contextInfo.forwardingScore = 1;
+                }
+                if (inner.contextInfo.isForwarded === undefined) {
+                    inner.contextInfo.isForwarded = true;
+                }
+            }
+        }
+        const messageContextInfo = m.messageContextInfo;
+        if (messageContextInfo) {
+            delete m.messageContextInfo;
+        }
+        m = wantV2Ext
+            ? { viewOnceMessageV2Extension: { message: m } }
+            : { viewOnceMessageV2: { message: m } };
+        if (messageContextInfo) {
+            m.messageContextInfo = messageContextInfo;
+        }
+    }
     if (shouldIncludeReportingToken(m)) {
         m.messageContextInfo = m.messageContextInfo || {};
         if (!m.messageContextInfo.messageSecret) {

package/lib/Utils/rich-menu.js

@@ -0,0 +1,211 @@
+/**
+ * rich-menu.js — menu "rich response" (tombol + kartu geser + header gambar +
+ * footer open-URL) lewat botForwardedMessage > richResponseMessage >
+ * unifiedResponse, porting dari @vansnowi/baileys (`richMenu`).
+ *
+ * PERINGATAN (sama seperti rich-webui.js / rich-carousel.js):
+ * unifiedResponse adalah format GenAI internal WhatsApp — relayMessage bisa
+ * sukses tanpa error walau pesan tidak dirender di client penerima, dan nama
+ * typename-nya bisa berubah antar-versi WA. Tombol di sini adalah CTA widget
+ * dengan toast, BUKAN quick-reply yang mengirim balik pesan ke bot.
+ *
+ * Content yang dikembalikan siap dipakai dengan
+ * generateWAMessageFromContent(jid, content, { userJid }) lalu
+ * relayMessage(jid, msg.message, { messageId: msg.key.id }).
+ * Atau langsung: sock.richMenu(jid, content).
+ */
+import { randomBytes } from 'crypto';
+
+const IMAGE_TTL_MS = 24 * 60 * 60 * 1000;
+/** ForwardOrigin.META_AI di proto */
+const FORWARD_ORIGIN_META_AI = 4;
+
+const toolCallId = () => randomBytes(8).toString('hex');
+
+const section = (viewModel) => ({
+    __typename: 'GenAIUnifiedResponseSection',
+    view_model: viewModel
+});
+
+const single = (primitive) => section({
+    __typename: 'GenAISingleLayoutViewModel',
+    primitive
+});
+
+/** Gambar inline: dirender lewat inline entity LaTeX 1 titik (trik agar gambar muncul di dalam teks). */
+const inlineImagePrimitive = (image, { width, height, padding }) => ({
+    __typename: 'GenAIMarkdownTextUXPrimitive',
+    text: '{{header}}.{{/header}}',
+    inline_entities: [
+        {
+            __typename: 'GenAITextInlineEntity',
+            key: 'header',
+            metadata: {
+                __typename: 'GenAILatexItem',
+                latex_expression: '.',
+                font_height: 24,
+                padding,
+                latex_image: {
+                    __typename: 'GenAIMediaItem',
+                    mime_type: image.mime_type || 'image/png',
+                    url: image.url,
+                    url_fallback: image.url,
+                    width: image.width || width,
+                    height: image.height || height,
+                    expiration_timestamp_ms: Date.now() + IMAGE_TTL_MS
+                }
+            }
+        }
+    ]
+});
+
+const normalizeButton = (btn, fallbackToast) => {
+    const label = typeof btn === 'string' ? btn : btn?.label ?? btn?.text ?? '';
+    const toast = typeof btn === 'object' && btn?.toast !== undefined ? btn.toast : fallbackToast;
+    return {
+        label: String(label),
+        state: 'PENDING',
+        kind: 'OTHER',
+        tool_call_id: toolCallId(),
+        toast: {
+            label: toast || '',
+            __typename: 'GenAI3PExtWidgetToast'
+        },
+        __typename: 'GenAI3PExtWidgetCTA'
+    };
+};
+
+const widgetPrimitive = (title, buttons, toast) => ({
+    __typename: 'GenAI3PExtWidgetPrimitive',
+    header: {
+        __typename: 'GenAI3PExtWidgetStandardHeader',
+        title: title || ''
+    },
+    body: {
+        __typename: 'GenAI3PExtCalendarEventList',
+        ctas: buttons.map(btn => normalizeButton(btn, toast)),
+        sections: []
+    }
+});
+
+/**
+ * Bangun content pesan rich menu (belum dikirim).
+ *
+ * @param {object} content
+ * @param {object} [content.header]  { title, image: { url, inline, mime_type, width, height }, disclaimer, disclaimerText }
+ * @param {object} [content.body]    { title, buttons: string[], toast } atau
+ *                                   { carousel: true | row: true, cards: [{ title, buttons, toast }] }
+ * @param {object} [content.footer]  { text, url, image: { url, mime_type, width, height } } — CTA open-URL hanya dibuat jika `url` diisi
+ * @param {object} [content.contextInfo] override contextInfo richResponseMessage
+ * @returns {object} content object (kompatibel proto.Message)
+ */
+export function buildRichMenuMessage(content = {}) {
+    const { header, body, footer } = content;
+    const sections = [];
+    let messageContextInfo;
+    if (header) {
+        const { disclaimer = false, disclaimerText = ' ', image, title = '' } = header;
+        if (disclaimer) {
+            messageContextInfo = { botMetadata: { messageDisclaimerText: disclaimerText } };
+        }
+        if (title) {
+            sections.push(single({ __typename: 'FOATextPrimitive', text: '# ' + title }));
+        }
+        if (image?.url) {
+            if (image.inline) {
+                sections.push(single(inlineImagePrimitive(image, { width: 500, height: 500, padding: 4 })));
+            }
+            else {
+                sections.push(single({
+                    __typename: 'GenAIImagePrimitive',
+                    preview_image: {
+                        __typename: 'GenAIMediaItem',
+                        mime_type: image.mime_type || 'image/png',
+                        url: image.url
+                    },
+                    full_image: {
+                        __typename: 'GenAIMediaItem',
+                        mime_type: image.mime_type || 'image/png',
+                        url: image.url
+                    }
+                }));
+            }
+        }
+    }
+    if (body) {
+        const { cards, buttons, title = '', toast = '', carousel = false, row = false } = body;
+        if (carousel || row) {
+            if (cards?.length) {
+                sections.push(section({
+                    __typename: carousel ? 'GenAIHScrollLayoutViewModel' : 'GenAIActionRowLayoutViewModel',
+                    primitives: cards.map(card => widgetPrimitive(card?.title, card?.buttons || [], card?.toast))
+                }));
+            }
+        }
+        else if (buttons?.length) {
+            sections.push(single(widgetPrimitive(title, buttons, toast)));
+        }
+    }
+    if (footer) {
+        const { text = '', url = '', image } = footer;
+        const primitives = [];
+        if (url) {
+            primitives.push({
+                __typename: 'GenAIFooterActionPrimitive',
+                cta_text: text || 'Open',
+                cta_type: 'OPEN_URL',
+                cta_url: url
+            });
+        }
+        if (image?.url) {
+            primitives.push(inlineImagePrimitive(image, { width: 100, height: 100, padding: -5 }));
+        }
+        if (primitives.length) {
+            sections.push({
+                view_model: {
+                    __typename: 'GenAIActionRowLayoutViewModel',
+                    primitives
+                }
+            });
+        }
+    }
+    if (!sections.length) {
+        throw new TypeError('richMenu: header/body/footer kosong — isi minimal satu (title, image, buttons/cards, atau footer.url)');
+    }
+    return {
+        ...(messageContextInfo ? { messageContextInfo } : {}),
+        botForwardedMessage: {
+            message: {
+                richResponseMessage: {
+                    unifiedResponse: {
+                        data: Buffer.from(JSON.stringify({ sections })).toString('base64')
+                    },
+                    contextInfo: {
+                        isForwarded: true,
+                        forwardOrigin: FORWARD_ORIGIN_META_AI,
+                        ...(content.contextInfo ?? {})
+                    }
+                }
+            }
+        }
+    };
+}
+
+/**
+ * Bangun + kirim rich menu lewat socket.
+ * @param {object} sock  Baileys socket (harus punya relayMessage)
+ * @param {string} jid   JID tujuan
+ * @param {object} content lihat buildRichMenuMessage
+ * @param {object} [options] { messageId }
+ */
+export async function sendRichMenu(sock, jid, content = {}, options = {}) {
+    if (!sock || typeof sock.relayMessage !== 'function') {
+        throw new TypeError('sendRichMenu: "sock" harus instance Baileys socket yang punya relayMessage()');
+    }
+    const message = buildRichMenuMessage(content);
+    const messageId = options.messageId || ('3EB0' + randomBytes(18).toString('hex').toUpperCase());
+    await sock.relayMessage(jid, message, { messageId });
+    return { messageId, message };
+}
+
+export default { buildRichMenuMessage, sendRichMenu };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@rennzsync/baileys",
   "type": "module",
-  "version": "10.4.0",
+  "version": "10.5.0",
   "description": "renz/baileys — WhatsApp Multi-Device library rebased @whiskeysockets/baileys 7.0.0-rc14, using the original libsignal (GPL-3.0) Signal Protocol engine. Maintained by RennZz-Dev. Focus: multimedia WhatsApp bots, low RAM footprint.",
   "license": "MIT",
   "author": "RennZz-Dev (https://github.com/renzxhub)",