@vanzxy/baileys 1.3.9 → 1.4.0

package/lib/Utils/MessageBuilder.js

@@ -738,6 +738,45 @@ class Button extends BaseBuilder {
 		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
+	// documented schema. Added dedicated setters + a lightweight type check reusing paramsList.
+	static #validateAgainstSchema(schema, data, label) {
+		for (const [key, type] of Object.entries(schema)) {
+			if (data[key] === undefined) continue;
+			const expectsArray = Array.isArray(type);
+			if (expectsArray) {
+				if (!Array.isArray(data[key]) || !data[key].every((v) => typeof v === type[0])) {
+					throw new TypeError(`${label}.${key} must be an array of ${type[0]}`);
+				}
+			} else if (typeof data[key] !== type) {
+				throw new TypeError(`${label}.${key} must be a ${type}`);
+			}
+		}
+	}
+
+	setLimitedTimeOffer({ text = '', url = '', copy_code = '', expiration_time } = {}) {
+		const data = { text, url, copy_code, expiration_time };
+		Button.#validateAgainstSchema(Button.paramsList.limited_time_offer, data, 'limited_time_offer');
+		this._params = { ...this._params, limited_time_offer: data };
+		return this;
+	}
+
+	setBottomSheet({ in_thread_buttons_limit, divider_indices = [], list_title = '', button_title = '' } = {}) {
+		const data = { in_thread_buttons_limit, divider_indices, list_title, button_title };
+		Button.#validateAgainstSchema(Button.paramsList.bottom_sheet, data, 'bottom_sheet');
+		this._params = { ...this._params, bottom_sheet: data };
+		return this;
+	}
+
+	setTapTargetConfiguration({ title = '', description = '', canonical_url = '', domain = '', buttonIndex = 0 } = {}) {
+		const data = { title, description, canonical_url, domain, buttonIndex };
+		Button.#validateAgainstSchema(Button.paramsList.tap_target_configuration, data, 'tap_target_configuration');
+		this._params = { ...this._params, tap_target_configuration: data };
+		return this;
+	}
+
 	static paramsList = {
 		limited_time_offer: {
 			text: 'string',
@@ -1016,6 +1055,11 @@ class AIRich extends BaseBuilder {
 		this._submessages = [];
 		this._sections = [];
 		this._richResponseSources = [];
+		// Vanz@Fix (bug 42 / inline image fallback): WA rejects rendering AIRichResponseInlineImageMetadata
+		// for third-party bots regardless of URL (confirmed empirically — Meta/WA CDN url with valid
+		// 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 = [];
 	}
 
 	addSubmessage(submessage) {
@@ -1279,6 +1323,66 @@ class AIRich extends BaseBuilder {
 		return this;
 	}
 
+	// Vanz@Fix 15-08-26 (bug 41) --- addImage() only builds GRID_IMAGE (messageType 1).
+	// There was no helper for standalone INLINE_IMAGE (messageType 3): callers were manually
+	// pushing addSubmessage() (correct proto shape) + addSection() (WRONG shape — reused the
+	// GRID_IMAGE/GenAIImaginePrimitive section schema instead of GenAIInlineImageUXPrimitive),
+	// which broke client-side unifiedResponse rendering even though the submessage itself was fine.
+	// Mirrors RichSubMessageType.INLINE_IMAGE handling in rich-message-utils.js's toUnified().
+	addInlineImage(imageUrl, { text = '', alignment = 'center', tapLinkUrl = '', resolveUrl = false } = {}) {
+		if (!(typeof imageUrl === 'string' || Buffer.isBuffer(imageUrl) || (imageUrl && typeof imageUrl === 'object'))) {
+			throw new TypeError('imageUrl must be string | buffer | { imagePreviewUrl, imageHighResUrl, sourceUrl }');
+		}
+
+		const ALIGNMENT_ENUM = { leading: 0, trailing: 1, center: 2 };
+		const ALIGNMENT_NAME = ['AI_RICH_RESPONSE_IMAGE_LAYOUT_LEADING_ALIGNED', 'AI_RICH_RESPONSE_IMAGE_LAYOUT_TRAILING_ALIGNED', 'AI_RICH_RESPONSE_IMAGE_LAYOUT_CENTER_ALIGNED'];
+		const alignmentNum = typeof alignment === 'number' ? alignment : (ALIGNMENT_ENUM[String(alignment).toLowerCase()] ?? ALIGNMENT_ENUM.center);
+
+		const url =
+			imageUrl && typeof imageUrl === 'object'
+				? {
+						imagePreviewUrl: imageUrl.imagePreviewUrl || imageUrl.url,
+						imageHighResUrl: imageUrl.imageHighResUrl || imageUrl.url,
+						sourceUrl: imageUrl.sourceUrl || imageUrl.url,
+					}
+				: (() => {
+						const resolved = Toolkit.resolveMedia(this.#client, imageUrl, 'image', { resolveUrl });
+						return { imagePreviewUrl: resolved, imageHighResUrl: resolved, sourceUrl: resolved };
+					})();
+
+		this._submessages.push({
+			messageType: 3,
+			imageMetadata: {
+				imageUrl: url,
+				imageText: text,
+				alignment: alignmentNum,
+				tapLinkUrl,
+			},
+		});
+
+		this._sections.push(
+			AIRich.newLayout('Single', {
+				image_url: {
+					image_preview_url: url.imagePreviewUrl || '',
+					image_high_res_url: url.imageHighResUrl || '',
+					source_url: url.sourceUrl || '',
+				},
+				image_text: text,
+				alignment: ALIGNMENT_NAME[alignmentNum],
+				tap_link_url: tapLinkUrl,
+				__typename: 'GenAIInlineImageUXPrimitive',
+			})
+		);
+
+		// Vanz@Fix (bug 42): stash for the imageMessage fallback in send()
+		this._inlineImages.push({
+			url: url.sourceUrl || url.imageHighResUrl || url.imagePreviewUrl,
+			caption: text || undefined,
+		});
+
+		return this;
+	}
+
 	// Vanz@Perf 15-08-26 --- autoFill defaults to false (arslan-baileys behavior): skips the
 	// 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
@@ -1564,8 +1668,30 @@ class AIRich extends BaseBuilder {
 		};
 	}
 
-	async send(jid, { forwarded, notification, includesUnifiedResponse, includesSubmessages, ...options } = {}) {
-		const msg = await this.build({ forwarded, notification, includesUnifiedResponse, includesSubmessages, ...options });
+	// 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 (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.
+	async send(jid, { forwarded, notification, includesUnifiedResponse, includesSubmessages, skipImageFallback = false, quoted, ...options } = {}) {
+		const msg = await this.build({ forwarded, notification, includesUnifiedResponse, includesSubmessages, quoted, ...options });
+
+		if (!skipImageFallback && this._inlineImages.length) {
+			for (const { url, caption } of this._inlineImages) {
+				try {
+					await this.#client.sendMessage(jid, { image: { url }, caption }, quoted ? { quoted } : {});
+				} catch (err) {
+					// Vanz@Fix: don't let a fallback image failure block the actual rich card from sending
+					this.#client.logger?.warn?.({ err, url }, 'inline image fallback failed, continuing with rich card');
+				}
+			}
+		}
 
 		return await this.#client.relayMessage(jid, msg, { ...options });
 	}

package/lib/Utils/messages.js

@@ -863,10 +863,24 @@ export const generateWAMessageContent = async (message, options) => {
         return message;
     }
     // Lia@Changes 09-04-26 --- Add support for code block and table with richResponseMessage
+    // Vanz@Fix (bug 41 / inline image standalone): gate only checked code/links/table/richResponse,
+    // so sending { inlineImage } alone (or headerText/contentText/latex/items/etc standalone) never
+    // reached prepareRichResponseMessage and silently fell through to another branch. Added every
+    // key that prepareRichResponseMessage actually destructures.
     else if (hasNonNullishProperty(message, 'code') ||
         hasNonNullishProperty(message, 'links') ||
         hasNonNullishProperty(message, 'table') ||
-        hasNonNullishProperty(message, 'richResponse')) {
+        hasNonNullishProperty(message, 'richResponse') ||
+        hasNonNullishProperty(message, 'inlineImage') ||
+        hasNonNullishProperty(message, 'inlineVideo') ||
+        hasNonNullishProperty(message, 'headerText') ||
+        hasNonNullishProperty(message, 'contentText') ||
+        hasNonNullishProperty(message, 'footerText') ||
+        hasNonNullishProperty(message, 'latex') ||
+        hasNonNullishProperty(message, 'items') ||
+        hasNonNullishProperty(message, 'posts') ||
+        hasNonNullishProperty(message, 'products') ||
+        hasNonNullishProperty(message, 'suggested')) {
         m = prepareRichResponseMessage(message);
     }
     else if (hasNonNullishProperty(message, 'text')) {

package/lib/WABinary/generic-utils.js

@@ -126,7 +126,12 @@ export function binaryNodeToString(node, i = 0) {
 const FLOWS_MAP = {
     // Original flow types
     mpm: true,
-    cta_catalog: true,
+    // Vanz@Fix (bug 44): the "catalog" nativeFlow shortcut generates a button
+    // named 'catalog_message' (see prepareNativeFlowButtons in messages.js),
+    // never 'cta_catalog' — the old key here never matched anything, so
+    // catalog_message always fell through to the generic mixed-flow node
+    // instead of getting its dedicated native_flow node.
+    catalog_message: true,
     send_location: true,
     call_permission_request: true,
     wa_payment_transaction_details: true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vanzxy/baileys",
-  "version": "1.3.9",
+  "version": "1.4.0",
   "description": "Enhanced Baileys fork by Vanzxy \u2014 based on @itsliaaa/baileys + @whiskeysockets/baileys with fixes for audio group status and clean media without newsletter button.",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",