@nanazx/baileys 0.0.0-stage → 1.0.1

package/lib/Utils/lt-hash.js

@@ -0,0 +1,8 @@
+import { LTHashAntiTampering } from 'whatsapp-rust-bridge';
+/**
+ * LT Hash is a summation based hash algorithm that maintains the integrity of a piece of data
+ * over a series of mutations. You can add/remove mutations and it'll return a hash equal to
+ * if the same series of mutations was made sequentially.
+ */
+export const LT_HASH_ANTI_TAMPERING = new LTHashAntiTampering();
+//# sourceMappingURL=lt-hash.js.map

package/lib/Utils/lt-hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lt-hash.js","sourceRoot":"","sources":["../../src/Utils/lt-hash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAE1D;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,mBAAmB,EAAE,CAAA"}

package/lib/Utils/make-mutex.d.ts

@@ -0,0 +1,9 @@
+export declare const makeMutex: () => {
+    mutex<T>(code: () => Promise<T> | T): Promise<T>;
+};
+export type Mutex = ReturnType<typeof makeMutex>;
+export declare const makeKeyedMutex: () => {
+    mutex<T>(key: string, task: () => Promise<T> | T): Promise<T>;
+};
+export type KeyedMutex = ReturnType<typeof makeKeyedMutex>;
+//# sourceMappingURL=make-mutex.d.ts.map

package/lib/Utils/make-mutex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"make-mutex.d.ts","sourceRoot":"","sources":["../../src/Utils/make-mutex.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,SAAS;UAId,CAAC,QAAQ,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CAIjD,CAAA;AAED,MAAM,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,SAAS,CAAC,CAAA;AAEhD,eAAO,MAAM,cAAc;UAIb,CAAC,OAAO,MAAM,QAAQ,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CAqBpE,CAAA;AAED,MAAM,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAA"}

package/lib/Utils/make-mutex.js

@@ -0,0 +1,33 @@
+import { Mutex as AsyncMutex } from 'async-mutex';
+export const makeMutex = () => {
+    const mutex = new AsyncMutex();
+    return {
+        mutex(code) {
+            return mutex.runExclusive(code);
+        }
+    };
+};
+export const makeKeyedMutex = () => {
+    const map = new Map();
+    return {
+        async mutex(key, task) {
+            let entry = map.get(key);
+            if (!entry) {
+                entry = { mutex: new AsyncMutex(), refCount: 0 };
+                map.set(key, entry);
+            }
+            entry.refCount++;
+            try {
+                return await entry.mutex.runExclusive(task);
+            }
+            finally {
+                entry.refCount--;
+                // only delete it if this is still the current entry
+                if (entry.refCount === 0 && map.get(key) === entry) {
+                    map.delete(key);
+                }
+            }
+        }
+    };
+};
+//# sourceMappingURL=make-mutex.js.map

package/lib/Utils/make-mutex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"make-mutex.js","sourceRoot":"","sources":["../../src/Utils/make-mutex.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,IAAI,UAAU,EAAE,MAAM,aAAa,CAAA;AAEjD,MAAM,CAAC,MAAM,SAAS,GAAG,GAAG,EAAE;IAC7B,MAAM,KAAK,GAAG,IAAI,UAAU,EAAE,CAAA;IAE9B,OAAO;QACN,KAAK,CAAI,IAA0B;YAClC,OAAO,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,CAAA;QAChC,CAAC;KACD,CAAA;AACF,CAAC,CAAA;AAID,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,EAAE;IAClC,MAAM,GAAG,GAAG,IAAI,GAAG,EAAmD,CAAA;IAEtE,OAAO;QACN,KAAK,CAAC,KAAK,CAAI,GAAW,EAAE,IAA0B;YACrD,IAAI,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;YAExB,IAAI,CAAC,KAAK,EAAE,CAAC;gBACZ,KAAK,GAAG,EAAE,KAAK,EAAE,IAAI,UAAU,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAA;gBAChD,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;YACpB,CAAC;YAED,KAAK,CAAC,QAAQ,EAAE,CAAA;YAEhB,IAAI,CAAC;gBACJ,OAAO,MAAM,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,CAAA;YAC5C,CAAC;oBAAS,CAAC;gBACV,KAAK,CAAC,QAAQ,EAAE,CAAA;gBAChB,oDAAoD;gBACpD,IAAI,KAAK,CAAC,QAAQ,KAAK,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,KAAK,EAAE,CAAC;oBACpD,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;gBAChB,CAAC;YACF,CAAC;QACF,CAAC;KACD,CAAA;AACF,CAAC,CAAA"}

package/lib/Utils/message-composer.js

