@vanzxy/baileys 2.0.2 → 2.0.3

package/README.md

@@ -74,7 +74,7 @@
 - [💖 Support](#-support)
 - [👑 Maintainer](#-maintainer)
 - [⚠️ Disclaimer](#-disclaimer)
-- [📝 Patch Notes](#-v7-patch-notes)
+- [📝 Patch Notes](#-v8-patch-notes)
 
 </details>
 
@@ -246,6 +246,8 @@ Audio status uses a more compatible implementation to avoid unsupported-version
 ### AIRich — the rich-response message builder
 A chainable builder (`AIRich`, also exported as `AIVanzxy` / `LeafRich` / `VanzxyAI` / `VanzxyRich`) with 40+ `add*()`/`set*()` methods covering headings, formatted text (hyperlinks/citations/LaTeX), code blocks, tables, image/video/product/post cards, task & progress cards, tip banners, and quick-reply suggestions — the kind of rich card layout you'd normally only see from an official AI/assistant-style bot. See [Usage Examples](#airich--rich-response-cards) below.
 
+> **Experimental (V8):** `build()` now also populates the proto's `originalRecipientMetadata` field (previously left unset) with the same section payload as `unifiedResponse`. This is a fix for AI-response bubbles collapsing into WhatsApp's "Baca selengkapnya"/"Read more" fold earlier than expected while being built up live via `sendEdit()`. Pending live-traffic confirmation — report back if you still see early truncation.
+
 ### Native Flow Expansion
 
 <table>
@@ -530,8 +532,26 @@ Every message builder lives in its own file under `lib/Builders/`, so you can tr
 | `Album.js` | `Album` | Media-group/album builder — bundles 2+ images/videos. Thin wrapper: the actual cover + delayed-follow-up sending is already handled by the `content.album` shorthand in `Socket/messages-send.js`. |
 | `AIRich.js` | `AIRich` (+ aliases `ORich`, `AIVanzxy`, `LeafRich`, `VanzxyAI`, `VanzxyRich`, `RichVanzxy`) | The rich AI-assistant-style response builder described above — headings, formatted text, tables, media/product/post cards, task/progress cards, tip banners, quick-reply suggestions. |
 | `A2UI.js` | `A2UI`, `sendA2UIWidget` | Lower-level A2UI/Bloks widget builder. Builds the flat `components` tree (Column/Row → `children`, Card/Button → `child`, Modal → `trigger`/`content`) that Bloks widgets expect and sends it through the same `getBizBinaryNode()` path as `Button`/`ButtonV2`, so the wire-level node always matches the button names actually sent. |
-| `VanzxyBaileys.js` | `VanzxyBaileys` | A unified builder **hub** — one object that wraps all the builders above behind short method names (`.button()`, `.buttonV2()`, `.buttonV3()`, `.carousel()`, `.poll()`, `.nativeFlow()`, `.location()`, `.contact()`, `.album()`, `.airich()`, `.a2ui()`), plus PascalCase aliases (`.Button()`, `.Carousel()`, `.Poll()`, `.NativeFlow()`, `.Location()`, `.Contact()`, `.Album()`, `.AIRich()`, `.A2UI()`) for developers who prefer that naming style. Nothing new is implemented here — it's purely a single entry point over the individual classes. |
-| `index.js` | everything above, plus `MESSAGE_BUILDER_VERSION` | The barrel file — re-exports every builder and its aliases so `import { Button, Poll, AIRich, VanzxyBaileys } from '@vanzxy/baileys'` works without reaching into individual files. `MESSAGE_BUILDER_VERSION` tracks the builder API surface's own version, independent of the package version (currently `5.0`). |
+| `LinkPreview.js` | `bindLinkPreview` | Not a builder class — a function that binds a `sendLinkPreview(jid, text, link, title, description, thumbnail, options)` method directly onto a Baileys socket instance. Builds the `linkPreview` context (matched text, title, description, optional thumbnail via `prepareWAMessageMedia`) and sends it through the socket's own `sendMessage`. Called automatically when you construct `VanzxyBaileys(sock)`; call it yourself (`bindLinkPreview(sock)`) if you're not using the hub. |
+| `VanzxyBaileys.js` | `VanzxyBaileys` | A unified builder **hub** — one object that wraps all the builders above behind short method names (`.button()`, `.buttonV2()`, `.buttonV3()`, `.carousel()`, `.poll()`, `.nativeFlow()`, `.location()`, `.contact()`, `.album()`, `.airich()`, `.a2ui()`), plus PascalCase aliases (`.Button()`, `.Carousel()`, `.Poll()`, `.NativeFlow()`, `.Location()`, `.Contact()`, `.Album()`, `.AIRich()`, `.A2UI()`) for developers who prefer that naming style. The constructor also runs `bindLinkPreview()` on the socket you pass in, so `vx.client.sendLinkPreview(...)` is available immediately. Nothing new is implemented here — it's purely a single entry point over the individual classes. |
+| `index.js` | everything above, plus `MESSAGE_BUILDER_VERSION` | The barrel file — re-exports every builder and its aliases so `import { Button, Poll, AIRich, VanzxyBaileys, bindLinkPreview } from '@vanzxy/baileys'` works without reaching into individual files. `MESSAGE_BUILDER_VERSION` tracks the builder API surface's own version, independent of the package version (currently `5.0`). |
+
+**Link preview example** — works on any socket, with or without the `VanzxyBaileys` hub:
+
+```js
+import { bindLinkPreview } from '@vanzxy/baileys'
+
+const sock = bindLinkPreview(makeWASocket({ /* ... */ }))
+
+await sock.sendLinkPreview(
+    jid,
+    'Cek repo ini deh',
+    'https://github.com/vanzxysenpai/vanzxybaileys',
+    'vanzxybaileys',
+    'Extended interactive messages & native flow, built on WhiskeySockets/Baileys.',
+    { url: 'https://files.catbox.moe/l72xji.svg' } // optional thumbnail
+)
+```
 
 **Unified hub example** — useful if you'd rather carry one object around than import each builder individually:
 
@@ -830,6 +850,14 @@ Use responsibly and follow WhatsApp Terms of Service.
 
 ---
 
+## 📝 V8 Patch Notes
+
+- Added `LinkPreview.js` to `lib/Builders/`: `bindLinkPreview(sock)` attaches a `sendLinkPreview(jid, text, link, title, description, thumbnail, options)` method directly to a socket instance (matched-text/title/description + optional thumbnail via `prepareWAMessageMedia`). Wired into `index.js`'s exports and auto-applied inside the `VanzxyBaileys` constructor, so `new VanzxyBaileys(sock)` gives you `sendLinkPreview` for free. See the [Builders Folder Map](#-builders-folder-map-libbuilders) for the usage example.
+- **Experimental AIRich fix:** `AIRich.build()` now populates the previously-unset `richResponseMessage.originalRecipientMetadata` proto field with the same section payload as `unifiedResponse`. Working hypothesis is that WhatsApp's client uses this field to decide full/expanded rendering for an AI-response bubble's original recipient, and its absence was causing live-built AIRich bubbles to collapse into "Baca selengkapnya" earlier than they should while still mid-`sendEdit()` build. Not yet confirmed against live traffic — flag it if the early collapse persists or if this introduces a regression.
+- Corrected `package.json`'s `version` field from `2.0.6` back to `2.0.3`. `2.0.6` was never reached through this fork's own release process — it got bumped out of sequence, so the version number is reset to the correct next step.
+
+---
+
 ## 📝 V7 Patch Notes
 
 - Added four new builders to `lib/Builders/` (see the [📁 Builders Folder Map](#-builders-folder-map-libbuilders) for details), wired into both `index.js` and the `VanzxyBaileys` hub:

package/lib/Builders/AIRich.js

@@ -161,6 +161,11 @@ class AIRich extends BaseBuilder {
 		});
 	}
 
+	/** Alias — .d.ts documents this as "addHeading" (FOATextPrimitive), source only ever exposed addFOAText(). */
+	addHeading(text, options = {}) {
+		return this.addFOAText(text, options);
+	}
+
 	addFOAText(text, { id, replace, insertAt } = {}) {
 		if (typeof text !== 'string') {
 			throw new TypeError('Text must be a string');
@@ -772,6 +777,277 @@ class AIRich extends BaseBuilder {
 		});
 	}
 
+	addQuotaUpsell(data, { id, replace, insertAt } = {}) {
+		if (!data || typeof data !== 'object' || Array.isArray(data)) {
+			throw new TypeError('Quota upsell must be an object');
+		}
+
+		if (typeof data.title !== 'string' || !data.title) {
+			throw new TypeError('addQuotaUpsell() requires a "title"');
+		}
+
+		const buttons = Array.isArray(data.buttons) ? data.buttons : [];
+
+		const primitive = {
+			__typename: 'GenAIMetaSubsQuotaUpsellPrimitive',
+			title: data.title,
+			body_line1: data.body_line1 ?? data.body ?? '',
+			body_line2: data.body_line2 ?? '',
+
+			buttons: buttons.map((btn) => ({
+				__typename: 'GenAIMetaSubsQuotaUpsellButton',
+				label: btn.label ?? '',
+				action: btn.action ?? 'OPEN_DEEPLINK',
+				deeplink: btn.deeplink ?? '',
+			})),
+		};
+
+		const section = AIRich.newLayout('Single', primitive);
+
+		const submessage = this.createAlert('GenAIMetaSubsQuotaUpsellPrimitive');
+
+		return this._addContent(section, submessage, {
+			id,
+			replace,
+			insertAt,
+		});
+	}
+
+	/** GenAIDividerPrimitive — plain horizontal line, no content. */
+	addDivider({ id, replace, insertAt } = {}) {
+		const section = AIRich.newLayout('Single', {
+			__typename: 'GenAIDividerPrimitive',
+		});
+
+		return this._addContent(section, undefined, {
+			id,
+			replace,
+			insertAt,
+		});
+	}
+
+	/** GenAISpacerPrimitive — blank vertical spacing. */
+	addSpacer(spacing, { id, replace, insertAt } = {}) {
+		const section = AIRich.newLayout('Single', {
+			spacing,
+			__typename: 'GenAISpacerPrimitive',
+		});
+
+		return this._addContent(section, undefined, {
+			id,
+			replace,
+			insertAt,
+		});
+	}
+
+	/**
+	 * GenAILatexItem — corrected after cross-checking an older, actually-shipped build
+	 * (MessageBuilder v4.7, pre-dates this primitive-card guess). LaTeX in this ecosystem
+	 * is NOT a standalone card — the real, working mechanism is an inline entity inside
+	 * addText()'s own extractIE() parser (`[expr|width|height|font_height|padding]<imageUrl>`
+	 * syntax), and it requires a PRE-RENDERED image of the equation — WhatsApp does not
+	 * render raw LaTeX text client-side. The previous addLatex() (standalone
+	 * GenAILatexUXPrimitive card, text-only) was confirmed via eval to render blank because
+	 * that primitive/approach never existed in the first place. This version is a thin
+	 * wrapper around the real, already-working addText() inline syntax.
+	 */
+	addLatex(expression, { url, width, height, font_height, padding, id, replace, insertAt } = {}) {
+		if (typeof expression !== 'string' || !expression) {
+			throw new TypeError('addLatex(expression) requires a non-empty string');
+		}
+
+		if (!url) {
+			throw new TypeError('addLatex() requires a pre-rendered equation image "url" — WhatsApp renders LaTeX as an inline image, not raw text');
+		}
+
+		const extras = [width, height, font_height, padding];
+
+		while (extras.length && extras[extras.length - 1] == null) {
+			extras.pop();
+		}
+
+		const raw = [expression, ...extras].join('|');
+
+		return this.addText(`[${raw}]<${url}>`, {
+			id,
+			replace,
+			insertAt,
+		});
+	}
+
+	/**
+	 * GenAIInlineImageUXPrimitive — messageType 3 (INLINE_IMAGE) submessage, field layout
+	 * ported from rich-message-utils.js toUnified() INLINE_IMAGE case (same image-url-object
+	 * fix as addImage()/bug 40 round 2), not guessed from the .d.ts alone.
+	 */
+	addInlineImage(imageUrl, { text = '', alignment = 'center', tapLinkUrl = '', resolveUrl = false, id, replace, insertAt } = {}) {
+		if (!(typeof imageUrl === 'string' || Buffer.isBuffer(imageUrl))) {
+			throw new TypeError('imageUrl must be string | buffer');
+		}
+
+		const url = Toolkit.resolveMedia(this.#client, imageUrl, 'image', { resolveUrl });
+
+		const ALIGNMENT_INDEX = { 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 alignmentIndex = ALIGNMENT_INDEX[String(alignment).toLowerCase()] ?? ALIGNMENT_INDEX.center;
+
+		const section = AIRich.newLayout('Single', {
+			image_url: {
+				image_preview_url: url,
+				image_high_res_url: url,
+				source_url: url,
+			},
+			image_text: text,
+			alignment: ALIGNMENT_NAME[alignmentIndex],
+			tap_link_url: tapLinkUrl,
+			__typename: 'GenAIInlineImageUXPrimitive',
+		});
+
+		const submessage = {
+			messageType: 3,
+			imageMetadata: {
+				imageUrl: { imagePreviewUrl: url, imageHighResUrl: url, sourceUrl: url },
+				imageText: text,
+				alignment: alignmentIndex,
+				tapLinkUrl,
+			},
+		};
+
+		return this._addContent(section, submessage, {
+			id,
+			replace,
+			insertAt,
+		});
+	}
+
+	/**
+	 * GenAIContentItemsUXPrimitive — messageType 9 (CONTENT_ITEMS) submessage, ported from
+	 * rich-message-utils.js toUnified() CONTENT_ITEMS case (bug 40: was returning {}).
+	 */
+	addContentItems(items = [], { content_type = 1, id, replace, insertAt } = {}) {
+		if (!Array.isArray(items)) {
+			throw new TypeError('addContentItems() requires an array of items');
+		}
+
+		const section = AIRich.newLayout('Single', {
+			items,
+			content_type,
+			__typename: 'GenAIContentItemsUXPrimitive',
+		});
+
+		const submessage = {
+			messageType: 9,
+			contentItemsMetadata: {
+				itemsMetadata: items,
+				contentType: content_type,
+			},
+		};
+
+		return this._addContent(section, submessage, {
+			id,
+			replace,
+			insertAt,
+		});
+	}
+
+	/** GenAIBotProgressStatusPrimitive — one-shot "searching/working" status chip. */
+	addProgressStatus(title, { icon, is_in_progress = true, target_secondary_screen_id, target_secondary_screen_tab_id, id, replace, insertAt } = {}) {
+		if (typeof title !== 'string' || !title) {
+			throw new TypeError('addProgressStatus() requires a "title"');
+		}
+
+		const section = AIRich.newLayout('Single', {
+			title,
+			icon,
+			is_in_progress,
+			target_secondary_screen_id,
+			target_secondary_screen_tab_id,
+			__typename: 'GenAIBotProgressStatusPrimitive',
+		});
+
+		const submessage = this.createAlert('GenAIBotProgressStatusPrimitive');
+
+		return this._addContent(section, submessage, {
+			id,
+			replace,
+			insertAt,
+		});
+	}
+
+	/** GenAIBotThinkingStatusPrimitive — one-shot "thinking" status chip. */
+	addThinkingStatus(title, { icon, is_in_progress = true, target_secondary_screen_id, target_secondary_screen_tab_id, textFallback = true, id, replace, insertAt } = {}) {
+		if (typeof title !== 'string' || !title) {
+			throw new TypeError('addThinkingStatus() requires a "title"');
+		}
+
+		const section = AIRich.newLayout('Single', {
+			title,
+			icon,
+			is_in_progress,
+			target_secondary_screen_id,
+			target_secondary_screen_tab_id,
+			__typename: 'GenAIBotThinkingStatusPrimitive',
+		});
+
+		const submessage = textFallback ? this.createAlert('GenAIBotThinkingStatusPrimitive') : undefined;
+
+		return this._addContent(section, submessage, {
+			id,
+			replace,
+			insertAt,
+		});
+	}
+
+	/** FOABloksPrimitive — raw Bloks payload; most experimental primitive, fields passed through as-is. */
+	addBloks(data, { id, replace, insertAt } = {}) {
+		if (!data || typeof data !== 'object' || Array.isArray(data)) {
+			throw new TypeError('Bloks payload must be an object');
+		}
+
+		if (typeof data.type !== 'string' || !data.type) {
+			throw new TypeError('addBloks() requires a "type"');
+		}
+
+		const { textFallback = true, ...rest } = data;
+
+		const section = AIRich.newLayout('Single', {
+			...rest,
+			__typename: 'FOABloksPrimitive',
+		});
+
+		const submessage = textFallback ? this.createAlert('FOABloksPrimitive') : undefined;
+
+		return this._addContent(section, submessage, {
+			id,
+			replace,
+			insertAt,
+		});
+	}
+
+	/**
+	 * GenAIImaginePrimitive with status GENERATING — pending-generation placeholder.
+	 * Mirrors addVideo()'s ANIMATE/GENERATING branch but with no media yet.
+	 */
+	addGenerating({ imagine_type = 'IMAGE', estimated_completion_time, textFallback = true, id, replace, insertAt } = {}) {
+		const section = AIRich.newLayout('Single', {
+			imagine_type,
+			status: {
+				status: 'GENERATING',
+				// Matches addVideo()'s convention: input is a ms-from-now duration, stored as a unix-seconds timestamp.
+				estimated_completion_time: estimated_completion_time != null ? Math.floor((Date.now() + estimated_completion_time) / 1000) : undefined,
+			},
+			__typename: 'GenAIImaginePrimitive',
+		});
+
+		const submessage = textFallback ? this.createAlert(`GenAIImaginePrimitive (${imagine_type === 'ANIMATE' ? 'ANIMATE' : 'IMAGE'} GENERATING)`) : undefined;
+
+		return this._addContent(section, submessage, {
+			id,
+			replace,
+			insertAt,
+		});
+	}
+
 	addSuggest(suggestion, { scroll = true, layout, id, replace, insertAt } = {}) {
 		if (!(typeof suggestion === 'string' || (Array.isArray(suggestion) && suggestion.every((v) => typeof v === 'string')))) {
 			throw new TypeError('Suggestion must be a string or array of strings');
@@ -875,6 +1151,9 @@ class AIRich extends BaseBuilder {
 							unifiedResponse: {
 								data: includesUnifiedResponse ? Buffer.from(Toolkit.stringifyEscaped({ response_id: this._responseId, sections })).toString('base64') : '',
 							},
+							originalRecipientMetadata: {
+								data: includesUnifiedResponse ? Buffer.from(Toolkit.stringifyEscaped({ response_id: this._responseId, sections })).toString('base64') : '',
+							},
 							contextInfo: {
 								...forward,
 								...qObj,

package/lib/Builders/LinkPreview.js

@@ -0,0 +1,74 @@
+import { prepareWAMessageMedia } from './shared.js';
+
+/**
+ * Binds `sendLinkPreview` onto a Baileys socket instance.
+ *
+ * Ported from MessageBuilder.js's `bind()` helper (present upstream in
+ * MessageBuilderV4.7 / "mb"'s build, but missing from this fork).
+ *
+ * Usage:
+ *   import { bindLinkPreview } from '@vanzxy/baileys';
+ *   const sock = bindLinkPreview(makeWASocket({ ... }));
+ *   await sock.sendLinkPreview(jid, 'check this out', 'https://example.com', 'Example Title');
+ */
+function bindLinkPreview(client) {
+	if (!client) {
+		throw new Error('Socket is required');
+	}
+
+	return Object.defineProperties(client, {
+		sendLinkPreview: {
+			configurable: true,
+			writable: true,
+			async value(jid, text, link, title, description, thumbnail, options = {}) {
+				if (typeof jid !== 'string') {
+					throw new TypeError('jid is not string');
+				}
+				if (typeof text !== 'string') {
+					throw new TypeError('text is not string');
+				}
+				if (typeof link !== 'string') {
+					throw new TypeError('link is not string');
+				}
+				if (typeof title !== 'string') {
+					throw new TypeError('title is not string');
+				}
+				if (description && typeof description !== 'string') {
+					throw new TypeError('description is not string');
+				}
+				if (thumbnail && !Buffer.isBuffer(thumbnail) && typeof thumbnail.url !== 'string') {
+					throw new TypeError('thumbnail must be Buffer or object with url key');
+				}
+
+				const image = thumbnail
+					? await prepareWAMessageMedia(
+							{ image: thumbnail },
+							{
+								upload: client.waUploadToServer,
+								mediaTypeOverride: 'thumbnail-link',
+							}
+						).then((v) => v.imageMessage)
+					: undefined;
+
+				text = text.includes(link) ? text : `${link}\n${text}`;
+
+				return await client.sendMessage(
+					jid,
+					{
+						text,
+						linkPreview: {
+							'matched-text': link,
+							title,
+							description,
+							jpegThumbnail: image?.jpegThumbnail,
+							highQualityThumbnail: image,
+						},
+					},
+					options
+				);
+			},
+		},
+	});
+}
+
+export { bindLinkPreview };

package/lib/Builders/VanzxyBaileys.js

@@ -9,6 +9,7 @@ import { NativeFlow } from './NativeFlow.js'
 import { Location } from './Location.js'
 import { Contact } from './Contact.js'
 import { Album } from './Album.js'
+import { bindLinkPreview } from './LinkPreview.js'
 
 /**
  * VanzxyBaileys — unified builder hub.
@@ -24,7 +25,7 @@ class VanzxyBaileys {
       )
     }
 
-    this.client = client
+    this.client = bindLinkPreview(client)
   }
 
   // ===== AIRICH =====

package/lib/Builders/index.js

@@ -13,3 +13,4 @@ export { A2UI, sendA2UIWidget } from './A2UI.js';
 export { AIRich as AIVanzxy, AIRich as LeafRich, AIRich as VanzxyAI, AIRich as VanzxyRich, AIRich as RichVanzxy } from './AIRich.js';
 export const MESSAGE_BUILDER_VERSION = '5.0';
 export { VanzxyBaileys } from './VanzxyBaileys.js';
+export { bindLinkPreview } from './LinkPreview.js';

package/package.json

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