@vanzxy/baileys 1.4.4 → 1.4.6

package/cjs/lib/Utils/MessageBuilder.js

@@ -61,7 +61,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 var _a, _Button_client, _Button_validateAgainstSchema, _ButtonV2_client, _Carousel_client, _Poll_client, _AIRich_client;
 Object.defineProperty(exports, "__esModule", { value: true });
 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';
+const MESSAGE_BUILDER_VERSION = '4.8';
 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");
@@ -1736,6 +1736,11 @@ class AIRich extends BaseBuilder {
             status: data.status ?? 'IN_PROGRESS',
             __typename: 'GenAITaskPrimitive',
         }));
+        // Safety net: stock WA client doesn't render this primitive visibly.
+        if (data.textFallback !== false) {
+            const fallbackText = data.subtitle ? `${data.title} — ${data.subtitle}` : data.title;
+            this._sections.push(AIRich.newLayout('Single', { text: `Tugas: ${fallbackText}`, __typename: 'FOATextPrimitive' }));
+        }
         return this;
     }
     addProgressStatus(title, { icon = 'SEARCH', is_in_progress = true, target_secondary_screen_id, target_secondary_screen_tab_id } = {}) {
@@ -2594,6 +2599,69 @@ class AIRich extends BaseBuilder {
             unified_rows,
         };
     }
