zapo-js 1.2.1 → 1.3.0

package/dist/esm/client/WaClient.js

@@ -3,6 +3,7 @@ import { createIgnoreKeyFilter, validateIgnoreKey } from './messaging/ignore-key
 import { runHistorySyncNotification } from './persistence/history-sync.js';
 import { persistIncomingMailboxEntities } from './persistence/mailbox.js';
 import { WriteBehindPersistence } from './persistence/WriteBehindPersistence.js';
+import { installWaClientPlugins } from './plugins/install.js';
 import { buildWaClientDependencies, resolveWaClientBase } from './WaClientFactory.js';
 import { ConsoleLogger } from '../infra/log/ConsoleLogger.js';
 import { proto } from '../proto.js';
@@ -19,55 +20,8 @@ const SYNC_RELATED_PROTOCOL_TYPES = new Set([
     proto.Message.ProtocolMessage.Type.PEER_DATA_OPERATION_REQUEST_MESSAGE,
     proto.Message.ProtocolMessage.Type.PEER_DATA_OPERATION_REQUEST_RESPONSE_MESSAGE
 ]);
-/**
- * Top-level WhatsApp client. Owns the transport, auth, signal, and per-feature
- * coordinators (accessible via getters such as {@link message}, {@link group},
- * {@link newsletter}, etc.) and re-emits every {@link WaClientEventMap} event.
- *
- * Lifecycle: construct with {@link WaClientOptions}, call {@link connect} to
- * open the socket, react to `connection`/`auth_qr`/`auth_pairing_code` events,
- * then use the coordinator getters to drive the session. Call {@link disconnect}
- * to shut down cleanly or {@link logout} to remove the companion device.
- *
- * @example
- * ```ts
- * import { createPinoLogger, createStore, WaClient } from '..'
- * import { createSqliteStore } from '@zapo-js/store-sqlite'
- *
- * const store = createStore({
- *     backends: { sqlite: createSqliteStore({ path: '.auth/state.sqlite' }) },
- *     providers: {
- *         auth: 'sqlite',
- *         signal: 'sqlite',
- *         preKey: 'sqlite',
- *         session: 'sqlite',
- *         identity: 'sqlite',
- *         senderKey: 'sqlite',
- *         appState: 'sqlite',
- *         privacyToken: 'sqlite',
- *         messages: 'sqlite',
- *         threads: 'sqlite',
- *         contacts: 'sqlite'
- *     }
- * })
- *
- * const client = new WaClient(
- *     { store, sessionId: 'default' },
- *     await createPinoLogger({ level: 'info', pretty: true })
- * )
- *
- * client.on('auth_qr', ({ qr, ttlMs }) => console.log('scan:', qr, ttlMs))
- * client.on('connection', (event) => console.log('connection', event))
- * client.on('message', async (event) => {
- *     if (event.message?.conversation === 'ping') {
- *         await client.message.send(event.chatJid!, 'pong')
- *     }
- * })
- *
- * await client.connect()
- * ```
- */
-export class WaClient extends EventEmitter {
+/** @internal Implementation backing the exported {@link WaClient}. */
+class WaClientImpl extends EventEmitter {
     /**
      * @param options Client configuration (store, transport, addons, history...).
      * @param logger  Optional structured logger. Defaults to a `ConsoleLogger('info')`.
@@ -78,6 +32,7 @@ export class WaClient extends EventEmitter {
         this.acceptingIncomingEvents = true;
         this.activeIncomingHandlers = 0;
         this.incomingHandlersDrainedWaiters = [];
+        this.disposePlugins = null;
         const base = resolveWaClientBase(options, logger);
         this.options = base.options;
         this.logger = base.logger;
@@ -115,6 +70,13 @@ export class WaClient extends EventEmitter {
         this.deps = dependencies;
         this.appStateSync = dependencies.appStateSync;
         this.mediaTransfer = dependencies.mediaTransfer;
+        this.disposePlugins = installWaClientPlugins(this, {
+            options: this.options,
+            logger: this.logger,
+            stores: this.stores,
+            deps: this.deps,
+            queryWithContext: this.queryWithContext.bind(this)
+        }, this.options.plugins ?? []);
         this.bindNodeTransportEvents();
         this.on('connection', (event) => {
             if (event.status !== 'close')
@@ -381,6 +343,11 @@ export class WaClient extends EventEmitter {
                 remaining: writeBehindFlush.remaining
             });
         }
+        if (this.disposePlugins) {
+            const dispose = this.disposePlugins;
+            this.disposePlugins = null;
+            await dispose();
+        }
         await this.deps.connectionManager.disconnect();
         this.emit('connection', {
             status: 'close',
@@ -603,3 +570,57 @@ export class WaClient extends EventEmitter {
         this.emit('debug_client_error', { error });
     }
 }
+/**
+ * Top-level WhatsApp client. Owns the transport, auth, signal, and per-feature
+ * coordinators (accessible via getters such as {@link message}, {@link group},
+ * {@link newsletter}, etc.) and re-emits every {@link WaClientEventMap} event.
+ *
+ * Lifecycle: construct with {@link WaClientOptions}, call {@link connect} to
+ * open the socket, react to `connection`/`auth_qr`/`auth_pairing_code` events,
+ * then use the coordinator getters to drive the session. Call {@link disconnect}
+ * to shut down cleanly or {@link logout} to remove the companion device.
+ *
+ * Pass `plugins` to expose plugin getters and events on the returned client,
+ * typed from the values you pass: e.g. `plugins: [voipPlugin()]` adds
+ * `client.voip` and the `voip_*` events, and only then. See
+ * {@link WaClientConstructor}.
+ *
+ * @example
+ * ```ts
+ * import { createPinoLogger, createStore, WaClient } from '..'
+ * import { createSqliteStore } from '@zapo-js/store-sqlite'
+ *
+ * const store = createStore({
+ *     backends: { sqlite: createSqliteStore({ path: '.auth/state.sqlite' }) },
+ *     providers: {
+ *         auth: 'sqlite',
+ *         signal: 'sqlite',
+ *         preKey: 'sqlite',
+ *         session: 'sqlite',
+ *         identity: 'sqlite',
+ *         senderKey: 'sqlite',
+ *         appState: 'sqlite',
+ *         privacyToken: 'sqlite',
+ *         messages: 'sqlite',
+ *         threads: 'sqlite',
+ *         contacts: 'sqlite'
+ *     }
+ * })
+ *
+ * const client = new WaClient(
+ *     { store, sessionId: 'default' },
+ *     await createPinoLogger({ level: 'info', pretty: true })
+ * )
+ *
+ * client.on('auth_qr', ({ qr, ttlMs }) => console.log('scan:', qr, ttlMs))
+ * client.on('connection', (event) => console.log('connection', event))
+ * client.on('message', async (event) => {
+ *     if (event.message?.conversation === 'ping') {
+ *         await client.message.send(event.chatJid!, 'pong')
+ *     }
+ * })
+ *
+ * await client.connect()
+ * ```
+ */
+export const WaClient = WaClientImpl;

package/dist/esm/client/WaClientFactory.js

@@ -1026,6 +1026,7 @@ export function buildWaClientDependencies(input) {
         signalMissingPreKeysSync,
         signalRotateKey,
         signalSessionSync,
+        sessionResolver,
         authClient,
         messageDispatch,
         messageCoordinator,

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

@@ -0,0 +1,19 @@
+export function defineWaClientPlugin(input) {
+    if ('exposeAs' in input && input.exposeAs !== undefined) {
+        const exposeInput = input;
+        return {
+            id: exposeInput.id,
+            exposeAs: exposeInput.exposeAs,
+            setup: exposeInput.setup,
+            dispose: exposeInput.dispose
+                ? (instance, ctx) => exposeInput.dispose(instance, ctx)
+                : undefined
+        };
+    }
+    const behaviorInput = input;
+    return {
+        id: behaviorInput.id,
+        setup: behaviorInput.setup,
+        dispose: behaviorInput.dispose ? (_instance, ctx) => behaviorInput.dispose(ctx) : undefined
+    };
+}

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

@@ -0,0 +1,3 @@
+export { defineWaClientPlugin } from '../plugins/define.js';
+export { installWaClientPlugins } from '../plugins/install.js';
+export { isWaClientExposePluginDefinition } from '../plugins/types.js';

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/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/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,6 +24,7 @@ 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';

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;