@vanzxy/baileys 2.0.0 → 2.0.2

package/lib/Builders/NativeFlow.js

@@ -0,0 +1,210 @@
+import { BaseBuilder, generateWAMessageFromContent, prepareWAMessageMedia, generateMessageIDV2, crypto } from './shared.js';
+
+/**
+ * Interactive/nativeFlow message builder — the modern replacement for the legacy
+ * hydrated-template buttons in `ButtonV3`. Produces the `interactiveMessage` shape
+ * (`cta_url`, `cta_copy`, `cta_call`, `quick_reply`, `single_select`) that
+ * `generateWAMessageContent` already understands via the `message.nativeFlow`
+ * shorthand (see Utils/messages.js, `hasNonNullishProperty(message, 'nativeFlow')`).
+ */
+class NativeFlow 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._buttons = [];
+		this._text;
+		this._caption;
+		this._title;
+		this._subtitle;
+		this._footer;
+		this._audioFooter;
+		this._thumbnail;
+		this._media;
+		this._offer;
+		this._optionTitle;
+		this._optionText;
+		this._bizJid;
+		this._shopSurface;
+	}
+
+	/** Plain text body (no header). Mutually exclusive with `setCaption()`. */
+	setText(text) {
+		if (typeof text !== 'string' || !text) throw new TypeError('setText(text) requires a non-empty string');
+		this._text = text;
+		return this;
+	}
+
+	/** Body text shown together with a media/title header — pair with `setHeader()` and/or `setImage()/setVideo()/setDocument()`. */
+	setCaption(caption) {
+		if (typeof caption !== 'string' || !caption) throw new TypeError('setCaption(caption) requires a non-empty string');
+		this._caption = caption;
+		return this;
+	}
+
+	/** Header title/subtitle shown above the caption. Requires a media header (see `setImage()` etc.) or leave media unset for a text-only header. */
+	setHeader(title = '', subtitle = '') {
+		this._title = title;
+		this._subtitle = subtitle;
+		return this;
+	}
+
+	/** Footer text under the buttons. Mutually exclusive with `setAudioFooter()`. */
+	setFooter(text) {
+		this._footer = text;
+		return this;
+	}
+
+	/** Voice-note footer instead of text. @param {string|Buffer} path Url or buffer. */
+	setAudioFooter(path) {
+		if (!path) throw new Error('Url or buffer needed');
+		this._audioFooter = path;
+		return this;
+	}
+
+	/** Raw jpeg thumbnail bytes for the header (used when the header media itself isn't re-uploaded). */
+	setThumbnail(buffer) {
+		this._thumbnail = buffer;
+		return this;
+	}
+
+	/** Attach an image as the header. @param {string|Buffer} path Url or buffer. */
+	setImage(path, options = {}) {
+		if (!path) throw new Error('Url or buffer needed');
+		this._media = Buffer.isBuffer(path) ? { image: path, ...options } : { image: { url: path }, ...options };
+		return this;
+	}
+
+	/** Attach a video as the header. @param {string|Buffer} path Url or buffer. */
+	setVideo(path, options = {}) {
+		if (!path) throw new Error('Url or buffer needed');
+		this._media = Buffer.isBuffer(path) ? { video: path, ...options } : { video: { url: path }, ...options };
+		return this;
+	}
+
+	/** Attach a document as the header. @param {string|Buffer} path Url or buffer. */
+	setDocument(path, options = {}) {
+		if (!path) throw new Error('Url or buffer needed');
+		this._media = Buffer.isBuffer(path) ? { document: path, ...options } : { document: { url: path }, ...options };
+		return this;
+	}
+
+	/** Set a raw pre-built header media object (bypasses setImage/setVideo/setDocument shorthands). */
+	setMedia(obj) {
+		if (typeof obj !== 'object' || obj === null || Array.isArray(obj)) throw new TypeError('Media must be a plain object');
+		this._media = obj;
+		return this;
+	}
+
+	/** Remove every button added so far (keeps text/header/footer/media). */
+	clearButtons() {
+		this._buttons = [];
+		return this;
+	}
+
+	/** `quick_reply` button — fires a regular button-response callback. */
+	addQuickReply(displayText, id = crypto.randomUUID(), { icon } = {}) {
+		if (typeof displayText !== 'string' || !displayText) throw new TypeError('addQuickReply(displayText, id) requires a non-empty displayText');
+		this._buttons.push({ text: displayText, id, icon });
+		return this;
+	}
+
+	/** `cta_url` button — opens a link, optionally inside WhatsApp's in-app webview. */
+	addUrl(displayText, url, { useWebview = false, icon } = {}) {
+		if (typeof url !== 'string' || !url) throw new TypeError('addUrl(displayText, url) requires a non-empty url');
+		this._buttons.push({ text: displayText, url, useWebview, icon });
+		return this;
+	}
+
+	/** `cta_copy` button — copies text/code to the recipient's clipboard. */
+	addCopy(displayText, copyCode, { icon } = {}) {
+		if (typeof copyCode !== 'string' || !copyCode) throw new TypeError('addCopy(displayText, copyCode) requires a non-empty copyCode');
+		this._buttons.push({ text: displayText, copy: copyCode, icon });
+		return this;
+	}
+
+	/** `cta_call` button — dials a phone number. */
+	addCall(displayText, phoneNumber, { icon } = {}) {
+		if (typeof phoneNumber !== 'string' || !phoneNumber) throw new TypeError('addCall(displayText, phoneNumber) requires a non-empty phoneNumber');
+		this._buttons.push({ text: displayText, call: phoneNumber, icon });
+		return this;
+	}
+
+	/**
+	 * `single_select` button — opens a list picker.
+	 * @param {string} title Text shown on the button that opens the list.
+	 * @param {{title: string, rows: {title: string, description?: string, id: string}[]}[]} sections
+	 */
+	addSingleSelect(title, sections) {
+		if (typeof title !== 'string' || !title) throw new TypeError('addSingleSelect(title, sections) requires a non-empty title');
+		if (!Array.isArray(sections) || !sections.length) throw new TypeError('addSingleSelect(title, sections) requires a non-empty sections array');
+		this._buttons.push({ text: title, sections });
+		return this;
+	}
+
+	/** Append a raw pre-built button object (bypasses the add*() shorthands). */
+	addRawButton(obj) {
+		if (typeof obj !== 'object' || obj === null) throw new TypeError('addRawButton(obj) requires a plain object');
+		this._buttons.push(obj);
+		return this;
+	}
+
+	/** Attach the "limited time offer" banner above the buttons. */
+	setOffer({ text, url, code, expiration } = {}) {
+		this._offer = { text, url, code, expiration };
+		return this;
+	}
+
+	/** Collapse buttons beyond the in-thread limit into a "..." bottom-sheet menu. */
+	setOptionsMenu(buttonText, title = '📄 Select Options') {
+		if (typeof buttonText !== 'string' || !buttonText) throw new TypeError('setOptionsMenu(buttonText) requires a non-empty string');
+		this._optionText = buttonText;
+		this._optionTitle = title;
+		return this;
+	}
+
+	/** Mark this as a catalog/collection-backed message tied to a business JID. */
+	setBizJid(jid) {
+		this._bizJid = jid;
+		return this;
+	}
+
+	/** Mark this as a shop-storefront-backed message. */
+	setShopSurface(surface) {
+		this._shopSurface = surface;
+		return this;
+	}
+
+	/** @returns {Record<string, any>} The `sendMessage()`-shaped payload, without sending it. */
+	build() {
+		if (!this._text && !this._caption) throw new Error('NativeFlow requires setText() or setCaption()');
+		if (!this._buttons.length) throw new Error('NativeFlow requires at least one button (addUrl()/addCopy()/addCall()/addQuickReply()/addSingleSelect())');
+		if (this._caption && this._media === undefined && !this._title && !this._subtitle) {
+			throw new Error('setCaption() requires setHeader() and/or a media header (setImage()/setVideo()/setDocument())');
+		}
+
+		return {
+			...(this._media || {}),
+			...(this._text ? { text: this._text } : { caption: this._caption, title: this._title, subtitle: this._subtitle }),
+			...(this._footer !== undefined && { footer: this._footer }),
+			...(this._audioFooter !== undefined && { audioFooter: this._audioFooter }),
+			...(this._thumbnail !== undefined && { thumbnail: this._thumbnail }),
+			...(this._offer && { offerText: this._offer.text, offerUrl: this._offer.url, offerCode: this._offer.code, offerExpiration: this._offer.expiration }),
+			...(this._optionText !== undefined && { optionText: this._optionText, optionTitle: this._optionTitle }),
+			...(this._bizJid !== undefined && { bizJid: this._bizJid }),
+			...(this._shopSurface !== undefined && { shopSurface: this._shopSurface }),
+			nativeFlow: this._buttons,
+		};
+	}
+
+	/** Build and send via the socket's `sendMessage()`. */
+	async send(jid, options = {}) {
+		return this.#client.sendMessage(jid, this.build(), options);
+	}
+}
+
+export { NativeFlow };

