zapo-js 1.2.1 → 1.4.0

package/dist/esm/client/plugins/install.js

@@ -0,0 +1,80 @@
+import { isWaClientExposePluginDefinition } from '../plugins/types.js';
+import { toError } from '../../util/primitives.js';
+/**
+ * Installs {@link WaClientOptions.plugins} on `client`. Returns a dispose
+ * function invoked by {@link WaClient.disconnect}.
+ */
+export function installWaClientPlugins(client, input, plugins) {
+    const seenIds = new Set();
+    const seenExposeAs = new Set();
+    const disposeCallbacks = [];
+    const registerDispose = (fn) => {
+        disposeCallbacks[disposeCallbacks.length] = fn;
+    };
+    const baseCtx = {
+        client,
+        options: input.options,
+        logger: input.logger,
+        stores: input.stores,
+        deps: input.deps,
+        emit: client.emit.bind(client),
+        on: client.on.bind(client),
+        off: client.off.bind(client),
+        once: client.once.bind(client),
+        queryWithContext: input.queryWithContext,
+        registerIncomingHandler: (registration) => input.deps.lowLevelCoordinator.registerIncomingHandler(registration),
+        registerIncomingStanzaFilter: (filter) => input.deps.lowLevelCoordinator.registerIncomingStanzaFilter(filter),
+        registerDispose
+    };
+    for (let index = 0; index < plugins.length; index += 1) {
+        const plugin = plugins[index];
+        if (seenIds.has(plugin.id)) {
+            throw new Error(`duplicate wa client plugin id: ${plugin.id}`);
+        }
+        seenIds.add(plugin.id);
+        const pluginCtx = {
+            ...baseCtx,
+            logger: input.logger.child({ plugin: plugin.id })
+        };
+        if (isWaClientExposePluginDefinition(plugin)) {
+            if (seenExposeAs.has(plugin.exposeAs)) {
+                throw new Error(`duplicate wa client plugin exposeAs: ${plugin.exposeAs}`);
+            }
+            seenExposeAs.add(plugin.exposeAs);
+            if (plugin.exposeAs in client) {
+                throw new Error(`wa client plugin exposeAs "${plugin.exposeAs}" collides with a reserved client member`);
+            }
+            const instance = plugin.setup(pluginCtx);
+            Object.defineProperty(client, plugin.exposeAs, {
+                get: () => instance,
+                enumerable: true,
+                configurable: false
+            });
+            if (plugin.dispose) {
+                const dispose = plugin.dispose;
+                registerDispose(() => dispose(instance, pluginCtx));
+            }
+            pluginCtx.logger.debug('wa client plugin installed', { exposeAs: plugin.exposeAs });
+        }
+        else {
+            plugin.setup(pluginCtx);
+            if (plugin.dispose) {
+                const dispose = plugin.dispose;
+                registerDispose(() => dispose(undefined, pluginCtx));
+            }
+            pluginCtx.logger.debug('wa client plugin installed');
+        }
+    }
+    return async () => {
+        for (let index = disposeCallbacks.length - 1; index >= 0; index -= 1) {
+            try {
+                await disposeCallbacks[index]();
+            }
+            catch (error) {
+                input.logger.warn('wa client plugin dispose failed', {
+                    message: toError(error).message
+                });
+            }
+        }
+    };
+}

package/dist/esm/client/plugins/types.js

@@ -0,0 +1,3 @@
+export function isWaClientExposePluginDefinition(plugin) {
+    return plugin.exposeAs !== undefined && plugin.exposeAs.length > 0;
+}

package/dist/esm/index.js

@@ -1,8 +1,10 @@
 export { WaClient } from './client/index.js';
+export { defineWaClientPlugin } from './client/plugins/index.js';
 export { downloadMediaMessage } from './client/media.js';
 export { parseUsyncResultEnvelope } from './transport/node/builders/usync.js';
 export { getContentType, resolveMessageTarget } from './message/encode/content.js';
 export { resolveMediaPayload } from './message/encode/media-payload.js';
+export { unpadPkcs7, writeRandomPadMax16 } from './message/encode/padding.js';
 export { fetchLatestWaWebVersion } from './transport/wa-web-version-fetcher.js';
 export { ConsoleLogger } from './infra/log/ConsoleLogger.js';
 export { PinoLogger, createPinoLogger } from './infra/log/PinoLogger.js';

package/dist/esm/infra/log/ConsoleLogger.js