+    addGenerating({ imagine_type = 'IMAGE', estimated_completion_time, textFallback = true } = {}) {
+        this._submessages.push({ messageType: 2, messageText: '[ Sedang diproses... ]' });
+        this._sections.push(AIRich.newLayout('Single', {
+            media: { url: '', mime_type: imagine_type === 'ANIMATE' ? 'video/mp4' : 'image/png' },
+            imagine_type,
+            status: {
+                status: 'GENERATING',
+                estimated_completion_time: estimated_completion_time ?? Math.floor(Date.now() / 1000) + 30,
+            },
+            __typename: 'GenAIImaginePrimitive',
+        }));
+        // Vanz@Fix 23-08-26 (v4.8) --- instant FOATextPrimitive fallback instead of
+        // relying on WA's own generation-timeout text. Set { textFallback: false } to skip.
+        if (textFallback) {
+            this._sections.push(AIRich.newLayout('Single', { text: '[ Sedang diproses... ]', __typename: 'FOATextPrimitive' }));
+        }
+        return this;
+    }
+    static async sendSupportPayload(client, jid, text, { ticketId = crypto_1.default.randomUUID(), isAiMessage = true, shouldShowSystemMessage = true, version = 1 } = {}) {
+        if (!client) throw new Error('Socket is required');
+        if (typeof text !== 'string' || !text) throw new TypeError('sendSupportPayload(client, jid, text) requires a non-empty string text');
+        const msg = {
+            conversation: text,
+            messageContextInfo: {
+                messageSecret: crypto_1.default.randomBytes(32),
+                supportPayload: JSON.stringify({
+                    version,
+                    is_ai_message: isAiMessage,
+                    should_show_system_message: shouldShowSystemMessage,
+                    ticket_id: ticketId,
+                }),
+            },
+        };
+        return client.relayMessage(jid, msg, {
+            additionalNodes: [
+                { tag: 'bot', attrs: { biz_bot: '1' } },
+                { tag: 'biz', attrs: {} },
+            ],
+        });
+    }
+    static async sendPairedMedia(client, jid, { image, video } = {}) {
+        if (!client) throw new Error('Socket is required');
+        if (!image || !video) throw new TypeError('sendPairedMedia() requires both "image" and "video"');
+        const imagePrepared = await (0, messages_js_1.prepareWAMessageMedia)({ image: typeof image === 'string' ? { url: image } : image }, { upload: client.waUploadToServer });
+        const videoPrepared = await (0, messages_js_1.prepareWAMessageMedia)({ video: typeof video === 'string' ? { url: video } : video }, { upload: client.waUploadToServer });
+        const imageMsg = (0, messages_js_1.generateWAMessageFromContent)(jid, {
+            imageMessage: {
+                ...imagePrepared.imageMessage,
+                contextInfo: { pairedMediaType: 5, statusSourceType: 0 },
+            },
+        }, {});
+        await client.relayMessage(jid, imageMsg.message, { messageId: imageMsg.key.id });
+        await client.relayMessage(jid, {
+            videoMessage: {
+                ...videoPrepared.videoMessage,
+                contextInfo: { pairedMediaType: 6, statusSourceType: 0 },
+            },
+            messageContextInfo: {
+                messageAssociation: { associationType: 12, parentMessageKey: imageMsg.key },
+            },
+        }, {});
+        return imageMsg.key;
+    }
     static newLayout(name, data, extra = {}) {
         return {
             ...extra,

package/cjs/lib/WABinary/generic-utils.js

@@ -166,7 +166,8 @@ const FLOWS_MAP = {
     authentication_button: true,
     cta_reminder: true,
     cta_cancel_reminder: true,
-    single_select: true,
+    // Vanz@Fix (single_select never renders alone) --- see ESM copy for full note.
+    // Removed on purpose so single_select always falls through to the mixed-flow branch.
 };
 const DECISION_SOURCE_CONTENT = [
     {

package/lib/Utils/MessageBuilder.d.ts

@@ -170,7 +170,7 @@ export class AIRich extends BaseBuilder {
 	/** GenAILatexUXPrimitive — has a real AI_RICH_RESPONSE_LATEX submessage (unlike most primitives here). */
 	addLatex(expression: string): this;
 	/** GenAITaskPrimitive — task/checklist card. */
-	addTask(data: { task_id?: string; title: string; subtitle?: string; status?: string }): this;
+	addTask(data: { task_id?: string; title: string; subtitle?: string; status?: string; textFallback?: boolean }): this;
 	/** GenAIBotProgressStatusPrimitive — one-shot "searching/working" status chip. */
 	addProgressStatus(title: string, options?: { icon?: string; is_in_progress?: boolean; target_secondary_screen_id?: string; target_secondary_screen_tab_id?: string }): this;
 	/** GenAIBotThinkingStatusPrimitive — one-shot "thinking" status chip. */
@@ -180,12 +180,18 @@ export class AIRich extends BaseBuilder {
 	/** FOABloksPrimitive — raw Bloks payload; most experimental primitive, fields passed through as-is. */
 	addBloks(data: { type: string; data?: string; uuid?: string; initial_response?: any; versioning_id?: string; textFallback?: boolean }): this;
 	addSuggest(suggestion: Record<string, any>, options?: { scroll?: boolean; layout?: string }): this;
+	/** GenAIImaginePrimitive with status GENERATING — pending-generation placeholder, distinct from addImage()/addVideo()'s READY status. */
+	addGenerating(options?: { imagine_type?: 'IMAGE' | 'ANIMATE'; estimated_completion_time?: number; textFallback?: boolean }): this;
 	build(): Record<string, any>;
 	send(jid: string, options?: Record<string, any>): Promise<any>;
 
 	static tokenizer(code: string, lang?: string): Record<string, any>;
 	static toTableMetadata(arr: string[][], options?: AddTextOptions): Record<string, any>;
 	static newLayout(name: string, data: Record<string, any> | Record<string, any>[], extra?: Record<string, any>): Record<string, any>;
+	/** Send a support-ticket marker message (messageContextInfo.supportPayload). */
+	static sendSupportPayload(client: any, jid: string, text: string, options?: { ticketId?: string; isAiMessage?: boolean; shouldShowSystemMessage?: boolean; version?: number }): Promise<any>;
+	/** Send an image + video as one paired-media unit (messageAssociation). */
+	static sendPairedMedia(client: any, jid: string, media: { image: string | Buffer; video: string | Buffer }): Promise<any>;
 }
 
 // Same class as AIRich — exported under alternate names (see Vanz@Alias in

package/lib/Utils/MessageBuilder.js

@@ -10,6 +10,12 @@
  * and message-authenticity fields backported from arslan-baileys 1.1.0 and
  * this project's own rich-message-utils.js. See changes tagged "Vanz@" below.
  *
+ * Vanz@Fix 23-08-26 --- v4.7 -> v4.8. addGenerating() now defaults to appending a
+ *   FOATextPrimitive text fallback ('[ Sedang diproses... ]'), same pattern as
+ *   addTask/addThinkingStatus/addBloks. Previously the card had no client-visible
+ *   content until WA's own timeout swapped it for its built-in failed-generation
+ *   text; this makes the fallback instant. Opt out with { textFallback: false }.
+ *
  * Vanz@Merge 22-08-26 --- v4.6 -> v4.7. Button class hardened + extended:
  *   - Bug fix: addCall() wrote its second arg into buttonParamsJson.id, but
  *     the cta_call native-flow schema keys on `phone_number` (id is ignored
@@ -38,7 +44,7 @@
 
 'use strict';
 
-const MESSAGE_BUILDER_VERSION = '4.7';
+const MESSAGE_BUILDER_VERSION = '4.8';
 
 import { generateWAMessageFromContent, prepareWAMessageMedia } from './messages.js';
 import { botMetadataSignature, botMetadataCertificate } from './rich-message-utils.js';
@@ -2308,6 +2314,13 @@ class AIRich extends BaseBuilder {
 				__typename: 'GenAITaskPrimitive',
 			})
 		);
+		// Safety net: GenAITaskPrimitive is a custom AI-only component the stock WA client
+		// doesn't render visibly. Append a plain text section so the task is still visible.
+		// Set data.textFallback = false to skip.
+		if (data.textFallback !== false) {
+			const fallbackText = data.subtitle ? `${data.title} — ${data.subtitle}` : data.title;
+			this._sections.push(AIRich.newLayout('Single', { text: `Tugas: ${fallbackText}`, __typename: 'FOATextPrimitive' }));
+		}
 		return this;
 	}
 
@@ -3275,6 +3288,119 @@ class AIRich extends BaseBuilder {
 		};
 	}
 
+	/**
+	 * Add an "AI is generating..." placeholder card (`GenAIImaginePrimitive` with status
+	 * GENERATING) — distinct from addImage()/addVideo() which always send status READY.
+	 * Use this to show a pending-generation state before the real media is ready.
+	 * @param {{ imagine_type?: 'IMAGE'|'ANIMATE', estimated_completion_time?: number }} [options]
+	 */
+	addGenerating({ imagine_type = 'IMAGE', estimated_completion_time, textFallback = true } = {}) {
+		this._submessages.push({ messageType: 2, messageText: '[ Sedang diproses... ]' });
+		this._sections.push(
+			AIRich.newLayout('Single', {
+				media: { url: '', mime_type: imagine_type === 'ANIMATE' ? 'video/mp4' : 'image/png' },
+				imagine_type,
+				status: {
+					status: 'GENERATING',
+					estimated_completion_time: estimated_completion_time ?? Math.floor(Date.now() / 1000) + 30,
+				},
+				__typename: 'GenAIImaginePrimitive',
+			})
+		);
+		// Vanz@Fix 23-08-26 (v4.8) --- media.url kosong + status GENERATING gak punya renderer
+		// visual instan di stock WA client; sebelumnya cuma diem sampe WA nge-timeout sendiri
+		// dan nampilin fallback bawaannya ("Saat ini, saya tidak bisa membuat gambar itu...").
+		// Same fix class kayak addTask/addBloks: append FOATextPrimitive biar ada fallback
+		// instan, gak perlu nunggu timeout WA. Set { textFallback: false } buat skip.
+		if (textFallback) {
+			this._sections.push(AIRich.newLayout('Single', { text: '[ Sedang diproses... ]', __typename: 'FOATextPrimitive' }));
+		}
+		return this;
+	}
+
+	/**
+	 * Send a support-ticket marker message (`messageContextInfo.supportPayload`) — a plain
+	 * conversation message tagged as an AI/support-bot ticket, distinct from richResponseMessage.
+	 * @param {import('../../WAProto/index.js').WASocket} client
+	 * @param {string} jid
+	 * @param {string} text
+	 * @param {{ ticketId?: string, isAiMessage?: boolean, shouldShowSystemMessage?: boolean, version?: number }} [options]
+	 */
+	static async sendSupportPayload(client, jid, text, { ticketId = crypto.randomUUID(), isAiMessage = true, shouldShowSystemMessage = true, version = 1 } = {}) {
+		if (!client) throw new Error('Socket is required');
+		if (typeof text !== 'string' || !text) throw new TypeError('sendSupportPayload(client, jid, text) requires a non-empty string text');
+
+		const msg = {
+			conversation: text,
+			messageContextInfo: {
+				messageSecret: crypto.randomBytes(32),
+				supportPayload: JSON.stringify({
+					version,
+					is_ai_message: isAiMessage,
+					should_show_system_message: shouldShowSystemMessage,
+					ticket_id: ticketId,
+				}),
+			},
+		};
+
+		return client.relayMessage(jid, msg, {
+			additionalNodes: [
+				{ tag: 'bot', attrs: { biz_bot: '1' } },
+				{ tag: 'biz', attrs: {} },
+			],
+		});
+	}
+
+	/**
+	 * Send an image and video as one paired-media unit (image sent first, video linked to it via
+	 * `messageAssociation`). Distinct from a plain album — the client treats them as a single group.
+	 * @param {import('../../WAProto/index.js').WASocket} client
+	 * @param {string} jid
+	 * @param {{ image: string|Buffer, video: string|Buffer }} media
+	 */
+	static async sendPairedMedia(client, jid, { image, video } = {}) {
+		if (!client) throw new Error('Socket is required');
+		if (!image || !video) throw new TypeError('sendPairedMedia() requires both "image" and "video"');
+
+		const imagePrepared = await prepareWAMessageMedia(
+			{ image: typeof image === 'string' ? { url: image } : image },
+			{ upload: client.waUploadToServer }
+		);
+		const videoPrepared = await prepareWAMessageMedia(
+			{ video: typeof video === 'string' ? { url: video } : video },
+			{ upload: client.waUploadToServer }
+		);
+
+		const imageMsg = generateWAMessageFromContent(
+			jid,
+			{
+				imageMessage: {
+					...imagePrepared.imageMessage,
+					contextInfo: { pairedMediaType: 5, statusSourceType: 0 },
+				},
+			},
+			{}
+		);
+
+		await client.relayMessage(jid, imageMsg.message, { messageId: imageMsg.key.id });
+
+		await client.relayMessage(
+			jid,
+			{
+				videoMessage: {
+					...videoPrepared.videoMessage,
+					contextInfo: { pairedMediaType: 6, statusSourceType: 0 },
+				},
+				messageContextInfo: {
+					messageAssociation: { associationType: 12, parentMessageKey: imageMsg.key },
+				},
+			},
+			{}
+		);
+
+		return imageMsg.key;
+	}
+
 	/** Build a raw submessage layout block by name — escape hatch for layouts not covered by the add*() helpers. */
 	static newLayout(name, data, extra = {}) {
 		return {

package/lib/WABinary/generic-utils.js

@@ -153,7 +153,14 @@ const FLOWS_MAP = {
     authentication_button: true,
     cta_reminder: true,
     cta_cancel_reminder: true,
-    single_select: true,
+    // Vanz@Fix (single_select never renders alone) --- single_select must NEVER get
+    // its own dedicated native_flow node here. WhatsApp only renders a single_select
+    // button through the generic <native_flow v='9' name='mixed'> node — the same one
+    // used when it's combined with other buttons. Giving it a dedicated
+    // <native_flow v='2' name='single_select'> node (like the other FLOWS_MAP entries)
+    // silently fails to render client-side, whether single_select is alone or is simply
+    // the first button in the array. Removed from this map on purpose so it always
+    // falls through to the `flowMsg` mixed-flow branch below.
 };
 const DECISION_SOURCE_CONTENT = [
     {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vanzxy/baileys",
-  "version": "1.4.4",
+  "version": "1.4.6",
   "description": "Enhanced Baileys fork by Vanzxy — based on @itsliaaa/baileys + @whiskeysockets/baileys with fixes for audio group status and clean media without newsletter button.",
   "type": "module",
   "main": "./cjs/lib/index.js",