@lopeszera/baileys 1.0.1

package/lib/Utils/history.js

@@ -0,0 +1,134 @@
+import { pipeline } from 'stream/promises';
+import { promisify } from 'util';
+import { createInflate, inflate } from 'zlib';
+import { proto } from '../../WAProto/index.js';
+import { WAMessageStubType } from '../Types/index.js';
+import { isHostedLidUser, isHostedPnUser, isLidUser, isPnUser } from '../WABinary/index.js';
+import { toNumber } from './generics.js';
+import { normalizeMessageContent } from './messages.js';
+import { downloadContentFromMessage } from './messages-media.js';
+const inflatePromise = promisify(inflate);
+const extractPnFromMessages = (messages) => {
+    for (const msgItem of messages) {
+        const message = msgItem.message;
+        // Only extract from outgoing messages (fromMe: true) in 1:1 chats
+        // because userReceipt.userJid is the recipient's JID
+        if (!message?.key?.fromMe || !message.userReceipt?.length) {
+            continue;
+        }
+        const userJid = message.userReceipt[0]?.userJid;
+        if (userJid && (isPnUser(userJid) || isHostedPnUser(userJid))) {
+            return userJid;
+        }
+    }
+    return undefined;
+};
+export const downloadHistory = async (msg, options) => {
+    const stream = await downloadContentFromMessage(msg, 'md-msg-hist', { options });
+    // Pipe decrypted stream directly through zlib inflate
+    // This avoids allocating an intermediate buffer for the compressed data
+    const inflater = createInflate();
+    const chunks = [];
+    inflater.on('data', (chunk) => chunks.push(chunk));
+    await pipeline(stream, inflater);
+    const buffer = Buffer.concat(chunks);
+    const syncData = proto.HistorySync.decode(buffer);
+    return syncData;
+};
+export const processHistoryMessage = (item, logger) => {
+    const messages = [];
+    const contacts = [];
+    const chats = [];
+    const lidPnMappings = [];
+    logger?.trace({ progress: item.progress }, 'processing history of type ' + item.syncType?.toString());
+    // Extract LID-PN mappings for all sync types
+    for (const m of item.phoneNumberToLidMappings || []) {
+        if (m.lidJid && m.pnJid) {
+            lidPnMappings.push({ lid: m.lidJid, pn: m.pnJid });
+        }
+    }
+    switch (item.syncType) {
+        case proto.HistorySync.HistorySyncType.INITIAL_BOOTSTRAP:
+        case proto.HistorySync.HistorySyncType.RECENT:
+        case proto.HistorySync.HistorySyncType.FULL:
+        case proto.HistorySync.HistorySyncType.ON_DEMAND:
+            for (const chat of item.conversations) {
+                contacts.push({
+                    id: chat.id,
+                    name: chat.displayName || chat.name || chat.username || undefined,
+                    username: chat.username || undefined,
+                    lid: chat.lidJid || chat.accountLid || undefined,
+                    phoneNumber: chat.pnJid || undefined
+                });
+                const chatId = chat.id;
+                const isLid = isLidUser(chatId) || isHostedLidUser(chatId);
+                const isPn = isPnUser(chatId) || isHostedPnUser(chatId);
+                if (isLid && chat.pnJid) {
+                    lidPnMappings.push({ lid: chatId, pn: chat.pnJid });
+                }
+                else if (isPn && chat.lidJid) {
+                    lidPnMappings.push({ lid: chat.lidJid, pn: chatId });
+                }
+                else if (isLid && !chat.pnJid) {
+                    // Fallback: extract PN from userReceipt in messages when pnJid is missing
+                    const pnFromReceipt = extractPnFromMessages(chat.messages || []);
+                    if (pnFromReceipt) {
+                        lidPnMappings.push({ lid: chatId, pn: pnFromReceipt });
+                    }
+                }
+                const msgs = chat.messages || [];
+                delete chat.messages;
+                for (const item of msgs) {
+                    const message = item.message;
+                    messages.push(message);
+                    if (!chat.messages?.length) {
+                        // keep only the most recent message in the chat array
+                        chat.messages = [{ message }];
+                    }
+                    if (!message.key.fromMe && !chat.lastMessageRecvTimestamp) {
+                        chat.lastMessageRecvTimestamp = toNumber(message.messageTimestamp);
+                    }
+                    if ((message.messageStubType === WAMessageStubType.BIZ_PRIVACY_MODE_TO_BSP ||
+                        message.messageStubType === WAMessageStubType.BIZ_PRIVACY_MODE_TO_FB) &&
+                        message.messageStubParameters?.[0]) {
+                        contacts.push({
+                            id: message.key.participant || message.key.remoteJid,
+                            verifiedName: message.messageStubParameters?.[0]
+                        });
+                    }
+                }
+                chats.push(chat);
+            }
+            break;
+        case proto.HistorySync.HistorySyncType.PUSH_NAME:
+            for (const c of item.pushnames) {
+                contacts.push({ id: c.id, notify: c.pushname });
+            }
+            break;
+    }
+    return {
+        chats,
+        contacts,
+        messages,
+        lidPnMappings,
+        pastParticipants: item.pastParticipants,
+        syncType: item.syncType,
+        progress: item.progress
+    };
+};
+export const downloadAndProcessHistorySyncNotification = async (msg, options, logger) => {
+    let historyMsg;
+    if (msg.initialHistBootstrapInlinePayload) {
+        historyMsg = proto.HistorySync.decode(await inflatePromise(msg.initialHistBootstrapInlinePayload));
+    }
+    else {
+        historyMsg = await downloadHistory(msg, options);
+    }
+    return processHistoryMessage(historyMsg, logger);
+};
+export const getHistoryMsg = (message) => {
+    const normalizedContent = !!message ? normalizeMessageContent(message) : undefined;
+    const anyHistoryMsg = normalizedContent?.protocolMessage?.historySyncNotification;
+    return anyHistoryMsg;
+};
+//# sourceMappingURL=history.js.map

