@neelegirl/baileys 2.1.7 → 2.1.9

package/README.md

@@ -3,7 +3,7 @@
 # @neelegirl/baileys
 
 ### CommonJS WhatsApp Web runtime for Neelegirl projects
-### Conservative merge strategy based on WhiskeySockets/Baileys
+### Conservative merge strategy based on WhiskeySockets/Baileys with QR, pairing, and LID/libsignal maintenance
 
 [![npm version](https://img.shields.io/npm/v/@neelegirl/baileys?style=for-the-badge&color=ff69b4&logo=npm)](https://www.npmjs.com/package/@neelegirl/baileys)
 [![node](https://img.shields.io/badge/node-%3E%3D20-2ea043?style=for-the-badge&logo=node.js)](https://nodejs.org)
@@ -19,7 +19,7 @@
 
 | Package | Version | Main goal |
 |---|---:|---|
-| `@neelegirl/baileys` | `2.1.7` | Stable Neelegirl fork with preserved project-specific runtime behavior |
+| `@neelegirl/baileys` | `2.1.9` | Stable Neelegirl fork with preserved project-specific runtime behavior |
 
 [Installation](#installation) · [Quickstart](#quickstart) · [Protected logic](#protected-logic) · [Device and LID notes](#device-and-lid-notes) · [Verified exports](#verified-exports) · [Release notes](#release-notes)
 
@@ -30,9 +30,10 @@
 ## Table of Contents
 
 - [Overview](#overview)
+- [Stack relationship](#stack-relationship)
 - [Why this fork exists](#why-this-fork-exists)
 - [Protected logic](#protected-logic)
-- [What was updated in 2.1.6](#what-was-updated-in-216)
+- [What was updated in 2.1.9](#what-was-updated-in-219)
 - [Installation](#installation)
 - [Imports](#imports)
 - [Quickstart](#quickstart)
@@ -50,13 +51,31 @@
 
 `@neelegirl/baileys` is the local CommonJS-oriented Neelegirl fork of Baileys used in this stack. It is meant to keep existing Neelegirl-specific behavior stable while still absorbing compatible fixes from the public WhiskeySockets/Baileys project where that improves correctness.
 
-This package was rechecked against the public WhiskeySockets/Baileys repository on `2026-03-19`. The merge strategy is conservative by design:
+This package was rechecked against the public WhiskeySockets/Baileys repository and the repaired local source package on `2026-03-20`. The merge strategy is conservative by design:
 
 - keep working Neelegirl runtime behavior
 - adopt compatible fixes
 - avoid blind upstream replacement
 - avoid destructive refactors in project-critical paths
 
+## Stack relationship
+
+This fork sits in the middle of the local Neelegirl WhatsApp stack.
+
+| Package | Role | Why it matters here |
+|---|---|---|
+| `@neelegirl/baileys` | WhatsApp Web runtime and socket layer | Owns QR, pairing, events, message send/recv, device handling |
+| `@neelegirl/libsignal` | Signal session and identity runtime | Owns session cipher state, identity keys, and LID-aware session migration helpers |
+| `@neelegirl/wa-api` | Convenience wrapper | Wraps the socket for multi-session management and simpler app integration |
+
+The recent maintenance pass specifically verified that the Baileys socket layer and the local libsignal-facing repository agree again on:
+
+- pairing-code platform handling for WhatsApp Web-style flows
+- LID-to-PN mapping storage
+- session migration helpers
+- history-sync mapping capture
+- conservative JID and device normalization
+
 ## Why this fork exists
 
 The local package differs from upstream for practical reasons:
@@ -77,12 +96,31 @@ The following logic was explicitly treated as protected during maintenance:
 - QR-code generation and QR lifecycle
 - `NEELE` message-ID generation and related custom handling
 - existing Neelegirl branding and log output
+- existing WhatsApp Web / browser-specific pairing behavior
 - existing device, watch, and platform-specific behavior
 - existing custom community and message-stub handling
 - existing message-type behavior for conversation, extended text, media, and context handling
 
 Nothing in those areas was blindly replaced with upstream code.
 
+## What was updated in 2.1.9
+
+### Runtime hotfixes
+
+- fixed hosted device `99` migration so PN sessions move into `@hosted.lid` instead of an invalid plain `@lid` target
+- fixed hosted PN session lookup during PN to LID migration by resolving the actual Signal address key instead of assuming the plain PN key shape
+- fixed `lru-cache` compatibility so the local CommonJS build works with both direct-class and named-export variants
+- unblocked `LIDMappingStore` initialization during real bot startup
+- unblocked the migrated session cache and retry caches that rely on the same constructor shape
+- kept QR flow, `NEELE` message-ID logic, and project-specific device/watch handling untouched
+
+### Verified after the hotfix
+
+- hosted device `99` mock migrations now land on `hosted.lid` Signal addresses and no longer get skipped
+- multi-session startup completed successfully in the local Neelegirl runtime
+- LID/device watch output continued to work after the patch
+- the package now starts without the `LRUCache is not a constructor` crash seen before this release
+
 ## What was updated in 2.1.6
 
 ### Runtime compatibility
@@ -400,6 +438,8 @@ const result = transferDevice(
 )
 ```
 
+When the source JID is a hosted device such as `491234567890:99@hosted`, the helper now keeps that hosted device space and returns `1234567890:99@hosted.lid`.
+
 ### Why this matters here
 
 Neelegirl-specific code in this package already relies on richer identity handling around:
@@ -1614,6 +1654,18 @@ This README is intentionally longer than a minimal package page because users of
 
 ## Release notes
 
+### 2.1.9
+
+- fixed hosted device `99` PN to LID migration so the runtime keeps `hosted` and `hosted.lid` identity space correctly
+- fixed Signal session lookup for hosted PN sessions during migration by using the real session-address encoding
+- README and package metadata refreshed to match the current stabilized runtime
+
+### 2.1.8
+
+- runtime hotfix release for CommonJS `lru-cache` compatibility in the current Neelegirl environment
+- fixed constructor resolution used by LID mapping and retry cache initialization
+- dependency range aligned to `@neelegirl/libsignal@^1.0.12`
+
 ### 2.1.7
 
 - documentation expansion release

package/lib/Signal/libsignal.js

@@ -4,7 +4,8 @@ Object.defineProperty(exports, "__esModule", { value: true })
 
 const libsignal = require("@neelegirl/libsignal")
 const { PreKeyWhisperMessage } = require("@neelegirl/libsignal/src/protobufs")
-const { LRUCache } = require("lru-cache")
+const LRUCacheModule = require("lru-cache")
+const LRUCache = LRUCacheModule.LRUCache || LRUCacheModule
 const WASignalGroup_1 = require("./WASignalGroup")
 const lid_mapping_1 = require("./lid-mapping")
 const Utils_1 = require("../Utils")
@@ -174,27 +175,18 @@ function makeLibSignalRepository(auth, logger, pnToLIDFunc) {
             if (!userDevices.includes(fromDeviceStr)) {
                 userDevices.push(fromDeviceStr)
             }
-            const uncachedDevices = userDevices.filter(device => !migratedSessionCache.has(`${user}.${device}`))
-            const deviceSessionKeys = uncachedDevices.map(device => `${user}.${device}`)
+            const uncachedDeviceJids = userDevices
+                .map(device => {
+                    const deviceNum = parseInt(device, 10)
+                    const normalizedDevice = Number.isNaN(deviceNum) ? 0 : deviceNum
+                    return `${user}${normalizedDevice ? `:${normalizedDevice}` : ''}@${normalizedDevice === 99 ? 'hosted' : 's.whatsapp.net'}`
+                })
+                .filter(jid => !migratedSessionCache.has(jidToSignalProtocolAddress(jid).toString()))
+            const deviceSessionKeys = uncachedDeviceJids.map(jid => jidToSignalProtocolAddress(jid).toString())
             const existingSessions = deviceSessionKeys.length
                 ? await parsedKeys.get('session', deviceSessionKeys)
                 : {}
-            const deviceJids = []
-            for (const [sessionKey, sessionData] of Object.entries(existingSessions)) {
-                if (!sessionData) {
-                    continue
-                }
-                const deviceStr = sessionKey.split('.')[1]
-                if (!deviceStr) {
-                    continue
-                }
-                const deviceNum = parseInt(deviceStr, 10)
-                let jid = `${user}${deviceNum ? `:${deviceNum}` : ''}@s.whatsapp.net`
-                if (deviceNum === 99) {
-                    jid = `${user}:99@hosted`
-                }
-                deviceJids.push(jid)
-            }
+            const deviceJids = uncachedDeviceJids.filter(jid => existingSessions[jidToSignalProtocolAddress(jid).toString()])
             return parsedKeys.transaction(async () => {
                 const migrationOps = deviceJids.map(jid => {
                     const lidWithDevice = (0, WABinary_1.transferDevice)(jid, toJid)
@@ -234,7 +226,7 @@ function makeLibSignalRepository(auth, logger, pnToLIDFunc) {
                     await parsedKeys.set({ session: sessionUpdates })
                     for (const op of migrationOps) {
                         if (sessionUpdates[op.toAddr.toString()] && op.pnUser) {
-                            migratedSessionCache.set(`${op.pnUser}.${op.deviceId}`, true)
+                            migratedSessionCache.set(op.fromAddr.toString(), true)
                         }
                     }
                 }

package/lib/Signal/lid-mapping.js

@@ -2,7 +2,8 @@
 
 Object.defineProperty(exports, "__esModule", { value: true })
 
-const { LRUCache } = require("lru-cache")
+const LRUCacheModule = require("lru-cache")
+const LRUCache = LRUCacheModule.LRUCache || LRUCacheModule
 const WABinary_1 = require("../WABinary")
 
 class LIDMappingStore {

package/lib/Utils/message-retry-manager.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MessageRetryManager = void 0;
 const lru_cache_1 = require("lru-cache");
+const LRUCache = lru_cache_1.LRUCache || lru_cache_1;
 /** Number of sent messages to cache in memory for handling retry receipts */
 const RECENT_MESSAGES_SIZE = 512;
 const MESSAGE_KEY_SEPARATOR = '\u0000';
@@ -11,7 +12,7 @@ const PHONE_REQUEST_DELAY = 3000;
 class MessageRetryManager {
     constructor(logger, maxMsgRetryCount) {
         this.logger = logger;
-        this.recentMessagesMap = new lru_cache_1.LRUCache({
+        this.recentMessagesMap = new LRUCache({
             max: RECENT_MESSAGES_SIZE,
             ttl: 5 * 60 * 1000,
             ttlAutopurge: true,
@@ -24,11 +25,11 @@ class MessageRetryManager {
             }
         });
         this.messageKeyIndex = new Map();
-        this.sessionRecreateHistory = new lru_cache_1.LRUCache({
+        this.sessionRecreateHistory = new LRUCache({
             ttl: RECREATE_SESSION_TIMEOUT * 2,
             ttlAutopurge: true
         });
-        this.retryCounters = new lru_cache_1.LRUCache({
+        this.retryCounters = new LRUCache({
             ttl: 15 * 60 * 1000,
             ttlAutopurge: true,
             updateAgeOnGet: true
@@ -176,4 +177,3 @@ exports.MessageRetryManager = MessageRetryManager;
 //# sourceMappingURL=message-retry-manager.js.map
 
 
-

package/lib/WABinary/jid-utils.js

@@ -113,10 +113,22 @@ const transferDevice = (fromJid, toJid) => {
     const fromDecoded = jidDecode(fromJid)
     const deviceId = fromDecoded?.device || 0
     const toDecoded = jidDecode(toJid)
-    if (!toDecoded) {
+    if (!toDecoded?.user) {
         throw new Error(`invalid jid for device transfer: ${toJid}`)
     }
-    return jidEncode(toDecoded.user, toDecoded.server, deviceId)
+    let server = toDecoded.server
+    const isHostedDevice = fromDecoded?.server === 'hosted'
+        || fromDecoded?.server === 'hosted.lid'
+        || deviceId === 99
+    if (isHostedDevice) {
+        if (server === 's.whatsapp.net') {
+            server = 'hosted'
+        }
+        else if (server === 'lid') {
+            server = 'hosted.lid'
+        }
+    }
+    return jidEncode(toDecoded.user, server, deviceId)
 }
 
 module.exports = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neelegirl/baileys",
-  "version": "2.1.7",
+  "version": "2.1.9",
   "description": "CommonJS Neelegirl Baileys fork with preserved QR/NEELE logic and selective WhiskeySockets/Baileys compatibility updates",
   "keywords": [
     "whatsapp",
@@ -29,9 +29,9 @@
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
   "files": [
-    "lib/**/*",
-    "WAProto/**/*",
-    "engine-requirements.js"
+    "lib/*",
+    "WAProto/*",
+    "WASignalGroup/*.js"
   ],
   "scripts": {
     "build:all": "tsc && typedoc",
@@ -44,7 +44,7 @@
     "@adiwajshing/keyed-db": "^0.2.4",
     "@cacheable/node-cache": "^1.5.4",
     "@hapi/boom": "^9.1.3",
-    "@neelegirl/libsignal": "^1.0.11",
+    "@neelegirl/libsignal": "^1.0.12",
     "async-mutex": "^0.5.0",
     "audio-decode": "^2.1.3",
     "axios": "^1.3.3",
@@ -69,7 +69,7 @@
     "conventional-changelog-cli": "^2.2.2",
     "eslint": "^8.0.0",
     "jest": "^27.0.6",
-    "jimp": "^0.16.13",
+ "jimp": "^0.16.13",
     "json": "^11.0.0",
     "link-preview-js": "^3.0.5",
     "open": "^8.4.2",
@@ -89,9 +89,6 @@
     "sharp": "^0.32.6"
   },
   "peerDependenciesMeta": {
-    "audio-decode": {
-      "optional": true
-    },
     "jimp": {
       "optional": true
     },

package/engine-requirements.js

@@ -1,10 +0,0 @@
-const major = parseInt(process.versions.node.split('.')[0], 10);
-
-if (major < 20) {
-  console.error(
-    `\n❌ This package requires Node.js 20+ to run reliably.\n` +
-    `   You are using Node.js ${process.versions.node}.\n` +
-    `   Please upgrade to Node.js 20+ to proceed.\n`
-  );
-  process.exit(1);
-}