@vanzxy/baileys 1.4.2 → 1.4.4

package/cjs/lib/Utils/MessageBuilder.js

@@ -58,10 +58,10 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
-var _a, _Button_client, _Button_validateAgainstSchema, _ButtonV2_client, _Carousel_client, _AIRich_client;
+var _a, _Button_client, _Button_validateAgainstSchema, _ButtonV2_client, _Carousel_client, _Poll_client, _AIRich_client;
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Toolkit = exports.AIRich = exports.Carousel = exports.ButtonV2 = exports.Button = exports.MESSAGE_BUILDER_VERSION = void 0;
-const MESSAGE_BUILDER_VERSION = '4.6';
+exports.Toolkit = exports.VanzxyRich = exports.VanzxyAI = exports.LeafRich = exports.AIVanzxy = exports.AIRich = exports.Poll = exports.Carousel = exports.ButtonV2 = exports.Button = exports.MESSAGE_BUILDER_VERSION = void 0;
+const MESSAGE_BUILDER_VERSION = '4.7';
 exports.MESSAGE_BUILDER_VERSION = MESSAGE_BUILDER_VERSION;
 const messages_js_1 = require("./messages.js");
 const rich_message_utils_js_1 = require("./rich-message-utils.js");
@@ -318,7 +318,6 @@ class Toolkit {
                 height,
             })));
         }