package/lib/Utils/history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.js","sourceRoot":"","sources":["../../src/Utils/history.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAA;AAChC,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAC7C,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AAE9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAC5C,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAClF,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAErC,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAA;AACpD,OAAO,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAA;AAE7D,MAAM,cAAc,GAAG,SAAS,CAAC,OAAO,CAAC,CAAA;AAEzC,MAAM,qBAAqB,GAAG,CAAC,QAAiC,EAAsB,EAAE;IACvF,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAChC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAA;QAC/B,kEAAkE;QAClE,qDAAqD;QACrD,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC;YAC3D,SAAQ;QACT,CAAC;QAED,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,OAAO,CAAA;QAC/C,IAAI,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,cAAc,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;YAC/D,OAAO,OAAO,CAAA;QACf,CAAC;IACF,CAAC;IAED,OAAO,SAAS,CAAA;AACjB,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,EAAE,GAA2C,EAAE,OAAoB,EAAE,EAAE;IAC1G,MAAM,MAAM,GAAG,MAAM,0BAA0B,CAAC,GAAG,EAAE,aAAa,EAAE,EAAE,OAAO,EAAE,CAAC,CAAA;IAChF,sDAAsD;IACtD,wEAAwE;IACxE,MAAM,QAAQ,GAAG,aAAa,EAAE,CAAA;IAChC,MAAM,MAAM,GAAa,EAAE,CAAA;IAC3B,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAA;IAC1D,MAAM,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;IAEhC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IACpC,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IACjD,OAAO,QAAQ,CAAA;AAChB,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,IAAwB,EAAE,MAAgB,EAAE,EAAE;IACnF,MAAM,QAAQ,GAAgB,EAAE,CAAA;IAChC,MAAM,QAAQ,GAAc,EAAE,CAAA;IAC9B,MAAM,KAAK,GAAW,EAAE,CAAA;IACxB,MAAM,aAAa,GAAiB,EAAE,CAAA;IAEtC,MAAM,EAAE,KAAK,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,EAAE,6BAA6B,GAAG,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAA;IAErG,6CAA6C;IAC7C,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,wBAAwB,IAAI,EAAE,EAAE,CAAC;QACrD,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;YACzB,aAAa,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAA;QACnD,CAAC;IACF,CAAC;IAED,QAAQ,IAAI,CAAC,QAAQ,EAAE,CAAC;QACvB,KAAK,KAAK,CAAC,WAAW,CAAC,eAAe,CAAC,iBAAiB,CAAC;QACzD,KAAK,KAAK,CAAC,WAAW,CAAC,eAAe,CAAC,MAAM,CAAC;QAC9C,KAAK,KAAK,CAAC,WAAW,CAAC,eAAe,CAAC,IAAI,CAAC;QAC5C,KAAK,KAAK,CAAC,WAAW,CAAC,eAAe,CAAC,SAAS;YAC/C,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,aAAwB,EAAE,CAAC;gBAClD,QAAQ,CAAC,IAAI,CAAC;oBACb,EAAE,EAAE,IAAI,CAAC,EAAG;oBACZ,IAAI,EAAE,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ,IAAI,SAAS;oBACjE,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,SAAS;oBACpC,GAAG,EAAE,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,UAAU,IAAI,SAAS;oBAChD,WAAW,EAAE,IAAI,CAAC,KAAK,IAAI,SAAS;iBACpC,CAAC,CAAA;gBAEF,MAAM,MAAM,GAAG,IAAI,CAAC,EAAG,CAAA;gBACvB,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,CAAC,IAAI,eAAe,CAAC,MAAM,CAAC,CAAA;gBAC1D,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,cAAc,CAAC,MAAM,CAAC,CAAA;gBACvD,IAAI,KAAK,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;oBACzB,aAAa,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAA;gBACpD,CAAC;qBAAM,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;oBAChC,aAAa,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAA;gBACrD,CAAC;qBAAM,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;oBACjC,0EAA0E;oBAC1E,MAAM,aAAa,GAAG,qBAAqB,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAA;oBAChE,IAAI,aAAa,EAAE,CAAC;wBACnB,aAAa,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,aAAa,EAAE,CAAC,CAAA;oBACvD,CAAC;gBACF,CAAC;gBAED,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAA;gBAChC,OAAO,IAAI,CAAC,QAAQ,CAAA;gBAEpB,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;oBACzB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAqB,CAAA;oBAC1C,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;oBAEtB,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;wBAC5B,sDAAsD;wBACtD,IAAI,CAAC,QAAQ,GAAG,CAAC,EAAE,OAAO,EAAE,CAAC,CAAA;oBAC9B,CAAC;oBAED,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,wBAAwB,EAAE,CAAC;wBAC3D,IAAI,CAAC,wBAAwB,GAAG,QAAQ,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAA;oBACnE,CAAC;oBAED,IACC,CAAC,OAAO,CAAC,eAAe,KAAK,iBAAiB,CAAC,uBAAuB;wBACrE,OAAO,CAAC,eAAe,KAAK,iBAAiB,CAAC,sBAAsB,CAAC;wBACtE,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAAC,CAAC,EACjC,CAAC;wBACF,QAAQ,CAAC,IAAI,CAAC;4BACb,EAAE,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,SAAU;4BACrD,YAAY,EAAE,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAAC,CAAC;yBAChD,CAAC,CAAA;oBACH,CAAC;gBACF,CAAC;gBAED,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YACjB,CAAC;YAED,MAAK;QACN,KAAK,KAAK,CAAC,WAAW,CAAC,eAAe,CAAC,SAAS;YAC/C,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,SAAU,EAAE,CAAC;gBACjC,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAG,EAAE,MAAM,EAAE,CAAC,CAAC,QAAS,EAAE,CAAC,CAAA;YAClD,CAAC;YAED,MAAK;IACP,CAAC;IAED,OAAO;QACN,KAAK;QACL,QAAQ;QACR,QAAQ;QACR,aAAa;QACb,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;QACvC,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;KACvB,CAAA;AACF,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,yCAAyC,GAAG,KAAK,EAC7D,GAA2C,EAC3C,OAAoB,EACpB,MAAgB,EACf,EAAE;IACH,IAAI,UAA6B,CAAA;IACjC,IAAI,GAAG,CAAC,iCAAiC,EAAE,CAAC;QAC3C,UAAU,GAAG,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,cAAc,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC,CAAA;IACnG,CAAC;SAAM,CAAC;QACP,UAAU,GAAG,MAAM,eAAe,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;IACjD,CAAC;IAED,OAAO,qBAAqB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAA;AACjD,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,OAAuB,EAAE,EAAE;IACxD,MAAM,iBAAiB,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IAClF,MAAM,aAAa,GAAG,iBAAiB,EAAE,eAAe,EAAE,uBAAwB,CAAA;IAElF,OAAO,aAAa,CAAA;AACrB,CAAC,CAAA"}