@@ -1,10 +1,4 @@
-const LOG_LEVEL_PRIORITY = {
-    trace: 10,
-    debug: 20,
-    info: 30,
-    warn: 40,
-    error: 50
-};
+import { LOG_LEVEL_PRIORITY } from '../log/types.js';
 const CONSOLE_WRITERS = {
     trace: (...args) => console.debug(...args),
     debug: (...args) => console.debug(...args),
@@ -48,9 +42,9 @@ export class ConsoleLogger {
      * Returns a derived logger with `bindings` merged into the parent's
      * bindings. Per-call context still wins on key conflicts.
      */
-    child(bindings) {
+    child(bindings, options) {
         const merged = this.bindings ? { ...this.bindings, ...bindings } : { ...bindings };
-        return new ConsoleLogger(this.level, merged);
+        return new ConsoleLogger(options?.level ?? this.level, merged);
     }
     write(level, message, context) {
         if (LOG_LEVEL_PRIORITY[level] < this.minLevelPriority) {

package/dist/esm/infra/log/PinoLogger.js

@@ -1,3 +1,4 @@
+import { LOG_LEVEL_PRIORITY } from '../log/types.js';
 const PINO_MODULE = 'pino';
 const PINO_PRETTY_MODULE = 'pino-pretty';
 async function loadPinoFactory() {
@@ -57,11 +58,11 @@ export class PinoLogger {
      * call's context. Delegates to the underlying pino `child()` when
      * available; otherwise wraps with a parent + bindings merge.
      */
-    child(bindings) {
+    child(bindings, options) {
         if (typeof this.logger.child === 'function') {
-            return new PinoLogger(this.logger.child(bindings), this.level);
+            return new PinoLogger(this.logger.child(bindings), options?.level ?? this.level);
         }
-        return new BoundLogger(this, bindings);
+        return new BoundLogger(this, bindings, options?.level);
     }
     write(level, message, context) {
         if (context === null || context === undefined) {
@@ -83,28 +84,39 @@ export class PinoLogger {
  * underlying logger does not support `child()` natively.
  */
 class BoundLogger {
-    constructor(parent, bindings) {
+    constructor(parent, bindings, level) {
         this.parent = parent;
-        this.level = parent.level;
+        this.level = level ?? parent.level;
         this.bindings = bindings;
+        this.minPriority = LOG_LEVEL_PRIORITY[this.level];
     }
     trace(message, context) {
-        this.parent.trace(message, this.merge(context));
+        if (LOG_LEVEL_PRIORITY.trace >= this.minPriority) {
+            this.parent.trace(message, this.merge(context));
+        }
     }
     debug(message, context) {
-        this.parent.debug(message, this.merge(context));
+        if (LOG_LEVEL_PRIORITY.debug >= this.minPriority) {
+            this.parent.debug(message, this.merge(context));
+        }
     }
     info(message, context) {
-        this.parent.info(message, this.merge(context));
+        if (LOG_LEVEL_PRIORITY.info >= this.minPriority) {
+            this.parent.info(message, this.merge(context));
+        }
     }
     warn(message, context) {
-        this.parent.warn(message, this.merge(context));
+        if (LOG_LEVEL_PRIORITY.warn >= this.minPriority) {
+            this.parent.warn(message, this.merge(context));
+        }
     }
     error(message, context) {
-        this.parent.error(message, this.merge(context));
+        if (LOG_LEVEL_PRIORITY.error >= this.minPriority) {
+            this.parent.error(message, this.merge(context));
+        }
     }
-    child(bindings) {
-        return new BoundLogger(this.parent, { ...this.bindings, ...bindings });
+    child(bindings, options) {
+        return new BoundLogger(this.parent, { ...this.bindings, ...bindings }, options?.level ?? this.level);
     }
     merge(context) {
         return context ? { ...this.bindings, ...context } : this.bindings;

package/dist/esm/infra/log/types.js

@@ -1,3 +1,10 @@
+export const LOG_LEVEL_PRIORITY = {
+    trace: 10,
+    debug: 20,
+    info: 30,
+    warn: 40,
+    error: 50
+};
 function noop() { }
 export function createNoopLogger(level = 'trace') {
     const logger = {
@@ -7,7 +14,7 @@ export function createNoopLogger(level = 'trace') {
         info: noop,
         warn: noop,
         error: noop,
-        child: () => logger
+        child: (_bindings, options) => (options?.level ? createNoopLogger(options.level) : logger)
     };
     return logger;
 }

package/dist/esm/protocol/nodes.js

@@ -50,6 +50,8 @@ export const WA_NODE_TAGS = Object.freeze({
     COUNTRY_CODE: 'country_code',
     DEVICE_IDENTITY: 'device-identity',
     PLATFORM: 'platform',
+    PASSKEY_REQUEST_OPTIONS: 'passkey_request_options',
+    PRIMARY_EPHEMERAL_IDENTITY: 'primary_ephemeral_identity',
     SUBJECT: 'subject',
     BODY: 'body',
     PARTICIPANT: 'participant',

package/dist/esm/protocol/notification.js

@@ -6,7 +6,9 @@ export const WA_NOTIFICATION_TYPES = Object.freeze({
     REGISTRATION: 'registration',
     NEWSLETTER: 'newsletter',
     BUSINESS: 'business',
-    PICTURE: 'picture'
+    PICTURE: 'picture',
+    PASSKEY_PROLOGUE_REQUEST: 'passkey_prologue_request',
+    CRSC_CONTINUATION: 'crsc_continuation'
 });
 export const WA_BUSINESS_NOTIFICATION_TAGS = Object.freeze({
     VERIFIED_NAME: 'verified_name',

package/dist/esm/retry/replay.js

@@ -85,9 +85,9 @@ export class WaRetryReplayService {
     resolveSignedDeviceIdentity(context) {
         const signedIdentity = this.options.getCurrentCredentials()?.signedIdentity;
         if (!signedIdentity) {
-            this.options.logger.warn('retry request missing signed identity for pkmsg envelope', {
-                context
-            });
+            if (!this.options.isMobilePrimary?.()) {
+                this.options.logger.warn('retry request missing signed identity for pkmsg envelope', { context });
+            }
             return undefined;
         }
         return proto.ADVSignedDeviceIdentity.encode(signedIdentity).finish();
@@ -179,15 +179,7 @@ export class WaRetryReplayService {
             logContext: 'group'
         })) ?? payload.plaintext;
         const encrypted = await this.options.signalProtocol.encryptMessage(requesterAddress, plaintext);
-        let deviceIdentity;
-        if (encrypted.type === 'pkmsg') {
-            const signedIdentity = this.options.getCurrentCredentials()?.signedIdentity;
-            if (!signedIdentity) {
-                this.options.logger.warn('retry request rejected: missing signed identity for pkmsg group retry');
-                return 'ineligible';
-            }
-            deviceIdentity = proto.ADVSignedDeviceIdentity.encode(signedIdentity).finish();
-        }
+        const deviceIdentity = encrypted.type === 'pkmsg' ? this.resolveSignedDeviceIdentity('group') : undefined;
         const isStatus = isStatusBroadcastJid(payload.to);
         const metaAttrs = {};
         if (isStatus) {

package/dist/esm/transport/index.js

@@ -12,3 +12,5 @@ export { WaNodeTransport } from './node/WaNodeTransport.js';
 export { WaMobileTcpSocket, WaMobileTcpSocketCtor } from './node/WaMobileTcpSocket.js';
 export { buildMobileLoginPayload } from './noise/WaMobileClientPayload.js';
 export { assertIqResult, buildIqNode, parseIqError, queryWithContext } from './node/query.js';
+export { buildAckNode, buildReceiptNode } from './node/builders/global.js';
+export { findNodeChild, getFirstNodeChild, getNodeChildren, getNodeChildrenByTag, getNodeTextContent, hasNodeChild } from './node/helpers.js';

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

@@ -0,0 +1,50 @@
+import { WA_DEFAULTS, WA_IQ_TYPES, WA_NODE_TAGS, WA_XMLNS } from '../../../protocol/constants.js';
+import { buildIqNode } from '../../node/query.js';
+/**
+ * IQ builders for the WhatsApp "Shortcake" companion-linking protocol
+ * (`xmlns="md"`). Wire shapes mirror the official client's
+ * `WASmaxOutMd…Request` builders. The stanza `id` is assigned by the socket
+ * query layer, matching the other pairing builders.
+ */
+function mdIq(type, content) {
+    return buildIqNode(type, WA_DEFAULTS.HOST_DOMAIN, WA_XMLNS.MD, content);
+}
+/** `<iq type="get" xmlns="md"><passkey_request_options/></iq>` */
+export function buildGetPasskeyRequestOptionsRequestNode() {
+    return mdIq(WA_IQ_TYPES.GET, [
+        { tag: WA_NODE_TAGS.PASSKEY_REQUEST_OPTIONS, attrs: {}, content: undefined }
+    ]);
+}
+/** `<iq type="get" xmlns="md"><ref/></iq>` */
+export function buildShortcakeGetRefRequestNode() {
+    return mdIq(WA_IQ_TYPES.GET, [{ tag: WA_NODE_TAGS.REF, attrs: {}, content: undefined }]);
+}
+/**
+ * `<iq type="set" xmlns="md"><passkey_prologue><credential_id/><webauthn_assertion/>`
+ * `<prologue_payload/>[<pairing_handoff_proof/>]</passkey_prologue></iq>`
+ */
+export function buildSetPasskeyPrologueRequestNode(args) {
+    const children = [
+        { tag: 'credential_id', attrs: {}, content: args.credentialId },
+        { tag: 'webauthn_assertion', attrs: {}, content: args.webauthnAssertion },
+        { tag: 'prologue_payload', attrs: {}, content: args.prologuePayload }
+    ];
+    if (args.pairingHandoffProof) {
+        children.push({
+            tag: 'pairing_handoff_proof',
+            attrs: {},
+            content: args.pairingHandoffProof
+        });
+    }
+    return mdIq(WA_IQ_TYPES.SET, [{ tag: 'passkey_prologue', attrs: {}, content: children }]);
+}
+/** `<iq type="set" xmlns="md"><companion_nonce/></iq>` */
+export function buildSetCompanionNonceRequestNode(companionNonce) {
+    return mdIq(WA_IQ_TYPES.SET, [{ tag: 'companion_nonce', attrs: {}, content: companionNonce }]);
+}
+/** `<iq type="set" xmlns="md"><encrypted_pairing_request/></iq>` */
+export function buildSetEncryptedPairingRequestRequestNode(encryptedPairingRequest) {
+    return mdIq(WA_IQ_TYPES.SET, [
+        { tag: 'encrypted_pairing_request', attrs: {}, content: encryptedPairingRequest }
+    ]);
+}

package/dist/esm/transport/noise/WaClientPayload.js

@@ -33,7 +33,7 @@ function resolveLocale() {
 function defaultWebSubPlatform() {
     return proto.ClientPayload.WebInfo.WebSubPlatform.WEB_BROWSER;
 }
-function resolveDevicePropsPlatformType(deviceBrowser) {
+export function resolveDevicePropsPlatformType(deviceBrowser) {
     const normalized = deviceBrowser?.trim().toLowerCase();
     switch (normalized) {
         case 'chrome':

package/dist/esm/util/index.js

@@ -1,4 +1,4 @@
-export { base64ToBytes, bytesToBase64, bytesToBase64UrlSafe, bytesToHex, decodeBase64Url, hexToBytes, TEXT_DECODER, toBytesView, uint8Equal, uint8TimingSafeEqual } from './bytes.js';
+export { base64ToBytes, bytesToBase64, bytesToBase64UrlSafe, bytesToHex, concatBytes, decodeBase64Url, EMPTY_BYTES, hexToBytes, TEXT_DECODER, TEXT_ENCODER, 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,5 +1,8 @@
 export { WaClient } from './client';
+export { defineWaClientPlugin } from './client/plugins';
+export type { WaClientDependencies } from './client/WaClientFactory';
 export type { WaClientEventMap, WaClientOptions, WaClientProxyOptions, WaDownloadMediaOptions, WaHistorySyncChunkEvent, WaHistorySyncOptions, WaWriteBehindOptions } from './client/types';
+export type { WaClientPluginContext, WaClientPluginDefinition } from './client/plugins';
 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, 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';
@@ -21,11 +24,13 @@ export type { WaSendStatusInput, WaStatusCoordinator } from './client/coordinato
 export type { WaEncryptedMessageInput, WaMessageAckMetadata, WaMessageKey, WaMessagePublishOptions, WaMessagePublishResult, WaMessageRef, WaMessageTargetInput, WaSendEditKey, WaSendEventLocation, WaSendEventMessage, WaSendEventParent, WaSendEventResponseMessage, WaSendEventResponseType, WaSendKeepMessage, WaSendMediaMessage, WaSendMessageContent, WaSendPinMessage, WaSendPollMessage, WaSendPollOptionInput, WaSendPollParent, WaSendPollVoteMessage, WaSendReactionMessage, WaSendReceiptEventOptions, WaSendReceiptInput, WaSendReceiptOptions, WaSendRevokeMessage, WaSendStickerPackMessage, WaSendStickerPackStickerInput, WaSendStickerPackTrayIcon, WaSendTextMessage } from './message/types';
 export { getContentType, resolveMessageTarget } from './message/encode/content';
 export { resolveMediaPayload } from './message/encode/media-payload';
+export { unpadPkcs7, writeRandomPadMax16 } from './message/encode/padding';
 export type { WaResolvedMediaPayload } from './message/encode/media-payload';
 export type { WaSendContextInfo } from './message/context-info';
 export type { WaLinkPreviewFetcher, WaLinkPreviewOptions, WaLinkPreviewOverride, WaLinkPreviewResolved, WaLinkPreviewThumbnailBytes, WaLinkPreviewThumbnailInput, WaLinkPreviewThumbnailStream, WaLinkPreviewType } from './message/addons/link-preview/types';
 export type { SignalLidSyncResult } from './signal/api/SignalDeviceSyncApi';
 export type { WaAuthCredentials, WaVersionResolver } from './auth/types';
+export type { WaShortcakeAssertionSigner } from './auth/pairing/WaShortcakeFlow';
 export type { BinaryNode } from './transport/types';
 export { fetchLatestWaWebVersion } from './transport/wa-web-version-fetcher';
 export type { WaFetchLatestWebVersionOptions, WaLatestWebVersion } from './transport/wa-web-version-fetcher';

package/dist/index.js

@@ -1,9 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.WA_COMPANION_PLATFORM_IDS = exports.WA_BUSINESS_HOURS_MODES = exports.WA_BUSINESS_HOURS_DAYS = exports.WA_BROWSERS = 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_ACCOUNT_SYNC_PROTOCOLS = exports.toUserJid = exports.splitJid = exports.signalAddressKey = exports.parseSignalAddressFromJid = exports.parsePhoneJid = exports.parseJidFull = exports.normalizeRecipientJid = exports.normalizeDeviceJid = exports.isUserJid = exports.isStatusBroadcastJid = exports.isNewsletterJid = exports.isLidJid = exports.isHostedServer = exports.isHostedDeviceJid = exports.isHostedDeviceId = exports.isGroupOrBroadcastJid = exports.isGroupJid = exports.isBroadcastJid = exports.isBotJid = exports.getWaMediaHkdfInfo = exports.getWaCompanionPlatformId = exports.getLoginIdentity = exports.canonicalizeSignalServer = exports.canonicalizeSignalJid = exports.buildDeviceJid = exports.delay = exports.WaAuthMemoryStore = exports.createStore = exports.createNoopLogger = exports.createPinoLogger = exports.PinoLogger = exports.ConsoleLogger = exports.fetchLatestWaWebVersion = exports.resolveMediaPayload = exports.resolveMessageTarget = exports.getContentType = exports.parseUsyncResultEnvelope = exports.downloadMediaMessage = exports.WaClient = void 0;
-exports.proto = exports.WA_XMLNS = 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_SUPPORTED_DIRTY_TYPES = exports.WA_STREAM_SIGNALING = exports.WA_SIGNALING = exports.WA_RETRYABLE_ACK_CODES = exports.WA_READY_STATES = exports.WA_PREVIEW_MEDIA_HKDF_INFO = exports.WA_PAIRING_KDF_INFO = exports.WA_NODE_TAGS = exports.WA_MEDIA_HKDF_INFO = exports.WA_MESSAGE_TYPES = exports.WA_MESSAGE_TAGS = exports.WA_LOGOUT_REASONS = exports.WA_IQ_TYPES = exports.WA_DISCONNECT_REASONS = exports.WA_DIRTY_TYPES = exports.WA_DIRTY_PROTOCOLS = exports.WA_DEFAULTS = void 0;
+exports.WA_BROWSERS = 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_ACCOUNT_SYNC_PROTOCOLS = exports.toUserJid = exports.splitJid = exports.signalAddressKey = exports.parseSignalAddressFromJid = exports.parsePhoneJid = exports.parseJidFull = exports.normalizeRecipientJid = exports.normalizeDeviceJid = exports.isUserJid = exports.isStatusBroadcastJid = exports.isNewsletterJid = exports.isLidJid = exports.isHostedServer = exports.isHostedDeviceJid = exports.isHostedDeviceId = exports.isGroupOrBroadcastJid = exports.isGroupJid = exports.isBroadcastJid = exports.isBotJid = exports.getWaMediaHkdfInfo = exports.getWaCompanionPlatformId = exports.getLoginIdentity = exports.canonicalizeSignalServer = exports.canonicalizeSignalJid = exports.buildDeviceJid = exports.delay = exports.WaAuthMemoryStore = exports.createStore = exports.createNoopLogger = exports.createPinoLogger = exports.PinoLogger = exports.ConsoleLogger = exports.fetchLatestWaWebVersion = exports.writeRandomPadMax16 = exports.unpadPkcs7 = exports.resolveMediaPayload = exports.resolveMessageTarget = exports.getContentType = exports.parseUsyncResultEnvelope = exports.downloadMediaMessage = exports.defineWaClientPlugin = exports.WaClient = void 0;
+exports.proto = exports.WA_XMLNS = 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_SUPPORTED_DIRTY_TYPES = exports.WA_STREAM_SIGNALING = exports.WA_SIGNALING = exports.WA_RETRYABLE_ACK_CODES = exports.WA_READY_STATES = exports.WA_PREVIEW_MEDIA_HKDF_INFO = exports.WA_PAIRING_KDF_INFO = exports.WA_NODE_TAGS = exports.WA_MEDIA_HKDF_INFO = exports.WA_MESSAGE_TYPES = exports.WA_MESSAGE_TAGS = exports.WA_LOGOUT_REASONS = exports.WA_IQ_TYPES = exports.WA_DISCONNECT_REASONS = exports.WA_DIRTY_TYPES = exports.WA_DIRTY_PROTOCOLS = exports.WA_DEFAULTS = exports.WA_COMPANION_PLATFORM_IDS = exports.WA_BUSINESS_HOURS_MODES = exports.WA_BUSINESS_HOURS_DAYS = void 0;
 var _client_1 = require("./client");
 Object.defineProperty(exports, "WaClient", { enumerable: true, get: function () { return _client_1.WaClient; } });
+var plugins_1 = require("./client/plugins");
+Object.defineProperty(exports, "defineWaClientPlugin", { enumerable: true, get: function () { return plugins_1.defineWaClientPlugin; } });
 var media_1 = require("./client/media");
 Object.defineProperty(exports, "downloadMediaMessage", { enumerable: true, get: function () { return media_1.downloadMediaMessage; } });
 var usync_1 = require("./transport/node/builders/usync");
@@ -13,6 +15,9 @@ Object.defineProperty(exports, "getContentType", { enumerable: true, get: functi
 Object.defineProperty(exports, "resolveMessageTarget", { enumerable: true, get: function () { return content_1.resolveMessageTarget; } });
 var media_payload_1 = require("./message/encode/media-payload");
 Object.defineProperty(exports, "resolveMediaPayload", { enumerable: true, get: function () { return media_payload_1.resolveMediaPayload; } });
+var padding_1 = require("./message/encode/padding");
+Object.defineProperty(exports, "unpadPkcs7", { enumerable: true, get: function () { return padding_1.unpadPkcs7; } });
+Object.defineProperty(exports, "writeRandomPadMax16", { enumerable: true, get: function () { return padding_1.writeRandomPadMax16; } });
 var wa_web_version_fetcher_1 = require("./transport/wa-web-version-fetcher");
 Object.defineProperty(exports, "fetchLatestWaWebVersion", { enumerable: true, get: function () { return wa_web_version_fetcher_1.fetchLatestWaWebVersion; } });
 var ConsoleLogger_1 = require("./infra/log/ConsoleLogger");

package/dist/infra/log/ConsoleLogger.d.ts

@@ -1,4 +1,4 @@
-import type { Logger, LogLevel } from '../log/types';
+import { type Logger, type LogLevel } from '../log/types';
 /**
  * Default zero-dependency {@link Logger} that writes structured records to
  * the standard `console` sinks. Messages below the configured `level` are
@@ -24,6 +24,8 @@ export declare class ConsoleLogger implements Logger {
      * Returns a derived logger with `bindings` merged into the parent's
      * bindings. Per-call context still wins on key conflicts.
      */
-    child(bindings: Readonly<Record<string, unknown>>): Logger;
+    child(bindings: Readonly<Record<string, unknown>>, options?: {
+        readonly level?: LogLevel;
+    }): Logger;
     private write;
 }

package/dist/infra/log/ConsoleLogger.js

@@ -1,13 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ConsoleLogger = void 0;
-const LOG_LEVEL_PRIORITY = {
-    trace: 10,
-    debug: 20,
-    info: 30,
-    warn: 40,
-    error: 50
-};
+const types_1 = require("../log/types");
 const CONSOLE_WRITERS = {
     trace: (...args) => console.debug(...args),
     debug: (...args) => console.debug(...args),
@@ -24,7 +18,7 @@ class ConsoleLogger {
     /** @param level Minimum level to emit. Defaults to `'info'`. */
     constructor(level = 'info', bindings = null) {
         this.level = level;
-        this.minLevelPriority = LOG_LEVEL_PRIORITY[level];
+        this.minLevelPriority = types_1.LOG_LEVEL_PRIORITY[level];
         this.bindings = bindings;
     }
     /** Emits a `trace` record. */
@@ -51,12 +45,12 @@ class ConsoleLogger {
      * Returns a derived logger with `bindings` merged into the parent's
      * bindings. Per-call context still wins on key conflicts.
      */
-    child(bindings) {
+    child(bindings, options) {
         const merged = this.bindings ? { ...this.bindings, ...bindings } : { ...bindings };
-        return new ConsoleLogger(this.level, merged);
+        return new ConsoleLogger(options?.level ?? this.level, merged);
     }
     write(level, message, context) {
-        if (LOG_LEVEL_PRIORITY[level] < this.minLevelPriority) {
+        if (types_1.LOG_LEVEL_PRIORITY[level] < this.minLevelPriority) {
             return;
         }
         if (this.bindings) {

package/dist/infra/log/PinoLogger.d.ts

@@ -1,4 +1,4 @@
-import type { Logger, LogLevel } from '../log/types';
+import { type Logger, type LogLevel } from '../log/types';
 type PinoLikeLogger = {
     level: string;
     trace: (...args: unknown[]) => void;
@@ -72,7 +72,9 @@ export declare class PinoLogger implements Logger {
      * call's context. Delegates to the underlying pino `child()` when
      * available; otherwise wraps with a parent + bindings merge.
      */
-    child(bindings: Readonly<Record<string, unknown>>): Logger;
+    child(bindings: Readonly<Record<string, unknown>>, options?: {
+        readonly level?: LogLevel;
+    }): Logger;
     private write;
 }
 /**

package/dist/infra/log/PinoLogger.js

@@ -35,6 +35,7 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PinoLogger = void 0;
 exports.createPinoLogger = createPinoLogger;
+const types_1 = require("../log/types");
 const PINO_MODULE = 'pino';
 const PINO_PRETTY_MODULE = 'pino-pretty';
 async function loadPinoFactory() {
@@ -94,11 +95,11 @@ class PinoLogger {
      * call's context. Delegates to the underlying pino `child()` when
      * available; otherwise wraps with a parent + bindings merge.
      */
-    child(bindings) {
+    child(bindings, options) {
         if (typeof this.logger.child === 'function') {
-            return new PinoLogger(this.logger.child(bindings), this.level);
+            return new PinoLogger(this.logger.child(bindings), options?.level ?? this.level);
         }
-        return new BoundLogger(this, bindings);
+        return new BoundLogger(this, bindings, options?.level);
     }
     write(level, message, context) {
         if (context === null || context === undefined) {
@@ -121,28 +122,39 @@ exports.PinoLogger = PinoLogger;
  * underlying logger does not support `child()` natively.
  */
 class BoundLogger {
-    constructor(parent, bindings) {
+    constructor(parent, bindings, level) {
         this.parent = parent;
-        this.level = parent.level;
+        this.level = level ?? parent.level;
         this.bindings = bindings;
+        this.minPriority = types_1.LOG_LEVEL_PRIORITY[this.level];
     }
     trace(message, context) {
-        this.parent.trace(message, this.merge(context));
+        if (types_1.LOG_LEVEL_PRIORITY.trace >= this.minPriority) {
+            this.parent.trace(message, this.merge(context));
+        }
     }
     debug(message, context) {
-        this.parent.debug(message, this.merge(context));
+        if (types_1.LOG_LEVEL_PRIORITY.debug >= this.minPriority) {
+            this.parent.debug(message, this.merge(context));
+        }
     }
     info(message, context) {
-        this.parent.info(message, this.merge(context));
+        if (types_1.LOG_LEVEL_PRIORITY.info >= this.minPriority) {
+            this.parent.info(message, this.merge(context));
+        }
     }
     warn(message, context) {
-        this.parent.warn(message, this.merge(context));
+        if (types_1.LOG_LEVEL_PRIORITY.warn >= this.minPriority) {
+            this.parent.warn(message, this.merge(context));
+        }
     }
     error(message, context) {
-        this.parent.error(message, this.merge(context));
+        if (types_1.LOG_LEVEL_PRIORITY.error >= this.minPriority) {
+            this.parent.error(message, this.merge(context));
+        }
     }
-    child(bindings) {
-        return new BoundLogger(this.parent, { ...this.bindings, ...bindings });
+    child(bindings, options) {
+        return new BoundLogger(this.parent, { ...this.bindings, ...bindings }, options?.level ?? this.level);
     }
     merge(context) {
         return context ? { ...this.bindings, ...context } : this.bindings;

package/dist/infra/log/types.d.ts

@@ -1,4 +1,9 @@
 export type LogLevel = 'trace' | 'debug' | 'info' | 'warn' | 'error';
+export declare const LOG_LEVEL_PRIORITY: Readonly<Record<LogLevel, number>>;
+export interface LoggerChildOptions {
+    /** Minimum level the derived logger emits; defaults to the parent's level. */
+    readonly level?: LogLevel;
+}
 export interface Logger {
     readonly level: LogLevel;
     trace(message: string, context?: Readonly<Record<string, unknown>>): void;
@@ -10,7 +15,9 @@ export interface Logger {
      * Returns a derived logger that pre-binds `bindings` into every log
      * call's context object. Bindings stack: `parent.child(a).child(b)`
      * merges `{ ...a, ...b }`. Per-call context wins on key conflicts.
+     * Pass `options.level` to give the child its own minimum level
+     * (independent of the parent), e.g. to quiet a noisy subsystem.
      */
-    child(bindings: Readonly<Record<string, unknown>>): Logger;
+    child(bindings: Readonly<Record<string, unknown>>, options?: LoggerChildOptions): Logger;
 }
 export declare function createNoopLogger(level?: LogLevel): Logger;

package/dist/infra/log/types.js

@@ -1,6 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.LOG_LEVEL_PRIORITY = void 0;
 exports.createNoopLogger = createNoopLogger;
+exports.LOG_LEVEL_PRIORITY = {
+    trace: 10,
+    debug: 20,
+    info: 30,
+    warn: 40,
+    error: 50
+};
 function noop() { }
 function createNoopLogger(level = 'trace') {
     const logger = {
@@ -10,7 +18,7 @@ function createNoopLogger(level = 'trace') {
         info: noop,
         warn: noop,
         error: noop,
-        child: () => logger
+        child: (_bindings, options) => (options?.level ? createNoopLogger(options.level) : logger)
     };
     return logger;
 }

package/dist/protocol/nodes.d.ts

@@ -50,6 +50,8 @@ export declare const WA_NODE_TAGS: Readonly<{
     readonly COUNTRY_CODE: "country_code";
     readonly DEVICE_IDENTITY: "device-identity";
     readonly PLATFORM: "platform";
+    readonly PASSKEY_REQUEST_OPTIONS: "passkey_request_options";
+    readonly PRIMARY_EPHEMERAL_IDENTITY: "primary_ephemeral_identity";
     readonly SUBJECT: "subject";
     readonly BODY: "body";
     readonly PARTICIPANT: "participant";

package/dist/protocol/nodes.js

@@ -53,6 +53,8 @@ exports.WA_NODE_TAGS = Object.freeze({
     COUNTRY_CODE: 'country_code',
     DEVICE_IDENTITY: 'device-identity',
     PLATFORM: 'platform',
+    PASSKEY_REQUEST_OPTIONS: 'passkey_request_options',
+    PRIMARY_EPHEMERAL_IDENTITY: 'primary_ephemeral_identity',
     SUBJECT: 'subject',
     BODY: 'body',
     PARTICIPANT: 'participant',

package/dist/protocol/notification.d.ts

@@ -7,6 +7,8 @@ export declare const WA_NOTIFICATION_TYPES: Readonly<{
     readonly NEWSLETTER: "newsletter";
     readonly BUSINESS: "business";
     readonly PICTURE: "picture";
+    readonly PASSKEY_PROLOGUE_REQUEST: "passkey_prologue_request";
+    readonly CRSC_CONTINUATION: "crsc_continuation";
 }>;
 export declare const WA_BUSINESS_NOTIFICATION_TAGS: Readonly<{
     readonly VERIFIED_NAME: "verified_name";

package/dist/protocol/notification.js

@@ -9,7 +9,9 @@ exports.WA_NOTIFICATION_TYPES = Object.freeze({
     REGISTRATION: 'registration',
     NEWSLETTER: 'newsletter',
     BUSINESS: 'business',
-    PICTURE: 'picture'
+    PICTURE: 'picture',
+    PASSKEY_PROLOGUE_REQUEST: 'passkey_prologue_request',
+    CRSC_CONTINUATION: 'crsc_continuation'
 });
 exports.WA_BUSINESS_NOTIFICATION_TAGS = Object.freeze({
     VERIFIED_NAME: 'verified_name',