zapo-js 1.1.0 → 1.1.2

package/dist/message/WaMessageClient.js

@@ -191,6 +191,9 @@ class WaMessageClient {
         if (input.metaNode) {
             content.push(input.metaNode);
         }
+        if (input.privacyTokenNode) {
+            content.push(input.privacyTokenNode);
+        }
         const node = {
             tag: constants_1.WA_MESSAGE_TAGS.MESSAGE,
             attrs,

package/dist/message/primitives/incoming.d.ts

@@ -16,6 +16,12 @@ interface WaIncomingMessageAckHandlerOptions {
     readonly emitNewsletterMessageUpdate?: (event: WaIncomingNewsletterMessageUpdateEvent) => void;
     readonly emitUnhandledStanza?: (event: WaIncomingUnhandledStanzaEvent) => void;
 }
-export declare function buildRecoveredIncomingEvent(webMessageInfo: proto.IWebMessageInfo): WaIncomingMessageEvent;
+/**
+ * Rebuilds a `message` event from a recovered {@link proto.IWebMessageInfo}
+ * (placeholder resend). `meJid` is the current account user JID, used as the
+ * author fallback for self-sent group messages when the proto carries no
+ * participant and no `originalSelfAuthorUserJidString`.
+ */
+export declare function buildRecoveredIncomingEvent(webMessageInfo: proto.IWebMessageInfo, meJid?: string | null): WaIncomingMessageEvent;
 export declare function handleIncomingMessageAck(node: BinaryNode, options: WaIncomingMessageAckHandlerOptions): Promise<boolean>;
 export {};

package/dist/message/primitives/incoming.js

@@ -73,13 +73,22 @@ function buildIncomingEventRawNode(node) {
         content: children
     };
 }
-function buildRecoveredIncomingEvent(webMessageInfo) {
+/**
+ * Rebuilds a `message` event from a recovered {@link proto.IWebMessageInfo}
+ * (placeholder resend). `meJid` is the current account user JID, used as the
+ * author fallback for self-sent group messages when the proto carries no
+ * participant and no `originalSelfAuthorUserJidString`.
+ */
+function buildRecoveredIncomingEvent(webMessageInfo, meJid) {
     const key = webMessageInfo.key ?? {};
     const chatJid = key.remoteJid ?? undefined;
     const fromMe = key.fromMe === true;
-    const participant = key.participant ?? undefined;
     const isGroup = chatJid ? (0, jid_1.isGroupJid)(chatJid) : false;
     const isBroadcast = chatJid ? (0, jid_1.isBroadcastJid)(chatJid) : false;
+    const rawSelfAuthor = webMessageInfo.originalSelfAuthorUserJidString ?? meJid ?? undefined;
+    const selfAuthor = fromMe && (isGroup || isBroadcast) && rawSelfAuthor ? (0, jid_1.toUserJid)(rawSelfAuthor) : undefined;
+    const participant = webMessageInfo.participant ?? key.participant ?? selfAuthor;
+    const pushName = webMessageInfo.pushName ?? undefined;
     const rawSender = fromMe ? undefined : isGroup || isBroadcast ? participant : chatJid;
     const sender = rawSender ? (0, jid_1.parseJidFull)(rawSender) : null;
     const senderDevice = sender?.address.device;
@@ -94,7 +103,8 @@ function buildRecoveredIncomingEvent(webMessageInfo) {
         attrs: {
             ...(stanzaId !== undefined ? { id: stanzaId } : {}),
             ...(chatJid !== undefined ? { from: chatJid } : {}),
-            ...(participant !== undefined ? { participant } : {})
+            ...(participant !== undefined ? { participant } : {}),
+            ...(pushName !== undefined ? { notify: pushName } : {})
         }
     };
     return {
@@ -111,6 +121,7 @@ function buildRecoveredIncomingEvent(webMessageInfo) {
         },
         timestampSeconds,
         ...(expirationSeconds !== undefined ? { expirationSeconds } : {}),
+        ...(pushName !== undefined ? { pushName } : {}),
         message
     };
 }
@@ -233,7 +244,7 @@ function processMsmsgEncNode(node, encNode, senderJid, options) {
                 encPayload: decoded.encPayload
             }
         };
-        const chatJid = node.attrs.from;
+        const chatJid = node.attrs.from ? (0, jid_1.toUserJid)(node.attrs.from) : node.attrs.from;
         const sender = senderJid ? (0, jid_1.parseJidFull)(senderJid) : null;
         const isGroup = chatJid ? (0, jid_1.isGroupJid)(chatJid) : false;
         const isBroadcast = chatJid ? (0, jid_1.isBroadcastJid)(chatJid) : false;
@@ -306,7 +317,11 @@ async function decryptAndProcessEncNode(node, encNode, encType, senderJid, optio
             }
         }
         if (shouldEmitIncomingMessage(message)) {
-            const chatJid = node.attrs.from;
+            // remoteJid is the chat identity, which is deviceless: the device
+            // lives in senderDevice (from senderAddress), so strip any `:device`
+            // segment the `from` attr carries for 1:1 chats.
+            const fromAttr = node.attrs.from;
+            const chatJid = fromAttr ? (0, jid_1.toUserJid)(fromAttr) : fromAttr;
             const isGroup = chatJid ? (0, jid_1.isGroupJid)(chatJid) : false;
             const isBroadcast = chatJid ? (0, jid_1.isBroadcastJid)(chatJid) : false;
             const senderUserJid = `${senderAddress.user}@${senderAddress.server}`;

package/dist/message/types.d.ts

@@ -268,6 +268,11 @@ export interface WaEncryptedMessageInput {
     readonly participant?: string;
     readonly deviceFanout?: string;
     readonly metaNode?: BinaryNode;
+    /**
+     * Trusted-contact (privacy) token node, appended as a `<tctoken>` child.
+     * Recipients that require one nack a token-less send with error 463.
+     */
+    readonly privacyTokenNode?: BinaryNode;
 }
 export interface WaSendReceiptInput {
     readonly to: string;

package/dist/protocol/constants.d.ts

@@ -5,7 +5,7 @@ export type { WaConnectionCode, WaConnectionOpenReason, WaDisconnectReason, WaFa
 export { WA_IQ_TYPES, WA_NODE_TAGS, WA_XMLNS } from './nodes';
 export { WA_CALL_CHILD_TAGS, WA_CALL_NODE_ATTRS, WA_CALL_PAYLOAD_TAGS, WA_CALL_RECEIPT_PAYLOAD_TAGS } from './call';
 export type { WaCallPayloadTag } from './call';
-export { WA_EDIT_ATTRS, WA_ENC_MEDIA_TYPES, WA_EVENT_META_TYPES, WA_MESSAGE_TAGS, WA_MESSAGE_TYPES, WA_POLL_META_TYPES, WA_RETRYABLE_ACK_CODES, WA_STANZA_MSG_TYPES } from './message';
+export { WA_EDIT_ATTRS, WA_ENC_MEDIA_TYPES, WA_EVENT_META_TYPES, WA_MESSAGE_TAGS, WA_MESSAGE_TYPES, WA_NACK_REASONS, WA_POLL_META_TYPES, WA_RETRYABLE_ACK_CODES, WA_STANZA_MSG_TYPES } from './message';
 export type { WaOutboundReceiptType } from './message';
 export { WA_APP_STATE_COLLECTIONS, WA_APP_STATE_COLLECTION_STATES, WA_APP_STATE_ERROR_CODES, WA_APP_STATE_KDF_INFO, WA_APP_STATE_KEY_TYPES, WA_APP_STATE_SYNC_DATA_TYPE } from './appstate';
 export { getWaMediaHkdfInfo, WA_MEDIA_HKDF_INFO, WA_PREVIEW_MEDIA_HKDF_INFO } from './media';

package/dist/protocol/constants.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.WA_PRIVACY_TOKEN_NOTIFICATION_TYPE = exports.WA_PRESENCE_TYPES = exports.WA_PRESENCE_LAST_SENTINELS = exports.WA_CHATSTATE_MEDIA = exports.WA_BUSINESS_HOURS_MODES = exports.WA_BUSINESS_HOURS_DAYS = exports.WA_REGISTRATION_NOTIFICATION_TAGS = exports.WA_NOTIFICATION_TYPES = exports.WA_NEWSLETTER_NOTIFICATION_TAGS = exports.WA_GROUP_NOTIFICATION_TAGS = exports.WA_BUSINESS_NOTIFICATION_TAGS = exports.WA_SUPPORTED_DIRTY_TYPES = exports.WA_DIRTY_TYPES = exports.WA_DIRTY_PROTOCOLS = exports.WA_ACCOUNT_SYNC_PROTOCOLS = exports.WA_PREVIEW_MEDIA_HKDF_INFO = exports.WA_MEDIA_HKDF_INFO = exports.getWaMediaHkdfInfo = exports.WA_APP_STATE_SYNC_DATA_TYPE = exports.WA_APP_STATE_KEY_TYPES = exports.WA_APP_STATE_KDF_INFO = exports.WA_APP_STATE_ERROR_CODES = exports.WA_APP_STATE_COLLECTION_STATES = exports.WA_APP_STATE_COLLECTIONS = exports.WA_STANZA_MSG_TYPES = exports.WA_RETRYABLE_ACK_CODES = exports.WA_POLL_META_TYPES = exports.WA_MESSAGE_TYPES = exports.WA_MESSAGE_TAGS = exports.WA_EVENT_META_TYPES = exports.WA_ENC_MEDIA_TYPES = exports.WA_EDIT_ATTRS = exports.WA_CALL_RECEIPT_PAYLOAD_TAGS = exports.WA_CALL_PAYLOAD_TAGS = exports.WA_CALL_NODE_ATTRS = exports.WA_CALL_CHILD_TAGS = exports.WA_XMLNS = exports.WA_NODE_TAGS = exports.WA_IQ_TYPES = exports.WA_STREAM_SIGNALING = exports.WA_READY_STATES = exports.WA_LOGOUT_REASONS = exports.WA_FAILURE_REASONS = exports.WA_DISCONNECT_REASONS = exports.WA_CONNECTION_REASONS = exports.WA_PAIRING_KDF_INFO = exports.WA_SIGNALING = exports.WA_COMPANION_PLATFORM_IDS = exports.WA_BROWSERS = exports.getWaCompanionPlatformId = void 0;
-exports.WA_NEWSLETTER_VIEW_ROLES = exports.WA_NEWSLETTER_VERIFICATION_STATES = exports.WA_NEWSLETTER_STATE_TYPES = exports.WA_NEWSLETTER_SEND_TYPES = exports.WA_NEWSLETTER_ROLES = exports.WA_NEWSLETTER_RECEIVE_TYPES = exports.WA_NEWSLETTER_PICTURE_TYPES = exports.WA_NEWSLETTER_MUTE_VALUES = exports.WA_NEWSLETTER_MUTE_TYPES = exports.WA_NEWSLETTER_FETCH_KEY_TYPES = exports.WA_USYNC_MODES = exports.WA_USYNC_DEFAULTS = exports.WA_USYNC_CONTEXTS = exports.WA_GROUP_PARTICIPANT_TYPES = exports.WA_ABPROPS_REFRESH_BOUNDS = exports.WA_ABPROPS_PROTOCOL_VERSION = exports.resolveAbPropNameByCode = exports.AB_PROP_CONFIGS = exports.WA_EMAIL_XMLNS = exports.WA_EMAIL_TAGS = exports.WA_EMAIL_LIMITS = exports.WA_EMAIL_ERROR_CODES = exports.WA_EMAIL_CONTEXTS = exports.WA_STATUS_DISTRIBUTION_SETTINGS = exports.WA_META_NODE_ATTRS_BOT = exports.WA_BOT_NODE_ATTRS = exports.WA_BOT_MSG_SECRET_BYTES = exports.WA_BOT_MSG_EDIT_TYPES = exports.WA_BOT_MSG_BODY_TYPES = exports.WA_BOT_KNOWN_JIDS = exports.WA_BOT_HKDF_INFO = exports.WA_BOT_DEFAULT_CAPABILITIES = exports.WA_BIZ_BOT_TYPES = exports.WA_DEFAULTS = exports.WA_PRIVACY_VALUES = exports.WA_PRIVACY_TAGS = exports.WA_PRIVACY_SETTING_TO_CATEGORY = exports.WA_PRIVACY_DISALLOWED_LIST_CATEGORIES = exports.WA_PRIVACY_CATEGORY_TO_SETTING = exports.WA_PRIVACY_CATEGORIES = exports.WA_TC_TOKEN_DEFAULTS = exports.WA_PRIVACY_TOKEN_TYPES = exports.WA_PRIVACY_TOKEN_TAGS = void 0;
+exports.WA_PRESENCE_TYPES = exports.WA_PRESENCE_LAST_SENTINELS = exports.WA_CHATSTATE_MEDIA = exports.WA_BUSINESS_HOURS_MODES = exports.WA_BUSINESS_HOURS_DAYS = exports.WA_REGISTRATION_NOTIFICATION_TAGS = exports.WA_NOTIFICATION_TYPES = exports.WA_NEWSLETTER_NOTIFICATION_TAGS = exports.WA_GROUP_NOTIFICATION_TAGS = exports.WA_BUSINESS_NOTIFICATION_TAGS = exports.WA_SUPPORTED_DIRTY_TYPES = exports.WA_DIRTY_TYPES = exports.WA_DIRTY_PROTOCOLS = exports.WA_ACCOUNT_SYNC_PROTOCOLS = exports.WA_PREVIEW_MEDIA_HKDF_INFO = exports.WA_MEDIA_HKDF_INFO = exports.getWaMediaHkdfInfo = exports.WA_APP_STATE_SYNC_DATA_TYPE = exports.WA_APP_STATE_KEY_TYPES = exports.WA_APP_STATE_KDF_INFO = exports.WA_APP_STATE_ERROR_CODES = exports.WA_APP_STATE_COLLECTION_STATES = exports.WA_APP_STATE_COLLECTIONS = exports.WA_STANZA_MSG_TYPES = exports.WA_RETRYABLE_ACK_CODES = exports.WA_POLL_META_TYPES = exports.WA_NACK_REASONS = exports.WA_MESSAGE_TYPES = exports.WA_MESSAGE_TAGS = exports.WA_EVENT_META_TYPES = exports.WA_ENC_MEDIA_TYPES = exports.WA_EDIT_ATTRS = exports.WA_CALL_RECEIPT_PAYLOAD_TAGS = exports.WA_CALL_PAYLOAD_TAGS = exports.WA_CALL_NODE_ATTRS = exports.WA_CALL_CHILD_TAGS = exports.WA_XMLNS = exports.WA_NODE_TAGS = exports.WA_IQ_TYPES = exports.WA_STREAM_SIGNALING = exports.WA_READY_STATES = exports.WA_LOGOUT_REASONS = exports.WA_FAILURE_REASONS = exports.WA_DISCONNECT_REASONS = exports.WA_CONNECTION_REASONS = exports.WA_PAIRING_KDF_INFO = exports.WA_SIGNALING = exports.WA_COMPANION_PLATFORM_IDS = exports.WA_BROWSERS = exports.getWaCompanionPlatformId = void 0;
+exports.WA_NEWSLETTER_VIEW_ROLES = exports.WA_NEWSLETTER_VERIFICATION_STATES = exports.WA_NEWSLETTER_STATE_TYPES = exports.WA_NEWSLETTER_SEND_TYPES = exports.WA_NEWSLETTER_ROLES = exports.WA_NEWSLETTER_RECEIVE_TYPES = exports.WA_NEWSLETTER_PICTURE_TYPES = exports.WA_NEWSLETTER_MUTE_VALUES = exports.WA_NEWSLETTER_MUTE_TYPES = exports.WA_NEWSLETTER_FETCH_KEY_TYPES = exports.WA_USYNC_MODES = exports.WA_USYNC_DEFAULTS = exports.WA_USYNC_CONTEXTS = exports.WA_GROUP_PARTICIPANT_TYPES = exports.WA_ABPROPS_REFRESH_BOUNDS = exports.WA_ABPROPS_PROTOCOL_VERSION = exports.resolveAbPropNameByCode = exports.AB_PROP_CONFIGS = exports.WA_EMAIL_XMLNS = exports.WA_EMAIL_TAGS = exports.WA_EMAIL_LIMITS = exports.WA_EMAIL_ERROR_CODES = exports.WA_EMAIL_CONTEXTS = exports.WA_STATUS_DISTRIBUTION_SETTINGS = exports.WA_META_NODE_ATTRS_BOT = exports.WA_BOT_NODE_ATTRS = exports.WA_BOT_MSG_SECRET_BYTES = exports.WA_BOT_MSG_EDIT_TYPES = exports.WA_BOT_MSG_BODY_TYPES = exports.WA_BOT_KNOWN_JIDS = exports.WA_BOT_HKDF_INFO = exports.WA_BOT_DEFAULT_CAPABILITIES = exports.WA_BIZ_BOT_TYPES = exports.WA_DEFAULTS = exports.WA_PRIVACY_VALUES = exports.WA_PRIVACY_TAGS = exports.WA_PRIVACY_SETTING_TO_CATEGORY = exports.WA_PRIVACY_DISALLOWED_LIST_CATEGORIES = exports.WA_PRIVACY_CATEGORY_TO_SETTING = exports.WA_PRIVACY_CATEGORIES = exports.WA_TC_TOKEN_DEFAULTS = exports.WA_PRIVACY_TOKEN_TYPES = exports.WA_PRIVACY_TOKEN_TAGS = exports.WA_PRIVACY_TOKEN_NOTIFICATION_TYPE = void 0;
 var browser_1 = require("./browser");
 Object.defineProperty(exports, "getWaCompanionPlatformId", { enumerable: true, get: function () { return browser_1.getWaCompanionPlatformId; } });
 Object.defineProperty(exports, "WA_BROWSERS", { enumerable: true, get: function () { return browser_1.WA_BROWSERS; } });
@@ -31,6 +31,7 @@ Object.defineProperty(exports, "WA_ENC_MEDIA_TYPES", { enumerable: true, get: fu
 Object.defineProperty(exports, "WA_EVENT_META_TYPES", { enumerable: true, get: function () { return message_1.WA_EVENT_META_TYPES; } });
 Object.defineProperty(exports, "WA_MESSAGE_TAGS", { enumerable: true, get: function () { return message_1.WA_MESSAGE_TAGS; } });
 Object.defineProperty(exports, "WA_MESSAGE_TYPES", { enumerable: true, get: function () { return message_1.WA_MESSAGE_TYPES; } });
+Object.defineProperty(exports, "WA_NACK_REASONS", { enumerable: true, get: function () { return message_1.WA_NACK_REASONS; } });
 Object.defineProperty(exports, "WA_POLL_META_TYPES", { enumerable: true, get: function () { return message_1.WA_POLL_META_TYPES; } });
 Object.defineProperty(exports, "WA_RETRYABLE_ACK_CODES", { enumerable: true, get: function () { return message_1.WA_RETRYABLE_ACK_CODES; } });
 Object.defineProperty(exports, "WA_STANZA_MSG_TYPES", { enumerable: true, get: function () { return message_1.WA_STANZA_MSG_TYPES; } });

package/dist/protocol/message.d.ts

@@ -28,6 +28,28 @@ export declare const WA_MESSAGE_TYPES: Readonly<{
 }>;
 export type WaOutboundReceiptType = typeof WA_MESSAGE_TYPES.RECEIPT_TYPE_READ | typeof WA_MESSAGE_TYPES.RECEIPT_TYPE_READ_SELF | typeof WA_MESSAGE_TYPES.RECEIPT_TYPE_PLAYED | typeof WA_MESSAGE_TYPES.RECEIPT_TYPE_PLAYED_SELF | typeof WA_MESSAGE_TYPES.RECEIPT_TYPE_INACTIVE | typeof WA_MESSAGE_TYPES.RECEIPT_TYPE_HISTORY_SYNC;
 export declare const WA_RETRYABLE_ACK_CODES: readonly ["408", "429", "500", "503"];
+/**
+ * Stanza-ack `error` attr codes (nack reasons): sent when nacking a stanza
+ * that could not be handled, and matched against the `error` carried by an
+ * inbound publish ack (e.g. stale group addressing mode).
+ */
+export declare const WA_NACK_REASONS: Readonly<{
+    readonly STALE_GROUP_ADDRESSING_MODE: 421;
+    readonly NEW_CHAT_MESSAGES_CAPPED: 475;
+    readonly PARSING_ERROR: 487;
+    readonly UNRECOGNIZED_STANZA: 488;
+    readonly UNRECOGNIZED_STANZA_CLASS: 489;
+    readonly UNRECOGNIZED_STANZA_TYPE: 490;
+    readonly INVALID_PROTOBUF: 491;
+    readonly INVALID_HOSTED_COMPANION_STANZA: 493;
+    readonly MISSING_MESSAGE_SECRET: 495;
+    readonly SIGNAL_ERROR_OLD_COUNTER: 496;
+    readonly MESSAGE_DELETED_ON_PEER: 499;
+    readonly UNHANDLED_ERROR: 500;
+    readonly UNSUPPORTED_ADMIN_REVOKE: 550;
+    readonly UNSUPPORTED_LID_GROUP: 551;
+    readonly DB_OPERATION_FAILED: 552;
+}>;
 export declare const WA_STANZA_MSG_TYPES: Readonly<{
     readonly TEXT: "text";
     readonly MEDIA: "media";

package/dist/protocol/message.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.WA_ENC_MEDIA_TYPES = exports.WA_EVENT_META_TYPES = exports.WA_POLL_META_TYPES = exports.WA_EDIT_ATTRS = exports.WA_STANZA_MSG_TYPES = exports.WA_RETRYABLE_ACK_CODES = exports.WA_MESSAGE_TYPES = exports.WA_MESSAGE_TAGS = void 0;
+exports.WA_ENC_MEDIA_TYPES = exports.WA_EVENT_META_TYPES = exports.WA_POLL_META_TYPES = exports.WA_EDIT_ATTRS = exports.WA_STANZA_MSG_TYPES = exports.WA_NACK_REASONS = exports.WA_RETRYABLE_ACK_CODES = exports.WA_MESSAGE_TYPES = exports.WA_MESSAGE_TAGS = void 0;
 exports.WA_MESSAGE_TAGS = Object.freeze({
     MESSAGE: 'message',
     ENC: 'enc',
@@ -30,6 +30,28 @@ exports.WA_MESSAGE_TYPES = Object.freeze({
     RECEIPT_TYPE_VIEW: 'view'
 });
 exports.WA_RETRYABLE_ACK_CODES = Object.freeze(['408', '429', '500', '503']);
+/**
+ * Stanza-ack `error` attr codes (nack reasons): sent when nacking a stanza
+ * that could not be handled, and matched against the `error` carried by an
+ * inbound publish ack (e.g. stale group addressing mode).
+ */
+exports.WA_NACK_REASONS = Object.freeze({
+    STALE_GROUP_ADDRESSING_MODE: 421,
+    NEW_CHAT_MESSAGES_CAPPED: 475,
+    PARSING_ERROR: 487,
+    UNRECOGNIZED_STANZA: 488,
+    UNRECOGNIZED_STANZA_CLASS: 489,
+    UNRECOGNIZED_STANZA_TYPE: 490,
+    INVALID_PROTOBUF: 491,
+    INVALID_HOSTED_COMPANION_STANZA: 493,
+    MISSING_MESSAGE_SECRET: 495,
+    SIGNAL_ERROR_OLD_COUNTER: 496,
+    MESSAGE_DELETED_ON_PEER: 499,
+    UNHANDLED_ERROR: 500,
+    UNSUPPORTED_ADMIN_REVOKE: 550,
+    UNSUPPORTED_LID_GROUP: 551,
+    DB_OPERATION_FAILED: 552
+});
 exports.WA_STANZA_MSG_TYPES = Object.freeze({
     TEXT: 'text',
     MEDIA: 'media',

package/dist/retry/replay.d.ts

@@ -5,6 +5,7 @@ import type { WaMessageClient } from '../message/WaMessageClient';
 import type { WaRetryOutboundMessageRecord } from './types';
 import type { SignalSessionResolver } from '../signal/session/resolver';
 import type { SignalProtocol } from '../signal/session/SignalProtocol';
+import type { BinaryNode } from '../transport/types';
 export interface WaRetryReplayServiceOptions {
     readonly logger: Logger;
     readonly messageClient: WaMessageClient;
@@ -12,6 +13,12 @@ export interface WaRetryReplayServiceOptions {
     readonly sessionResolver: SignalSessionResolver;
     readonly getCurrentCredentials: () => WaAuthCredentials | null;
     readonly resolveUserIcdc?: (userJid: string) => Promise<IcdcMeta | null>;
+    /**
+     * Resolves the trusted-contact (privacy) token node for a recipient user
+     * jid. A resend without it is nacked with error 463 by privacy-gated
+     * recipients.
+     */
+    readonly resolvePrivacyTokenNode?: (recipientJid: string) => Promise<BinaryNode | null>;
 }
 export type WaRetryResendResult = 'resent' | 'ineligible';
 /**
@@ -30,6 +37,11 @@ export declare class WaRetryReplayService {
     resendOutboundMessage(outbound: WaRetryOutboundMessageRecord, requesterJid: string, retryCount: number): Promise<WaRetryResendResult>;
     private resendPlaintextPayload;
     private resolveSignedDeviceIdentity;
+    /**
+     * Resolves the trusted-contact token node for the requester's user jid. A
+     * failure (or absent resolver) yields no node and the resend still goes out.
+     */
+    private resolvePrivacyToken;
     private refreshRetryPlaintext;
     private safeUserJid;
     private resendGroupPlaintextPayload;

package/dist/retry/replay.js

@@ -69,6 +69,9 @@ class WaRetryReplayService {
         const metaNode = (0, jid_1.isHostedDeviceJid)(requesterJid)
             ? (0, message_1.buildMetaNode)({ sender_intent: 'hosted' })
             : undefined;
+        const privacyTokenNode = requesterIsSelf
+            ? undefined
+            : await this.resolvePrivacyToken(requesterJid);
         await this.options.messageClient.sendEncrypted({
             to: requesterJid,
             encType: encrypted.type,
@@ -77,7 +80,8 @@ class WaRetryReplayService {
             id: outbound.messageId,
             type: payload.type,
             deviceIdentity,
-            metaNode
+            metaNode,
+            privacyTokenNode
         });
         return 'resent';
     }
@@ -91,6 +95,32 @@ class WaRetryReplayService {
         }
         return _proto_1.proto.ADVSignedDeviceIdentity.encode(signedIdentity).finish();
     }
+    /**
+     * Resolves the trusted-contact token node for the requester's user jid. A
+     * failure (or absent resolver) yields no node and the resend still goes out.
+     */
+    async resolvePrivacyToken(requesterJid) {
+        if (!this.options.resolvePrivacyTokenNode) {
+            return undefined;
+        }
+        let recipientUserJid;
+        try {
+            recipientUserJid = (0, jid_1.toUserJid)(requesterJid);
+        }
+        catch {
+            return undefined;
+        }
+        try {
+            return (await this.options.resolvePrivacyTokenNode(recipientUserJid)) ?? undefined;
+        }
+        catch (error) {
+            this.options.logger.warn('retry resend privacy token resolution failed', {
+                to: recipientUserJid,
+                message: (0, primitives_1.toError)(error).message
+            });
+            return undefined;
+        }
+    }
     async refreshRetryPlaintext(payload, options) {
         if (!options.wrapAsDeviceSent && !this.options.resolveUserIcdc) {
             return null;
@@ -202,6 +232,9 @@ class WaRetryReplayService {
         const metaNode = (0, jid_1.isHostedDeviceJid)(requesterJid)
             ? (0, message_1.buildMetaNode)({ sender_intent: 'hosted' })
             : undefined;
+        const privacyTokenNode = this.isRequesterCurrentAccount(requesterJid)
+            ? undefined
+            : await this.resolvePrivacyToken(requesterJid);
         await this.options.messageClient.sendEncrypted({
             to: requesterJid,
             encType: payload.encType,
@@ -211,7 +244,8 @@ class WaRetryReplayService {
             type: payload.type,
             participant: payload.participant,
             deviceIdentity,
-            metaNode
+            metaNode,
+            privacyTokenNode
         });
         return 'resent';
     }

package/dist/signal/session/SignalRatchet.js

@@ -163,9 +163,9 @@ async function decryptMsg(session, parsed, onPrevSessionDecryptError) {
     }
     catch (error) {
         for (let i = 0; i < session.prevSessions.length; i += 1) {
-            const decodedPrev = (0, encoding_1.decodeSignalSessionSnapshot)(session.prevSessions[i], `prevSessions[${i}]`);
-            const prevSession = (0, SignalSession_1.snapshotToRecord)(decodedPrev);
             try {
+                const decodedPrev = (0, encoding_1.decodeSignalSessionSnapshot)(session.prevSessions[i], `prevSessions[${i}]`);
+                const prevSession = (0, SignalSession_1.snapshotToRecord)(decodedPrev);
                 const [updatedPrev, plaintext] = await decryptMsgFromSession(prevSession, parsed);
                 const updatedSession = {
                     ...updatedPrev,

package/dist/transport/WaComms.js

@@ -172,6 +172,10 @@ class WaComms {
         await this.socket.close(1000, 'stop_comms');
     }
     async closeSocketAndResume() {
+        if (!this.started || this.preventRetry) {
+            this.logger.debug('comms resume skipped: comms stopped or retry disabled');
+            return;
+        }
         this.logger.debug('comms close socket and resume requested');
         this.resetConnectionState({
             started: true,

package/dist/transport/keepalive/WaKeepAlive.js

@@ -104,6 +104,10 @@ class WaKeepAlive {
             }
         }
         catch (error) {
+            if (generation !== this.generation) {
+                this.logger.trace('keepalive stopped during in-flight ping, not resuming');
+                return;
+            }
             this.logger.warn('keepalive ping failed, reconnecting socket', {
                 message: (0, primitives_1.toError)(error).message
             });

package/dist/transport/node/WaNodeOrchestrator.d.ts

@@ -5,7 +5,12 @@ interface WaNodeOrchestratorOptions {
     readonly sendNode: (node: BinaryNode) => Promise<void>;
     readonly defaultTimeoutMs?: number;
     readonly hostDomain?: string;
-    readonly mobileIqIdFormat?: boolean;
+    /**
+     * Resolved lazily on first id-generator creation (post-connect, after
+     * credentials load) so a registered mobile session reconnecting without an
+     * explicit `mobileTransport` option still picks the mobile id format.
+     */
+    readonly mobileIqIdFormat?: () => boolean;
 }
 /**
  * Issues outgoing binary nodes and matches incoming responses back to their

package/dist/transport/node/WaNodeOrchestrator.js

@@ -15,7 +15,7 @@ class WaNodeOrchestrator {
         this.sendNodeFn = options.sendNode;
         this.defaultTimeoutMs = options.defaultTimeoutMs ?? constants_1.WA_DEFAULTS.NODE_QUERY_TIMEOUT_MS;
         this.hostDomain = options.hostDomain ?? constants_1.WA_DEFAULTS.HOST_DOMAIN;
-        this.mobileIqIdFormat = options.mobileIqIdFormat === true;
+        this.mobileIqIdFormat = options.mobileIqIdFormat ?? (() => false);
         this.idGenerator = null;
         this.idGeneratorReady = null;
         this.pendingQueries = new Map();
@@ -137,7 +137,7 @@ class WaNodeOrchestrator {
         if (this.idGenerator) {
             return this.idGenerator;
         }
-        if (this.mobileIqIdFormat) {
+        if (this.mobileIqIdFormat()) {
             this.idGenerator = (0, helpers_1.createMobileNodeIdGenerator)();
             this.logger.debug('generated stanza prefix (mobile)', {
                 prefix: this.idGenerator.prefix

package/dist/transport/node/builders/global.d.ts

@@ -15,6 +15,7 @@ export type BuildAckNodeInput = {
     readonly typeOverride?: string;
     readonly participant?: string;
     readonly recipient?: string;
+    readonly error?: number | string;
 } | {
     readonly kind: 'receipt';
     readonly node: BinaryNode;

package/dist/transport/node/builders/global.js

@@ -62,6 +62,9 @@ function buildAckNode(input) {
             to: input.to,
             class: _protocol_1.WA_MESSAGE_TYPES.ACK_CLASS_MESSAGE
         };
+        if (input.error !== undefined) {
+            attrs.error = String(input.error);
+        }
         const type = input.typeOverride ?? input.node.attrs.type;
         if (type) {
             attrs.type = type;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "zapo-js",
-    "version": "1.1.0",
+    "version": "1.1.2",
     "description": "High-performance WhatsApp Web TypeScript library",
     "license": "MIT",
     "author": "vinikjkkj <contact@vinicius.email> (https://github.com/vinikjkkj)",