package/lib/Utils/identity-change-handler.d.ts

@@ -0,0 +1,44 @@
+import NodeCache from '@cacheable/node-cache';
+import { type BinaryNode } from '../WABinary/index.js';
+import type { ILogger } from './logger.js';
+export type IdentityChangeResult = {
+    action: 'no_identity_node';
+} | {
+    action: 'invalid_notification';
+} | {
+    action: 'skipped_companion_device';
+    device: number;
+} | {
+    action: 'skipped_self_primary';
+} | {
+    action: 'debounced';
+} | {
+    action: 'skipped_offline';
+} | {
+    action: 'skipped_no_session';
+} | {
+    action: 'session_refreshed';
+} | {
+    action: 'session_refresh_failed';
+    error: unknown;
+};
+export type IdentityChangeContext = {
+    meId: string | undefined;
+    meLid: string | undefined;
+    validateSession: (jid: string) => Promise<{
+        exists: boolean;
+        reason?: string;
+    }>;
+    assertSessions: (jids: string[], force?: boolean) => Promise<boolean>;
+    debounceCache: NodeCache<boolean>;
+    logger: ILogger;
+    /**
+     * Invoked right before `assertSessions` is called for an existing-session identity change.
+     * Used to kick off fire-and-forget side effects (e.g. tctoken re-issuance) in the same
+     * order WA Web does — i.e. before the E2E session is re-established.
+     * Must not throw; implementations are responsible for their own error handling.
+     */
+    onBeforeSessionRefresh?: (jid: string) => void;
+};
+export declare function handleIdentityChange(node: BinaryNode, ctx: IdentityChangeContext): Promise<IdentityChangeResult>;
+//# sourceMappingURL=identity-change-handler.d.ts.map

