@queenanya/baileys 9.5.2 → 9.5.3-beta.2

package/lib/addons/jid-plotting.js

@@ -0,0 +1,150 @@
+import { jidDecode, jidNormalizedUser, isLidUser, isHostedPnUser, isHostedLidUser } from '../WABinary/index.js';
+const isPnUser = (jid) => jid?.endsWith('@s.whatsapp.net');
+export const parseJid = (jid) => {
+    if (!jid)
+        return null;
+    const decoded = jidDecode(jid);
+    if (!decoded)
+        return null;
+    return {
+        jid,
+        user: decoded.user,
+        server: decoded.server,
+        device: decoded.device || 0,
+        agent: 0,
+        isLid: !!(isLidUser(jid) || isHostedLidUser(jid)),
+        isPn: !!(isPnUser(jid) || isHostedPnUser(jid)),
+        isHosted: jid.includes('@hosted') || !!isHostedLidUser(jid) || !!isHostedPnUser(jid),
+        isGroup: jid.endsWith('@g.us'),
+        isNewsletter: jid.endsWith('@newsletter'),
+        normalizedUser: jidNormalizedUser(jid)
+    };
+};
+export const getSenderPn = (creds) => {
+    if (!creds?.me?.id)
+        return null;
+    const decoded = jidDecode(creds.me.id);
+    if (!decoded)
+        return null;
+    return {
+        phoneJid: `${decoded.user}@s.whatsapp.net`,
+        phoneNumber: decoded.user,
+        lid: creds.me.lid,
+        deviceId: decoded.device || 0,
+        pushName: creds.me.name,
+        platform: creds.platform
+    };
+};
+export const getCurrentSenderInfo = (authState) => getSenderPn(authState.creds);
+export const isSelf = (jid, senderPn) => {
+    if (!jid || !senderPn)
+        return false;
+    const normalizedJid = jidNormalizedUser(jid);
+    const normalizedSelf = jidNormalizedUser(senderPn.phoneJid);
+    if (normalizedJid === normalizedSelf)
+        return true;
+    if (senderPn.lid) {
+        const normalizedLid = jidNormalizedUser(senderPn.lid);
+        if (normalizedJid === normalizedLid)
+            return true;
+    }
+    return false;
+};
+export const plotJid = (jid) => {
+    const info = parseJid(jid);
+    if (!info)
+        return null;
+    const result = { original: jid, primary: jid, info };
+    if (info.isPn) {
+        result.pn = info.normalizedUser;
+        result.primary = info.normalizedUser;
+    }
+    else if (info.isLid) {
+        result.lid = info.normalizedUser;
+        result.primary = info.normalizedUser;
+    }
+    return result;
+};
+export const normalizePhoneToJid = (phone) => {
+    if (phone.includes('@'))
+        return jidNormalizedUser(phone);
+    return `${phone.replace(/[^\d]/g, '')}@s.whatsapp.net`;
+};
+export const extractPhoneNumber = (jid) => {
+    const info = parseJid(jid);
+    if (!info || !info.isPn)
+        return null;
+    return info.user;
+};
+export const formatJidDisplay = (jid, options) => {
+    const info = parseJid(jid);
+    if (!info)
+        return jid;
+    let display = info.user;
+    if (options?.showDevice && info.device > 0)
+        display += `:${info.device}`;
+    if (options?.showType) {
+        if (info.isLid)
+            display += ' (LID)';
+        else if (info.isGroup)
+            display += ' (Group)';
+        else if (info.isNewsletter)
+            display += ' (Newsletter)';
+        else if (info.isPn)
+            display += ' (PN)';
+    }
+    return display;
+};
+export const isSameUser = (jid1, jid2) => {
+    const i1 = parseJid(jid1), i2 = parseJid(jid2);
+    if (!i1 || !i2)
+        return false;
+    return i1.normalizedUser === i2.normalizedUser;
+};
+export const getJidVariants = (phone) => {
+    const cleaned = phone.replace(/[^\d]/g, '');
+    return [
+        `${cleaned}@s.whatsapp.net`,
+        `${cleaned}:0@s.whatsapp.net`,
+        `${cleaned}@lid`,
+        `${cleaned}:1@s.whatsapp.net`,
+        `${cleaned}:2@s.whatsapp.net`
+    ];
+};
+export const constructJidWithDevice = (user, device, server = 's.whatsapp.net') => {
+    return device === 0 ? `${user}@${server}` : `${user}:${device}@${server}`;
+};
+export const getRemoteJidFromMessage = (msg) => {
+    if (!msg?.key?.remoteJid)
+        return null;
+    const chatJid = msg.key.remoteJid;
+    const isGroupMsg = chatJid.endsWith('@g.us');
+    const senderJid = isGroupMsg ? msg.key.participant || chatJid : chatJid;
+    return { chatJid, senderJid };
+};
+export const createJidPlotter = (getLIDForPN, getPNForLID) => ({
+    plotToLid: (pn) => getLIDForPN(pn),
+    plotToPn: (lid) => getPNForLID(lid),
+    plotBidirectional: async (jid) => {
+        const info = parseJid(jid);
+        if (!info)
+            return { original: jid, primary: jid, info: null };
+        const result = { original: jid, primary: jid, info };
+        if (info.isPn) {
+            result.pn = info.normalizedUser;
+            const lid = await getLIDForPN(jid);
+            if (lid)
+                result.lid = lid;
+            result.primary = info.normalizedUser;
+        }
+        else if (info.isLid) {
+            result.lid = info.normalizedUser;
+            const pn = await getPNForLID(jid);
+            if (pn)
+                result.pn = pn;
+            result.primary = result.pn || info.normalizedUser;
+        }
+        return result;
+    }
+});
+//# sourceMappingURL=jid-plotting.js.map

