@vanzxy/baileys 1.5.4 → 1.5.6

package/lib/Utils/MessageBuilder.js

@@ -44,7 +44,10 @@
 
 'use strict';
 
-const MESSAGE_BUILDER_VERSION = '4.9';
+const MESSAGE_BUILDER_VERSION = '4.9.1';
+// Vanz@Fix 24-08-26: use the exported builder version everywhere; the old
+// verification helper referenced an undeclared `VERSION`, making every AIRich.build() fail.
+
 
 import { generateWAMessageFromContent, prepareWAMessageMedia } from './messages.js';
 import { generateMessageIDV2 } from './generics.js';
@@ -1009,6 +1012,106 @@ class Button extends BaseBuilder {
 		return this;
 	}
 
+
+	/** Native-flow `card_message` shortcut, matching this fork's prepareNativeFlowButtons(). */
+	addCardMessage(payload = {}) {
+		if (typeof payload !== 'object' || payload === null || Array.isArray(payload)) throw new TypeError('addCardMessage(payload) requires a plain object');
+		this._buttons.push({ name: 'card_message', buttonParamsJson: JSON.stringify(payload) });
+		return this;
+	}
+
+	/** Native-flow `order_details` shortcut. */
+	addOrderDetails(payload = {}) {
+		if (typeof payload !== 'object' || payload === null || Array.isArray(payload)) throw new TypeError('addOrderDetails(payload) requires a plain object');
+		this._buttons.push({ name: 'order_details', buttonParamsJson: JSON.stringify(payload) });
+		return this;
+	}
+
+	/** Native-flow `order_status` shortcut. */
+	addOrderStatus(payload = {}) {
+		if (typeof payload !== 'object' || payload === null || Array.isArray(payload)) throw new TypeError('addOrderStatus(payload) requires a plain object');
+		this._buttons.push({ name: 'order_status', buttonParamsJson: JSON.stringify(payload) });
+		return this;
+	}
+
+	/** Native-flow `payment_status` shortcut. */
+	addPaymentStatus(payload = {}) {
+		if (typeof payload !== 'object' || payload === null || Array.isArray(payload)) throw new TypeError('addPaymentStatus(payload) requires a plain object');
+		this._buttons.push({ name: 'payment_status', buttonParamsJson: JSON.stringify(payload) });
+		return this;
+	}
+
+	/** Native-flow `payment_method` shortcut. */
+	addPaymentMethod(payload = {}) {
+		if (typeof payload !== 'object' || payload === null || Array.isArray(payload)) throw new TypeError('addPaymentMethod(payload) requires a plain object');
+		this._buttons.push({ name: 'payment_method', buttonParamsJson: JSON.stringify(payload) });
+		return this;
+	}
+
+	/** Native-flow `track_order` shortcut. */
+	addTrackOrder(id, display_text = '🚚 Track order') {
+		if (!id) throw new TypeError('addTrackOrder(id) requires a non-empty id');
+		this._buttons.push({ name: 'track_order', buttonParamsJson: JSON.stringify({ id, display_text }) });
+		return this;
+	}
+
+	/** Native-flow `reorder` shortcut. */
+	addReorder(id, display_text = '🔁 Reorder') {
+		if (!id) throw new TypeError('addReorder(id) requires a non-empty id');
+		this._buttons.push({ name: 'reorder', buttonParamsJson: JSON.stringify({ id, display_text }) });
+		return this;
+	}
+
+	/** Native-flow `cancel_order` shortcut. */
+	addCancelOrder(id, display_text = '❌ Cancel order') {
+		if (!id) throw new TypeError('addCancelOrder(id) requires a non-empty id');
+		this._buttons.push({ name: 'cancel_order', buttonParamsJson: JSON.stringify({ id, display_text }) });
+		return this;
+	}
+
+	/** Native-flow `clear_chat` shortcut. */
+	addClearChat() {
+		this._buttons.push({ name: 'clear_chat', buttonParamsJson: '{}' });
+		return this;
+	}
+
+	/** Native-flow `navigateToScreen` shortcut. */
+	addNavigateToScreen(screen, data = {}) {
+		if (!screen) throw new TypeError('addNavigateToScreen(screen) requires a non-empty screen');
+		this._buttons.push({ name: 'navigateToScreen', buttonParamsJson: JSON.stringify({ screen_name: screen, data }) });
+		return this;
+	}
+
+	/** WhatsApp Flows `flow_action` shortcut. Requires a real registered Flow. */
+	addFlow(flow = {}, display_text = '') {
+		if (typeof flow !== 'object' || flow === null || Array.isArray(flow) || !flow.id) throw new TypeError('addFlow(flow) requires a plain object with flow.id');
+		this._buttons.push({
+			name: 'flow_action',
+			buttonParamsJson: JSON.stringify({
+				flow_message_version: flow.version || '3',
+				flow_id: flow.id,
+				flow_cta: display_text || flow.cta || 'Continue',
+				flow_action: flow.action || 'navigate',
+				flow_action_payload: flow.actionPayload || { screen: flow.screen || 'WELCOME', data: flow.data || {} },
+			}),
+		});
+		return this;
+	}
+
+	/** Native-flow `voice_call` shortcut. */
+	addVoiceCall(id, display_text = '📞 Voice call') {
+		if (!id) throw new TypeError('addVoiceCall(id) requires a non-empty id');
+		this._buttons.push({ name: 'voice_call', buttonParamsJson: JSON.stringify({ display_text, id }) });
+		return this;
+	}
+
+	/** Native-flow `video_call_button` shortcut. */
+	addVideoCall(id, display_text = '🎥 Video call') {
+		if (!id) throw new TypeError('addVideoCall(id) requires a non-empty id');
+		this._buttons.push({ name: 'video_call_button', buttonParamsJson: JSON.stringify({ display_text, id }) });
+		return this;
+	}
+
 	// Vanz@Fix (bug 43) --- paramsList documented the schema for these 3 message-level native flow
 	// params (limited_time_offer / bottom_sheet / tap_target_configuration) but no helper ever wrote
 	// them into this._params — only manual setParams() could, with zero validation against the
