@queenanya/baileys 9.2.4 → 9.4.1

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

@@ -0,0 +1,201 @@
+import { proto } from '../../WAProto/index.js';
+import type { MediaGenerationOptions, WAMediaUpload } from '../Types/index.js';
+export type InteractiveButton = {
+    buttonId?: string;
+    displayText: string;
+};
+export type InteractiveButtonMessageContent = {
+    /** Body text of the message */
+    body: string;
+    /** Footer text */
+    footer?: string;
+    /** Buttons to display */
+    buttons: InteractiveButton[];
+    /** Optional: plain text title (uses TEXT header type) */
+    title?: string;
+    /** Optional: image header */
+    headerImage?: WAMediaUpload;
+    /** Optional: video header */
+    headerVideo?: WAMediaUpload;
+    /** Optional: document header */
+    headerDocument?: WAMediaUpload & {
+        filename?: string;
+    };
+};
+export type ListRow = {
+    rowId: string;
+    title: string;
+    description?: string;
+};
+export type ListSection = {
+    title: string;
+    rows: ListRow[];
+};
+export type InteractiveListMessageContent = {
+    title: string;
+    description?: string;
+    buttonText: string;
+    footer?: string;
+    sections: ListSection[];
+};
+export type TemplateHydratedButton = {
+    index: number;
+    quickReplyButton?: {
+        displayText: string;
+        id: string;
+    };
+    urlButton?: {
+        displayText: string;
+        url: string;
+    };
+    callButton?: {
+        displayText: string;
+        phoneNumber: string;
+    };
+};
+export type TemplateMessageContent = {
+    body: string;
+    footer?: string;
+    title?: string;
+    buttons: TemplateHydratedButton[];
+    headerImage?: WAMediaUpload;
+    headerVideo?: WAMediaUpload;
+    headerLocation?: {
+        latitude: number;
+        longitude: number;
+        name?: string;
+        address?: string;
+    };
+};
+export type NativeFlowButton = {
+    name: string;
+    buttonParamsJson: string;
+};
+export type NativeFlowOptions = {
+    footer?: string;
+    header?: {
+        title?: string;
+        subtitle?: string;
+        hasMediaAttachment?: boolean;
+    };
+};
+export type CopyCodeButtonOptions = NativeFlowOptions & {
+    displayText?: string;
+};
+export type UrlButton = {
+    displayText: string;
+    url: string;
+    merchantUrl?: string;
+};
+export type UrlButtonOptions = {
+    footer?: string;
+    title?: string;
+};
+export type QuickReplyButton = {
+    displayText: string;
+    id: string;
+};
+export type QuickReplyOptions = {
+    footer?: string;
+    title?: string;
+};
+export type CombinedButton = {
+    type: 'url';
+    displayText: string;
+    url: string;
+} | {
+    type: 'reply';
+    displayText: string;
+    id: string;
+} | {
+    type: 'copy';
+    displayText: string;
+    copyCode: string;
+} | {
+    type: 'call';
+    displayText: string;
+    phoneNumber: string;
+};
+export type CombinedButtonOptions = {
+    footer?: string;
+    title?: string;
+};
+/**
+ * Generate a classic WhatsApp ButtonsMessage (up to 3 buttons).
+ * Works via `sendMessage(jid, content.buttonsMessage)`.
+ */
+export declare const generateInteractiveButtonMessage: (content: InteractiveButtonMessageContent, options?: MediaGenerationOptions) => Promise<{
+    buttonsMessage: proto.Message.IButtonsMessage;
+}>;
+/**
+ * Generate a single-select list message.
+ * Works via `sendMessage(jid, content.listMessage)`.
+ */
+export declare const generateInteractiveListMessage: (content: InteractiveListMessageContent) => {
+    listMessage: proto.Message.IListMessage;
+};
+/**
+ * Generate a template message with quick-reply / URL / call buttons.
+ * Works via `sendMessage(jid, content.templateMessage)`.
+ */
+export declare const generateTemplateMessage: (content: TemplateMessageContent, options?: MediaGenerationOptions) => Promise<{
+    templateMessage: proto.Message.ITemplateMessage;
+}>;
+/**
+ * Core builder: generate a native-flow interactiveMessage with raw button definitions.
+ * All higher-level helpers (generateUrlButtonMessage, generateQuickReplyButtons, etc.) call this.
+ */
+export declare const generateNativeFlowMessage: (body: string, buttons: NativeFlowButton[], options?: NativeFlowOptions) => {
+    interactiveMessage: proto.Message.IInteractiveMessage;
+};
+/**
+ * Button that copies a code to the clipboard when tapped.
+ *
+ * @example
+ * const msg = generateCopyCodeButton('Here is your OTP', '123456')
+ * await sock.sendMessage(jid, msg.interactiveMessage)
+ */
+export declare const generateCopyCodeButton: (body: string, copyCode: string, displayText?: string, options?: CopyCodeButtonOptions) => {
+    interactiveMessage: proto.Message.IInteractiveMessage;
+};
+/**
+ * One or more CTA URL buttons (opens a link in browser).
+ *
+ * @example
+ * const msg = generateUrlButtonMessage('Visit us!', [
+ *   { displayText: 'Open Website', url: 'https://example.com' }
+ * ])
+ * await sock.sendMessage(jid, msg.interactiveMessage)
+ */
+export declare const generateUrlButtonMessage: (body: string, buttons: UrlButton[], options?: UrlButtonOptions) => {
+    interactiveMessage: proto.Message.IInteractiveMessage;
+};
+/**
+ * One or more quick-reply buttons (sends a reply when tapped).
+ *
+ * @example
+ * const msg = generateQuickReplyButtons('Choose an option:', [
+ *   { displayText: 'Yes', id: 'yes' },
+ *   { displayText: 'No',  id: 'no'  }
+ * ])
+ * await sock.sendMessage(jid, msg.interactiveMessage)
+ */
+export declare const generateQuickReplyButtons: (body: string, buttons: QuickReplyButton[], options?: QuickReplyOptions) => {
+    interactiveMessage: proto.Message.IInteractiveMessage;
+};
+/**
+ * Mix of url / reply / copy / call buttons in one message.
+ *
+ * @example
+ * const msg = generateCombinedButtons('What do you want?', [
+ *   { type: 'url',   displayText: 'Visit', url: 'https://example.com' },
+ *   { type: 'reply', displayText: 'Ping',  id: 'ping' },
+ *   { type: 'copy',  displayText: 'Copy',  copyCode: 'ABC123' },
+ *   { type: 'call',  displayText: 'Call',  phoneNumber: '+911234567890' }
+ * ])
+ * await sock.sendMessage(jid, msg.interactiveMessage)
+ */
+export declare const generateCombinedButtons: (body: string, buttons: CombinedButton[], options?: CombinedButtonOptions) => {
+    interactiveMessage: proto.Message.IInteractiveMessage;
+};
+//# sourceMappingURL=interactive-message.d.ts.map

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

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