package/lib/addons/jid-plotting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jid-plotting.js","sourceRoot":"","sources":["../../src/addons/jid-plotting.ts"],"names":[],"mappings":"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"}

package/lib/addons/message-search.d.ts

@@ -0,0 +1,38 @@
+import type { WAMessage } from '../Types/index.js';
+type MessageType = 'text' | 'image' | 'video' | 'document' | 'audio' | 'sticker' | 'location' | 'contact' | 'other';
+export interface SearchOptions {
+    jid?: string;
+    fromDate?: Date;
+    toDate?: Date;
+    fromSender?: string;
+    fromMe?: boolean;
+    messageTypes?: MessageType[];
+    limit?: number;
+    caseSensitive?: boolean;
+}
+export interface SearchResult {
+    message: WAMessage;
+    matchedText: string;
+    matchPosition: number;
+    relevanceScore: number;
+}
+export declare const extractMessageText: (message: WAMessage) => string;
+export declare const searchMessages: (messages: WAMessage[], query: string, options?: SearchOptions) => SearchResult[];
+export declare const searchMessagesRegex: (messages: WAMessage[], pattern: RegExp, options?: Omit<SearchOptions, "caseSensitive">) => SearchResult[];
+export declare class MessageSearchManager {
+    private messages;
+    private messageIndex;
+    addMessages(messages: WAMessage[]): void;
+    removeMessages(messageIds: string[]): void;
+    clear(): void;
+    get count(): number;
+    search(query: string, options?: SearchOptions): SearchResult[];
+    searchRegex(pattern: RegExp, options?: Omit<SearchOptions, 'caseSensitive'>): SearchResult[];
+    getByJid(jid: string): WAMessage[];
+    getBySender(sender: string): WAMessage[];
+    getByType(type: MessageType): WAMessage[];
+    getById(id: string): WAMessage | undefined;
+}
+export declare const createMessageSearch: () => MessageSearchManager;
+export {};
+//# sourceMappingURL=message-search.d.ts.map

