@vanzxy/baileys 1.4.3 → 1.4.5

package/cjs/lib/Utils/MessageBuilder.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 } = {}) {
@@ -1754,7 +1759,7 @@ class AIRich extends BaseBuilder {
         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 } = {}) {
+    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');
         }
@@ -1767,6 +1772,10 @@ class AIRich extends BaseBuilder {
         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 = {}) {
@@ -1802,6 +1811,10 @@ class AIRich extends BaseBuilder {
         };
         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 } = {}) {
@@ -2586,6 +2599,64 @@ class AIRich extends BaseBuilder {
             unified_rows,
         };
     }
+    addGenerating({ imagine_type = 'IMAGE', estimated_completion_time } = {}) {
+        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',
+        }));
+        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,22 +170,28 @@ 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. */
-	addThinkingStatus(title: string, options?: { icon?: string; is_in_progress?: boolean; target_secondary_screen_id?: string; target_secondary_screen_tab_id?: string }): this;
+	addThinkingStatus(title: string, options?: { icon?: string; is_in_progress?: boolean; target_secondary_screen_id?: string; target_secondary_screen_tab_id?: string; textFallback?: boolean }): this;
 	/** GenAIMetaSubsQuotaUpsellPrimitive — subscription-quota-limit upsell card. */
 	addQuotaUpsell(data: { title: string; body?: string; body_line1?: string; body_line2?: string; buttons?: { label: string; action?: string; deeplink?: string }[] }): this;
 	/** 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 }): this;
+	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 }): 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

@@ -2308,6 +2308,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;
 	}
 
@@ -2340,7 +2347,7 @@ class AIRich extends BaseBuilder {
 	}
 
 	/** Add a "thinking" status banner (`GenAIBotThinkingStatusPrimitive`). See `addProgressStatus()`. */
-	addThinkingStatus(title, { icon = 'THINKING', is_in_progress = true, target_secondary_screen_id, target_secondary_screen_tab_id } = {}) {
+	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');
 		}
@@ -2356,6 +2363,12 @@ class AIRich extends BaseBuilder {
 		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 doesn't render this primitive's own view (it's meant
+		// as a transient spinner in the official app), so the card shows blank when forwarded.
+		// Append a plain text section so the title is still visible. Set { textFallback: false } to skip.
+		if (textFallback) {
+			this._sections.push(AIRich.newLayout('Single', { text: title, __typename: 'FOATextPrimitive' }));
+		}
 		return this;
 	}
 
@@ -2406,6 +2419,12 @@ class AIRich extends BaseBuilder {
 		// Omit initial_response entirely when unset — same null-field crash as addProgressStatus/addThinkingStatus.
 		if (data.initial_response != null) primitive.initial_response = data.initial_response;
 		this._sections.push(AIRich.newLayout('Single', primitive));
+		// Safety net: FOABloksPrimitive needs a real, client-registered Bloks screen to render
+		// anything — arbitrary/placeholder payloads show up blank. Append a plain text section
+		// so the card isn't empty. Set data.textFallback = false to skip.
+		if (data.textFallback !== false) {
+			this._sections.push(AIRich.newLayout('Single', { text: `Bloks: ${data.type}`, __typename: 'FOATextPrimitive' }));
+		}
 		return this;
 	}
 
@@ -3263,6 +3282,111 @@ 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 } = {}) {
+		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',
+			})
+		);
+		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.3",
+  "version": "1.4.5",
   "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",