package/lib/Utils/identity-change-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity-change-handler.d.ts","sourceRoot":"","sources":["../../src/Utils/identity-change-handler.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,uBAAuB,CAAA;AAC7C,OAAO,EAAmB,KAAK,UAAU,EAAiC,MAAM,aAAa,CAAA;AAE7F,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAA;AAEvC,MAAM,MAAM,oBAAoB,GAC7B;IAAE,MAAM,EAAE,kBAAkB,CAAA;CAAE,GAC9B;IAAE,MAAM,EAAE,sBAAsB,CAAA;CAAE,GAClC;IAAE,MAAM,EAAE,0BAA0B,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,MAAM,EAAE,sBAAsB,CAAA;CAAE,GAClC;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,GACvB;IAAE,MAAM,EAAE,iBAAiB,CAAA;CAAE,GAC7B;IAAE,MAAM,EAAE,oBAAoB,CAAA;CAAE,GAChC;IAAE,MAAM,EAAE,mBAAmB,CAAA;CAAE,GAC/B;IAAE,MAAM,EAAE,wBAAwB,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAA;AAEvD,MAAM,MAAM,qBAAqB,GAAG;IACnC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAA;IACxB,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB,eAAe,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAC/E,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IACrE,aAAa,EAAE,SAAS,CAAC,OAAO,CAAC,CAAA;IACjC,MAAM,EAAE,OAAO,CAAA;IACf;;;;;OAKG;IACH,sBAAsB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;CAC9C,CAAA;AAED,wBAAsB,oBAAoB,CACzC,IAAI,EAAE,UAAU,EAChB,GAAG,EAAE,qBAAqB,GACxB,OAAO,CAAC,oBAAoB,CAAC,CAwD/B"}

package/lib/Utils/identity-change-handler.js

@@ -0,0 +1,50 @@
+import NodeCache from '@cacheable/node-cache';
+import { areJidsSameUser, getBinaryNodeChild, jidDecode } from '../WABinary/index.js';
+import { isStringNullOrEmpty } from './generics.js';
+export async function handleIdentityChange(node, ctx) {
+    const from = node.attrs.from;
+    if (!from) {
+        return { action: 'invalid_notification' };
+    }
+    const identityNode = getBinaryNodeChild(node, 'identity');
+    if (!identityNode) {
+        return { action: 'no_identity_node' };
+    }
+    ctx.logger.info({ jid: from }, 'identity changed');
+    const decoded = jidDecode(from);
+    if (decoded?.device && decoded.device !== 0) {
+        ctx.logger.debug({ jid: from, device: decoded.device }, 'ignoring identity change from companion device');
+        return { action: 'skipped_companion_device', device: decoded.device };
+    }
+    const isSelfPrimary = ctx.meId && (areJidsSameUser(from, ctx.meId) || (ctx.meLid && areJidsSameUser(from, ctx.meLid)));
+    if (isSelfPrimary) {
+        ctx.logger.info({ jid: from }, 'self primary identity changed');
+        return { action: 'skipped_self_primary' };
+    }
+    if (ctx.debounceCache.get(from)) {
+        ctx.logger.debug({ jid: from }, 'skipping identity assert (debounced)');
+        return { action: 'debounced' };
+    }
+    ctx.debounceCache.set(from, true);
+    const isOfflineNotification = !isStringNullOrEmpty(node.attrs.offline);
+    const hasExistingSession = await ctx.validateSession(from);
+    if (!hasExistingSession.exists) {
+        ctx.logger.debug({ jid: from }, 'no old session, skipping session refresh');
+        return { action: 'skipped_no_session' };
+    }
+    ctx.logger.debug({ jid: from }, 'old session exists, will refresh session');
+    if (isOfflineNotification) {
+        ctx.logger.debug({ jid: from }, 'skipping session refresh during offline processing');
+        return { action: 'skipped_offline' };
+    }
+    ctx.onBeforeSessionRefresh?.(from);
+    try {
+        await ctx.assertSessions([from], true);
+        return { action: 'session_refreshed' };
+    }
+    catch (error) {
+        ctx.logger.warn({ error, jid: from }, 'failed to assert sessions after identity change');
+        return { action: 'session_refresh_failed', error };
+    }
+}
+//# sourceMappingURL=identity-change-handler.js.map

