@vanzxy/baileys 1.4.6 → 1.4.7

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.8';
+const MESSAGE_BUILDER_VERSION = '4.9';
 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");
@@ -1378,7 +1378,7 @@ class AIRich extends BaseBuilder {
         }))));
         return this;
     }
-    addImage(imageUrl, { resolveUrl = false } = {}) {
+    addImage(imageUrl, { resolveUrl = false, instant = false } = {}) {
         if (!(typeof imageUrl === 'string' || Buffer.isBuffer(imageUrl) || (Array.isArray(imageUrl) && imageUrl.every((v) => typeof v === 'string' || Buffer.isBuffer(v))))) {
             throw new TypeError('imageUrl must be string | buffer | array of string/buffer');
         }
@@ -1420,6 +1420,9 @@ class AIRich extends BaseBuilder {
                 status: { status: 'READY' },
                 __typename: 'GenAIImaginePrimitive',
             }));
+            if (instant) {
+                this._inlineImages.push({ url: imagePreviewUrl, caption: undefined });
+            }
         });
         return this;
     }

package/lib/Utils/MessageBuilder.js

@@ -44,7 +44,7 @@
 
 'use strict';
 
-const MESSAGE_BUILDER_VERSION = '4.8';
+const MESSAGE_BUILDER_VERSION = '4.9';
 
 import { generateWAMessageFromContent, prepareWAMessageMedia } from './messages.js';
 import { botMetadataSignature, botMetadataCertificate } from './rich-message-utils.js';
@@ -1587,6 +1587,68 @@ class AIRich extends BaseBuilder {
 		// mediaKey still doesn't render, so it's a trust-chain gate, not a domain/encoding issue).
 		// Track every addInlineImage() call here so send() can fall back to a normal imageMessage.
 		this._inlineImages = [];
+
+		// Vanz@Add (v4.9.1) --- { id, insertAt } support for every add*()/set*() call, without
+		// touching each method's own body/signature. Every add*() call ends up pushing 0-N items
+		// onto _submessages and 0-N onto _sections (some push to both, some to just one — e.g.
+		// addSuggest only touches _submessages, addSection only touches _sections). A Proxy wraps
+		// every add*/set* call: it snapshots array lengths before calling the real method, lets the
+		// method push onto the tail as it always has, then — if the caller passed { insertAt } —
+		// peels those freshly-pushed items back off the tail and re-splices them right after the
+		// last item that belongs to the block named by insertAt. Blocks are tracked by *object
+		// reference*, not saved numeric index, so earlier insertions shifting the array around never
+		// invalidates a later insertAt lookup (indexOf on the reference always finds the live position).
+		this._blocks = new Map(); // id -> { subItems: object[], secItems: object[] }
+		return new Proxy(this, {
+			get(target, prop, receiver) {
+				const orig = Reflect.get(target, prop, receiver);
+				if (typeof orig !== 'function' || !/^(add|set)/.test(String(prop))) return orig;
+
+				return (...args) => {
+					const opts = args.find((a) => a && typeof a === 'object' && !Array.isArray(a) && !Buffer.isBuffer(a) && ('id' in a || 'insertAt' in a));
+					const id = opts?.id;
+					const insertAt = opts?.insertAt;
+
+					const subBefore = target._submessages.length;
+					const secBefore = target._sections.length;
+
+					const result = orig.apply(receiver, args);
+
+					const subItems = target._submessages.splice(subBefore);
+					const secItems = target._sections.splice(secBefore);
+
+					if (insertAt) {
+						const anchor = target._blocks.get(insertAt);
+						if (!anchor) throw new Error(`insertAt: no block registered with id "${insertAt}" (register it by passing { id: "${insertAt}" } on an earlier add*() call)`);
+
+						const lastSub = anchor.subItems[anchor.subItems.length - 1];
+						const subIdx = lastSub ? target._submessages.indexOf(lastSub) + 1 : target._submessages.length;
+						target._submessages.splice(subIdx, 0, ...subItems);
+
+						const lastSec = anchor.secItems[anchor.secItems.length - 1];
+						const secIdx = lastSec ? target._sections.indexOf(lastSec) + 1 : target._sections.length;
+						target._sections.splice(secIdx, 0, ...secItems);
+					} else {
+						target._submessages.push(...subItems);
+						target._sections.push(...secItems);
+					}
+
+					if (id) target._blocks.set(id, { subItems, secItems });
+
+					return result === target ? receiver : result;
+				};
+			},
+		});
+	}
+
+	/** Flatten every primitive pushed into `_sections` so far into one array — lets you build a
+	 * card set in one AIRich instance and re-embed it into another via addSection(AIRich.newLayout(...)). */
+	get items() {
+		return this._sections.flatMap((s) => {
+			const vm = s?.view_model;
+			if (!vm) return [];
+			return vm.primitives ?? (vm.primitive !== undefined ? [vm.primitive] : []);
+		});
 	}
 
 	/** Push a raw pre-built submessage block (escape hatch for shapes not covered by the add*() helpers). */