@@ -0,0 +1,241 @@
+import { randomBytes, randomUUID } from 'crypto';
+import { generateMessageIDV2 } from './generics.js';
+
+export const JS_KEYWORDS = new Set([
+    'import','export','from','default','as','const','let','var','function','class','extends',
+    'new','return','if','else','for','while','do','switch','case','break','continue','try',
+    'catch','finally','throw','async','await','yield','typeof','instanceof','in','of','delete',
+    'void','true','false','null','undefined','NaN','Infinity','this','super','static','get',
+    'set','debugger','with'
+]);
+
+export const PYTHON_KEYWORDS = new Set([
+    'import','from','as','def','class','return','if','elif','else','for','while','break',
+    'continue','try','except','finally','raise','with','yield','lambda','pass','del','global',
+    'nonlocal','assert','True','False','None','and','or','not','in','is','async','await',
+    'self','print'
+]);
+
+export const LANGUAGE_KEYWORDS = {
+    javascript: JS_KEYWORDS, typescript: JS_KEYWORDS, js: JS_KEYWORDS, ts: JS_KEYWORDS,
+    python: PYTHON_KEYWORDS, py: PYTHON_KEYWORDS
+};
+
+export const CodeHighlightType = { DEFAULT: 0, KEYWORD: 1, METHOD: 2, STRING: 3, NUMBER: 4, COMMENT: 5 };
+export const RichSubMessageType = { UNKNOWN: 0, GRID_IMAGE: 1, TEXT: 2, INLINE_IMAGE: 3, TABLE: 4, CODE: 5, DYNAMIC: 6, MAP: 7, LATEX: 8, CONTENT_ITEMS: 9 };
+
+export const tokenizeCode = (codeStr, language = 'javascript') => {
+    const keywords = LANGUAGE_KEYWORDS[language] || JS_KEYWORDS;
+    const blocks = [];
+    const lines = codeStr.split('\n');
+    for (let li = 0; li < lines.length; li++) {
+        const line = lines[li];
+        const isLast = li === lines.length - 1;
+        const nl = isLast ? '' : '\n';
+        if (!line.trim()) { blocks.push({ highlightType: CodeHighlightType.DEFAULT, codeContent: line + nl }); continue; }
+        if (line.trim().startsWith('//') || line.trim().startsWith('#')) {
+            blocks.push({ highlightType: CodeHighlightType.COMMENT, codeContent: line + nl }); continue;
+        }
+        const regex = /(\/\/.*$|#.*$)|([\"'`](?:[^\"'`\\]|\\.)*[\"'`])|(\b\d+(?:\.\d+)?\b)|(\b[a-zA-Z_$][\w$]*\b)|([^\s\w$\"'`]+)|(\s+)/g;
+        let match;
+        const tokens = [];
+        while ((match = regex.exec(line)) !== null) {
+            const val = match[0];
+            if (match[1]) { tokens.push({ highlightType: CodeHighlightType.COMMENT, codeContent: val }); }
+            else if (match[2]) { tokens.push({ highlightType: CodeHighlightType.STRING, codeContent: val }); }
+            else if (match[3]) { tokens.push({ highlightType: CodeHighlightType.NUMBER, codeContent: val }); }
+            else if (match[4]) {
+                if (keywords.has(val)) { tokens.push({ highlightType: CodeHighlightType.KEYWORD, codeContent: val }); }
+                else {
+                    const after = line.slice(regex.lastIndex).trimStart();
+                    tokens.push({ highlightType: after.startsWith('(') ? CodeHighlightType.METHOD : CodeHighlightType.DEFAULT, codeContent: val });
+                }
+            } else { tokens.push({ highlightType: CodeHighlightType.DEFAULT, codeContent: val }); }
+        }
+        if (!tokens.length) { blocks.push({ highlightType: CodeHighlightType.DEFAULT, codeContent: line + nl }); continue; }
+        const merged = [];
+        for (const t of tokens) {
+            const prev = merged.length > 0 ? merged[merged.length - 1] : undefined;
+            if (prev && prev.highlightType === t.highlightType) { prev.codeContent += t.codeContent; }
+            else { merged.push({ ...t }); }
+        }
+        if (merged.length > 0) merged[merged.length - 1].codeContent += nl;
+        blocks.push(...merged);
+    }
+    return blocks;
+};
+
+export const buildRichContextInfo = (quoted, options = {}) => {
+    const ctxInfo = {
+        forwardingScore: 1,
+        isForwarded: true,
+        forwardedAiBotMessageInfo: { botJid: options.botJid ? options.botJid : '867051314767696@bot' },
+        forwardOrigin: 4,
+        ...(options.mentions ? { mentionedJid: options.mentions } : {})
+    };
+    if (quoted?.key) {
+        ctxInfo.stanzaId = quoted.key.id;
+        ctxInfo.participant = quoted.key.participant || quoted.sender || quoted.key.remoteJid;
+        ctxInfo.quotedMessage = quoted.message;
+    }
+    return ctxInfo;
+};
+
+export const buildBotForwardedMessage = (submessages, contextInfo, unifiedResponse) => {
+    const richResponse = { messageType: 1, submessages, contextInfo };
+    if (unifiedResponse) richResponse.unifiedResponse = unifiedResponse;
+    return { botForwardedMessage: { message: { richResponseMessage: richResponse } } };
+};
+
+export const generateTableContent = (title, headers, rows, quoted, options = {}) => {
+    const { footer, headerText } = options;
+    const tableRows = [{ items: headers, isHeading: true }, ...rows.map(row => ({ items: row.map(String) }))];
+    const submessages = [];
+    if (headerText) submessages.push({ messageType: 2, messageText: headerText });
+    submessages.push({ messageType: 4, tableMetadata: { title, rows: tableRows } });
+    if (footer) submessages.push({ messageType: 2, messageText: footer });
+    return { message: buildBotForwardedMessage(submessages, buildRichContextInfo(quoted)), messageId: generateMessageIDV2() };
+};
+
+export const generateListContent = (title, items, quoted, options = {}) => {
+    const { footer, headerText } = options;
+    const tableRows = items.map(item => ({ items: Array.isArray(item) ? item.map(String) : [String(item)] }));
+    const submessages = [];
+    if (headerText) submessages.push({ messageType: 2, messageText: headerText });
+    submessages.push({ messageType: 4, tableMetadata: { title, rows: tableRows } });
+    if (footer) submessages.push({ messageType: 2, messageText: footer });
+    return { message: buildBotForwardedMessage(submessages, buildRichContextInfo(quoted)), messageId: generateMessageIDV2() };
+};
+
+export const generateCodeBlockContent = (code, quoted, options = {}) => {
+    const { title, footer, language = 'javascript' } = options;
+    const submessages = [];
+    if (title) submessages.push({ messageType: 2, messageText: title });
+    submessages.push({ messageType: 5, codeMetadata: { codeLanguage: language, codeBlocks: tokenizeCode(code, language) } });
+    if (footer) submessages.push({ messageType: 2, messageText: footer });
+    return { message: buildBotForwardedMessage(submessages, buildRichContextInfo(quoted)), messageId: generateMessageIDV2() };
+};
+
+export const generateLatexContent = (quoted, options) => {
+    const { text, expressions, headerText, footer } = options;
+    const submessages = [];
+    if (headerText) submessages.push({ messageType: 2, messageText: headerText });
+    const latexExpressions = expressions.map(expr => {
+        const entry = { latexExpression: expr.latexExpression, url: expr.url, width: expr.width, height: expr.height };
+        if (expr.fontHeight !== undefined) entry.fontHeight = expr.fontHeight;
+        if (expr.imageTopPadding !== undefined) entry.imageTopPadding = expr.imageTopPadding;
+        if (expr.imageLeadingPadding !== undefined) entry.imageLeadingPadding = expr.imageLeadingPadding;
+        if (expr.imageBottomPadding !== undefined) entry.imageBottomPadding = expr.imageBottomPadding;
+        if (expr.imageTrailingPadding !== undefined) entry.imageTrailingPadding = expr.imageTrailingPadding;
+        return entry;
+    });
+    submessages.push({ messageType: 8, latexMetadata: { text: text || '', expressions: latexExpressions } });
+    if (footer) submessages.push({ messageType: 2, messageText: footer });
+    return { message: buildBotForwardedMessage(submessages, buildRichContextInfo(quoted)), messageId: generateMessageIDV2() };
+};
+
+export const generateLatexImageContent = async (quoted, options, uploadFn, renderLatexToPng) => {
+    const { text, expressions, headerText, footer } = options;
+    const submessages = [];
+    if (headerText) submessages.push({ messageType: 2, messageText: headerText });
+    const latexExpressions = await Promise.all(expressions.map(async expr => {
+        const { buffer, width, height } = await renderLatexToPng(expr.latexExpression);
+        const uploadResult = await uploadFn(buffer, 'image');
+        return { latexExpression: expr.latexExpression, url: uploadResult.url || uploadResult.directPath, width, height };
+    }));
+    submessages.push({ messageType: 8, latexMetadata: { text: text || '', expressions: latexExpressions } });
+    if (footer) submessages.push({ messageType: 2, messageText: footer });
+    return { message: buildBotForwardedMessage(submessages, buildRichContextInfo(quoted)), messageId: generateMessageIDV2() };
+};
+
+export const generateLatexInlineImageContent = async (quoted, options, uploadFn, renderLatexToPng) => {
+    const { text, expressions, headerText, footer } = options;
+    const submessages = [];
+    if (headerText) submessages.push({ messageType: 2, messageText: headerText });
+    if (text) submessages.push({ messageType: 2, messageText: text });
+    for (const expr of expressions) {
+        const { buffer, width, height } = await renderLatexToPng(expr.latexExpression);
+        const uploadResult = await uploadFn(buffer, 'image');
+        const imageUrl = uploadResult.url || uploadResult.directPath;
+        submessages.push({
+            messageType: 3,
+            imageMetadata: {
+                imageUrl: { imagePreviewUrl: imageUrl, imageHighResUrl: imageUrl },
+                imageText: expr.latexExpression, alignment: 2
+            }
+        });
+    }
+    if (footer) submessages.push({ messageType: 2, messageText: footer });
+    return { message: buildBotForwardedMessage(submessages, buildRichContextInfo(quoted)), messageId: generateMessageIDV2() };
+};
+
+export const captureUnifiedResponse = msg => {
+    const botFwd = msg?.botForwardedMessage?.message;
+    if (!botFwd) return null;
+    const rich = botFwd.richResponseMessage;
+    if (!rich?.unifiedResponse?.data) return null;
+    return { unifiedResponse: { data: rich.unifiedResponse.data }, submessages: rich.submessages || [], contextInfo: rich.contextInfo || {} };
+};
+
+export const generateUnifiedResponseContent = (quoted, captured) => {
+    return { message: buildBotForwardedMessage(captured.submessages, buildRichContextInfo(quoted), captured.unifiedResponse), messageId: generateMessageIDV2() };
+};
+
+export const generateRichMessageContent = (submessages, quoted, options) => {
+    return { message: buildBotForwardedMessage(submessages, buildRichContextInfo(quoted, options)), messageId: generateMessageIDV2() };
+};
+
+export const generateRichMenuContent = (content = {}, quoted, options = {}) => {
+    const header = content?.header;
+    const body = content?.body;
+    const footer = content?.footer;
+    const sections = [];
+    let messageContextInfo;
+    const randomToolId = () => randomBytes(8).toString('hex');
+    if (header) {
+        const { disclaimer = false, disclaimerText = ' ', image = { inline: false }, title = '' } = header ?? {};
+        if (disclaimer) messageContextInfo = { botMetadata: { messageDisclaimerText: disclaimerText } };
+        if (title) sections.push({ __typename: 'GenAIUnifiedResponseSection', view_model: { __typename: 'GenAISingleLayoutViewModel', primitive: { __typename: 'FOATextPrimitive', text: '# ' + title } } });
+        if (image?.url) {
+            if (image?.inline) {
+                sections.push({ __typename: 'GenAIUnifiedResponseSection', view_model: { __typename: 'GenAISingleLayoutViewModel', primitive: { __typename: 'GenAIMarkdownTextUXPrimitive', text: '{{header}}.{{/header}}', inline_entities: [{ __typename: 'GenAITextInlineEntity', key: 'header', metadata: { __typename: 'GenAILatexItem', latex_expression: '.', font_height: 24, padding: 4, latex_image: { __typename: 'GenAIMediaItem', mime_type: image.mime_type || 'image/png', url: image.url, url_fallback: image.url, width: image.width || 500, height: image.height || 500, expiration_timestamp_ms: Date.now() + 86400000 } } }] } } });
+            } else {
+                sections.push({ __typename: 'GenAIUnifiedResponseSection', view_model: { __typename: 'GenAISingleLayoutViewModel', primitive: { __typename: 'GenAIImagePrimitive', preview_image: { __typename: 'GenAIMediaItem', mime_type: image.mime_type || 'image/png', url: image.url }, full_image: { __typename: 'GenAIMediaItem', mime_type: image.mime_type || 'image/png', url: image.url } } } });
+            }
+        }
+    }
+    if (body) {
+        const { cards = null, buttons = null, title = '', toast = '', carousel = false, row = false } = body ?? {};
+        if (carousel || row) {
+            if (cards?.length >= 1) {
+                sections.push({ __typename: 'GenAIUnifiedResponseSection', view_model: { primitives: cards.map(card => ({ __typename: 'GenAI3PExtWidgetPrimitive', header: { __typename: 'GenAI3PExtWidgetStandardHeader', title: card?.title || '' }, body: { __typename: 'GenAI3PExtCalendarEventList', ctas: (card?.buttons || []).map(text => ({ label: text, state: 'PENDING', kind: 'OTHER', tool_call_id: randomToolId(), toast: { label: card?.toast || '', __typename: 'GenAI3PExtWidgetToast' }, __typename: 'GenAI3PExtWidgetCTA' })), sections: [] } })), __typename: carousel ? 'GenAIHScrollLayoutViewModel' : 'GenAIActionRowLayoutViewModel' } });
+            }
+        } else if (buttons?.length) {
+            sections.push({ __typename: 'GenAIUnifiedResponseSection', view_model: { primitive: { __typename: 'GenAI3PExtWidgetPrimitive', header: { __typename: 'GenAI3PExtWidgetStandardHeader', title: title || '' }, body: { __typename: 'GenAI3PExtCalendarEventList', ctas: buttons.map(text => ({ label: text, state: 'PENDING', kind: 'OTHER', tool_call_id: randomToolId(), toast: { label: toast, __typename: 'GenAI3PExtWidgetToast' }, __typename: 'GenAI3PExtWidgetCTA' })), sections: [] } }, __typename: 'GenAISingleLayoutViewModel' } });
+        }
+    }
+    if (footer) {
+        const { text = '', url = '', image = {} } = footer ?? {};
+        const img = [];
+        if (image?.url) {
+            img.push({ __typename: 'GenAIMarkdownTextUXPrimitive', text: '{{header}}.{{/header}}', inline_entities: [{ __typename: 'GenAITextInlineEntity', key: 'header', metadata: { __typename: 'GenAILatexItem', latex_expression: '.', font_height: 24, padding: -5, latex_image: { __typename: 'GenAIMediaItem', mime_type: image.mime_type || 'image/png', url: image.url, url_fallback: image.url, width: image.width || 100, height: image.height || 100, expiration_timestamp_ms: Date.now() + 86400000 } } }] });
+        }
+        sections.push({ view_model: { primitives: [{ cta_text: text || '', cta_type: 'OPEN_URL', cta_url: url || '', __typename: 'GenAIFooterActionPrimitive' }, ...img], __typename: 'GenAIActionRowLayoutViewModel' } });
+    }
+    const ctxInfo = buildRichContextInfo(quoted, options);
+    if (content?.contextInfo) Object.assign(ctxInfo, content.contextInfo);
+    const unifiedResponse = { data: Buffer.from(JSON.stringify({ sections })).toString('base64') };
+    return { message: { ...(messageContextInfo ? { messageContextInfo } : {}), ...buildBotForwardedMessage(undefined, ctxInfo, unifiedResponse) }, messageId: generateMessageIDV2() };
+};
+
+export const generateHtmlContent = (html = '', quoted, options = {}) => {
+    const ctxInfo = buildRichContextInfo(quoted, options);
+    const unifiedResponse = {
+        data: Buffer.from(JSON.stringify({
+            __typename: 'GenAIUnifiedResponse',
+            response_id: randomUUID(),
+            sections: [{ __typename: 'GenAIUnifiedResponseSection', view_model: { __typename: 'GenAISingleLayoutViewModel', primitive: { __typename: 'FOAHtmlPrimitiveDemoDONOTUSE', trusted_sources: [], payload: String(html).trim() } } }]
+        })).toString('base64')
+    };
+    return { message: buildBotForwardedMessage(undefined, ctxInfo, unifiedResponse), messageId: generateMessageIDV2() };
+};

package/lib/Utils/message-inspect.js

@@ -0,0 +1,180 @@
+/**
+ * message-inspect.js — Extended message inspection utilities (from Baron Baileys).
+ * Contains NEW functions not present in the original messages.js.
+ * Functions that already exist in messages.js are NOT duplicated here.
+ */
+
+import { proto } from '../../WAProto/index.js';
+import { jidDecode, isLidUser, isHostedLidUser, isPnUser, isHostedPnUser } from '../WABinary/index.js';
+import { getKeyAuthor } from './generics.js';
+
+// ─── Extended normalizeMessageContent ─────────────────────────────────────────
+// Baron adds many new message types not in the original normalizeMessageContent.
+// Use this if you need the extended version that covers newer WA message types.
+
+const getFutureProofMessage = message => (
+    message.ephemeralMessage ||
+    message.viewOnceMessage ||
+    message.documentWithCaptionMessage ||
+    message.viewOnceMessageV2 ||
+    message.viewOnceMessageV2Extension ||
+    message.editedMessage ||
+    message.groupMentionedMessage ||
+    message.botInvokeMessage ||
+    message.lottieStickerMessage ||
+    message.eventCoverImage ||
+    message.statusMentionMessage ||
+    message.pollCreationOptionImageMessage ||
+    message.associatedChildMessage ||
+    message.groupStatusMentionMessage ||
+    message.pollCreationMessageV4 ||
+    message.pollCreationMessageV5 ||
+    message.statusAddYours ||
+    message.groupStatusMessage ||
+    message.limitSharingMessage ||
+    message.botTaskMessage ||
+    message.questionMessage ||
+    message.groupStatusMessageV2 ||
+    message.botForwardedMessage ||
+    message.questionReplyMessage ||
+    message.newsletterAdminProfileMessage ||
+    message.newsletterAdminProfileMessageV2 ||
+    message.newsletterAdminProfileStatusMessage ||
+    message.spoilerMessage ||
+    message.groupStatusV3Message ||
+    message.pollCreationMessageV6 ||
+    message.botPlatformRegistrationSuccessMessage ||
+    message.newsletterScheduledMessage ||
+    message.acp2SettingMessage ||
+    message.audioStickerMessage
+);
+
+import { sha256 } from './crypto.js';
+
+/**
+ * Extended version of normalizeMessageContent — covers all Baron message types.
+ * Use instead of the original when dealing with newer WA message types.
+ */
+export const normalizeMessageContentExtended = content => {
+    if (!content) return undefined;
+    for (let i = 0; i < 5; i++) {
+        const inner = getFutureProofMessage(content);
+        if (!inner) break;
+        content = inner.message;
+    }
+    return content;
+};
+
+// ─── Scheduled Messages ───────────────────────────────────────────────────────
+
+/** Check if a WebMessageInfo has a scheduled reveal time (ConditionalRevealMessage). */
+export const isScheduledMessage = msg => !!msg?.scheduledMessageMetadata?.scheduledTime;
+
+/** Get scheduled reveal time of a message as a Date, or null. */
+export const getScheduledMessageTime = msg => {
+    const t = msg?.scheduledMessageMetadata?.scheduledTime;
+    if (!t) return null;
+    return new Date(Number(t) * 1000);
+};
+
+// ─── Payment / Comment / Add-ons ─────────────────────────────────────────────
+
+/** Extract PaymentInfo from a WebMessageInfo. */
+export const getMessagePaymentInfo = msg => msg?.paymentInfo || msg?.quotedPaymentInfo || null;
+
+/** Get comment metadata from a WebMessageInfo. */
+export const getMessageCommentMetadata = msg => msg?.commentMetadata || null;
+
+/** Get all message add-ons (reactions, poll updates, pins) from a WebMessageInfo. */
+export const getMessageAddOns = msg => msg?.messageAddOns || [];
+
+// ─── Poll helpers (extended) ──────────────────────────────────────────────────
+
+/** Get the quiz correct answer from a poll creation message, if it's a quiz. */
+export const getPollCorrectAnswer = pollMsg => {
+    const poll =
+        pollMsg?.pollCreationMessage ||
+        pollMsg?.pollCreationMessageV2 ||
+        pollMsg?.pollCreationMessageV3 ||
+        pollMsg?.pollCreationMessageV5 ||
+        pollMsg?.pollCreationMessageV6;
+    if (!poll) return null;
+    const isQuiz = poll.pollType === proto.Message.PollType?.QUIZ || poll.pollType === 1;
+    return isQuiz ? poll.correctAnswer?.optionName || null : null;
+};
+
+/**
+ * Extended getAggregateVotesInPollMessage — also handles V4/V5/V6 poll messages.
+ */
+export const getAggregateVotesInPollMessageExtended = ({ message, pollUpdates }, meId) => {
+    const opts =
+        message?.pollCreationMessage?.options ||
+        message?.pollCreationMessageV2?.options ||
+        message?.pollCreationMessageV3?.options ||
+        message?.pollCreationMessageV5?.options ||
+        message?.pollCreationMessageV6?.options ||
+        message?.pollCreationMessageV4?.message?.pollCreationMessage?.options ||
+        message?.pollCreationMessageV4?.message?.pollCreationMessageV3?.options ||
+        [];
+    const voteHashMap = opts.reduce((acc, opt) => {
+        const hash = sha256(Buffer.from(opt.optionName || '')).toString();
+        acc[hash] = { name: opt.optionName || '', voters: [] };
+        return acc;
+    }, {});
+    for (const update of pollUpdates || []) {
+        const { vote } = update;
+        if (!vote) continue;
+        for (const option of vote.selectedOptions || []) {
+            const hash = option.toString();
+            if (!voteHashMap[hash]) voteHashMap[hash] = { name: 'Unknown', voters: [] };
+            voteHashMap[hash].voters.push(getKeyAuthor(update.pollUpdateMessageKey, meId));
+        }
+    }
+    return Object.values(voteHashMap);
+};
+
+// ─── Event Responses ──────────────────────────────────────────────────────────
+
+/**
+ * Aggregate all event responses in an event message.
+ * @param eventResponses array of event response updates
+ * @param meLid your LID JID
+ */
+export const getAggregateResponsesInEventMessage = ({ eventResponses }, meLid) => {
+    const responseTypes = ['GOING', 'NOT_GOING', 'MAYBE'];
+    const responseMap = {};
+    for (const type of responseTypes) responseMap[type] = { response: type, responders: [] };
+    for (const update of eventResponses || []) {
+        const { response } = update.response || {};
+        const responseType = proto.Message.EventResponseMessage.EventResponseType[response];
+        if (responseType !== 'UNKNOWN' && responseMap[responseType]) {
+            responseMap[responseType].responders.push(getKeyAuthor(update.eventResponseMessageKey, meLid));
+        }
+    }
+    return Object.values(responseMap);
+};
+
+// ─── LID / JID helpers ───────────────────────────────────────────────────────
+
+/** Normalize a bare user id to @s.whatsapp.net. */
+export const toJid = id => {
+    if (!id) return '';
+    if (id.includes('@')) return id;
+    return `${id}@s.whatsapp.net`;
+};
+
+/** Returns the peer LID JID when the key is LID-primary. */
+export const getSenderLid = message => {
+    const k = message.key;
+    if (!k) return { jid: '', lid: '' };
+    const jid = k.participant || k.remoteJid || '';
+    if (jid.endsWith('@lid') || jid.endsWith('@hosted.lid')) return { jid, lid: jid };
+    if (k.lid && typeof k.lid === 'string') {
+        const lid = k.lid.includes('@') ? k.lid : jidDecode ? `${k.lid}@lid` : k.lid;
+        return { jid, lid };
+    }
+    if (k.participantLid && (isLidUser(k.participantLid) || isHostedLidUser(k.participantLid))) {
+        return { jid, lid: k.participantLid };
+    }
+    return { jid, lid: '' };
+};

package/lib/Utils/message-retry-manager.d.ts

@@ -0,0 +1,115 @@
+import type { proto } from '../../WAProto/index.js';
+import type { ILogger } from './logger.js';
+export interface RecentMessageKey {
+    to: string;
+    id: string;
+}
+export interface RecentMessage {
+    message: proto.IMessage;
+    timestamp: number;
+}
+export interface SessionRecreateHistory {
+    [jid: string]: number;
+}
+export interface RetryCounter {
+    [messageId: string]: number;
+}
+export type PendingPhoneRequest = Record<string, ReturnType<typeof setTimeout>>;
+export interface RetryStatistics {
+    totalRetries: number;
+    successfulRetries: number;
+    failedRetries: number;
+    mediaRetries: number;
+    sessionRecreations: number;
+    phoneRequests: number;
+}
+export declare enum RetryReason {
+    UnknownError = 0,
+    SignalErrorNoSession = 1,
+    SignalErrorInvalidKey = 2,
+    SignalErrorInvalidKeyId = 3,
+    /** MAC verification failed - most common cause of decryption failures */
+    SignalErrorInvalidMessage = 4,
+    SignalErrorInvalidSignature = 5,
+    SignalErrorFutureMessage = 6,
+    /** Explicit MAC failure - session is definitely out of sync */
+    SignalErrorBadMac = 7,
+    SignalErrorInvalidSession = 8,
+    SignalErrorInvalidMsgKey = 9,
+    BadBroadcastEphemeralSetting = 10,
+    UnknownCompanionNoPrekey = 11,
+    AdvFailure = 12,
+    StatusRevokeDelay = 13
+}
+export declare class MessageRetryManager {
+    private logger;
+    private recentMessagesMap;
+    private messageKeyIndex;
+    private sessionRecreateHistory;
+    private retryCounters;
+    private baseKeys;
+    private pendingPhoneRequests;
+    private readonly maxMsgRetryCount;
+    private statistics;
+    constructor(logger: ILogger, maxMsgRetryCount: number);
+    /**
+     * Add a recent message to the cache for retry handling
+     */
+    addRecentMessage(to: string, id: string, message: proto.IMessage): void;
+    /**
+     * Get a recent message from the cache
+     */
+    getRecentMessage(to: string, id: string): RecentMessage | undefined;
+    /**
+     * Check if a session should be recreated based on retry count, history, and error code.
+     * MAC errors (codes 4 and 7) trigger immediate session recreation regardless of timeout.
+     */
+    shouldRecreateSession(jid: string, hasSession: boolean, errorCode?: RetryReason): {
+        reason: string;
+        recreate: boolean;
+    };
+    /**
+     * Parse error code from retry receipt's retry node.
+     * Returns undefined if no error code is present.
+     */
+    parseRetryErrorCode(errorAttr: string | undefined): RetryReason | undefined;
+    /**
+     * Check if an error code indicates a MAC failure
+     */
+    isMacError(errorCode: RetryReason | undefined): boolean;
+    /**
+     * Increment retry counter for a message
+     */
+    incrementRetryCount(messageId: string): number;
+    /**
+     * Get retry count for a message
+     */
+    getRetryCount(messageId: string): number;
+    /**
+     * Check if message has exceeded maximum retry attempts
+     */
+    hasExceededMaxRetries(messageId: string): boolean;
+    /**
+     * Mark retry as successful
+     */
+    markRetrySuccess(messageId: string): void;
+    /**
+     * Mark retry as failed
+     */
+    markRetryFailed(messageId: string): void;
+    /**
+     * Schedule a phone request with delay
+     */
+    schedulePhoneRequest(messageId: string, callback: () => void, delay?: number): void;
+    /**
+     * Cancel pending phone request
+     */
+    cancelPendingPhoneRequest(messageId: string): void;
+    clear(): void;
+    saveBaseKey(addr: string, msgId: string, baseKey: Uint8Array): void;
+    hasSameBaseKey(addr: string, msgId: string, baseKey: Uint8Array): boolean;
+    deleteBaseKey(addr: string, msgId: string): void;
+    private keyToString;
+    private removeRecentMessage;
+}
+//# sourceMappingURL=message-retry-manager.d.ts.map

package/lib/Utils/message-retry-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-retry-manager.d.ts","sourceRoot":"","sources":["../../src/Utils/message-retry-manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAA;AAUvC,MAAM,WAAW,gBAAgB;IAChC,EAAE,EAAE,MAAM,CAAA;IACV,EAAE,EAAE,MAAM,CAAA;CACV;AAED,MAAM,WAAW,aAAa;IAC7B,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAA;IACvB,SAAS,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,sBAAsB;IACtC,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,YAAY;IAC5B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAA;CAC3B;AAED,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC,CAAA;AAE/E,MAAM,WAAW,eAAe;IAC/B,YAAY,EAAE,MAAM,CAAA;IACpB,iBAAiB,EAAE,MAAM,CAAA;IACzB,aAAa,EAAE,MAAM,CAAA;IACrB,YAAY,EAAE,MAAM,CAAA;IACpB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,aAAa,EAAE,MAAM,CAAA;CACrB;AAGD,oBAAY,WAAW;IACtB,YAAY,IAAI;IAChB,oBAAoB,IAAI;IACxB,qBAAqB,IAAI;IACzB,uBAAuB,IAAI;IAC3B,yEAAyE;IACzE,yBAAyB,IAAI;IAC7B,2BAA2B,IAAI;IAC/B,wBAAwB,IAAI;IAC5B,+DAA+D;IAC/D,iBAAiB,IAAI;IACrB,yBAAyB,IAAI;IAC7B,wBAAwB,IAAI;IAC5B,4BAA4B,KAAK;IACjC,wBAAwB,KAAK;IAC7B,UAAU,KAAK;IACf,iBAAiB,KAAK;CACtB;AAKD,qBAAa,mBAAmB;IAwC9B,OAAO,CAAC,MAAM;IAvCf,OAAO,CAAC,iBAAiB,CAWvB;IACF,OAAO,CAAC,eAAe,CAA4B;IACnD,OAAO,CAAC,sBAAsB,CAG5B;IACF,OAAO,CAAC,aAAa,CAInB;IACF,OAAO,CAAC,QAAQ,CAId;IACF,OAAO,CAAC,oBAAoB,CAA0B;IACtD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAY;IAC7C,OAAO,CAAC,UAAU,CAOjB;gBAGQ,MAAM,EAAE,OAAO,EACvB,gBAAgB,EAAE,MAAM;IAKzB;;OAEG;IACH,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,QAAQ,GAAG,IAAI;IAcvE;;OAEG;IACH,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAMnE;;;OAGG;IACH,qBAAqB,CACpB,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,OAAO,EACnB,SAAS,CAAC,EAAE,WAAW,GACrB;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE;IAyCxC;;;OAGG;IACH,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS;IAkB3E;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,WAAW,GAAG,SAAS,GAAG,OAAO;IAIvD;;OAEG;IACH,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAM9C;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAIxC;;OAEG;IACH,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAIjD;;OAEG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAQzC;;OAEG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAOxC;;OAEG;IACH,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,EAAE,KAAK,GAAE,MAA4B,GAAG,IAAI;IAaxG;;OAEG;IACH,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IASlD,KAAK,IAAI,IAAI;IAoBb,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,IAAI;IAInE,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO;IAazE,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAIhD,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,mBAAmB;CAS3B"}