package/lib/Utils/identity-change-handler.js.map

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

package/lib/Utils/index.d.ts

@@ -0,0 +1,27 @@
+export * from './generics.js';
+export * from './decode-wa-message.js';
+export * from './messages.js';
+export * from './messages-media.js';
+export * from './validate-connection.js';
+export * from './crypto.js';
+export * from './signal.js';
+export * from './noise-handler.js';
+export * from './history.js';
+export * from './chat-utils.js';
+export * from './lt-hash.js';
+export * from './auth-utils.js';
+export * from './use-multi-file-auth-state.js';
+export * from './link-preview.js';
+export * from './event-buffer.js';
+export * from './process-message.js';
+export * from './message-retry-manager.js';
+export * from './browser-utils.js';
+export * from './companion-reg-client-utils.js';
+export * from './identity-change-handler.js';
+export * from './stanza-ack.js';
+export * from './interactive-messages.js';
+export * from './message-builder.js';
+export * from './call-helpers.js';
+export * from './sources-menu.js';
+export * from './status-helper.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/Utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,qBAAqB,CAAA;AACnC,cAAc,YAAY,CAAA;AAC1B,cAAc,kBAAkB,CAAA;AAChC,cAAc,uBAAuB,CAAA;AACrC,cAAc,UAAU,CAAA;AACxB,cAAc,UAAU,CAAA;AACxB,cAAc,iBAAiB,CAAA;AAC/B,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,6BAA6B,CAAA;AAC3C,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,mBAAmB,CAAA;AACjC,cAAc,yBAAyB,CAAA;AACvC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,8BAA8B,CAAA;AAC5C,cAAc,2BAA2B,CAAA;AACzC,cAAc,cAAc,CAAA;AAC5B,cAAc,wBAAwB,CAAA;AACtC,cAAc,mBAAmB,CAAA;AACjC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,iBAAiB,CAAA"}

package/lib/Utils/index.js

@@ -0,0 +1,27 @@
+export * from './generics.js';
+export * from './decode-wa-message.js';
+export * from './messages.js';
+export * from './messages-media.js';
+export * from './validate-connection.js';
+export * from './crypto.js';
+export * from './signal.js';
+export * from './noise-handler.js';
+export * from './history.js';
+export * from './chat-utils.js';
+export * from './lt-hash.js';
+export * from './auth-utils.js';
+export * from './use-multi-file-auth-state.js';
+export * from './link-preview.js';
+export * from './event-buffer.js';
+export * from './process-message.js';
+export * from './message-retry-manager.js';
+export * from './browser-utils.js';
+export * from './companion-reg-client-utils.js';
+export * from './identity-change-handler.js';
+export * from './stanza-ack.js';
+export * from './interactive-messages.js';
+export * from './message-builder.js';
+export * from './call-helpers.js';
+export * from './sources-menu.js';
+export * from './status-helper.js';
+//# sourceMappingURL=index.js.map

