@neelegirl/baileys 2.1.8 → 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.8` | 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.8](#what-was-updated-in-218)
+- [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,16 +96,19 @@ 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.8
+## 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
@@ -94,6 +116,7 @@ Nothing in those areas was blindly replaced with upstream code.
 
 ### 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
@@ -415,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:
@@ -1629,6 +1654,12 @@ 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

package/lib/Signal/libsignal.js

@@ -175,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)
@@ -235,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/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.8",
+  "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",
@@ -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);
-}