package/lib/addons/message-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-search.d.ts","sourceRoot":"","sources":["../../src/addons/message-search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAEzC,KAAK,WAAW,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,OAAO,CAAA;AAEnH,MAAM,WAAW,aAAa;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,IAAI,CAAA;IACf,MAAM,CAAC,EAAE,IAAI,CAAA;IACb,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,YAAY,CAAC,EAAE,WAAW,EAAE,CAAA;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,aAAa,CAAC,EAAE,OAAO,CAAA;CACvB;AAED,MAAM,WAAW,YAAY;IAC5B,OAAO,EAAE,SAAS,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;IACnB,aAAa,EAAE,MAAM,CAAA;IACrB,cAAc,EAAE,MAAM,CAAA;CACtB;AAED,eAAO,MAAM,kBAAkB,GAAI,SAAS,SAAS,KAAG,MAcvD,CAAA;AAgCD,eAAO,MAAM,cAAc,GAAI,UAAU,SAAS,EAAE,EAAE,OAAO,MAAM,EAAE,UAAS,aAAkB,KAAG,YAAY,EA6B9G,CAAA;AAED,eAAO,MAAM,mBAAmB,GAC/B,UAAU,SAAS,EAAE,EACrB,SAAS,MAAM,EACf,UAAS,IAAI,CAAC,aAAa,EAAE,eAAe,CAAM,KAChD,YAAY,EAgBd,CAAA;AAED,qBAAa,oBAAoB;IAChC,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,YAAY,CAA+B;IAEnD,WAAW,CAAC,QAAQ,EAAE,SAAS,EAAE;IAUjC,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE;IAMnC,KAAK;IAIL,IAAI,KAAK,WAER;IACD,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa;IAG7C,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,eAAe,CAAC;IAG3E,QAAQ,CAAC,GAAG,EAAE,MAAM;IAGpB,WAAW,CAAC,MAAM,EAAE,MAAM;IAG1B,SAAS,CAAC,IAAI,EAAE,WAAW;IAG3B,OAAO,CAAC,EAAE,EAAE,MAAM;CAGlB;AAED,eAAO,MAAM,mBAAmB,4BAAmC,CAAA"}

package/lib/addons/message-search.js