@@ -1703,7 +1765,7 @@ class AIRich extends BaseBuilder {
 	}
 
 	/** Add a "Sources" strip. @param {string[]|string[][]} sources Flat list of urls, or `[title, url]` pairs. */
-	addSource(sources = []) {
+	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');
 		}
@@ -1718,7 +1780,7 @@ class AIRich extends BaseBuilder {
 			source_subtitle: 'AI',
 			source_url: url ?? '',
 			favicon: {
-				url: Toolkit.resolveMedia(this.#client, icon ?? '', 'image'),
+				url: Toolkit.resolveMedia(this.#client, icon ?? '', 'image', { resolveUrl }),
 				mime_type: 'image/jpeg',
 				width: 16,
 				height: 16,
@@ -1736,7 +1798,7 @@ class AIRich extends BaseBuilder {
 	}
 
 	/** Add a horizontally-scrollable reel of image/video items. */
-	addReels(reelsItems = []) {
+	addReels(reelsItems = [], { resolveUrl = false } = {}) {
 		if (
 			!(
 				(reelsItems && typeof reelsItems === 'object' && !Array.isArray(reelsItems)) ||
@@ -1752,8 +1814,8 @@ class AIRich extends BaseBuilder {
 
 		const reels = reelsItems.map((item) => ({
 			...item,
-			_avatar: Toolkit.resolveMedia(this.#client, item.profileIconUrl ?? item.profile_url ?? item.profile ?? '', 'image'),
-			_thumbnail: Toolkit.resolveMedia(this.#client, item.thumbnailUrl ?? item.thumbnail ?? '', 'image'),
+			_avatar: Toolkit.resolveMedia(this.#client, item.profileIconUrl ?? item.profile_url ?? item.profile ?? '', 'image', { resolveUrl }),
+			_thumbnail: Toolkit.resolveMedia(this.#client, item.thumbnailUrl ?? item.thumbnail ?? '', 'image', { resolveUrl }),
 		}));
 
 		this._submessages.push({
@@ -1806,10 +1868,24 @@ class AIRich extends BaseBuilder {
 	}
 
 	/** Add a full-width image (or grid of images if `imageUrl` is an array). */
-	addImage(imageUrl, { resolveUrl = false } = {}) {
+	/**
+	 * @param {{ resolveUrl?: boolean, instant?: boolean|'only' }} [options]
+	 * `instant: true` — sends BOTH: the GRID_IMAGE card (still shows WA's "can't verify"
+	 *   forwarded-download prompt, unavoidable per-design of botForwardedMessage) AND a plain
+	 *   (non-forwarded) imageMessage via send()'s inline-image fallback queue (`_inlineImages`,
+	 *   shared with addInlineImage()) that renders instantly with no prompt. Two images, by design.
+	 * `instant: 'only'` — Vanz@Add (v4.9.2): skips building the GRID_IMAGE card entirely (no
+	 *   submessage, no GenAIImaginePrimitive section) and queues ONLY the plain imageMessage.
+	 *   One image, no prompt, nothing to download — use this when you don't need the rich card,
+	 *   just the picture to show up immediately.
+	 */
+	addImage(imageUrl, { resolveUrl = false, instant = false } = {}) {
 		if (!(typeof imageUrl === 'string' || Buffer.isBuffer(imageUrl) || (Array.isArray(imageUrl) && imageUrl.every((v) => typeof v === 'string' || Buffer.isBuffer(v))))) {
 			throw new TypeError('imageUrl must be string | buffer | array of string/buffer');
 		}
+		if (instant !== false && instant !== true && instant !== 'only') {
+			throw new TypeError(`instant must be false, true, or 'only' — got ${JSON.stringify(instant)}`);
+		}
 
 		const list = Array.isArray(imageUrl)
 			? imageUrl.map((v) => {
@@ -1831,28 +1907,38 @@ class AIRich extends BaseBuilder {
 					];
 				})();
 
-		this._submessages.push({
-			messageType: 1,
-			gridImageMetadata: {
-				gridImageUrl: {
-					imagePreviewUrl: list[0]?.imagePreviewUrl,
+		const buildCard = instant !== 'only';
+
+		if (buildCard) {
+			this._submessages.push({
+				messageType: 1,
+				gridImageMetadata: {
+					gridImageUrl: {
+						imagePreviewUrl: list[0]?.imagePreviewUrl,
+					},
+					imageUrls: list,
 				},
-				imageUrls: list,
-			},
-		});
+			});
+		}
 
 		list.forEach(({ imagePreviewUrl }) => {
-			this._sections.push(
-				AIRich.newLayout('Single', {
-					media: {
-						url: imagePreviewUrl,
-						mime_type: 'image/png',
-					},
-					imagine_type: 'IMAGE',
-					status: { status: 'READY' },
-					__typename: 'GenAIImaginePrimitive',
-				})
-			);
+			if (buildCard) {
+				this._sections.push(
+					AIRich.newLayout('Single', {
+						media: {
+							url: imagePreviewUrl,
+							mime_type: 'image/png',
+						},
+						imagine_type: 'IMAGE',
+						status: { status: 'READY' },
+						__typename: 'GenAIImaginePrimitive',
+					})
+				);
+			}
+
+			if (instant) {
+				this._inlineImages.push({ url: imagePreviewUrl, caption: undefined });
+			}
 		});
 
 		return this;
@@ -1923,8 +2009,12 @@ class AIRich extends BaseBuilder {
 	// fetch-full-video + ffmpeg-frame-extraction + duration-parse round trip per video, which
 	// was the main source of blurose's slower response time. Pass { autoFill: true } to opt
 	// back into the complete/slow path (real thumbnail + duration + file_length).
+	// Vanz@Fix 23-08-26 --- addVideo() had no resolveUrl option at all (unlike addImage()), so the
+	// video url always stayed a raw external link, which stock WA clients show a "download" state
+	// for before rendering. Mirrors addImage()'s { resolveUrl } — when true, the url is uploaded to
+	// WA's own media server first via Toolkit.toUrl() so it renders instantly like WA-native media.
 	/** Add a video block. */
-	addVideo(videoUrl, { autoFill = false } = {}) {
+	addVideo(videoUrl, { autoFill = false, resolveUrl = false } = {}) {
 		const isObjectVideo = (v) => v && typeof v === 'object' && v.url;
 
 		const isValidPrimitive =
@@ -1947,7 +2037,9 @@ class AIRich extends BaseBuilder {
 		items.forEach((item) => {
 			const isObject = isObjectVideo(item);
 
-			const url = isObject ? Toolkit.resolveMedia(this.#client, item.url ?? '', 'video') : Toolkit.resolveMedia(this.#client, item, 'video');
+			const url = isObject
+				? Toolkit.resolveMedia(this.#client, item.url ?? '', 'video', { resolveUrl })
+				: Toolkit.resolveMedia(this.#client, item, 'video', { resolveUrl });
 
 			const bufferPromise = autoFill ? Promise.resolve(url).then((u) => Toolkit.fetchBuffer(u)) : null;
 
@@ -2005,7 +2097,7 @@ class AIRich extends BaseBuilder {
 	}
 
 	/** Add an inline product card (or array of cards). Each item needs at least a `title`. */
-	addProduct(data = {}) {
+	addProduct(data = {}, { resolveUrl = false } = {}) {
 		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');
 		}
@@ -2030,11 +2122,11 @@ class AIRich extends BaseBuilder {
 			sale_price: item.sale_price,
 			product_url: item.product_url ?? item.url,
 			image: {
-				url: Toolkit.resolveMedia(this.#client, item.image_url ?? item.image, 'image'),
+				url: Toolkit.resolveMedia(this.#client, item.image_url ?? item.image, 'image', { resolveUrl }),
 			},
 			additional_images: [
 				{
-					url: Toolkit.resolveMedia(this.#client, item.icon_url ?? item.icon, 'image'),
+					url: Toolkit.resolveMedia(this.#client, item.icon_url ?? item.icon, 'image', { resolveUrl }),
 				},
 			],
 			__typename: 'GenAIProductItemCardPrimitive',
@@ -2046,7 +2138,7 @@ class AIRich extends BaseBuilder {
 	}
 
 	/** Add an inline social-post style card (or array of cards). */
-	addPost(data = {}) {
+	addPost(data = {}, { resolveUrl = false } = {}) {
 		if (!((data && typeof data === 'object' && !Array.isArray(data)) || (Array.isArray(data) && data.every((item) => item && typeof item === 'object' && !Array.isArray(item))))) {
 			throw new TypeError('Post items must be an object or an array of objects');
 		}
@@ -2062,9 +2154,9 @@ class AIRich extends BaseBuilder {
 			title: p.title ?? '',
 			subtitle: p.subtitle ?? '',
 			username: p.username ?? '',
-			profile_picture_url: Toolkit.resolveMedia(this.#client, p.profile_picture_url ?? p.profile_url ?? p.profile ?? '', 'image'),
+			profile_picture_url: Toolkit.resolveMedia(this.#client, p.profile_picture_url ?? p.profile_url ?? p.profile ?? '', 'image', { resolveUrl }),
 			is_verified: !!(p.is_verified || p.verified),
-			thumbnail_url: Toolkit.resolveMedia(this.#client, p.thumbnail_url ?? p.thumbnail ?? '', 'image'),
+			thumbnail_url: Toolkit.resolveMedia(this.#client, p.thumbnail_url ?? p.thumbnail ?? '', 'image', { resolveUrl }),
 			post_caption: p.post_caption ?? p.caption ?? '',
 			likes_count: p.likes_count ?? p.like ?? 0,
 			comments_count: p.comments_count ?? p.comment ?? 0,
@@ -2073,7 +2165,7 @@ class AIRich extends BaseBuilder {
 			post_deeplink: p.post_deeplink ?? p.deeplink ?? '',
 			source_app: p.source_app || p.source || 'INSTAGRAM',
 			footer_label: p.footer_label ?? p.footer ?? '',
-			footer_icon: Toolkit.resolveMedia(this.#client, p.footer_icon ?? p.icon ?? '', 'image'),
+			footer_icon: Toolkit.resolveMedia(this.#client, p.footer_icon ?? p.icon ?? '', 'image', { resolveUrl }),
 			is_carousel: posts.length > 1,
 			orientation: p.orientation ?? 'LANDSCAPE',
 			post_type: p.post_type ?? 'VIDEO',

package/lib/Utils/MessageBuilder_d.ts

@@ -0,0 +1,208 @@
+/**
+ * Type declarations for lib/Utils/MessageBuilder.js
+ * Hand-written (this file had no .d.ts before — not shipped by upstream
+ * either). Public chaining API only; internal/private members omitted.
+ */
+
+export const MESSAGE_BUILDER_VERSION: string; // '4.7'
+
+export abstract class BaseBuilder {
+	setTitle(title: string): this;
+	setSubtitle(subtitle: string): this;
+	setBody(body: string): this;
+	setFooter(footer: string): this;
+	setContextInfo(obj: Record<string, any>): this;
+	addPayload(obj: Record<string, any>): this;
+}
+
+export interface LimitedTimeOfferParams {
+	text?: string;
+	url?: string;
+	copy_code?: string;
+	expiration_time?: number;
+}
+
+export interface BottomSheetParams {
+	in_thread_buttons_limit?: number;
+	divider_indices?: number[];
+	list_title?: string;
+	button_title?: string;
+}
+
+export interface TapTargetConfigurationParams {
+	title?: string;
+	description?: string;
+	canonical_url?: string;
+	domain?: string;
+	buttonIndex?: number;
+}
+
+export class Button extends BaseBuilder {
+	constructor(client: any);
+	setVideo(path: string | Buffer, options?: Record<string, any>): this;
+	setImage(path: string | Buffer, options?: Record<string, any>): this;
+	setDocument(path: string | Buffer, options?: Record<string, any>): this;
+	setMedia(obj: Record<string, any>): this;
+	clearButtons(): this;
+	setParams(obj: Record<string, any>): this;
+	addButton(name: string, params: string | Record<string, any>): this;
+	makeRow(header?: string, title?: string, description?: string, id?: string): this;
+	makeSection(title?: string, highlight_label?: string): this;
+	addSelection(title: string, options?: Record<string, any>): this;
+	addReply(display_text: string, id: string, options?: Record<string, any>): this;
+	/** cta_call. Note (v4.7): keys on `phone_number`, not `id` — fixed from a prior version that silently mis-keyed this field. */
+	addCall(display_text: string, phone_number: string, options?: Record<string, any>): this;
+	addReminder(display_text: string, id: string, options?: Record<string, any>): this;
+	addCancelReminder(display_text: string, id: string, options?: Record<string, any>): this;
+	addAddress(display_text: string, id: string, options?: Record<string, any>): this;
+	addLocation(options?: Record<string, any>): this;
+	addUrl(display_text: string, url: string, webview_interaction?: boolean, options?: Record<string, any>): this;
+	addCopy(display_text: string, copy_code: string, options?: Record<string, any>): this;
+	/** open_webview — opens a titled in-app webview. */
+	addOpenWebview(title: string, url: string, options?: Record<string, any>): this;
+	/** cta_catalog — opens the sender's WhatsApp Business catalog. Business-account gated. */
+	addCatalog(display_text?: string, options?: Record<string, any>): this;
+	/** automated_greeting_message_view_catalog. Business-account gated. */
+	addViewCatalog(options?: Record<string, any>): this;
+	/** call_permission_request. */
+	addCallPermission(display_text?: string, options?: Record<string, any>): this;
+	/** payment_info — structured payment-settings payload (e.g. PIX). Payment-enabled accounts only. */
+	addPaymentInfo(payload?: Record<string, any>): this;
+	/** review_and_pay — order/payment summary flow. Server-validated by WhatsApp. */
+	addReviewAndPay(payload?: Record<string, any>): this;
+	/** wa_payment_transaction_details. */
+	addTransactionDetails(payload?: Record<string, any>): this;
+	/** mpm — multi-product message. Business-catalog accounts only. */
+	addMultiProduct(payload?: Record<string, any>): this;
+	setLimitedTimeOffer(params?: LimitedTimeOfferParams): this;
+	setBottomSheet(params?: BottomSheetParams): this;
+	setTapTargetConfiguration(params?: TapTargetConfigurationParams): this;
+	toCard(): Promise<Record<string, any>>;
+	build(jid: string, options?: Record<string, any>): Promise<Record<string, any>>;
+	send(jid: string, options?: Record<string, any>): Promise<any>;
+
+	/** Native-flow names WA renders with a dedicated node instead of the generic v=9 "mixed" node. */
+	static SPECIAL_FLOW: Record<string, { v: string; name: string }>;
+
+	// Presets attached at runtime via attachPresets() from MessageKit.js.
+	static confirm?: (client: any, text: string, options?: Record<string, any>) => Button;
+	static yesNo?: (client: any, text: string, options?: Record<string, any>) => Button;
+	static menu?: (client: any, options?: Record<string, any>) => Button;
+}
+
+export class ButtonV2 extends BaseBuilder {
+	constructor(client: any);
+	addButton(displayText: string, buttonId?: string): this;
+	addRawButton(obj: Record<string, any>): this;
+	setThumbnail(path: string | Buffer): this;
+	setMedia(obj: Record<string, any>): this;
+	/** @param options.viewOnce Default true — some clients require this for legacy buttonsMessage to render; pass false for a normal (non-disappearing) message. */
+	build(jid: string, options?: Record<string, any> & { viewOnce?: boolean }): Promise<Record<string, any>>;
+	send(jid: string, options?: Record<string, any> & { viewOnce?: boolean }): Promise<any>;
+}
+
+export class Carousel extends BaseBuilder {
+	constructor(client: any);
+	/** WhatsApp caps carousels at this many cards (10); addCard() throws past it. */
+	static MAX_CARDS: number;
+	addCard(card: Record<string, any> | Record<string, any>[]): this;
+	build(jid: string, options?: Record<string, any>): Record<string, any>;
+	send(jid: string, options?: Record<string, any>): Promise<any>;
+}
+
+export class Poll extends BaseBuilder {
+	constructor(client: any);
+	setName(name: string): this;
+	addOption(name: string): this;
+	addOptions(names: string[]): this;
+	setSelectable(count: number): this;
+	setMultiSelect(canSelectMultiple?: boolean): this;
+	setHideVoter(hide?: boolean): this;
+	setCanAddOption(allow?: boolean): this;
+	setAnnouncementGroup(isAnnouncement?: boolean): this;
+	setEndDate(date: Date | string | number): this;
+	/** Defers hash/version handling to the socket's own sendMessage({poll}) logic — see .js docblock. */
+	setQuiz(correctOptionName: string): this;
+	build(): { poll: Record<string, any> };
+	send(jid: string, options?: Record<string, any>): Promise<any>;
+}
+
+export interface AddTextOptions {
+	hyperlink?: boolean;
+	citation?: boolean;
+	latex?: boolean;
+}
+
+export interface AddInlineImageOptions {
+	text?: string;
+	alignment?: string;
+	tapLinkUrl?: string;
+	resolveUrl?: boolean;
+}
+
+export class AIRich extends BaseBuilder {
+	constructor(client: any);
+	addSubmessage(submessage: Record<string, any>): this;
+	addSection(section: Record<string, any>): this;
+	addText(text: string, options?: AddTextOptions): this;
+	addCode(language: string, code: string): this;
+	addTable(table: string[][], options?: AddTextOptions): 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;
+	addInlineImage(imageUrl: string, options?: AddInlineImageOptions): this;
+	addVideo(videoUrl: string, options?: { autoFill?: boolean; resolveUrl?: boolean }): this;
+	addProduct(data?: Record<string, any>, options?: { resolveUrl?: boolean }): this;
+	addPost(data?: Record<string, any>, options?: { resolveUrl?: boolean }): this;
+	addTip(text: string): this;
+	/** FOATextPrimitive — large heading text, distinct from addText()'s paragraph text. */
+	addHeading(text: string): this;
+	/** GenAIImagePrimitive — "ready" static image (preview + full-res), distinct from addImage()'s generation-style card. */
+	addImageCard(previewUrl: string | Buffer, fullUrl?: string | Buffer, options?: { resolveUrl?: boolean }): this;
+	/** GenAI3PExtWidgetPrimitive — experimental, reverse-engineered; see JSDoc in the .js file for caveats. */
+	addWidget(data: Record<string, any> | Record<string, any>[], options?: { layout?: 'Single' | 'HScroll' | 'ActionRow' | string }): this;
+	/** GenAIFooterActionPrimitive — footer action link chips (e.g. "Join our Group"). */
+	addFooterAction(actions: { text: string; url: string; type?: string } | { text: string; url: string; type?: string }[]): this;
+	/** GenAIDividerPrimitive — plain horizontal line, no content. */
+	addDivider(): this;
+	/** GenAISpacerPrimitive — blank vertical spacing. */
+	addSpacer(spacing?: number): this;
+	/** 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; 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; 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; 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
+// MessageBuilder.js). All four are structurally identical to AIRich.
+export { AIRich as AIVanzxy, AIRich as LeafRich, AIRich as VanzxyAI, AIRich as VanzxyRich };
+
+export class Toolkit {
+	static extractIE(text: string, options?: AddTextOptions): Record<string, any>;
+	static getMp4Duration(buffer: Buffer, options?: { silent?: boolean }): Promise<number>;
+	static getMp4Preview(
+		videoBuffer: Buffer,
+		options?: { time?: number; result?: 'buffer' | string; resize?: boolean; width?: number; height?: number; silent?: boolean }
+	): Promise<Buffer | Record<string, any>>;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vanzxy/baileys",
-  "version": "1.4.6",
+  "version": "1.4.7",
   "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",