package/lib/addons/interactive-message.js

@@ -0,0 +1,256 @@
+import { proto } from '../../WAProto/index.js';
+import { prepareWAMessageMedia } from '../Utils/messages.js';
+// ─── Generators ────────────────────────────────────────────────────────────────
+/**
+ * Generate a classic WhatsApp ButtonsMessage (up to 3 buttons).
+ * Works via `sendMessage(jid, content.buttonsMessage)`.
+ */
+export const generateInteractiveButtonMessage = async (content, options) => {
+    const buttons = content.buttons.map((btn, idx) => ({
+        buttonId: btn.buttonId ?? `btn-${idx}`,
+        buttonText: { displayText: btn.displayText },
+        type: proto.Message.ButtonsMessage.Button.Type.RESPONSE,
+        nativeFlowInfo: undefined
+    }));
+    const buttonsMessage = {
+        contentText: content.body,
+        footerText: content.footer,
+        buttons,
+        headerType: proto.Message.ButtonsMessage.HeaderType.EMPTY
+    };
+    if (content.headerImage && options) {
+        const media = await prepareWAMessageMedia({ image: content.headerImage }, options);
+        buttonsMessage.imageMessage = media.imageMessage;
+        buttonsMessage.headerType = proto.Message.ButtonsMessage.HeaderType.IMAGE;
+    }
+    else if (content.headerVideo && options) {
+        const media = await prepareWAMessageMedia({ video: content.headerVideo }, options);
+        buttonsMessage.videoMessage = media.videoMessage;
+        buttonsMessage.headerType = proto.Message.ButtonsMessage.HeaderType.VIDEO;
+    }
+    else if (content.headerDocument && options) {
+        const doc = content.headerDocument;
+        const media = await prepareWAMessageMedia({ document: doc, mimetype: 'application/pdf', fileName: doc.filename }, options);
+        buttonsMessage.documentMessage = media.documentMessage;
+        buttonsMessage.headerType = proto.Message.ButtonsMessage.HeaderType.DOCUMENT;
+    }
+    else if (content.title) {
+        buttonsMessage.text = content.title;
+        buttonsMessage.headerType = proto.Message.ButtonsMessage.HeaderType.TEXT;
+    }
+    return { buttonsMessage };
+};
+/**
+ * Generate a single-select list message.
+ * Works via `sendMessage(jid, content.listMessage)`.
+ */
+export const generateInteractiveListMessage = (content) => {
+    const sections = content.sections.map(section => ({
+        title: section.title,
+        rows: section.rows.map(row => ({
+            rowId: row.rowId,
+            title: row.title,
+            description: row.description ?? ''
+        }))
+    }));
+    return {
+        listMessage: {
+            title: content.title,
+            description: content.description ?? '',
+            buttonText: content.buttonText,
+            footerText: content.footer ?? '',
+            listType: proto.Message.ListMessage.ListType.SINGLE_SELECT,
+            sections
+        }
+    };
+};
+/**
+ * Generate a template message with quick-reply / URL / call buttons.
+ * Works via `sendMessage(jid, content.templateMessage)`.
+ */
+export const generateTemplateMessage = async (content, options) => {
+    const hydratedButtons = content.buttons.map(btn => {
+        const hydratedBtn = { index: btn.index };
+        if (btn.quickReplyButton) {
+            hydratedBtn.quickReplyButton = {
+                displayText: btn.quickReplyButton.displayText,
+                id: btn.quickReplyButton.id
+            };
+        }
+        else if (btn.urlButton) {
+            hydratedBtn.urlButton = {
+                displayText: btn.urlButton.displayText,
+                url: btn.urlButton.url
+            };
+        }
+        else if (btn.callButton) {
+            hydratedBtn.callButton = {
+                displayText: btn.callButton.displayText,
+                phoneNumber: btn.callButton.phoneNumber
+            };
+        }
+        return hydratedBtn;
+    });
+    const hydratedTemplate = {
+        hydratedContentText: content.body,
+        hydratedFooterText: content.footer,
+        hydratedButtons
+    };
+    if (content.title) {
+        hydratedTemplate.hydratedTitleText = content.title;
+    }
+    if (content.headerImage && options) {
+        const media = await prepareWAMessageMedia({ image: content.headerImage }, options);
+        hydratedTemplate.imageMessage = media.imageMessage;
+    }
+    else if (content.headerVideo && options) {
+        const media = await prepareWAMessageMedia({ video: content.headerVideo }, options);
+        hydratedTemplate.videoMessage = media.videoMessage;
+    }
+    else if (content.headerLocation) {
+        hydratedTemplate.locationMessage = {
+            degreesLatitude: content.headerLocation.latitude,
+            degreesLongitude: content.headerLocation.longitude,
+            name: content.headerLocation.name,
+            address: content.headerLocation.address
+        };
+    }
+    return {
+        templateMessage: {
+            hydratedTemplate
+        }
+    };
+};
+/**
+ * Core builder: generate a native-flow interactiveMessage with raw button definitions.
+ * All higher-level helpers (generateUrlButtonMessage, generateQuickReplyButtons, etc.) call this.
+ */
+export const generateNativeFlowMessage = (body, buttons, options) => {
+    return {
+        interactiveMessage: {
+            body: { text: body },
+            footer: options?.footer ? { text: options.footer } : undefined,
+            header: options?.header
+                ? {
+                    title: options.header.title,
+                    subtitle: options.header.subtitle,
+                    hasMediaAttachment: options.header.hasMediaAttachment ?? false
+                }
+                : undefined,
+            nativeFlowMessage: {
+                buttons: buttons.map(btn => ({
+                    name: btn.name,
+                    buttonParamsJson: btn.buttonParamsJson
+                })),
+                messageParamsJson: ''
+            }
+        }
+    };
+};
+/**
+ * Button that copies a code to the clipboard when tapped.
+ *
+ * @example
+ * const msg = generateCopyCodeButton('Here is your OTP', '123456')
+ * await sock.sendMessage(jid, msg.interactiveMessage)
+ */
+export const generateCopyCodeButton = (body, copyCode, displayText = 'Copy Code', options) => {
+    return generateNativeFlowMessage(body, [
+        {
+            name: 'cta_copy',
+            buttonParamsJson: JSON.stringify({ display_text: displayText, copy_code: copyCode })
+        }
+    ], options);
+};
+/**
+ * One or more CTA URL buttons (opens a link in browser).
+ *
+ * @example
+ * const msg = generateUrlButtonMessage('Visit us!', [
+ *   { displayText: 'Open Website', url: 'https://example.com' }
+ * ])
+ * await sock.sendMessage(jid, msg.interactiveMessage)
+ */
+export const generateUrlButtonMessage = (body, buttons, options) => {
+    const nativeButtons = buttons.map(btn => ({
+        name: 'cta_url',
+        buttonParamsJson: JSON.stringify({
+            display_text: btn.displayText,
+            url: btn.url,
+            merchant_url: btn.merchantUrl
+        })
+    }));
+    return generateNativeFlowMessage(body, nativeButtons, {
+        footer: options?.footer,
+        header: options?.title ? { title: options.title } : undefined
+    });
+};
+/**
+ * One or more quick-reply buttons (sends a reply when tapped).
+ *
+ * @example
+ * const msg = generateQuickReplyButtons('Choose an option:', [
+ *   { displayText: 'Yes', id: 'yes' },
+ *   { displayText: 'No',  id: 'no'  }
+ * ])
+ * await sock.sendMessage(jid, msg.interactiveMessage)
+ */
+export const generateQuickReplyButtons = (body, buttons, options) => {
+    const nativeButtons = buttons.map(btn => ({
+        name: 'quick_reply',
+        buttonParamsJson: JSON.stringify({ display_text: btn.displayText, id: btn.id })
+    }));
+    return generateNativeFlowMessage(body, nativeButtons, {
+        footer: options?.footer,
+        header: options?.title ? { title: options.title } : undefined
+    });
+};
+/**
+ * Mix of url / reply / copy / call buttons in one message.
+ *
+ * @example
+ * const msg = generateCombinedButtons('What do you want?', [
+ *   { type: 'url',   displayText: 'Visit', url: 'https://example.com' },
+ *   { type: 'reply', displayText: 'Ping',  id: 'ping' },
+ *   { type: 'copy',  displayText: 'Copy',  copyCode: 'ABC123' },
+ *   { type: 'call',  displayText: 'Call',  phoneNumber: '+911234567890' }
+ * ])
+ * await sock.sendMessage(jid, msg.interactiveMessage)
+ */
+export const generateCombinedButtons = (body, buttons, options) => {
+    const nativeButtons = buttons.map(btn => {
+        switch (btn.type) {
+            case 'url':
+                return {
+                    name: 'cta_url',
+                    buttonParamsJson: JSON.stringify({ display_text: btn.displayText, url: btn.url })
+                };
+            case 'reply':
+                return {
+                    name: 'quick_reply',
+                    buttonParamsJson: JSON.stringify({ display_text: btn.displayText, id: btn.id })
+                };
+            case 'copy':
+                return {
+                    name: 'cta_copy',
+                    buttonParamsJson: JSON.stringify({
+                        display_text: btn.displayText,
+                        copy_code: btn.copyCode
+                    })
+                };
+            case 'call':
+                return {
+                    name: 'cta_call',
+                    buttonParamsJson: JSON.stringify({
+                        display_text: btn.displayText,
+                        phone_number: btn.phoneNumber
+                    })
+                };
+        }
+    });
+    return generateNativeFlowMessage(body, nativeButtons, {
+        footer: options?.footer,
+        header: options?.title ? { title: options.title } : undefined
+    });
+};
+//# sourceMappingURL=interactive-message.js.map

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

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

