zapo-js 1.1.3 → 1.2.1

package/dist/appstate/sync/WaAppStateSyncClient.js

@@ -717,7 +717,12 @@ class WaAppStateSyncClient {
         if (keyData !== null) {
             const expectedSnapshotMac = await this.crypto.generateSnapshotMac(keyData, ltHash, version, collection);
             if (!(0, bytes_1.uint8TimingSafeEqual)(expectedSnapshotMac, snapshot.mac)) {
-                throw new Error(`snapshot MAC mismatch for ${collection}`);
+                // Poisoned server-side snapshot (MAC unverifiable by any client):
+                // keep partial state instead of throwing, which would loop refetch forever.
+                this.logger.warn('snapshot LT-hash verification failed, continuing with partial state', {
+                    collection,
+                    version
+                });
             }
         }
         this.setCollectionState(collection, version, ltHash, indexValueMap);

package/dist/client/WaClient.js

@@ -12,7 +12,6 @@ const _proto_1 = require("../proto");
 const constants_1 = require("../protocol/constants");
 const jid_1 = require("../protocol/jid");
 const stream_1 = require("../protocol/stream");
-const noop_store_1 = require("../store/noop.store");
 const device_1 = require("../transport/node/builders/device");
 const query_1 = require("../transport/node/query");
 const wa_web_version_fetcher_1 = require("../transport/wa-web-version-fetcher");
@@ -91,12 +90,6 @@ class WaClient extends node_events_1.EventEmitter {
             threadStore: this.stores.threads,
             contactStore: this.stores.contacts
         }, this.logger, this.options.writeBehind);
