@japofc/baileys 2.1.0

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 `AIJap` / `LeafRich` / `JapAI` / `JapRich` (identical class, alternate names).
+ */
+export { Poll };

package/lib/Builders/index.d.ts

@@ -0,0 +1,17 @@
+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 { AIRich, ORich } from './AIRich.js';
+export { A2UI, sendA2UIWidget } from './A2UI.js';
+export { AIRich as AIJap, AIRich as LeafRich, AIRich as JapAI, AIRich as JapRich, AIRich as RichJap } from './AIRich.js';
+export declare const MESSAGE_BUILDER_VERSION: string;
+export { JapBaileys } from './JapBaileys.js';
+export type { LimitedTimeOfferParams, BottomSheetParams, TapTargetConfigurationParams, BloksWidgetOptions } from './Button.js';
+export type { ButtonV2BuildOptions } from './ButtonV2.js';
+export type { AddTextOptions, AddInlineImageOptions, AIRichBuildOptions, AIRichSendOptions, AIRichEditOptions } from './AIRich.js';
+export type { BloksRef, BloksNodeBase, ColumnRowNode, TextNode, IconNode, DividerNode, ImageNode, VideoNode, ListNode, TextFieldNode, DateTimeInputNode, SliderNode, SwitchNode, CheckBoxNode, ChoicePickerNode, BloksButtonNode, ModalNode, TabsNode, CardNode, ProgressBarNode, AvatarNode, BadgeNode, SpacerNode, AudioPlayerNode, AnyBloksNode, BloksNode, A2UIBuilderOptions, A2UIBuildOptions, A2UIBuildResult, ListCardOptions, SendA2UIWidgetOptions } from './A2UI.js';
+export type { CarouselCard } from './Carousel.js';
+export type { ExtractIEOptions, FetchBufferOptions, ResolveMediaOptions, Mp4PreviewOptions } from './shared.js';

package/lib/Builders/index.js

@@ -0,0 +1,11 @@
+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 { AIRich, ORich } from './AIRich.js';
+export { A2UI, sendA2UIWidget } from './A2UI.js';
+export { AIRich as AIJap, AIRich as LeafRich, AIRich as JapAI, AIRich as JapRich, AIRich as RichJap } from './AIRich.js';
+export const MESSAGE_BUILDER_VERSION = '4.8';
+export { JapBaileys } from './JapBaileys.js';

package/lib/Builders/shared.d.ts

@@ -0,0 +1,67 @@
+export { generateWAMessageFromContent, prepareWAMessageMedia } from '../Utils/messages.js';
+export { generateMessageIDV2 } from '../Utils/generics.js';
+export { botMetadataSignature, botMetadataCertificate } from '../Utils/rich-message-utils.js';
+export { getBizBinaryNode } from '../WABinary/index.js';
+export { PassThrough, Readable } from 'stream';
+export declare const crypto: typeof import('crypto');
+
+export interface ExtractIEOptions {
+    extract?: boolean;
+    hyperlink?: boolean;
+    citation?: boolean;
+    latex?: boolean;
+}
+
+export interface FetchBufferOptions {
+    silent?: boolean;
+    timeout?: number;
+}
+
+export interface ResolveMediaOptions {
+    resolveUrl?: boolean;
+    resolveWAUrl?: boolean;
+    result?: string;
+    resize?: boolean;
+    width?: number;
+    height?: number;
+}
+
+export interface Mp4PreviewOptions {
+    time?: number;
+    result?: 'buffer' | string;
+    resize?: boolean;
+    width?: number;
+    height?: number;
+    silent?: boolean;
+}
+
+export declare const extractIE: (text: string, options?: ExtractIEOptions) => Record<string, any>;
+export declare const waitAllPromises: (input: any) => Promise<any>;
+export declare const getSharp: () => Promise<any>;
+export declare const getFfmpeg: () => Promise<any>;
+
+export class Toolkit {
+    static extractIE(text: string, options?: ExtractIEOptions): Record<string, any>;
+    static resize(buffer: Buffer, x: number, y: number, fit?: string): Promise<Buffer>;
+    static waitAllPromises(input: any): Promise<any>;
+    static fetchBuffer(url: string, options?: Record<string, any>, opts?: FetchBufferOptions): Promise<Buffer>;
+    static toUrl(client: any, path: string | Buffer, mediaType?: string): Promise<string>;
+    static resolveMedia(client: any, media: any, mediaType?: string, options?: ResolveMediaOptions): Promise<any>;
+    static getMp4Duration(buffer: Buffer, options?: { silent?: boolean }): number;
+    static getMp4Preview(videoBuffer: Buffer, options?: Mp4PreviewOptions): Promise<Buffer | Record<string, any>>;
+}
+
+export abstract class BaseBuilder {
+    setTitle(title: string): this;
+    setSubtitle(subtitle: string): this;
+    setBody(body: string): this;
+    setFooter(footer: string): this;
+    setContextInfo(obj: Record<string, any>): this;
+    addPayload(obj: Record<string, any>): this;
+}
+
+export class RowBuilder {
+    constructor();
+    buttons: Record<string, any>[];
+    button(displayText: string, buttonId?: string): this;
+}