@@ -0,0 +1,171 @@
+export const extractMessageText = (message) => {
+    const c = message.message;
+    if (!c)
+        return '';
+    if (c.conversation)
+        return c.conversation;
+    if (c.extendedTextMessage?.text)
+        return c.extendedTextMessage.text;
+    if (c.imageMessage?.caption)
+        return c.imageMessage.caption;
+    if (c.videoMessage?.caption)
+        return c.videoMessage.caption;
+    if (c.documentMessage?.caption)
+        return c.documentMessage.caption;
+    if (c.documentMessage?.fileName)
+        return c.documentMessage.fileName;
+    if (c.locationMessage?.name)
+        return c.locationMessage.name;
+    if (c.locationMessage?.address)
+        return c.locationMessage.address;
+    if (c.contactMessage?.displayName)
+        return c.contactMessage.displayName;
+    if (c.pollCreationMessage?.name)
+        return c.pollCreationMessage.name;
+    return '';
+};
+const getMessageType = (message) => {
+    const c = message.message;
+    if (!c)
+        return 'other';
+    if (c.conversation || c.extendedTextMessage)
+        return 'text';
+    if (c.imageMessage)
+        return 'image';
+    if (c.videoMessage)
+        return 'video';
+    if (c.documentMessage)
+        return 'document';
+    if (c.audioMessage)
+        return 'audio';
+    if (c.stickerMessage)
+        return 'sticker';
+    if (c.locationMessage || c.liveLocationMessage)
+        return 'location';
+    if (c.contactMessage || c.contactsArrayMessage)
+        return 'contact';
+    return 'other';
+};
+const calcRelevance = (query, text, position) => {
+    let score = 100;
+    if (text.toLowerCase() === query.toLowerCase())
+        score += 50;
+    score -= Math.min(position / 10, 20);
+    const lt = text.toLowerCase(), lq = query.toLowerCase();
+    if (position === 0 ||
+        lt[position - 1] === ' ' ||
+        lt[position + lq.length] === ' ' ||
+        position + lq.length === text.length)
+        score += 20;
+    return Math.max(score, 0);
+};
+export const searchMessages = (messages, query, options = {}) => {
+    const results = [];
+    const sq = options.caseSensitive ? query : query.toLowerCase();
+    for (const message of messages) {
+        if (options.jid && message.key.remoteJid !== options.jid)
+            continue;
+        const ts = message.messageTimestamp;
+        const mt = ts ? new Date((typeof ts === 'number' ? ts : Number(ts)) * 1000) : null;
+        if (options.fromDate && mt && mt < options.fromDate)
+            continue;
+        if (options.toDate && mt && mt > options.toDate)
+            continue;
+        if (options.fromSender && message.key.participant !== options.fromSender)
+            continue;
+        if (options.fromMe !== undefined && message.key.fromMe !== options.fromMe)
+            continue;
+        if (options.messageTypes?.length) {
+            if (!options.messageTypes.includes(getMessageType(message)))
+                continue;
+        }
+        const text = extractMessageText(message);
+        if (!text)
+            continue;
+        const st = options.caseSensitive ? text : text.toLowerCase();
+        const pos = st.indexOf(sq);
+        if (pos !== -1) {
+            results.push({
+                message,
+                matchedText: text.substring(Math.max(0, pos - 20), Math.min(text.length, pos + query.length + 20)),
+                matchPosition: pos,
+                relevanceScore: calcRelevance(query, text, pos)
+            });
+        }
+        if (options.limit && results.length >= options.limit)
+            break;
+    }
+    return results.sort((a, b) => b.relevanceScore - a.relevanceScore);
+};
+export const searchMessagesRegex = (messages, pattern, options = {}) => {
+    const results = [];
+    for (const message of messages) {
+        if (options.jid && message.key.remoteJid !== options.jid)
+            continue;
+        if (options.fromSender && message.key.participant !== options.fromSender)
+            continue;
+        if (options.fromMe !== undefined && message.key.fromMe !== options.fromMe)
+            continue;
+        if (options.messageTypes?.length) {
+            if (!options.messageTypes.includes(getMessageType(message)))
+                continue;
+        }
+        const text = extractMessageText(message);
+        if (!text)
+            continue;
+        const match = text.match(pattern);
+        if (match)
+            results.push({ message, matchedText: match[0], matchPosition: match.index ?? 0, relevanceScore: 100 });
+        if (options.limit && results.length >= options.limit)
+            break;
+    }
+    return results;
+};
+export class MessageSearchManager {
+    constructor() {
+        this.messages = [];
+        this.messageIndex = new Map();
+    }
+    addMessages(messages) {
+        for (const msg of messages) {
+            const id = msg.key.id;
+            if (id && !this.messageIndex.has(id)) {
+                this.messages.push(msg);
+                this.messageIndex.set(id, msg);
+            }
+        }
+    }
+    removeMessages(messageIds) {
+        const idSet = new Set(messageIds);
+        this.messages = this.messages.filter(m => !idSet.has(m.key.id || ''));
+        for (const id of messageIds)
+            this.messageIndex.delete(id);
+    }
+    clear() {
+        this.messages = [];
+        this.messageIndex.clear();
+    }
+    get count() {
+        return this.messages.length;
+    }
+    search(query, options) {
+        return searchMessages(this.messages, query, options);
+    }
+    searchRegex(pattern, options) {
+        return searchMessagesRegex(this.messages, pattern, options);
+    }
+    getByJid(jid) {
+        return this.messages.filter(m => m.key.remoteJid === jid);
+    }
+    getBySender(sender) {
+        return this.messages.filter(m => m.key.participant === sender || m.key.remoteJid === sender);
+    }
+    getByType(type) {
+        return this.messages.filter(m => getMessageType(m) === type);
+    }
+    getById(id) {
+        return this.messageIndex.get(id);
+    }
+}
+export const createMessageSearch = () => new MessageSearchManager();
+//# sourceMappingURL=message-search.js.map

package/lib/addons/message-search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-search.js","sourceRoot":"","sources":["../../src/addons/message-search.ts"],"names":[],"mappings":"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"}

package/lib/addons/message-utils.d.ts