-        if (this.options.addons?.autoDecrypt !== false &&
-            this.stores.messageSecret === noop_store_1.NOOP_MESSAGE_SECRET_STORE) {
-            this.logger.warn('addons.autoDecrypt is on (default) but messageSecret cache is noop – ' +
-                'addon decryption will only work if secrets are in the message store. ' +
-                'Set addons.autoDecrypt: false to silence this warning.');
-        }
         const dependencies = (0, WaClientFactory_1.buildWaClientDependencies)({
             base,
             runtime: {
@@ -212,6 +205,7 @@ class WaClient extends node_events_1.EventEmitter {
                 logger: this.logger,
                 writeBehind: this.writeBehind,
                 messageSecretStore: this.stores.messageSecret,
+                persistAllSecrets: this.options.addons?.persistAllSecrets === true,
                 event
             });
             if (this.options.addons?.autoDecrypt !== false && event.message) {

package/dist/client/WaClientFactory.js

@@ -468,6 +468,7 @@ function buildWaClientDependencies(input) {
         deviceListStore: sessionStore.deviceList,
         signalDeviceSync,
         messageSecretStore: sessionStore.messageSecret,
+        persistAllMessageSecrets: options.addons?.persistAllSecrets === true,
         getCurrentCredentials,
         resolvePrivacyTokenNode: (recipientJid) => trustedContactToken.resolveTokenForMessage(recipientJid),
         onDirectMessageSent: (recipientJid) => {
@@ -694,6 +695,7 @@ function buildWaClientDependencies(input) {
                 .catch((err) => runtime.handleError((0, primitives_1.toError)(err)));
         },
         emitNewsletterMessageUpdate: (event) => runtime.emitEvent('newsletter_message_update', event),
+        emitUnavailableMessage: (event) => runtime.emitEvent('message_unavailable', event),
         emitUnhandledStanza: (event) => runtime.emitEvent('debug_unhandled_stanza', event)
     };
     const handleClientDirtyBits = (dirtyBits) => (0, dirty_1.handleDirtyBits)({

package/dist/client/coordinators/WaMessageDispatchCoordinator.d.ts

@@ -45,6 +45,12 @@ interface WaMessageDispatchCoordinatorOptions {
     readonly deviceListStore: WaDeviceListStore;
     readonly signalDeviceSync: SignalDeviceSyncApi;
     readonly messageSecretStore: WaMessageSecretStore;
+    /**
+     * When `true`, persist the message secret for every outgoing message, not
+     * only the poll / event / bot prompts that `needsSecretPersistence` flags.
+     * Wired from the client-level `addons.persistAllSecrets` option.
+     */
+    readonly persistAllMessageSecrets?: boolean;
     readonly getCurrentCredentials: () => WaAuthCredentials | null;
     readonly resolvePrivacyTokenNode: (recipientJid: string) => Promise<BinaryNode | null>;
     readonly onDirectMessageSent: (recipientJid: string) => void;
@@ -79,6 +85,16 @@ export declare class WaMessageDispatchCoordinator {
      * no LID is known/resolvable. Inputs already in LID form pass through.
      */
     private resolveDirectRecipientLid;
+    /**
+     * Resolves the `peer_recipient_pn` cross-reference for a 1:1 send, or
+     * `undefined` to drop the attribute. Only set when the envelope is
+     * LID-addressed (`directRecipientJid` is a LID): the PN is the caller's own
+     * JID when they passed a PN (zapo switched it to LID for sending), else the
+     * device-list snapshot counterpart for a recipient passed in LID form.
+     * Mirrors wa-web, which sets `peer_recipient_pn = getPhoneNumber($)` for a
+     * LID destination.
+     */
+    private resolvePeerRecipientPn;
     syncSignalSession(jid: string, reasonIdentity?: boolean): Promise<void>;
     sendReceipt(input: WaSendReceiptInput): Promise<void>;
     publishProtocolMessageToDevice(deviceJid: string, protocolMessage: Proto.Message.IProtocolMessage, options?: {

package/dist/client/coordinators/WaMessageDispatchCoordinator.js

@@ -217,7 +217,7 @@ class WaMessageDispatchCoordinator {
         if (rawSecret &&
             rawSecret.length > 0 &&
             sendOptions.id &&
-            (0, content_1.needsSecretPersistence)(messageWithSecret)) {
+            (this.deps.persistAllMessageSecrets || (0, content_1.needsSecretPersistence)(messageWithSecret))) {
             const meJid = this.deps.getCurrentCredentials()?.meJid ?? '';
             void this.deps.messageSecretStore
                 .set(sendOptions.id, { secret: rawSecret, senderJid: meJid })
@@ -278,11 +278,14 @@ class WaMessageDispatchCoordinator {
         const directRecipientJid = isGroup
             ? recipientJid
             : await this.resolveDirectRecipientLid((0, jid_1.toUserJid)(recipientJid));
+        const peerRecipientPn = isGroup
+            ? undefined
+            : await this.resolvePeerRecipientPn((0, jid_1.toUserJid)(recipientJid), directRecipientJid);
         const publishResult = isGroup
             ? this.shouldUseGroupDirectPath(messageWithIcdc)
                 ? await this.publishGroupDirectMessage(recipientJid, envelope)
                 : await this.publishGroupSenderKeyMessage(recipientJid, envelope)
-            : await this.publishDirectSignalMessageWithFanout(directRecipientJid, envelope);
+            : await this.publishDirectSignalMessageWithFanout(directRecipientJid, envelope, peerRecipientPn);
         return upload ? { ...publishResult, upload } : publishResult;
     }
     /**
@@ -317,6 +320,35 @@ class WaMessageDispatchCoordinator {
         }
         return pnUserJid;
     }
+    /**
+     * Resolves the `peer_recipient_pn` cross-reference for a 1:1 send, or
+     * `undefined` to drop the attribute. Only set when the envelope is
+     * LID-addressed (`directRecipientJid` is a LID): the PN is the caller's own
+     * JID when they passed a PN (zapo switched it to LID for sending), else the
+     * device-list snapshot counterpart for a recipient passed in LID form.
+     * Mirrors wa-web, which sets `peer_recipient_pn = getPhoneNumber($)` for a
+     * LID destination.
+     */
+    async resolvePeerRecipientPn(recipientUserJid, directRecipientJid) {
+        if (!(0, jid_1.isLidJid)(directRecipientJid))
+            return undefined;
+        if ((0, jid_1.isUserJid)(recipientUserJid))
+            return recipientUserJid;
+        try {
+            const snapshot = await this.deps.deviceListStore.findByAnyUserJid(directRecipientJid);
+            if (snapshot?.userJid && (0, jid_1.isUserJid)(snapshot.userJid))
+                return snapshot.userJid;
+            if (snapshot?.altUserJid && (0, jid_1.isUserJid)(snapshot.altUserJid))
+                return snapshot.altUserJid;
+        }
+        catch (error) {
+            this.deps.logger.trace('peer_recipient_pn store lookup failed', {
+                lid: directRecipientJid,
+                message: (0, primitives_2.toError)(error).message
+            });
+        }
+        return undefined;
+    }
     async syncSignalSession(jid, reasonIdentity = false) {
         const address = (0, jid_1.parseSignalAddressFromJid)(jid);
         if (address.server === constants_1.WA_DEFAULTS.GROUP_SERVER) {
@@ -997,7 +1029,7 @@ class WaMessageDispatchCoordinator {
             distributionParticipants
         };
     }
-    async publishDirectSignalMessageWithFanout(recipientJid, envelope) {
+    async publishDirectSignalMessageWithFanout(recipientJid, envelope, peerRecipientPn) {
         const { message, plaintext, type, edit, mediatype, sendOptions } = envelope;
         const meJid = this.requireCurrentMeJid('sendMessage');
         const meLid = this.deps.getCurrentCredentials()?.meLid;
@@ -1160,6 +1192,7 @@ class WaMessageDispatchCoordinator {
             customNodes: customNodes.length > 0 ? customNodes : undefined,
             mediatype,
             decryptFail: envelope.decryptFail,
+            peerRecipientPn,
             additionalAttributes: sendOptions.additionalAttributes
         });
         const replayPayload = {

package/dist/client/persistence/mailbox.d.ts

@@ -6,6 +6,12 @@ interface WaPersistIncomingMailboxOptions {
     readonly logger: Logger;
     readonly writeBehind: WriteBehindPersistence;
     readonly messageSecretStore: WaMessageSecretStore;
+    /**
+     * When `true`, persist the secret of every incoming message, not only the
+     * poll / event / bot prompts that `needsSecretPersistence` flags. Wired
+     * from the client-level `addons.persistAllSecrets` option.
+     */
+    readonly persistAllSecrets?: boolean;
     readonly event: WaIncomingMessageEvent;
 }
 export declare function persistIncomingMailboxEntities(options: WaPersistIncomingMailboxOptions): void;

package/dist/client/persistence/mailbox.js

@@ -56,7 +56,7 @@ function persistContacts(writeBehind, event, nowMs) {
     }
 }
 function persistIncomingMailboxEntities(options) {
-    const { logger, writeBehind, messageSecretStore, event } = options;
+    const { logger, writeBehind, messageSecretStore, persistAllSecrets, event } = options;
     const stanzaId = event.key.id;
     const chatJid = event.key.remoteJid;
     if (!stanzaId || !chatJid) {
@@ -81,7 +81,7 @@ function persistIncomingMailboxEntities(options) {
         if (rawSecret &&
             rawSecret.length > 0 &&
             event.message &&
-            (0, content_1.needsSecretPersistence)(event.message)) {
+            (persistAllSecrets || (0, content_1.needsSecretPersistence)(event.message))) {
             const rawSender = event.key.participant ?? event.rawNode.attrs.participant ?? event.key.remoteJid;
             const senderJid = rawSender ? (0, jid_1.toUserJid)(rawSender) : '';
             void messageSecretStore

package/dist/client/types.d.ts

@@ -241,6 +241,26 @@ export interface WaAddonOptions {
      * poll votes, event responses, comments).
      */
     readonly autoDecrypt?: boolean;
+    /**
+     * Persist the 32-byte message secret of every sent and received message,
+     * not just the poll / event / bot-prompt messages the library knows will
+     * get a follow-up. Off by default.
+     *
+     * Encrypted addons whose parent can be any message type - reactions,
+     * comments, and `secretEncryptedMessage` edits - need the parent's secret
+     * to decrypt. Without this, those parents stay decryptable after a restart
+     * only when the full `messages` archive is persistent. Enable this to keep
+     * them decryptable while storing only the secret, not the message body
+     * (e.g. with `messages: 'none'`).
+     *
+     * Has no effect when the `messageSecret` cache is `'none'`: every write
+     * lands in the noop store and is silently discarded. With the default
+     * `'memory'` provider it works for the lifetime of the process but is lost
+     * on restart and bounded by the cache's LRU and `messageSecretMs` TTL;
+     * point `messageSecret` at a persistent backend to keep the secrets across
+     * restarts.
+     */
+    readonly persistAllSecrets?: boolean;
 }
 export interface WaPrivacyTokenOptions {
     readonly tcTokenDurationS?: number;
@@ -721,6 +741,27 @@ export interface WaIncomingUnhandledStanzaEvent extends WaIncomingBaseEvent {
     /** Short reason describing why the dispatcher did not match a typed handler. */
     readonly reason: string;
 }
+/**
+ * Why an incoming message arrived as a content-less placeholder. `view_once`:
+ * a view-once already consumed elsewhere. `hosted`: a hosted/bot message that
+ * could not be fanned out. `other`: an `unavailable` marker the lib does not
+ * categorize yet.
+ */
+export type WaUnavailableMessageKind = 'view_once' | 'hosted' | 'other';
+export interface WaIncomingUnavailableMessageEvent extends Omit<WaIncomingBaseEvent, 'chatJid' | 'stanzaId'> {
+    /** Which flavour of content the server signalled as unavailable. */
+    readonly kind: WaUnavailableMessageKind;
+    /**
+     * The message key (chat, stanza id, author, addressing metadata) – same
+     * shape the `message` event carries, so it can be stored or correlated. There
+     * is no decrypted `message`: the payload is unavailable and cannot be fetched.
+     */
+    readonly key: WaIncomingMessageKey;
+    /** Stanza `t` attr (seconds since epoch). */
+    readonly timestampSeconds?: number;
+    /** Sender's display name from the stanza's `notify` attr. */
+    readonly pushName?: string;
+}
 export interface WaIncomingErrorStanzaEvent extends WaIncomingBaseEvent {
     readonly code?: number;
     readonly text?: string;
@@ -1057,6 +1098,14 @@ export interface WaClientEventMap {
      * typed protocol payload directly.
      */
     readonly message_protocol: (event: WaIncomingProtocolMessageEvent) => void;
+    /**
+     * A message the server delivered as a content-less placeholder: the payload
+     * is unavailable and cannot be recovered (a view-once already consumed, or a
+     * hosted/bot message that could not be fanned out). The lib acks it and emits
+     * this instead of a `message` event for the same stanza. Branch on
+     * `event.kind`.
+     */
+    readonly message_unavailable: (event: WaIncomingUnavailableMessageEvent) => void;
     /**
      * Inbound `<receipt>` for an outgoing message – delivery, read, played,
      * server, etc. Use this to track message ACK progression.

package/dist/esm/appstate/sync/WaAppStateSyncClient.js

@@ -714,7 +714,12 @@ export class WaAppStateSyncClient {
         if (keyData !== null) {
             const expectedSnapshotMac = await this.crypto.generateSnapshotMac(keyData, ltHash, version, collection);
             if (!uint8TimingSafeEqual(expectedSnapshotMac, snapshot.mac)) {
-                throw new Error(`snapshot MAC mismatch for ${collection}`);
+                // Poisoned server-side snapshot (MAC unverifiable by any client):
+                // keep partial state instead of throwing, which would loop refetch forever.
+                this.logger.warn('snapshot LT-hash verification failed, continuing with partial state', {
+                    collection,
+                    version
+                });
             }
         }
         this.setCollectionState(collection, version, ltHash, indexValueMap);

package/dist/esm/client/WaClient.js

@@ -9,7 +9,6 @@ import { proto } from '../proto.js';
 import { WA_DEFAULTS, WA_MESSAGE_TYPES } from '../protocol/constants.js';
 import { normalizeDeviceJid } from '../protocol/jid.js';
 import { WA_DISCONNECT_REASONS, WA_LOGOUT_REASONS } from '../protocol/stream.js';
-import { NOOP_MESSAGE_SECRET_STORE } from '../store/noop.store.js';
 import { buildRemoveCompanionDeviceIq } from '../transport/node/builders/device.js';
 import { assertIqResult, queryWithContext as queryNodeWithContext } from '../transport/node/query.js';
 import { fetchLatestWaWebVersion } from '../transport/wa-web-version-fetcher.js';
@@ -88,12 +87,6 @@ export class WaClient extends EventEmitter {
             threadStore: this.stores.threads,
             contactStore: this.stores.contacts
         }, this.logger, this.options.writeBehind);
-        if (this.options.addons?.autoDecrypt !== false &&
-            this.stores.messageSecret === NOOP_MESSAGE_SECRET_STORE) {
-            this.logger.warn('addons.autoDecrypt is on (default) but messageSecret cache is noop – ' +
-                'addon decryption will only work if secrets are in the message store. ' +
-                'Set addons.autoDecrypt: false to silence this warning.');
-        }
         const dependencies = buildWaClientDependencies({
             base,
             runtime: {
@@ -209,6 +202,7 @@ export class WaClient extends EventEmitter {
                 logger: this.logger,
                 writeBehind: this.writeBehind,
                 messageSecretStore: this.stores.messageSecret,
+                persistAllSecrets: this.options.addons?.persistAllSecrets === true,
                 event
             });
             if (this.options.addons?.autoDecrypt !== false && event.message) {

package/dist/esm/client/WaClientFactory.js

@@ -464,6 +464,7 @@ export function buildWaClientDependencies(input) {
         deviceListStore: sessionStore.deviceList,
         signalDeviceSync,
         messageSecretStore: sessionStore.messageSecret,
+        persistAllMessageSecrets: options.addons?.persistAllSecrets === true,
         getCurrentCredentials,
         resolvePrivacyTokenNode: (recipientJid) => trustedContactToken.resolveTokenForMessage(recipientJid),
         onDirectMessageSent: (recipientJid) => {
@@ -690,6 +691,7 @@ export function buildWaClientDependencies(input) {
                 .catch((err) => runtime.handleError(toError(err)));
         },
         emitNewsletterMessageUpdate: (event) => runtime.emitEvent('newsletter_message_update', event),
+        emitUnavailableMessage: (event) => runtime.emitEvent('message_unavailable', event),
         emitUnhandledStanza: (event) => runtime.emitEvent('debug_unhandled_stanza', event)
     };
     const handleClientDirtyBits = (dirtyBits) => handleDirtyBits({

package/dist/esm/client/coordinators/WaMessageDispatchCoordinator.js

@@ -12,7 +12,7 @@ import { writeRandomPadMax16 } from '../../message/encode/padding.js';
 import { buildBotInvokeProtoCopy, extractInvokedBotJid, genBotMsgSecret } from '../../message/kinds/bot.js';
 import { proto } from '../../proto.js';
 import { WA_DEFAULTS, WA_NACK_REASONS } from '../../protocol/constants.js';
-import { canonicalizeOwnAccountJid, isBotJid, isGroupJid, isHostedDeviceJid, isLidJid, isNewsletterJid, normalizeDeviceJid, normalizeRecipientJid, parseJidFull, parseSignalAddressFromJid, signalAddressKey, toUserJid } from '../../protocol/jid.js';
+import { canonicalizeOwnAccountJid, isBotJid, isGroupJid, isHostedDeviceJid, isLidJid, isNewsletterJid, isUserJid, normalizeDeviceJid, normalizeRecipientJid, parseJidFull, parseSignalAddressFromJid, signalAddressKey, toUserJid } from '../../protocol/jid.js';
 import { encodeBinaryNode } from '../../transport/binary/index.js';
 import { buildButtonAddonNode, buildDirectMessageFanoutNode, buildGroupSenderKeyMessageNode, buildMetaNode } from '../../transport/node/builders/message.js';
 import { bytesToHex, TEXT_ENCODER } from '../../util/bytes.js';
@@ -214,7 +214,7 @@ export class WaMessageDispatchCoordinator {
         if (rawSecret &&
             rawSecret.length > 0 &&
             sendOptions.id &&
-            needsSecretPersistence(messageWithSecret)) {
+            (this.deps.persistAllMessageSecrets || needsSecretPersistence(messageWithSecret))) {
             const meJid = this.deps.getCurrentCredentials()?.meJid ?? '';
             void this.deps.messageSecretStore
                 .set(sendOptions.id, { secret: rawSecret, senderJid: meJid })
@@ -275,11 +275,14 @@ export class WaMessageDispatchCoordinator {
         const directRecipientJid = isGroup
             ? recipientJid
             : await this.resolveDirectRecipientLid(toUserJid(recipientJid));
+        const peerRecipientPn = isGroup
+            ? undefined
+            : await this.resolvePeerRecipientPn(toUserJid(recipientJid), directRecipientJid);
         const publishResult = isGroup
             ? this.shouldUseGroupDirectPath(messageWithIcdc)
                 ? await this.publishGroupDirectMessage(recipientJid, envelope)
                 : await this.publishGroupSenderKeyMessage(recipientJid, envelope)
-            : await this.publishDirectSignalMessageWithFanout(directRecipientJid, envelope);
+            : await this.publishDirectSignalMessageWithFanout(directRecipientJid, envelope, peerRecipientPn);
         return upload ? { ...publishResult, upload } : publishResult;
     }
     /**
@@ -314,6 +317,35 @@ export class WaMessageDispatchCoordinator {
         }
         return pnUserJid;
     }
+    /**
+     * Resolves the `peer_recipient_pn` cross-reference for a 1:1 send, or
+     * `undefined` to drop the attribute. Only set when the envelope is
+     * LID-addressed (`directRecipientJid` is a LID): the PN is the caller's own
+     * JID when they passed a PN (zapo switched it to LID for sending), else the
+     * device-list snapshot counterpart for a recipient passed in LID form.
+     * Mirrors wa-web, which sets `peer_recipient_pn = getPhoneNumber($)` for a
+     * LID destination.
+     */
+    async resolvePeerRecipientPn(recipientUserJid, directRecipientJid) {
+        if (!isLidJid(directRecipientJid))
+            return undefined;
+        if (isUserJid(recipientUserJid))
+            return recipientUserJid;
+        try {
+            const snapshot = await this.deps.deviceListStore.findByAnyUserJid(directRecipientJid);
+            if (snapshot?.userJid && isUserJid(snapshot.userJid))
+                return snapshot.userJid;
+            if (snapshot?.altUserJid && isUserJid(snapshot.altUserJid))
+                return snapshot.altUserJid;
+        }
+        catch (error) {
+            this.deps.logger.trace('peer_recipient_pn store lookup failed', {
+                lid: directRecipientJid,
+                message: toError(error).message
+            });
+        }
+        return undefined;
+    }
     async syncSignalSession(jid, reasonIdentity = false) {
         const address = parseSignalAddressFromJid(jid);
         if (address.server === WA_DEFAULTS.GROUP_SERVER) {
@@ -994,7 +1026,7 @@ export class WaMessageDispatchCoordinator {
             distributionParticipants
         };
     }
-    async publishDirectSignalMessageWithFanout(recipientJid, envelope) {
+    async publishDirectSignalMessageWithFanout(recipientJid, envelope, peerRecipientPn) {
         const { message, plaintext, type, edit, mediatype, sendOptions } = envelope;
         const meJid = this.requireCurrentMeJid('sendMessage');
         const meLid = this.deps.getCurrentCredentials()?.meLid;
@@ -1157,6 +1189,7 @@ export class WaMessageDispatchCoordinator {
             customNodes: customNodes.length > 0 ? customNodes : undefined,
             mediatype,
             decryptFail: envelope.decryptFail,
+            peerRecipientPn,
             additionalAttributes: sendOptions.additionalAttributes
         });
         const replayPayload = {

package/dist/esm/client/persistence/mailbox.js

@@ -53,7 +53,7 @@ function persistContacts(writeBehind, event, nowMs) {
     }
 }
 export function persistIncomingMailboxEntities(options) {
-    const { logger, writeBehind, messageSecretStore, event } = options;
+    const { logger, writeBehind, messageSecretStore, persistAllSecrets, event } = options;
     const stanzaId = event.key.id;
     const chatJid = event.key.remoteJid;
     if (!stanzaId || !chatJid) {
@@ -78,7 +78,7 @@ export function persistIncomingMailboxEntities(options) {
         if (rawSecret &&
             rawSecret.length > 0 &&
             event.message &&
-            needsSecretPersistence(event.message)) {
+            (persistAllSecrets || needsSecretPersistence(event.message))) {
             const rawSender = event.key.participant ?? event.rawNode.attrs.participant ?? event.key.remoteJid;
             const senderJid = rawSender ? toUserJid(rawSender) : '';
             void messageSecretStore

package/dist/esm/message/primitives/incoming.js

@@ -496,6 +496,42 @@ export async function handleIncomingMessageAck(node, options) {
         await options.sendNode(ackNode);
         return true;
     }
+    const unavailableNode = findNodeChild(node, 'unavailable');
+    if (unavailableNode) {
+        const kind = unavailableNode.attrs.hosted === 'true'
+            ? 'hosted'
+            : unavailableNode.attrs.type === 'view_once'
+                ? 'view_once'
+                : 'other';
+        const senderJid = node.attrs.participant ?? node.attrs.from;
+        const sender = senderJid ? parseJidFull(senderJid) : null;
+        const { key, pushName } = buildIncomingMessageKey(node, sender ? { userJid: sender.userJid, device: sender.address.device } : null, options);
+        options.emitUnavailableMessage?.({
+            rawNode: buildIncomingEventRawNode(node),
+            key,
+            kind,
+            stanzaType: node.attrs.type,
+            offline: node.attrs.offline !== undefined,
+            timestampSeconds: parseOptionalInt(node.attrs.t),
+            pushName
+        });
+        const ackNode = buildAckNode({
+            kind: 'message',
+            node,
+            id,
+            to: from,
+            from: options.getMeJid?.()
+        });
+        options.logger.trace('acking unavailable incoming message', {
+            id,
+            to: from,
+            type: ackNode.attrs.type,
+            participant: ackNode.attrs.participant,
+            unavailableKind: kind
+        });
+        await options.sendNode(ackNode);
+        return true;
+    }
     if (!shouldSendStandardReceipt) {
         return true;
     }

package/dist/esm/transport/node/builders/message.js

@@ -32,6 +32,9 @@ function buildMessageAttrs(input) {
     if (input.addressingMode) {
         attrs.addressing_mode = input.addressingMode;
     }
+    if (input.peerRecipientPn) {
+        attrs.peer_recipient_pn = input.peerRecipientPn;
+    }
     if (input.additionalAttributes) {
         Object.assign(attrs, input.additionalAttributes);
     }

package/dist/esm/util/index.js

@@ -1,4 +1,4 @@
-export { base64ToBytes, bytesToBase64, bytesToBase64UrlSafe, bytesToHex, decodeBase64Url, hexToBytes, TEXT_DECODER, toBytesView, uint8Equal } from './bytes.js';
+export { base64ToBytes, bytesToBase64, bytesToBase64UrlSafe, bytesToHex, decodeBase64Url, hexToBytes, TEXT_DECODER, toBytesView, uint8Equal, uint8TimingSafeEqual } from './bytes.js';
 export { asBytes, asNumber, asOptionalBytes, asOptionalNumber, asOptionalString, asString, resolvePositive, toBoolOrUndef } from './coercion.js';
 export { normalizeQueryLimit } from './collections.js';
 export { toError, toSafeNumber } from './primitives.js';

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 export { WaClient } from './client';
 export type { WaClientEventMap, WaClientOptions, WaClientProxyOptions, WaDownloadMediaOptions, WaHistorySyncChunkEvent, WaHistorySyncOptions, WaWriteBehindOptions } from './client/types';
 export type { WaMessageCoordinator } from './client/coordinators/WaMessageCoordinator';
-export type { WaAccountTakeoverNoticeEvent, WaAppStateMutationEvent, WaAppStateMutationSource, WaBusinessEvent, WaBusinessEventAction, WaBusinessProfileResult, WaConnectionEvent, WaGroupEvent, WaGroupEventAction, WaGroupEventLinkedGroup, WaGroupEventMembershipRequest, WaGroupEventParticipant, WaGroupEventSubgroupSuggestion, WaIgnoreKey, WaIgnoreKeyContext, WaIgnoreKeyPredicate, WaIgnoreStanzaKind, WaIncomingAddonEvent, WaIncomingBaseEvent, WaIncomingBotChunkEvent, WaIncomingCallEvent, WaIncomingChatstateEvent, WaIncomingErrorStanzaEvent, WaIncomingFailureEvent, WaIncomingMessageEvent, WaIncomingMessageKey, WaIncomingNewsletterEvent, WaIncomingNewsletterMessageUpdateEvent, WaIncomingNodeHandler, WaIncomingNodeHandlerRegistration, WaIncomingNotificationEvent, WaIncomingPresenceEvent, WaIncomingProtocolMessageEvent, WaIncomingReceiptEvent, WaIncomingStanzaFilter, WaIncomingUnhandledStanzaEvent, WaMexLidChangeEvent, WaMexMessageCappingEvent, WaMexMessageCappingStatus, WaMexNotificationEvent, WaMexNotificationGraphQlError, WaMexNotificationOperationName, WaMexNotificationUnknownEvent, WaMexOwnUsernameSyncEvent, WaMexTextStatusUpdateEvent, WaMexTextStatusUpdateHintEvent, WaMexUsernameDeleteEvent, WaMexUsernameSetEvent, WaMexUsernameUpdateHintEvent, WaOfflineResumeEvent, WaPictureEvent, WaPictureEventAction, WaPrivacyTokenUpdateEvent, WaReceiptStatus, WaRegistrationCodeEvent, WaSendMessageOptions, WaVerifiedNameResult, WaAddonKind, WaNewsletterEventAction, WaNewsletterMessageUpdate, WaNewsletterPollVoteEntry, WaNewsletterReactionEntry } from './client/types';
+export type { WaAccountTakeoverNoticeEvent, WaAppStateMutationEvent, WaAppStateMutationSource, WaBusinessEvent, WaBusinessEventAction, WaBusinessProfileResult, WaConnectionEvent, WaGroupEvent, WaGroupEventAction, WaGroupEventLinkedGroup, WaGroupEventMembershipRequest, WaGroupEventParticipant, WaGroupEventSubgroupSuggestion, WaIgnoreKey, WaIgnoreKeyContext, WaIgnoreKeyPredicate, WaIgnoreStanzaKind, WaIncomingAddonEvent, WaIncomingBaseEvent, WaIncomingBotChunkEvent, WaIncomingCallEvent, WaIncomingChatstateEvent, WaIncomingErrorStanzaEvent, WaIncomingFailureEvent, WaIncomingMessageEvent, WaIncomingMessageKey, WaIncomingNewsletterEvent, WaIncomingNewsletterMessageUpdateEvent, WaIncomingNodeHandler, WaIncomingNodeHandlerRegistration, WaIncomingNotificationEvent, WaIncomingPresenceEvent, WaIncomingProtocolMessageEvent, WaIncomingReceiptEvent, WaIncomingStanzaFilter, WaIncomingUnavailableMessageEvent, WaIncomingUnhandledStanzaEvent, WaMexLidChangeEvent, WaMexMessageCappingEvent, WaMexMessageCappingStatus, WaMexNotificationEvent, WaMexNotificationGraphQlError, WaMexNotificationOperationName, WaMexNotificationUnknownEvent, WaMexOwnUsernameSyncEvent, WaMexTextStatusUpdateEvent, WaMexTextStatusUpdateHintEvent, WaMexUsernameDeleteEvent, WaMexUsernameSetEvent, WaMexUsernameUpdateHintEvent, WaOfflineResumeEvent, WaPictureEvent, WaPictureEventAction, WaPrivacyTokenUpdateEvent, WaReceiptStatus, WaRegistrationCodeEvent, WaSendMessageOptions, WaUnavailableMessageKind, WaVerifiedNameResult, WaAddonKind, WaNewsletterEventAction, WaNewsletterMessageUpdate, WaNewsletterPollVoteEntry, WaNewsletterReactionEntry } from './client/types';
 export type { WaAppStateMutationCoordinator, WaBroadcastListParticipant, WaSetBroadcastListInput, WaSetStatusPrivacyInput } from './client/coordinators/WaAppStateMutationCoordinator';
 export type { WaBotCoordinator, WaBotInfo, WaBotPosingAsProfessional, WaBotProfileCommand, WaBotProfilePrompt, WaBotProfileResult, WaBotPromptOptions, WaGetBotProfileOptions } from './client/coordinators/WaBotCoordinator';
 export type { WaBroadcastListCoordinator, WaSendBroadcastListMessageInput } from './client/coordinators/WaBroadcastListCoordinator';

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

@@ -1,4 +1,4 @@
-import type { WaIncomingMessageEvent, WaIncomingNewsletterMessageUpdateEvent, WaIncomingUnhandledStanzaEvent } from '../../client/types';
+import type { WaIncomingMessageEvent, WaIncomingNewsletterMessageUpdateEvent, WaIncomingUnavailableMessageEvent, WaIncomingUnhandledStanzaEvent } from '../../client/types';
 import type { Logger } from '../../infra/log/types';
 import { proto } from '../../proto';
 import type { WaRetryDecryptFailureContext } from '../../retry/types';
@@ -15,6 +15,7 @@ interface WaIncomingMessageAckHandlerOptions {
     readonly onDecryptFailure?: (context: WaRetryDecryptFailureContext, error: unknown) => Promise<boolean>;
     readonly emitIncomingMessage?: (event: WaIncomingMessageEvent) => void;
     readonly emitNewsletterMessageUpdate?: (event: WaIncomingNewsletterMessageUpdateEvent) => void;
+    readonly emitUnavailableMessage?: (event: WaIncomingUnavailableMessageEvent) => void;
     readonly emitUnhandledStanza?: (event: WaIncomingUnhandledStanzaEvent) => void;
 }
 /**

package/dist/message/primitives/incoming.js

@@ -500,6 +500,42 @@ async function handleIncomingMessageAck(node, options) {
         await options.sendNode(ackNode);
         return true;
     }
+    const unavailableNode = (0, helpers_1.findNodeChild)(node, 'unavailable');
+    if (unavailableNode) {
+        const kind = unavailableNode.attrs.hosted === 'true'
+            ? 'hosted'
+            : unavailableNode.attrs.type === 'view_once'
+                ? 'view_once'
+                : 'other';
+        const senderJid = node.attrs.participant ?? node.attrs.from;
+        const sender = senderJid ? (0, jid_1.parseJidFull)(senderJid) : null;
+        const { key, pushName } = buildIncomingMessageKey(node, sender ? { userJid: sender.userJid, device: sender.address.device } : null, options);
+        options.emitUnavailableMessage?.({
+            rawNode: buildIncomingEventRawNode(node),
+            key,
+            kind,
+            stanzaType: node.attrs.type,
+            offline: node.attrs.offline !== undefined,
+            timestampSeconds: (0, primitives_1.parseOptionalInt)(node.attrs.t),
+            pushName
+        });
+        const ackNode = (0, global_1.buildAckNode)({
+            kind: 'message',
+            node,
+            id,
+            to: from,
+            from: options.getMeJid?.()
+        });
+        options.logger.trace('acking unavailable incoming message', {
+            id,
+            to: from,
+            type: ackNode.attrs.type,
+            participant: ackNode.attrs.participant,
+            unavailableKind: kind
+        });
+        await options.sendNode(ackNode);
+        return true;
+    }
     if (!shouldSendStandardReceipt) {
         return true;
     }

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

@@ -15,6 +15,7 @@ type DirectMessageFanoutInput = {
     readonly customNodes?: readonly BinaryNode[];
     readonly mediatype?: string;
     readonly decryptFail?: string;
+    readonly peerRecipientPn?: string;
     readonly additionalAttributes?: Readonly<Record<string, string>>;
 };
 type GroupMessageFanoutInput = DirectMessageFanoutInput & {

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

@@ -39,6 +39,9 @@ function buildMessageAttrs(input) {
     if (input.addressingMode) {
         attrs.addressing_mode = input.addressingMode;
     }
+    if (input.peerRecipientPn) {
+        attrs.peer_recipient_pn = input.peerRecipientPn;
+    }
     if (input.additionalAttributes) {
         Object.assign(attrs, input.additionalAttributes);
     }

package/dist/util/index.d.ts

@@ -1,4 +1,4 @@
-export { base64ToBytes, bytesToBase64, bytesToBase64UrlSafe, bytesToHex, decodeBase64Url, hexToBytes, TEXT_DECODER, toBytesView, uint8Equal } from './bytes';
+export { base64ToBytes, bytesToBase64, bytesToBase64UrlSafe, bytesToHex, decodeBase64Url, hexToBytes, TEXT_DECODER, toBytesView, uint8Equal, uint8TimingSafeEqual } from './bytes';
 export { asBytes, asNumber, asOptionalBytes, asOptionalNumber, asOptionalString, asString, resolvePositive, toBoolOrUndef } from './coercion';
 export { normalizeQueryLimit } from './collections';
 export { toError, toSafeNumber } from './primitives';

package/dist/util/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isBunRuntime = exports.toSafeNumber = exports.toError = exports.normalizeQueryLimit = exports.toBoolOrUndef = exports.resolvePositive = exports.asString = exports.asOptionalString = exports.asOptionalNumber = exports.asOptionalBytes = exports.asNumber = exports.asBytes = exports.uint8Equal = exports.toBytesView = exports.TEXT_DECODER = exports.hexToBytes = exports.decodeBase64Url = exports.bytesToHex = exports.bytesToBase64UrlSafe = exports.bytesToBase64 = exports.base64ToBytes = void 0;
+exports.isBunRuntime = exports.toSafeNumber = exports.toError = exports.normalizeQueryLimit = exports.toBoolOrUndef = exports.resolvePositive = exports.asString = exports.asOptionalString = exports.asOptionalNumber = exports.asOptionalBytes = exports.asNumber = exports.asBytes = exports.uint8TimingSafeEqual = exports.uint8Equal = exports.toBytesView = exports.TEXT_DECODER = exports.hexToBytes = exports.decodeBase64Url = exports.bytesToHex = exports.bytesToBase64UrlSafe = exports.bytesToBase64 = exports.base64ToBytes = void 0;
 var bytes_1 = require("./bytes");
 Object.defineProperty(exports, "base64ToBytes", { enumerable: true, get: function () { return bytes_1.base64ToBytes; } });
 Object.defineProperty(exports, "bytesToBase64", { enumerable: true, get: function () { return bytes_1.bytesToBase64; } });
@@ -11,6 +11,7 @@ Object.defineProperty(exports, "hexToBytes", { enumerable: true, get: function (
 Object.defineProperty(exports, "TEXT_DECODER", { enumerable: true, get: function () { return bytes_1.TEXT_DECODER; } });
 Object.defineProperty(exports, "toBytesView", { enumerable: true, get: function () { return bytes_1.toBytesView; } });
 Object.defineProperty(exports, "uint8Equal", { enumerable: true, get: function () { return bytes_1.uint8Equal; } });
+Object.defineProperty(exports, "uint8TimingSafeEqual", { enumerable: true, get: function () { return bytes_1.uint8TimingSafeEqual; } });
 var coercion_1 = require("./coercion");
 Object.defineProperty(exports, "asBytes", { enumerable: true, get: function () { return coercion_1.asBytes; } });
 Object.defineProperty(exports, "asNumber", { enumerable: true, get: function () { return coercion_1.asNumber; } });

package/package.json

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