package/lib/addons/jid-plot.d.ts

@@ -0,0 +1,49 @@
+/**
+ * JID Plotting & LID Support utilities
+ * Maps between PN JIDs (@s.whatsapp.net) and LID JIDs (@lid)
+ * Useful for resolving JIDs in groups that use LID addressing
+ */
+export type JidPlotEntry = {
+    pnJid: string;
+    lidJid: string;
+};
+/**
+ * Register a PN <-> LID mapping in the plot
+ */
+export declare const plotJidPair: (pnJid: string, lidJid: string) => void;
+/**
+ * Batch register multiple PN <-> LID pairs
+ */
+export declare const plotJidPairs: (entries: JidPlotEntry[]) => void;
+/**
+ * Resolve a JID to its PN form (@s.whatsapp.net)
+ * If already PN, returns as-is. If LID, looks up the mapped PN.
+ */
+export declare const resolvePnJid: (jid: string) => string | undefined;
+/**
+ * Resolve a JID to its LID form (@lid)
+ * If already LID, returns as-is. If PN, looks up the mapped LID.
+ */
+export declare const resolveLidJid: (jid: string) => string | undefined;
+/**
+ * Check whether a JID has a known LID counterpart in the plot
+ */
+export declare const hasLidMapping: (pnJid: string) => boolean;
+/**
+ * Check whether a LID JID has a known PN counterpart in the plot
+ */
+export declare const hasPnMapping: (lidJid: string) => boolean;
+/**
+ * Get all registered plot entries
+ */
+export declare const getAllJidPlotEntries: () => JidPlotEntry[];
+/**
+ * Clear all JID plot mappings
+ */
+export declare const clearJidPlot: () => void;
+/**
+ * Normalize a JID — convert @c.us to @s.whatsapp.net,
+ * strip device suffix, and resolve LID to PN if mapped.
+ */
+export declare const normalizeJidForSend: (jid: string) => string;
+//# sourceMappingURL=jid-plot.d.ts.map

