@itsliaaa/baileys 0.1.4 → 0.1.6

package/README.md

@@ -14,7 +14,7 @@ A lightweight fork of Baileys with a few fixes and a small adjustment.
 
 #### 📨 Message Handling & Compatibility
 - 👉🏻 Added support for sending [interactive message](#-sending-interactive-messages) types (button, list, interactive, template, carousel).
-- 📩 Added support for [album messages](#%EF%B8%8F-album-image--video), [group status messages](#4%EF%B8%8F⃣-group-status), [sticker pack messages](#-sticker-pack), and several [payment-related messages](#-sending-payment-messages) (request payment, payment invite, order, invoice).
+- 📩 Added support for [album messages](#%EF%B8%8F-album-image--video), [group status messages](#4%EF%B8%8F⃣-group-status), [status mention messages](#%EF%B8%8F-status-mention), [sticker pack messages](#-sticker-pack), and several [payment-related messages](#-sending-payment-messages) (request payment, payment invite, order, invoice).
 - 📰 Simplified sending messages with ad thumbnails via [`externalAdReply`](#3%EF%B8%8F⃣-external-ad-reply) without requiring manual `contextInfo`.
 
 #### 🧩 Additional Message Options
@@ -361,6 +361,14 @@ sock.sendMessage(jid, {
 })
 ```
 
+##### 🎞️ Status Mention
+
+```javascript
+sock.sendMessage([jidA, jidB, jidC], {
+   text: 'Hello! 👋🏻'
+})
+```
+
 #### 📁 Sending Media Messages
 
 > [!NOTE]

package/lib/Defaults/index.js

@@ -4,7 +4,7 @@ import { Browsers } from '../Utils/browser-utils.js';
 import logger from '../Utils/logger.js';
 const version = [2, 3000, 1033846690];
 export const UNAUTHORIZED_CODES = [401, 403, 419];
-export const BIZ_BOT_SUPPORT_PAYLOAD = '{"version":1,"is_ai_message":true,"should_show_system_message":true,"ticket_id":"7004947587700716","citation_items":[],"ticket_locale":"us"}';
+export const BIZ_BOT_SUPPORT_PAYLOAD = '{"version":1,"is_ai_message":true,"should_show_system_message":false,"ticket_id":"7004947587700716","citation_items":[],"ticket_locale":"us"}';
 export const DEFAULT_ORIGIN = 'https://web.whatsapp.com';
 export const CALL_VIDEO_PREFIX = 'https://call.whatsapp.com/video/';
 export const CALL_AUDIO_PREFIX = 'https://call.whatsapp.com/voice/';

package/lib/Socket/messages-recv.js

@@ -7,6 +7,8 @@ import { DEFAULT_CACHE_TTLS, KEY_BUNDLE_TYPE, MIN_PREKEY_COUNT, PLACEHOLDER_MAX_
 import { WAMessageStatus, WAMessageStubType } from '../Types/index.js';
 import { aesDecryptCTR, aesEncryptGCM, cleanMessage, Curve, decodeMediaRetryNode, decodeMessageNode, decryptMessageNode, delay, derivePairingCodeKey, encodeBigEndian, encodeSignedDeviceIdentity, extractAddressingContext, getCallStatusFromNode, getHistoryMsg, getNextPreKeys, getStatusFromReceiptType, handleIdentityChange, hkdf, MISSING_KEYS_ERROR_TEXT, NACK_REASONS, NO_MESSAGE_FOUND_ERROR_TEXT, toNumber, unixTimestampSeconds, xmppPreKey, xmppSignedPreKey } from '../Utils/index.js';
 import { makeMutex } from '../Utils/make-mutex.js';
+import { makeOfflineNodeProcessor } from '../Utils/offline-node-processor.js';
+import { buildAckStanza } from '../Utils/stanza-ack.js';
 import { areJidsSameUser, binaryNodeToString, getAllBinaryNodeChildren, getBinaryNodeChild, getBinaryNodeChildBuffer, getBinaryNodeChildren, getBinaryNodeChildString, isJidGroup, isJidNewsletter, isJidStatusBroadcast, isLidUser, isPnUser, jidDecode, jidNormalizedUser, S_WHATSAPP_NET } from '../WABinary/index.js';
 import { extractGroupMetadata } from './groups.js';
 import { makeMessagesSocket } from './messages-send.js';
@@ -217,32 +219,9 @@ export const makeMessagesRecvSocket = (config) => {
                 break;
         }
     };
-    const sendMessageAck = async ({ tag, attrs, content }, errorCode) => {
-        const stanza = {
-            tag: 'ack',
-            attrs: {
-                id: attrs.id,
-                to: attrs.from,
-                class: tag
-            }
-        };
-        if (!!errorCode) {
-            stanza.attrs.error = errorCode.toString();
-        }
-        if (!!attrs.participant) {
-            stanza.attrs.participant = attrs.participant;
-        }
-        if (!!attrs.recipient) {
-            stanza.attrs.recipient = attrs.recipient;
-        }
-        if (!!attrs.type &&
-            (tag !== 'message' || getBinaryNodeChild({ tag, attrs, content }, 'unavailable') || errorCode !== 0)) {
-            stanza.attrs.type = attrs.type;
-        }
-        if (tag === 'message' && getBinaryNodeChild({ tag, attrs, content }, 'unavailable')) {
-            stanza.attrs.from = authState.creds.me.id;
-        }
-        logger.debug({ recv: { tag, attrs }, sent: stanza.attrs }, 'sent ack');
+    const sendMessageAck = async (node, errorCode) => {
+        const stanza = buildAckStanza(node, errorCode, authState.creds.me.id);
+        logger.debug({ recv: { tag: node.tag, attrs: node.attrs }, sent: stanza.attrs }, 'sent ack');
         await sendNode(stanza);
     };
     const rejectCall = async (callId, callFrom) => {
@@ -995,7 +974,7 @@ export const makeMessagesRecvSocket = (config) => {
             ]);
         }
         finally {
-            await sendMessageAck(node);
+            await sendMessageAck(node).catch(ackErr => logger.error({ ackErr }, 'failed to ack receipt'));
         }
     };
     const handleNotification = async (node) => {
@@ -1030,7 +1009,7 @@ export const makeMessagesRecvSocket = (config) => {
             ]);
         }
         finally {
-            await sendMessageAck(node);
+            await sendMessageAck(node).catch(ackErr => logger.error({ ackErr }, 'failed to ack notification'));
         }
     };
     const handleMessage = async (node) => {
@@ -1046,36 +1025,34 @@ export const makeMessagesRecvSocket = (config) => {
             await sendMessageAck(node, NACK_REASONS.MissingMessageSecret);
             return;
         }
-        const { fullMessage: msg, category, author, decrypt } = decryptMessageNode(node, authState.creds.me.id, authState.creds.me.lid || '', signalRepository, logger);
-        const alt = msg.key.participantAlt || msg.key.remoteJidAlt;
-        // store new mappings we didn't have before
-        if (!!alt) {
-            const altServer = jidDecode(alt)?.server;
-            const primaryJid = msg.key.participant || msg.key.remoteJid;
-            if (altServer === 'lid') {
-                if (!(await signalRepository.lidMapping.getPNForLID(alt))) {
-                    await signalRepository.lidMapping.storeLIDPNMappings([{ lid: alt, pn: primaryJid }]);
-                    await signalRepository.migrateSession(primaryJid, alt);
+        let acked = false;
+        try {
+            const { fullMessage: msg, category, author, decrypt } = decryptMessageNode(node, authState.creds.me.id, authState.creds.me.lid || '', signalRepository, logger);
+            const alt = msg.key.participantAlt || msg.key.remoteJidAlt;
+            // store new mappings we didn't have before
+            if (!!alt) {
+                const altServer = jidDecode(alt)?.server;
+                const primaryJid = msg.key.participant || msg.key.remoteJid;
+                if (altServer === 'lid') {
+                    if (!(await signalRepository.lidMapping.getPNForLID(alt))) {
+                        await signalRepository.lidMapping.storeLIDPNMappings([{ lid: alt, pn: primaryJid }]);
+                        await signalRepository.migrateSession(primaryJid, alt);
+                    }
+                }
+                else {
+                    await signalRepository.lidMapping.storeLIDPNMappings([{ lid: primaryJid, pn: alt }]);
+                    await signalRepository.migrateSession(alt, primaryJid);
                 }
             }
-            else {
-                await signalRepository.lidMapping.storeLIDPNMappings([{ lid: primaryJid, pn: alt }]);
-                await signalRepository.migrateSession(alt, primaryJid);
-            }
-        }
-        if (msg.key?.remoteJid && msg.key?.id && messageRetryManager) {
-            messageRetryManager.addRecentMessage(msg.key.remoteJid, msg.key.id, msg.message);
-            logger.debug({
-                jid: msg.key.remoteJid,
-                id: msg.key.id
-            }, 'Added message to recent cache for retry receipts');
-        }
-        try {
             await messageMutex.mutex(async () => {
                 await decrypt();
+                if (msg.key?.remoteJid && msg.key?.id && msg.message && messageRetryManager) {
+                    messageRetryManager.addRecentMessage(msg.key.remoteJid, msg.key.id, msg.message);
+                }
                 // message failed to decrypt
                 if (msg.messageStubType === proto.WebMessageInfo.StubType.CIPHERTEXT && msg.category !== 'peer') {
                     if (msg?.messageStubParameters?.[0] === MISSING_KEYS_ERROR_TEXT) {
+                        acked = true;
                         return sendMessageAck(node, NACK_REASONS.ParsingError);
                     }
                     if (msg.messageStubParameters?.[0] === NO_MESSAGE_FOUND_ERROR_TEXT) {
@@ -1087,11 +1064,13 @@ export const makeMessagesRecvSocket = (config) => {
                             unavailableType === 'hosted_unavailable_fanout' ||
                             unavailableType === 'view_once_unavailable_fanout') {
                             logger.debug({ msgId: msg.key.id, unavailableType }, 'skipping placeholder resend for excluded unavailable type');
+                            acked = true;
                             return sendMessageAck(node);
                         }
                         const messageAge = unixTimestampSeconds() - toNumber(msg.messageTimestamp);
                         if (messageAge > PLACEHOLDER_MAX_AGE_SECONDS) {
                             logger.debug({ msgId: msg.key.id, messageAge }, 'skipping placeholder resend for old message');
+                            acked = true;
                             return sendMessageAck(node);
                         }
                         // Request the real content from the phone via placeholder resend PDO.
@@ -1128,6 +1107,7 @@ export const makeMessagesRecvSocket = (config) => {
                             .catch(err => {
                             logger.warn({ err, msgId: msg.key.id }, 'failed to request placeholder resend for unavailable message');
                         });
+                        acked = true;
                         await sendMessageAck(node);
                         // Don't return — fall through to upsertMessage so the stub is emitted
                     }
@@ -1137,6 +1117,7 @@ export const makeMessagesRecvSocket = (config) => {
                             const messageAge = unixTimestampSeconds() - toNumber(msg.messageTimestamp);
                             if (messageAge > STATUS_EXPIRY_SECONDS) {
                                 logger.debug({ msgId: msg.key.id, messageAge, remoteJid: msg.key.remoteJid }, 'skipping retry for expired status message');
+                                acked = true;
                                 return sendMessageAck(node);
                             }
                         }
@@ -1180,6 +1161,7 @@ export const makeMessagesRecvSocket = (config) => {
                                     logger.error({ retryErr }, 'Failed to send retry after error handling');
                                 }
                             }
+                            acked = true;
                             await sendMessageAck(node, NACK_REASONS.UnhandledError);
                         });
                     }
@@ -1208,6 +1190,7 @@ export const makeMessagesRecvSocket = (config) => {
                         else if (!sendActiveReceipts) {
                             type = 'inactive';
                         }
+                        acked = true;
                         await sendReceipt(msg.key.remoteJid, participant, [msg.key.id], type);
                         // send ack for history message
                         const isAnyHistoryMsg = getHistoryMsg(msg.message);
@@ -1217,6 +1200,7 @@ export const makeMessagesRecvSocket = (config) => {
                         }
                     }
                     else {
+                        acked = true;
                         await sendMessageAck(node);
                         logger.debug({ key: msg.key }, 'processed newsletter message without receipts');
                     }
@@ -1227,45 +1211,55 @@ export const makeMessagesRecvSocket = (config) => {
         }
         catch (error) {
             logger.error({ error, node: binaryNodeToString(node) }, 'error in handling message');
+            if (!acked) {
+                await sendMessageAck(node, NACK_REASONS.UnhandledError).catch(ackErr => logger.error({ ackErr }, 'failed to ack message after error'));
+            }
         }
     };
     const handleCall = async (node) => {
-        const { attrs } = node;
-        const [infoChild] = getAllBinaryNodeChildren(node);
-        const status = getCallStatusFromNode(infoChild);
-        if (!infoChild) {
-            throw new Boom('Missing call info in call node');
-        }
-        const callId = infoChild.attrs['call-id'];
-        const from = infoChild.attrs.from || infoChild.attrs['call-creator'];
-        const call = {
-            chatId: attrs.from,
-            from,
-            callerPn: infoChild.attrs['caller_pn'],
-            id: callId,
-            date: new Date(+attrs.t * 1000),
-            offline: !!attrs.offline,
-            status
-        };
-        if (status === 'offer') {
-            call.isVideo = !!getBinaryNodeChild(infoChild, 'video');
-            call.isGroup = infoChild.attrs.type === 'group' || !!infoChild.attrs['group-jid'];
-            call.groupJid = infoChild.attrs['group-jid'];
-            await callOfferCache.set(call.id, call);
+        try {
+            const { attrs } = node;
+            const [infoChild] = getAllBinaryNodeChildren(node);
+            if (!infoChild) {
+                throw new Boom('Missing call info in call node');
+            }
+            const status = getCallStatusFromNode(infoChild);
+            const callId = infoChild.attrs['call-id'];
+            const from = infoChild.attrs.from || infoChild.attrs['call-creator'];
+            const call = {
+                chatId: attrs.from,
+                from,
+                callerPn: infoChild.attrs['caller_pn'],
+                id: callId,
+                date: new Date(+attrs.t * 1000),
+                offline: !!attrs.offline,
+                status
+            };
+            if (status === 'offer') {
+                call.isVideo = !!getBinaryNodeChild(infoChild, 'video');
+                call.isGroup = infoChild.attrs.type === 'group' || !!infoChild.attrs['group-jid'];
+                call.groupJid = infoChild.attrs['group-jid'];
+                await callOfferCache.set(call.id, call);
+            }
+            const existingCall = await callOfferCache.get(call.id);
+            // use existing call info to populate this event
+            if (existingCall) {
+                call.isVideo = existingCall.isVideo;
+                call.isGroup = existingCall.isGroup;
+                call.callerPn = call.callerPn || existingCall.callerPn;
+            }
+            // delete data once call has ended
+            if (status === 'reject' || status === 'accept' || status === 'timeout' || status === 'terminate') {
+                await callOfferCache.del(call.id);
+            }
+            ev.emit('call', [call]);
         }
-        const existingCall = await callOfferCache.get(call.id);
-        // use existing call info to populate this event
-        if (existingCall) {
-            call.isVideo = existingCall.isVideo;
-            call.isGroup = existingCall.isGroup;
-            call.callerPn = call.callerPn || existingCall.callerPn;
+        catch (error) {
+            logger.error({ error, node: binaryNodeToString(node) }, 'error in handling call');
         }
-        // delete data once call has ended
-        if (status === 'reject' || status === 'accept' || status === 'timeout' || status === 'terminate') {
-            await callOfferCache.del(call.id);
+        finally {
+            await sendMessageAck(node).catch(ackErr => logger.error({ ackErr }, 'failed to ack call'));
         }
-        ev.emit('call', [call]);
-        await sendMessageAck(node);
     };
     const handleBadAck = async ({ attrs }) => {
         const key = { remoteJid: attrs.from, fromMe: true, id: attrs.id };
@@ -1320,52 +1314,16 @@ export const makeMessagesRecvSocket = (config) => {
             return exec(node, false).catch(err => onUnexpectedError(err, identifier));
         }
     };
-    /** Yields control to the event loop to prevent blocking */
-    const yieldToEventLoop = () => {
-        return new Promise(resolve => setImmediate(resolve));
-    };
-    const makeOfflineNodeProcessor = () => {
-        const nodeProcessorMap = new Map([
-            ['message', handleMessage],
-            ['call', handleCall],
-            ['receipt', handleReceipt],
-            ['notification', handleNotification]
-        ]);
-        const nodes = [];
-        let isProcessing = false;
-        // Number of nodes to process before yielding to event loop
-        const BATCH_SIZE = 10;
-        const enqueue = (type, node) => {
-            nodes.push({ type, node });
-            if (isProcessing) {
-                return;
-            }
-            isProcessing = true;
-            const promise = async () => {
-                let processedInBatch = 0;
-                while (nodes.length && ws.isOpen) {
-                    const { type, node } = nodes.shift();
-                    const nodeProcessor = nodeProcessorMap.get(type);
-                    if (!nodeProcessor) {
-                        onUnexpectedError(new Error(`unknown offline node type: ${type}`), 'processing offline node');
-                        continue;
-                    }
-                    await nodeProcessor(node);
-                    processedInBatch++;
-                    // Yield to event loop after processing a batch
-                    // This prevents blocking the event loop for too long when there are many offline nodes
-                    if (processedInBatch >= BATCH_SIZE) {
-                        processedInBatch = 0;
-                        await yieldToEventLoop();
-                    }
-                }
-                isProcessing = false;
-            };
-            promise().catch(error => onUnexpectedError(error, 'processing offline nodes'));
-        };
-        return { enqueue };
-    };
-    const offlineNodeProcessor = makeOfflineNodeProcessor();
+    const offlineNodeProcessor = makeOfflineNodeProcessor(new Map([
+        ['message', handleMessage],
+        ['call', handleCall],
+        ['receipt', handleReceipt],
+        ['notification', handleNotification]
+    ]), {
+        isWsOpen: () => ws.isOpen,
+        onUnexpectedError,
+        yieldToEventLoop: () => new Promise(resolve => setImmediate(resolve))
+    });
     const processNode = async (type, node, identifier, exec) => {
         const isOffline = !!node.attrs.offline;
         if (isOffline) {

package/lib/Socket/messages-send.js

@@ -1,5 +1,6 @@
 import NodeCache from '@cacheable/node-cache';
 import { Boom } from '@hapi/boom';
+import { randomBytes } from 'crypto';
 import { proto } from '../../WAProto/index.js';
 import { BIZ_BOT_SUPPORT_PAYLOAD, DEFAULT_CACHE_TTLS, OLD_GROUP_ID_REGEX, WA_DEFAULT_EPHEMERAL } from '../Defaults/index.js';
 import { aggregateMessageKeysNotFromMe, assertMediaContent, bindWaitForEvent, decryptMediaRetryData, delay, encodeNewsletterMessage, encodeSignedDeviceIdentity, encodeWAMessage, encryptMediaRetryRequest, extractDeviceJids, generateMessageIDV2, generateParticipantHashV2, generateWAMessageFromContent, generateWAMessage, getStatusCodeForMediaRetry, getUrlFromDirectPath, getWAUploadToServer, hasValidAlbumMedia, MessageRetryManager, normalizeMessageContent, parseAndInjectE2ESessions, shouldIncludeBizBinaryNode, unixTimestampSeconds } from '../Utils/index.js';
@@ -830,7 +831,9 @@ export const makeMessagesSocket = (config) => {
         }
         if (normalizedMessage.pollCreationMessage ||
             normalizedMessage.pollCreationMessageV2 ||
-            normalizedMessage.pollCreationMessageV3 || normalizedMessage.pollCreationMessageV5 ||
+            normalizedMessage.pollCreationMessageV3 ||
+            normalizedMessage.pollCreationMessageV5 ||
+            normalizedMessage.pollCreationMessageV6 ||
             normalizedMessage.pollUpdateMessage) {
             return 'poll';
         }
@@ -992,7 +995,102 @@ export const makeMessagesSocket = (config) => {
         // Lia@Changes 30-01-26 --- Add support for modifying additionalNodes and additionalAttributes using "options" in sendMessage()
         sendMessage: async (jid, content, options = {}) => {
             const userJid = authState.creds.me.id;
-            if ('disappearingMessagesInChat' in content && isJidGroup(jid)) {
+            // Lia@Changes 13-03-26 --- Add status mentions!
+            if (Array.isArray(jid)) {
+                const { delayMs = 1500 } = options;
+                const allUsers = new Set();
+                const fullMsg = await generateWAMessage('status@broadcast', content, {
+                    logger,
+                    userJid,
+                    upload: waUploadToServer,
+                    mediaCache: config.mediaCache,
+                    options: config.options,
+                    ...options,
+                    messageId: generateMessageIDV2(userJid)
+                });
+                for (const id of jid) {
+                    if (isJidGroup(id)) {
+                        try {
+                            const groupData = (cachedGroupMetadata ? await cachedGroupMetadata(id) : null) || await groupMetadata(id);
+                            for (const participant of groupData.participants) {
+                                if (allUsers.has(participant.id))
+                                    continue;
+                                allUsers.add(participant.id);
+                            }
+                        }
+                        catch (error) {
+                            logger.error(`Error getting metadata group from ${id}: ${error}`);
+                        }
+                    }
+                    else if (!allUsers.has(id)) {
+                        allUsers.add(id);
+                    }
+                }
+                await relayMessage('status@broadcast', fullMsg.message, {
+                    messageId: fullMsg.key.id,
+                    statusJidList: Array.from(allUsers),
+                    additionalNodes: [
+                        {
+                            tag: 'meta',
+                            attrs: {},
+                            content: [
+                                {
+                                    tag: 'mentioned_users',
+                                    attrs: {},
+                                    content: jid.map(id => ({
+                                        tag: 'to',
+                                        attrs: { jid: id },
+                                        content: undefined
+                                    }))
+                                }
+                            ]
+                        }
+                    ]
+                });
+                if (config.emitOwnEvents) {
+                    process.nextTick(async () => {
+                        await messageMutex.mutex(() => upsertMessage(fullMsg, 'append'));
+                    });
+                }
+                for (const id of jid) {
+                    const isGroup = isJidGroup(id)
+                    const sendType = isGroup ? 'groupStatusMentionMessage' : 'statusMentionMessage';
+                    const mentionMsg = generateWAMessageFromContent(id, {
+                        messageContextInfo: {
+                            messageSecret: randomBytes(32)
+                        },
+                        [sendType]: {
+                            message: {
+                                protocolMessage: {
+                                    key: fullMsg.key,
+                                    type: 25
+                                }
+                            }
+                        }
+                    }, {
+                        userJid
+                    });
+                    await relayMessage(id, mentionMsg.message, {
+                        additionalNodes: [
+                            {
+                                tag: 'meta',
+                                attrs: isGroup ?
+                                    { is_group_status_mention: 'true' } :
+                                    { is_status_mention: 'true' },
+                                content: undefined
+                            }
+                        ]
+                    });
+                    if (config.emitOwnEvents) {
+                        process.nextTick(async () => {
+                            await messageMutex.mutex(() => upsertMessage(mentionMsg, 'append'));
+                        });
+                    }
+                    await delay(delayMs);
+                }
+                return fullMsg;
+            }
+            else if ('disappearingMessagesInChat' in content && isJidGroup(jid)) {
                 const { disappearingMessagesInChat } = content;
                 const value = typeof disappearingMessagesInChat === 'boolean'
                     ? disappearingMessagesInChat

package/lib/Utils/index.js

@@ -16,4 +16,5 @@ export * from './event-buffer.js';
 export * from './process-message.js';
 export * from './message-retry-manager.js';
 export * from './browser-utils.js';
-export * from './identity-change-handler.js';
+export * from './identity-change-handler.js';
+export * from './stanza-ack.js';

package/lib/Utils/messages.js

@@ -26,33 +26,28 @@ const MessageTypeProto = {
     sticker: WAProto.Message.StickerMessage,
     document: WAProto.Message.DocumentMessage
 };
-const mediaAnnotation = [{
-    polygonVertices: [{
-        x: 60.71664810180664,
-        y: -36.39784622192383
-    }, {
-        x: -16.710189819335938,
-        y: 49.263675689697266
-    }, {
-        x: -56.585853576660156,
-        y: 37.85963439941406
-    }, {
-        x: 20.840980529785156,
-        y: -47.80188751220703
-    }],
-    newsletter: {
-        // Lia@Note 03-02-26 --- You can change jid, message id, and name via .env (⁠≧⁠▽⁠≦⁠)
-        newsletterJid: process.env.NEWSLETTER_ID ||
-            Buffer.from('313230333633343034303036363434313339406e6577736c6574746572', 'hex').toString(),
-        serverMessageId: process.env.NEWSLETTER_MESSAGE_ID ||
-            Buffer.from('313033', 'hex').toString(),
-        newsletterName: process.env.NEWSLETTER_NAME ||
-            Buffer.from('f09d96b2f09d978df09d96baf09d978bf09d96bff09d96baf09d9785f09d9785', 'hex').toString(),
-        contentType: proto.ContextInfo.ForwardedNewsletterMessageInfo.ContentType.UPDATE,
-        accessibilityText: process.env.NEWSLETTER_ACCESSIBILITY_TEXT ||
-            ''
-    }
-}];
+const mediaAnnotation = [
+    {
+        polygonVertices: [
+            { x: 60.71664810180664, y: -36.39784622192383 },
+            { x: -16.710189819335938, y: 49.263675689697266 },
+            { x: -56.585853576660156, y: 37.85963439941406 },
+            { x: 20.840980529785156, y: -47.80188751220703 }
+        ],
+        newsletter: {
+            // Lia@Note 03-02-26 --- You can change jid, message id, and name via .env (⁠≧⁠▽⁠≦⁠)
+            newsletterJid: process.env.NEWSLETTER_ID ||
+                Buffer.from('313230333633343034303036363434313339406e6577736c6574746572', 'hex').toString(),
+            serverMessageId: process.env.NEWSLETTER_MESSAGE_ID ||
+                Buffer.from('313033', 'hex').toString(),
+            newsletterName: process.env.NEWSLETTER_NAME ||
+                Buffer.from('f09d96b2f09d978df09d96baf09d978bf09d96bff09d96baf09d9785f09d9785', 'hex').toString(),
+            contentType: proto.ContextInfo.ForwardedNewsletterMessageInfo.ContentType.UPDATE,
+            accessibilityText: process.env.NEWSLETTER_ACCESSIBILITY_TEXT ||
+                '@itsliaaa/baileys'
+        }
+    }
+];
 /**
  * Uses a regex to test whether the string contains a URL, and returns the URL if it does.
  * @param text eg. hello https://google.com
@@ -552,7 +547,10 @@ const prepareNativeFlowButtons = (message) => {
         Object.assign(messageParamsJson, {
             bottom_sheet: {
                 in_thread_buttons_limit: 1,
-                divide_indices: [],
+                divider_indices: Array.from(
+                    { length: correctedField.length },
+                    (_, index) => index
+                ),
                 list_title: message.optionTitle || '📄 Select Options',
                 button_title: message.optionText
             }

package/lib/Utils/offline-node-processor.js

@@ -0,0 +1,39 @@
+/**
+ * Creates a processor for offline stanza nodes that:
+ * - Queues nodes for sequential processing
+ * - Yields to the event loop periodically to avoid blocking
+ * - Catches handler errors to prevent the processing loop from crashing
+ */
+export function makeOfflineNodeProcessor(nodeProcessorMap, deps, batchSize = 10) {
+    const nodes = [];
+    let isProcessing = false;
+    const enqueue = (type, node) => {
+        nodes.push({ type, node });
+        if (isProcessing) {
+            return;
+        }
+        isProcessing = true;
+        const promise = async () => {
+            let processedInBatch = 0;
+            while (nodes.length && deps.isWsOpen()) {
+                const { type, node } = nodes.shift();
+                const nodeProcessor = nodeProcessorMap.get(type);
+                if (!nodeProcessor) {
+                    deps.onUnexpectedError(new Error(`unknown offline node type: ${type}`), 'processing offline node');
+                    continue;
+                }
+                await nodeProcessor(node).catch(err => deps.onUnexpectedError(err, `processing offline ${type}`));
+                processedInBatch++;
+                // Yield to event loop after processing a batch
+                // This prevents blocking the event loop for too long when there are many offline nodes
+                if (processedInBatch >= batchSize) {
+                    processedInBatch = 0;
+                    await deps.yieldToEventLoop();
+                }
+            }
+            isProcessing = false;
+        };
+        promise().catch(error => deps.onUnexpectedError(error, 'processing offline nodes'));
+    };
+    return { enqueue };
+}

package/lib/Utils/stanza-ack.js

@@ -0,0 +1,37 @@
+/**
+ * Builds an ACK stanza for a received node.
+ * Pure function -- no I/O, no side effects.
+ *
+ * Mirrors WhatsApp Web's ACK construction:
+ * - WAWebHandleMsgSendAck.sendAck / sendNack
+ * - WAWebCreateNackFromStanza.createNackFromStanza
+ */
+export function buildAckStanza(node, errorCode, meId) {
+    const { tag, attrs } = node;
+    const stanza = {
+        tag: 'ack',
+        attrs: {
+            id: attrs.id,
+            to: attrs.from,
+            class: tag
+        }
+    };
+    if (errorCode) {
+        stanza.attrs.error = errorCode.toString();
+    }
+    if (attrs.participant) {
+        stanza.attrs.participant = attrs.participant;
+    }
+    if (attrs.recipient) {
+        stanza.attrs.recipient = attrs.recipient;
+    }
+    // WA Web always includes type when present: `n.type || DROP_ATTR`
+    if (attrs.type) {
+        stanza.attrs.type = attrs.type;
+    }
+    // WA Web WAWebHandleMsgSendAck.sendAck/sendNack always include `from` for message-class ACKs
+    if (tag === 'message' && meId) {
+        stanza.attrs.from = meId;
+    }
+    return stanza;
+}

package/lib/WABinary/generic-utils.js

@@ -123,75 +123,88 @@ export function binaryNodeToString(node, i = 0) {
  * @param {object} message Normalized message content (after Baileys normalization).
  * @returns {object} A node with shape { tag, attrs, [content] } to inject into additionalNodes.
  */
-const bizFlowMap = {
-    mpm: 1,
-    cta_catalog: 1,
-    send_location: 1,
-    call_permission_request: 1,
-    wa_payment_transaction_details: 1,
-    automated_greeting_message_view_catalog: 1
+const FLOWS_MAP = {
+    mpm: true,
+    cta_catalog: true,
+    send_location: true,
+    call_permission_request: true,
+    wa_payment_transaction_details: true,
+    automated_greeting_message_view_catalog: true
 };
-const bizBinaryQualityAttribute = {
+const qualityAttribute = {
     tag: 'quality_control',
-    attrs: { source_type: 'third_party' },
-    content: undefined
+    attrs: { source_type: 'third_party' }
 };
-const baseBizAttrs = {};
-const defaultContent = [bizBinaryQualityAttribute];
-const listContent = [{
-    tag: 'list',
-    attrs: { v: '2', type: 'product_list' },
-    content: undefined
-}, bizBinaryQualityAttribute];
-const makeInteractive = (v, name) => {
-    return [{
-        tag: 'interactive',
-        attrs: { type: 'native_flow', v: '1' },
-        content: [{
-            tag: 'native_flow',
-            attrs: { v, name },
-            content: undefined
-        }]
-    }, bizBinaryQualityAttribute];
-}
+const defaultContent = [qualityAttribute]
+const listContent = [
+    {
+        tag: 'list',
+        attrs: { v: '2', type: 'product_list' }
+    },
+    qualityAttribute
+];
 export const getBizBinaryNode = (message) => {
-    const nativeFlowMessage = message.interactiveMessage?.nativeFlowMessage;
-    const buttonName = nativeFlowMessage?.buttons?.[0]?.name;
+    const flowMsg = message.interactiveMessage?.nativeFlowMessage;
+    const buttonName = flowMsg?.buttons?.[0]?.name;
     if (buttonName === 'review_and_pay' || buttonName === 'payment_info') {
         return {
             tag: 'biz',
             attrs: {
-                native_flow_name: buttonName === 'review_and_pay'
-                    ? 'order_details'
-                    : buttonName
+                native_flow_name: buttonName === 'review_and_pay' ?
+                    'order_details' :
+                    buttonName
             },
             content: defaultContent
         };
     }
-    if (buttonName && bizFlowMap[buttonName]) {
+    if (buttonName && FLOWS_MAP[buttonName]) {
         return {
             tag: 'biz',
-            attrs: baseBizAttrs,
-            content: makeInteractive('2', buttonName)
+            attrs: {},
+            content: [
+                {
+                    tag: 'interactive',
+                    attrs: { type: 'native_flow', v: '1' },
+                    content: [
+                        {
+                            tag: 'native_flow',
+                            attrs: { v: '2', name: buttonName }
+                        }
+                    ]
+                },
+                qualityAttribute
+            ]
         };
     }
-    if (nativeFlowMessage || message.buttonsMessage || message.templateMessage) {
+    if (flowMsg || message.buttonsMessage || message.templateMessage) {
         return {
             tag: 'biz',
-            attrs: baseBizAttrs,
-            content: makeInteractive('9', 'mixed')
+            attrs: {},
+            content: [
+                {
+                    tag: 'interactive',
+                    attrs: { type: 'native_flow', v: '1' },
+                    content: [
+                        {
+                            tag: 'native_flow',
+                            attrs: { v: '9', name: 'mixed' }
+                        }
+                    ]
+                },
+                qualityAttribute
+            ]
         };
     }
     if (message.listMessage) {
         return {
             tag: 'biz',
-            attrs: baseBizAttrs,
+            attrs: {},
             content: listContent
         };
     }
     return {
         tag: 'biz',
-        attrs: baseBizAttrs,
+        attrs: {},
         content: defaultContent
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
    "name": "@itsliaaa/baileys",
-   "version": "0.1.4",
+   "version": "0.1.6",
    "description": "A simple fork of Baileys for WhatsApp automation",
    "main": "lib/index.js",
    "type": "module",