@@ -0,0 +1,14 @@
+import { proto } from '../../WAProto/index.js';
+import type { BinaryNode } from '../WABinary/index.js';
+export declare function getMediaType(message: proto.IMessage): string;
+export declare function getMessageType(message: proto.IMessage): string;
+/**
+ * Detect what kind of button message this is
+ * Returns: 'list' | 'buttons' | 'native_flow' | undefined
+ */
+export declare function getButtonType(message: proto.IMessage): string | undefined;
+/**
+ * Build the <biz> binary node that WhatsApp servers require for button messages
+ */
+export declare function getButtonArgs(message: proto.IMessage): BinaryNode;
+//# sourceMappingURL=message-utils.d.ts.map

package/lib/addons/message-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-utils.d.ts","sourceRoot":"","sources":["../../src/addons/message-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAM7C,wBAAgB,YAAY,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,GAAG,MAAM,CAiB5D;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,GAAG,MAAM,CAc9D;AAID;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,GAAG,MAAM,GAAG,SAAS,CAazE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,GAAG,UAAU,CAoGjE"}

package/lib/addons/message-utils.js

@@ -0,0 +1,174 @@
+import { proto } from '../../WAProto/index.js';
+import { normalizeMessageContent } from '../Utils/messages.js';
+import { unixTimestampSeconds } from '../Utils/generics.js';
+// ── Message Type Detection ─────────────────────────────────────────────────
+export function getMediaType(message) {
+    if (message.imageMessage)
+        return 'image';
+    if (message.videoMessage)
+        return message.videoMessage.gifPlayback ? 'gif' : 'video';
+    if (message.audioMessage)
+        return message.audioMessage.ptt ? 'ptt' : 'audio';
+    if (message.contactMessage)
+        return 'vcard';
+    if (message.documentMessage)
+        return 'document';
+    if (message.contactsArrayMessage)
+        return 'contact_array';
+    if (message.liveLocationMessage)
+        return 'livelocation';
+    if (message.stickerMessage)
+        return 'sticker';
+    if (message.listMessage)
+        return 'list';
+    if (message.listResponseMessage)
+        return 'list_response';
+    if (message.buttonsResponseMessage)
+        return 'buttons_response';
+    if (message.orderMessage)
+        return 'order';
+    if (message.productMessage)
+        return 'product';
+    if (message.interactiveResponseMessage)
+        return 'native_flow_response';
+    if (message.groupInviteMessage)
+        return 'url';
+    return '';
+}
+export function getMessageType(message) {
+    const normalizedMessage = normalizeMessageContent(message);
+    if (!normalizedMessage)
+        return 'text';
+    if (normalizedMessage.reactionMessage || normalizedMessage.encReactionMessage)
+        return 'reaction';
+    if (normalizedMessage.pollCreationMessage ||
+        normalizedMessage.pollCreationMessageV2 ||
+        normalizedMessage.pollCreationMessageV3 ||
+        normalizedMessage.pollUpdateMessage)
+        return 'poll';
+    if (normalizedMessage.eventMessage)
+        return 'event';
+    if (getMediaType(normalizedMessage) !== '')
+        return 'media';
+    return 'text';
+}
+// ── Button / Biz Node Helpers ──────────────────────────────────────────────
+/**
+ * Detect what kind of button message this is
+ * Returns: 'list' | 'buttons' | 'native_flow' | undefined
+ */
+export function getButtonType(message) {
+    const inner = message.viewOnceMessageV2Extension?.message || message;
+    if (inner.listMessage)
+        return 'list';
+    if (inner.buttonsMessage)
+        return 'buttons';
+    if (inner.interactiveMessage?.nativeFlowMessage)
+        return 'native_flow';
+    if (inner.interactiveMessage?.carouselMessage)
+        return 'native_flow';
+    if (message.viewOnceMessage?.message?.interactiveMessage?.carouselMessage)
+        return 'native_flow';
+    if (message.viewOnceMessageV2?.message?.interactiveMessage?.carouselMessage)
+        return 'native_flow';
+    if (message.viewOnceMessage?.message?.interactiveMessage?.nativeFlowMessage)
+        return 'native_flow';
+    if (message.viewOnceMessageV2?.message?.interactiveMessage?.nativeFlowMessage)
+        return 'native_flow';
+    if (message.viewOnceMessageV2Extension?.message?.interactiveMessage?.nativeFlowMessage)
+        return 'native_flow';
+    if (message.viewOnceMessageV2Extension?.message?.interactiveMessage?.carouselMessage)
+        return 'native_flow';
+    return undefined;
+}
+/**
+ * Build the <biz> binary node that WhatsApp servers require for button messages
+ */
+export function getButtonArgs(message) {
+    const inner = message.viewOnceMessageV2Extension?.message || message;
+    const nativeFlow = inner.interactiveMessage?.nativeFlowMessage ||
+        message.viewOnceMessage?.message?.interactiveMessage?.nativeFlowMessage ||
+        message.viewOnceMessageV2?.message?.interactiveMessage?.nativeFlowMessage;
+    const carouselMessage = inner.interactiveMessage?.carouselMessage ||
+        message.viewOnceMessage?.message?.interactiveMessage?.carouselMessage ||
+        message.viewOnceMessageV2?.message?.interactiveMessage?.carouselMessage;
+    const firstButtonName = nativeFlow?.buttons?.[0]?.name ||
+        carouselMessage?.cards?.[0]?.nativeFlowMessage?.buttons?.[0]
+            ?.name;
+    const nativeFlowSpecials = [
+        'mpm',
+        'cta_catalog',
+        'send_location',
+        'call_permission_request',
+        'wa_payment_transaction_details',
+        'automated_greeting_message_view_catalog'
+    ];
+    const ts = unixTimestampSeconds().toString();
+    // single_select → list-style biz node
+    if (nativeFlow && firstButtonName === 'single_select') {
+        return {
+            tag: 'biz',
+            attrs: { actual_actors: '2', host_storage: '2', privacy_mode_ts: ts },
+            content: [
+                { tag: 'list', attrs: { v: '2', type: 'product_list' } },
+                { tag: 'quality_control', attrs: { source_type: 'third_party' } }
+            ]
+        };
+    }
+    // Payment flows
+    if (nativeFlow && (firstButtonName === 'review_and_pay' || firstButtonName === 'payment_info')) {
+        return {
+            tag: 'biz',
+            attrs: {
+                native_flow_name: firstButtonName === 'review_and_pay' ? 'order_details' : firstButtonName
+            }
+        };
+    }
+    // Special native flow (catalog, location, etc.)
+    if (nativeFlow && nativeFlowSpecials.includes(firstButtonName ?? '')) {
+        return {
+            tag: 'biz',
+            attrs: { actual_actors: '2', host_storage: '2', privacy_mode_ts: ts },
+            content: [
+                {
+                    tag: 'interactive',
+                    attrs: { type: 'native_flow', v: '1' },
+                    content: [{ tag: 'native_flow', attrs: { v: '2', name: firstButtonName } }]
+                },
+                { tag: 'quality_control', attrs: { source_type: 'third_party' } }
+            ]
+        };
+    }
+    // Standard interactive / buttons / carousel
+    if (nativeFlow || carouselMessage || message.buttonsMessage) {
+        return {
+            tag: 'biz',
+            attrs: { actual_actors: '2', host_storage: '2', privacy_mode_ts: ts },
+            content: [
+                {
+                    tag: 'interactive',
+                    attrs: { type: 'native_flow', v: '1' },
+                    content: [{ tag: 'native_flow', attrs: { v: '9', name: 'mixed' } }]
+                },
+                { tag: 'quality_control', attrs: { source_type: 'third_party' } }
+            ]
+        };
+    }
+    // List message
+    if (inner.listMessage) {
+        return {
+            tag: 'biz',
+            attrs: { actual_actors: '2', host_storage: '2', privacy_mode_ts: ts },
+            content: [
+                { tag: 'list', attrs: { v: '2', type: 'product_list' } },
+                { tag: 'quality_control', attrs: { source_type: 'third_party' } }
+            ]
+        };
+    }
+    // Fallback
+    return {
+        tag: 'biz',
+        attrs: { actual_actors: '2', host_storage: '2', privacy_mode_ts: ts }
+    };
+}
+//# sourceMappingURL=message-utils.js.map

