zapo-js 0.3.0 → 1.0.1

package/dist/store/{providers/memory/participants.store.js → memory/group-metadata.store.js}

@@ -1,32 +1,41 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.WaParticipantsMemoryStore = void 0;
-const coercion_1 = require("../../../util/coercion");
-const collections_1 = require("../../../util/collections");
+exports.WaGroupMetadataMemoryStore = void 0;
+const coercion_1 = require("../../util/coercion");
+const collections_1 = require("../../util/collections");
 const DEFAULTS = Object.freeze({
     ttlMs: 5 * 60 * 1000,
     maxGroups: 4096
 });
-class WaParticipantsMemoryStore {
+class WaGroupMetadataMemoryStore {
     constructor(ttlMs = DEFAULTS.ttlMs, options = {}) {
         if (!Number.isFinite(ttlMs) || ttlMs <= 0) {
-            throw new Error('participants ttlMs must be a positive finite number');
+            throw new Error('groupMetadata ttlMs must be a positive finite number');
         }
         this.records = new Map();
         this.ttlMs = ttlMs;
-        this.maxGroups = (0, coercion_1.resolvePositive)(options.maxGroups, DEFAULTS.maxGroups, 'WaParticipantsMemoryStoreOptions.maxGroups');
-        this.cleanupTimer = setInterval(() => {
+        this.maxGroups = (0, coercion_1.resolvePositive)(options.maxGroups, DEFAULTS.maxGroups, 'WaGroupMetadataMemoryStoreOptions.maxGroups');
+        this.logger = options.logger;
+        this.capacityWarned = false;
+        this.cleanup = (0, collections_1.createPeriodicCleanup)(ttlMs, () => {
             void this.cleanupExpired(Date.now());
-        }, (0, collections_1.resolveCleanupIntervalMs)(ttlMs));
-        this.cleanupTimer.unref();
+        });
     }
-    async upsertGroupParticipants(snapshot) {
+    warnCapacity() {
+        if (this.capacityWarned || !this.logger)
+            return;
+        this.capacityWarned = true;
+        this.logger.warn('group metadata store at capacity, evicting oldest', {
+            max: this.maxGroups
+        });
+    }
+    async upsertGroupMetadata(snapshot) {
         (0, collections_1.setBoundedMapEntry)(this.records, snapshot.groupJid, {
             ...snapshot,
             expiresAtMs: snapshot.updatedAtMs + this.ttlMs
-        }, this.maxGroups);
+        }, this.maxGroups, () => this.warnCapacity());
     }
-    async getGroupParticipants(groupJid, nowMs = Date.now()) {
+    async getGroupMetadata(groupJid, nowMs = Date.now()) {
         const record = this.records.get(groupJid);
         if (!record) {
             return null;
@@ -37,7 +46,7 @@ class WaParticipantsMemoryStore {
         }
         return record;
     }
-    async deleteGroupParticipants(groupJid) {
+    async deleteGroupMetadata(groupJid) {
         return this.records.delete(groupJid) ? 1 : 0;
     }
     async cleanupExpired(nowMs) {
@@ -54,8 +63,8 @@ class WaParticipantsMemoryStore {
         this.records.clear();
     }
     async destroy() {
-        clearInterval(this.cleanupTimer);
+        this.cleanup.destroy();
         await this.clear();
     }
 }
-exports.WaParticipantsMemoryStore = WaParticipantsMemoryStore;
+exports.WaGroupMetadataMemoryStore = WaGroupMetadataMemoryStore;

package/dist/store/{providers/memory → memory}/identity.store.js

@@ -1,9 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.WaIdentityMemoryStore = void 0;
-const jid_1 = require("../../../protocol/jid");
-const coercion_1 = require("../../../util/coercion");
-const collections_1 = require("../../../util/collections");
+const jid_1 = require("../../protocol/jid");
+const coercion_1 = require("../../util/coercion");
+const collections_1 = require("../../util/collections");
 const DEFAULT_MAX_REMOTE_IDENTITIES = 8192;
 class WaIdentityMemoryStore {
     constructor(options = {}) {

package/dist/store/{providers/memory → memory}/message-secret.store.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.WaMessageSecretMemoryStore = void 0;
-const coercion_1 = require("../../../util/coercion");
-const collections_1 = require("../../../util/collections");
+const coercion_1 = require("../../util/coercion");
+const collections_1 = require("../../util/collections");
 const DEFAULTS = Object.freeze({
     ttlMs: 30 * 60 * 1000,
     maxSecrets: 10000
@@ -15,10 +15,19 @@ class WaMessageSecretMemoryStore {
         this.secrets = new Map();
         this.ttlMs = ttlMs;
         this.maxSecrets = (0, coercion_1.resolvePositive)(options.maxSecrets, DEFAULTS.maxSecrets, 'WaMessageSecretMemoryStoreOptions.maxSecrets');
-        this.cleanupTimer = setInterval(() => {
+        this.logger = options.logger;
+        this.capacityWarned = false;
+        this.cleanup = (0, collections_1.createPeriodicCleanup)(ttlMs, () => {
             void this.cleanupExpired(Date.now());
-        }, (0, collections_1.resolveCleanupIntervalMs)(ttlMs));
-        this.cleanupTimer.unref();
+        });
+    }
+    warnCapacity() {
+        if (this.capacityWarned || !this.logger)
+            return;
+        this.capacityWarned = true;
+        this.logger.warn('message secret store at capacity, evicting oldest', {
+            max: this.maxSecrets
+        });
     }
     async get(messageId, nowMs = Date.now()) {
         const cached = this.secrets.get(messageId);
@@ -52,7 +61,7 @@ class WaMessageSecretMemoryStore {
             secret: entry.secret,
             senderJid: entry.senderJid,
             expiresAtMs: Date.now() + this.ttlMs
-        }, this.maxSecrets);
+        }, this.maxSecrets, () => this.warnCapacity());
     }
     async setBatch(entries) {
         const nowMs = Date.now();
@@ -61,7 +70,7 @@ class WaMessageSecretMemoryStore {
                 secret: entries[i].entry.secret,
                 senderJid: entries[i].entry.senderJid,
                 expiresAtMs: nowMs + this.ttlMs
-            }, this.maxSecrets);
+            }, this.maxSecrets, () => this.warnCapacity());
         }
     }
     async cleanupExpired(nowMs) {
@@ -78,7 +87,7 @@ class WaMessageSecretMemoryStore {
         this.secrets.clear();
     }
     async destroy() {
-        clearInterval(this.cleanupTimer);
+        this.cleanup.destroy();
         this.secrets.clear();
     }
 }

package/dist/store/{providers/memory → memory}/message.store.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.WaMessageMemoryStore = void 0;
-const coercion_1 = require("../../../util/coercion");
-const collections_1 = require("../../../util/collections");
+const coercion_1 = require("../../util/coercion");
+const collections_1 = require("../../util/collections");
 const DEFAULT_MESSAGE_MEMORY_STORE_LIMITS = Object.freeze({
     messages: 50000
 });

package/dist/store/{providers/memory → memory}/pre-key.store.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.WaPreKeyMemoryStore = void 0;
-const coercion_1 = require("../../../util/coercion");
-const collections_1 = require("../../../util/collections");
+const coercion_1 = require("../../util/coercion");
+const collections_1 = require("../../util/collections");
 const DEFAULT_MAX_PRE_KEYS = 4096;
 class WaPreKeyMemoryStore {
     constructor(options = {}) {

package/dist/store/{providers/memory → memory}/privacy-token.store.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.WaPrivacyTokenMemoryStore = void 0;
-const collections_1 = require("../../../util/collections");
+const collections_1 = require("../../util/collections");
 const DEFAULT_MAX_ENTRIES = 10000;
 class WaPrivacyTokenMemoryStore {
     constructor(maxEntries = DEFAULT_MAX_ENTRIES) {

package/dist/store/{providers/memory → memory}/retry.store.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.WaRetryMemoryStore = void 0;
-const coercion_1 = require("../../../util/coercion");
-const collections_1 = require("../../../util/collections");
+const coercion_1 = require("../../util/coercion");
+const collections_1 = require("../../util/collections");
 const DEFAULTS = Object.freeze({
     ttlMs: 60 * 1000,
     maxOutboundMessages: 10000,
@@ -19,10 +19,28 @@ class WaRetryMemoryStore {
         this.ttlMs = ttlMs;
         this.maxOutboundMessages = (0, coercion_1.resolvePositive)(options.maxOutboundMessages, DEFAULTS.maxOutboundMessages, 'WaRetryMemoryStoreOptions.maxOutboundMessages');
         this.maxInboundCounters = (0, coercion_1.resolvePositive)(options.maxInboundCounters, DEFAULTS.maxInboundCounters, 'WaRetryMemoryStoreOptions.maxInboundCounters');
-        this.cleanupTimer = setInterval(() => {
+        this.logger = options.logger;
+        this.outboundCapacityWarned = false;
+        this.inboundCapacityWarned = false;
+        this.cleanup = (0, collections_1.createPeriodicCleanup)(this.ttlMs, () => {
             void this.cleanupExpired(Date.now());
-        }, (0, collections_1.resolveCleanupIntervalMs)(this.ttlMs));
-        this.cleanupTimer.unref();
+        });
+    }
+    warnOutboundCapacity() {
+        if (this.outboundCapacityWarned || !this.logger)
+            return;
+        this.outboundCapacityWarned = true;
+        this.logger.warn('retry outbound store at capacity, evicting oldest', {
+            max: this.maxOutboundMessages
+        });
+    }
+    warnInboundCapacity() {
+        if (this.inboundCapacityWarned || !this.logger)
+            return;
+        this.inboundCapacityWarned = true;
+        this.logger.warn('retry inbound counters at capacity, evicting oldest', {
+            max: this.maxInboundCounters
+        });
     }
     getTtlMs() {
         return this.ttlMs;
@@ -78,6 +96,7 @@ class WaRetryMemoryStore {
         };
         (0, collections_1.setBoundedMapEntry)(this.outboundMessages, record.messageId, storedRecord, this.maxOutboundMessages, (messageId) => {
             this.eligibleSets.delete(messageId);
+            this.warnOutboundCapacity();
         });
         if (record.eligibleRequesterDeviceJids && record.eligibleRequesterDeviceJids.length > 0) {
             this.eligibleSets.set(record.messageId, new Set(record.eligibleRequesterDeviceJids));
@@ -106,6 +125,7 @@ class WaRetryMemoryStore {
             expiresAtMs
         }, this.maxOutboundMessages, (evictedMessageId) => {
             this.eligibleSets.delete(evictedMessageId);
+            this.warnOutboundCapacity();
         });
     }
     async markOutboundRequesterDelivered(messageId, requesterDeviceJid, updatedAtMs, expiresAtMs) {
@@ -122,13 +142,14 @@ class WaRetryMemoryStore {
             expiresAtMs
         }, this.maxOutboundMessages, (evictedMessageId) => {
             this.eligibleSets.delete(evictedMessageId);
+            this.warnOutboundCapacity();
         });
     }
     async incrementInboundCounter(messageId, requesterJid, _updatedAtMs, expiresAtMs) {
         const key = this.counterKey(messageId, requesterJid);
         const current = this.inboundCounters.get(key);
         const count = current ? current.count + 1 : 1;
-        (0, collections_1.setBoundedMapEntry)(this.inboundCounters, key, { count, expiresAtMs }, this.maxInboundCounters);
+        (0, collections_1.setBoundedMapEntry)(this.inboundCounters, key, { count, expiresAtMs }, this.maxInboundCounters, () => this.warnInboundCapacity());
         return count;
     }
     async cleanupExpired(nowMs) {
@@ -154,7 +175,7 @@ class WaRetryMemoryStore {
         this.inboundCounters.clear();
     }
     async destroy() {
-        clearInterval(this.cleanupTimer);
+        this.cleanup.destroy();
         await this.clear();
     }
     counterKey(messageId, requesterJid) {

package/dist/store/{providers/memory → memory}/sender-key.store.js

@@ -1,9 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SenderKeyMemoryStore = void 0;
-const jid_1 = require("../../../protocol/jid");
-const coercion_1 = require("../../../util/coercion");
-const collections_1 = require("../../../util/collections");
+const jid_1 = require("../../protocol/jid");
+const coercion_1 = require("../../util/coercion");
+const collections_1 = require("../../util/collections");
 const DEFAULT_SENDER_KEY_STORE_LIMITS = Object.freeze({
     senderKeys: 8192,
     senderDistributions: 8192

package/dist/store/{providers/memory → memory}/session.store.js

@@ -1,9 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.WaSessionMemoryStore = void 0;
-const jid_1 = require("../../../protocol/jid");
-const coercion_1 = require("../../../util/coercion");
-const collections_1 = require("../../../util/collections");
+const jid_1 = require("../../protocol/jid");
+const coercion_1 = require("../../util/coercion");
+const collections_1 = require("../../util/collections");
 const DEFAULT_MAX_SESSIONS = 8192;
 class WaSessionMemoryStore {
     constructor(options = {}) {

package/dist/store/{providers/memory → memory}/thread.store.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.WaThreadMemoryStore = void 0;
-const coercion_1 = require("../../../util/coercion");
-const collections_1 = require("../../../util/collections");
+const coercion_1 = require("../../util/coercion");
+const collections_1 = require("../../util/collections");
 const DEFAULT_THREAD_MEMORY_STORE_LIMITS = Object.freeze({
     threads: 10000
 });

package/dist/store/noop.store.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.NOOP_DEVICE_LIST_STORE = exports.NOOP_PARTICIPANTS_STORE = exports.NOOP_RETRY_STORE = exports.NOOP_CONTACT_STORE = exports.NOOP_THREAD_STORE = exports.NOOP_MESSAGE_STORE = exports.NOOP_MESSAGE_SECRET_STORE = void 0;
+exports.NOOP_DEVICE_LIST_STORE = exports.NOOP_GROUP_METADATA_STORE = exports.NOOP_RETRY_STORE = exports.NOOP_CONTACT_STORE = exports.NOOP_THREAD_STORE = exports.NOOP_MESSAGE_STORE = exports.NOOP_MESSAGE_SECRET_STORE = void 0;
 const EMPTY_STORE_LIST = Object.freeze([]);
 exports.NOOP_MESSAGE_SECRET_STORE = Object.freeze({
     get: async (_messageId) => null,
@@ -30,6 +30,7 @@ exports.NOOP_CONTACT_STORE = Object.freeze({
     upsert: async (_record) => { },
     upsertBatch: async (_records) => { },
     getByJid: async (_jid) => null,
+    getByPhoneNumber: async (_pn) => null,
     deleteByJid: async (_jid) => 0,
     clear: async () => { }
 });
@@ -45,10 +46,10 @@ exports.NOOP_RETRY_STORE = Object.freeze({
     clear: async () => { },
     destroy: async () => { }
 });
-exports.NOOP_PARTICIPANTS_STORE = Object.freeze({
-    upsertGroupParticipants: async (_snapshot) => { },
-    getGroupParticipants: async (_groupJid, _nowMs) => null,
-    deleteGroupParticipants: async (_groupJid) => 0,
+exports.NOOP_GROUP_METADATA_STORE = Object.freeze({
+    upsertGroupMetadata: async (_snapshot) => { },
+    getGroupMetadata: async (_groupJid, _nowMs) => null,
+    deleteGroupMetadata: async (_groupJid) => 0,
     cleanupExpired: async (_nowMs) => 0,
     clear: async () => { },
     destroy: async () => { }
@@ -56,6 +57,7 @@ exports.NOOP_PARTICIPANTS_STORE = Object.freeze({
 exports.NOOP_DEVICE_LIST_STORE = Object.freeze({
     upsertUserDevicesBatch: async (_snapshots) => { },
     getUserDevicesBatch: async (userJids, _nowMs) => new Array(userJids.length).fill(null),
+    findByAnyUserJid: async (_jid, _nowMs) => null,
     deleteUserDevices: async (_userJid) => 0,
     cleanupExpired: async (_nowMs) => 0,
     clear: async () => { },

package/dist/transport/WaComms.js

@@ -12,6 +12,11 @@ const WA_FRAME_HANDLER_QUEUE_MAX_SIZE = 4096;
 const WA_FRAME_HANDLER_MAX_CONCURRENCY = 8;
 const WA_PENDING_FRAMES_MAX_COUNT = 2048;
 const WA_PENDING_FRAMES_MAX_BYTES = 16 * 1024 * 1024;
+/**
+ * Owns the WebSocket + Noise handshake lifecycle: opens the socket, drives
+ * the noise pairing/login exchange, persists routing-info/server-static
+ * updates, and delivers post-handshake binary frames to the caller.
+ */
 class WaComms {
     constructor(config, logger = new ConsoleLogger_1.ConsoleLogger('info')) {
         if (!config.noise) {
@@ -49,6 +54,7 @@ class WaComms {
             onClose: async (info) => {
                 await this.onSocketClosed(info);
             },
+            // eslint-disable-next-line @typescript-eslint/require-await
             onError: async (error) => {
                 this.logger.warn('socket runtime error', { message: error.message });
             },
@@ -113,7 +119,7 @@ class WaComms {
         };
     }
     startComms(handleStanza, inflateFrame) {
-        this.logger.info('comms start requested');
+        this.logger.debug('comms start requested');
         this.stanzaHandler = handleStanza;
         this.inflateFrame = inflateFrame ?? null;
         this.clearPendingFrames();
@@ -153,7 +159,7 @@ class WaComms {
         this.frameProcessingQueue = this.frameProcessingQueue.then(() => this.flushPendingFrames(), () => this.flushPendingFrames());
     }
     async stopComms() {
-        this.logger.info('comms stop requested');
+        this.logger.debug('comms stop requested');
         this.resetConnectionState({
             started: false,
             connected: false,
@@ -166,7 +172,7 @@ class WaComms {
         await this.socket.close(1000, 'stop_comms');
     }
     async closeSocketAndResume() {
-        this.logger.info('comms close socket and resume requested');
+        this.logger.debug('comms close socket and resume requested');
         this.resetConnectionState({
             started: true,
             connected: false,
@@ -251,6 +257,7 @@ class WaComms {
             this.logger.warn('socket open failed', { message: (0, primitives_1.toError)(error).message });
         }
     }
+    // eslint-disable-next-line @typescript-eslint/require-await
     async onSocketClosed(info) {
         this.connected = false;
         this.noiseSession?.onSocketClosed(new Error(`socket closed (${info.code}:${info.reason})`));
@@ -272,7 +279,8 @@ class WaComms {
         this.logger.info('socket closed, scheduling reconnect', {
             code: info.code,
             reason: info.reason,
-            reconnectAfterMs: this.config.reconnectIntervalMs
+            reconnectAfterMs: this.config.reconnectIntervalMs,
+            reconnectAttempts: this.reconnectAttempts
         });
     }
     onSocketMessage(payload) {
@@ -347,9 +355,10 @@ class WaComms {
         this.lastServerStaticKey = session.getServerStaticKey();
         this.connected = true;
         this.reconnectAttempts = 0;
-        this.logger.info('comms connected and noise session established');
+        this.logger.debug('comms connected and noise session established');
         this.drainWaiters((waiter) => waiter.resolve());
     }
+    // eslint-disable-next-line @typescript-eslint/require-await
     async flushPendingFrames() {
         if (!this.handlingRequests || !this.stanzaHandler || this.pendingFrames.length === 0) {
             return;

package/dist/transport/WaWebSocket.js

@@ -103,6 +103,11 @@ function resolveSocketRuntime() {
     }
     return 'browser';
 }
+/**
+ * Thin wrapper around a `RawWebSocket` (or Node `ws` constructor) used by
+ * {@link WaComms}. Iterates the configured URL list on failure and applies a
+ * connect/idle timeout.
+ */
 class WaWebSocket {
     constructor(config, logger = new ConsoleLogger_1.ConsoleLogger('info')) {
         this.config = Object.freeze({
@@ -208,6 +213,7 @@ class WaWebSocket {
             }
         });
     }
+    // eslint-disable-next-line @typescript-eslint/require-await
     async send(data) {
         const socket = this.socket;
         if (!socket || socket.readyState !== constants_1.WA_READY_STATES.OPEN) {
@@ -371,16 +377,30 @@ class WaWebSocket {
             handlers.onOpen();
         };
         entry.socket.onerror = () => {
-            this.logger.warn('socket open error', { url: entry.url });
+            if (entry.settled) {
+                this.logger.trace('settled pending socket error', { url: entry.url });
+            }
+            else {
+                this.logger.warn('socket open error', { url: entry.url });
+            }
             handlers.onFail(new Error(`websocket connect error for ${entry.url}`));
         };
         entry.socket.onclose = (event) => {
             const info = this.toCloseInfo(event);
-            this.logger.warn('socket closed before open', {
-                url: entry.url,
-                code: info.code,
-                reason: info.reason
-            });
+            if (entry.settled) {
+                this.logger.trace('settled pending socket closed', {
+                    url: entry.url,
+                    code: info.code,
+                    reason: info.reason
+                });
+            }
+            else {
+                this.logger.warn('socket closed before open', {
+                    url: entry.url,
+                    code: info.code,
+                    reason: info.reason
+                });
+            }
             handlers.onFail(new Error(`websocket closed before open (${info.code}:${info.reason}) for ${entry.url}`));
         };
     }
@@ -440,8 +460,12 @@ class WaWebSocket {
         try {
             socket.close(code, reason);
         }
-        catch {
-            // no-op
+        catch (error) {
+            this.logger.trace('socket close ignored', {
+                code,
+                reason,
+                message: (0, primitives_1.toError)(error).message
+            });
         }
     }
     async createRawSocket(url) {

package/dist/transport/binary/constants.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DICTIONARY_TOKEN_MAPS = exports.SINGLE_BYTE_TOKEN_MAP = exports.HEX_ALPHABET = exports.NIBBLE_ALPHABET = exports.NIBBLE_8 = exports.BINARY_32 = exports.BINARY_20 = exports.BINARY_8 = exports.HEX_8 = exports.JID_PAIR = exports.LIST_16 = exports.LIST_8 = exports.JID_U = exports.JID_FB = exports.JID_INTEROP = exports.DICTIONARY_3 = exports.DICTIONARY_0 = exports.STREAM_END = exports.LIST_EMPTY = void 0;
+exports.DICTIONARY_TOKEN_MAPS = exports.SINGLE_BYTE_TOKEN_MAP = exports.HEX_ALPHABET = exports.NIBBLE_ALPHABET = exports.JID_U_DOMAIN_TYPE_LID_MASK = exports.JID_U_DOMAIN_TYPE_HOSTED_MASK = exports.JID_U_DOMAIN_TYPE_HOSTED_LID = exports.JID_U_DOMAIN_TYPE_HOSTED = exports.JID_U_DOMAIN_TYPE_LID = exports.JID_U_DOMAIN_TYPE_PN = exports.NIBBLE_8 = exports.BINARY_32 = exports.BINARY_20 = exports.BINARY_8 = exports.HEX_8 = exports.JID_PAIR = exports.LIST_16 = exports.LIST_8 = exports.JID_U = exports.JID_FB = exports.JID_INTEROP = exports.DICTIONARY_3 = exports.DICTIONARY_0 = exports.STREAM_END = exports.LIST_EMPTY = void 0;
 const tokens_1 = require("../binary/tokens");
 exports.LIST_EMPTY = 0;
 exports.STREAM_END = 2;
@@ -17,7 +17,13 @@ exports.BINARY_8 = 252;
 exports.BINARY_20 = 253;
 exports.BINARY_32 = 254;
 exports.NIBBLE_8 = 255;
-exports.NIBBLE_ALPHABET = [
+exports.JID_U_DOMAIN_TYPE_PN = 0x00;
+exports.JID_U_DOMAIN_TYPE_LID = 0x01;
+exports.JID_U_DOMAIN_TYPE_HOSTED = 0x80;
+exports.JID_U_DOMAIN_TYPE_HOSTED_LID = 0x81;
+exports.JID_U_DOMAIN_TYPE_HOSTED_MASK = 0x80;
+exports.JID_U_DOMAIN_TYPE_LID_MASK = 0x01;
+exports.NIBBLE_ALPHABET = Object.freeze([
     '0',
     '1',
     '2',
@@ -34,8 +40,8 @@ exports.NIBBLE_ALPHABET = [
     '\uFFFD',
     '\uFFFD',
     '\uFFFD'
-];
-exports.HEX_ALPHABET = [
+]);
+exports.HEX_ALPHABET = Object.freeze([
     '0',
     '1',
     '2',
@@ -52,7 +58,7 @@ exports.HEX_ALPHABET = [
     'D',
     'E',
     'F'
-];
+]);
 exports.SINGLE_BYTE_TOKEN_MAP = (() => {
     const map = new Map();
     for (let i = 0; i < tokens_1.SINGLE_BYTE_TOKENS.length; i += 1) {

package/dist/transport/binary/decoder.js

@@ -10,13 +10,6 @@ const tokens_1 = require("../binary/tokens");
 const bytes_1 = require("../../util/bytes");
 const unzipAsync = (0, node_util_1.promisify)(node_zlib_1.unzip);
 const inflateRawAsync = (0, node_util_1.promisify)(node_zlib_1.inflateRaw);
-const JID_U_DOMAIN_TYPE_LID = 0x01;
-const JID_U_DOMAIN_TYPE_HOSTED_LID = 0x81;
-const JID_U_DOMAIN_TYPE_HOSTED_MASK = 0x80;
-const JID_U_DOMAIN_TYPE_LID_MASK = 0x01;
-const JID_U_DOMAIN_LID = 'lid';
-const JID_U_DOMAIN_HOSTED = 'hosted';
-const JID_U_DOMAIN_HOSTED_LID = 'hosted.lid';
 class ByteReader {
     constructor(data) {
         this.data = data;
@@ -58,27 +51,35 @@ class ByteReader {
         }
     }
 }
+// Reusable scratch buffer for nibble/hex unpack. Max output is
+// `(0x7f) * 2 = 254` bytes (length byte holds the packed-byte count in
+// its low 7 bits, each byte unpacks to ≤2 chars). Single-threaded JS +
+// non-reentrant decoder makes module-level reuse safe – `TextDecoder`
+// copies into the returned string before we touch the buffer again.
+const PACKED_SCRATCH = new Uint8Array(256);
 function parsePacked(reader, alphabet) {
     const lengthByte = reader.readUint8();
     const odd = (lengthByte & 0x80) !== 0;
     const byteCount = lengthByte & 0x7f;
     const outLength = byteCount * 2 - (odd ? 1 : 0);
-    const buf = new Uint8Array(outLength);
+    if (outLength < 0) {
+        throw new Error(`invalid packed length byte 0x${lengthByte.toString(16)}`);
+    }
     let outIndex = 0;
     for (let i = 0; i < byteCount; i += 1) {
         const packed = reader.readUint8();
         const high = (packed >>> 4) & 0x0f;
         const low = packed & 0x0f;
         if (outIndex < outLength) {
-            buf[outIndex] = alphabet[high].charCodeAt(0);
+            PACKED_SCRATCH[outIndex] = alphabet[high].charCodeAt(0);
             outIndex += 1;
         }
         if (outIndex < outLength) {
-            buf[outIndex] = alphabet[low].charCodeAt(0);
+            PACKED_SCRATCH[outIndex] = alphabet[low].charCodeAt(0);
             outIndex += 1;
         }
     }
-    return bytes_1.TEXT_DECODER.decode(buf);
+    return bytes_1.TEXT_DECODER.decode(PACKED_SCRATCH.subarray(0, outLength));
 }
 function readBinary(reader, token) {
     if (token === constants_2.BINARY_8) {
@@ -131,15 +132,15 @@ function decodeJidU(reader) {
     const device = reader.readUint8();
     const user = decodeTokenString(reader.readUint8(), reader);
     let domain = constants_1.WA_DEFAULTS.HOST_DOMAIN;
-    if (domainType === JID_U_DOMAIN_TYPE_LID) {
-        domain = JID_U_DOMAIN_LID;
+    if (domainType === constants_2.JID_U_DOMAIN_TYPE_LID) {
+        domain = constants_1.WA_DEFAULTS.LID_SERVER;
     }
-    else if (domainType === JID_U_DOMAIN_TYPE_HOSTED_LID) {
-        domain = JID_U_DOMAIN_HOSTED_LID;
+    else if (domainType === constants_2.JID_U_DOMAIN_TYPE_HOSTED_LID) {
+        domain = constants_1.WA_DEFAULTS.HOSTED_LID_SERVER;
     }
-    else if ((domainType & JID_U_DOMAIN_TYPE_HOSTED_MASK) !== 0 &&
-        (domainType & JID_U_DOMAIN_TYPE_LID_MASK) === 0) {
-        domain = JID_U_DOMAIN_HOSTED;
+    else if ((domainType & constants_2.JID_U_DOMAIN_TYPE_HOSTED_MASK) !== 0 &&
+        (domainType & constants_2.JID_U_DOMAIN_TYPE_LID_MASK) === 0) {
+        domain = constants_1.WA_DEFAULTS.HOSTED_SERVER;
     }
     if (device > 0) {
         return `${user}:${device}@${domain}`;
@@ -247,6 +248,7 @@ function decodeNodeInternal(reader) {
         : { tag: tagValue, attrs, content };
     return node;
 }
+/** Decodes raw WhatsApp binary node bytes into a {@link BinaryNode}. */
 function decodeBinaryNode(data) {
     const reader = new ByteReader(data);
     return decodeNodeInternal(reader);
@@ -265,6 +267,10 @@ async function inflateCompressedStanza(data) {
         }
     }
 }
+/**
+ * Decodes a framed stanza: reads the 1-byte flag, inflates the body when the
+ * `0x02` compression bit is set, then parses the result as a {@link BinaryNode}.
+ */
 async function decodeBinaryNodeStanza(stanza) {
     const reader = new ByteReader(stanza);
     const flag = reader.readUint8();