@neelegirly/baileys 2.2.20 → 2.2.21

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.20-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.5-c77dff?style=for-the-badge)](https://www.npmjs.com/package/@neelegirly/wa-api)
-[![libsignal](https://img.shields.io/badge/libsignal-1.0.29-f4a261?style=for-the-badge)](https://www.npmjs.com/package/@neelegirly/libsignal)
+[![Version](https://img.shields.io/badge/Version-2.2.21-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)
 [![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.20 / 1.8.5 / 1.0.29</strong></sub></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>
 
-[**Installation**](#-installation) · [**Quickstart**](#-quickstart) · [**Highlights**](#-highlights) · [**QR Branding**](#-qr-branding--update-status) · [**Migration**](#-namespace-migration) · [**Release Notes**](#-release-notes-2220)
+[**Installation**](#-installation) · [**Quickstart**](#-quickstart) · [**Highlights**](#-highlights) · [**QR Branding**](#-qr-branding--update-status) · [**Migration**](#-namespace-migration) · [**Release Notes**](#-release-notes-2221)
 
 </div>
 
@@ -42,14 +42,16 @@ Neelegirlys Variante von Baileys ist die WhatsApp-Web-Basis für stabile Bots, s
 
 ---
 
-## 🆕 Was sich in `v2.2.20` geändert hat
+## 🆕 Was sich in `v2.2.21` 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
 - ✅ Username-Felder in Contacts, Gruppenmetadaten, Message Keys und USync ergänzt
 - ✅ App-State-Sync robuster bei fehlenden Keys, Snapshot-Retry und Reconnects
 - ✅ Call-Events, Album-Messages und History/Media-Streaming erweitert
-- ✅ libsignal-Dependency auf `1.0.29` mit TypeScript-Definitionen und ProtocolAddress-Typen aktualisiert
+- ✅ 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
+- ✅ MEX-LID-Mappings werden in die Signal-Store-Anbindung übernommen
 
 ---
 
@@ -57,9 +59,9 @@ Neelegirlys Variante von Baileys ist die WhatsApp-Web-Basis für stabile Bots, s
 
 | Paket | Empfohlene Version |
 | --- | --- |
-| `@neelegirly/baileys` | `2.2.20` |
-| `@neelegirly/wa-api` | `1.8.5` |
-| `@neelegirly/libsignal` | `1.0.29` |
+| `@neelegirly/baileys` | `2.2.21` |
+| `@neelegirly/wa-api` | `1.8.6` |
+| `@neelegirly/libsignal` | `1.0.30` |
 
 ---
 
@@ -68,22 +70,22 @@ Neelegirlys Variante von Baileys ist die WhatsApp-Web-Basis für stabile Bots, s
 ### npm
 
 ```bash
-npm install @neelegirly/baileys@2.2.20 @neelegirly/libsignal@1.0.29 --save-exact
+npm install @neelegirly/baileys@2.2.21 @neelegirly/libsignal@1.0.30 --save-exact
 ```
 
 ### yarn
 
 ```bash
-yarn add @neelegirly/baileys@2.2.20 @neelegirly/libsignal@1.0.29 --exact
+yarn add @neelegirly/baileys@2.2.21 @neelegirly/libsignal@1.0.30 --exact
 ```
 
 ### pnpm
 
 ```bash
-pnpm add @neelegirly/baileys@2.2.20 @neelegirly/libsignal@1.0.29 --save-exact
+pnpm add @neelegirly/baileys@2.2.21 @neelegirly/libsignal@1.0.30 --save-exact
 ```
 
-> Für den kompletten Neelegirly-Stack passt dazu `@neelegirly/wa-api@1.8.5`.
+> Für den kompletten Neelegirly-Stack passt dazu `@neelegirly/wa-api@1.8.6`.
 
 ---
 
@@ -136,9 +138,9 @@ start().catch(console.error)
 
 | Paket | Rolle |
 |------|-------|
-| `@neelegirly/baileys 2.2.20` | Socket, Events, Messaging |
-| `@neelegirly/libsignal 1.0.29` | Signal-Protokoll-Komponente |
-| `@neelegirly/wa-api 1.8.5` | Lifecycle-, Session- und Update-Wrapper |
+| `@neelegirly/baileys 2.2.21` | Socket, Events, Messaging |
+| `@neelegirly/libsignal 1.0.30` | Signal-Protokoll-Komponente |
+| `@neelegirly/wa-api 1.8.6` | Lifecycle-, Session- und Update-Wrapper |
 
 ---
 
@@ -148,8 +150,8 @@ Beim QR-Scan werden automatisch Markenzeilen oberhalb und unterhalb des QR-Codes
 
 Typische Anzeige:
 
-- `Baileys Update-Status: up to date (2.2.20)`
-- `Wrapper Update-Status: up to date (1.8.5)`
+- `Baileys Update-Status: up to date (2.2.21)`
+- `Wrapper Update-Status: up to date (1.8.6)`
 - Bei echten Updates werden kompakte Hinweise auf `latest` eingeblendet
 
 Wenn kein Wrapper-Kontext vorhanden ist, bleibt die Anzeige sauber bei Baileys. Kein unnötiges Drama, nur QR. ✨
@@ -169,7 +171,7 @@ Wenn du direkt prüfen willst:
 ```ts
 import { checkNpmVersion } from '@neelegirly/baileys'
 
-const info = await checkNpmVersion('@neelegirly/baileys', '2.2.20', {
+const info = await checkNpmVersion('@neelegirly/baileys', '2.2.21', {
   githubRepo: 'neelegirly/baileys'
 })
 
@@ -189,11 +191,14 @@ Wenn du vom Upstream kommst, nutze den Neelegirly-Scope:
 
 ---
 
-## 📝 Release Notes `2.2.20`
+## 📝 Release Notes `2.2.21`
 
 - 🔧 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.29` mit WhiskeySockets-TypeScript-Definitionen und ProtocolAddress-Typen gepinnt
-- 🔗 Companion-Stack auf `2.2.20 / 1.8.5 / 1.0.29` aktualisiert
+- 🔐 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
+- 🛡️ 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

package/lib/Socket/business.d.ts

@@ -189,4 +189,6 @@ export declare const makeBusinessSocket: (config: SocketConfig) => {
     requestPairingCode: (phoneNumber: string, code?: string) => Promise<string>
     waitForConnectionUpdate: (check: (u: Partial<import("../Types").ConnectionState>) => boolean | undefined, timeoutMs?: number | undefined) => Promise<void>
     sendWAMBuffer: (wamBuffer: Buffer) => Promise<BinaryNode>
+    fetchAccountReachoutTimelock: () => Promise<import("../Types").ReachoutTimelockState>
+    fetchNewChatMessageCap: () => Promise<import("../Types").NewChatMessageCapInfo>
 }

package/lib/Socket/chats.d.ts

@@ -100,4 +100,6 @@ export declare const makeChatsSocket: (config: SocketConfig) => {
      * requires the last messages till the last message received required for archive & unread
     */
     sendWAMBuffer: (wamBuffer: Buffer) => Promise<BinaryNode>
+    fetchAccountReachoutTimelock: () => Promise<import("../Types").ReachoutTimelockState>
+    fetchNewChatMessageCap: () => Promise<import("../Types").NewChatMessageCapInfo>
 }

package/lib/Socket/communities.d.ts

@@ -224,5 +224,7 @@ export declare const makeCommunitiesSocket: (config: SocketConfig) => {
     requestPairingCode: (phoneNumber: string, customPairingCode?: string) => Promise<string>;
     waitForConnectionUpdate: (check: (u: Partial<import("../index.js").ConnectionState>) => Promise<boolean | undefined>, timeoutMs?: number) => Promise<void>;
     sendWAMBuffer: (wamBuffer: Buffer) => Promise<any>;
+    fetchAccountReachoutTimelock: () => Promise<import("../Types").ReachoutTimelockState>;
+    fetchNewChatMessageCap: () => Promise<import("../Types").NewChatMessageCapInfo>;
 };
 export declare const extractCommunityMetadata: (result: BinaryNode) => GroupMetadata;

package/lib/Socket/groups.d.ts

@@ -131,6 +131,8 @@ export declare const makeGroupsSocket: (config: SocketConfig) => {
     requestPairingCode: (phoneNumber: string, code?: string) => Promise<string>
     waitForConnectionUpdate: (check: (u: Partial<import("../Types").ConnectionState>) => boolean | undefined, timeoutMs?: number | undefined) => Promise<void>
     sendWAMBuffer: (wamBuffer: Buffer) => Promise<BinaryNode>
+    fetchAccountReachoutTimelock: () => Promise<import("../Types").ReachoutTimelockState>
+    fetchNewChatMessageCap: () => Promise<import("../Types").NewChatMessageCapInfo>
 }
 
 export declare const extractGroupMetadata: (result: BinaryNode) => GroupMetadata

package/lib/Socket/groups.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true })
 
 const WAProto_1 = require("../../WAProto")
+const boom_1 = require("@hapi/boom")
 const Types_1 = require("../Types")
 const Utils_1 = require("../Utils")
 const WABinary_1 = require("../WABinary")
@@ -298,6 +299,21 @@ const makeGroupsSocket = (config) => {
 
 const extractGroupMetadata = (result) => {
     const group = WABinary_1.getBinaryNodeChild(result, 'group')
+    if (!group) {
+        const errorNode = WABinary_1.getBinaryNodeChild(result, 'error')
+        if (errorNode) {
+            const code = errorNode.attrs.code ? +errorNode.attrs.code : 500
+            const text = errorNode.attrs.text || 'group metadata query failed'
+            throw new boom_1.Boom(text, { statusCode: code, data: errorNode })
+        }
+
+        throw new boom_1.Boom('Invalid group metadata response: missing <group> node', { data: result })
+    }
+
+    if (!group.attrs.id) {
+        throw new boom_1.Boom('Invalid group metadata response: missing group id', { data: group })
+    }
+
     const descChild = WABinary_1.getBinaryNodeChild(group, 'description')
     
     let desc

package/lib/Socket/index.d.ts

@@ -191,6 +191,8 @@ declare const makeWASocket: (config: UserFacingSocketConfig) => {
     requestPairingCode: (phoneNumber: string, code?: string) => Promise<string>
     waitForConnectionUpdate: (check: (u: Partial<import("../Types").ConnectionState>) => boolean | undefined, timeoutMs?: number | undefined) => Promise<void>
     sendWAMBuffer: (wamBuffer: Buffer) => Promise<import("..").BinaryNode>
+    fetchAccountReachoutTimelock: () => Promise<import("../Types").ReachoutTimelockState>
+    fetchNewChatMessageCap: () => Promise<import("../Types").NewChatMessageCapInfo>
 }
 
 export default makeWASocket

package/lib/Socket/messages-recv.d.ts

@@ -179,4 +179,6 @@ export declare const makeMessagesRecvSocket: (config: SocketConfig) => {
     requestPairingCode: (phoneNumber: string, code?: string) => Promise<string>
     waitForConnectionUpdate: (check: (u: Partial<import("../Types").ConnectionState>) => boolean | undefined, timeoutMs?: number | undefined) => Promise<void>
     sendWAMBuffer: (wamBuffer: Buffer) => Promise<BinaryNode>
+    fetchAccountReachoutTimelock: () => Promise<import("../Types").ReachoutTimelockState>
+    fetchNewChatMessageCap: () => Promise<import("../Types").NewChatMessageCapInfo>
 }

package/lib/Socket/messages-recv.js

@@ -48,6 +48,7 @@ const makeMessagesRecvSocket = (config) => {
     getUSyncDevices,
     createParticipantNodes,
     sendPeerDataOperationMessage,
+    fetchAccountReachoutTimelock,
   } = Neele;
 
   /** this mutex ensures that each retryRequest will wait for the previous one to finish */
@@ -677,9 +678,60 @@ const makeMessagesRecvSocket = (config) => {
     }
   };
 
-  const handleMexNotification = (id, node) => {
-    const operation = node?.attrs?.op_name;
-    const content = JSON.parse(node?.content);
+  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;
+    if (!payloadNode?.content) {
+      logger.warn({ node }, "Invalid mex newsletter notification");
+      return;
+    }
+
+    let content;
+    try {
+      const payloadContent = payloadNode.content;
+      if (Array.isArray(payloadContent)) {
+        logger.warn({ payloadNode }, "Invalid mex newsletter notification payload format");
+        return;
+      }
+
+      const contentBuf = typeof payloadContent === "string"
+        ? Buffer.from(payloadContent, "binary")
+        : Buffer.from(payloadContent);
+      content = JSON.parse(contentBuf.toString());
+    } catch (error) {
+      logger.error({ err: error, node }, "Failed to parse mex newsletter notification");
+      return;
+    }
+
+    const operation = content?.operation || payloadNode?.attrs?.op_name || node?.attrs?.op_name;
+    const linkedProfiles = content?.data?.[Types_1.XWAPathsMexUpdates.LINKED_PROFILES];
+    const updates = content?.updates || (linkedProfiles ? [linkedProfiles] : undefined);
+
+    if (operation === Types_1.MexUpdatesOperations.LINKED_PROFILES) {
+      const mappings = [];
+      for (const update of updates || []) {
+        const lid = normalizeOptionalJid(update?.jid);
+        const addedProfiles = Array.isArray(update?.added_profiles) ? update.added_profiles : [];
+        for (const profile of addedProfiles) {
+          const pn = normalizeOptionalJid(typeof profile === "string" ? profile : (profile?.pn || profile?.jid || ""));
+          if (lid && pn) {
+            const mapping = { lid, pn };
+            ev.emit("lid-mapping.update", mapping);
+            mappings.push(mapping);
+          }
+        }
+      }
+
+      if (mappings.length && signalRepository?.lidMapping?.storeLIDPNMappings) {
+        await signalRepository.lidMapping.storeLIDPNMappings(mappings);
+      }
+      if (mappings.length && signalRepository?.migrateSession) {
+        for (const mapping of mappings) {
+          await signalRepository.migrateSession(mapping.pn, mapping.lid);
+        }
+      }
+      return;
+    }
 
     let contentPath;
     let action;
@@ -777,7 +829,7 @@ const makeMessagesRecvSocket = (config) => {
         handleNewsletterNotification(node.attrs.from, child);
         break;
       case "mex":
-        handleMexNotification(node.attrs.from, child);
+        await handleMexNotification(node.attrs.from, child);
         break;
       case "mediaretry":
         const event = Utils_1.decodeMediaRetryNode(node);
@@ -1635,13 +1687,19 @@ const makeMessagesRecvSocket = (config) => {
     // error in acknowledgement,
     // device could not display the message
     if (attrs.error) {
+      const isReachoutTimelocked = attrs.error === String(Utils_1.NACK_REASONS.SenderReachoutTimelocked);
+      if (isReachoutTimelocked && fetchAccountReachoutTimelock) {
+        await fetchAccountReachoutTimelock().catch((err) =>
+          logger.warn({ err }, "failed to fetch reachout timelock")
+        );
+      }
       logger.warn({ attrs }, "received error in ack");
       ev.emit("messages.update", [
         {
           key,
           update: {
             status: Types_1.WAMessageStatus.ERROR,
-            messageStubParameters: [attrs.error],
+            messageStubParameters: isReachoutTimelocked ? [attrs.error, Utils_1.ACCOUNT_RESTRICTED_TEXT] : [attrs.error],
           },
         },
       ]);

package/lib/Socket/messages-send.d.ts

@@ -170,4 +170,6 @@ export declare const makeMessagesSocket: (config: SocketConfig) => {
     requestPairingCode: (phoneNumber: string, code?: string) => Promise<string>
     waitForConnectionUpdate: (check: (u: Partial<import("../Types").ConnectionState>) => boolean | undefined, timeoutMs?: number | undefined) => Promise<void>
     sendWAMBuffer: (wamBuffer: Buffer) => Promise<BinaryNode>
+    fetchAccountReachoutTimelock: () => Promise<import("../Types").ReachoutTimelockState>
+    fetchNewChatMessageCap: () => Promise<import("../Types").NewChatMessageCapInfo>
 }

package/lib/Socket/messages-send.js

@@ -558,7 +558,7 @@ const makeMessagesSocket = (config) => {
     }
 
     const relayMessage = async (jid, message, { messageId: msgId, participant, additionalAttributes, useUserDevicesCache, useCachedGroupMetadata, statusJidList, additionalNodes, AI = true }) => {
-        const meId = authState.creds.me.id
+        const meId = Utils_1.assertMeId(authState.creds)
         const meLid = authState.creds.me?.lid
 
         let didPushAdditional = false
@@ -1534,4 +1534,4 @@ const makeMessagesSocket = (config) => {
 
 module.exports = {
   makeMessagesSocket
-}
+}

package/lib/Socket/newsletter.d.ts

@@ -147,6 +147,8 @@ export declare const makeNewsletterSocket: (config: SocketConfig) => {
     requestPairingCode: (phoneNumber: string, code?: string) => Promise<string>
     waitForConnectionUpdate: (check: (u: Partial<import("../Types").ConnectionState>) => boolean | undefined, timeoutMs?: number | undefined) => Promise<void>
     sendWAMBuffer: (wamBuffer: Buffer) => Promise<BinaryNode>
+    fetchAccountReachoutTimelock: () => Promise<import("../Types").ReachoutTimelockState>
+    fetchNewChatMessageCap: () => Promise<import("../Types").NewChatMessageCapInfo>
 }
 
 export declare const extractNewsletterMetadata: (node: BinaryNode, isCreate?: boolean) => NewsletterMetadata

package/lib/Socket/socket.d.ts

@@ -40,6 +40,8 @@ export declare const makeSocket: (config: SocketConfig) => {
     /** Waits for the connection to WA to reach a state */
     waitForConnectionUpdate: (check: (u: Partial<import("../Types").ConnectionState>) => boolean | undefined, timeoutMs?: number | undefined) => Promise<void>
     sendWAMBuffer: (wamBuffer: Buffer) => Promise<BinaryNode>
+    fetchAccountReachoutTimelock: () => Promise<import("../Types").ReachoutTimelockState>
+    fetchNewChatMessageCap: () => Promise<import("../Types").NewChatMessageCapInfo>
 }
 
-export type Socket = ReturnType<typeof makeSocket>
+export type Socket = ReturnType<typeof makeSocket>

package/lib/Socket/socket.js

@@ -15,6 +15,7 @@ const BinaryInfo_1 = require("../WAM/BinaryInfo")
 const USyncQuery_1 = require("../WAUSync/USyncQuery")
 const USyncUser_1 = require("../WAUSync/USyncUser")
 const Client_1 = require("./Client")
+const mex_1 = require("./mex")
 
 /**
  * Connects to WA servers and performs:
@@ -690,6 +691,35 @@ const makeSocket = (config) => {
             ]
         })
     }
+
+    const fetchAccountReachoutTimelock = async () => {
+        const queryResult = await mex_1.executeWMexQuery(
+            {},
+            Types_1.QueryIds.REACHOUT_TIMELOCK,
+            Types_1.XWAPaths.REACHOUT_TIMELOCK,
+            query,
+            generateMessageTag
+        )
+        const result = {
+            isActive: !!queryResult?.is_active,
+            timeEnforcementEnds: queryResult?.time_enforcement_ends && queryResult.time_enforcement_ends !== '0'
+                ? new Date(parseInt(queryResult.time_enforcement_ends, 10) * 1000)
+                : undefined,
+            enforcementType: queryResult?.enforcement_type || Types_1.ReachoutTimelockEnforcementType.DEFAULT
+        }
+        ev.emit('connection.update', { reachoutTimeLock: result })
+        return result
+    }
+
+    const fetchNewChatMessageCap = async () => {
+        return mex_1.executeWMexQuery(
+            { input: { type: 'INDIVIDUAL_NEW_CHAT_MSG' } },
+            Types_1.QueryIds.MESSAGE_CAPPING_INFO,
+            Types_1.XWAPaths.MESSAGE_CAPPING_INFO,
+            query,
+            generateMessageTag
+        )
+    }
     
     ws.on('message', onMessageReceived)
     
@@ -934,6 +964,8 @@ const makeSocket = (config) => {
         /** Waits for the connection to WA to reach a state */
         waitForConnectionUpdate: Utils_1.bindWaitForConnectionUpdate(ev),
         sendWAMBuffer,
+        fetchAccountReachoutTimelock,
+        fetchNewChatMessageCap,
         executeUSyncQuery,
         onWhatsApp
     }

package/lib/Types/Events.d.ts

@@ -41,6 +41,10 @@ export type BaileysEventMap = {
         lid: string
         jid: string
     }
+    'lid-mapping.update': {
+        lid: string
+        pn: string
+    }
     /** delete chats with given ID */
     'chats.delete': string[]
     /** presence of contact in a chat updated */

package/lib/Types/MexUpdates.d.ts

@@ -1,9 +1,11 @@
 export declare const enum MexUpdatesOperations {
     OWNER_COMMUNITY = "NotificationCommunityOwnerUpdate", 
-    GROUP_LIMIT_SHARING = "NotificationGroupLimitSharingPropertyUpdate"
+    GROUP_LIMIT_SHARING = "NotificationGroupLimitSharingPropertyUpdate",
+    LINKED_PROFILES = "NotificationLinkedProfilesUpdates"
 }
 
-export declare const enum XWAPathsUpdates {
+export declare const enum XWAPathsMexUpdates {
     GROUP_SHARING_CHANGE = "xwa2_notify_group_on_prop_change", 
-    COMMUNITY_OWNER_CHANGE = "xwa2_notify_group_on_participants_roles_change"
-}
+    COMMUNITY_OWNER_CHANGE = "xwa2_notify_group_on_participants_roles_change",
+    LINKED_PROFILES = "xwa2_notify_linked_profiles"
+}

package/lib/Types/MexUpdates.js

@@ -3,16 +3,18 @@
 Object.defineProperty(exports, "__esModule", { value: true })
 
 const MexUpdatesOperations = {
-	OWNER_COMMUNITY: "NotificationCommunityOwnerUpdate", 
-	GROUP_LIMIT_SHARING: "NotificationGroupLimitSharingPropertyUpdate"
+	OWNER_COMMUNITY: "NotificationCommunityOwnerUpdate",
+	GROUP_LIMIT_SHARING: "NotificationGroupLimitSharingPropertyUpdate",
+	LINKED_PROFILES: "NotificationLinkedProfilesUpdates"
 }
 
 const XWAPathsMexUpdates = {
-	GROUP_SHARING_CHANGE: "xwa2_notify_group_on_prop_change", 
-	COMMUNITY_OWNER_CHANGE: "xwa2_notify_group_on_participants_roles_change"
+	GROUP_SHARING_CHANGE: "xwa2_notify_group_on_prop_change",
+	COMMUNITY_OWNER_CHANGE: "xwa2_notify_group_on_participants_roles_change",
+	LINKED_PROFILES: "xwa2_notify_linked_profiles"
 }
 
 module.exports = {
   MexUpdatesOperations,
   XWAPathsMexUpdates
-}
+}

package/lib/Types/Newsletter.d.ts

@@ -90,14 +90,18 @@ export declare const enum XWAPaths {
     CREATE = "xwa2_newsletter_create",
     NEWSLETTER = "xwa2_newsletter",
     SUBSCRIBED = "xwa2_newsletter_subscribed", 
-    METADATA_UPDATE = "xwa2_notify_newsletter_on_metadata_update"
+    METADATA_UPDATE = "xwa2_notify_newsletter_on_metadata_update",
+    JOIN_V2 = "xwa2_newsletter_join_v2",
+    LEAVE_V2 = "xwa2_newsletter_leave_v2",
+    REACHOUT_TIMELOCK = "xwa2_fetch_account_reachout_timelock",
+    MESSAGE_CAPPING_INFO = "xwa2_message_capping_info"
 }
 
 export declare const enum QueryIds {
     JOB_MUTATION = "7150902998257522",
     METADATA = "6620195908089573",
-    UNFOLLOW = "7238632346214362",
-    FOLLOW = "7871414976211147",
+    UNFOLLOW = "9767147403369991",
+    FOLLOW = "24404358912487870",
     UNMUTE = "7337137176362961",
     MUTE = "25151904754424642",
     CREATE = "6996806640408138",
@@ -105,5 +109,7 @@ export declare const enum QueryIds {
     CHANGE_OWNER = "7341777602580933",
     DELETE = "8316537688363079",
     DEMOTE = "6551828931592903", 
-    SUBSCRIBED = "6388546374527196"
-}
+    SUBSCRIBED = "6388546374527196",
+    REACHOUT_TIMELOCK = "23983697327930364",
+    MESSAGE_CAPPING_INFO = "24503548349331633"
+}

package/lib/Types/Newsletter.js

@@ -15,14 +15,18 @@ const XWAPaths = {
     CREATE: "xwa2_newsletter_create",
     NEWSLETTER: "xwa2_newsletter",
     SUBSCRIBED: "xwa2_newsletter_subscribed", 
-    METADATA_UPDATE: "xwa2_notify_newsletter_on_metadata_update"
+    METADATA_UPDATE: "xwa2_notify_newsletter_on_metadata_update",
+    JOIN_V2: "xwa2_newsletter_join_v2",
+    LEAVE_V2: "xwa2_newsletter_leave_v2",
+    REACHOUT_TIMELOCK: "xwa2_fetch_account_reachout_timelock",
+    MESSAGE_CAPPING_INFO: "xwa2_message_capping_info"
 }
 
 const QueryIds = {
     JOB_MUTATION: "7150902998257522",
     METADATA: "6620195908089573",
-    UNFOLLOW: "7238632346214362",
-    FOLLOW: "7871414976211147",
+    UNFOLLOW: "9767147403369991",
+    FOLLOW: "24404358912487870",
     UNMUTE: "7337137176362961",
     MUTE: "25151904754424642",
     CREATE: "6996806640408138",
@@ -30,11 +34,13 @@ const QueryIds = {
     CHANGE_OWNER: "7341777602580933",
     DELETE: "8316537688363079",
     DEMOTE: "6551828931592903", 
-    SUBSCRIBED: "6388546374527196"
+    SUBSCRIBED: "6388546374527196",
+    REACHOUT_TIMELOCK: "23983697327930364",
+    MESSAGE_CAPPING_INFO: "24503548349331633"
 }
 
 module.exports = {
   MexOperations,
   XWAPaths,
   QueryIds
-}
+}

package/lib/Types/State.d.ts

@@ -38,4 +38,67 @@ export type ConnectionState = {
      * If this is false, the primary phone and other devices will receive notifs
      * */
     isOnline?: boolean
-}
+    /**
+     * When this is active, WhatsApp prevents outgoing messages and calls.
+     */
+    reachoutTimeLock?: ReachoutTimelockState
+}
+
+export type ReachoutTimelockState = {
+    isActive?: boolean
+    timeEnforcementEnds?: Date
+    enforcementType?: ReachoutTimelockEnforcementType
+}
+
+export declare const enum ReachoutTimelockEnforcementType {
+    BIZ_COMMERCE_VIOLATION_ALCOHOL = "BIZ_COMMERCE_VIOLATION_ALCOHOL",
+    BIZ_COMMERCE_VIOLATION_ADULT = "BIZ_COMMERCE_VIOLATION_ADULT",
+    BIZ_COMMERCE_VIOLATION_ANIMALS = "BIZ_COMMERCE_VIOLATION_ANIMALS",
+    BIZ_COMMERCE_VIOLATION_BODY_PARTS_FLUIDS = "BIZ_COMMERCE_VIOLATION_BODY_PARTS_FLUIDS",
+    BIZ_COMMERCE_VIOLATION_DATING = "BIZ_COMMERCE_VIOLATION_DATING",
+    BIZ_COMMERCE_VIOLATION_DIGITAL_SERVICES_PRODUCTS = "BIZ_COMMERCE_VIOLATION_DIGITAL_SERVICES_PRODUCTS",
+    BIZ_COMMERCE_VIOLATION_DRUGS = "BIZ_COMMERCE_VIOLATION_DRUGS",
+    BIZ_COMMERCE_VIOLATION_DRUGS_ONLY_OTC = "BIZ_COMMERCE_VIOLATION_DRUGS_ONLY_OTC",
+    BIZ_COMMERCE_VIOLATION_GAMBLING = "BIZ_COMMERCE_VIOLATION_GAMBLING",
+    BIZ_COMMERCE_VIOLATION_HEALTHCARE = "BIZ_COMMERCE_VIOLATION_HEALTHCARE",
+    BIZ_COMMERCE_VIOLATION_REAL_FAKE_CURRENCY = "BIZ_COMMERCE_VIOLATION_REAL_FAKE_CURRENCY",
+    BIZ_COMMERCE_VIOLATION_SUPPLEMENTS = "BIZ_COMMERCE_VIOLATION_SUPPLEMENTS",
+    BIZ_COMMERCE_VIOLATION_TOBACCO = "BIZ_COMMERCE_VIOLATION_TOBACCO",
+    BIZ_COMMERCE_VIOLATION_VIOLENT_CONTENT = "BIZ_COMMERCE_VIOLATION_VIOLENT_CONTENT",
+    BIZ_COMMERCE_VIOLATION_WEAPONS = "BIZ_COMMERCE_VIOLATION_WEAPONS",
+    BIZ_QUALITY = "BIZ_QUALITY",
+    DEFAULT = "DEFAULT",
+    WEB_COMPANION_ONLY = "WEB_COMPANION_ONLY"
+}
+
+export declare const enum NewChatMessageCappingStatusType {
+    NONE = "NONE",
+    FIRST_WARNING = "FIRST_WARNING",
+    SECOND_WARNING = "SECOND_WARNING",
+    CAPPED = "CAPPED"
+}
+
+export declare const enum NewChatMessageCappingMVStatusType {
+    NOT_ELIGIBLE = "NOT_ELIGIBLE",
+    NOT_ACTIVE = "NOT_ACTIVE",
+    ACTIVE = "ACTIVE",
+    ACTIVE_UPGRADE_AVAILABLE = "ACTIVE_UPGRADE_AVAILABLE"
+}
+
+export declare const enum NewChatMessageCappingOTEStatusType {
+    NOT_ELIGIBLE = "NOT_ELIGIBLE",
+    ELIGIBLE = "ELIGIBLE",
+    ACTIVE_IN_CURRENT_CYCLE = "ACTIVE_IN_CURRENT_CYCLE",
+    EXHAUSTED = "EXHAUSTED"
+}
+
+export type NewChatMessageCapInfo = {
+    total_quota?: number
+    used_quota?: number
+    cycle_start_timestamp?: string
+    cycle_end_timestamp?: string
+    server_sent_timestamp?: string
+    ote_status?: NewChatMessageCappingOTEStatusType
+    mv_status?: NewChatMessageCappingMVStatusType
+    capping_status?: NewChatMessageCappingStatusType
+}

package/lib/Types/State.js

@@ -9,6 +9,52 @@ const SyncState = {
 	Online: 3
 }
 
+const ReachoutTimelockEnforcementType = {
+	BIZ_COMMERCE_VIOLATION_ALCOHOL: "BIZ_COMMERCE_VIOLATION_ALCOHOL",
+	BIZ_COMMERCE_VIOLATION_ADULT: "BIZ_COMMERCE_VIOLATION_ADULT",
+	BIZ_COMMERCE_VIOLATION_ANIMALS: "BIZ_COMMERCE_VIOLATION_ANIMALS",
+	BIZ_COMMERCE_VIOLATION_BODY_PARTS_FLUIDS: "BIZ_COMMERCE_VIOLATION_BODY_PARTS_FLUIDS",
+	BIZ_COMMERCE_VIOLATION_DATING: "BIZ_COMMERCE_VIOLATION_DATING",
+	BIZ_COMMERCE_VIOLATION_DIGITAL_SERVICES_PRODUCTS: "BIZ_COMMERCE_VIOLATION_DIGITAL_SERVICES_PRODUCTS",
+	BIZ_COMMERCE_VIOLATION_DRUGS: "BIZ_COMMERCE_VIOLATION_DRUGS",
+	BIZ_COMMERCE_VIOLATION_DRUGS_ONLY_OTC: "BIZ_COMMERCE_VIOLATION_DRUGS_ONLY_OTC",
+	BIZ_COMMERCE_VIOLATION_GAMBLING: "BIZ_COMMERCE_VIOLATION_GAMBLING",
+	BIZ_COMMERCE_VIOLATION_HEALTHCARE: "BIZ_COMMERCE_VIOLATION_HEALTHCARE",
+	BIZ_COMMERCE_VIOLATION_REAL_FAKE_CURRENCY: "BIZ_COMMERCE_VIOLATION_REAL_FAKE_CURRENCY",
+	BIZ_COMMERCE_VIOLATION_SUPPLEMENTS: "BIZ_COMMERCE_VIOLATION_SUPPLEMENTS",
+	BIZ_COMMERCE_VIOLATION_TOBACCO: "BIZ_COMMERCE_VIOLATION_TOBACCO",
+	BIZ_COMMERCE_VIOLATION_VIOLENT_CONTENT: "BIZ_COMMERCE_VIOLATION_VIOLENT_CONTENT",
+	BIZ_COMMERCE_VIOLATION_WEAPONS: "BIZ_COMMERCE_VIOLATION_WEAPONS",
+	BIZ_QUALITY: "BIZ_QUALITY",
+	DEFAULT: "DEFAULT",
+	WEB_COMPANION_ONLY: "WEB_COMPANION_ONLY"
+}
+
+const NewChatMessageCappingStatusType = {
+	NONE: "NONE",
+	FIRST_WARNING: "FIRST_WARNING",
+	SECOND_WARNING: "SECOND_WARNING",
+	CAPPED: "CAPPED"
+}
+
+const NewChatMessageCappingMVStatusType = {
+	NOT_ELIGIBLE: "NOT_ELIGIBLE",
+	NOT_ACTIVE: "NOT_ACTIVE",
+	ACTIVE: "ACTIVE",
+	ACTIVE_UPGRADE_AVAILABLE: "ACTIVE_UPGRADE_AVAILABLE"
+}
+
+const NewChatMessageCappingOTEStatusType = {
+	NOT_ELIGIBLE: "NOT_ELIGIBLE",
+	ELIGIBLE: "ELIGIBLE",
+	ACTIVE_IN_CURRENT_CYCLE: "ACTIVE_IN_CURRENT_CYCLE",
+	EXHAUSTED: "EXHAUSTED"
+}
+
 module.exports = {
-  SyncState
-}
+  SyncState,
+  ReachoutTimelockEnforcementType,
+  NewChatMessageCappingStatusType,
+  NewChatMessageCappingMVStatusType,
+  NewChatMessageCappingOTEStatusType
+}

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

@@ -18,4 +18,6 @@ export declare function makeCacheableSignalKeyStore(store: SignalKeyStore, logge
  */
 export declare const addTransactionCapability: (state: SignalKeyStore, logger?: ILogger, { maxCommitRetries, delayBetweenTriesMs }: TransactionCapabilityOptions) => SignalKeyStoreWithTransaction
 
-export declare const initAuthCreds: () => AuthenticationCreds
+export declare const assertMeId: (creds: AuthenticationCreds) => string
+
+export declare const initAuthCreds: () => AuthenticationCreds

package/lib/Utils/auth-utils.js

@@ -8,6 +8,7 @@ Object.defineProperty(exports, "__esModule", { value: true })
 
 const crypto_1 = require("crypto")
 const node_cache_1 = __importDefault(require("@cacheable/node-cache"))
+const boom_1 = require("@hapi/boom")
 const Defaults_1 = require("../Defaults")
 const crypto_2 = require("./crypto")
 const generics_1 = require("./generics")
@@ -175,6 +176,15 @@ const addTransactionCapability = (state, logger, { maxCommitRetries, delayBetwee
     }
 }
 
+const assertMeId = (creds) => {
+    const id = creds.me?.id
+    if (!id) {
+        throw new boom_1.Boom('Cannot proceed: socket is not authenticated yet (creds.me.id is missing)', { statusCode: 401 })
+    }
+
+    return id
+}
+
 const initAuthCreds = () => {
     const identityKey = crypto_2.Curve.generateKeyPair()
     return {
@@ -201,5 +211,6 @@ const initAuthCreds = () => {
 module.exports = {
   makeCacheableSignalKeyStore, 
   addTransactionCapability, 
+  assertMeId,
   initAuthCreds
-}
+}

package/lib/Utils/decode-wa-message.d.ts

@@ -7,7 +7,10 @@ export declare const NO_MESSAGE_FOUND_ERROR_TEXT = "Message absent from node"
 
 export declare const MISSING_KEYS_ERROR_TEXT = "Key used already or never filled"
 
+export declare const ACCOUNT_RESTRICTED_TEXT = "Your account has been restricted"
+
 export declare const NACK_REASONS: {
+    SenderReachoutTimelocked: number
     ParsingError: number
     UnrecognizedStanza: number
     UnrecognizedStanzaClass: number
@@ -38,4 +41,4 @@ export declare const decryptMessageNode: (stanza: BinaryNode, meId: string, meLi
     category: string
     author: string
     decrypt(): Promise<void>
-}
+}

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

@@ -12,7 +12,10 @@ const NO_MESSAGE_FOUND_ERROR_TEXT = 'Message absent from node'
 
 const MISSING_KEYS_ERROR_TEXT = 'Key used already or never filled'
 
+const ACCOUNT_RESTRICTED_TEXT = 'Your account has been restricted'
+
 const NACK_REASONS = {
+    SenderReachoutTimelocked: 463,
     ParsingError: 487,
     UnrecognizedStanza: 488,
     UnrecognizedStanzaClass: 489,
@@ -43,6 +46,14 @@ function decodeMessageNode(stanza, meId, meLid) {
         participant = stanza.attrs.participant_pn;
     }
     const recipient = stanza.attrs.recipient
+    if (!msgId) {
+        throw new boom_1.Boom('Invalid message stanza: missing id attribute', { data: stanza })
+    }
+
+    if (!from) {
+        throw new boom_1.Boom('Invalid message stanza: missing from attribute', { data: stanza })
+    }
+
     const isMe = (jid) => WABinary_1.areJidsSameUser(jid, meId)
     const isMeLid = (jid) => WABinary_1.areJidsSameUser(jid, meLid)
     if (WABinary_1.isJidUser(from)) {
@@ -287,6 +298,10 @@ const decryptMessageNode = (stanza, meId, meLid, repository, logger) => {
 }
 
 module.exports = {
+  NO_MESSAGE_FOUND_ERROR_TEXT,
+  MISSING_KEYS_ERROR_TEXT,
+  ACCOUNT_RESTRICTED_TEXT,
+  NACK_REASONS,
   decodeMessageNode, 
   decryptMessageNode
 }

package/lib/Utils/messages.js

@@ -1555,7 +1555,7 @@ const patchMessageForMdIfRequired = (message) => {
 	if (message?.buttonsMessage || 
 	    message?.templateMessage ||
     	message?.listMessage ||
-	    message?.interactiveMessage?.nativeFlowMesaage
+        message?.interactiveMessage
 	) {
         message = {
             viewOnceMessageV2Extension: {

package/lib/Utils/process-message.js

@@ -3,6 +3,7 @@
 Object.defineProperty(exports, "__esModule", { value: true })
 
 const WAProto_1 = require("../../WAProto")
+const boom_1 = require("@hapi/boom")
 const Types_1 = require("../Types")
 const messages_1 = require("../Utils/messages")
 const WABinary_1 = require("../WABinary")
@@ -80,9 +81,21 @@ const shouldIncrementChatUnread = (message) => !message.key.fromMe && !message.m
  * Typically -- that'll be the remoteJid, but for broadcasts, it'll be the participant
  */
 const getChatId = ({ remoteJid, participant, fromMe }) => {
+    if (!remoteJid) {
+        throw new boom_1.Boom('Cannot derive chat id: message key is missing remoteJid', {
+            data: { remoteJid, participant, fromMe }
+        })
+    }
+
     if (WABinary_1.isJidBroadcast(remoteJid)
         && !WABinary_1.isJidStatusBroadcast(remoteJid)
         && !fromMe) {
+        if (!participant) {
+            throw new boom_1.Boom('Cannot derive chat id: broadcast message key is missing participant', {
+                data: { remoteJid, fromMe }
+            })
+        }
+
         return participant
     }
     return remoteJid

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neelegirly/baileys",
-  "version": "2.2.20",
+  "version": "2.2.21",
   "description": "Neelegirly fork of Baileys: multi-device WhatsApp Web API for Node.js",
   "keywords": [
     "whatsapp",
@@ -43,7 +43,7 @@
     "@adiwajshing/keyed-db": "^0.2.4",
     "@cacheable/node-cache": "^1.5.4",
     "@hapi/boom": "^9.1.3",
-    "@neelegirly/libsignal": "1.0.29",
+    "@neelegirly/libsignal": "1.0.30",
     "async-mutex": "^0.5.0",
     "audio-decode": "^2.1.3",
     "axios": "^1.3.3",
@@ -58,7 +58,7 @@
     "ws": "^8.13.0"
   },
   "overrides": {
-    "@neelegirly/libsignal": "1.0.29"
+    "@neelegirly/libsignal": "1.0.30"
   },
   "devDependencies": {
     "@adiwajshing/eslint-config": "github:adiwajshing/eslint-config",