@@ -1811,6 +1914,72 @@ class AIRich extends BaseBuilder {
 	}
 
 	/** Add a "Sources" strip. @param {string[]|string[][]} sources Flat list of urls, or `[title, url]` pairs. */
+
+	/** Build rich-response citation/link submessages using the same shape as Baileys' `links` content shortcut. */
+	addLinks(links = []) {
+		if (!Array.isArray(links)) throw new TypeError('links must be an array');
+		links.forEach((linkField, index) => {
+			if (!linkField || typeof linkField !== 'object') throw new TypeError('Each link must be an object');
+			const prefix = 'SS_' + index;
+			const url = linkField.url || '';
+			const text = String(linkField.text ?? '');
+			const sources = Array.isArray(linkField.sources) ? linkField.sources.map((sourceField) => ({
+				source_type: 'THIRD_PARTY',
+				source_display_name: sourceField?.displayName || sourceField?.title || 'Source',
+				source_subtitle: sourceField?.subtitle || '',
+				source_url: sourceField?.url || url,
+			})) : [];
+			const entity = {
+				key: prefix,
+				metadata: {
+					reference_id: index + 1,
+					reference_url: url,
+					reference_title: linkField.title || 'Source',
+					reference_display_name: linkField.displayName || linkField.title || 'Source',
+					sources,
+					__typename: 'GenAISearchCitationItem',
+				},
+			};
+			const section = AIRich.newLayout('Single', {
+				text: `${text} {{${prefix}}}${url}{{/${prefix}}}`,
+				inline_entities: [entity],
+				__typename: 'GenAIMarkdownTextUXPrimitive',
+			});
+			this._sections.push(section);
+			this._submessages.push({
+				messageType: 2,
+				messageText: `${text} {{${prefix}}}¹{{/${prefix}}} `,
+				inlineEntities: [entity],
+			});
+		});
+		return this;
+	}
+
+	/** Add a raw rich-response content-items carousel, matching Baileys' `items` field. */
+	addContentItems(items = []) {
+		if (!Array.isArray(items)) throw new TypeError('items must be an array');
+		this._submessages.push({
+			messageType: 9,
+			contentItemsMetadata: { itemsMetadata: items, contentType: 1 },
+		});
+		this._sections.push(AIRich.newLayout('Single', {
+			items,
+			content_type: 1,
+			__typename: 'GenAIContentItemsUXPrimitive',
+		}));
+		return this;
+	}
+
+	/** Add Baileys-compatible inline-video marker. WhatsApp's current rich-response helper carries this as a text marker. */
+	addInlineVideo() {
+		this._submessages.push({ messageType: 2, messageText: 'INLINE_VIDEO' });
+		this._sections.push(AIRich.newLayout('Single', {
+			text: 'INLINE_VIDEO',
+			__typename: 'GenAIMarkdownTextUXPrimitive',
+		}));
+		return this;
+	}
+
 	addSource(sources = [], { resolveUrl = false } = {}) {
 		if (!(Array.isArray(sources) && (sources.every((item) => typeof item === 'string') || sources.every((item) => Array.isArray(item) && item.every((v) => typeof v === 'string'))))) {
 			throw new TypeError('Sources must be a string array or an array of string arrays');

package/lib/Utils/MessageBuilder_d.ts

@@ -74,6 +74,19 @@ export class Button extends BaseBuilder {
 	addTransactionDetails(payload?: Record<string, any>): this;
 	/** mpm — multi-product message. Business-catalog accounts only. */
 	addMultiProduct(payload?: Record<string, any>): this;
+	addCardMessage(payload?: Record<string, any>): this;
+	addOrderDetails(payload?: Record<string, any>): this;
+	addOrderStatus(payload?: Record<string, any>): this;
+	addPaymentStatus(payload?: Record<string, any>): this;
+	addPaymentMethod(payload?: Record<string, any>): this;
+	addTrackOrder(id: string, display_text?: string): this;
+	addReorder(id: string, display_text?: string): this;
+	addCancelOrder(id: string, display_text?: string): this;
+	addClearChat(): this;
+	addNavigateToScreen(screen: string, data?: Record<string, any>): this;
+	addFlow(flow: Record<string, any>, display_text?: string): this;
+	addVoiceCall(id: string, display_text?: string): this;
+	addVideoCall(id: string, display_text?: string): this;
 	setLimitedTimeOffer(params?: LimitedTimeOfferParams): this;
 	setBottomSheet(params?: BottomSheetParams): this;
 	setTapTargetConfiguration(params?: TapTargetConfigurationParams): this;
@@ -147,6 +160,9 @@ export class AIRich extends BaseBuilder {
 	addText(text: string, options?: AddTextOptions): this;
 	addCode(language: string, code: string): this;
 	addTable(table: string[][], options?: AddTextOptions): this;
+	addLinks(links?: Record<string, any>[]): this;
+	addContentItems(items?: Record<string, any>[]): this;
+	addInlineVideo(): this;
 	addSource(sources?: Record<string, any>[], options?: { resolveUrl?: boolean }): this;
 	addReels(reelsItems?: Record<string, any>[], options?: { resolveUrl?: boolean }): this;
 	addImage(imageUrl: string, options?: { resolveUrl?: boolean }): this;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vanzxy/baileys",
-  "version": "1.5.4",
+  "version": "1.5.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",
   "module": "./lib/index.js",