package/lib/addons/jid-plot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jid-plot.d.ts","sourceRoot":"","sources":["../../src/addons/jid-plot.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,MAAM,YAAY,GAAG;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACd,CAAA;AAKD;;GAEG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,MAAM,EAAE,QAAQ,MAAM,KAAG,IAG3D,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,YAAY,GAAI,SAAS,YAAY,EAAE,KAAG,IAItD,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY,GAAI,KAAK,MAAM,KAAG,MAAM,GAAG,SAInD,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,KAAK,MAAM,KAAG,MAAM,GAAG,SAIpD,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,MAAM,KAAG,OAAgC,CAAA;AAE9E;;GAEG;AACH,eAAO,MAAM,YAAY,GAAI,QAAQ,MAAM,KAAG,OAAiC,CAAA;AAE/E;;GAEG;AACH,eAAO,MAAM,oBAAoB,QAAO,YAAY,EASnD,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,YAAY,QAAO,IAE/B,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAAI,KAAK,MAAM,KAAG,MAMjD,CAAA"}

package/lib/addons/jid-plot.js

@@ -0,0 +1,84 @@
+/**
+ * JID Plotting & LID Support utilities
+ * Maps between PN JIDs (@s.whatsapp.net) and LID JIDs (@lid)
+ * Useful for resolving JIDs in groups that use LID addressing
+ */
+import { isLidUser, isPnUser, jidDecode, jidEncode } from '../WABinary/index.js';
+/** In-memory JID plot map: pnJid -> lidJid and lidJid -> pnJid */
+const jidPlotMap = new Map();
+/**
+ * Register a PN <-> LID mapping in the plot
+ */
+export const plotJidPair = (pnJid, lidJid) => {
+    jidPlotMap.set(pnJid, lidJid);
+    jidPlotMap.set(lidJid, pnJid);
+};
+/**
+ * Batch register multiple PN <-> LID pairs
+ */
+export const plotJidPairs = (entries) => {
+    for (const { pnJid, lidJid } of entries) {
+        plotJidPair(pnJid, lidJid);
+    }
+};
+/**
+ * Resolve a JID to its PN form (@s.whatsapp.net)
+ * If already PN, returns as-is. If LID, looks up the mapped PN.
+ */
+export const resolvePnJid = (jid) => {
+    if (isPnUser(jid))
+        return jid;
+    if (isLidUser(jid))
+        return jidPlotMap.get(jid);
+    return jid;
+};
+/**
+ * Resolve a JID to its LID form (@lid)
+ * If already LID, returns as-is. If PN, looks up the mapped LID.
+ */
+export const resolveLidJid = (jid) => {
+    if (isLidUser(jid))
+        return jid;
+    if (isPnUser(jid))
+        return jidPlotMap.get(jid);
+    return jid;
+};
+/**
+ * Check whether a JID has a known LID counterpart in the plot
+ */
+export const hasLidMapping = (pnJid) => jidPlotMap.has(pnJid);
+/**
+ * Check whether a LID JID has a known PN counterpart in the plot
+ */
+export const hasPnMapping = (lidJid) => jidPlotMap.has(lidJid);
+/**
+ * Get all registered plot entries
+ */
+export const getAllJidPlotEntries = () => {
+    const entries = [];
+    for (const [key, value] of jidPlotMap.entries()) {
+        if (isPnUser(key)) {
+            entries.push({ pnJid: key, lidJid: value });
+        }
+    }
+    return entries;
+};
+/**
+ * Clear all JID plot mappings
+ */
+export const clearJidPlot = () => {
+    jidPlotMap.clear();
+};
+/**
+ * Normalize a JID — convert @c.us to @s.whatsapp.net,
+ * strip device suffix, and resolve LID to PN if mapped.
+ */
+export const normalizeJidForSend = (jid) => {
+    const decoded = jidDecode(jid);
+    if (!decoded)
+        return jid;
+    const { user, server } = decoded;
+    const normalized = jidEncode(user, server === 'c.us' ? 's.whatsapp.net' : server);
+    return resolvePnJid(normalized) || normalized;
+};
+//# sourceMappingURL=jid-plot.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"jid-plot.js","sourceRoot":"","sources":["../../src/addons/jid-plot.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAOvE,kEAAkE;AAClE,MAAM,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAA;AAE5C;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAa,EAAE,MAAc,EAAQ,EAAE;IAClE,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;IAC7B,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;AAC9B,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,OAAuB,EAAQ,EAAE;IAC7D,KAAK,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,OAAO,EAAE,CAAC;QACzC,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;IAC3B,CAAC;AACF,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,GAAW,EAAsB,EAAE;IAC/D,IAAI,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAA;IAC7B,IAAI,SAAS,CAAC,GAAG,CAAC;QAAE,OAAO,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IAC9C,OAAO,GAAG,CAAA;AACX,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,GAAW,EAAsB,EAAE;IAChE,IAAI,SAAS,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAA;IAC9B,IAAI,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IAC7C,OAAO,GAAG,CAAA;AACX,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAa,EAAW,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;AAE9E;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,MAAc,EAAW,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;AAE/E;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAmB,EAAE;IACxD,MAAM,OAAO,GAAmB,EAAE,CAAA;IAClC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC;QACjD,IAAI,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACnB,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAA;QAC5C,CAAC;IACF,CAAC;IAED,OAAO,OAAO,CAAA;AACf,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,GAAS,EAAE;IACtC,UAAU,CAAC,KAAK,EAAE,CAAA;AACnB,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,GAAW,EAAU,EAAE;IAC1D,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,CAAA;IAC9B,IAAI,CAAC,OAAO;QAAE,OAAO,GAAG,CAAA;IACxB,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAA;IAChC,MAAM,UAAU,GAAG,SAAS,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAA;IACjF,OAAO,YAAY,CAAC,UAAU,CAAC,IAAI,UAAU,CAAA;AAC9C,CAAC,CAAA"}