-        const originalIsBuffer = Buffer.isBuffer(media);
         if (typeof media === 'string' && isUrl(media)) {
             if (isWAUrl(media)) {
                 if (resolveWAUrl) {
@@ -356,9 +355,7 @@ class Toolkit {
         if (result === 'base64') {
             return media.toString('base64');
         }
-        if (originalIsBuffer) {
-            return Toolkit.toUrl(_client, media, mediaType);
-        }
+        // Vanz@Fix 22-08-26 (v4.7): dead-branch cleanup, see ESM file for note.
         return Toolkit.toUrl(_client, media, mediaType);
     }
     static getMp4Duration(buffer, { silent = true } = {}) {
@@ -577,6 +574,9 @@ class Button extends BaseBuilder {
         return this;
     }
     addButton(name, params) {
+        if (typeof name !== 'string' || !name.trim()) {
+            throw new TypeError('addButton(name, params) requires a non-empty string name');
+        }
         this._buttons.push({
             name,
             buttonParamsJson: typeof params === 'string' ? params : JSON.stringify(params),
@@ -587,6 +587,9 @@ class Button extends BaseBuilder {
         if (this._currentSelectionIndex === -1 || this._currentSectionIndex === -1) {
             throw new Error('You need to create a selection and a section first');
         }
+        if (!title || !id) {
+            throw new TypeError('makeRow() requires both a title and an id');
+        }
         const buttonParams = JSON.parse(this._buttons[this._currentSelectionIndex].buttonParamsJson);
         buttonParams.sections[this._currentSectionIndex].rows.push({ header, title, description, id });
         this._buttons[this._currentSelectionIndex].buttonParamsJson = JSON.stringify(buttonParams);
@@ -603,12 +606,16 @@ class Button extends BaseBuilder {
         return this;
     }
     addSelection(title, options = {}) {
+        if (!title) throw new TypeError('addSelection(title) requires a non-empty title');
         this._buttons.push({ ...options, name: 'single_select', buttonParamsJson: JSON.stringify({ title, sections: [] }) });
         this._currentSelectionIndex = this._buttons.length - 1;
         this._currentSectionIndex = -1;
         return this;
     }
     addReply(display_text = '', id = '', options = {}) {
+        if (!display_text || !id) {
+            throw new TypeError('addReply(display_text, id) requires both a label and a unique id');
+        }
         this._buttons.push({
             name: 'quick_reply',
             buttonParamsJson: JSON.stringify({
@@ -619,18 +626,26 @@ class Button extends BaseBuilder {
         });
         return this;
     }
-    addCall(display_text = '', id = '', options = {}) {
+    // Vanz@Fix 22-08-26 (v4.7) --- 2nd arg now writes buttonParamsJson.phone_number instead of
+    // .id; see the ESM file's inline note for why (cta_call ignores `id`, WA keys on phone_number).
+    addCall(display_text = '', phone_number = '', options = {}) {
+        if (!display_text || !phone_number) {
+            throw new TypeError('addCall(display_text, phone_number) requires both a label and a phone number');
+        }
         this._buttons.push({
             name: 'cta_call',
             buttonParamsJson: JSON.stringify({
                 display_text,
-                id,
+                phone_number,
                 ...options,
             }),
         });
         return this;
     }
     addReminder(display_text = '', id = '', options = {}) {
+        if (!display_text || !id) {
+            throw new TypeError('addReminder(display_text, id) requires both a label and a unique id');
+        }
         this._buttons.push({
             name: 'cta_reminder',
             buttonParamsJson: JSON.stringify({
@@ -642,6 +657,9 @@ class Button extends BaseBuilder {
         return this;
     }
     addCancelReminder(display_text = '', id = '', options = {}) {
+        if (!display_text || !id) {
+            throw new TypeError('addCancelReminder(display_text, id) requires both a label and a unique id');
+        }
         this._buttons.push({
             name: 'cta_cancel_reminder',
             buttonParamsJson: JSON.stringify({
@@ -653,6 +671,9 @@ class Button extends BaseBuilder {
         return this;
     }
     addAddress(display_text = '', id = '', options = {}) {
+        if (!display_text || !id) {
+            throw new TypeError('addAddress(display_text, id) requires both a label and a unique id');
+        }
         this._buttons.push({
             name: 'address_message',
             buttonParamsJson: JSON.stringify({
@@ -670,13 +691,18 @@ class Button extends BaseBuilder {
         });
         return this;
     }
+    // Vanz@Add 22-08-26 (v4.7): merchant_url defaulted to url, see ESM file for note.
     addUrl(display_text = '', url = '', webview_interaction = false, options = {}) {
+        if (!display_text || !url) {
+            throw new TypeError('addUrl(display_text, url) requires both a label and a url');
+        }
         this._buttons.push({
             ...options,
             name: 'cta_url',
             buttonParamsJson: JSON.stringify({
                 display_text,
                 url,
+                merchant_url: url,
                 webview_interaction,
                 ...options,
             }),
@@ -684,6 +710,9 @@ class Button extends BaseBuilder {
         return this;
     }
     addCopy(display_text = '', copy_code = '', options = {}) {
+        if (!display_text || !copy_code) {
+            throw new TypeError('addCopy(display_text, copy_code) requires both a label and the text to copy');
+        }
         this._buttons.push({
             name: 'cta_copy',
             buttonParamsJson: JSON.stringify({
@@ -694,6 +723,66 @@ class Button extends BaseBuilder {
         });
         return this;
     }
+    // Vanz@Add 22-08-26 (v4.7) --- new native-flow helpers, see ESM file for full JSDoc + caveats.
+    addOpenWebview(title = '', url = '', options = {}) {
+        if (!title || !url) {
+            throw new TypeError('addOpenWebview(title, url) requires both a title and a url');
+        }
+        this._buttons.push({
+            name: 'open_webview',
+            buttonParamsJson: JSON.stringify({ title, link: { url }, ...options }),
+        });
+        return this;
+    }
+    addCatalog(display_text = '', options = {}) {
+        this._buttons.push({
+            name: 'cta_catalog',
+            buttonParamsJson: JSON.stringify({ ...(display_text ? { display_text } : {}), ...options }),
+        });
+        return this;
+    }
+    addViewCatalog(options = {}) {
+        this._buttons.push({
+            name: 'automated_greeting_message_view_catalog',
+            buttonParamsJson: JSON.stringify(options),
+        });
+        return this;
+    }
+    addCallPermission(display_text = '', options = {}) {
+        this._buttons.push({
+            name: 'call_permission_request',
+            buttonParamsJson: JSON.stringify({ ...(display_text ? { display_text } : {}), ...options }),
+        });
+        return this;
+    }
+    addPaymentInfo(payload = {}) {
+        if (typeof payload !== 'object' || payload === null || Array.isArray(payload)) {
+            throw new TypeError('addPaymentInfo(payload) requires a plain object');
+        }
+        this._buttons.push({ name: 'payment_info', buttonParamsJson: JSON.stringify(payload) });
+        return this;
+    }
+    addReviewAndPay(payload = {}) {
+        if (typeof payload !== 'object' || payload === null || Array.isArray(payload)) {
+            throw new TypeError('addReviewAndPay(payload) requires a plain object');
+        }
+        this._buttons.push({ name: 'review_and_pay', buttonParamsJson: JSON.stringify(payload) });
+        return this;
+    }
+    addTransactionDetails(payload = {}) {
+        if (typeof payload !== 'object' || payload === null || Array.isArray(payload)) {
+            throw new TypeError('addTransactionDetails(payload) requires a plain object');
+        }
+        this._buttons.push({ name: 'wa_payment_transaction_details', buttonParamsJson: JSON.stringify(payload) });
+        return this;
+    }
+    addMultiProduct(payload = {}) {
+        if (typeof payload !== 'object' || payload === null || Array.isArray(payload)) {
+            throw new TypeError('addMultiProduct(payload) requires a plain object');
+        }
+        this._buttons.push({ name: 'mpm', buttonParamsJson: JSON.stringify(payload) });
+        return this;
+    }
     setLimitedTimeOffer({ text = '', url = '', copy_code = '', expiration_time } = {}) {
         const data = { text, url, copy_code, expiration_time };
         __classPrivateFieldGet(_a, _a, "m", _Button_validateAgainstSchema).call(_a, _a.paramsList.limited_time_offer, data, 'limited_time_offer');
@@ -738,7 +827,39 @@ class Button extends BaseBuilder {
             },
         };
     }
+    // Vanz@Fix (bug: single_select alone doesn't render) --- lihat catatan yang sama
+    // di versi ESM (lib/Utils/MessageBuilder.js) untuk penjelasan lengkap.
+    _isLoneSingleSelect() {
+        return this._buttons.length === 1 && this._buttons[0].name === 'single_select';
+    }
+    _toListMessage() {
+        const { title: buttonText, sections } = JSON.parse(this._buttons[0].buttonParamsJson);
+        return {
+            listMessage: {
+                title: this._title || undefined,
+                description: this._body || undefined,
+                footerText: this._footer || undefined,
+                buttonText: buttonText || undefined,
+                listType: 1,
+                sections: (sections || []).map((s) => ({
+                    title: s.title,
+                    rows: (s.rows || []).map((r) => ({
+                        title: r.title || r.header || '',
+                        description: r.description || '',
+                        rowId: r.id || '',
+                    })),
+                })),
+                contextInfo: this._contextInfo,
+            },
+        };
+    }
     async build(jid, { ...options } = {}) {
+        if (this._buttons.length === 0) {
+            throw new Error('Button requires at least one button (use addReply/addUrl/addCall/addSelection/addButton/...)');
+        }
+        if (this._isLoneSingleSelect()) {
+            return (0, messages_js_1.generateWAMessageFromContent)(jid, { ...this._extraPayload, ...this._toListMessage() }, { ...options });
+        }
         const message = await this.toCard();
         return (0, messages_js_1.generateWAMessageFromContent)(jid, {
             ...this._extraPayload,
@@ -748,21 +869,31 @@ class Button extends BaseBuilder {
             },
         }, { ...options });
     }
+    // Vanz@Add 22-08-26 (v4.7) --- picks the native_flow node variant for the first button's
+    // name, per Button.SPECIAL_FLOW. Falls back to the generic mixed node (previous
+    // unconditional behaviour) for anything not in that map. See ESM file for source notes.
+    _buildNativeFlowNode() {
+        const special = Button.SPECIAL_FLOW[this._buttons[0]?.name];
+        return special ? { tag: 'native_flow', attrs: special } : { tag: 'native_flow', attrs: { v: '9', name: 'mixed' } };
+    }
     async send(jid, { ...options } = {}) {
         const msg = await this.build(jid, options);
+        const bizContent = this._isLoneSingleSelect()
+            ? [{ tag: 'list', attrs: { v: '2', type: 'product_list' } }]
+            : [
+                {
+                    tag: 'interactive',
+                    attrs: { type: 'native_flow', v: '1' },
+                    content: [this._buildNativeFlowNode()],
+                },
+            ];
         await __classPrivateFieldGet(this, _Button_client, "f").relayMessage(msg.key.remoteJid, msg.message, {
             messageId: msg.key.id,
             additionalNodes: [
                 {
                     tag: 'biz',
                     attrs: {},
-                    content: [
-                        {
-                            tag: 'interactive',
-                            attrs: { type: 'native_flow', v: '1' },
-                            content: [{ tag: 'native_flow', attrs: { v: '9', name: 'mixed' } }],
-                        },
-                    ],
+                    content: bizContent,
                 },
             ],
             ...options,
@@ -771,6 +902,16 @@ class Button extends BaseBuilder {
     }
 }
 exports.Button = Button;
+Button.SPECIAL_FLOW = {
+    review_and_pay: { v: '1', name: 'order_details' },
+    payment_info: { v: '1', name: 'payment_info' },
+    mpm: { v: '2', name: 'mpm' },
+    cta_catalog: { v: '2', name: 'cta_catalog' },
+    send_location: { v: '2', name: 'send_location' },
+    call_permission_request: { v: '2', name: 'call_permission_request' },
+    wa_payment_transaction_details: { v: '2', name: 'wa_payment_transaction_details' },
+    automated_greeting_message_view_catalog: { v: '2', name: 'automated_greeting_message_view_catalog' },
+};
 _a = Button, _Button_client = new WeakMap(), _Button_validateAgainstSchema = function _Button_validateAgainstSchema(schema, data, label) {
     for (const [key, type] of Object.entries(schema)) {
         if (data[key] === undefined)
@@ -820,6 +961,7 @@ class ButtonV2 extends BaseBuilder {
         this._buttons = [];
     }
     addButton(displayText = '', buttonId = crypto_1.default.randomUUID()) {
+        if (!displayText) throw new TypeError('addButton(displayText) requires a non-empty label');
         this._buttons.push({
             buttonId,
             buttonText: { displayText },
@@ -847,8 +989,10 @@ class ButtonV2 extends BaseBuilder {
         this._data = obj;
         return this;
     }
-    async build(jid, { ...options } = {}) {
-        let _thumbnail = this._image ? await Toolkit.resize(Buffer.isBuffer(this._image) ? this._image : await Toolkit.fetchBuffer(this._image, {}, { silent: true }), 300, 300) : null;
+    // Vanz@Fix 22-08-26 (v4.7): _thumbnail only computed when it'll be used; viewOnce now
+    // an overridable option (default true). See ESM file for full note.
+    async build(jid, { viewOnce = true, ...options } = {}) {
+        const _thumbnail = !this._data && this._image ? await Toolkit.resize(Buffer.isBuffer(this._image) ? this._image : await Toolkit.fetchBuffer(this._image, {}, { silent: true }), 300, 300) : null;
         const msg = (0, messages_js_1.generateWAMessageFromContent)(jid, {
             ...this._extraPayload,
             buttonsMessage: {
@@ -866,7 +1010,7 @@ class ButtonV2 extends BaseBuilder {
                             jpegThumbnail: _thumbnail,
                         },
                     }),
-                viewOnce: true,
+                viewOnce,
                 contextInfo: this._contextInfo,
                 buttons: [...this._buttons],
             },
@@ -917,6 +1061,9 @@ class Carousel extends BaseBuilder {
                 throw new Error(`Card [${baseIndex + index}] must include an image or video in header`);
             }
         }
+        if (this._cards.length + cards.length > Carousel.MAX_CARDS) {
+            throw new Error(`Carousel supports at most ${Carousel.MAX_CARDS} cards (got ${this._cards.length + cards.length})`);
+        }
         this._cards.push(...cards);
         return this;
     }
@@ -937,6 +1084,7 @@ class Carousel extends BaseBuilder {
         }, { ...options });
     }
     async send(jid, { ...options } = {}) {
+        if (this._cards.length === 0) throw new Error('Carousel requires at least one card (use addCard())');
         const msg = this.build(jid, options);
         await __classPrivateFieldGet(this, _Carousel_client, "f").relayMessage(msg.key.remoteJid, msg.message, {
             messageId: msg.key.id,
@@ -960,6 +1108,101 @@ class Carousel extends BaseBuilder {
 }
 exports.Carousel = Carousel;
 _Carousel_client = new WeakMap();
+// Vanz@Add (v4.8): Poll builder, see ESM file for full docblock/rationale.
+class Poll extends BaseBuilder {
+    constructor(client) {
+        super();
+        _Poll_client.set(this, void 0);
+        if (!client)
+            throw new Error('Socket is required');
+        __classPrivateFieldSet(this, _Poll_client, client, "f");
+        this._name = '';
+        this._values = [];
+        this._selectableCount = 1;
+        this._hideVoter = false;
+        this._canAddOption = false;
+        this._toAnnouncementGroup = false;
+        this._correctAnswer = undefined;
+        this._endDate = undefined;
+    }
+    setName(name) {
+        if (typeof name !== 'string' || !name)
+            throw new TypeError('setName(name) requires a non-empty string');
+        this._name = name;
+        return this;
+    }
+    addOption(name) {
+        if (typeof name !== 'string' || !name)
+            throw new TypeError('addOption(name) requires a non-empty string');
+        this._values.push(name);
+        return this;
+    }
+    addOptions(names) {
+        if (!Array.isArray(names) || !names.length)
+            throw new TypeError('addOptions(names) requires a non-empty array of strings');
+        names.forEach((name) => this.addOption(name));
+        return this;
+    }
+    setSelectable(count) {
+        if (typeof count !== 'number' || count < 0)
+            throw new TypeError('setSelectable(count) requires a non-negative number');
+        this._selectableCount = count;
+        return this;
+    }
+    setMultiSelect(canSelectMultiple = true) {
+        this._selectableCount = canSelectMultiple ? 0 : 1;
+        return this;
+    }
+    setHideVoter(hide = true) {
+        this._hideVoter = hide;
+        return this;
+    }
+    setCanAddOption(allow = true) {
+        this._canAddOption = allow;
+        return this;
+    }
+    setAnnouncementGroup(isAnnouncement = true) {
+        this._toAnnouncementGroup = isAnnouncement;
+        return this;
+    }
+    setEndDate(date) {
+        this._endDate = date instanceof Date ? date : new Date(date);
+        return this;
+    }
+    setQuiz(correctOptionName) {
+        if (typeof correctOptionName !== 'string' || !correctOptionName) {
+            throw new TypeError('setQuiz(correctOptionName) requires a non-empty string');
+        }
+        this._correctAnswer = correctOptionName;
+        return this;
+    }
+    build() {
+        if (!this._name)
+            throw new Error('Poll requires a name (use setName())');
+        if (this._values.length < 2)
+            throw new Error('Poll requires at least 2 options (use addOption()/addOptions())');
+        if (this._correctAnswer && !this._values.includes(this._correctAnswer)) {
+            throw new Error('setQuiz(correctOptionName) must match one of the added options exactly');
+        }
+        return {
+            poll: {
+                name: this._name,
+                values: this._values,
+                selectableCount: this._selectableCount,
+                toAnnouncementGroup: this._toAnnouncementGroup,
+                hideVoter: this._hideVoter,
+                canAddOption: this._canAddOption,
+                ...(this._endDate && { endDate: this._endDate }),
+                ...(this._correctAnswer && { pollType: 1, correctAnswer: this._correctAnswer }),
+            },
+        };
+    }
+    async send(jid, options = {}) {
+        return __classPrivateFieldGet(this, _Poll_client, "f").sendMessage(jid, this.build(), options);
+    }
+}
+exports.Poll = Poll;
+_Poll_client = new WeakMap();
 class AIRich extends BaseBuilder {
     constructor(client) {
         if (!client) {
@@ -1296,6 +1539,11 @@ class AIRich extends BaseBuilder {
         if (!((data && typeof data === 'object' && !Array.isArray(data)) || (Array.isArray(data) && data.every((item) => item && typeof item === 'object' && !Array.isArray(item))))) {
             throw new TypeError('Product items must be an object or an array of objects');
         }
+        const itemsToCheck = Array.isArray(data) ? data : [data];
+        const missingTitleAt = itemsToCheck.findIndex((item) => !item.title);
+        if (missingTitleAt !== -1) {
+            throw new TypeError(`addProduct() item[${missingTitleAt}] is missing a required "title"`);
+        }
         this._submessages.push({
             messageType: 2,
             messageText: '[ Produk tidak dapat dimuat ]',
@@ -1354,6 +1602,9 @@ class AIRich extends BaseBuilder {
         return this;
     }
     addTip(text) {
+        if (typeof text !== 'string' || !text) {
+            throw new TypeError('addTip(text) requires a non-empty string');
+        }
         this._submessages.push({
             messageType: 2,
             messageText: text,
@@ -1364,6 +1615,203 @@ class AIRich extends BaseBuilder {
         }));
         return this;
     }
+    // Vanz@Add 22-08-26 (v4.7): addHeading/addImageCard/addWidget/addFooterAction, see ESM file for full notes.
+    addHeading(text) {
+        if (typeof text !== 'string' || !text) {
+            throw new TypeError('addHeading(text) requires a non-empty string');
+        }
+        this._submessages.push({ messageType: 2, messageText: text });
+        this._sections.push(AIRich.newLayout('Single', { text, __typename: 'FOATextPrimitive' }));
+        return this;
+    }
+    addImageCard(previewUrl, fullUrl = previewUrl, { resolveUrl = false } = {}) {
+        if (!(typeof previewUrl === 'string' || Buffer.isBuffer(previewUrl))) {
+            throw new TypeError('addImageCard(previewUrl) requires a string url or buffer');
+        }
+        const preview = Toolkit.resolveMedia(__classPrivateFieldGet(this, _AIRich_client, "f"), previewUrl, 'image', { resolveUrl });
+        const full = fullUrl === previewUrl ? preview : Toolkit.resolveMedia(__classPrivateFieldGet(this, _AIRich_client, "f"), fullUrl, 'image', { resolveUrl });
+        this._submessages.push({
+            messageType: 1,
+            gridImageMetadata: {
+                gridImageUrl: { imagePreviewUrl: preview },
+                imageUrls: [{ imagePreviewUrl: preview, imageHighResUrl: full, sourceUrl: full }],
+            },
+        });
+        this._sections.push(AIRich.newLayout('Single', {
+            preview_image: { url: preview, mime_type: 'image/jpeg', __typename: 'GenAIMediaItem' },
+            full_image: { url: full, mime_type: 'image/jpeg', __typename: 'GenAIMediaItem' },
+            __typename: 'GenAIImagePrimitive',
+        }));
+        return this;
+    }
+    // Vanz@Add (v4.8): { layout } override + ctas/actions alias support, see ESM file for full notes.
+    addWidget(data = {}, { layout } = {}) {
+        const items = Array.isArray(data) ? data : [data];
+        items.forEach((item, i) => {
+            if (!item?.title) {
+                throw new TypeError(`addWidget() item[${i}] is missing a required "title"`);
+            }
+            const ctas = item.ctas ?? item.actions;
+            if (!Array.isArray(ctas) || !ctas.length) {
+                throw new TypeError(`addWidget() item[${i}] requires a non-empty "ctas" (or "actions") array`);
+            }
+        });
+        this._submessages.push({ messageType: 2, messageText: items.map((item) => item.title).join(', ') });
+        const widgets = items.map((item) => {
+            const ctas = item.ctas ?? item.actions;
+            return {
+                header: { title: item.title, __typename: 'GenAI3PExtWidgetStandardHeader' },
+                body: {
+                    sections: item.sections ?? [],
+                    ctas: ctas.map((cta, idx) => ({
+                        label: cta.label ?? '',
+                        state: cta.state ?? 'PENDING',
+                        kind: cta.kind ?? 'OTHER',
+                        tool_call_id: cta.tool_call_id ?? String(idx).padStart(2, '0'),
+                        ...(cta.toast !== false && {
+                            toast: { label: typeof cta.toast === 'string' ? cta.toast : item.title, __typename: 'GenAI3PExtWidgetToast' },
+                        }),
+                        __typename: 'GenAI3PExtWidgetCTA',
+                    })),
+                    __typename: item.body_typename ?? 'GenAI3PExtCalendarEventList',
+                },
+                __typename: 'GenAI3PExtWidgetPrimitive',
+            };
+        });
+        const resolvedLayout = layout ?? (Array.isArray(data) ? 'HScroll' : 'Single');
+        const asArray = resolvedLayout !== 'Single';
+        this._sections.push(AIRich.newLayout(resolvedLayout, asArray ? widgets : widgets[0]));
+        return this;
+    }
+    addFooterAction(actions) {
+        const items = Array.isArray(actions) ? actions : [actions];
+        items.forEach((item, i) => {
+            if (!item?.text || !item?.url) {
+                throw new TypeError(`addFooterAction() item[${i}] requires both "text" and "url"`);
+            }
+        });
+        const primitives = items.map((item) => ({
+            cta_text: item.text,
+            cta_type: item.type ?? 'OPEN_URL',
+            cta_url: item.url,
+            __typename: 'GenAIFooterActionPrimitive',
+        }));
+        this._sections.push(AIRich.newLayout('HScroll', primitives));
+        return this;
+    }
+    // Vanz@Add (v4.8): 8 primitives with no dedicated proto submessage type (except Latex), see ESM file.
+    addDivider() {
+        this._submessages.push({ messageType: 2, messageText: '---' });
+        this._sections.push(AIRich.newLayout('Single', { __typename: 'GenAIDividerPrimitive' }));
+        return this;
+    }
+    addSpacer(spacing = 1) {
+        if (typeof spacing !== 'number' || spacing < 0) {
+            throw new TypeError('addSpacer(spacing) requires a non-negative number');
+        }
+        this._submessages.push({ messageType: 2, messageText: `spasi ${spacing}` });
+        this._sections.push(AIRich.newLayout('Single', { spacing, __typename: 'GenAISpacerPrimitive' }));
+        return this;
+    }
+    addLatex(expression) {
+        if (typeof expression !== 'string' || !expression) {
+            throw new TypeError('addLatex(expression) requires a non-empty string');
+        }
+        this._submessages.push({
+            messageType: 8,
+            latexMetadata: { text: expression, expressions: [{ latexExpression: expression }] },
+        });
+        this._sections.push(AIRich.newLayout('Single', { latex_expression: expression, __typename: 'GenAILatexUXPrimitive' }));
+        return this;
+    }
+    addTask(data = {}) {
+        if (!data?.title) {
+            throw new TypeError('addTask() requires a "title"');
+        }
+        this._submessages.push({ messageType: 2, messageText: `Tugas: ${data.title}` });
+        this._sections.push(AIRich.newLayout('Single', {
+            task_id: data.task_id ?? '',
+            title: data.title,
+            subtitle: data.subtitle ?? '',
+            status: data.status ?? 'IN_PROGRESS',
+            __typename: 'GenAITaskPrimitive',
+        }));
+        return this;
+    }
+    addProgressStatus(title, { icon = 'SEARCH', is_in_progress = true, target_secondary_screen_id, target_secondary_screen_tab_id } = {}) {
+        if (typeof title !== 'string' || !title) {
+            throw new TypeError('addProgressStatus(title) requires a non-empty string');
+        }
+        this._submessages.push({ messageType: 2, messageText: title });
+        const primitive = {
+            title, icon, is_in_progress,
+            meta_search_apps: [],
+            __typename: 'GenAIBotProgressStatusPrimitive',
+        };
+        // Must be omitted when unset, not sent as null — explicit null here crashed the WA client renderer.
+        if (target_secondary_screen_id != null) primitive.target_secondary_screen_id = target_secondary_screen_id;
+        if (target_secondary_screen_tab_id != null) primitive.target_secondary_screen_tab_id = target_secondary_screen_tab_id;
+        this._sections.push(AIRich.newLayout('Single', primitive));
+        return this;
+    }
+    addThinkingStatus(title, { icon = 'THINKING', is_in_progress = true, target_secondary_screen_id, target_secondary_screen_tab_id, textFallback = true } = {}) {
+        if (typeof title !== 'string' || !title) {
+            throw new TypeError('addThinkingStatus(title) requires a non-empty string');
+        }
+        this._submessages.push({ messageType: 2, messageText: title });
+        const primitive = {
+            title, icon, is_in_progress,
+            meta_search_apps: [],
+            __typename: 'GenAIBotThinkingStatusPrimitive',
+        };
+        if (target_secondary_screen_id != null) primitive.target_secondary_screen_id = target_secondary_screen_id;
+        if (target_secondary_screen_tab_id != null) primitive.target_secondary_screen_tab_id = target_secondary_screen_tab_id;
+        this._sections.push(AIRich.newLayout('Single', primitive));
+        // Safety net: stock WA client renders this as blank (native UI is a transient spinner).
+        if (textFallback) {
+            this._sections.push(AIRich.newLayout('Single', { text: title, __typename: 'FOATextPrimitive' }));
+        }
+        return this;
+    }
+    addQuotaUpsell(data = {}) {
+        if (!data?.title) {
+            throw new TypeError('addQuotaUpsell() requires a "title"');
+        }
+        this._submessages.push({ messageType: 2, messageText: data.title });
+        this._sections.push(AIRich.newLayout('Single', {
+            title: data.title,
+            body: data.body ?? '',
+            body_line1: data.body_line1 ?? '',
+            body_line2: data.body_line2 ?? '',
+            buttons: (data.buttons ?? []).map((b) => ({
+                label: b.label ?? '',
+                action: b.action ?? 'OPEN_DEEPLINK',
+                deeplink: b.deeplink ?? '',
+            })),
+            __typename: 'GenAIMetaSubsQuotaUpsellPrimitive',
+        }));
+        return this;
+    }
+    addBloks(data = {}) {
+        if (!data?.type) {
+            throw new TypeError('addBloks() requires a "type"');
+        }
+        this._submessages.push({ messageType: 2, messageText: 'Bloks' });
+        const primitive = {
+            type: data.type,
+            data: data.data ?? '{}',
+            uuid: data.uuid ?? '',
+            versioning_id: data.versioning_id ?? '',
+            __typename: 'FOABloksPrimitive',
+        };
+        if (data.initial_response != null) primitive.initial_response = data.initial_response;
+        this._sections.push(AIRich.newLayout('Single', primitive));
+        // Safety net: FOABloksPrimitive needs a real registered Bloks screen to render anything.
+        if (data.textFallback !== false) {
+            this._sections.push(AIRich.newLayout('Single', { text: `Bloks: ${data.type}`, __typename: 'FOATextPrimitive' }));
+        }
+        return this;
+    }
     addSuggest(suggestion, { scroll = true, layout } = {}) {
         if (!(typeof suggestion === 'string' || (Array.isArray(suggestion) && suggestion.every((v) => typeof v === 'string')))) {
             throw new TypeError('Suggestion must be a string or array of strings');
@@ -1469,10 +1917,6 @@ class AIRich extends BaseBuilder {
     // for bot-sent messages (confirmed: even a valid WA-CDN url with mediaKey stays blank), so any
     // image added via addInlineImage() is sent here as a normal imageMessage instead. Pass
     // { skipImageFallback: true } to opt out and send only the (image-less-looking) rich card.
-    // Vanz@Fix (bug 42 / inline image fallback) --- WA won't render AIRichResponseInlineImageMetadata
-    // for bot-sent messages (confirmed: even a valid WA-CDN url with mediaKey stays blank), so any
-    // image added via addInlineImage() is sent here as a normal imageMessage instead. Pass
-    // { skipImageFallback: true } to opt out and send only the (image-less-looking) rich card.
     // Vanz@Fix: don't spread relayMessage-shaped `options` into sendMessage()'s options param —
     // the two calls expect different option shapes, so the fallback now only forwards `quoted`
     // (the one option that clearly applies to both) instead of blindly spreading everything.
@@ -2161,4 +2605,9 @@ class AIRich extends BaseBuilder {
     }
 }
 exports.AIRich = AIRich;
+// Vanz@Alias --- lihat catatan yang sama di versi ESM (lib/Utils/MessageBuilder.js)
+exports.AIVanzxy = AIRich;
+exports.LeafRich = AIRich;
+exports.VanzxyAI = AIRich;
+exports.VanzxyRich = AIRich;
 _AIRich_client = new WeakMap();