package/lib/addons/message-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-utils.js","sourceRoot":"","sources":["../../src/addons/message-utils.ts"],"names":[],"mappings":"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"}

package/lib/addons/scheduling.d.ts

@@ -0,0 +1,40 @@
+import type { WAMessage } from '../Types/index.js';
+import type { AnyMessageContent } from '../Types/index.js';
+export interface SchedulerOptions {
+    maxQueue?: number;
+    checkInterval?: number;
+    onSent?: (scheduled: ScheduledMessage, message?: WAMessage) => void;
+    onFailed?: (scheduled: ScheduledMessage, error: Error) => void;
+}
+export interface ScheduledMessage {
+    id: string;
+    jid: string;
+    content: AnyMessageContent;
+    scheduledTime: Date;
+    createdAt: Date;
+    status: 'pending' | 'sent' | 'failed' | 'cancelled';
+    messageId?: string;
+    error?: string;
+}
+export declare class MessageScheduler {
+    private queue;
+    private timer;
+    private sendMessage;
+    private options;
+    constructor(sendMessage: (jid: string, content: AnyMessageContent) => Promise<WAMessage | undefined>, options?: SchedulerOptions);
+    private generateId;
+    schedule(jid: string, content: AnyMessageContent, scheduledTime: Date): ScheduledMessage;
+    scheduleDelay(jid: string, content: AnyMessageContent, delayMs: number): ScheduledMessage;
+    cancel(id: string): boolean;
+    cancelForJid(jid: string): number;
+    getPending(): ScheduledMessage[];
+    get(id: string): ScheduledMessage | undefined;
+    clearAll(): number;
+    private processQueue;
+    private ensureTimerRunning;
+    private stopTimer;
+    stop(): void;
+    start(): void;
+}
+export declare const createMessageScheduler: (sendMessage: (jid: string, content: AnyMessageContent) => Promise<WAMessage | undefined>, options?: SchedulerOptions) => MessageScheduler;
+//# sourceMappingURL=scheduling.d.ts.map

