@vanzxy/baileys 2.0.0 → 2.0.2

package/lib/Utils/MessageBuilder.js

@@ -1,4405 +1,2 @@
-/**
- * lib/Utils/MessageBuilder.js — AIRich / Button / ButtonV2 / Carousel / Toolkit
- *
- * Part of @vanzxy/baileys 1.4.4. Third-party attribution for the base
- * implementation this file was adapted from is kept in /NOTICE.md
- * (not inline here) per the original author's license terms.
- *
- * Vanz@Merge 15-08-26 --- Ported into @vanzxy/baileys 1.3.9 from the
- * @blurose/baileys 1.1.13 fork (base, feature-complete) with perf defaults
- * and message-authenticity fields backported from arslan-baileys 1.1.0 and
- * this project's own rich-message-utils.js. See changes tagged "Vanz@" below.
- *
- * Vanz@Fix 23-08-26 --- v4.7 -> v4.8. addGenerating() now defaults to appending a
- *   FOATextPrimitive text fallback ('[ Sedang diproses... ]'), same pattern as
- *   addTask/addThinkingStatus/addBloks. Previously the card had no client-visible
- *   content until WA's own timeout swapped it for its built-in failed-generation
- *   text; this makes the fallback instant. Opt out with { textFallback: false }.
- *
- * Vanz@Merge 22-08-26 --- v4.6 -> v4.7. Button class hardened + extended:
- *   - Bug fix: addCall() wrote its second arg into buttonParamsJson.id, but
- *     the cta_call native-flow schema keys on `phone_number` (id is ignored
- *     by WhatsApp for this button type). Confirmed against 3 independent
- *     current Baileys-fork call sites before changing the wire shape.
- *   - Required-field validation added to the CTA helpers that silently
- *     produced a button WA would render but never route correctly
- *     (empty id/url/copy_code/phone_number).
- *   - New native-flow helpers for names WA recognises beyond the "mixed"
- *     set (cta_catalog, open_webview, call_permission_request,
- *     automated_greeting_message_view_catalog, payment_info,
- *     review_and_pay, wa_payment_transaction_details, mpm) — see the
- *     Button.#SPECIAL_FLOW map and each method's JSDoc for the
- *     business/official-client gating caveat.
- *   - send() now picks the correct <native_flow v=.. name=..> node per the
- *     first button's name instead of always emitting v=9 name=mixed, which
- *     is required for the special names above to have a chance of
- *     rendering at all (mirrors the same class of bug already fixed for
- *     lone single_select in 1.3.x).
- *   - JSDoc added across Toolkit/BaseBuilder/Button/ButtonV2/Carousel/AIRich
- *     for editor hover-docs; kept in sync with MessageBuilder.d.ts.
- * All additions above are original implementations written against public
- * Baileys-ecosystem documentation of the native-flow wire format, not
- * copied from any third-party fork.
- */
-
-'use strict';
-
-const MESSAGE_BUILDER_VERSION = '4.8';
-// 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';
-import { botMetadataSignature, botMetadataCertificate } from './rich-message-utils.js';
-// Vanz@Fix 27-08-26: Button.send() was hand-rolling its own <biz> node with
-// attrs: {} instead of reusing the canonical builder. Real client traffic
-// (and the auto-attached biz node in Socket/messages-send.js) always carries
-// actual_actors/host_storage/privacy_mode_ts on every <biz> node, including
-// the one wrapping a lone single_select's <list> node. Missing them made the
-// single_select wire payload diverge from what messages-send.js emits for
-// every other message type -- import the shared helper instead of duplicating
-// (and silently drifting from) its attrs.
-import { getBizBinaryNode } from '../WABinary/index.js';
-import crypto from 'crypto';
-import { PassThrough, Readable } from 'stream';
-// Vanz@Fix 15-08-26 --- sharp/fluent-ffmpeg were statically imported in the blurose source.
-// Both are optional peer deps here (see package.json peerDependenciesMeta); a static import
-// throws at module-load time when they're not installed, which would crash the entire
-// lib/Utils barrel export (and therefore bot startup) even for users who never call
-// AIRich.addImage()/addVideo()/Toolkit.*. Lazy-load them instead, matching the pattern
-// already used in messages-media.js's getImageProcessingLibrary().
-let _sharp;
-const getSharp = async () => {
-    if (_sharp === undefined) {
-        _sharp = await import('sharp').then((m) => m.default ?? m).catch(() => null);
-    }
-    if (!_sharp)
-        throw new Error('sharp is required for this operation. Install it with: npm i sharp');
-    return _sharp;
-};
-let _ffmpeg;
-const getFfmpeg = async () => {
-    if (_ffmpeg === undefined) {
-        _ffmpeg = await import('fluent-ffmpeg').then((m) => m.default ?? m).catch(() => null);
-    }
-    if (!_ffmpeg)
-        throw new Error('fluent-ffmpeg is required for this operation. Install it with: npm i fluent-ffmpeg');
-    return _ffmpeg;
-};
-
-function extractIE(text, { extract = true, hyperlink = true, citation = true, latex = true } = {}) {
-	if (!extract) {
-		return {
-			text,
-			ie: [],
-			inline_entities: [],
-		};
-	}
-
-	const createIE = (type, ie) => {
-		if (type == 'hyperlink') {
-			return {
-				key: ie.key,
-				metadata: {
-					display_name: ie.text,
-					is_trusted: ie.is_trusted,
-					url: ie.url,
-					__typename: 'GenAIInlineLinkItem',
-				},
-			};
-		}
-
-		if (type == 'citation') {
-			return {
-				key: ie.key,
-				metadata: {
-					reference_id: ie.reference_id,
-					reference_url: ie.url,
-					reference_title: ie.url,
-					reference_display_name: ie.url,
-					sources: [],
-					__typename: 'GenAISearchCitationItem',
-				},
-			};
-		}
-
-		if (type == 'latex') {
-			return {
-				key: ie.key,
-				metadata: {
-					latex_expression: ie.text,
-					latex_image: {
-						url: ie.url,
-						width: Number(ie.width) || 100,
-						height: Number(ie.height) || 100,
-					},
-					font_height: Number(ie.font_height) || 83.333333333333,
-					padding: Number(ie.padding) || 15,
-					__typename: 'GenAILatexItem',
-				},
-			};
-		}
-	};
-
-	let ie = [];
-	let inline_entities = [];
-	let result = '';
-	let last = 0;
-	let citation_index = 1;
-	let hyperlink_index = 0;
-	let latex_index = 0;
-	let stack = [];
-
-	for (let i = 0; i < text.length; i++) {
-		if (text[i] == '[' && text[i - 1] != '\\') {
-			stack.push(i);
-		} else if (text[i] == ']' && (text[i + 1] == '(' || text[i + 1] == '<')) {
-			let start = stack.pop();
-
-			if (start == null) continue;
-
-			let open = text[i + 1];
-			let close = open == '(' ? ')' : '>';
-			let type = open == '(' ? 'link' : 'latex';
-			let end = i + 2;
-			let depth = 1;
-
-			while (end < text.length && depth) {
-				if (text[end] == open && text[end - 1] != '\\') depth++;
-				else if (text[end] == close && text[end - 1] != '\\') depth--;
-				end++;
-			}
-
-			if (depth) continue;
-
-			let raw = text.slice(start + 1, i).trim();
-			let url = text.slice(i + 2, end - 1).trim();
-
-			let key;
-			let tag;
-			let data;
-
-			if (type == 'latex') {
-				if (!latex) continue;
-
-				let [txt = '', width = null, height = null, font_height = null, padding = null] = raw.split('|');
-
-				key = `\u004E\u0049\u0058\u0045\u004C_LATEX_${latex_index++}`;
-				tag = `{{${key}}}${txt || 'image'}{{/${key}}}`;
-
-				data = {
-					type: 'latex',
-					ie: {
-						key,
-						text: txt,
-						url,
-						width,
-						height,
-						font_height,
-						padding,
-					},
-				};
-			} else if (raw) {
-				if (!hyperlink) continue;
-
-				const trusted = !url.startsWith('!');
-
-				if (!trusted) {
-					url = url.slice(1);
-				}
-
-				key = `\u004E\u0049\u0058\u0045\u004C_HYPERLINK_${hyperlink_index++}`;
-				tag = `{{${key}}}${url}{{/${key}}}`;
-
-				data = {
-					type: 'hyperlink',
-					ie: {
-						key,
-						text: raw,
-						url,
-						is_trusted: trusted,
-					},
-				};
-			} else {
-				if (!citation) continue;
-
-				key = `\u004E\u0049\u0058\u0045\u004C_CITATION_${citation_index - 1}`;
-				tag = `{{${key}}}${url}{{/${key}}}`;
-
-				data = {
-					type: 'citation',
-					ie: {
-						reference_id: citation_index++,
-						key,
-						text: '',
-						url,
-					},
-				};
-			}
-
-			result += text.slice(last, start) + tag;
-			last = end;
-
-			ie.push(data);
-
-			const entity = createIE(data.type, data.ie);
-
-			if (entity) {
-				inline_entities.push(entity);
-			}
-
-			i = end - 1;
-		}
-	}
-
-	result += text.slice(last);
-
-	return {
-		text: result,
-		ie,
-		inline_entities,
-	};
-}
-
-async function waitAllPromises(input) {
-	const isPromise = (v) => v && typeof v.then === 'function';
-	const isObject = (v) => v && typeof v === 'object';
-
-	const deep = async (v) => {
-		if (isPromise(v)) return deep(await v);
-		if (Array.isArray(v)) return Promise.all(v.map(deep));
-		if (isObject(v)) {
-			const entries = await Promise.all(Object.entries(v).map(async ([k, val]) => [k, await deep(val)]));
-			return Object.fromEntries(entries);
-		}
-		return v;
-	};
-
-	return deep(await input);
-}
-
-/** Static grab-bag of media/text helpers shared by the builder classes above. */
-class Toolkit {
-	constructor() {}
-
-	/** Parse `[label](url)` hyperlinks, `[]()` citations, and `[expr]<img-url>` latex tags out of `text`. */
-	static extractIE(text, { extract = true, hyperlink = true, citation = true, latex = true } = {}) {
-		return extractIE(text, { extract, hyperlink, citation, latex });
-	}
-
-	/** Resize an image buffer to `x`×`y` via sharp (lazy-loaded; throws with an install hint if sharp isn't present). */
-	static async resize(buffer, x, y, fit = 'cover') {
-		const sharp = await getSharp();
-		return await sharp(buffer)
-			.resize(x, y, {
-				fit,
-				position: 'center',
-				background: { r: 0, g: 0, b: 0, alpha: 0 },
-			})
-			.png()
-			.toBuffer();
-	}
-
-	/** Deeply await every Promise nested in `input` (objects/arrays), resolving it into plain values. */
-	static async waitAllPromises(input) {
-		return await waitAllPromises(input);
-	}
-
-	/** Fetch `url` into a Buffer. @param {boolean} [silent] Return an empty Buffer instead of throwing on failure. @param {number} [timeout] Abort after this many ms (default 15s) instead of hanging indefinitely on a dead/slow host. */
-	static async fetchBuffer(url, options = {}, { silent = true, timeout = 15000 } = {}) {
-		const controller = new AbortController();
-		const timer = setTimeout(() => controller.abort(), timeout);
-		try {
-			let response = await fetch(url, { ...options, signal: options.signal ?? controller.signal });
-			if (!response.ok) throw Error(`HTTP ${response.status}`);
-			return Buffer.from(await response.arrayBuffer());
-		} catch (error) {
-			if (silent) return Buffer.alloc(0);
-			throw error;
-		} finally {
-			clearTimeout(timer);
-		}
-	}
-
-	/** Upload media to WhatsApp's media server and return its `url`/`directPath` descriptor. */
-	static async toUrl(_client, path, mediaType = 'document') {
-		if (!path) throw new Error('Url or buffer needed');
-
-		const media = await prepareWAMessageMedia(
-			{
-				[mediaType]: Buffer.isBuffer(path) ? path : { url: path },
-			},
-			{
-				upload: _client.waUploadToServer,
-				jid: '\u0040\u006e\u0065\u0077\u0073\u006c\u0065\u0074\u0074\u0065\u0072',
-			}
-		);
-
-		return Object.values(media)[0]?.url;
-	}
-
-	/** Normalize a url/buffer/array of either into the requested `result` shape ('url' | 'buffer' | 'base64'), optionally resizing and/or uploading to WA's media server first. */
-	static async resolveMedia(_client, media, mediaType = 'image', { resolveUrl = false, resolveWAUrl = false, result = 'url', resize = false, width = 300, height = 300 } = {}) {
-		const isUrl = (str) => /^https?:\/\/.+/i.test(str);
-
-		const isWAUrl = (str) => /^https?:\/\/[^/]*\.whatsapp\.net\//i.test(str);
-
-		// Vanz@Fix (crash guard) --- keep the original raw url around so that if the
-		// resolveUrl=true upload-to-'@newsletter' round trip (Toolkit.toUrl -> prepareWAMessageMedia)
-		// throws/rejects (blocked account, network hiccup, WA server refusal, etc.), we can
-		// gracefully fall back to the raw url instead of letting the rejection bubble up
-		// unhandled through waitAllPromises() and take the whole process down. Only applies
-		// when the input was actually a url string; buffers/base64 have no such fallback.
-		const rawUrlFallback = typeof media === 'string' && isUrl(media) ? media : undefined;
-
-		if (Array.isArray(media)) {
-			return Promise.all(
-				media.map((item) =>
-					Toolkit.resolveMedia(_client, item, mediaType, {
-						resolveUrl,
-						resolveWAUrl,
-						result,
-						resize,
-						width,
-						height,
-					})
-				)
-			);
-		}
-
-		if (typeof media === 'string' && isUrl(media)) {
-			if (isWAUrl(media)) {
-				if (resolveWAUrl) {
-					media = await Toolkit.fetchBuffer(media, {}, { silent: true });
-				} else if (!resolveUrl) {
-					if (result === 'url') return media;
-
-					media = await Toolkit.fetchBuffer(media, {}, { silent: true });
-				}
-			} else {
-				if (!resolveUrl) {
-					if (result === 'url') return media;
-
-					media = await Toolkit.fetchBuffer(media, {}, { silent: true });
-				} else {
-					media = await Toolkit.fetchBuffer(media, {}, { silent: true });
-				}
-			}
-		}
-
-		if (typeof media === 'string' && !isUrl(media)) {
-			media = Buffer.from(media, 'base64');
-		}
-
-		if (!Buffer.isBuffer(media) || !media.length) {
-			return;
-		}
-
-		if (resize && Buffer.isBuffer(media)) {
-			media = await Toolkit.resize(media, width, height);
-		}
-
-		if (result === 'buffer') {
-			return media;
-		}
-
-		if (result === 'base64') {
-			return media.toString('base64');
-		}
-
-		// Vanz@Fix 22-08-26 (v4.7) --- both branches of the old if/else here returned the exact
-		// same `Toolkit.toUrl(_client, media, mediaType)` call (dead branching left over from an
-		// earlier version that must have treated buffer vs non-buffer input differently). Collapsed
-		// to a single return; `originalIsBuffer` is now unused and removed below.
-		//
-		// Vanz@Fix (crash guard) --- toUrl() uploads to WA's media server under a spoofed
-		// '@newsletter' jid; if that upload fails for any reason, fall back to the raw url
-		// (when we have one) instead of letting the exception propagate and crash the caller.
-		try {
-			return await Toolkit.toUrl(_client, media, mediaType);
-		} catch (err) {
-			if (rawUrlFallback) return rawUrlFallback;
-			throw err;
-		}
-	}
-
-	/** Read an mp4 buffer's duration (seconds) straight from its moov atom, no ffprobe needed. */
-	static getMp4Duration(buffer, { silent = true } = {}) {
-		try {
-			if (!Buffer.isBuffer(buffer) || buffer.length < 8) {
-				if (silent) return 0;
-				throw new Error('Invalid buffer');
-			}
-
-			let offset = 0;
-
-			while (offset < buffer.length - 8) {
-				const size = buffer.readUInt32BE(offset);
-
-				if (size < 8 || offset + size > buffer.length) {
-					if (silent) return 0;
-					throw new Error('Invalid atom size');
-				}
-
-				const type = buffer.toString('ascii', offset + 4, offset + 8);
-
-				if (type === 'moov') {
-					let moovOffset = offset + 8;
-					const moovEnd = offset + size;
-
-					while (moovOffset < moovEnd - 8) {
-						const childSize = buffer.readUInt32BE(moovOffset);
-
-						if (childSize < 8 || moovOffset + childSize > moovEnd) {
-							if (silent) return 0;
-							throw new Error('Invalid child atom size');
-						}
-
-						const childType = buffer.toString('ascii', moovOffset + 4, moovOffset + 8);
-
-						if (childType === 'mvhd') {
-							const version = buffer.readUInt8(moovOffset + 8);
-
-							if (version === 0) {
-								const timescale = buffer.readUInt32BE(moovOffset + 20);
-								const duration = buffer.readUInt32BE(moovOffset + 24);
-
-								if (!timescale) {
-									if (silent) return 0;
-									throw new Error('Invalid timescale');
-								}
-
-								return duration / timescale;
-							}
-
-							if (version === 1) {
-								const timescale = buffer.readUInt32BE(moovOffset + 32);
-								const duration = Number(buffer.readBigUInt64BE(moovOffset + 36));
-
-								if (!timescale) {
-									if (silent) return 0;
-									throw new Error('Invalid timescale');
-								}
-
-								return duration / timescale;
-							}
-						}
-
-						moovOffset += childSize;
-					}
-				}
-
-				offset += size;
-			}
-
-			if (silent) return 0;
-
-			throw new Error('No mvhd found!');
-		} catch (err) {
-			if (silent) return 0;
-			throw err;
-		}
-	}
-
-	/** Extract a single frame from an mp4 buffer as a thumbnail (ffmpeg lazy-loaded; throws with an install hint if missing). */
-	static getMp4Preview(videoBuffer, { time, result = 'buffer', resize = true, width = 300, height = 300, silent = true } = {}) {
-		return new Promise((resolve, reject) => {
-			const fail = (err) => {
-				if (silent) {
-					return resolve(result === 'base64' ? '' : Buffer.alloc(0));
-				}
-				return reject(err);
-			};
-
-			try {
-				if (!Buffer.isBuffer(videoBuffer) || !videoBuffer.length) {
-					return fail(new Error('videoBuffer tidak valid atau kosong'));
-				}
-
-				const inputStream = new Readable({ read() {} });
-				inputStream.push(videoBuffer);
-				inputStream.push(null);
-
-				const outputStream = new PassThrough();
-				const chunks = [];
-
-				outputStream.on('data', (chunk) => chunks.push(chunk));
-
-				outputStream.on('end', async () => {
-					try {
-						let output = Buffer.concat(chunks);
-
-						if (!output.length) {
-							return fail(new Error('Output kosong — cek format atau timestamp video'));
-						}
-
-						if (resize) {
-							output = await Toolkit.resize(output, width, height);
-						}
-
-						return resolve(result === 'base64' ? output.toString('base64') : output);
-					} catch (err) {
-						return fail(err);
-					}
-				});
-
-				outputStream.on('error', fail);
-
-				time ??= Math.min(Toolkit.getMp4Duration(videoBuffer) * 0.2, 10);
-
-				getFfmpeg()
-					.then((ffmpeg) => {
-						ffmpeg(inputStream)
-							.outputOptions([`-ss ${time}`, '-vframes 1', '-vcodec png', '-f image2pipe'])
-							.on('error', (err) => fail(new Error(`ffmpeg error: ${err.message}`)))
-							.pipe(outputStream, { end: true });
-					})
-					.catch(fail);
-			} catch (err) {
-				return fail(err);
-			}
-		});
-	}
-}
-
-/**
- * Shared chaining base for Button/ButtonV2/Carousel/AIRich: title/subtitle/body/footer,
- * contextInfo (quoted/mentions/etc.), and an escape-hatch payload merged verbatim
- * into the generated message content.
- * @abstract
- */
-class BaseBuilder {
-	constructor() {
-		this._title = '';
-		this._subtitle = '';
-		this._body = '';
-		this._footer = '';
-		this._contextInfo = {};
-		this._extraPayload = {};
-	}
-
-	/** @param {string} title */
-	setTitle(title) {
-		if (typeof title !== 'string') {
-			throw new TypeError('Title must be a string');
-		}
-		this._title = title;
-		return this;
-	}
-
-	/** @param {string} subtitle */
-	setSubtitle(subtitle) {
-		if (typeof subtitle !== 'string') {
-			throw new TypeError('Subtitle must be a string');
-		}
-		this._subtitle = subtitle;
-		return this;
-	}
-
-	/** @param {string} body Main message text. */
-	setBody(body) {
-		if (typeof body !== 'string') {
-			throw new TypeError('Body must be a string');
-		}
-		this._body = body;
-		return this;
-	}
-
-	/** @param {string} footer */
-	setFooter(footer) {
-		if (typeof footer !== 'string') {
-			throw new TypeError('Footer must be a string');
-		}
-		this._footer = footer;
-		return this;
-	}
-
-	/** @param {Record<string, any>} obj Raw `contextInfo` (quotedMessage, mentionedJid, etc.), merged verbatim. */
-	setContextInfo(obj) {
-		if (typeof obj !== 'object' || obj === null || Array.isArray(obj)) {
-			throw new TypeError('ContextInfo must be a plain object');
-		}
-
-		this._contextInfo = obj;
-		return this;
-	}
-
-	/** Escape hatch: shallow-merge arbitrary keys into the generated message content, alongside whatever this builder produces. */
-	addPayload(obj) {
-		if (typeof obj !== 'object' || obj === null || Array.isArray(obj)) {
-			throw new TypeError('Payload must be a plain object');
-		}
-
-		Object.assign(this._extraPayload, obj);
-
-		return this;
-	}
-}
-
-/** Tiny fluent helper for building a single quickReply button row (type 1). Standalone — not tied to Button/ButtonV2. */
-class RowBuilder {
-	constructor() {
-		this.buttons = [];
-	}
-
-	button(displayText, buttonId) {
-		this.buttons.push({ buttonId, buttonText: { displayText }, type: 1 });
-		return this;
-	}
-}
-
-/** Thin fluent wrapper around `Button` for building a single image+title+text+reply "card" in one chain. */
-class CardBuilder {
-	/** @param {import('../../WAProto/index.js').WASocket} client Active Baileys socket. */
-	constructor(client) {
-		this._card = new Button(client);
-	}
-
-	image(url) {
-		this._card.setImage(url);
-		return this;
-	}
-
-	title(t) {
-		this._card.setTitle(t);
-		return this;
-	}
-
-	text(t) {
-		this._card.setBody(t);
-		return this;
-	}
-
-	button(displayText, id) {
-		this._card.addReply(displayText, id);
-		return this;
-	}
-}
-
-/**
- * Interactive (native-flow) message builder — header/body/footer + a mix of
- * buttons (quick_reply, cta_url, cta_call, single_select, ...). Sends via
- * `interactiveMessage` (or falls back to a legacy `listMessage` when the
- * only button is a lone `single_select`, since WA doesn't render that
- * combination as native-flow).
- */
-class Button extends BaseBuilder {
-	#client;
-
-	/** @param {import('../../WAProto/index.js').WASocket} client Active Baileys socket (must expose `relayMessage`). */
-	constructor(client) {
-		super();
-		if (!client) {
-			throw new Error('Socket is required');
-		}
-		this.#client = client;
-
-		this._buttons = [];
-		this._data;
-		this._currentSelectionIndex = -1;
-		this._currentSectionIndex = -1;
-		this._params = {};
-	}
-
-	/** Attach a video as the interactive header. @param {string|Buffer} path Url or buffer. */
-	setVideo(path, options = {}) {
-		if (!path) throw new Error('Url or buffer needed');
-		Buffer.isBuffer(path) ? (this._data = { video: path, ...options }) : (this._data = { video: { url: path }, ...options });
-		return this;
-	}
-
-	/** Attach an image as the interactive header. @param {string|Buffer} path Url or buffer. */
-	setImage(path, options = {}) {
-		if (!path) throw new Error('Url or buffer needed');
-		Buffer.isBuffer(path) ? (this._data = { image: path, ...options }) : (this._data = { image: { url: path }, ...options });
-		return this;
-	}
-
-	/** Attach a document as the interactive header. @param {string|Buffer} path Url or buffer. */
-	setDocument(path, options = {}) {
-		if (!path) throw new Error('Url or buffer needed');
-		Buffer.isBuffer(path) ? (this._data = { document: path, ...options }) : (this._data = { document: { url: path }, ...options });
-		return this;
-	}
-
-	/** Set a raw pre-built header media object (bypasses setVideo/setImage/setDocument shorthands). */
-	setMedia(obj) {
-		if (typeof obj !== 'object' || obj === null || Array.isArray(obj)) {
-			throw new TypeError('Media must be a plain object');
-		}
-
-		this._data = obj;
-		return this;
-	}
-
-	/** Remove every button added so far (keeps title/body/footer/media). */
-	clearButtons() {
-		this._buttons = [];
-		return this;
-	}
-
-	/** Overwrite the message-level `nativeFlowMessage.messageParamsJson` payload wholesale. */
-	setParams(obj) {
-		this._params = obj;
-		return this;
-	}
-
-	// Vanz@Add 26-08-26 --- setBloksWidget(): Meta's Bloks/A2UI format, a sibling field to
-	// nativeFlowMessage on interactiveMessage (NOT part of the AIRich rich-response system —
-	// this is a real native interactive UI: checkboxes/text fields/buttons actually work).
-	// Captured traffic gives the A2UI payload as a flat `components` array where every node has
-	// an `id` and children/child reference OTHER nodes by id string. Authoring that by hand is
-	// error-prone (dangling ids, ordering), so this accepts a plain nested tree instead —
-	// { component, ...props, children: [...] } / { component, ...props, child: {...} } — and
-	// flattens it into that array itself, auto-assigning ids.
-	//
-	// Vanz@Fix 26-08-26 (v2) --- Modal is a different shape: `trigger`/`content` point to a
-	// SIBLING node by id (e.g. the Button that opens it), not a fresh child — captured traffic
-	// confirmed `{ trigger: "<id of an existing Button node>", content: "<id of its body>" }`.
-	// Nesting it as a plain `child`/`children` would duplicate the trigger node. So:
-	//   - any prop whose value is `{ component: ..., ... }` is now auto-flattened as a nested
-	//     node too (not just `child`/`children`) — covers Modal.content directly.
-	//   - a node can carry a builder-only `ref: 'name'` tag; another prop can then point back
-	//     at it with `{ $ref: 'name' }`, resolved to that node's real id after the whole tree
-	//     is walked (order-independent). `ref` itself is stripped and never reaches the wire.
-	//
-	// Vanz@Add 01-09-26 --- JSDoc typedefs for the "basic" A2UI catalog below (component set +
-	// props confirmed from captured traffic — see /areas/vanzxy-baileys.md). This is NOT the
-	// official A2UI spec (there isn't a public one we have access to), just what's been observed
-	// on the wire, so BloksNode ends with a permissive `AnyBloksNode` fallback: known components
-	// get full editor autocomplete + prop hints, anything else still type-checks and still works
-	// at runtime (setBloksWidget()'s own validation only ever requires a "component" string).
-	/**
-	 * @typedef {{ $ref: string }} BloksRef
-	 * Points back at a sibling node tagged `ref: 'name'` elsewhere in the same tree (currently
-	 * only needed for `Modal.trigger`/`Modal.content` — everything else nests directly).
-	 */
-	/**
-	 * @typedef {Object} BloksNodeBase
-	 * @property {string} [ref] Builder-only tag so another node can reference this one via `{ $ref: ref }`. Stripped before send.
-	 */
-	/**
-	 * @typedef {BloksNodeBase & { component: 'Column'|'Row', weight?: number, justify?: string, children?: BloksNode[] }} ColumnRowNode
-	 * @typedef {BloksNodeBase & { component: 'Text', text: string, variant?: string }} TextNode
-	 * @typedef {BloksNodeBase & { component: 'Icon', name: string }} IconNode
-	 * @typedef {BloksNodeBase & { component: 'Divider' }} DividerNode
-	 * @typedef {BloksNodeBase & { component: 'Image', url: string, variant?: string, fit?: string }} ImageNode
-	 * @typedef {BloksNodeBase & { component: 'Video', url: string }} VideoNode
-	 * @typedef {BloksNodeBase & { component: 'List', children?: BloksNode[] }} ListNode
-	 * @typedef {BloksNodeBase & { component: 'TextField', label?: string, value?: string, variant?: string }} TextFieldNode
-	 * @typedef {BloksNodeBase & { component: 'DateTimeInput', label?: string, value?: string, enableDate?: boolean, enableTime?: boolean }} DateTimeInputNode
-	 * @typedef {BloksNodeBase & { component: 'Slider', label?: string, min?: number, max?: number, value?: number }} SliderNode
-	 * @typedef {BloksNodeBase & { component: 'CheckBox', label?: string, value?: boolean }} CheckBoxNode
-	 * @typedef {BloksNodeBase & { component: 'ChoicePicker', label?: string, variant?: string, displayStyle?: string, options?: Array<{label: string, value: string}>, value?: string }} ChoicePickerNode
-	 * @typedef {BloksNodeBase & { component: 'Button', child?: BloksNode, variant?: string, action?: { call: string, args?: Record<string, any> } }} BloksButtonNode
-	 *   Note: unlike the CTA/native-flow `Button` class elsewhere in this file, an A2UI Button node
-	 *   has no `label`/`type`+`name` — its label comes from a nested `child` (usually a `Text` node),
-	 *   and tapping it fires `action.call` (with `action.args`), not a native-flow button name.
-	 * @typedef {BloksNodeBase & { component: 'Modal', trigger: string|BloksRef, content: BloksNode|string|BloksRef }} ModalNode
-	 * @typedef {BloksNodeBase & { component: 'Tabs', tabs: Array<{title: string, child: BloksNode}> }} TabsNode
-	 * @typedef {BloksNodeBase & { component: 'Card', child?: BloksNode }} CardNode
-	 * @typedef {BloksNodeBase & { component: 'AudioPlayer', url: string, description?: string }} AudioPlayerNode
-	 * @typedef {BloksNodeBase & { component: string, [key: string]: any }} AnyBloksNode Fallback for components not yet confirmed on the wire — still works, just no prop-level autocomplete.
-	 * @typedef {ColumnRowNode|TextNode|IconNode|DividerNode|ImageNode|VideoNode|ListNode|TextFieldNode|DateTimeInputNode|SliderNode|CheckBoxNode|ChoicePickerNode|BloksButtonNode|ModalNode|TabsNode|CardNode|AudioPlayerNode|AnyBloksNode} BloksNode
-	 */
-	#flattenBloks(tree, out, ctx = { n: 0, refs: new Map(), pending: [] }, id = 'root') {
-		if (!tree || typeof tree !== 'object') throw new TypeError('setBloksWidget: every node needs a "component" type');
-		const { component, children, child, ref, ...rest } = tree;
-		if (typeof component !== 'string' || !component) throw new TypeError('setBloksWidget: every node needs a "component" type');
-
-		const isTreeNode = (v) => v && typeof v === 'object' && !Array.isArray(v) && typeof v.component === 'string';
-		const isRefMarker = (v) => v && typeof v === 'object' && !Array.isArray(v) && typeof v.$ref === 'string' && Object.keys(v).length === 1;
-
-		const node = { id, component };
-		for (const [k, v] of Object.entries(rest)) {
-			if (isRefMarker(v)) {
-				node[k] = null; // resolved once the full tree (and its `ref` tags) has been walked
-				ctx.pending.push({ node, key: k, refName: v.$ref });
-			} else if (isTreeNode(v)) {
-				node[k] = this.#flattenBloks(v, out, ctx, `n${ctx.n++}`);
-			} else {
-				node[k] = v;
-			}
-		}
-
-		if (Array.isArray(children)) {
-			node.children = children.map((c) => this.#flattenBloks(c, out, ctx, `n${ctx.n++}`));
-		} else if (child) {
-			node.child = this.#flattenBloks(child, out, ctx, `n${ctx.n++}`);
-		}
-
-		if (ref) ctx.refs.set(ref, id);
-
-		out.push(node);
-		return id;
-	}
-
-	/**
-	 * Set a Bloks/A2UI native widget (`bloksWidget`, `type: "im_a2ui"`) — a real interactive
-	 * screen (images, video, checkboxes, text fields, buttons that fire an `action`), not a
-	 * static card. Pass a nested tree; ids are assigned automatically.
-	 *
-	 * For components that reference a SIBLING node instead of nesting one — currently just
-	 * `Modal.trigger` — tag the source node with `ref: 'someName'` and point at it with
-	 * `{ $ref: 'someName' }`. Everything else (including `Modal.content`) can just be nested
-	 * directly, no special key needed.
-	 * @param {BloksNode} tree Root node, e.g. `{ component: 'Column', children: [...] }`.
-	 * @param {{uuid?: string, catalogId?: string, surfaceId?: string, version?: string}} [options]
-	 */
-	setBloksWidget(tree, { uuid = crypto.randomUUID(), catalogId = 'https://a2ui.org/specification/v0_9/catalogs/basic/catalog.json', surfaceId, version = 'v0.9' } = {}) {
-		const components = [];
-		const ctx = { n: 0, refs: new Map(), pending: [] };
-		this.#flattenBloks(tree, components, ctx);
-		for (const { node, key, refName } of ctx.pending) {
-			const resolved = ctx.refs.get(refName);
-			if (!resolved) throw new Error(`setBloksWidget: ref "${refName}" (used on "${key}") was never declared with ref: "${refName}" on any node`);
-			node[key] = resolved;
-		}
-
-		this._bloksWidget = {
-			uuid,
-			data: JSON.stringify({
-				version,
-				createSurface: {
-					surfaceId: surfaceId ?? `starcore-widget=${uuid}`,
-					catalogId,
-					components,
-				},
-			}),
-			type: 'im_a2ui',
-		};
-
-		return this;
-	}
-
-	/**
-	 * Low-level escape hatch: push a raw native-flow button by name. Prefer the
-	 * dedicated `add*()` helpers below when one exists — they validate the
-	 * required keys for that button type.
-	 * @param {string} name Native-flow button name, e.g. 'quick_reply', 'cta_url'.
-	 * @param {string|Record<string, any>} params Either a pre-stringified JSON payload or a plain object.
-	 */
-	addButton(name, params) {
-		if (typeof name !== 'string' || !name.trim()) {
-			throw new TypeError('addButton(name, params) requires a non-empty string name');
-		}
-
-		this._buttons.push({
-			name,
-			buttonParamsJson: typeof params === 'string' ? params : JSON.stringify(params),
-		});
-
-		return this;
-	}
-
-	/** Append a row to the section currently open on the last `addSelection()` (call `makeSection()` first). */
-	makeRow(header = '', title = '', description = '', id = '') {
-		if (this._currentSelectionIndex === -1 || this._currentSectionIndex === -1) {
-			throw new Error('You need to create a selection and a section first');
-		}
-		if (!title || !id) {
-			throw new TypeError('makeRow() requires both a title and an id');
-		}
-		const buttonParams = JSON.parse(this._buttons[this._currentSelectionIndex].buttonParamsJson);
-		buttonParams.sections[this._currentSectionIndex].rows.push({ header, title, description, id });
-		this._buttons[this._currentSelectionIndex].buttonParamsJson = JSON.stringify(buttonParams);
-		return this;
-	}
-
-	/** Open a new section on the `single_select` button added by the last `addSelection()` call. */
-	makeSection(title = '', highlight_label = '') {
-		if (this._currentSelectionIndex === -1) {
-			throw new Error('You need to create a selection first');
-		}
-		const buttonParams = JSON.parse(this._buttons[this._currentSelectionIndex].buttonParamsJson);
-		buttonParams.sections.push({ title, highlight_label, rows: [] });
-		this._currentSectionIndex = buttonParams.sections.length - 1;
-		this._buttons[this._currentSelectionIndex].buttonParamsJson = JSON.stringify(buttonParams);
-		return this;
-	}
-
-	/** Start a `single_select` (in-button picker list) button. Follow with `makeSection()` + `makeRow()`. */
-	addSelection(title, options = {}) {
-		if (!title) throw new TypeError('addSelection(title) requires a non-empty title');
-		this._buttons.push({ ...options, name: 'single_select', buttonParamsJson: JSON.stringify({ title, sections: [] }) });
-		this._currentSelectionIndex = this._buttons.length - 1;
-		this._currentSectionIndex = -1;
-		return this;
-	}
-
-	/**
-	 * Add a `quick_reply` button — sends `id` back as the interactive-response id when tapped.
-	 * @param {string} display_text Button label.
-	 * @param {string} id Unique id returned on tap; required, WA silently drops replies without one.
-	 */
-	addReply(display_text = '', id = '', options = {}) {
-		if (!display_text || !id) {
-			throw new TypeError('addReply(display_text, id) requires both a label and a unique id');
-		}
-		this._buttons.push({
-			name: 'quick_reply',
-			buttonParamsJson: JSON.stringify({
-				display_text,
-				id,
-				...options,
-			}),
-		});
-		return this;
-	}
-
-	/**
-	 * Add a `cta_call` (tap-to-dial) button.
-	 * @param {string} display_text Button label.
-	 * @param {string} phone_number Phone number to dial, e.g. '+15551234567'.
-	 */
-	// Vanz@Fix 22-08-26 (v4.7) --- second arg used to be written into buttonParamsJson.id, but
-	// the cta_call schema keys on `phone_number` (confirmed against @chatunity/baileys,
-	// @neoxr/wb, and a WhiskeySockets/Baileys#2626 working example) — `id` is simply ignored
-	// by WhatsApp for this button, so every button built with the old addCall() silently
-	// rendered with no dial action. Kept the same 2nd-positional-arg call shape so existing
-	// call sites keep working; only the wire key changed.
-	addCall(display_text = '', phone_number = '', options = {}) {
-		if (!display_text || !phone_number) {
-			throw new TypeError('addCall(display_text, phone_number) requires both a label and a phone number');
-		}
-		this._buttons.push({
-			name: 'cta_call',
-			buttonParamsJson: JSON.stringify({
-				display_text,
-				phone_number,
-				...options,
-			}),
-		});
-		return this;
-	}
-
-	/** Add a `cta_reminder` button (schedules an in-chat reminder chip). */
-	addReminder(display_text = '', id = '', options = {}) {
-		if (!display_text || !id) {
-			throw new TypeError('addReminder(display_text, id) requires both a label and a unique id');
-		}
-		this._buttons.push({
-			name: 'cta_reminder',
-			buttonParamsJson: JSON.stringify({
-				display_text,
-				id,
-				...options,
-			}),
-		});
-		return this;
-	}
-
-	/** Add a `cta_cancel_reminder` button, pairs with `addReminder()`. */
-	addCancelReminder(display_text = '', id = '', options = {}) {
-		if (!display_text || !id) {
-			throw new TypeError('addCancelReminder(display_text, id) requires both a label and a unique id');
-		}
-		this._buttons.push({
-			name: 'cta_cancel_reminder',
-			buttonParamsJson: JSON.stringify({
-				display_text,
-				id,
-				...options,
-			}),
-		});
-		return this;
-	}
-
-	/** Add an `address_message` button (prompts the user's saved-address picker). */
-	addAddress(display_text = '', id = '', options = {}) {
-		if (!display_text || !id) {
-			throw new TypeError('addAddress(display_text, id) requires both a label and a unique id');
-		}
-		this._buttons.push({
-			name: 'address_message',
-			buttonParamsJson: JSON.stringify({
-				display_text,
-				id,
-				...options,
-			}),
-		});
-		return this;
-	}
-
-	/** Add a `send_location` button (requests the user's live location). */
-	addLocation(options = {}) {
-		this._buttons.push({
-			name: 'send_location',
-			buttonParamsJson: JSON.stringify(options),
-		});
-		return this;
-	}
-
-	/**
-	 * Add a `cta_url` button.
-	 * @param {string} display_text Button label.
-	 * @param {string} url Url opened on tap.
-	 * @param {boolean} webview_interaction Open inside WhatsApp's in-app webview instead of the system browser.
-	 */
-	// Vanz@Add 22-08-26 (v4.7) --- `merchant_url` is present (and equal to `url`) on every
-	// cta_url button seen in captured client traffic, alongside `url`. Defaulted here rather
-	// than left for the caller to remember; still overridable via options if it should differ.
-	addUrl(display_text = '', url = '', webview_interaction = false, options = {}) {
-		if (!display_text || !url) {
-			throw new TypeError('addUrl(display_text, url) requires both a label and a url');
-		}
-		this._buttons.push({
-			...options,
-			name: 'cta_url',
-			buttonParamsJson: JSON.stringify({
-				display_text,
-				url,
-				merchant_url: url,
-				webview_interaction,
-				...options,
-			}),
-		});
-		return this;
-	}
-
-	/** Add a `cta_copy` button (copies `copy_code` to the user's clipboard on tap). */
-	addCopy(display_text = '', copy_code = '', options = {}) {
-		if (!display_text || !copy_code) {
-			throw new TypeError('addCopy(display_text, copy_code) requires both a label and the text to copy');
-		}
-		this._buttons.push({
-			name: 'cta_copy',
-			buttonParamsJson: JSON.stringify({
-				display_text,
-				copy_code,
-				...options,
-			}),
-		});
-		return this;
-	}
-
-	/**
-	 * Add an `open_webview` button — opens a titled in-app webview (distinct from
-	 * `cta_url`'s `webview_interaction` flag: this is its own native-flow name).
-	 * @param {string} title Webview title shown in the header bar.
-	 * @param {string} url Url loaded inside the webview.
-	 */
-	addOpenWebview(title = '', url = '', options = {}) {
-		if (!title || !url) {
-			throw new TypeError('addOpenWebview(title, url) requires both a title and a url');
-		}
-		this._buttons.push({
-			name: 'open_webview',
-			buttonParamsJson: JSON.stringify({
-				title,
-				link: { url },
-				...options,
-			}),
-		});
-		return this;
-	}
-
-	/**
-	 * Add a `cta_catalog` button (opens the sender's WhatsApp Business catalog).
-	 * Vanz@Add 22-08-26 (v4.7) --- WA only shows the catalog action for accounts
-	 * that actually have a catalog attached; on regular accounts the button may
-	 * render inert. See Button.#SPECIAL_FLOW for the native-flow node this name requires.
-	 */
-	addCatalog(display_text = '', options = {}) {
-		this._buttons.push({
-			name: 'cta_catalog',
-			buttonParamsJson: JSON.stringify({
-				...(display_text ? { display_text } : {}),
-				...options,
-			}),
-		});
-		return this;
-	}
-
-	/**
-	 * Add an `automated_greeting_message_view_catalog` button — the "View catalog"
-	 * action WhatsApp Business shows on the automated greeting message.
-	 * Vanz@Add 22-08-26 (v4.7). Business-account only; see Button.#SPECIAL_FLOW.
-	 */
-	addViewCatalog(options = {}) {
-		this._buttons.push({
-			name: 'automated_greeting_message_view_catalog',
-			buttonParamsJson: JSON.stringify(options),
-		});
-		return this;
-	}
-
-	/**
-	 * Add a `call_permission_request` button — asks the user to grant call
-	 * permission before a voice/video call can be placed.
-	 * Vanz@Add 22-08-26 (v4.7). See Button.#SPECIAL_FLOW.
-	 */
-	addCallPermission(display_text = '', options = {}) {
-		this._buttons.push({
-			name: 'call_permission_request',
-			buttonParamsJson: JSON.stringify({
-				...(display_text ? { display_text } : {}),
-				...options,
-			}),
-		});
-		return this;
-	}
-
-	/**
-	 * Add a `payment_info` button carrying a structured payment-settings payload
-	 * (e.g. a PIX static-code block). Payload shape is dictated by WhatsApp's
-	 * payment flows and is passed through as given — validate it yourself.
-	 * Vanz@Add 22-08-26 (v4.7). Business/payment-enabled accounts only.
-	 * @param {Record<string, any>} payload e.g. `{ payment_settings: [{ type: 'pix_static_code', pix_static_code: {...} }] }`.
-	 */
-	addPaymentInfo(payload = {}) {
-		if (typeof payload !== 'object' || payload === null || Array.isArray(payload)) {
-			throw new TypeError('addPaymentInfo(payload) requires a plain object');
-		}
-		this._buttons.push({
-			name: 'payment_info',
-			buttonParamsJson: JSON.stringify(payload),
-		});
-		return this;
-	}
-
-	/**
-	 * Add a `review_and_pay` button (order/payment summary flow).
-	 * Vanz@Add 22-08-26 (v4.7). Server-validated by WhatsApp; malformed or
-	 * unauthorized payloads are typically ignored rather than erroring locally.
-	 * @param {Record<string, any>} payload Order/payment summary payload.
-	 */
-	addReviewAndPay(payload = {}) {
-		if (typeof payload !== 'object' || payload === null || Array.isArray(payload)) {
-			throw new TypeError('addReviewAndPay(payload) requires a plain object');
-		}
-		this._buttons.push({
-			name: 'review_and_pay',
-			buttonParamsJson: JSON.stringify(payload),
-		});
-		return this;
-	}
-
-	/**
-	 * Add a `wa_payment_transaction_details` button referencing a prior transaction.
-	 * Vanz@Add 22-08-26 (v4.7). See Button.#SPECIAL_FLOW.
-	 */
-	addTransactionDetails(payload = {}) {
-		if (typeof payload !== 'object' || payload === null || Array.isArray(payload)) {
-			throw new TypeError('addTransactionDetails(payload) requires a plain object');
-		}
-		this._buttons.push({
-			name: 'wa_payment_transaction_details',
-			buttonParamsJson: JSON.stringify(payload),
-		});
-		return this;
-	}
-
-	/**
-	 * Add an `mpm` (multi-product message) button referencing a set of catalog items.
-	 * Vanz@Add 22-08-26 (v4.7). Business-catalog accounts only; see Button.#SPECIAL_FLOW.
-	 */
-	addMultiProduct(payload = {}) {
-		if (typeof payload !== 'object' || payload === null || Array.isArray(payload)) {
-			throw new TypeError('addMultiProduct(payload) requires a plain object');
-		}
-		this._buttons.push({
-			name: 'mpm',
-			buttonParamsJson: JSON.stringify(payload),
-		});
-		return this;
-	}
-
-
-	/** Native-flow `payment_key_info` shortcut. Payload is passed through unchanged. */
-	addPaymentKeyInfo(payload = {}) {
-		if (typeof payload !== 'object' || payload === null || Array.isArray(payload)) throw new TypeError('addPaymentKeyInfo(payload) requires a plain object');
-		this._buttons.push({ name: 'payment_key_info', buttonParamsJson: JSON.stringify(payload) });
-		return this;
-	}
-
-	/** Native-flow `booking_confirmation` shortcut. Payload is passed through unchanged. */
-	addBookingConfirmation(payload = {}) {
-		if (typeof payload !== 'object' || payload === null || Array.isArray(payload)) throw new TypeError('addBookingConfirmation(payload) requires a plain object');
-		this._buttons.push({ name: 'booking_confirmation', buttonParamsJson: JSON.stringify(payload) });
-		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 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({
-			// Vanz@Fix 27-08-26: the button name was 'flow_action', which is actually
-			// the *field name* inside buttonParamsJson (flow_action: 'navigate' | 'data_exchange'),
-			// not a native_flow name WhatsApp recognises. The real native_flow name for
-			// launching a registered WhatsApp Flow is 'flow' -- client silently ignored
-			// the button because <native_flow name='flow_action'> isn't a thing it renders.
-			name: 'flow',
-			buttonParamsJson: JSON.stringify({
-				flow_message_version: flow.version || '3',
-				// flow_token: unique per-send session token WhatsApp Flows requires to
-				// correlate a flow_action data-exchange callback with this specific
-				// message. Was missing entirely -- without it the client can accept the
-				// message but has nothing to key the flow session on.
-				flow_token: flow.token || generateMessageIDV2(),
-				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
-	// 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}`);
-			}
-		}
-	}
-
-	/** Set the message-level "limited time offer" strip (countdown banner above the buttons). */
-	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;
-	}
-
-	/** Configure how many buttons show inline before the rest collapse into a bottom sheet. */
-	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;
-	}
-
-	/** Configure the tap-target callout shown pointing at a specific button by index. */
-	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',
-			url: 'string',
-			copy_code: 'string',
-			expiration_time: 'number',
-		},
-		bottom_sheet: {
-			in_thread_buttons_limit: 'number',
-			divider_indices: ['number'],
-			list_title: 'string',
-			button_title: 'string',
-		},
-		tap_target_configuration: {
-			title: 'string',
-			description: 'string',
-			canonical_url: 'string',
-			domain: 'string',
-			buttonIndex: 'number',
-		},
-	};
-
-	// Vanz@Add 22-08-26 (v4.7) --- native-flow names WA treats specially: the client
-	// only recognises these when the *first* button's name matches AND the wrapping
-	// <native_flow> biz-node carries the right v/name for that name. Everything not
-	// listed here (quick_reply, cta_url, cta_call, cta_copy, single_select mixed with
-	// others, etc.) uses the generic v=9 name=mixed node, which is what send() emitted
-	// unconditionally before this change. Table cross-checked against the observed
-	// wire behaviour documented by zqdevelopers/zq_baileys_helper and @chatunity/baileys.
-	static #SPECIAL_FLOW = {
-		review_and_pay: { v: '1', name: 'order_details' },
-		payment_info: { v: '1', name: 'payment_info' },
-		mpm: { v: '2', name: 'mpm' },
-		cta_catalog: { v: '2', name: 'cta_catalog' },
-		send_location: { v: '2', name: 'send_location' },
-		call_permission_request: { v: '2', name: 'call_permission_request' },
-		wa_payment_transaction_details: { v: '2', name: 'wa_payment_transaction_details' },
-		payment_key_info: { v: '1', name: 'payment_key_info' },
-		booking_confirmation: { v: '1', name: 'booking_confirmation' },
-		automated_greeting_message_view_catalog: { v: '2', name: 'automated_greeting_message_view_catalog' },
-	};
-
-	/** Render this builder's header/body/footer/media/buttons/params into an `interactiveMessage`-shaped card (without the outer `interactiveMessage` wrapper or contextInfo). */
-	async toCard() {
-		return {
-			body: {
-				text: this._body,
-			},
-			footer: {
-				text: this._footer,
-			},
-			header: {
-				title: this._title,
-				subtitle: this._subtitle,
-				hasMediaAttachment: !!this._data,
-				...(this._data
-					? await prepareWAMessageMedia(this._data, { upload: this.#client.waUploadToServer }).catch((e) => {
-							if (String(e).includes('Invalid media type')) return this._data;
-							throw e;
-						})
-					: {}),
-			},
-			nativeFlowMessage: {
-				messageParamsJson: JSON.stringify(this._params),
-				buttons: this._buttons,
-			},
-		};
-	}
-
-	// Vanz@Fix (bug: single_select alone doesn't render) --- WhatsApp only renders a
-	// `single_select` native_flow button when it's mixed with other native_flow buttons
-	// (biz node <native_flow v='9' name='mixed'>). 'single_select' is NOT in the set of
-	// button names WA treats as a standalone native_flow type (confirmed against
-	// itsliaaa/baileys WABinary/generic-utils.js getBizBinaryNode() — it special-cases
-	// message.listMessage separately, with its own biz node <list v='2' type='product_list'>,
-	// and never routes 'single_select' through the single-type native_flow path).
-	// A lone single_select must be sent as a legacy `listMessage` instead.
-	#isLoneSingleSelect() {
-		return this._buttons.length === 1 && this._buttons[0].name === 'single_select';
-	}
-
-	#toListMessage() {
-		const { title: buttonText, sections } = JSON.parse(this._buttons[0].buttonParamsJson);
-		return {
-			listMessage: {
-				title: this._title || undefined,
-				description: this._body || undefined,
-				footerText: this._footer || undefined,
-				buttonText: buttonText || undefined,
-				listType: 1,
-				sections: (sections || []).map((s) => ({
-					title: s.title,
-					rows: (s.rows || []).map((r) => ({
-						title: r.title || r.header || '',
-						description: r.description || '',
-						rowId: r.id || '',
-					})),
-				})),
-				contextInfo: this._contextInfo,
-			},
-		};
-	}
-
-	/** @returns {Record<string, any>} The final content object, without generating/wrapping a WAMessage. Useful when composing this interactive card into something else (e.g. Carousel). */
-	async build(jid, { ...options } = {}) {
-		if (this._buttons.length === 0 && !this._bloksWidget) {
-			throw new Error('Button requires at least one button (use addReply/addUrl/addCall/addSelection/addButton/...) or a Bloks widget (setBloksWidget())');
-		}
-
-		if (this._buttons.length > 0 && this.#isLoneSingleSelect()) {
-			return generateWAMessageFromContent(jid, { ...this._extraPayload, ...this.#toListMessage() }, { ...options });
-		}
-
-		const message = this._buttons.length > 0 ? await this.toCard() : {};
-
-		return generateWAMessageFromContent(
-			jid,
-			{
-				...(this._bloksWidget && {
-					messageContextInfo: { messageSecret: crypto.randomBytes(32) },
-				}),
-				...this._extraPayload,
-				interactiveMessage: {
-					...message,
-					...(this._bloksWidget && { bloksWidget: this._bloksWidget }),
-					contextInfo: this._contextInfo,
-				},
-			},
-			{ ...options }
-		);
-	}
-
-	/** Build and send this interactive message. @param {string} jid Destination chat/group jid. */
-	async send(jid, { ...options } = {}) {
-		const msg = await this.build(jid, options);
-
-		// Vanz@Fix 27-08-26: delegate the <biz> node to the shared getBizBinaryNode()
-		// helper instead of hand-rolling one here. It already:
-		//  - stamps actual_actors/host_storage/privacy_mode_ts (previously missing,
-		//    the likely cause of single_select's wire being flagged for validation)
-		//  - picks the correct wrapper per button name (FLOWS_MAP dedicated node,
-		//    ORDER_RESPONSE_ALIAS native_flow_name, mixed native_flow, or the
-		//    <list v='2' type='product_list'> node for a lone single_select via
-		//    message.listMessage) using the exact same table messages-send.js uses
-		//    for every non-Button send path, so Button.send() can't silently drift
-		//    out of sync with it.
-		// Button.#SPECIAL_FLOW is kept only as documentation for addFlow()/etc.
-		// JSDoc now (see below); getBizBinaryNode()'s own ORDER_RESPONSE_ALIAS /
-		// FLOWS_MAP tables are what actually pick the wire node -- keep those two
-		// tables in sync if a new special-cased button name is ever added.
-		const bizNode = getBizBinaryNode(msg.message);
-
-		await this.#client.relayMessage(msg.key.remoteJid, msg.message, {
-			messageId: msg.key.id,
-			additionalNodes: [bizNode],
-			...options,
-		});
-		return msg;
-	}
-}
-
-/**
- * Legacy `buttonsMessage` builder (up to 3 simple quick-reply buttons under a
- * media/location header). Simpler and more universally supported than
- * `Button`'s native-flow messages, but capped to `type: 1` quick replies.
- */
-class ButtonV2 extends BaseBuilder {
-	#client;
-
-	/** @param {import('../../WAProto/index.js').WASocket} client Active Baileys socket. */
-	constructor(client) {
-		super();
-		if (!client) {
-			throw new Error('Socket is required');
-		}
-
-		this.#client = client;
-		this._image;
-		this._data;
-		this._buttons = [];
-	}
-
-	/** Add a simple quick-reply button. @param {string} displayText Label. @param {string} [buttonId] Defaults to a random uuid. */
-	addButton(displayText = '', buttonId = crypto.randomUUID()) {
-		if (!displayText) throw new TypeError('addButton(displayText) requires a non-empty label');
-		this._buttons.push({
-			buttonId,
-			buttonText: { displayText },
-			type: 1,
-		});
-		return this;
-	}
-
-	/** Push a raw pre-built button object, bypassing the `addButton()` shorthand. */
-	addRawButton(obj) {
-		if (typeof obj !== 'object' || obj === null || Array.isArray(obj)) {
-			throw new TypeError('Buttons must be a plain object');
-		}
-
-		this._buttons.push(obj);
-		return this;
-	}
-
-	/** Set the header thumbnail (used as a fallback location-header image when no `setMedia()` header is given). */
-	setThumbnail(path) {
-		if (!path) throw new Error('Url or buffer needed');
-		this._image = path;
-		return this;
-	}
-
-	/** Set a raw pre-built header media object for the buttons message. */
-	setMedia(obj) {
-		if (typeof obj !== 'object' || obj === null || Array.isArray(obj)) {
-			throw new TypeError('Media must be a plain object');
-		}
-
-		this._data = obj;
-		return this;
-	}
-
-	/** Alias for addButton() — shorthand parity with RowBuilder#button(). */
-	button(displayText, buttonId) {
-		return this.addButton(displayText, buttonId);
-	}
-
-	/**
-	 * Vanz@Add 29-08-26 --- Fluent row helper ported from the RowBuilder class (already
-	 * present but previously unwired into ButtonV2). Lets callers group buttons via a
-	 * callback instead of chaining addButton() calls one at a time.
-	 * @param {(row: RowBuilder) => void} cb
-	 */
-	row(cb) {
-		const r = new RowBuilder();
-		cb(r);
-		r.buttons.forEach((b) => this._buttons.push(b));
-		return this;
-	}
-
-	// Vanz@Fix 22-08-26 (v4.7) --- _thumbnail was computed unconditionally (fetch + resize) even
-	// when setMedia() is used, in which case the location-fallback header (the only place
-	// _thumbnail is used) never runs at all — wasted network/CPU work on every build() call.
-	// Now only computed when it'll actually be used. Also: `viewOnce` was hardcoded true with no
-	// way to opt out (kept as the default — some clients need it to render legacy buttonsMessage
-	// at all — but it's now a `{ viewOnce = true }` option instead of a hardcoded literal).
-	/** @returns {Promise<Record<string, any>>} The generated WAMessage (without sending). @param {boolean} [viewOnce] Default true — some clients require this for legacy buttonsMessage to render; pass false to send it as a normal (non-disappearing) message. */
-	async build(jid, { viewOnce = true, ...options } = {}) {
-		const _thumbnail = !this._data && this._image ? await Toolkit.resize(Buffer.isBuffer(this._image) ? this._image : await Toolkit.fetchBuffer(this._image, {}, { silent: true }), 300, 300) : null;
-		const msg = generateWAMessageFromContent(
-			jid,
-			{
-				...this._extraPayload,
-				buttonsMessage: {
-					contentText: this._body,
-					footerText: this._footer,
-					...(this._data
-						? this._data
-						: {
-								headerType: 6,
-								locationMessage: {
-									degreesLatitude: 0,
-									degreesLongitude: 0,
-									name: this._title,
-									address: this._subtitle,
-									jpegThumbnail: _thumbnail,
-								},
-							}),
-					viewOnce,
-					contextInfo: this._contextInfo,
-					buttons: [...this._buttons],
-				},
-			},
-			{ ...options }
-		);
-		return msg;
-	}
-
-	/** Build and send this buttons message. @param {string} jid Destination chat/group jid. */
-	async send(jid, { ...options } = {}) {
-		if (this._buttons.length < 1) throw new Error('ButtonV2 requires at least one button');
-		const msg = await this.build(jid, options);
-
-		await this.#client.relayMessage(msg.key.remoteJid, msg.message, {
-			messageId: msg.key.id,
-			additionalNodes: [
-				{
-					tag: 'biz',
-					attrs: {},
-					content: [
-						{
-							tag: 'interactive',
-							attrs: { type: 'native_flow', v: '1' },
-							content: [{ tag: 'native_flow', attrs: { v: '9', name: 'mixed' } }],
-						},
-					],
-				},
-			],
-			...options,
-		});
-		return msg;
-	}
-}
-
-/**
- * Legacy `templateMessage` / `hydratedFourRowTemplate` builder — WA's Generation-1
- * button protocol (predates the nativeFlow format that Button/ButtonV2 use).
- * Capped at 3 buttons (quickReply/url/call only), no interactive list/flow support.
- * Ported from MessageBuilderV4.7.
- */
-class ButtonV3 extends BaseBuilder {
-	#client;
-
-	/** @param {import('../../WAProto/index.js').WASocket} client Active Baileys socket. */
-	constructor(client) {
-		super();
-		if (!client) {
-			throw new Error('Socket is required');
-		}
-
-		this.#client = client;
-		this._data;
-		this._mediaHeaderType = null;
-		this._buttons = [];
-	}
-
-	/** Load an existing templateMessage (e.g. from a fetched/quoted message) for editing. */
-	loadFrom(msg) {
-		if (!msg) throw new Error('templateMessage needed');
-		if (!msg.templateMessage) throw new Error('templateMessage not found');
-
-		const { templateMessage, ...extraPayload } = msg;
-		const hft = templateMessage.hydratedFourRowTemplate || {};
-
-		this._title = hft.hydratedTitleText || '';
-		this._body = hft.hydratedContentText || '';
-		this._footer = hft.hydratedFooterText || '';
-		this._contextInfo = templateMessage.contextInfo || {};
-		this._extraPayload = extraPayload;
-
-		this._buttons = Array.isArray(hft.hydratedButtons)
-			? hft.hydratedButtons.map((button) => ({ ...button }))
-			: [];
-
-		if (hft.imageMessage) {
-			this._data = { imageMessage: hft.imageMessage };
-			this._mediaHeaderType = 'imageMessage';
-		} else if (hft.videoMessage) {
-			this._data = { videoMessage: hft.videoMessage };
-			this._mediaHeaderType = 'videoMessage';
-		} else if (hft.documentMessage) {
-			this._data = { documentMessage: hft.documentMessage };
-			this._mediaHeaderType = 'documentMessage';
-		} else if (hft.locationMessage) {
-			this._data = { locationMessage: hft.locationMessage };
-			this._mediaHeaderType = 'locationMessage';
-		} else {
-			this._data = undefined;
-			this._mediaHeaderType = null;
-		}
-
-		return this;
-	}
-
-	setImage(path, options = {}) {
-		if (!path) throw new Error('Url or buffer needed');
-		this._data = Buffer.isBuffer(path)
-			? { image: path, ...options }
-			: { image: { url: path }, ...options };
-		this._mediaHeaderType = 'imageMessage';
-		return this;
-	}
-
-	setVideo(path, options = {}) {
-		if (!path) throw new Error('Url or buffer needed');
-		this._data = Buffer.isBuffer(path)
-			? { video: path, ...options }
-			: { video: { url: path }, ...options };
-		this._mediaHeaderType = 'videoMessage';
-		return this;
-	}
-
-	setDocument(path, options = {}) {
-		if (!path) throw new Error('Url or buffer needed');
-		this._data = Buffer.isBuffer(path)
-			? { document: path, ...options }
-			: { document: { url: path }, ...options };
-		this._mediaHeaderType = 'documentMessage';
-		return this;
-	}
-
-	setMedia(obj) {
-		if (typeof obj !== 'object' || obj === null || Array.isArray(obj)) {
-			throw new TypeError('Media must be a plain object');
-		}
-		this._data = obj;
-		this._mediaHeaderType = null; // caller is expected to pass an already-resolved shape
-		return this;
-	}
-
-	clearButtons() {
-		this._buttons = [];
-		return this;
-	}
-
-	addButton(hydratedButton) {
-		if (this._buttons.length >= 3) {
-			throw new Error('ButtonV3 (TemplateMessage) supports a maximum of 3 buttons');
-		}
-		this._buttons.push({ index: this._buttons.length + 1, ...hydratedButton });
-		return this;
-	}
-
-	addReply(display_text = '', id = '') {
-		return this.addButton({
-			quickReplyButton: { displayText: display_text, id },
-		});
-	}
-
-	addUrl(display_text = '', url = '', options = {}) {
-		return this.addButton({
-			urlButton: { displayText: display_text, url, ...options },
-		});
-	}
-
-	addCall(display_text = '', phone_number = '') {
-		return this.addButton({
-			callButton: { displayText: display_text, phoneNumber: phone_number },
-		});
-	}
-
-	async toTemplate() {
-		let mediaFields = {};
-
-		if (this._data) {
-			const alreadyResolved =
-				this._data.imageMessage || this._data.videoMessage ||
-				this._data.documentMessage || this._data.locationMessage;
-
-			mediaFields = alreadyResolved
-				? this._data
-				: await prepareWAMessageMedia(this._data, {
-						upload: this.#client.waUploadToServer,
-					}).catch((e) => {
-						if (String(e).includes('Invalid media type')) return this._data;
-						throw e;
-					});
-		} else if (this._title) {
-			mediaFields = { hydratedTitleText: this._title };
-		}
-
-		return {
-			hydratedContentText: this._body,
-			hydratedFooterText: this._footer,
-			hydratedButtons: this._buttons,
-			...mediaFields,
-		};
-	}
-
-	async build(jid, { messageId, ...options } = {}) {
-		const hydratedFourRowTemplate = await this.toTemplate();
-
-		return generateWAMessageFromContent(
-			jid,
-			{
-				...this._extraPayload,
-				templateMessage: {
-					hydratedFourRowTemplate,
-					contextInfo: this._contextInfo,
-				},
-			},
-			{ messageId: messageId || generateMessageIDV2(), ...options },
-		);
-	}
-
-	async send(jid, { messageId, additionalNodes = [], ...options } = {}) {
-		if (this._buttons.length < 1)
-			throw new Error('ButtonV3 requires at least one button');
-		const msg = await this.build(jid, { messageId, ...options });
-
-		// TemplateMessage predates the nativeFlow protocol and does not need the
-		// "biz"/"native_flow" additionalNodes hack that Button/ButtonV2 use.
-		await this.#client.relayMessage(msg.key.remoteJid, msg.message, {
-			messageId: msg.key.id,
-			additionalNodes,
-			...options,
-		});
-		return msg;
-	}
-}
-
-/** Carousel of interactive cards (each with its own header media + optional buttons), scrollable horizontally in-chat. */
-class Carousel extends BaseBuilder {
-	#client;
-
-	// Vanz@Add 22-08-26 (v4.7) --- WhatsApp caps carousels at 10 cards; anything beyond
-	// that is silently truncated client-side, so failing fast here is more useful than
-	// shipping a carousel that quietly loses cards.
-	static MAX_CARDS = 10;
-
-	/** @param {import('../../WAProto/index.js').WASocket} client Active Baileys socket. */
-	constructor(client) {
-		super();
-		if (!client) {
-			throw new Error('Socket is required');
-		}
-
-		this.#client = client;
-		this._cards = [];
-	}
-
-	/**
-	 * Add one card, or an array of cards, to the carousel.
-	 * @param {Record<string, any>|Record<string, any>[]} card A card (or array of cards) with `header.hasMediaAttachment: true`
-	 *   — typically built via `new Button(client).setImage(...).addUrl(...).toCard()`.
-	 */
-	addCard(card) {
-		const cards = Array.isArray(card) ? card : [card];
-		const baseIndex = this._cards.length;
-
-		for (const [index, c] of cards.entries()) {
-			if (!c?.header?.hasMediaAttachment) {
-				throw new Error(`Card [${baseIndex + index}] must include an image or video in header`);
-			}
-		}
-
-		if (this._cards.length + cards.length > Carousel.MAX_CARDS) {
-			throw new Error(`Carousel supports at most ${Carousel.MAX_CARDS} cards (got ${this._cards.length + cards.length})`);
-		}
-
-		this._cards.push(...cards);
-		return this;
-	}
-
-	/** @returns {Record<string, any>} The generated WAMessage (without sending). */
-	build(jid, { ...options } = {}) {
-		return generateWAMessageFromContent(
-			jid,
-			{
-				...this._extraPayload,
-				interactiveMessage: {
-					header: {
-						hasMediaAttachment: false,
-					},
-					body: { text: this._body },
-					footer: { text: this._footer },
-					contextInfo: this._contextInfo,
-					carouselMessage: {
-						cards: this._cards,
-					},
-				},
-			},
-			{ ...options }
-		);
-	}
-
-	/** Build and send this carousel. @param {string} jid Destination chat/group jid. */
-	async send(jid, { ...options } = {}) {
-		if (this._cards.length === 0) throw new Error('Carousel requires at least one card (use addCard())');
-
-		const msg = this.build(jid, options);
-
-		await this.#client.relayMessage(msg.key.remoteJid, msg.message, {
-			messageId: msg.key.id,
-			additionalNodes: [
-				{
-					tag: 'biz',
-					attrs: {},
-					content: [
-						{
-							tag: 'interactive',
-							attrs: { type: 'native_flow', v: '1' },
-							content: [{ tag: 'native_flow', attrs: { v: '9', name: 'mixed' } }],
-						},
-					],
-				},
-			],
-			...options,
-		});
-		return msg;
-	}
-}
-
-/**
- * Vanz@Add (v4.8) --- Chainable poll builder, wrapping the socket's own well-tested
- * `sendMessage({ poll })` path (see messages.js) instead of hand-building
- * pollCreationMessageV3/V5 over relayMessage. Two things from the traffic you sent were
- * deliberately NOT implemented here because they can't be built with confidence:
- *   1. Per-option poll images (`values: [{ name, image }]`) — the proto this fork ships
- *      only has a plain `optionName` string per option; an image-poll option isn't a named
- *      field anywhere in it. The one place an image-poll concept even appears
- *      (`pollCreationOptionImageMessage`) is typed as an opaque `FutureProofMessage` (a
- *      forward-compat envelope with no documented inner layout) — there's no field list to
- *      target, so adding "support" for it would just be silently dropping the image and
- *      guessing at a shape. Flagging instead of faking it.
- *   2. Quiz-mode `correctAnswer.optionHash` built by hand — the one working example you
- *      captured had a 65-character hex string where a sha256 digest should be 64, and this
- *      builder's target `sendMessage({poll})` path (pollCreationMessageV5) already computes
- *      quiz mode correctly from a plain `correctAnswer` string, so `setQuiz()` below defers to
- *      that existing, already-tested logic rather than reimplementing the hash.
- */
-class Poll extends BaseBuilder {
-	#client;
-
-	/** @param {import('../../WAProto/index.js').WASocket} client Active Baileys socket (must expose `sendMessage`). */
-	constructor(client) {
-		super();
-		if (!client) throw new Error('Socket is required');
-		this.#client = client;
-
-		this._name = '';
-		this._values = [];
-		this._selectableCount = 1;
-		this._hideVoter = false;
-		this._canAddOption = false;
-		this._toAnnouncementGroup = false;
-		this._correctAnswer;
-		this._endDate;
-	}
-
-	/** Set the poll question/title. */
-	setName(name) {
-		if (typeof name !== 'string' || !name) throw new TypeError('setName(name) requires a non-empty string');
-		this._name = name;
-		return this;
-	}
-
-	/** Append one option. Chainable — call repeatedly, or use `addOptions()` for an array. */
-	addOption(name) {
-		if (typeof name !== 'string' || !name) throw new TypeError('addOption(name) requires a non-empty string');
-		this._values.push(name);
-		return this;
-	}
-
-	/** Append several options at once. @param {string[]} names */
-	addOptions(names) {
-		if (!Array.isArray(names) || !names.length) throw new TypeError('addOptions(names) requires a non-empty array of strings');
-		names.forEach((name) => this.addOption(name));
-		return this;
-	}
-
-	/** How many options a voter can pick (default 1). Use `setMultiSelect()` for unlimited. */
-	setSelectable(count) {
-		if (typeof count !== 'number' || count < 0) throw new TypeError('setSelectable(count) requires a non-negative number');
-		this._selectableCount = count;
-		return this;
-	}
-
-	/** Shortcut for unlimited-choice polls (`selectableCount: 0`). Pass `false` to revert to single-select. */
-	setMultiSelect(canSelectMultiple = true) {
-		this._selectableCount = canSelectMultiple ? 0 : 1;
-		return this;
-	}
-
-	/** Hide voter names from other participants (where the client supports it). */
-	setHideVoter(hide = true) {
-		this._hideVoter = hide;
-		return this;
-	}
-
-	/** Allow voters to add their own options. */
-	setCanAddOption(allow = true) {
-		this._canAddOption = allow;
-		return this;
-	}
-
-	/** Mark this a community-announcement-group poll (pollCreationMessageV2 path). */
-	setAnnouncementGroup(isAnnouncement = true) {
-		this._toAnnouncementGroup = isAnnouncement;
-		return this;
-	}
-
-	/** Auto-close the poll at this date/time. */
-	setEndDate(date) {
-		this._endDate = date instanceof Date ? date : new Date(date);
-		return this;
-	}
-
-	/**
-	 * Turn this into a quiz: one option is marked correct. Delegates the actual hash/version
-	 * wiring to the socket's own `sendMessage({poll:{...correctAnswer}})` handling — see class
-	 * docblock for why this builder doesn't compute the hash itself.
-	 * @param {string} correctOptionName Must exactly match one of the strings passed to `addOption()`/`addOptions()`.
-	 */
-	setQuiz(correctOptionName) {
-		if (typeof correctOptionName !== 'string' || !correctOptionName) {
-			throw new TypeError('setQuiz(correctOptionName) requires a non-empty string');
-		}
-		this._correctAnswer = correctOptionName;
-		return this;
-	}
-
-	/** @returns {{poll: Record<string, any>}} The `sendMessage()`-shaped poll payload, without sending it. */
-	build() {
-		if (!this._name) throw new Error('Poll requires a name (use setName())');
-		if (this._values.length < 2) throw new Error('Poll requires at least 2 options (use addOption()/addOptions())');
-		if (this._correctAnswer && !this._values.includes(this._correctAnswer)) {
-			throw new Error('setQuiz(correctOptionName) must match one of the added options exactly');
-		}
-
-		return {
-			poll: {
-				name: this._name,
-				values: this._values,
-				selectableCount: this._selectableCount,
-				toAnnouncementGroup: this._toAnnouncementGroup,
-				hideVoter: this._hideVoter,
-				canAddOption: this._canAddOption,
-				...(this._endDate && { endDate: this._endDate }),
-				...(this._correctAnswer && { pollType: 1, correctAnswer: this._correctAnswer }),
-			},
-		};
-	}
-
-	/** Build and send via the socket's `sendMessage()`. */
-	async send(jid, options = {}) {
-		return this.#client.sendMessage(jid, this.build(), options);
-	}
-}
-
-/**
- * "Rich AI-response" style message builder: text with hyperlink/citation/latex
- * inline entities, code blocks, tables, sources, image/video attachments,
- * inline product/post cards, tip banners and quick-reply suggestions —
- * everything ChatGPT/Gemini-in-WhatsApp-style bots typically render.
- * Also exported as `AIVanzxy` / `LeafRich` / `VanzxyAI` / `VanzxyRich` (identical class, alternate names).
- */
-class AIRich extends BaseBuilder {
-	#client;
-
-	constructor(client) {
-		if (!client) {
-			throw new Error('Socket is required');
-		}
-
-		super();
-		this.#client = client;
-		this._contextInfo = {};
-		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 = [];
-
-		// Vanz@Add 24-08-26 --- ported from temen's MessageBuilderV4.7 (setResponseId/setBotResponseId
-		// below), rewritten to fit this fork's conventions. build() used to always mint a fresh
-		// crypto.randomUUID() for both unifiedResponse.response_id and botMetadata.botResponseId on
-		// every call, with no way to reuse one — so a `sendEdit()`-style flow (rebuild the same
-		// message with updated content, same response_id, so WA patches it in place instead of
-		// showing a new message) was never actually possible despite being in the gist example.
-		// null here means "not pinned yet" — build() falls back to a fresh randomUUID() same as before
-		// when neither setResponseId() nor setBotResponseId() has been called.
-		this._responseId = null;
-		this._botResponseId = null;
-
-		// Vanz@Add --- set by send()/sendEdit() after every relay so a follow-up sendEdit(), called
-		// with no args, knows which jid/message id to patch in place (matches temen's v4.7 API).
-		this._lastMessageKey = null;
-
-		// 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).
-		//
-		// Vanz@Note (bug 71, behavior — not fixed, documented) --- insertAt always inserts right after
-		// the ANCHOR's block, not after "whatever was most recently inserted there". Chaining (each new
-		// item gets its own id, and the next call's insertAt points at THAT id — exactly what the
-		// addText/addSuggest streaming-reveal example does) produces the expected order. But calling
-		// insertAt at the SAME static anchor id repeatedly, without giving each new item its own id to
-		// chain onto, inserts every one of them right after the original anchor — so the order comes out
-		// reversed relative to call order (confirmed by test: id:'x' then 3x insertAt:'x' with no id of
-		// their own on the new items produces [x, third, second, first], not [x, first, second, third]).
-		// Left as-is rather than "fixed": making insertAt self-advance (re-pointing the anchor's block at
-		// whatever was just inserted) would silently change what an id resolves to for any OTHER caller
-		// still holding that id for a later replace()/delete()/insertAt() — a subtler, harder-to-diagnose
-		// bug than the surprising-but-deterministic order this produces. Chain with fresh ids instead.
-		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') return orig;
-
-				// Vanz@Fix 23-08-26 (part 2) --- the add*/set* filter below only wrapped methods whose
-				// name starts with "add"/"set". Everything else (send(), build(), ...) fell through to
-				// `return orig` unwrapped, so calling e.g. `richInstance.send(...)` still invoked the
-				// real method with `this` = the Proxy (`receiver`), hitting the exact same
-				// "Cannot read private member #client..." brand-check error the add*/set* fix was for —
-				// just one level up, in send()/build() themselves. Every function property now gets
-				// bound to `target` (the real instance) at minimum; add*/set* additionally get the
-				// insertAt/id bookkeeping below.
-				if (!/^(add|set)/.test(String(prop))) {
-					return (...args) => {
-						const result = orig.apply(target, args);
-						return result === target ? receiver : result;
-					};
-				}
-
-				return (...args) => {
-					const opts = args.find((a) => a && typeof a === 'object' && !Array.isArray(a) && !Buffer.isBuffer(a) && ('id' in a || 'insertAt' in a || 'replace' in a));
-					const id = opts?.id;
-					const insertAt = opts?.insertAt;
-					const replace = opts?.replace;
-
-					// Vanz@Fix (bug 70) --- `id` reuse across two different add*/set* calls was silently
-					// accepted: target._blocks.set(id, ...) below just clobbers the previous registration,
-					// so the FIRST block with that id becomes an untracked ghost — still in _sections/
-					// _submessages (still renders), but no longer reachable via hasId/peek/delete/replace/
-					// insertAt (the id now only resolves to the second block). Confirmed by direct test:
-					// addText('first',{id:'dup'}); addText('second',{id:'dup'}) left both in the message
-					// but getIds() only ever had one 'dup', pointing at 'second'. Fail fast instead — same
-					// as re-registering the same id you're actively `replace`-ing (that's a legitimate
-					// "update this block, keep its id" call, not a collision).
-					if (id && target._blocks.has(id) && replace !== id) {
-						throw new Error(`add*/set*: id "${id}" is already registered — each id must be unique (pass { replace: "${id}" } to update that block instead, or use a different id)`);
-					}
-
-					const subBefore = target._submessages.length;
-					const secBefore = target._sections.length;
-
-					// Vanz@Fix 23-08-26 --- was orig.apply(receiver, args): calling the real method bound to
-					// the Proxy itself (`receiver`) makes any `this.#client` access inside throw
-					// "Cannot read private member #client from an object whose class did not declare it",
-					// because a Proxy is never the branded instance a private field was declared on —
-					// this hit every add*() that touches #client via Toolkit.resolveMedia(this.#client, ...)
-					// (addProduct/addPost/addReels/addSource, and would eventually hit addImage/addVideo
-					// too once JIT/engine specifics changed). Binding to `target` (the real instance) instead
-					// fixes it for good; `target._submessages`/`target._sections` below are unaffected since
-					// they're plain properties, and `result === target ? receiver : result` still converts a
-					// `this`-return back to the Proxy so chaining (`.addX().addY()`) keeps working.
-					const result = orig.apply(target, 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 if (replace) {
-						// replace: delete the old block's items at their current positions,
-						// then insert new items at the same positions
-						const old = target._blocks.get(replace);
-						if (!old) throw new Error(`replace: no block registered with id "${replace}" (register it first with { id: "${replace}" })`);
-
-						let subIdx = old.subItems.length > 0 ? target._submessages.indexOf(old.subItems[0]) : target._submessages.length;
-						if (subIdx === -1) subIdx = target._submessages.length;
-						for (const item of old.subItems) {
-							const i = target._submessages.indexOf(item);
-							if (i !== -1) target._submessages.splice(i, 1);
-						}
-						target._submessages.splice(subIdx, 0, ...subItems);
-
-						let secIdx = old.secItems.length > 0 ? target._sections.indexOf(old.secItems[0]) : target._sections.length;
-						if (secIdx === -1) secIdx = target._sections.length;
-						for (const item of old.secItems) {
-							const i = target._sections.indexOf(item);
-							if (i !== -1) target._sections.splice(i, 1);
-						}
-						target._sections.splice(secIdx, 0, ...secItems);
-
-						target._blocks.delete(replace);
-						if (id) target._blocks.set(id, { subItems, secItems });
-						else target._blocks.set(replace, { subItems, 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). */
-	addSubmessage(submessage) {
-		const items = Array.isArray(submessage) ? submessage : [submessage];
-
-		for (const item of items) {
-			if (typeof item !== 'object' || item === null || Array.isArray(item)) {
-				throw new TypeError('Submessage must be a plain object or array of plain objects');
-			}
-
-			this._submessages.push(item);
-		}
-
-		return this;
-	}
-
-	/** Push a raw pre-built section wrapper around one or more submessages. */
-	addSection(section) {
-		const items = Array.isArray(section) ? section : [section];
-
-		for (const item of items) {
-			if (typeof item !== 'object' || item === null || Array.isArray(item)) {
-				throw new TypeError('Section must be a plain object or array of plain objects');
-			}
-
-			this._sections.push(item);
-		}
-
-		return this;
-	}
-
-	/** Add a text block. `[label](url)` becomes a hyperlink, `[](url)` a numbered citation, `[expr]<img-url>` a rendered latex expression — toggle each via the options. */
-	addText(text, { hyperlink = true, citation = true, latex = true } = {}) {
-		if (typeof text != 'string') {
-			throw new TypeError('Text must be a string');
-		}
-
-		const { text: extractedText, inline_entities } = extractIE(text, {
-			hyperlink,
-			citation,
-			latex,
-		});
-
-		this._submessages.push({
-			messageType: 2,
-			messageText: extractedText,
-		});
-
-		this._sections.push(
-			AIRich.newLayout('Single', {
-				text: extractedText,
-				...(inline_entities.length && {
-					inline_entities,
-				}),
-				__typename: 'GenAIMarkdownTextUXPrimitive',
-			})
-		);
-
-		return this;
-	}
-
-	/** Add a syntax-highlighted code block. @param {string} language e.g. 'javascript', 'python'. */
-	addCode(language, code) {
-		if (typeof language !== 'string' || typeof code !== 'string') {
-			throw new TypeError('Language and code must be a string');
-		}
-
-		const meta = AIRich.tokenizer(code, language);
-
-		this._submessages.push({
-			messageType: 5,
-			codeMetadata: {
-				codeLanguage: language,
-				codeBlocks: meta.codeBlock,
-			},
-		});
-
-		this._sections.push(
-			AIRich.newLayout('Single', {
-				language,
-				code_blocks: meta.unified_codeBlock,
-				__typename: 'GenAICodeUXPrimitive',
-			})
-		);
-
-		return this;
-	}
-
-	/** Add a table. @param {string[][]} table Row-major grid, first row treated as the header. */
-	addTable(table, { hyperlink = true, citation = true, latex = true } = {}) {
-		if (!Array.isArray(table)) {
-			throw new TypeError('Table must be an array');
-		}
-
-		const meta = AIRich.toTableMetadata(table, { hyperlink, citation, latex });
-
-		this._submessages.push({
-			messageType: 4,
-			tableMetadata: {
-				title: meta.title,
-				rows: meta.rows,
-			},
-		});
-
-		this._sections.push(
-			AIRich.newLayout('Single', {
-				rows: meta.unified_rows,
-				__typename: 'GenATableUXPrimitive',
-			})
-		);
-
-		return this;
-	}
-
-	/** 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 } = {}) {
-		// Accept 3 formats:
-		// 1. Array of objects: [{ icon, url, title, subtitle }] — from v4.7 example
-		// 2. Array of string arrays: [['iconUrl', 'url', 'text']]
-		// 3. Single string array (shorthand for format 2): ['iconUrl', 'url', 'text']
-		const isObjArray = Array.isArray(sources) && sources.every((item) => item && typeof item === 'object' && !Array.isArray(item));
-		const isStrArrayArray = Array.isArray(sources) && sources.every((item) => Array.isArray(item) && item.every((v) => typeof v === 'string'));
-		const isFlatStrArray = Array.isArray(sources) && sources.every((item) => typeof item === 'string');
-
-		if (!isObjArray && !isStrArrayArray && !isFlatStrArray) {
-			throw new TypeError('addSource(): pass an array of objects { icon, url, title, subtitle } or string arrays [iconUrl, url, text]');
-		}
-
-		let normalized;
-		if (isObjArray) {
-			normalized = sources.map((item) => ({
-				icon: item.icon ?? item.iconUrl ?? item.favicon ?? '',
-				url: item.url ?? '',
-				text: item.title ?? item.displayName ?? item.text ?? '',
-				subtitle: item.subtitle ?? 'AI',
-			}));
-		} else {
-			const arr = isFlatStrArray ? [sources] : sources;
-			normalized = arr.map(([icon = '', url = '', text = '']) => ({ icon, url, text, subtitle: 'AI' }));
-		}
-
-		const source = normalized.map(({ icon, url, text, subtitle }) => ({
-			source_type: 'THIRD_PARTY',
-			source_display_name: text,
-			source_subtitle: subtitle,
-			source_url: url,
-			favicon: {
-				url: Toolkit.resolveMedia(this.#client, icon, 'image', { resolveUrl }),
-				mime_type: 'image/jpeg',
-				width: 16,
-				height: 16,
-			},
-		}));
-
-		this._sections.push(
-			AIRich.newLayout('Single', {
-				sources: source,
-				__typename: 'GenAISearchResultPrimitive',
-			})
-		);
-
-		return this;
-	}
-
-	/** Add a horizontally-scrollable reel of image/video items. */
-	addReels(reelsItems = [], { resolveUrl = false } = {}) {
-		if (
-			!(
-				(reelsItems && typeof reelsItems === 'object' && !Array.isArray(reelsItems)) ||
-				(Array.isArray(reelsItems) && reelsItems.every((item) => item && typeof item === 'object' && !Array.isArray(item)))
-			)
-		) {
-			throw new TypeError('Reels items must be an object or an array of objects');
-		}
-
-		if (!Array.isArray(reelsItems)) {
-			reelsItems = [reelsItems];
-		}
-
-		const reels = reelsItems.map((item) => ({
-			...item,
-			_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({
-			messageType: 9,
-			contentItemsMetadata: {
-				contentType: 1,
-				itemsMetadata: reels.map((item) => ({
-					reelItem: {
-						title: item.username ?? '',
-						profileIconUrl: item._avatar,
-						thumbnailUrl: item._thumbnail,
-						videoUrl: item.videoUrl ?? item.url ?? '',
-					},
-				})),
-			},
-		});
-
-		reels.forEach((item, idx) => {
-			this._richResponseSources.push({
-				provider: 'Evernight AI',
-				thumbnailCDNURL: item._thumbnail,
-				sourceProviderURL: item.videoUrl ?? item.url ?? '',
-				sourceQuery: '',
-				faviconCDNURL: item._avatar,
-				citationNumber: idx + 1,
-				sourceTitle: item.username ?? '',
-			});
-		});
-
-		this._sections.push(
-			AIRich.newLayout(
-				'HScroll',
-				reels.map((item) => ({
-					reels_url: item.videoUrl ?? item.url ?? '',
-					thumbnail_url: item._thumbnail,
-					creator: item.username ?? item.title ?? '',
-					avatar_url: item._avatar,
-					reels_title: item.reels_title ?? item.title ?? '',
-					likes_count: item.likes_count ?? item.like ?? 0,
-					shares_count: item.shares_count ?? item.share ?? 0,
-					view_count: item.view_count ?? item.view ?? 0,
-					reel_source: item.reel_source ?? item.source ?? 'IG',
-					is_verified: !!(item.is_verified || item.verified),
-					__typename: 'GenAIReelPrimitive',
-				}))
-			)
-		);
-
-		return this;
-	}
-
-	/** Add a full-width image (or grid of images if `imageUrl` is an array). */
-	/**
-	 * @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) => {
-					const url = Toolkit.resolveMedia(this.#client, v, 'image', { resolveUrl });
-					return {
-						imagePreviewUrl: url,
-						imageHighResUrl: url,
-						sourceUrl: url,
-					};
-				})
-			: (() => {
-					const url = Toolkit.resolveMedia(this.#client, imageUrl, 'image', { resolveUrl });
-					return [
-						{
-							imagePreviewUrl: url,
-							imageHighResUrl: url,
-							sourceUrl: url,
-						},
-					];
-				})();
-
-		const buildCard = instant !== 'only';
-
-		if (buildCard) {
-			this._submessages.push({
-				messageType: 1,
-				gridImageMetadata: {
-					gridImageUrl: {
-						imagePreviewUrl: list[0]?.imagePreviewUrl,
-					},
-					imageUrls: list,
-				},
-			});
-		}
-
-		list.forEach(({ imagePreviewUrl }) => {
-			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;
-	}
-
-	// 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().
-	/** Add an image inline with the surrounding text flow (falls back to a plain imageMessage on send() if the client can't render inline images — see skipImageFallback). */
-	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
-	// 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, resolveUrl = false } = {}) {
-		const isObjectVideo = (v) => v && typeof v === 'object' && v.url;
-
-		const isValidPrimitive =
-			typeof videoUrl === 'string' ||
-			Buffer.isBuffer(videoUrl) ||
-			isObjectVideo(videoUrl) ||
-			(Array.isArray(videoUrl) && videoUrl.every((v) => typeof v === 'string' || Buffer.isBuffer(v) || isObjectVideo(v)));
-
-		if (!isValidPrimitive) {
-			throw new TypeError('videoUrl must be string | buffer | object | array');
-		}
-
-		const items = Array.isArray(videoUrl) ? videoUrl : [videoUrl];
-
-		this._submessages.push({
-			messageType: 2,
-			messageText: '[ Video tidak dapat dimuat ]',
-		});
-
-		items.forEach((item) => {
-			const isObject = isObjectVideo(item);
-
-			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;
-
-			const file_length = isObject && item.file_length != null ? item.file_length : autoFill ? bufferPromise.then((b) => b?.length ?? 0) : 0;
-
-			const duration =
-				isObject && item.duration != null
-					? item.duration
-					: autoFill
-						? bufferPromise.then((b) =>
-								Toolkit.getMp4Duration(b, {
-									silent: true,
-								})
-							)
-						: 0;
-
-			const thumbnail =
-				isObject && item.thumbnail
-					? Toolkit.resolveMedia(this.#client, item.thumbnail, 'image', {
-							result: 'base64',
-							resize: true,
-							width: 300,
-							height: 300,
-						})
-					: autoFill
-						? bufferPromise
-							? bufferPromise.then((b) =>
-									Toolkit.getMp4Preview(b, {
-										time: 0,
-										result: 'base64',
-									})
-								)
-							: null
-						: null;
-
-			this._sections.push(
-				AIRich.newLayout('Single', {
-					media: {
-						url,
-						mime_type: isObject ? (item.mime_type ?? 'video/mp4') : 'video/mp4',
-						file_length,
-						duration,
-					},
-					imagine_type: 'ANIMATE',
-					status: { status: 'READY' },
-					thumbnail: {
-						raw_media: thumbnail,
-					},
-					__typename: 'GenAIImaginePrimitive',
-				})
-			);
-		});
-
-		return this;
-	}
-
-	/** Add an inline product card (or array of cards). Each item needs at least a `title`. */
-	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');
-		}
-
-		const itemsToCheck = Array.isArray(data) ? data : [data];
-		const missingTitleAt = itemsToCheck.findIndex((item) => !item.title);
-		if (missingTitleAt !== -1) {
-			throw new TypeError(`addProduct() item[${missingTitleAt}] is missing a required "title"`);
-		}
-
-		this._submessages.push({
-			messageType: 2,
-			messageText: '[ Produk tidak dapat dimuat ]',
-		});
-
-		const items = Array.isArray(data) ? data : [data];
-
-		const product = items.map((item) => ({
-			title: item.title,
-			brand: item.brand,
-			price: item.price,
-			sale_price: item.sale_price,
-			product_url: item.product_url ?? item.url,
-			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', { resolveUrl }),
-				},
-			],
-			__typename: 'GenAIProductItemCardPrimitive',
-		}));
-
-		this._sections.push(AIRich.newLayout(Array.isArray(data) ? 'HScroll' : 'Single', Array.isArray(data) ? product : product[0]));
-
-		return this;
-	}
-
-	/** Add an inline social-post style card (or array of cards). */
-	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');
-		}
-
-		const posts = Array.isArray(data) ? data : [data];
-
-		this._submessages.push({
-			messageType: 2,
-			messageText: '[ Postingan tidak dapat dimuat ]',
-		});
-
-		const primitives = posts.map((p) => ({
-			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', { resolveUrl }),
-			is_verified: !!(p.is_verified || p.verified),
-			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,
-			shares_count: p.shares_count ?? p.share ?? 0,
-			post_url: p.post_url ?? p.url ?? '',
-			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', { resolveUrl }),
-			is_carousel: posts.length > 1,
-			orientation: p.orientation ?? 'LANDSCAPE',
-			post_type: p.post_type ?? 'VIDEO',
-			__typename: 'GenAIPostPrimitive',
-		}));
-
-		this._sections.push(AIRich.newLayout('HScroll', primitives));
-
-		return this;
-	}
-
-	// Vanz@Add 24-08-26 --- ported from temen's MessageBuilderV4.7 (setResponseId/setBotResponseId/
-	// refreshResponseId/refreshBotResponseId), rewritten for this fork. Pins the two ids build()
-	// generates (see constructor comment) so a rebuilt message can reuse the same response_id/
-	// botResponseId — needed for editing an already-sent AIRich message in place.
-
-	/** Pin `unifiedResponse.response_id` to a specific value instead of a fresh random one each build() — needed to re-send an edited version of an already-sent message in place. */
-	setResponseId(id) {
-		if (typeof id !== 'string' || !id) throw new TypeError('setResponseId(id) requires a non-empty string');
-		this._responseId = id;
-		return this;
-	}
-
-	/** Un-pin `unifiedResponse.response_id`, generating a fresh crypto.randomUUID() immediately (not deferred to the next build()). */
-	refreshResponseId() {
-		this._responseId = crypto.randomUUID();
-		return this;
-	}
-
-	/** Pin `botMetadata.botResponseId` to a specific value instead of a fresh random one each build(). */
-	setBotResponseId(id) {
-		if (typeof id !== 'string' || !id) throw new TypeError('setBotResponseId(id) requires a non-empty string');
-		this._botResponseId = id;
-		return this;
-	}
-
-	/** Un-pin `botMetadata.botResponseId`, generating a fresh crypto.randomUUID() immediately. */
-	refreshBotResponseId() {
-		this._botResponseId = crypto.randomUUID();
-		return this;
-	}
-
-	// Vanz@Add 25-08-26 --- ported from temen's MessageBuilderV4.7 (hasId/getIds/peek/delete).
-	// That fork tracked every block in a unified `_nodes` array so query/delete-by-id was free;
-	// this fork instead tracks blocks in the `_blocks` Map (id -> {subItems, secItems}, populated
-	// by the constructor's Proxy on every add*/set* call that passes {id}) but never exposed a way
-	// to query or undo one after the fact — you could insertAt an id but never inspect, check, or
-	// remove it. These 4 read/delete that same Map, so no changes to the Proxy itself were needed.
-
-	/** Check whether a block id was registered by an earlier `add*()`/`set*()` call passing `{id}`. */
-	hasId(id) {
-		return typeof id === 'string' && this._blocks.has(id);
-	}
-
-	/** List every block id registered so far, in no particular order. */
-	getIds() {
-		return [...this._blocks.keys()];
-	}
-
-	/** Inspect a registered block without modifying it. Returns `null` if `id` isn't registered. */
-	peek(id) {
-		const block = this._blocks.get(id);
-		if (!block) return null;
-
-		return { id, sections: [...block.secItems], submessages: [...block.subItems] };
-	}
-
-	/** Remove a previously-added block (by the `id` passed to its `add*()`/`set*()` call) from the message. Throws if `id` isn't registered. */
-	delete(id) {
-		const block = this._blocks.get(id);
-		if (!block) throw new Error(`delete(id): no block registered with id "${id}"`);
-
-		for (const item of block.subItems) {
-			const idx = this._submessages.indexOf(item);
-			if (idx !== -1) this._submessages.splice(idx, 1);
-		}
-		for (const item of block.secItems) {
-			const idx = this._sections.indexOf(item);
-			if (idx !== -1) this._sections.splice(idx, 1);
-		}
-
-		this._blocks.delete(id);
-		return this;
-	}
-
-	/** Add a small metadata-style text line (`GenAIMetadataTextPrimitive`) — same visual style as the auto-appended footer/`addTip()`'s callout, but insertable anywhere and without `addTip()`'s icon prefix. */
-	addMetadata(text) {
-		if (typeof text !== 'string' || !text) throw new TypeError('addMetadata(text) requires a non-empty string');
-
-		this._submessages.push({
-			messageType: 2,
-			messageText: text,
-		});
-
-		this._sections.push(
-			AIRich.newLayout('Single', {
-				text,
-				__typename: 'GenAIMetadataTextPrimitive',
-			})
-		);
-
-		return this;
-	}
-
-	/** Add a small "tip" callout banner. @param {string} text */
-	addTip(text) {
-		if (typeof text !== 'string' || !text) {
-			throw new TypeError('addTip(text) requires a non-empty string');
-		}
-
-		this._submessages.push({
-			messageType: 2,
-			messageText: text,
-		});
-
-		this._sections.push(
-			AIRich.newLayout('Single', {
-				text,
-				__typename: 'GenAIMetadataTextPrimitive',
-			})
-		);
-
-		return this;
-	}
-
-	// Vanz@Add 22-08-26 (v4.7) --- addHeading/addWidget/addFooterAction: 3 primitives
-	// reverse-engineered from captured Meta-AI-in-WhatsApp traffic that this project's own crm/snip
-	// tooling (see rich-message-utils.js) dumps for study. Not in any public Baileys schema, so
-	// unknown enum values (kind/state on addWidget's ctas) are passed through as observed rather
-	// than guessed at, and documented as experimental below.
-	// Vanz@Fix 25-08-26 --- removed addImageCard(): its GenAIImagePrimitive/preview_image+full_image
-	// shape was mis-reverse-engineered (not a real WA schema) and crashed the client renderer on
-	// arrival. addImage() already covers static image cards correctly — use that instead.
-
-	/** Add a large heading-style text block (`FOATextPrimitive`) — visually distinct from `addText()`'s regular paragraph text. */
-	addHeading(text) {
-		if (typeof text !== 'string' || !text) {
-			throw new TypeError('addHeading(text) requires a non-empty string');
-		}
-
-		this._submessages.push({
-			messageType: 2,
-			messageText: text,
-		});
-
-		this._sections.push(
-			AIRich.newLayout('Single', {
-				text,
-				__typename: 'FOATextPrimitive',
-			})
-		);
-
-		return this;
-	}
-
-	/**
-	 * Add a "3P extension" widget card (`GenAI3PExtWidgetPrimitive`) — a small panel with a title and
-	 * a row of tappable CTA chips. Per captured traffic these CTAs call back into a tool (`tool_call_id`)
-	 * rather than opening a url; `kind`/`state` semantics beyond the observed `'OTHER'`/`'PENDING'`
-	 * defaults aren't publicly documented, so treat this as experimental.
-	 *
-	 * Vanz@Add (v4.8) --- accepts an `{ layout }` override so consecutive `addWidget()` calls can
-	 * pick different renderings (e.g. one `HScroll` row, one `ActionRow` stack) instead of always
-	 * inferring HScroll-for-array/Single-for-object from the shape of `data`. Also accepts either
-	 * `ctas` (original key, matches the wire field) or `actions` (alias) on each item — whichever
-	 * is present is used; `ctas` wins if both are somehow given.
-	 * @param {Record<string, any>|Record<string, any>[]} data `{ title, ctas|actions: [{ label, tool_call_id?, kind?, state?, toast? }] }` (single or array).
-	 * @param {{layout?: 'Single'|'HScroll'|'ActionRow'|string}} [options] `layout` overrides the default single/array inference.
-	 */
-	addWidget(data = {}, { layout } = {}) {
-		const items = Array.isArray(data) ? data : [data];
-
-		// Vanz@Fix (bug 44) --- layout: 'Single' forces `widgets[0]` below (a "Single" layout's
-		// view_model can only ever hold one `primitive`, never a `primitives` array — see
-		// newLayout()). Previously an explicit { layout: 'Single' } combined with a multi-item
-		// array silently dropped every item past the first with no error. Fail loud instead.
-		if (layout === 'Single' && items.length > 1) {
-			throw new TypeError(`addWidget(): layout "Single" can only hold one widget (got ${items.length}) — use "HScroll"/"ActionRow" (or omit layout) for multiple`);
-		}
-
-		items.forEach((item, i) => {
-			// header.title or top-level title required
-			const hasTitle = item?.title || item?.header?.title;
-			if (!hasTitle) {
-				throw new TypeError(`addWidget() item[${i}] is missing a required "title" (or "header.title")`);
-			}
-			const ctas = item.ctas ?? item.actions;
-			if (!Array.isArray(ctas) || !ctas.length) {
-				throw new TypeError(`addWidget() item[${i}] requires a non-empty "ctas" (or "actions") array`);
-			}
-		});
-
-		this._submessages.push({
-			messageType: 2,
-			messageText: items.map((item) => item.header?.title ?? item.title).join(', '),
-		});
-
-		// Vanz@Fix (bug 45) --- auto tool_call_id used to be `idx` scoped per-item (ctas.map's own
-		// index), resetting to 0 for every widget item. Two items (or two separate addWidget()
-		// calls) that both omit tool_call_id/id ended up minting the identical auto id ("00"),
-		// so a CTA tap could route to the wrong widget's tool call. Track the counter on the
-		// instance instead so every auto-generated id is unique for this AIRich's lifetime.
-		this._widgetCtaCounter ??= 0;
-
-		const widgets = items.map((item) => {
-			const ctas = item.ctas ?? item.actions;
-			// header accepts either a string title (legacy) or an object { title, subtitle }
-			const headerTitle = item.header?.title ?? item.title;
-			const headerSubtitle = item.header?.subtitle ?? item.subtitle ?? undefined;
-			return {
-				header: {
-					title: headerTitle,
-					...(headerSubtitle !== undefined && { subtitle: headerSubtitle }),
-					__typename: 'GenAI3PExtWidgetStandardHeader',
-				},
-				body: {
-					sections: item.sections ?? [],
-					ctas: ctas.map((cta) => ({
-						label: cta.label ?? '',
-						state: cta.state ?? 'PENDING',
-						kind: cta.kind ?? 'OTHER',
-						tool_call_id: cta.tool_call_id ?? cta.id ?? String(this._widgetCtaCounter++).padStart(2, '0'),
-						...(cta.toast !== false && {
-							toast: { label: typeof cta.toast === 'string' ? cta.toast : headerTitle, __typename: 'GenAI3PExtWidgetToast' },
-						}),
-						__typename: 'GenAI3PExtWidgetCTA',
-					})),
-					__typename: item.body_typename ?? 'GenAI3PExtCalendarEventList',
-				},
-				__typename: 'GenAI3PExtWidgetPrimitive',
-			};
-		});
-
-		const resolvedLayout = layout ?? (Array.isArray(data) ? 'HScroll' : 'Single');
-		const asArray = resolvedLayout !== 'Single';
-
-		this._sections.push(AIRich.newLayout(resolvedLayout, asArray ? widgets : widgets[0]));
-
-		return this;
-	}
-
-	/**
-	 * Add footer action link(s) (`GenAIFooterActionPrimitive`) — e.g. "Join our WhatsApp Group/Channel"
-	 * chips shown below the response, separate from `setFooter()`'s plain text footer.
-	 * @param {{text: string, url: string, type?: string}|{text: string, url: string, type?: string}[]} actions
-	 */
-	addFooterAction(actions) {
-		const items = Array.isArray(actions) ? actions : [actions];
-
-		items.forEach((item, i) => {
-			if (!item?.text || !item?.url) {
-				throw new TypeError(`addFooterAction() item[${i}] requires both "text" and "url"`);
-			}
-		});
-
-		const primitives = items.map((item) => ({
-			cta_text: item.text,
-			cta_type: item.type ?? 'OPEN_URL',
-			cta_url: item.url,
-			__typename: 'GenAIFooterActionPrimitive',
-		}));
-
-		this._sections.push(AIRich.newLayout('HScroll', primitives));
-
-		return this;
-	}
-
-	// Vanz@Add (v4.8) --- 8 primitives from the 20-item reference test script that had no
-	// add*() helper yet (Divider/Spacer/Task/ProgressStatus/ThinkingStatus/QuotaUpsell/FOABloks
-	// have no dedicated AIRichResponseSubMessageType — WA carries them purely in the
-	// unifiedResponse view-model JSON, so their submessage falls back to plain AI_RICH_RESPONSE_TEXT
-	// like addTip/addHeading already do. Latex is the one exception: it has a real proto type
-	// (AI_RICH_RESPONSE_LATEX = 8, confirmed in WAProto) with its own latexMetadata, so that one
-	// gets a proper submessage instead of the text fallback.
-
-	/** Add a plain horizontal divider line (`GenAIDividerPrimitive`, no content). */
-	addDivider() {
-		this._submessages.push({ messageType: 2, messageText: '---' });
-		this._sections.push(AIRich.newLayout('Single', { __typename: 'GenAIDividerPrimitive' }));
-		return this;
-	}
-
-	/** Add blank vertical spacing (`GenAISpacerPrimitive`). @param {number} [spacing=1] Spacing unit, per observed traffic. */
-	addSpacer(spacing = 1) {
-		if (typeof spacing !== 'number' || spacing < 0) {
-			throw new TypeError('addSpacer(spacing) requires a non-negative number');
-		}
-		this._submessages.push({ messageType: 2, messageText: `spasi ${spacing}` });
-		this._sections.push(AIRich.newLayout('Single', { spacing, __typename: 'GenAISpacerPrimitive' }));
-		return this;
-	}
-
-	/**
-	 * Add a rendered LaTeX expression (`GenAILatexUXPrimitive`), with a real `AI_RICH_RESPONSE_LATEX`
-	 * submessage (unlike most primitives in this block, this one has a proper proto type).
-	 * @param {string} expression LaTeX source, e.g. `'$$E = mc^2$$'`.
-	 */
-	addLatex(expression) {
-		if (typeof expression !== 'string' || !expression) {
-			throw new TypeError('addLatex(expression) requires a non-empty string');
-		}
-		this._submessages.push({
-			messageType: 8,
-			latexMetadata: { text: expression, expressions: [{ latexExpression: expression }] },
-		});
-		this._sections.push(AIRich.newLayout('Single', { latex_expression: expression, __typename: 'GenAILatexUXPrimitive' }));
-		return this;
-	}
-
-	/**
-	 * Add a task/checklist card (`GenAITaskPrimitive`).
-	 * @param {{task_id?: string, title: string, subtitle?: string, status?: string}} data
-	 */
-	addTask(data = {}) {
-		if (!data?.title) {
-			throw new TypeError('addTask() requires a "title"');
-		}
-		this._submessages.push({ messageType: 2, messageText: `Tugas: ${data.title}` });
-		this._sections.push(
-			AIRich.newLayout('Single', {
-				task_id: data.task_id ?? '',
-				title: data.title,
-				subtitle: data.subtitle ?? '',
-				status: data.status ?? 'IN_PROGRESS',
-				__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;
-	}
-
-	/**
-	 * Add a "searching/working" progress banner (`GenAIBotProgressStatusPrimitive`) — a one-shot
-	 * status chip (unlike `addSuggest`, this isn't tappable). Distinct from `addThinkingStatus()`'s
-	 * icon/typename.
-	 * @param {string} title
-	 * @param {{icon?: string, is_in_progress?: boolean}} [options]
-	 */
-	addProgressStatus(title, { icon = 'SEARCH', is_in_progress = true, target_secondary_screen_id, target_secondary_screen_tab_id } = {}) {
-		if (typeof title !== 'string' || !title) {
-			throw new TypeError('addProgressStatus(title) requires a non-empty string');
-		}
-		this._submessages.push({ messageType: 2, messageText: title });
-		const primitive = {
-			title,
-			icon,
-			is_in_progress,
-			meta_search_apps: [],
-			__typename: 'GenAIBotProgressStatusPrimitive',
-		};
-		// NOTE: these two fields must be OMITTED when unset, not sent as `null` —
-		// an explicit null here was reproducibly crashing the WA client renderer
-		// on group-open/media-download. Only include when the caller actually passes one.
-		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));
-		return this;
-	}
-
-	/** 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, textFallback = true } = {}) {
-		if (typeof title !== 'string' || !title) {
-			throw new TypeError('addThinkingStatus(title) requires a non-empty string');
-		}
-		this._submessages.push({ messageType: 2, messageText: title });
-		const primitive = {
-			title,
-			icon,
-			is_in_progress,
-			meta_search_apps: [],
-			__typename: 'GenAIBotThinkingStatusPrimitive',
-		};
-		// Same crash-avoidance rule as addProgressStatus(): omit, never null.
-		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;
-	}
-
-	/**
-	 * Add a subscription-quota-limit upsell card (`GenAIMetaSubsQuotaUpsellPrimitive`).
-	 * @param {{title: string, body?: string, body_line1?: string, body_line2?: string, buttons?: {label: string, action?: string, deeplink?: string}[]}} data
-	 */
-	addQuotaUpsell(data = {}) {
-		if (!data?.title) {
-			throw new TypeError('addQuotaUpsell() requires a "title"');
-		}
-		this._submessages.push({ messageType: 2, messageText: data.title });
-		this._sections.push(
-			AIRich.newLayout('Single', {
-				title: data.title,
-				body: data.body ?? '',
-				body_line1: data.body_line1 ?? '',
-				body_line2: data.body_line2 ?? '',
-				buttons: (data.buttons ?? []).map((b) => ({
-					label: b.label ?? '',
-					action: b.action ?? 'OPEN_DEEPLINK',
-					deeplink: b.deeplink ?? '',
-				})),
-				__typename: 'GenAIMetaSubsQuotaUpsellPrimitive',
-			})
-		);
-		return this;
-	}
-
-	/**
-	 * Add a raw Bloks payload (`FOABloksPrimitive`) — Meta's internal UI-description format.
-	 * Escape hatch: field meaning beyond what's passed through is undocumented, so this is the
-	 * most experimental primitive in this block; pass whatever your captured traffic shows.
-	 * @param {{type: string, data: string, uuid?: string, initial_response?: any, versioning_id?: string}} data
-	 */
-	addBloks(data = {}) {
-		if (!data?.type) {
-			throw new TypeError('addBloks() requires a "type"');
-		}
-		this._submessages.push({ messageType: 2, messageText: 'Bloks' });
-		const primitive = {
-			type: data.type,
-			data: data.data ?? '{}',
-			uuid: data.uuid ?? '',
-			versioning_id: data.versioning_id ?? '',
-			__typename: 'FOABloksPrimitive',
-		};
-		// 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;
-	}
-
-	/** Add tappable follow-up suggestion chips below the message. @param {string|string[]} suggestion */
-	addSuggest(suggestion, { scroll = true, layout } = {}) {
-		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');
-		}
-
-		const suggest = Array.isArray(suggestion)
-			? suggestion.map((text) => ({
-					prompt_text: text,
-					prompt_type: 'SUGGESTED_PROMPT',
-					__typename: 'GenAIFollowUpSuggestionPillPrimitive',
-				}))
-			: [
-					{
-						prompt_text: suggestion,
-						prompt_type: 'SUGGESTED_PROMPT',
-						__typename: 'GenAIFollowUpSuggestionPillPrimitive',
-					},
-				];
-
-		const type = layout ?? (suggest.length === 1 ? 'Single' : scroll ? 'HScroll' : 'ActionRow');
-
-		this._sections.push(AIRich.newLayout(type, type === 'Single' ? suggest[0] : suggest, { __typename: 'GenAIUnifiedResponseSection' }));
-
-		return this;
-	}
-
-	/** @returns {Promise<Record<string, any>>} The generated AI-rich message content (without wrapping/sending it). */
-	async build({ forwarded = true, notification = false, includesUnifiedResponse = true, includesSubmessages = true, quoted, quotedParticipant, ...options } = {}) {
-		const forward = forwarded
-			? {
-					forwardingScore: 1,
-					isForwarded: true,
-					forwardedAiBotMessageInfo: { botJid: '0@bot' },
-					forwardOrigin: 4,
-				}
-			: {};
-
-		const notif = notification
-			? {
-					sessionTransparencyMetadata: {
-						disclaimerText: '~ Ahmad tumbuh kembang',
-						hcaId: `hca_${Date.now()}`,
-						sessionTransparencyType: 1,
-					},
-				}
-			: {};
-
-		const qObj = quoted
-			? {
-					stanzaId: quoted?.key?.id || quoted?.id,
-					participant: quotedParticipant || quoted?.key?.participant || quoted?.key?.remoteJid,
-					quotedType: 0,
-					quotedMessage: typeof quoted === 'object' && quoted !== null ? (quoted.message ?? quoted) : undefined,
-				}
-			: {};
-
-		const sections = this._footer
-			? [
-					...(await waitAllPromises(this._sections)),
-					AIRich.newLayout('Single', {
-						text: this._footer,
-						__typename: 'GenAIMetadataTextPrimitive',
-					}),
-				]
-			: [...(await waitAllPromises(this._sections))];
-
-		// Vanz@Merge 15-08-26 --- Neither blurose nor arslan sign the bot metadata with
-		// verificationMetadata (proofs/certificateChain). Backported from this project's own
-		// rich-message-utils.js botMetadataSignature/botMetadataCertificate helpers, plus a
-		// botResponseId tying the signed metadata to unifiedResponse.response_id.
-		// Vanz@Fix 24-08-26 --- was `const responseId = crypto.randomUUID()` shared for BOTH
-		// unifiedResponse.response_id and botMetadata.botResponseId, generated fresh every build()
-		// with no override. Now each has its own id, pinned via setResponseId()/setBotResponseId()
-		// if the caller set one (for sendEdit()-style in-place message updates), otherwise still
-		// defaults to a fresh randomUUID() per build() exactly like before.
-		const responseId = this._responseId ?? crypto.randomUUID();
-		const botResponseId = this._botResponseId ?? crypto.randomUUID();
-
-		return {
-			messageContextInfo: {
-				deviceListMetadata: {},
-				deviceListMetadataVersion: 2,
-				botMetadata: {
-					messageDisclaimerText: this._title,
-					richResponseSourcesMetadata: { sources: this._richResponseSources },
-					botResponseId: botResponseId,
-					verificationMetadata: {
-						proofs: [
-							{
-								certificateChain: [botMetadataCertificate(), botMetadataCertificate(892)],
-								version: 1,
-								useCase: 1,
-								signature: botMetadataSignature(),
-							},
-						],
-					},
-					...notif,
-				},
-			},
-			...this._extraPayload,
-			botForwardedMessage: {
-				message: {
-					richResponseMessage: {
-						messageType: 1,
-						submessages: includesSubmessages ? await waitAllPromises(this._submessages) : [],
-						unifiedResponse: {
-							data: includesUnifiedResponse ? Buffer.from(JSON.stringify({ response_id: responseId, sections })).toString('base64') : '',
-						},
-						contextInfo: {
-							...forward,
-							...qObj,
-							...this._contextInfo,
-						},
-					},
-				},
-			},
-		};
-	}
-
-	// 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.
-	/** Build and send this AI-rich message. @param {string} jid Destination chat/group jid. @param {boolean} [skipImageFallback] Skip auto-resending inline images as a plain imageMessage. */
-	async send(jid, { forwarded, notification, includesUnifiedResponse, includesSubmessages, skipImageFallback = false, quoted, messageId, ...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');
-				}
-			}
-		}
-
-		// Vanz@Add --- pin our own messageId (instead of letting relayMessage mint one internally)
-		// so we know exactly which id was sent, and stash it as _lastMessageKey. That's what lets
-		// sendEdit() be called with no args afterwards and still know which message to patch.
-		messageId = messageId || generateMessageIDV2();
-
-		await this.#client.relayMessage(jid, msg, { messageId, ...options });
-
-		this._lastMessageKey = { remoteJid: jid, fromMe: true, id: messageId };
-
-		return { key: this._lastMessageKey, message: msg };
-	}
-
-	/**
-	 * Build a `protocolMessage` (type EDIT) that patches an already-sent AIRich message in place.
-	 * @param {string} targetJid Chat the original message lives in.
-	 * @param {string} targetId `key.id` of the original message (the id `send()`/`sendEdit()` returned).
-	 * @param {object} [opts] Pass `{ msg }` to reuse an already-built content object instead of rebuilding via build().
-	 */
-	async buildEdit(targetJid, targetId, { msg, messageId, ...options } = {}) {
-		const editedMessage = msg || (await this.build({ ...options }));
-
-		if (!editedMessage) {
-			throw new Error('buildEdit: no message content to edit (build() returned nothing)');
-		}
-
-		return generateWAMessageFromContent(
-			targetJid,
-			{
-				protocolMessage: {
-					key: {
-						remoteJid: targetJid,
-						fromMe: true,
-						id: targetId,
-					},
-					type: 14, // MESSAGE_EDIT
-					editedMessage,
-				},
-			},
-			{ messageId: messageId || generateMessageIDV2(), ...options }
-		);
-	}
-
-	/**
-	 * Rebuild this AIRich message's current content and patch it into an already-sent message in place
-	 * (WA edits the bubble instead of showing a new one). With no args, edits the message from the last
-	 * send()/sendEdit() call — that's the flow `.addX(...); await rich.sendEdit();` relies on.
-	 * @param {string} [jid] Defaults to the jid from the last send()/sendEdit().
-	 * @param {string} [id] Defaults to the message id from the last send()/sendEdit().
-	 */
-	async sendEdit(jid, id, { msg, messageId, additionalNodes = [], ...options } = {}) {
-		jid = jid ?? this._lastMessageKey?.remoteJid;
-		id = id ?? this._lastMessageKey?.id;
-
-		if (!jid) {
-			throw new Error('sendEdit: no jid — pass one explicitly, or call send() first');
-		}
-
-		if (!id) {
-			throw new Error('sendEdit: no message id — pass one explicitly, or call send() first');
-		}
-
-		const msgEdit = await this.buildEdit(jid, id, {
-			msg,
-			messageId: messageId || generateMessageIDV2(),
-			...options,
-		});
-
-		await this.#client.relayMessage(jid, msgEdit.message, {
-			messageId: msgEdit.key.id,
-			additionalNodes,
-		});
-
-		// Vanz@Note --- deliberately NOT overwriting _lastMessageKey with msgEdit.key here: the
-		// protocolMessage envelope has its own id, but the message the user actually sees (and the
-		// one future sendEdit() calls need to keep patching) is still `id`/`jid` above.
-		return msgEdit;
-	}
-
-	/** Tokenize `code` into `{ type, value }` spans for syntax highlighting. Covers JS/TS/Python/Java and more; unsupported languages fall back to a single plain-text token. */
-	static tokenizer(code, lang = 'javascript') {
-		const keywordsMap = {
-			javascript: new Set([
-				'break',
-				'case',
-				'catch',
-				'continue',
-				'debugger',
-				'delete',
-				'do',
-				'else',
-				'finally',
-				'for',
-				'function',
-				'if',
-				'in',
-				'instanceof',
-				'new',
-				'return',
-				'switch',
-				'this',
-				'throw',
-				'try',
-				'typeof',
-				'var',
-				'void',
-				'while',
-				'with',
-				'true',
-				'false',
-				'null',
-				'undefined',
-				'class',
-				'const',
-				'let',
-				'super',
-				'extends',
-				'export',
-				'import',
-				'yield',
-				'static',
-				'constructor',
-				'async',
-				'await',
-				'get',
-				'set',
-			]),
-
-			typescript: new Set([
-				'abstract',
-				'any',
-				'as',
-				'asserts',
-				'bigint',
-				'boolean',
-				'declare',
-				'enum',
-				'implements',
-				'infer',
-				'interface',
-				'is',
-				'keyof',
-				'module',
-				'namespace',
-				'never',
-				'readonly',
-				'require',
-				'number',
-				'object',
-				'override',
-				'private',
-				'protected',
-				'public',
-				'satisfies',
-				'string',
-				'symbol',
-				'type',
-				'unknown',
-				'using',
-				'from',
-				'break',
-				'case',
-				'catch',
-				'continue',
-				'do',
-				'else',
-				'finally',
-				'for',
-				'function',
-				'if',
-				'new',
-				'return',
-				'switch',
-				'this',
-				'throw',
-				'try',
-				'var',
-				'void',
-				'while',
-				'class',
-				'const',
-				'let',
-				'extends',
-				'import',
-				'export',
-				'async',
-				'await',
-			]),
-
-			python: new Set([
-				'False',
-				'None',
-				'True',
-				'and',
-				'as',
-				'assert',
-				'async',
-				'await',
-				'break',
-				'class',
-				'continue',
-				'def',
-				'del',
-				'elif',
-				'else',
-				'except',
-				'finally',
-				'for',
-				'from',
-				'global',
-				'if',
-				'import',
-				'in',
-				'is',
-				'lambda',
-				'nonlocal',
-				'not',
-				'or',
-				'pass',
-				'raise',
-				'return',
-				'try',
-				'while',
-				'with',
-				'yield',
-			]),
-
-			java: new Set([
-				'abstract',
-				'assert',
-				'boolean',
-				'break',
-				'byte',
-				'case',
-				'catch',
-				'char',
-				'class',
-				'const',
-				'continue',
-				'default',
-				'do',
-				'double',
-				'else',
-				'enum',
-				'extends',
-				'final',
-				'finally',
-				'float',
-				'for',
-				'goto',
-				'if',
-				'implements',
-				'import',
-				'instanceof',
-				'int',
-				'interface',
-				'long',
-				'native',
-				'new',
-				'package',
-				'private',
-				'protected',
-				'public',
-				'return',
-				'short',
-				'static',
-				'strictfp',
-				'super',
-				'switch',
-				'synchronized',
-				'this',
-				'throw',
-				'throws',
-				'transient',
-				'try',
-				'void',
-				'volatile',
-				'while',
-			]),
-
-			golang: new Set([
-				'break',
-				'case',
-				'chan',
-				'const',
-				'continue',
-				'default',
-				'defer',
-				'else',
-				'fallthrough',
-				'for',
-				'func',
-				'go',
-				'goto',
-				'if',
-				'import',
-				'interface',
-				'map',
-				'package',
-				'range',
-				'return',
-				'select',
-				'struct',
-				'switch',
-				'type',
-				'var',
-			]),
-
-			c: new Set([
-				'auto',
-				'break',
-				'case',
-				'char',
-				'const',
-				'continue',
-				'default',
-				'do',
-				'double',
-				'else',
-				'enum',
-				'extern',
-				'float',
-				'for',
-				'goto',
-				'if',
-				'int',
-				'long',
-				'register',
-				'return',
-				'short',
-				'signed',
-				'sizeof',
-				'static',
-				'struct',
-				'switch',
-				'typedef',
-				'union',
-				'unsigned',
-				'void',
-				'volatile',
-				'while',
-			]),
-
-			cpp: new Set([
-				'alignas',
-				'alignof',
-				'and',
-				'auto',
-				'bool',
-				'break',
-				'case',
-				'catch',
-				'class',
-				'const',
-				'constexpr',
-				'continue',
-				'delete',
-				'do',
-				'double',
-				'else',
-				'enum',
-				'explicit',
-				'export',
-				'extern',
-				'false',
-				'float',
-				'for',
-				'friend',
-				'if',
-				'inline',
-				'int',
-				'long',
-				'mutable',
-				'namespace',
-				'new',
-				'noexcept',
-				'nullptr',
-				'operator',
-				'private',
-				'protected',
-				'public',
-				'return',
-				'short',
-				'signed',
-				'sizeof',
-				'static',
-				'struct',
-				'switch',
-				'template',
-				'this',
-				'throw',
-				'true',
-				'try',
-				'typedef',
-				'typename',
-				'union',
-				'unsigned',
-				'using',
-				'virtual',
-				'void',
-				'while',
-			]),
-
-			php: new Set([
-				'abstract',
-				'and',
-				'array',
-				'as',
-				'break',
-				'callable',
-				'case',
-				'catch',
-				'class',
-				'clone',
-				'const',
-				'continue',
-				'declare',
-				'default',
-				'do',
-				'echo',
-				'else',
-				'elseif',
-				'empty',
-				'enddeclare',
-				'endfor',
-				'endforeach',
-				'endif',
-				'endswitch',
-				'endwhile',
-				'extends',
-				'final',
-				'finally',
-				'fn',
-				'for',
-				'foreach',
-				'function',
-				'global',
-				'goto',
-				'if',
-				'implements',
-				'include',
-				'include_once',
-				'instanceof',
-				'interface',
-				'match',
-				'namespace',
-				'new',
-				'null',
-				'or',
-				'private',
-				'protected',
-				'public',
-				'require',
-				'require_once',
-				'return',
-				'static',
-				'switch',
-				'throw',
-				'trait',
-				'try',
-				'use',
-				'var',
-				'while',
-				'yield',
-			]),
-
-			rust: new Set([
-				'as',
-				'break',
-				'const',
-				'continue',
-				'crate',
-				'else',
-				'enum',
-				'extern',
-				'false',
-				'fn',
-				'for',
-				'if',
-				'impl',
-				'in',
-				'let',
-				'loop',
-				'match',
-				'mod',
-				'move',
-				'mut',
-				'pub',
-				'ref',
-				'return',
-				'self',
-				'Self',
-				'static',
-				'struct',
-				'super',
-				'trait',
-				'true',
-				'type',
-				'unsafe',
-				'use',
-				'where',
-				'while',
-			]),
-
-			html: new Set([
-				'html',
-				'head',
-				'body',
-				'div',
-				'span',
-				'p',
-				'a',
-				'img',
-				'video',
-				'audio',
-				'script',
-				'style',
-				'link',
-				'meta',
-				'form',
-				'input',
-				'button',
-				'table',
-				'tr',
-				'td',
-				'th',
-				'ul',
-				'ol',
-				'li',
-				'section',
-				'article',
-				'header',
-				'footer',
-				'nav',
-				'main',
-			]),
-
-			bash: new Set([
-				'if',
-				'then',
-				'else',
-				'elif',
-				'fi',
-				'for',
-				'while',
-				'do',
-				'done',
-				'case',
-				'esac',
-				'function',
-				'in',
-				'select',
-				'until',
-				'break',
-				'continue',
-				'return',
-				'export',
-				'readonly',
-				'local',
-				'declare',
-			]),
-
-			markdown: new Set(['#', '##', '###', '####', '#####', '######']),
-		};
-
-		if (!lang || lang === 'txt' || lang === 'text' || lang === 'plaintext') {
-			return {
-				codeBlock: [
-					{
-						codeContent: code,
-						highlightType: 0,
-					},
-				],
-				unified_codeBlock: [
-					{
-						content: code,
-						type: 'DEFAULT',
-					},
-				],
-			};
-		}
-
-		const TYPE_MAP = {
-			0: 'DEFAULT',
-			1: 'KEYWORD',
-			2: 'METHOD',
-			3: 'STR',
-			4: 'NUMBER',
-			5: 'COMMENT',
-		};
-
-		const keywords = keywordsMap[lang.toLowerCase()] || new Set();
-		const tokens = [];
-
-		let i = 0;
-
-		const push = (content, type) => {
-			if (!content) return;
-
-			const last = tokens[tokens.length - 1];
-
-			if (last && last.highlightType === type) {
-				last.codeContent += content;
-			} else {
-				tokens.push({
-					codeContent: content,
-					highlightType: type,
-				});
-			}
-		};
-
-		const isIdentifier = (char) => {
-			switch (lang.toLowerCase()) {
-				case 'css':
-					return /[a-zA-Z0-9_$-]/.test(char);
-
-				case 'html':
-					return /[a-zA-Z0-9_$:-]/.test(char);
-
-				default:
-					return /[a-zA-Z0-9_$]/.test(char);
-			}
-		};
-
-		while (i < code.length) {
-			const c = code[i];
-
-			if (/\s/.test(c)) {
-				let s = i;
-
-				while (i < code.length && /\s/.test(code[i])) {
-					i++;
-				}
-
-				push(code.slice(s, i), 0);
-				continue;
-			}
-
-			if ((c === '/' && code[i + 1] === '/') || (c === '#' && ['python', 'bash'].includes(lang))) {
-				let s = i;
-
-				while (i < code.length && code[i] !== '\n') {
-					i++;
-				}
-
-				push(code.slice(s, i), 5);
-				continue;
-			}
-
-			if (c === '"' || c === "'" || c === '`') {
-				let s = i;
-				const q = c;
-
-				i++;
-
-				while (i < code.length) {
-					if (code[i] === '\\' && i + 1 < code.length) {
-						i += 2;
-					} else if (code[i] === q) {
-						i++;
-						break;
-					} else {
-						i++;
-					}
-				}
-
-				push(code.slice(s, i), 3);
-				continue;
-			}
-
-			if (/[0-9]/.test(c)) {
-				let s = i;
-
-				while (i < code.length && /[0-9._]/.test(code[i])) {
-					i++;
-				}
-
-				push(code.slice(s, i), 4);
-				continue;
-			}
-
-			if (/[a-zA-Z_$]/.test(c)) {
-				let s = i;
-
-				while (i < code.length && isIdentifier(code[i])) {
-					i++;
-				}
-
-				const word = code.slice(s, i);
-
-				let type = 0;
-
-				if (keywords.has(word)) {
-					type = 1;
-				} else if (lang === 'css') {
-					let j = i;
-
-					while (j < code.length && /\s/.test(code[j])) {
-						j++;
-					}
-
-					if (code[j] === ':') {
-						type = 1;
-					}
-				} else if (lang === 'html') {
-					let p = s - 1;
-
-					while (p >= 0 && /\s/.test(code[p])) {
-						p--;
-					}
-
-					if (code[p] === '<' || (code[p] === '/' && code[p - 1] === '<')) {
-						type = 1;
-					}
-				}
-
-				if (type === 0) {
-					let j = i;
-
-					while (j < code.length && /\s/.test(code[j])) {
-						j++;
-					}
-
-					if (code[j] === '(') {
-						type = 2;
-					}
-				}
-
-				push(word, type);
-				continue;
-			}
-
-			push(c, 0);
-			i++;
-		}
-
-		return {
-			codeBlock: tokens,
-			unified_codeBlock: tokens.map((t) => ({
-				content: t.codeContent,
-				type: TYPE_MAP[t.highlightType],
-			})),
-		};
-	}
-
-	/** Convert a raw `string[][]` grid into the table metadata shape addTable()/addText() produce internally. */
-	static toTableMetadata(arr, { hyperlink = true, citation = true, latex = true } = {}) {
-		if (!Array.isArray(arr) || !arr.every((row) => Array.isArray(row) && row.every((cell) => typeof cell === 'string'))) {
-			throw new TypeError('Table must be a nested array of strings');
-		}
-
-		const [header, ...rows] = arr;
-
-		const maxLen = Math.max(header.length, ...rows.map((r) => r.length));
-
-		const normalize = (r) => [...r, ...Array(maxLen - r.length).fill('')];
-
-		const unified_rows = [
-			{
-				is_header: true,
-				cells: normalize(header),
-			},
-			...rows.map((r) => ({
-				is_header: false,
-				cells: normalize(r),
-			})),
-		].map((row) => {
-			const markdown_cells = row.cells.map((cell) => {
-				const extracted = extractIE(cell, { hyperlink, citation, latex });
-
-				return {
-					text: extracted.text,
-					...(extracted.inline_entities.length ? { inline_entities: extracted.inline_entities } : {}),
-				};
-			});
-
-			return {
-				...row,
-				...(markdown_cells.some((c) => c.inline_entities?.length) ? { markdown_cells } : {}),
-			};
-		});
-
-		const rowsMeta = unified_rows.map((r) => ({
-			items: r.cells,
-			...(r.is_header ? { isHeading: true } : {}),
-		}));
-
-		return {
-			title: '',
-			rows: rowsMeta,
-			unified_rows,
-		};
-	}
-
-	/**
-	 * 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, textFallback = true } = {}) {
-		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',
-			})
-		);
-		// Vanz@Fix 23-08-26 (v4.8) --- media.url kosong + status GENERATING gak punya renderer
-		// visual instan di stock WA client; sebelumnya cuma diem sampe WA nge-timeout sendiri
-		// dan nampilin fallback bawaannya ("Saat ini, saya tidak bisa membuat gambar itu...").
-		// Same fix class kayak addTask/addBloks: append FOATextPrimitive biar ada fallback
-		// instan, gak perlu nunggu timeout WA. Set { textFallback: false } buat skip.
-		if (textFallback) {
-			this._sections.push(AIRich.newLayout('Single', { text: '[ Sedang diproses... ]', __typename: 'FOATextPrimitive' }));
-		}
-		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 {
-			...extra,
-			view_model: {
-				[Array.isArray(data) ? 'primitives' : 'primitive']: data,
-				__typename: `GenAI${name}LayoutViewModel`,
-			},
-		};
-	}
-}
-
-/** Thin no-op subclass of `AIRich` — kept for drop-in compatibility with code ported from ourin-baileys that references `ORich` by name. */
-class ORich extends AIRich {}
-
-// Vanz@Alias --- AIRich diekspos ulang pake nama sendiri. Implementasi & referensi
-// internal (AIRich.newLayout/tokenizer/toTableMetadata) TETAP pake nama class asli
-// biar nggak perlu rewrite ratusan pemanggilan; ini cuma nge-alias binding exportnya.
-// Attribution buat base implementation tetep di NOTICE.md, gak kehapus cuma gara-gara
-// alias nama di sini.
-export {
-	MESSAGE_BUILDER_VERSION,
-	Button,
-	ButtonV2,
-	ButtonV3,
-	RowBuilder,
-	CardBuilder,
-	Carousel,
-	Poll,
-	AIRich,
-	ORich,
-	AIRich as AIVanzxy,
-	AIRich as LeafRich,
-	AIRich as VanzxyAI,
-	AIRich as VanzxyRich,
-	Toolkit,
-};
+// Compatibility shim: legacy relative imports continue to work.
+export * from '../Builders/index.js';