package/lib/Utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/Utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,qBAAqB,CAAA;AACnC,cAAc,YAAY,CAAA;AAC1B,cAAc,kBAAkB,CAAA;AAChC,cAAc,uBAAuB,CAAA;AACrC,cAAc,UAAU,CAAA;AACxB,cAAc,UAAU,CAAA;AACxB,cAAc,iBAAiB,CAAA;AAC/B,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,6BAA6B,CAAA;AAC3C,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,mBAAmB,CAAA;AACjC,cAAc,yBAAyB,CAAA;AACvC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,8BAA8B,CAAA;AAC5C,cAAc,2BAA2B,CAAA;AACzC,cAAc,cAAc,CAAA;AAC5B,cAAc,wBAAwB,CAAA;AACtC,cAAc,mBAAmB,CAAA;AACjC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,iBAAiB,CAAA"}

package/lib/Utils/interactive-messages.d.ts

@@ -0,0 +1,120 @@
+import type { WAMessage } from '../Types/index.js';
+import type makeWASocket from '../Socket/index.js';
+import type { WAMediaUpload } from '../Types/Message.js';
+type WASocket = ReturnType<typeof makeWASocket>;
+/** Uma linha dentro de uma seção de lista (`single_select`) */
+export type ListRow = {
+    title: string;
+    description?: string;
+    id: string;
+};
+/** Uma seção de lista — pode ter várias, cada uma com seu próprio título */
+export type ListSection = {
+    title?: string;
+    rows: ListRow[];
+};
+/** Parâmetros de um botão de WhatsApp Flow — ver `InteractiveButton.flow` */
+export type FlowButtonOptions = {
+    flowId: string;
+    /** token que identifica essa sessão de flow pro seu backend — se não passar, gera um aleatório */
+    flowToken?: string;
+    action?: 'navigate' | 'data_exchange';
+    /** obrigatório se action for 'navigate' (padrão) */
+    screen?: string;
+    /** dados iniciais pra tela do flow, se action for 'navigate' */
+    data?: Record<string, unknown>;
+    mode?: 'draft' | 'published';
+    /** versão do protocolo do flow — hoje é sempre '3' */
+    version?: string;
+};
+/**
+ * Um botão de mensagem interativa. Além do quick reply e do link (já
+ * existentes), dá pra usar os outros tipos nativos do WhatsApp — mas
+ * nem todos têm o mesmo nível de confiança:
+ *
+ * ✅ confirmados em uso real (Baileys/comunidade já documentou):
+ *    url, call, copyCode, list (single_select), callPermissionRequest
+ * 🔵 nome/parâmetros seguem a documentação OFICIAL da Cloud API da Meta
+ *    (bem provável que seja o mesmo formato no native_flow pessoal, mas
+ *    não é 100% confirmado nessa forma específica — teste antes):
+ *    flow
+ * ⚠️ existem no protocolo mas com pouca documentação pública — teste
+ *    antes de confiar em produção, o WhatsApp pode mudar o formato
+ *    sem aviso:
+ *    reminderId, cancelReminderId, address, location, catalog, product (mpm)
+ * 🔧 não é um botão nativo do WhatsApp — é só um quick_reply com um id
+ *    combinado, quem interpreta o clique é o SEU código (ex: seu bot
+ *    escuta esse id e daí limpa o histórico local que ele guarda):
+ *    clearChat
+ */
+export type InteractiveButton = {
+    text: string;
+    id?: string;
+    url?: string;
+    /** número pra ligar, só dígitos com DDI. Ex: '5511999999999' */
+    call?: string;
+    /** texto/código que o usuário copia com 1 toque (cupom, OTP, PIX copia-e-cola etc.) */
+    copyCode?: string;
+    /** cria um lembrete nativo do WhatsApp associado a esse id */
+    reminderId?: string;
+    /** cancela o lembrete criado com esse id */
+    cancelReminderId?: string;
+    /** pede o endereço salvo do usuário (⚠️ pouco documentado) */
+    address?: boolean;
+    /** pede a localização atual do usuário (⚠️ pouco documentado) */
+    location?: boolean;
+    /** abre o catálogo do WhatsApp Business vinculado ao número (⚠️ pouco documentado) */
+    catalog?: boolean;
+    /** não é nativo — só um quick_reply com id fixo, pra você tratar no seu handler */
+    clearChat?: boolean;
+    /** abre uma lista de opções (`single_select`) — ver `ListSection`/`ListRow` */
+    list?: {
+        title?: string;
+        sections: ListSection[];
+    };
+    /** mostra 1 produto do catálogo vinculado ao número (⚠️ pouco documentado — adicione um botão por produto pra mostrar vários) */
+    product?: {
+        catalogId: string;
+        productRetailerId: string;
+    };
+    /** pede permissão explícita do contato pra você poder ligar pra ele */
+    callPermissionRequest?: boolean;
+    /** abre um WhatsApp Flow (formulário nativo) — ver `FlowButtonOptions` */
+    flow?: FlowButtonOptions;
+};
+/**
+ * Um card do carrossel precisa ter EXATAMENTE uma mídia de capa: imagem OU vídeo.
+ * O protocolo do WhatsApp aceita os dois no header do card (igual o header do
+ * ButtonsMessage), então isso não é gambiarra — o antigo helper só não expunha
+ * essa opção.
+ */
+export type CarouselCard = {
+    title?: string;
+    body?: string;
+    buttons: InteractiveButton[];
+} & ({
+    image: WAMediaUpload;
+    video?: never;
+} | {
+    video: WAMediaUpload;
+    image?: never;
+});
+export type CarouselMessageOptions = {
+    text: string;
+    footer?: string;
+    cards: CarouselCard[];
+};
+export type ButtonMessageOptions = {
+    text: string;
+    footer?: string;
+    title?: string;
+    buttons: InteractiveButton[];
+};
+export declare function toNativeFlowButton(button: InteractiveButton): {
+    name: string;
+    buttonParamsJson: string;
+};
+export declare function sendButtonMessage(sock: WASocket, jid: string, options: ButtonMessageOptions, quoted?: WAMessage): Promise<WAMessage | undefined>;
+export declare function sendCarouselMessage(sock: WASocket, jid: string, options: CarouselMessageOptions, quoted?: WAMessage): Promise<WAMessage | undefined>;
+export {};
+//# sourceMappingURL=interactive-messages.d.ts.map