package/lib/addons/scheduling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduling.d.ts","sourceRoot":"","sources":["../../src/addons/scheduling.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AACzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAEjD,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,SAAS,KAAK,IAAI,CAAA;IACnE,QAAQ,CAAC,EAAE,CAAC,SAAS,EAAE,gBAAgB,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;CAC9D;AAED,MAAM,WAAW,gBAAgB;IAChC,EAAE,EAAE,MAAM,CAAA;IACV,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,iBAAiB,CAAA;IAC1B,aAAa,EAAE,IAAI,CAAA;IACnB,SAAS,EAAE,IAAI,CAAA;IACf,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,WAAW,CAAA;IACnD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;CACd;AAED,qBAAa,gBAAgB;IAC5B,OAAO,CAAC,KAAK,CAAsC;IACnD,OAAO,CAAC,KAAK,CAA8C;IAC3D,OAAO,CAAC,WAAW,CAA6E;IAChG,OAAO,CAAC,OAAO,CAA4B;gBAG1C,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,EACxF,OAAO,GAAE,gBAAqB;IAW/B,OAAO,CAAC,UAAU;IAIlB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,IAAI,GAAG,gBAAgB;IAiBxF,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,GAAG,gBAAgB;IAIzF,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAU3B,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAYjC,UAAU,IAAI,gBAAgB,EAAE;IAIhC,GAAG,CAAC,EAAE,EAAE,MAAM;IAId,QAAQ,IAAI,MAAM;YAOJ,YAAY;IAoB1B,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,SAAS;IAOjB,IAAI;IAIJ,KAAK;CAGL;AAED,eAAO,MAAM,sBAAsB,GAClC,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,EACxF,UAAU,gBAAgB,qBACoB,CAAA"}