package/lib/Builders/Poll.js

@@ -0,0 +1,128 @@
+import { BaseBuilder, generateWAMessageFromContent, prepareWAMessageMedia, generateMessageIDV2, crypto } from './shared.js';
+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).
+ */
+export { Poll };

package/lib/Builders/VanzxyBaileys.js

@@ -0,0 +1,146 @@
+import { AIRich } from './AIRich.js'
+import { Button } from './Button.js'
+import { ButtonV2 } from './ButtonV2.js'
+import { ButtonV3 } from './ButtonV3.js'
+import { Carousel } from './Carousel.js'
+import { Poll } from './Poll.js'
+import { A2UI } from './A2UI.js'
+import { NativeFlow } from './NativeFlow.js'
+import { Location } from './Location.js'
+import { Contact } from './Contact.js'
+import { Album } from './Album.js'
+
+/**
+ * VanzxyBaileys — unified builder hub.
+ *
+ * Semua builder tetap berada di class/file masing-masing.
+ * Class ini hanya menyediakan satu pintu masuk.
+ */
+class VanzxyBaileys {
+  constructor(client) {
+    if (!client) {
+      throw new TypeError(
+        'VanzxyBaileys(client) requires an active Baileys socket/client'
+      )
+    }
+
+    this.client = client
+  }
+
+  // ===== AIRICH =====
+
+  airich() {
+    return new AIRich(this.client)
+  }
+
+  vanzxyAI() {
+    return new AIRich(this.client)
+  }
+
+  aiVanzxy() {
+    return new AIRich(this.client)
+  }
+
+  leafRich() {
+    return new AIRich(this.client)
+  }
+
+  vanzxyRich() {
+    return new AIRich(this.client)
+  }
+
+  richVanzxy() {
+    return new AIRich(this.client)
+  }
+
+  // ===== BUTTON =====
+
+  button() {
+    return new Button(this.client)
+  }
+
+  buttonV2() {
+    return new ButtonV2(this.client)
+  }
+
+  buttonV3() {
+    return new ButtonV3(this.client)
+  }
+
+  // ===== CAROUSEL =====
+
+  carousel() {
+    return new Carousel(this.client)
+  }
+
+  // ===== POLL =====
+
+  poll() {
+    return new Poll(this.client)
+  }
+
+  // ===== NATIVE FLOW =====
+
+  nativeFlow() {
+    return new NativeFlow(this.client)
+  }
+
+  location() {
+    return new Location(this.client)
+  }
+
+  contact() {
+    return new Contact(this.client)
+  }
+
+  album() {
+    return new Album(this.client)
+  }
+
+  // ===== A2UI / BLOKS =====
+
+  a2ui() {
+    return new A2UI()
+  }
+
+  /**
+   * Alias PascalCase untuk developer yang suka naming class.
+   */
+  AIRich() {
+    return this.airich()
+  }
+
+  Button() {
+    return this.button()
+  }
+
+  Carousel() {
+    return this.carousel()
+  }
+
+  Poll() {
+    return this.poll()
+  }
+
+  NativeFlow() {
+    return this.nativeFlow()
+  }
+
+  Location() {
+    return this.location()
+  }
+
+  Contact() {
+    return this.contact()
+  }
+
+  Album() {
+    return this.album()
+  }
+
+  A2UI() {
+    return this.a2ui()
+  }
+}
+
+export { VanzxyBaileys }

package/lib/Builders/index.js

@@ -0,0 +1,15 @@
+export { Toolkit, BaseBuilder, RowBuilder } from './shared.js';
+export { Button, CardBuilder } from './Button.js';
+export { ButtonV2 } from './ButtonV2.js';
+export { ButtonV3 } from './ButtonV3.js';
+export { Carousel } from './Carousel.js';
+export { Poll } from './Poll.js';
+export { NativeFlow } from './NativeFlow.js';
+export { Location } from './Location.js';
+export { Contact } from './Contact.js';
+export { Album } from './Album.js';
+export { AIRich, ORich } from './AIRich.js';
+export { A2UI, sendA2UIWidget } from './A2UI.js';
+export { AIRich as AIVanzxy, AIRich as LeafRich, AIRich as VanzxyAI, AIRich as VanzxyRich, AIRich as RichVanzxy } from './AIRich.js';
+export const MESSAGE_BUILDER_VERSION = '5.0';
+export { VanzxyBaileys } from './VanzxyBaileys.js';