package/lib/Utils/interactive-messages.d.ts.map

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

package/lib/Utils/interactive-messages.js

@@ -0,0 +1,165 @@
+import { randomBytes } from 'crypto';
+import { prepareWAMessageMedia } from './messages.js';
+export function toNativeFlowButton(button) {
+    if (button.url) {
+        return {
+            name: 'cta_url',
+            buttonParamsJson: JSON.stringify({
+                display_text: button.text,
+                url: button.url,
+                merchant_url: button.url
+            })
+        };
+    }
+    if (button.call) {
+        return {
+            name: 'cta_call',
+            buttonParamsJson: JSON.stringify({
+                display_text: button.text,
+                phone_number: button.call
+            })
+        };
+    }
+    if (button.copyCode) {
+        return {
+            name: 'cta_copy',
+            buttonParamsJson: JSON.stringify({
+                display_text: button.text,
+                copy_code: button.copyCode,
+                id: button.id || button.text
+            })
+        };
+    }
+    if (button.reminderId) {
+        return {
+            name: 'cta_reminder',
+            buttonParamsJson: JSON.stringify({
+                display_text: button.text,
+                id: button.reminderId
+            })
+        };
+    }
+    if (button.cancelReminderId) {
+        return {
+            name: 'cta_cancel_reminder',
+            buttonParamsJson: JSON.stringify({
+                display_text: button.text,
+                id: button.cancelReminderId
+            })
+        };
+    }
+    if (button.address) {
+        return {
+            name: 'address_message',
+            buttonParamsJson: JSON.stringify({ display_text: button.text })
+        };
+    }
+    if (button.location) {
+        return {
+            name: 'send_location',
+            buttonParamsJson: JSON.stringify({ display_text: button.text })
+        };
+    }
+    if (button.catalog) {
+        return {
+            name: 'cta_catalog',
+            buttonParamsJson: JSON.stringify({ display_text: button.text })
+        };
+    }
+    if (button.list) {
+        return {
+            name: 'single_select',
+            buttonParamsJson: JSON.stringify({
+                title: button.list.title || button.text,
+                sections: button.list.sections
+            })
+        };
+    }
+    if (button.product) {
+        return {
+            name: 'mpm',
+            buttonParamsJson: JSON.stringify({
+                catalog_id: button.product.catalogId,
+                product_retailer_id: button.product.productRetailerId
+            })
+        };
+    }
+    if (button.callPermissionRequest) {
+        return {
+            name: 'call_permission_request',
+            buttonParamsJson: JSON.stringify({ display_text: button.text })
+        };
+    }
+    if (button.flow) {
+        const f = button.flow;
+        const isNavigate = (f.action || 'navigate') === 'navigate';
+        return {
+            name: 'flow',
+            buttonParamsJson: JSON.stringify({
+                flow_message_version: f.version || '3',
+                flow_token: f.flowToken || randomBytes(16).toString('hex'),
+                flow_id: f.flowId,
+                flow_cta: button.text,
+                flow_action: f.action || 'navigate',
+                ...(f.mode ? { mode: f.mode } : {}),
+                ...(isNavigate ? { flow_action_payload: { screen: f.screen, data: f.data } } : {})
+            })
+        };
+    }
+    // clearChat não é nativo do WhatsApp: vira um quick_reply com id fixo
+    // pro seu handler reconhecer. Se `id` não vier, usa 'clear_chat' padrão.
+    if (button.clearChat) {
+        return {
+            name: 'quick_reply',
+            buttonParamsJson: JSON.stringify({
+                display_text: button.text,
+                id: button.id || 'clear_chat'
+            })
+        };
+    }
+    return {
+        name: 'quick_reply',
+        buttonParamsJson: JSON.stringify({
+            display_text: button.text,
+            id: button.id || button.text
+        })
+    };
+}
+export async function sendButtonMessage(sock, jid, options, quoted) {
+    return sock.sendMessage(jid, {
+        interactiveMessage: {
+            title: options.title,
+            body: options.text,
+            footer: options.footer,
+            buttons: options.buttons.map(toNativeFlowButton)
+        }
+    }, { quoted });
+}
+export async function sendCarouselMessage(sock, jid, options, quoted) {
+    if (options.cards.length < 2 || options.cards.length > 10) {
+        throw new Error('O carrossel precisa ter entre 2 e 10 cards (exigencia do WhatsApp)');
+    }
+    const cards = await Promise.all(options.cards.map(async (card) => {
+        const isVideo = 'video' in card && !!card.video;
+        const { imageMessage, videoMessage } = await prepareWAMessageMedia((isVideo ? { video: card.video } : { image: card.image }), { upload: sock.waUploadToServer });
+        return {
+            header: {
+                title: card.title,
+                hasMediaAttachment: true,
+                ...(isVideo ? { videoMessage } : { imageMessage })
+            },
+            body: { text: card.body || '' },
+            nativeFlowMessage: {
+                buttons: card.buttons.map(toNativeFlowButton)
+            }
+        };
+    }));
+    return sock.sendMessage(jid, {
+        interactiveMessage: {
+            body: options.text,
+            footer: options.footer,
+            carouselMessage: { cards }
+        }
+    }, { quoted });
+}
+//# sourceMappingURL=interactive-messages.js.map