package/lib/addons/jid-plotting.d.ts

@@ -0,0 +1,54 @@
+import type { AuthenticationState, WAMessage } from '../Types/index.js';
+export interface JidInfo {
+    jid: string;
+    user: string;
+    server: string;
+    device: number;
+    agent: number;
+    isLid: boolean;
+    isPn: boolean;
+    isHosted: boolean;
+    isGroup: boolean;
+    isNewsletter: boolean;
+    normalizedUser: string;
+}
+export interface SenderPnInfo {
+    phoneJid: string;
+    phoneNumber: string;
+    lid?: string;
+    deviceId: number;
+    pushName?: string;
+    platform?: string;
+}
+export interface PlottedJid {
+    original: string;
+    primary: string;
+    info: JidInfo | null;
+    pn?: string;
+    lid?: string;
+}
+export declare const parseJid: (jid: string) => JidInfo | null;
+export declare const getSenderPn: (creds: AuthenticationState["creds"]) => SenderPnInfo | null;
+export declare const getCurrentSenderInfo: (authState: AuthenticationState) => SenderPnInfo | null;
+export declare const isSelf: (jid: string, senderPn: SenderPnInfo) => boolean;
+export declare const plotJid: (jid: string) => PlottedJid | null;
+export declare const normalizePhoneToJid: (phone: string) => string;
+export declare const extractPhoneNumber: (jid: string) => string | null;
+export declare const formatJidDisplay: (jid: string, options?: {
+    showDevice?: boolean;
+    showType?: boolean;
+}) => string;
+export declare const isSameUser: (jid1: string, jid2: string) => boolean;
+export declare const getJidVariants: (phone: string) => string[];
+export declare const constructJidWithDevice: (user: string, device: number, server?: string) => string;
+export declare const getRemoteJidFromMessage: (msg: WAMessage) => {
+    chatJid: string;
+    senderJid: string;
+} | null;
+export interface JidPlotterWithMapping {
+    plotToLid: (pn: string) => Promise<string | null>;
+    plotToPn: (lid: string) => Promise<string | null>;
+    plotBidirectional: (jid: string) => Promise<PlottedJid>;
+}
+export declare const createJidPlotter: (getLIDForPN: (pn: string) => Promise<string | null>, getPNForLID: (lid: string) => Promise<string | null>) => JidPlotterWithMapping;
+//# sourceMappingURL=jid-plotting.d.ts.map