@neelegirly/baileys 2.2.21 → 2.2.23

package/README.md

@@ -5,9 +5,9 @@
 ### *Die WhatsApp Web API mit sauberem Neelegirly-Glow-up*
 ### *QR Branding · Wrapper-Aware Update Notify · LID · Smart Queue*
 
-[![Version](https://img.shields.io/badge/Version-2.2.21-ff69b4?style=for-the-badge&logo=npm)](https://www.npmjs.com/package/@neelegirly/baileys)
+[![Version](https://img.shields.io/badge/Version-2.2.22-ff69b4?style=for-the-badge&logo=npm)](https://www.npmjs.com/package/@neelegirly/baileys)
 [![wa-api](https://img.shields.io/badge/wa--api-1.8.6-c77dff?style=for-the-badge)](https://www.npmjs.com/package/@neelegirly/wa-api)
-[![libsignal](https://img.shields.io/badge/libsignal-1.0.30-f4a261?style=for-the-badge)](https://www.npmjs.com/package/@neelegirly/libsignal)
+[![libsignal](https://img.shields.io/badge/libsignal-1.0.31-f4a261?style=for-the-badge)](https://www.npmjs.com/package/@neelegirly/libsignal)
 [![Node](https://img.shields.io/badge/Node-16+-4caf50?style=for-the-badge&logo=node.js)](https://nodejs.org)
 [![npm](https://img.shields.io/npm/v/%40neelegirly%2Fbaileys?style=for-the-badge&color=ff69b4&logo=npm)](https://www.npmjs.com/package/@neelegirly/baileys)
 
@@ -15,9 +15,9 @@
   <img src="https://files.catbox.moe/5bqumy.jpeg" width="780" alt="@neelegirly/baileys Hero" />
 </p>
 
-<p align="center"><sub>2026 Glow-Up Edition · frische WA-API-, USync- und libsignal-Patches · Companion-Stack auf <strong>2.2.21 / 1.8.6 / 1.0.30</strong></sub></p>
+<p align="center"><sub>2026 Glow-Up Edition · frische WA-API-, USync- und libsignal-Patches · Companion-Stack auf <strong>2.2.22 / 1.8.6 / 1.0.31</strong></sub></p>
 
-[**Installation**](#-installation) · [**Quickstart**](#-quickstart) · [**Highlights**](#-highlights) · [**QR Branding**](#-qr-branding--update-status) · [**Migration**](#-namespace-migration) · [**Release Notes**](#-release-notes-2221)
+[**Installation**](#-installation) · [**Quickstart**](#-quickstart) · [**Highlights**](#-highlights) · [**QR Branding**](#-qr-branding--update-status) · [**Migration**](#-namespace-migration) · [**Release Notes**](#-release-notes-2222)
 
 </div>
 
@@ -42,7 +42,7 @@ Neelegirlys Variante von Baileys ist die WhatsApp-Web-Basis für stabile Bots, s
 
 ---
 
-## 🆕 Was sich in `v2.2.21` geändert hat
+## 🆕 Was sich in `v2.2.22` geändert hat
 
 - ✅ Aktuelle Baileys-Upstream-Fixes vom 24./25. April 2026 sauber übernommen
 - ✅ AB-Props-Query nutzt wieder den aktuellen `abt`/Protocol-1-Flow
@@ -50,8 +50,9 @@ Neelegirlys Variante von Baileys ist die WhatsApp-Web-Basis für stabile Bots, s
 - ✅ App-State-Sync robuster bei fehlenden Keys, Snapshot-Retry und Reconnects
 - ✅ Call-Events, Album-Messages und History/Media-Streaming erweitert
 - ✅ Baileys-WA-API mit robusteren Group-/Message-Guards, Reachout-/Message-Cap-Abfragen und Newsletter-Join/Leave-IDs aktualisiert
-- ✅ libsignal-Dependency auf `1.0.30` mit TypeScript-Definitionen und ProtocolAddress-Typen aktualisiert
+- ✅ libsignal-Dependency auf `1.0.31` mit TypeScript-Definitionen und ProtocolAddress-Typen aktualisiert
 - ✅ MEX-LID-Mappings werden in die Signal-Store-Anbindung übernommen
+- ✅ Link-Preview-Redirect-Retry und serverseitige MEX-Notifications fuer Reachout/Message-Capping geprueft
 
 ---
 
@@ -59,9 +60,9 @@ Neelegirlys Variante von Baileys ist die WhatsApp-Web-Basis für stabile Bots, s
 
 | Paket | Empfohlene Version |
 | --- | --- |
-| `@neelegirly/baileys` | `2.2.21` |
+| `@neelegirly/baileys` | `2.2.22` |
 | `@neelegirly/wa-api` | `1.8.6` |
-| `@neelegirly/libsignal` | `1.0.30` |
+| `@neelegirly/libsignal` | `1.0.31` |
 
 ---
 
@@ -70,19 +71,19 @@ Neelegirlys Variante von Baileys ist die WhatsApp-Web-Basis für stabile Bots, s
 ### npm
 
 ```bash
-npm install @neelegirly/baileys@2.2.21 @neelegirly/libsignal@1.0.30 --save-exact
+npm install @neelegirly/baileys@2.2.22 @neelegirly/libsignal@1.0.31 --save-exact
 ```
 
 ### yarn
 
 ```bash
-yarn add @neelegirly/baileys@2.2.21 @neelegirly/libsignal@1.0.30 --exact
+yarn add @neelegirly/baileys@2.2.22 @neelegirly/libsignal@1.0.31 --exact
 ```
 
 ### pnpm
 
 ```bash
-pnpm add @neelegirly/baileys@2.2.21 @neelegirly/libsignal@1.0.30 --save-exact
+pnpm add @neelegirly/baileys@2.2.22 @neelegirly/libsignal@1.0.31 --save-exact
 ```
 
 > Für den kompletten Neelegirly-Stack passt dazu `@neelegirly/wa-api@1.8.6`.
@@ -138,8 +139,8 @@ start().catch(console.error)
 
 | Paket | Rolle |
 |------|-------|
-| `@neelegirly/baileys 2.2.21` | Socket, Events, Messaging |
-| `@neelegirly/libsignal 1.0.30` | Signal-Protokoll-Komponente |
+| `@neelegirly/baileys 2.2.22` | Socket, Events, Messaging |
+| `@neelegirly/libsignal 1.0.31` | Signal-Protokoll-Komponente |
 | `@neelegirly/wa-api 1.8.6` | Lifecycle-, Session- und Update-Wrapper |
 
 ---
@@ -150,7 +151,7 @@ Beim QR-Scan werden automatisch Markenzeilen oberhalb und unterhalb des QR-Codes
 
 Typische Anzeige:
 
-- `Baileys Update-Status: up to date (2.2.21)`
+- `Baileys Update-Status: up to date (2.2.22)`
 - `Wrapper Update-Status: up to date (1.8.6)`
 - Bei echten Updates werden kompakte Hinweise auf `latest` eingeblendet
 
@@ -171,7 +172,7 @@ Wenn du direkt prüfen willst:
 ```ts
 import { checkNpmVersion } from '@neelegirly/baileys'
 
-const info = await checkNpmVersion('@neelegirly/baileys', '2.2.21', {
+const info = await checkNpmVersion('@neelegirly/baileys', '2.2.22', {
   githubRepo: 'neelegirly/baileys'
 })
 
@@ -191,14 +192,15 @@ Wenn du vom Upstream kommst, nutze den Neelegirly-Scope:
 
 ---
 
-## 📝 Release Notes `2.2.21`
+## 📝 Release Notes `2.2.22`
 
 - 🔧 Upstream-Änderungen vom 24./25. April 2026 portiert, ohne QR-/Update-Notify- oder Message-ID-Handling umzubauen
 - 🧩 Username-USync und Inbound-Username-Felder für Kontakte, Gruppen und Message Keys ergänzt
 - 🛡️ App-State-Sync und libsignal-LID/PN-Typen robuster gemacht
 - 🖼️ Album-Message-Sending und erweiterte Call-Event-Typen ergänzt
-- 🔐 libsignal auf `1.0.30` mit WhiskeySockets-TypeScript-Definitionen und ProtocolAddress-Typen gepinnt
-- 🔗 Companion-Stack auf `2.2.21 / 1.8.6 / 1.0.30` aktualisiert
+- 🔐 libsignal auf `1.0.31` mit WhiskeySockets-TypeScript-Definitionen und ProtocolAddress-Typen gepinnt
+- 🔗 Companion-Stack auf `2.2.22 / 1.8.6 / 1.0.31` aktualisiert
 - 🛡️ Null-/Undefined-Pfade in Gruppen-, Nachrichten- und Chat-ID-Verarbeitung gehärtet
 - 🧷 MEX-LID-Mappings werden in den Signal-Store übernommen
 - 🧩 Reachout- und Message-Cap-WA-API-Abfragen plus TypeScript-Definitionen ergänzt
+- 🔁 Link-Preview-Redirect-Retry-Counter repariert und Server-Push-MEX-Updates verarbeitet

package/lib/Socket/chats.js

@@ -544,7 +544,7 @@ const makeChatsSocket = (config) => {
                     const { patches, hasMorePatches, snapshot } = decoded[name]
                     try {
                         if (snapshot) {
-                            const { state: newState, mutationMap } = await Utils_1.decodeSyncdSnapshot(name, snapshot, getAppStateSyncKey, initialVersionMap[name], appStateMacVerification.snapshot)
+                            const { state: newState, mutationMap } = await Utils_1.decodeSyncdSnapshot(name, snapshot, getAppStateSyncKey, initialVersionMap[name], appStateMacVerification.snapshot, logger)
                             states[name] = newState
                             Object.assign(globalMutationMap, mutationMap)
                             logger.info(`restored state of ${name} from snapshot to v${newState.version} with mutations`)

package/lib/Socket/messages-recv.js

@@ -20,6 +20,13 @@ const WABinary_1 = require("../WABinary");
 const groups_1 = require("./groups");
 const messages_send_1 = require("./messages-send");
 
+const ENFORCEMENT_TYPE_VALUES = new Set(
+  Object.values(Types_1.ReachoutTimelockEnforcementType)
+);
+
+const isValidEnforcementType = (value) =>
+  typeof value === "string" && ENFORCEMENT_TYPE_VALUES.has(value);
+
 const makeMessagesRecvSocket = (config) => {
   const {
     logger,
@@ -678,6 +685,53 @@ const makeMessagesRecvSocket = (config) => {
     }
   };
 
+  const handleReachoutTimelockNotification = (payload) => {
+    if (!payload) {
+      logger.warn("reachout timelock notification missing payload");
+      return;
+    }
+
+    if (!payload.is_active) {
+      logger.info("reachout timelock restriction lifted");
+      ev.emit("connection.update", {
+        reachoutTimeLock: {
+          isActive: false,
+          enforcementType: Types_1.ReachoutTimelockEnforcementType.DEFAULT,
+        },
+      });
+      return;
+    }
+
+    const timeEnforcementEnds = payload.time_enforcement_ends
+      ? new Date(Number.parseInt(payload.time_enforcement_ends, 10) * 1000)
+      : new Date(Date.now() + 60_000);
+    const enforcementType = isValidEnforcementType(payload.enforcement_type)
+      ? payload.enforcement_type
+      : Types_1.ReachoutTimelockEnforcementType.DEFAULT;
+
+    logger.info(
+      { enforcementType, timeEnforcementEnds },
+      "reachout timelock restriction set"
+    );
+    ev.emit("connection.update", {
+      reachoutTimeLock: {
+        isActive: true,
+        timeEnforcementEnds,
+        enforcementType,
+      },
+    });
+  };
+
+  const handleMessageCappingNotification = (payload) => {
+    if (!payload) {
+      logger.warn("message capping notification missing payload");
+      return;
+    }
+
+    logger.info({ payload }, "received message capping update");
+    ev.emit("message-capping.update", payload);
+  };
+
   const handleMexNotification = async (id, node) => {
     const updateNode = !node || node.content ? null : WABinary_1.getBinaryNodeChild(node, "update") || WABinary_1.getAllBinaryNodeChildren(node)[0];
     const payloadNode = node?.content ? node : updateNode;
@@ -704,6 +758,23 @@ const makeMessagesRecvSocket = (config) => {
     }
 
     const operation = content?.operation || payloadNode?.attrs?.op_name || node?.attrs?.op_name;
+    if (Array.isArray(content?.errors) && content.errors.length) {
+      logger.warn({ errors: content.errors, operation }, "mex notification has GQL errors");
+      return;
+    }
+
+    const data = content?.data || {};
+
+    if (operation === "NotificationUserReachoutTimelockUpdate") {
+      handleReachoutTimelockNotification(data.xwa2_notify_account_reachout_timelock);
+      return;
+    }
+
+    if (operation === "MessageCappingInfoNotification") {
+      handleMessageCappingNotification(data.xwa2_notify_new_chat_messages_capping_info_update);
+      return;
+    }
+
     const linkedProfiles = content?.data?.[Types_1.XWAPathsMexUpdates.LINKED_PROFILES];
     const updates = content?.updates || (linkedProfiles ? [linkedProfiles] : undefined);
 
@@ -825,9 +896,19 @@ const makeMessagesRecvSocket = (config) => {
           node.attrs.participant_username
         );
         break;
-      case "newsletter":
-        handleNewsletterNotification(node.attrs.from, child);
+      case "newsletter": {
+        const newsletterChildren = WABinary_1.getAllBinaryNodeChildren(node);
+        const nodesToHandle = newsletterChildren.length
+          ? newsletterChildren
+          : child
+          ? [child]
+          : [];
+
+        for (const newsletterChild of nodesToHandle) {
+          handleNewsletterNotification(node.attrs.from, newsletterChild);
+        }
         break;
+      }
       case "mex":
         await handleMexNotification(node.attrs.from, child);
         break;

package/lib/Types/Events.d.ts

@@ -9,7 +9,7 @@ import { Label } from './Label'
 import { LabelAssociation } from './LabelAssociation'
 import { MessageUpsertType, MessageUserReceiptUpdate, WAMessage, WAMessageKey, WAMessageUpdate } from './Message'
 import { NewsletterViewRole, SubscriberAction, NewsletterSettingsUpdate } from './Newsletter'
-import { ConnectionState } from './State'
+import { ConnectionState, NewChatMessageCapInfo } from './State'
 
 export type BaileysEventMap = {
     /** connection state has been updated -- WS closed, opened, connecting etc. */
@@ -145,6 +145,7 @@ export type BaileysEventMap = {
     	id: string
         update: NewsletterSettingsUpdate
     }
+    'message-capping.update': NewChatMessageCapInfo
     'limit-sharing.update': {
         id: string
         author: string

package/lib/Utils/chat-utils.d.ts

@@ -85,7 +85,7 @@ export declare const extractSyncdPatches: (result: BinaryNode, options: AxiosReq
 
 export declare const downloadExternalBlob: (blob: proto.IExternalBlobReference, options: AxiosRequestConfig<{}>) => Promise<Buffer>
 export declare const downloadExternalPatch: (blob: proto.IExternalBlobReference, options: AxiosRequestConfig<{}>) => Promise<proto.SyncdMutations>
-export declare const decodeSyncdSnapshot: (name: WAPatchName, snapshot: proto.ISyncdSnapshot, getAppStateSyncKey: FetchAppStateSyncKey, minimumVersionNumber: number | undefined, validateMacs?: boolean) => Promise<{
+export declare const decodeSyncdSnapshot: (name: WAPatchName, snapshot: proto.ISyncdSnapshot, getAppStateSyncKey: FetchAppStateSyncKey, minimumVersionNumber: number | undefined, validateMacs?: boolean, logger?: ILogger) => Promise<{
     state: LTHashState
     mutationMap: ChatMutationMap
 }>

package/lib/Utils/chat-utils.js

@@ -179,18 +179,33 @@ const decodeSyncdMutations = async (msgMutations, initialState, getAppStateSyncK
         // otherwise, if it's only a record -- it'll be a SET mutation
         const operation = 'operation' in msgMutation ? msgMutation.operation : WAProto_1.proto.SyncdMutation.SyncdOperation.SET
         const record = ('record' in msgMutation && !!msgMutation.record) ? msgMutation.record : msgMutation
-        const key = await getKey(record.keyId.id)
+        let key
+        try {
+            key = await getKey(record.keyId.id)
+        }
+        catch (error) {
+            if (isMissingKeyError(error)) {
+                throw error
+            }
+            continue
+        }
         const content = Buffer.from(record.value.blob)
         const encContent = content.slice(0, -32)
         const ogValueMac = content.slice(-32)
         if (validateMacs) {
             const contentHmac = generateMac(operation, encContent, record.keyId.id, key.valueMacKey)
             if (Buffer.compare(contentHmac, ogValueMac) !== 0) {
-                throw new boom_1.Boom('HMAC content verification failed')
+                continue
             }
         }
-        const result = crypto_1.aesDecrypt(encContent, key.valueEncryptionKey)
-        const syncAction = WAProto_1.proto.SyncActionData.decode(result)
+        let syncAction
+        try {
+            const result = crypto_1.aesDecrypt(encContent, key.valueEncryptionKey)
+            syncAction = WAProto_1.proto.SyncActionData.decode(result)
+        }
+        catch (error) {
+            continue
+        }
         if (validateMacs) {
             const hmac = crypto_1.hmacSign(syncAction.index, key.indexKey)
             if (Buffer.compare(hmac, record.index.blob) !== 0) {
@@ -286,7 +301,7 @@ const downloadExternalPatch = async (blob, options) => {
     return syncData
 }
 
-const decodeSyncdSnapshot = async (name, snapshot, getAppStateSyncKey, minimumVersionNumber, validateMacs = true) => {
+const decodeSyncdSnapshot = async (name, snapshot, getAppStateSyncKey, minimumVersionNumber, validateMacs = true, logger) => {
     const newState = newLTHashState()
     newState.version = generics_1.toNumber(snapshot.version.version)
     const mutationMap = {}
@@ -309,7 +324,7 @@ const decodeSyncdSnapshot = async (name, snapshot, getAppStateSyncKey, minimumVe
         const result = await mutationKeys(keyEnc.keyData)
         const computedSnapshotMac = generateSnapshotMac(newState.hash, newState.version, name, result.snapshotMacKey)
         if (Buffer.compare(snapshot.mac, computedSnapshotMac) !== 0) {
-            throw new boom_1.Boom(`failed to verify LTHash at ${newState.version} of ${name} from snapshot`)
+            logger?.warn({ name, version: newState.version }, 'LTHash verification failed on snapshot, continuing with partial state')
         }
     }
     return {
@@ -335,13 +350,24 @@ const decodePatches = async (name, syncds, initial, getAppStateSyncKey, options,
         const patchVersion = generics_1.toNumber(version.version)
         newState.version = patchVersion
         const shouldMutate = typeof minimumVersionNumber === 'undefined' || patchVersion > minimumVersionNumber
-        const decodeResult = await decodeSyncdPatch(syncd, name, newState, getAppStateSyncKey, shouldMutate
-            ? mutation => {
-                var _a
-                const index = mutation.syncAction.index?.toString()
-                mutationMap[index] = mutation
+        let decodeResult
+        try {
+            decodeResult = await decodeSyncdPatch(syncd, name, newState, getAppStateSyncKey, shouldMutate
+                ? mutation => {
+                    var _a
+                    const index = mutation.syncAction.index?.toString()
+                    mutationMap[index] = mutation
+                }
+                : (() => { }), validateMacs)
+        }
+        catch (error) {
+            if (isMissingKeyError(error)) {
+                throw error
             }
-            : (() => { }), true)
+            logger?.warn({ name, version: patchVersion, error: error?.stack || error }, 'failed to decode patch, skipping')
+            syncd.mutations = []
+            continue
+        }
         newState.hash = decodeResult.hash
         newState.indexValueMap = decodeResult.indexValueMap
         if (validateMacs) {
@@ -353,7 +379,8 @@ const decodePatches = async (name, syncds, initial, getAppStateSyncKey, options,
             const result = await mutationKeys(keyEnc.keyData)
             const computedSnapshotMac = generateSnapshotMac(newState.hash, newState.version, name, result.snapshotMacKey)
             if (Buffer.compare(snapshotMac, computedSnapshotMac) !== 0) {
-                throw new boom_1.Boom(`failed to verify LTHash at ${newState.version} of ${name}`)
+                logger?.warn({ name, version: newState.version }, 'LTHash verification failed, skipping remaining patches')
+                break
             }
         }
         // clear memory used up by the mutations

package/lib/Utils/link-preview.js

@@ -47,7 +47,7 @@ const getCompressedJpegThumbnail = async (url, { thumbnailWidth, fetchOpts }) =>
  */
 const getUrlInfo = async (text, opts = { thumbnailWidth: THUMBNAIL_WIDTH_PX, fetchOpts: { timeout: 3000 }}) => {
     try {
-        const retries = 0
+        let retries = 0
         const maxRetry = 5
         const { getLinkPreview } = await Promise.resolve().then(() => __importStar(require('link-preview-js')))
         let previewLink = text
@@ -66,7 +66,7 @@ const getUrlInfo = async (text, opts = { thumbnailWidth: THUMBNAIL_WIDTH_PX, fet
                 if (forwardedURLObj.hostname === urlObj.hostname
                     || forwardedURLObj.hostname === 'www.' + urlObj.hostname
                     || 'www.' + forwardedURLObj.hostname === urlObj.hostname) {
-                    retries + 1
+                    retries += 1
                     return true
                 }
                 else {
@@ -117,4 +117,4 @@ const getUrlInfo = async (text, opts = { thumbnailWidth: THUMBNAIL_WIDTH_PX, fet
 
 module.exports = {
   getUrlInfo
-}
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neelegirly/baileys",
-  "version": "2.2.21",
+  "version": "2.2.23",
   "description": "Neelegirly fork of Baileys: multi-device WhatsApp Web API for Node.js",
   "keywords": [
     "whatsapp",
@@ -27,6 +27,7 @@
   "files": [
     "lib/**/*",
     "WAProto/**/*",
+    "tsconfig.json",
     "README.md",
     "LICENSE"
   ],
@@ -43,7 +44,7 @@
     "@adiwajshing/keyed-db": "^0.2.4",
     "@cacheable/node-cache": "^1.5.4",
     "@hapi/boom": "^9.1.3",
-    "@neelegirly/libsignal": "1.0.30",
+    "@neelegirly/libsignal": "1.0.31",
     "async-mutex": "^0.5.0",
     "audio-decode": "^2.1.3",
     "axios": "^1.3.3",
@@ -58,7 +59,7 @@
     "ws": "^8.13.0"
   },
   "overrides": {
-    "@neelegirly/libsignal": "1.0.30"
+    "@neelegirly/libsignal": "1.0.31"
   },
   "devDependencies": {
     "@adiwajshing/eslint-config": "github:adiwajshing/eslint-config",
@@ -115,6 +116,7 @@
   "scripts": {
     "build:all": "tsc && typedoc",
     "build:docs": "typedoc",
-    "build:tsc": "tsc"
+    "build:tsc": "tsc",
+    "test": "node --check lib/Socket/groups.js && node --check lib/Socket/messages-recv.js && node --check lib/Socket/messages-send.js && node --check lib/Socket/socket.js && node --check lib/Utils/auth-utils.js && node --check lib/Utils/decode-wa-message.js && node --check lib/Utils/process-message.js && node --check lib/Utils/link-preview.js && node -e \"const b=require('./'); if(typeof b.makeWASocket !== 'function' || b.NACK_REASONS.SenderReachoutTimelocked !== 463 || b.QueryIds.FOLLOW !== '24404358912487870') process.exit(1)\""
   }
 }

package/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "allowJs": true,
+    "checkJs": false,
+    "esModuleInterop": true,
+    "module": "commonjs",
+    "moduleResolution": "node",
+    "noEmit": true,
+    "skipLibCheck": true,
+    "target": "es2020",
+    "types": ["node"]
+  },
+  "include": ["lib/**/*.js", "lib/**/*.d.ts", "WAProto/**/*.js", "WAProto/**/*.d.ts"],
+  "exclude": ["node_modules"]
+}