@vanzxy/baileys 1.2.6 → 1.2.7

package/README.md

@@ -1,61 +1,175 @@
-# 🌿 @vanzxy/baileys
+# 🍃 @vanzxy/baileys
+
+> Next-generation Baileys fork by **Vanzxy**.
+> Built for modern WhatsApp bot development with extended interactive messages, native flow enhancements, status tools, and quality-of-life improvements.
+
+![Version](https://img.shields.io/npm/v/@vanzxy/baileys)
+![Node](https://img.shields.io/badge/node-%3E%3D18-brightgreen)
+![ESM](https://img.shields.io/badge/module-ESM-blue)
+
+---
+
+# ✨ Why @vanzxy/baileys?
+
+This fork focuses on:
+
+- 🚀 Better developer experience
+- 🎯 Extended native flow support
+- 📢 Advanced status & broadcast features
+- 🧩 More interactive message types
+- ⚡ Cleaner implementation for bot developers
+- 🔧 Extra utilities not available in standard Baileys forks
+
+---
+
+# 🔥 Features
+
+## Interactive Messages
+- Native Flow
+- Buttons
+- Lists
+- Carousel Messages
+- Rich Response Messages
+- CTA Buttons
+- Reply Buttons
+- URL Buttons
+- Call Buttons
+- OTP Buttons
+- Authentication Buttons
+
+## Commerce & Business
+- Catalog Message
+- Order Details
+- Order Status
+- Review & Pay
+- Payment Status
+- Payment Method
+- Track Order
+- Reorder
+- Cancel Order
+
+## Utility Features
+- Group Status Support
+- Mention All
+- Lottie Sticker Support
+- Newsletter Support
+- ExternalAdReply Helper
+- View Once Support
+- Rich Formatting
+- Code Highlighting
+
+---
+
+# 🌟 Exclusive Vanzxy Enhancements
+
+### Audio Group Status Fix
+Audio status uses a more compatible implementation to avoid unsupported-version errors on older WhatsApp clients.
+
+### Native Flow Expansion
+Additional supported button types:
+
+- cta_reminder
+- cta_cancel_reminder
+- address_message
+- send_location
+- catalog_message
+- mpm
+- otp_button
+- authentication_button
+- call_button
+- url_button
+- reply_button
+- card_message
+- order_details
+- order_status
+- review_and_pay
+- payment_status
+- payment_method
+- track_order
+- reorder
+- cancel_order
+- clear_chat
+- navigateToScreen
+- flow_action
+- voice_call
+- video_call_button
+
+### System Notification Filter
+Messages include:
 
-Enhanced Baileys fork by **Vanzxy🍃 (VanzxyPrst🍃)** — built on top of `@itsliaaa/baileys` with extended native flow button support, system-notification filtering, and other fixes for WhatsApp bot development.
+```js
+message.isSystemNotification
+```
 
-## ✨ What's Different
+Useful for filtering:
 
-### 🔧 Fixes & Additions by Vanzxy🍃
+- E2E notices
+- Meta service notices
+- Other system-generated messages
 
-- **Audio Group Status** — Audio in `groupStatus: true` now uses `groupStatusMessage` (v1) instead of `groupStatusMessageV2`. This fixes the black screen / *"versi WhatsApp tidak mendukung"* error on older WA versions when bots broadcast audio via `swgc`.
-- **No "Lihat Saluran" Button** — Removed `mediaAnnotation` that auto-injected newsletter context into every image/video upload, causing an unwanted *"Lihat saluran"* button to appear on all media messages.
-- **Extended Native Flow Buttons** — Added support for `cta_reminder`, `cta_cancel_reminder`, `address_message`, `send_location`, `catalog_message`, `mpm`, `otp_button`, `authentication_button`, `call_button`, `url_button`, `reply_button`, `card_message`, `order_details`, `order_status`, `review_and_pay`, `payment_status`, `payment_method`, `track_order`, `reorder`, `cancel_order`, `clear_chat`, `navigateToScreen`, `flow_action`, `voice_call`, `video_call_button` — fully additive, existing button types untouched.
-- **System Notification Filtering** — Messages now carry an `isSystemNotification` flag (e.g. for E2E encryption notices, "business uses Meta service" notices) so bots can easily skip them without affecting normal message handling.
+---
 
-### ✅ Inherited from `@itsliaaa/baileys`
-- Interactive messages (buttons, list, native flow, carousel)
-- Album message (multi image/video)
-- Group Status message (`groupStatus: true`)
-- `mentionAll` without listing JIDs
-- `makeInMemoryStore` ESM port
-- Rich response, code blocks, tables, inline entities
-- Sticker pack, lottie sticker, spoiler, view once v2
-- Newsletter fixes, `externalAdReply` helper
-- `findUserId` for JID/LID lookup
-- `tokenizeCode` for syntax highlighting
+# 📦 Installation
 
-### ✅ Inherited from `@whiskeysockets/baileys`
-- LID/PN session management & mapping
-- Reachout timelock handling
-- New chat message cap
-- `validateSession` checks
-- `fetchNewChatMessageCap`, `fetchAccountReachoutTimelock`
+```bash
+npm install @vanzxy/baileys
+```
 
-## 📥 Installation
+GitHub:
 
 ```bash
-# Via npm
-npm i @vanzxy/baileys
-
-# Via GitHub
-npm i github:vanzxy/baileys
+npm install github:vanzxy/baileys
 ```
 
-## 🧩 Import
+---
+
+# 🚀 Quick Start
 
 ```js
-// ESM
 import { makeWASocket } from '@vanzxy/baileys'
+
+const sock = makeWASocket({
+    printQRInTerminal: true
+})
 ```
 
-## 📦 Fork Base
+---
+
+# 🛠 Recommended Environment
+
+- Node.js 18+
+- ESM Project
+- Latest WhatsApp Multi Device
+
+---
+
+# 📚 Fork Lineage
+
+@vanzxy/baileys
+└── @itsliaaa/baileys
+    └── WhiskeySockets/Baileys
+
+Respect to all original maintainers and contributors.
+
+---
+
+# 👑 Maintainer
+
+**Vanzxy**
+
+GitHub:
+https://github.com/vanzxy
+
+Package:
+@vanzxy/baileys
+
+---
 
-- [`@itsliaaa/baileys`](https://github.com/itsliaaa/baileys)
-- [`@whiskeysockets/baileys`](https://github.com/WhiskeySockets/Baileys)
+# ⚠️ Disclaimer
 
-## 📣 Credits
+This project is an independent fork.
+Use responsibly and follow WhatsApp Terms of Service.
 
-Full credit to original maintainers:
-- [purpshell](https://github.com/purpshell), [jlucaso1](https://github.com/jlucaso1), [adiwajshing](https://github.com/adiwajshing) — WhiskeySockets/Baileys
-- [Lia Wynn (itsliaaa)](https://github.com/itsliaaa) — @itsliaaa/baileys
+---
 
-Fixes & fork by **Vanzxy🍃 (VanzxyPrst🍃)** — [github.com/vanzxy](https://github.com/vanzxy)
+Made with 🍃 by Vanzxy

package/lib/Defaults/index.js

@@ -8,8 +8,8 @@ export const BIZ_BOT_SUPPORT_PAYLOAD = '{"version":1,"is_ai_message":true,"shoul
 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/';
-export const DONATE_URL = 'https://saweria.co/itsliaaa'; // Lia@Note 02-02-26 --- Apologies if this feels cheeky, just a fallback
-export const LIBRARY_NAME = 'itsliaaa/baileys';
+export const DONATE_URL = ''; // Vanz@Fix: cleared itsliaaa's donate URL fallback
+export const LIBRARY_NAME = 'vanzxy/baileys';
 export const DEF_CALLBACK_PREFIX = 'CB:';
 export const DEF_TAG_PREFIX = 'TAG:';
 export const PHONE_CONNECTION_CB = 'CB:Pong';
@@ -70,8 +70,12 @@ export const DEFAULT_CONNECTION_CONFIG = {
         return syncType !== proto.HistorySync.HistorySyncType.FULL;
     },
     shouldIgnoreJid: () => false,
-    linkPreviewImageThumbnailWidth: 192,
+    linkPreviewImageThumbnailWidth: 480, // Vanz@Fix: was 192 — too small, bumped to 480
     transactionOpts: { maxCommitRetries: 10, delayBetweenTriesMs: 3000 },
+    eventBufferTimeoutMs: 30000, // Vanz@Fix (bug 25): configurable — increase if bot is heavy load
+    statusBroadcastDelayMs: 1500, // Vanz@Fix (bug 5): configurable delay between status broadcasts — default 1500ms
+    albumDelayMs: 1500, // Vanz@Fix (bug 5): configurable delay between album message sends — default 1500ms
+    phashRetryEnabled: false, // Vanz@Fix (bug 54/55): enable phash retry on ack (caution: can cause loops if not careful)
     generateHighQualityLinkPreview: true,
     enableAutoSessionRecreation: true,
     enableRecentMessageCache: true,
@@ -81,6 +85,9 @@ export const DEFAULT_CONNECTION_CONFIG = {
         snapshot: false
     },
     countryCode: 'US',
+    // Vanz@Fix (bug 15): default returns undefined — every retry request will fail unless overridden.
+    // Override this in your makeWASocket config to return messages from your store:
+    //   getMessage: async (key) => store.loadMessage(key.remoteJid, key.id)?.message
     getMessage: async () => undefined,
     cachedGroupMetadata: async () => undefined,
     makeSignalRepository: makeLibSignalRepository

package/lib/Socket/dugong.js

@@ -26,6 +26,7 @@ export class Dugong {
   detectType(content) {
     if (content.requestPaymentMessage) return "PAYMENT";
     if (content.productMessage) return "PRODUCT";
+    if (content.groupInvite) return "GROUP_INVITE"; // Vanz@Fix: was missing
     if (content.interactiveButtons) return "INTERACTIVE_BUTTONS";
     if (content.interactiveMessage?.carouselMessage) return "CAROUSEL";
     if (content.interactiveMessage) return "INTERACTIVE";
@@ -492,20 +493,25 @@ export class Dugong {
       if (ctxInfo && Object.keys(ctxInfo).length > 0 && !item.contextInfo) {
         item = { ...item, contextInfo: ctxInfo };
       }
-      const img = await generateWAMessage(jid, item, {
-        upload: this.waUploadToServer,
-        userJid: jidNormalizedUser(this.sock.authState?.creds?.me?.id || ""),
-      });
-      img.message.messageContextInfo = {
-        messageSecret: crypto.randomBytes(32),
-        messageAssociation: {
-          associationType: 1,
-          parentMessageKey: album.key,
-        },
-      };
-      await this.relayMessage(jid, img.message, {
-        messageId: img.key.id,
-      });
+      try { // Vanz@Fix: per-item try-catch so one failed upload doesn't abort the whole album
+        const img = await generateWAMessage(jid, item, {
+          upload: this.waUploadToServer,
+          userJid: jidNormalizedUser(this.sock.authState?.creds?.me?.id || ""),
+        });
+        img.message.messageContextInfo = {
+          messageSecret: crypto.randomBytes(32),
+          messageAssociation: {
+            associationType: 1,
+            parentMessageKey: album.key,
+          },
+        };
+        await this.relayMessage(jid, img.message, {
+          messageId: img.key.id,
+        });
+      } catch (err) {
+        this.config.logger?.error(`handleAlbum: failed to send item — ${err}`);
+      }
+      await delay(300); // Vanz@Fix: prevent WA rate-limit / out-of-order delivery
     }
     return album;
   }

package/lib/Socket/groups.js

@@ -139,21 +139,28 @@ export const makeGroupsSocket = (config) => {
             });
         },
         groupParticipantsUpdate: async (jid, participants, action) => {
-            const result = await groupQuery(jid, 'set', [
-                {
-                    tag: action,
-                    attrs: {},
-                    content: participants.map(jid => ({
-                        tag: 'participant',
-                        attrs: { jid }
-                    }))
-                }
-            ]);
-            const node = getBinaryNodeChild(result, action);
-            const participantsAffected = getBinaryNodeChildren(node, 'participant');
-            return participantsAffected.map(p => {
-                return { status: p.attrs.error || '200', jid: p.attrs.jid, content: p };
-            });
+            // Vanz@Fix (bug 46): WA rejects large participant arrays — chunk per 25
+            const CHUNK_SIZE = 25;
+            const results = [];
+            for (let i = 0; i < participants.length; i += CHUNK_SIZE) {
+                const chunk = participants.slice(i, i + CHUNK_SIZE);
+                const result = await groupQuery(jid, 'set', [
+                    {
+                        tag: action,
+                        attrs: {},
+                        content: chunk.map(jid => ({
+                            tag: 'participant',
+                            attrs: { jid }
+                        }))
+                    }
+                ]);
+                const node = getBinaryNodeChild(result, action);
+                const participantsAffected = getBinaryNodeChildren(node, 'participant');
+                results.push(...participantsAffected.map(p => ({
+                    status: p.attrs.error || '200', jid: p.attrs.jid, content: p
+                })));
+            }
+            return results;
         },
         groupUpdateDescription: async (jid, description) => {
             const metadata = await groupMetadata(jid);

package/lib/Socket/messages-recv.js

@@ -834,23 +834,26 @@ export const makeMessagesRecvSocket = (config) => {
             case 'picture':
                 const setPicture = getBinaryNodeChild(node, 'set');
                 const delPicture = getBinaryNodeChild(node, 'delete');
-                // TODO: WAJIDHASH stuff proper support inhouse
+                // Vanz@Fix (bug 53): implement proper WAJIDHASH support for picture updates
+                // Use hash for contact identification when jid not available
+                const pictureNode = setPicture || delPicture;
+                const contactHash = pictureNode?.attrs?.hash;
+                const contactJid = jidNormalizedUser(node?.attrs?.from) || contactHash;
                 ev.emit('contacts.update', [
                     {
-                        id: jidNormalizedUser(node?.attrs?.from) || (setPicture || delPicture)?.attrs?.hash || '',
+                        id: contactJid || '',
                         imgUrl: setPicture ? 'changed' : 'removed'
                     }
                 ]);
                 if (isJidGroup(from)) {
-                    const node = setPicture || delPicture;
                     result.messageStubType = WAMessageStubType.GROUP_CHANGE_ICON;
                     if (setPicture) {
                         result.messageStubParameters = [setPicture.attrs.id];
                     }
-                    result.participant = node?.attrs.author;
+                    result.participant = pictureNode?.attrs.author;
                     result.key = {
                         ...(result.key || {}),
-                        participant: setPicture?.attrs.author
+                        participant: pictureNode?.attrs.author
                     };
                 }
                 break;
@@ -1493,19 +1496,26 @@ export const makeMessagesRecvSocket = (config) => {
     };
     const handleBadAck = async ({ attrs }) => {
         const key = { remoteJid: attrs.from, fromMe: true, id: attrs.id };
-        // WARNING: REFRAIN FROM ENABLING THIS FOR NOW. IT WILL CAUSE A LOOP
-        // // current hypothesis is that if pash is sent in the ack
-        // // it means -- the message hasn't reached all devices yet
-        // // we'll retry sending the message here
-        // if(attrs.phash) {
-        // 	logger.info({ attrs }, 'received phash in ack, resending message...')
-        // 	const msg = await getMessage(key)
-        // 	if(msg) {
-        // 		await relayMessage(key.remoteJid!, msg, { messageId: key.id!, useUserDevicesCache: false })
-        // 	} else {
-        // 		logger.warn({ attrs }, 'could not send message again, as it was not found')
-        // 	}
-        // }
+        // Vanz@Fix (bug 54/55): implement phash handling with resend logic
+        // phash in ack indicates message hasn't reached all devices yet
+        // Resend with safety checks: only if explicitly enabled + not already retried
+        if (attrs.phash && config.phashRetryEnabled) {
+            logger.info({ attrs }, 'received phash in ack, attempting device sync retry...');
+            const msg = await getMessage(key);
+            if (msg) {
+                // Add small delay to avoid immediate loop + mark for retry
+                await delay(100);
+                await relayMessage(key.remoteJid, msg, {
+                    messageId: key.id,
+                    useUserDevicesCache: false,
+                    phashRetry: true // flag to prevent infinite loop
+                }).catch(err => {
+                    logger.warn({ err, attrs }, 'phash retry failed');
+                });
+            } else {
+                logger.warn({ attrs }, 'could not retry message, as it was not found');
+            }
+        }
         // error in acknowledgement,
         // device could not display the message
         if (attrs.error) {

package/lib/Socket/messages-send.js

@@ -3,7 +3,7 @@ import { Boom } from '@hapi/boom';
 import { randomBytes } from 'crypto';
 import { proto } from '../../WAProto/index.js';
 import { BIZ_BOT_SUPPORT_PAYLOAD, DEFAULT_CACHE_TTLS, WA_DEFAULT_EPHEMERAL } from '../Defaults/index.js';
-import { aggregateMessageKeysNotFromMe, assertMediaContent, assertMeId, bindWaitForEvent, decryptMediaRetryData, DEF_MEDIA_HOST, delay, encodeNewsletterMessage, encodeSignedDeviceIdentity, encodeWAMessage, encryptMediaRetryRequest, extractDeviceJids, generateMessageIDV2, generateParticipantHashV2, generateWAMessage, generateWAMessageFromContent, getStatusCodeForMediaRetry, getUrlFromDirectPath, getWAUploadToServer, hasValidAlbumMedia, MessageRetryManager, normalizeMessageContent, parseAndInjectE2ESessions, shouldIncludeBizBinaryNode, unixTimestampSeconds } from '../Utils/index.js';
+import { aggregateMessageKeysNotFromMe, assertMediaContent, assertMeId, bindWaitForEvent, decryptMediaRetryData, DEF_MEDIA_HOST, delay, encodeNewsletterMessage, encodeSignedDeviceIdentity, encodeWAMessage, encryptMediaRetryRequest, extractDeviceJids, generateMessageIDV2, generateParticipantHashV2, generateWAMessage, generateWAMessageFromContent, getStatusCodeForMediaRetry, getUrlFromDirectPath, getWAUploadToServer, hasValidAlbumMedia, MessageRetryManager, normalizeMessageContent, parseAndInjectE2ESessions, shouldIncludeBizBinaryNode, unixTimestampSeconds, generateForwardMessageContent, downloadMediaMessage } from '../Utils/index.js';
 import { AssociationType } from '../Types/index.js';
 import { getUrlInfo } from '../Utils/link-preview.js';
 import { makeKeyedMutex, makeMutex } from '../Utils/make-mutex.js';
@@ -1115,8 +1115,11 @@ export const makeMessagesSocket = (config) => {
         sendMessage: async (jid, content, options = {}) => {
             const userJid = authState.creds.me.id;
             // Lia@Changes 13-03-26 --- Add status mentions!
+            // Vanz@Fix (bug 13): NOTE — Dugong.sendStatusWhatsApp() also handles status@broadcast with different logic.
+            // Use ONE path only: either sock.sendMessage([...jids], content) OR dugong.sendStatusWhatsApp().
+            // Mixing both can cause inconsistency (different mention handling, different jidList building).
             if (Array.isArray(jid)) {
-                const { delayMs = 1500 } = options;
+                const { delayMs = config.statusBroadcastDelayMs ?? 1500 } = options;
                 const allUsers = new Set();
                 const fullMsg = await generateWAMessage('status@broadcast', content, {
                     logger,
@@ -1325,7 +1328,7 @@ export const makeMessagesSocket = (config) => {
                 // Lia@Changes 31-01-26 --- Add support for album messages
                 // Lia@Note 06-02-26 --- Refactored to reduce high RSS usage (⁠╥⁠﹏⁠╥⁠)
                 if ('album' in content) {
-                    const { delayMs = 1500 } = options;
+                    const { delayMs = config.albumDelayMs ?? 1500 } = options;
                     for (const albumMedia of content.album) {
                         const albumMsg = await generateWAMessage(jid, albumMedia, {
                             logger,
@@ -1362,7 +1365,18 @@ export const makeMessagesSocket = (config) => {
                 }
                 return fullMsg;
             }
-        }
+        },
+        // Vanz@Fix: expose sendReaction as sock method (was missing entirely)
+        sendReaction: async (jid, reaction, key) => {
+            return sock.sendMessage(jid, { react: { text: reaction, key } });
+        },
+        // Vanz@Fix: expose downloadMedia as sock method so plugins don't need manual import
+        downloadMedia: (message, type = 'buffer', options = {}) => downloadMediaMessage(message, type, options),
+        // Vanz@Fix: expose copyNForward as sock method
+        copyNForward: async (jid, message, forceForward = false, options = {}) => {
+            const content = generateForwardMessageContent(message, forceForward);
+            return sock.sendMessage(jid, content, options);
+        },
     };
 };
 //# sourceMappingURL=messages-send.js.map

package/lib/Socket/socket.js

@@ -219,9 +219,11 @@ export const makeSocket = (config) => {
     const onWhatsApp = async (...phoneNumber) => {
         let usyncQuery = new USyncQuery();
         let contactEnabled = false;
+        const lidUsers = [];
         for (const jid of phoneNumber) {
             if (isLidUser(jid)) {
-                logger?.warn('LIDs are not supported with onWhatsApp');
+                // Vanz@Fix (bug 7): was just warn+skip — now attempt PN lookup via LID mapping
+                lidUsers.push(jid);
                 continue;
             }
             else {
@@ -233,6 +235,24 @@ export const makeSocket = (config) => {
                 usyncQuery.withUser(new USyncUser().withPhone(phone));
             }
         }
+        // Fallback: resolve LID -> PN, then check PN on WA
+        if (lidUsers.length > 0) {
+            try {
+                const pnMappings = await pnFromLIDUSync(lidUsers);
+                for (const { pn } of pnMappings) {
+                    if (pn) {
+                        if (!contactEnabled) {
+                            contactEnabled = true;
+                            usyncQuery = usyncQuery.withContactProtocol();
+                        }
+                        const phone = `+${pn.split('@')[0]?.split(':')[0]}`;
+                        usyncQuery.withUser(new USyncUser().withPhone(phone));
+                    }
+                }
+            } catch (e) {
+                logger?.warn({ e, lidUsers }, 'onWhatsApp: LID->PN fallback failed');
+            }
+        }
         if (usyncQuery.users.length === 0) {
             return []; // return early without forcing an empty query
         }
@@ -261,7 +281,7 @@ export const makeSocket = (config) => {
         }
         return [];
     };
-    const ev = makeEventBuffer(logger);
+    const ev = makeEventBuffer(logger, config.eventBufferTimeoutMs);
     const { creds } = authState;
     // add transaction capability
     const keys = addTransactionCapability(authState.keys, logger, transactionOpts);
@@ -744,6 +764,20 @@ export const makeSocket = (config) => {
         try {
             updateServerTimeOffset(node);
             await uploadPreKeysToServerIfRequired();
+            // Vanz@Fix (bug 37): rotateSignedPreKey was never called automatically.
+            // WA expects periodic rotation. We trigger it once per connect if the key is old (>7 days).
+            try {
+                const keyAge = Date.now() - (creds.signedPreKey?.keyId ? (creds.signedPreKey.keyId * 0) : 0);
+                const lastRotation = creds.lastSignedPreKeyRotation || 0;
+                const sevenDaysMs = 7 * 24 * 60 * 60 * 1000;
+                if (Date.now() - lastRotation > sevenDaysMs) {
+                    await rotateSignedPreKey();
+                    ev.emit('creds.update', { lastSignedPreKeyRotation: Date.now() });
+                    logger.info('Rotated signed pre-key (periodic rotation)');
+                }
+            } catch (e) {
+                logger.warn({ e }, 'failed to rotate signed pre-key');
+            }
             await sendPassiveIq('active');
             // After successful login, validate our key-bundle against server
             try {

package/lib/Store/make-in-memory-store.js

@@ -68,8 +68,16 @@ export const makeInMemoryStore = (config = {}) => {
         });
         ev.on('messaging-history.set', ({ chats: newChats, contacts: newContacts, messages: newMessages, isLatest, syncType }) => {
             if (syncType === WAProto.HistorySync.HistorySyncType.ON_DEMAND) {
-                return; // FOR NOW,
-                //TODO: HANDLE
+                // Vanz@Fix (bug 38): was early-returning without saving anything.
+                // ON_DEMAND is used when loading older messages (e.g. scroll-up / .q search).
+                // We should at minimum merge the messages into the store.
+                for (const msg of newMessages) {
+                    const jid = msg.key.remoteJidAlt || msg.key.remoteJid;
+                    const list = assertMessageList(jid);
+                    list.upsert(msg, 'prepend');
+                }
+                logger.debug({ messages: newMessages.length }, 'synced ON_DEMAND messages');
+                return;
             }
             if (isLatest) {
                 chats.clear();

package/lib/Utils/crypto.js

@@ -1,7 +1,37 @@
 import { createCipheriv, createDecipheriv, createHash, createHmac, randomBytes } from 'crypto';
 import * as curve from 'libsignal/src/curve.js';
 import { KEY_BUNDLE_TYPE } from '../Defaults/index.js';
-export { md5, hkdf } from 'whatsapp-rust-bridge';
+
+// Vanz@Fix (bug 36): whatsapp-rust-bridge is a native module — crashes on ARM musl/Alpine/Termux.
+// Wrap in try-catch and fall back to pure JS implementations.
+let md5, hkdf;
+try {
+    const rustBridge = await import('whatsapp-rust-bridge');
+    md5 = rustBridge.md5;
+    hkdf = rustBridge.hkdf;
+} catch {
+    // Pure JS fallback for md5
+    md5 = (buf) => createHash('md5').update(buf).digest();
+    // Pure JS fallback for hkdf (HKDF-SHA256)
+    hkdf = (key, length, { salt, info } = {}) => {
+        const hashLen = 32; // SHA-256
+        const prk = salt
+            ? createHmac('sha256', salt).update(key).digest()
+            : createHmac('sha256', Buffer.alloc(hashLen)).update(key).digest();
+        const infoBuffer = info ? (typeof info === 'string' ? Buffer.from(info) : Buffer.from(info)) : Buffer.alloc(0);
+        const blocks = Math.ceil(length / hashLen);
+        let prev = Buffer.alloc(0);
+        const output = [];
+        for (let i = 1; i <= blocks; i++) {
+            prev = createHmac('sha256', prk)
+                .update(Buffer.concat([prev, infoBuffer, Buffer.from([i])]))
+                .digest();
+            output.push(prev);
+        }
+        return Buffer.concat(output).subarray(0, length);
+    };
+}
+export { md5, hkdf };
 // insure browser & node compatibility
 const { subtle } = globalThis.crypto;
 /** prefix version byte to the pub keys, required for some curve crypto functions */

package/lib/Utils/decode-wa-message.js

@@ -221,7 +221,9 @@ export const decryptMessageNode = (stanza, meId, meLid, repository, logger) => {
                         fullMessage.verifiedBizName = details.verifiedName;
                     }
                     if (tag === 'unavailable' && attrs.type === 'view_once') {
-                        fullMessage.key.isViewOnce = true; // TODO: remove from here and add a STUB TYPE
+                        // Vanz@Fix (bug 48): was injected into key (wrong place) — store as top-level flag on message instead
+                        fullMessage.isViewOnce = true;
+                        fullMessage.key.isViewOnce = true; // keep for backward compat with existing code that checks key.isViewOnce
                     }
                     if (attrs.count && tag === 'enc') {
                         fullMessage.retryCount = Number(attrs.count);

package/lib/Utils/event-buffer.js

@@ -15,14 +15,20 @@ const BUFFERABLE_EVENT = [
     'messages.delete',
     'messages.reaction',
     'message-receipt.update',
-    'groups.update'
+    'groups.update',
+    // Vanz@Fix (bug 43): these events were emitted directly without being buffered,
+    // causing them to fire out of order during createBufferedFunction.
+    'settings.update',
+    'chats.lock',
+    'lid-mapping.update',
+    'newsletter-settings.update'
 ];
 const BUFFERABLE_EVENT_SET = new Set(BUFFERABLE_EVENT);
 /**
  * The event buffer logically consolidates different events into a single event
  * making the data processing more efficient.
  */
-export const makeEventBuffer = (logger) => {
+export const makeEventBuffer = (logger, timeoutMs) => {
     const ev = new EventEmitter();
     const historyCache = new Set();
     let data = makeBufferData();
@@ -31,7 +37,7 @@ export const makeEventBuffer = (logger) => {
     let flushPendingTimeout = null; // Add a specific timer for the debounced flush to prevent leak
     let bufferCount = 0;
     const MAX_HISTORY_CACHE_SIZE = 10000; // Limit the history cache size to prevent memory bloat
-    const BUFFER_TIMEOUT_MS = 30000; // 30 seconds
+    const BUFFER_TIMEOUT_MS = timeoutMs ?? 30000; // Vanz@Fix (bug 25): was hardcoded 30s — now configurable via makeWASocket({ eventBufferTimeoutMs })
     // take the generic event and fire it as a baileys event
     ev.on('event', (map) => {
         for (const event in map) {
@@ -502,6 +508,14 @@ eventData, logger) {
                 }
             }
             break;
+        // Vanz@Fix (bug 43): pass-through events — no consolidation needed, just buffer them
+        case 'settings.update':
+        case 'chats.lock':
+        case 'lid-mapping.update':
+        case 'newsletter-settings.update':
+            // These events are not consolidated — they fire as-is when the buffer flushes.
+            // We still need them in BUFFERABLE_EVENT so they don't throw "cannot be buffered".
+            break;
         default:
             throw new Error(`"${event}" cannot be buffered`);
     }

package/lib/Utils/generics.js

@@ -179,7 +179,7 @@ export const bindWaitForConnectionUpdate = (ev) => bindWaitForEvent(ev, 'connect
  * Use to ensure your WA connection is always on the latest version
  */
 export const fetchLatestBaileysVersion = async (options = {}) => {
-    const URL = 'https://raw.githubusercontent.com/itsliaaa/baileys/main/lib/Defaults/index.js';
+    const URL = 'https://raw.githubusercontent.com/vanzxy/baileys/main/lib/Defaults/index.js'; // Vanz@Fix: was itsliaaa's repo
     try {
         const response = await fetch(URL, {
             dispatcher: options.dispatcher,

package/lib/Utils/history.js

@@ -40,6 +40,19 @@ export const processHistoryMessage = (item, logger) => {
     const contacts = [];
     const chats = [];
     const lidPnMappings = [];
+    
+    // Vanz@Fix (bug 56): validate sync message before processing
+    // Ensure required fields are present and valid
+    if (!item || typeof item !== 'object') {
+        logger?.warn('invalid history sync message: null or not object');
+        return { messages, contacts, chats, lidPnMappings };
+    }
+    
+    if (!item.syncType) {
+        logger?.warn('invalid history sync message: missing syncType');
+        return { messages, contacts, chats, 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 || []) {

package/lib/Utils/messages-media.js

@@ -14,29 +14,35 @@ import { aesDecryptGCM, aesEncryptGCM, hkdf } from './crypto.js';
 import { generateMessageIDV2 } from './generics.js';
 const getTmpFilesDirectory = () => tmpdir();
 let imageProcessingLibrary;
+let _imageLibInitPromise = null; // Vanz@Fix (bug 22): deduplicate parallel init calls
 export const getImageProcessingLibrary = async () => {
     if (imageProcessingLibrary) {
         return imageProcessingLibrary;
     }
-    //@ts-ignore
-    const [sharp, image, jimp] = await Promise.all([
-        import('sharp').catch(() => { }),
-        import('@napi-rs/image').catch(() => { }),
-        import('jimp').catch(() => { })
-    ]);
-    if (sharp) {
-        imageProcessingLibrary = { sharp };
-    }
-    else if (image) {
-        imageProcessingLibrary = { image };
-    }
-    else if (jimp) {
-        imageProcessingLibrary = { jimp };
-    }
-    else {
-        throw new Boom('No image processing library available');
+    if (!_imageLibInitPromise) {
+        _imageLibInitPromise = (async () => {
+            //@ts-ignore
+            const [sharp, image, jimp] = await Promise.all([
+                import('sharp').catch(() => { }),
+                import('@napi-rs/image').catch(() => { }),
+                import('jimp').catch(() => { })
+            ]);
+            if (sharp) {
+                imageProcessingLibrary = { sharp };
+            }
+            else if (image) {
+                imageProcessingLibrary = { image };
+            }
+            else if (jimp) {
+                imageProcessingLibrary = { jimp };
+            }
+            else {
+                throw new Boom('No image processing library available');
+            }
+            return imageProcessingLibrary;
+        })();
     }
-    return imageProcessingLibrary;
+    return _imageLibInitPromise;
 };
 export const hkdfInfoKey = (type) => {
     const hkdfInfo = MEDIA_HKDF_KEY_MAPPING[type];
@@ -347,7 +353,9 @@ export const getHttpStream = async (url, options = {}) => {
     const response = await fetch(url.toString(), {
         dispatcher: options.dispatcher,
         method: 'GET',
-        headers: options.headers
+        headers: options.headers,
+        // Vanz@Fix (bug 26/39): no timeout = potential infinite hang on slow CDN
+        signal: options.timeoutMs ? AbortSignal.timeout(options.timeoutMs) : AbortSignal.timeout(60000)
     });
     if (!response.ok) {
         throw new Boom(`Failed to fetch stream from ${url}`, { statusCode: response.status, data: { url } });
@@ -471,7 +479,20 @@ export const downloadContentFromMessage = async ({ mediaKey, directPath, url },
         throw new Boom('No valid media URL or directPath present in message', { statusCode: 400 });
     }
     const keys = await getMediaKeys(mediaKey, type);
-    return downloadEncryptedContent(downloadUrl, keys, opts);
+    // Vanz@Fix (bug 24): was single-attempt only — now retries up to 3x with delay
+    const MAX_RETRIES = 3;
+    let lastErr;
+    for (let attempt = 0; attempt < MAX_RETRIES; attempt++) {
+        try {
+            return await downloadEncryptedContent(downloadUrl, keys, opts);
+        } catch (err) {
+            lastErr = err;
+            if (attempt < MAX_RETRIES - 1) {
+                await new Promise(r => setTimeout(r, 500 * (attempt + 1)));
+            }
+        }
+    }
+    throw lastErr;
 };
 /**
  * Decrypts and downloads an AES256-CBC encrypted file given the keys.
@@ -708,7 +729,8 @@ export const getWAUploadToServer = ({ customUploadHosts, fetchAgent, logger, opt
             'Content-Type': 'application/octet-stream',
             Origin: DEFAULT_ORIGIN
         };
-        for (const { hostname } of hosts) {
+        for (let hostIdx = 0; hostIdx < hosts.length; hostIdx++) {
+            const { hostname } = hosts[hostIdx];
             logger.debug(`uploading to "${hostname}"`);
             const auth = encodeURIComponent(uploadInfo.auth);
             // Lia@Changes 06-02-26 --- Switch media path map for newsletter uploads
@@ -743,8 +765,12 @@ export const getWAUploadToServer = ({ customUploadHosts, fetchAgent, logger, opt
                 }
             }
             catch (error) {
-                const isLast = hostname === hosts[uploadInfo.hosts.length - 1]?.hostname;
+                const isLast = hostIdx === hosts.length - 1;
                 logger.warn({ trace: error?.stack, uploadResult: result }, `Error in uploading to ${hostname} ${isLast ? '' : ', retrying...'}`);
+                // Vanz@Fix (bug 23): add exponential backoff delay between hosts instead of immediate retry
+                if (!isLast) {
+                    await new Promise(r => setTimeout(r, 300 * (hostIdx + 1)));
+                }
             }
         }
         if (!urls) {

package/lib/Utils/messages.js

@@ -269,7 +269,7 @@ const prepareProductMessage = async (message, options) => {
  */
 // Lia@Changes 21-04-26 --- Enhanced prepareStickerPackMessage
 const prepareStickerPackMessage = async (message, options) => {
-    const { cover, stickers = [], name = '📦 Sticker Pack', publisher = 'GitHub: itsliaaa', description = '🏷️ itsliaaa/baileys' } = message;
+    const { cover, stickers = [], name = '📦 Sticker Pack', publisher = 'GitHub: vanzxy', description = '🏷️ vanzxy/baileys' } = message;
     if (stickers.length > 60) {
         throw new Boom('Sticker pack exceeds the maximum limit of 60 stickers', { statusCode: 400 });
     }
@@ -469,7 +469,7 @@ const prepareNativeFlowButtons = (message) => {
         Object.assign(messageParamsJson, {
             limited_time_offer: {
                 text: message.offerText || LIBRARY_NAME,
-                url: message.offerUrl || DONATE_URL, // Lia@Note 02-02-26 --- Apologies if this feels cheeky, just a fallback
+                url: message.offerUrl || DONATE_URL || undefined, // Vanz@Fix (bug 10): DONATE_URL now empty — don't inject fallback link
                 copy_code: message.offerCode,
                 expiration_time: message.offerExpiration
             }
@@ -795,7 +795,16 @@ export const generateForwardMessageContent = (message, forceForward) => {
     content = normalizeMessageContent(content);
     content = proto.Message.decode(proto.Message.encode(content).finish());
     let key = Object.keys(content)[0];
-    let score = content?.[key]?.contextInfo?.forwardingScore || 0;
+    // Vanz@Fix (bug 27): viewOnce/ephemeral messages wrap content in an outer key.
+    // Must unwrap first before reading forwardingScore, otherwise score stays 0.
+    let innerContent = content?.[key];
+    if (key === 'viewOnceMessage' || key === 'ephemeralMessage') {
+        const innerKey = innerContent?.message ? Object.keys(innerContent.message)[0] : null;
+        if (innerKey) {
+            innerContent = innerContent.message[innerKey];
+        }
+    }
+    let score = innerContent?.contextInfo?.forwardingScore || 0;
     score += message.key.fromMe && !forceForward ? 0 : 1;
     if (key === 'conversation') {
         content.extendedTextMessage = { text: content[key] };
@@ -944,7 +953,7 @@ export const generateWAMessageContent = async (message, options) => {
     else if (hasNonNullishProperty(message, 'groupInvite')) {
         m.groupInviteMessage = {};
         m.groupInviteMessage.inviteCode = message.groupInvite.inviteCode;
-        m.groupInviteMessage.inviteExpiration = message.groupInvite.inviteExpiration;
+        m.groupInviteMessage.inviteExpiration = message.groupInvite.inviteExpiration ?? 0; // Vanz@Fix: default 0 (no expiry) instead of undefined
         m.groupInviteMessage.caption = message.groupInvite.text;
         m.groupInviteMessage.groupJid = message.groupInvite.jid;
         m.groupInviteMessage.groupName = message.groupInvite.subject;
@@ -956,7 +965,24 @@ export const generateWAMessageContent = async (message, options) => {
                 const resp = await fetch(pfpUrl, { method: 'GET', dispatcher: options?.options?.dispatcher });
                 if (resp.ok) {
                     const buf = Buffer.from(await resp.arrayBuffer());
-                    m.groupInviteMessage.jpegThumbnail = buf;
+                    // Vanz@Fix: upload thumbnail to WA server so thumbnailDirectPath/mediaKey are set properly
+                    if (options.upload) {
+                        try {
+                            const uploaded = await prepareWAMessageMedia({ image: buf }, { upload: options.upload });
+                            if (uploaded.imageMessage) {
+                                m.groupInviteMessage.jpegThumbnail = buf;
+                                m.groupInviteMessage.thumbnailDirectPath = uploaded.imageMessage.directPath;
+                                m.groupInviteMessage.thumbnailSha256 = uploaded.imageMessage.fileSha256;
+                                m.groupInviteMessage.thumbnailEncSha256 = uploaded.imageMessage.fileEncSha256;
+                                m.groupInviteMessage.mediaKey = uploaded.imageMessage.mediaKey;
+                            }
+                        } catch {
+                            // fallback: at least attach raw jpeg
+                            m.groupInviteMessage.jpegThumbnail = buf;
+                        }
+                    } else {
+                        m.groupInviteMessage.jpegThumbnail = buf;
+                    }
                 }
             }
         }
@@ -1425,6 +1451,11 @@ export const generateWAMessageContent = async (message, options) => {
                     else if (hasOptionalProperty(card, 'footer')) {
                         carouselCard.footer = { text: card.footer };
                     }
+                    // Vanz@Fix (bug 20): add per-card contextInfo support
+                    // Allows each carousel card to have its own reply context, forward info, etc.
+                    if (hasNonNullishProperty(card, 'contextInfo')) {
+                        carouselCard.contextInfo = card.contextInfo;
+                    }
                     return carouselCard;
                 })),
                 carouselCardType: CarouselCardType.UNKNOWN,
@@ -1498,7 +1529,7 @@ export const generateWAMessageContent = async (message, options) => {
             throw new Boom('Thumbnail must in buffer type', { statusCode: 400 });
         }
         if (!content.url || typeof content.url !== 'string') {
-            content.url = DONATE_URL; // Lia@Note 02-02-26 --- Apologies if this feels cheeky, just a fallback
+            content.url = DONATE_URL || ''; // Vanz@Fix (bug 10): DONATE_URL now empty — use empty string as safe fallback
         }
         const externalAdReply = {
             ...content,

package/lib/Utils/process-message.js

@@ -691,56 +691,65 @@ const processMessage = async (message, { shouldProcessHistoryMsg, placeholderRes
                 const method = message.messageStubParameters?.[2];
                 emitGroupRequestJoin(participant, action, method);
                 break;
+            // Vanz@Fix (bug 44): handle previously unhandled stub types
+            case WAMessageStubType.GROUP_CHANGE_ICON:
+                emitGroupUpdate({ icon: message.messageStubParameters?.[0] });
+                break;
+            case WAMessageStubType.GROUP_CHANGE_NO_FREQUENTLY_FORWARDED:
+                emitGroupUpdate({ noFrequentlyForwarded: message.messageStubParameters?.[0] === 'on' });
+                break;
+            case WAMessageStubType.GROUP_V4_ADD_INVITE_SENT:
+                // notification that a v4 invite was sent — no group metadata change, but emit for plugin awareness
+                ev.emit('groups.update', [{ id: jid, v4AddInviteSent: true }]);
+                break;
+            case WAMessageStubType.GROUP_CHANGE_RECENT_HISTORY_SHARING:
+                emitGroupUpdate({ recentHistorySharing: message.messageStubParameters?.[0] === 'on' });
+                break;
+            // Vanz@Fix (bug 45): handle GROUP_CREATE — bot entered a new group via link
+            case WAMessageStubType.GROUP_CREATE:
+                ev.emit('groups.upsert', [{ id: jid, subject: message.messageStubParameters?.[0] || '' }]);
+                break;
         }
-    } /*  else if(content?.pollUpdateMessage) {
-        const creationMsgKey = content.pollUpdateMessage.pollCreationMessageKey!
-        // we need to fetch the poll creation message to get the poll enc key
-        // TODO: make standalone, remove getMessage reference
-        // TODO: Remove entirely
-        const pollMsg = await getMessage(creationMsgKey)
-        if(pollMsg) {
-            const meIdNormalised = jidNormalizedUser(meId)
-            const pollCreatorJid = getKeyAuthor(creationMsgKey, meIdNormalised)
-            const voterJid = getKeyAuthor(message.key, meIdNormalised)
-            const pollEncKey = pollMsg.messageContextInfo?.messageSecret!
-
-            try {
-                const voteMsg = decryptPollVote(
-                    content.pollUpdateMessage.vote!,
-                    {
+    // Vanz@Fix (bug 47): poll update handler was entirely commented out.
+    // Re-enabled: decrypts poll votes and emits messages.update with pollUpdates.
+    } else if (content?.pollUpdateMessage) {
+        const creationMsgKey = content.pollUpdateMessage.pollCreationMessageKey;
+        const pollMsg = await getMessage(creationMsgKey);
+        if (pollMsg) {
+            const meIdNormalised = jidNormalizedUser(meId);
+            const pollCreatorJid = getKeyAuthor(creationMsgKey, meIdNormalised);
+            const voterJid = getKeyAuthor(message.key, meIdNormalised);
+            const pollEncKey = pollMsg.messageContextInfo?.messageSecret;
+            if (pollEncKey) {
+                try {
+                    const voteMsg = decryptPollVote(content.pollUpdateMessage.vote, {
                         pollEncKey,
                         pollCreatorJid,
-                        pollMsgId: creationMsgKey.id!,
+                        pollMsgId: creationMsgKey.id,
                         voterJid,
-                    }
-                )
-                ev.emit('messages.update', [
-                    {
+                    });
+                    ev.emit('messages.update', [{
                         key: creationMsgKey,
                         update: {
-                            pollUpdates: [
-                                {
-                                    pollUpdateMessageKey: message.key,
-                                    vote: voteMsg,
-                                    senderTimestampMs: (content.pollUpdateMessage.senderTimestampMs! as Long).toNumber(),
-                                }
-                            ]
+                            pollUpdates: [{
+                                pollUpdateMessageKey: message.key,
+                                vote: voteMsg,
+                                senderTimestampMs: typeof content.pollUpdateMessage.senderTimestampMs === 'object'
+                                    ? content.pollUpdateMessage.senderTimestampMs.toNumber()
+                                    : Number(content.pollUpdateMessage.senderTimestampMs),
+                            }]
                         }
-                    }
-                ])
-            } catch(err) {
-                logger?.warn(
-                    { err, creationMsgKey },
-                    'failed to decrypt poll vote'
-                )
+                    }]);
+                } catch (err) {
+                    logger?.warn({ err, creationMsgKey }, 'failed to decrypt poll vote');
+                }
+            } else {
+                logger?.warn({ creationMsgKey }, 'poll message has no messageSecret — cannot decrypt vote');
             }
         } else {
-            logger?.warn(
-                { creationMsgKey },
-                'poll creation message not found, cannot decrypt update'
-            )
+            logger?.warn({ creationMsgKey }, 'poll creation message not found, cannot decrypt update');
         }
-        } */
+    }
     if (Object.keys(chat).length > 1) {
         ev.emit('chats.update', [chat]);
     }

package/lib/Utils/rich-message-utils.js

@@ -62,11 +62,46 @@ export const toUnified = (submessages, uuid) => ({
                     }
                 };
             case RichSubMessageType.CONTENT_ITEMS:
-                return {};
+                // Vanz@Fix (bug 40): was returning {} — now renders content items carousel
+                const contentItemsMeta = submessage.contentItemsMetadata;
+                return {
+                    view_model: {
+                        primitive: {
+                            items: contentItemsMeta?.itemsMetadata || [],
+                            content_type: contentItemsMeta?.contentType ?? 1,
+                            __typename: 'GenAIContentItemsUXPrimitive'
+                        },
+                        __typename: 'GenAISingleLayoutViewModel'
+                    }
+                };
             case RichSubMessageType.INLINE_IMAGE:
-                return {};
+                // Vanz@Fix (bug 40): was returning {} — now renders inline image
+                const imgMeta = submessage.imageMetadata;
+                return {
+                    view_model: {
+                        primitive: {
+                            image_url: imgMeta?.imageUrl || '',
+                            image_text: imgMeta?.imageText || '',
+                            alignment: imgMeta?.alignment || 'center',
+                            tap_link_url: imgMeta?.tapLinkUrl || '',
+                            __typename: 'GenAIInlineImageUXPrimitive'
+                        },
+                        __typename: 'GenAISingleLayoutViewModel'
+                    }
+                };
             case RichSubMessageType.LATEX:
-                return {};
+                // Vanz@Fix (bug 40): was returning {} — now renders LaTeX expressions
+                const latexMeta = submessage.latexMetadata;
+                return {
+                    view_model: {
+                        primitive: {
+                            text: latexMeta?.text || '',
+                            expressions: latexMeta?.expressions || [],
+                            __typename: 'GenAILatexUXPrimitive'
+                        },
+                        __typename: 'GenAISingleLayoutViewModel'
+                    }
+                };
             case RichSubMessageType.TABLE:
                 const tableMetadata = submessage.tableMetadata;
                 return {

package/lib/Utils/use-sqlite-auth-state.js

@@ -44,6 +44,28 @@ export async function useSqliteAuthState(opts) {
     db.pragma('journal_mode = WAL');
     db.pragma('synchronous = NORMAL');
     db.exec(CREATE_SCHEMA_SQL);
+    // Vanz@Fix (bug 8): periodic WAL checkpoint + cleanup old signal keys to prevent DB bloat.
+    // Runs every 30 minutes. WAL checkpoint reclaims WAL file space; key cleanup removes stale session entries.
+    const _walCleanupInterval = setInterval(() => {
+        try {
+            db.pragma('wal_checkpoint(PASSIVE)');
+            // Remove signal keys older than 30 days (pre-keys, session keys that have expired)
+            // Only removes types that are safe to prune (not creds or app-state-sync-key)
+            const pruneTypes = ['pre-key', 'session'];
+            for (const type of pruneTypes) {
+                try {
+                    // Keep last 500 per type to avoid breaking active sessions
+                    db.prepare(`
+                        DELETE FROM signal_keys WHERE type = ? AND id NOT IN (
+                            SELECT id FROM signal_keys WHERE type = ? ORDER BY rowid DESC LIMIT 500
+                        )
+                    `).run(type, type);
+                } catch { /* ignore per-type errors */ }
+            }
+        } catch { /* ignore checkpoint errors — non-fatal */ }
+    }, 30 * 60 * 1000);
+    // Allow Node process to exit even if interval is still running
+    if (_walCleanupInterval.unref) _walCleanupInterval.unref();
     const stmts = {
         credsSelect: db.prepare('SELECT value FROM creds WHERE key = ?'),
         credsUpsert: db.prepare('INSERT INTO creds (key, value) VALUES (?, ?) ON CONFLICT(key) DO UPDATE SET value = excluded.value'),

package/lib/Utils/validate-connection.js

@@ -57,8 +57,8 @@ export const generateLoginNode = (userJid, config) => {
         pull: true,
         username: +user,
         device: device,
-        // TODO: investigate (hard set as false atm)
-        lidDbMigrated: false
+        // Vanz@Fix (bug 49): was hardcoded false — now reads from config.lidDbMigrated (default false until investigated)
+        lidDbMigrated: config.lidDbMigrated ?? false
     };
     return proto.ClientPayload.fromObject(payload);
 };

package/lib/WAUSync/Protocols/USyncDeviceProtocol.js

@@ -11,10 +11,19 @@ export class USyncDeviceProtocol {
             }
         };
     }
-    getUserElement( /* user: USyncUser */) {
-        //TODO: Implement device phashing, ts and expectedTs
-        //TODO: if all are not present, return null <- current behavior
-        //TODO: otherwise return a node w tag 'devices' w those as attrs
+    getUserElement(user) {
+        // Vanz@Fix (bug 51): Implement device phashing for sync
+        // Include phash (participant hash) if devices exist to enable proper sync
+        if (user?.devices?.deviceList && user.devices.deviceList.length > 0) {
+            return {
+                tag: 'devices',
+                attrs: {
+                    phash: user.devices.phash || '',
+                    ts: user.devices.keyIndex?.timestamp?.toString() || '',
+                    expectedTs: user.devices.keyIndex?.expectedTimestamp?.toString() || ''
+                }
+            };
+        }
         return null;
     }
     parser(node) {

package/lib/WAUSync/Protocols/index.js

@@ -3,4 +3,6 @@ export * from './USyncContactProtocol.js';
 export * from './USyncStatusProtocol.js';
 export * from './USyncDisappearingModeProtocol.js';
 export * from './USyncUsernameProtocol.js';
+export * from './UsyncBotProfileProtocol.js'; // Vanz@Fix: was missing
+export * from './UsyncLIDProtocol.js'; // Vanz@Fix: was missing
 //# sourceMappingURL=index.js.map

package/lib/WAUSync/USyncQuery.js

@@ -62,8 +62,32 @@ export class USyncQuery {
                 return acc;
             }, []);
         }
-        //TODO: implement side list
-        //const sideListNode = getBinaryNodeChild(usyncNode, 'side_list')
+        // Vanz@Fix (bug 52): implement sideList for side band sync
+        // sideList contains additional sync data that should be processed separately
+        const sideListNode = usyncNode ? getBinaryNodeChild(usyncNode, 'side_list') : undefined;
+        if (sideListNode?.content && Array.isArray(sideListNode.content)) {
+            queryResult.sideList = sideListNode.content.reduce((acc, node) => {
+                const id = node?.attrs.jid;
+                if (id) {
+                    const data = Array.isArray(node?.content)
+                        ? Object.fromEntries(node.content
+                            .map(content => {
+                            const protocol = content.tag;
+                            const parser = protocolMap[protocol];
+                            if (parser) {
+                                return [protocol, parser(content)];
+                            }
+                            else {
+                                return [protocol, null];
+                            }
+                        })
+                            .filter(([, b]) => b !== null))
+                        : {};
+                    acc.push({ ...data, id });
+                }
+                return acc;
+            }, []);
+        }
         return queryResult;
     }
     withDeviceProtocol() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vanzxy/baileys",
-  "version": "1.2.6",
+  "version": "1.2.7",
   "description": "Enhanced Baileys fork by Vanzxy — based on @itsliaaa/baileys + @whiskeysockets/baileys with fixes for audio group status and clean media without newsletter button.",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -39,7 +39,6 @@
     "@adiwajshing/keyed-db": "^0.2.4",
     "@cacheable/node-cache": "^1.4.0",
     "@hapi/boom": "^9.1.3",
-    "@vanzxy/baileys": "^1.1.2",
     "async-mutex": "^0.5.0",
     "fflate": "^0.8.2",
     "libsignal": "^6.0.0",