package/lib/Utils/interactive-messages.js.map

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

package/lib/Utils/link-preview.d.ts

@@ -0,0 +1,21 @@
+import type { WAMediaUploadFunction, WAUrlInfo } from '../Types/index.js';
+import type { ILogger } from './logger.js';
+export type URLGenerationOptions = {
+    thumbnailWidth: number;
+    fetchOpts: {
+        /** Timeout in ms */
+        timeout: number;
+        proxyUrl?: string;
+        headers?: HeadersInit;
+    };
+    uploadImage?: WAMediaUploadFunction;
+    logger?: ILogger;
+};
+/**
+ * Given a piece of text, checks for any URL present, generates link preview for the same and returns it
+ * Return undefined if the fetch failed or no URL was found
+ * @param text first matched URL in text
+ * @returns the URL info required to generate link preview
+ */
+export declare const getUrlInfo: (text: string, opts?: URLGenerationOptions) => Promise<WAUrlInfo | undefined>;
+//# sourceMappingURL=link-preview.d.ts.map

package/lib/Utils/link-preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-preview.d.ts","sourceRoot":"","sources":["../../src/Utils/link-preview.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAChE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAA;AAavC,MAAM,MAAM,oBAAoB,GAAG;IAClC,cAAc,EAAE,MAAM,CAAA;IACtB,SAAS,EAAE;QACV,oBAAoB;QACpB,OAAO,EAAE,MAAM,CAAA;QACf,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,OAAO,CAAC,EAAE,WAAW,CAAA;KACrB,CAAA;IACD,WAAW,CAAC,EAAE,qBAAqB,CAAA;IACnC,MAAM,CAAC,EAAE,OAAO,CAAA;CAChB,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,UAAU,GACtB,MAAM,MAAM,EACZ,OAAM,oBAGL,KACC,OAAO,CAAC,SAAS,GAAG,SAAS,CAwE/B,CAAA"}