zapo-js 0.2.0 → 1.0.0

package/dist/esm/util/collections.js

@@ -4,6 +4,17 @@ export function resolveCleanupIntervalMs(ttlMs, maxIntervalMs = 60000) {
     }
     return Math.min(maxIntervalMs, Math.floor(ttlMs / 2));
 }
+export function createPeriodicCleanup(ttlMs, run) {
+    const timer = setInterval(run, resolveCleanupIntervalMs(ttlMs));
+    timer.unref?.();
+    return {
+        destroy: () => clearInterval(timer)
+    };
+}
+/**
+ * Returns a validated positive-safe-integer query limit, falling back to
+ * `defaultLimit` when `limit` is undefined. Throws on invalid input.
+ */
 export function normalizeQueryLimit(limit, defaultLimit) {
     if (limit === undefined) {
         return defaultLimit;

package/dist/esm/util/index.js

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

package/dist/esm/util/primitives.js

@@ -1,4 +1,11 @@
 const DIGITS_ONLY_RE = /^\d+$/;
+const SIGNED_DIGITS_RE = /^-?\d+$/;
+/**
+ * Normalizes an unknown thrown value into an `Error` – `Error` instances are
+ * returned unchanged, strings/numbers are wrapped, and objects with `message`
+ * or `code` fields are mapped to readable messages. Use in `catch` blocks
+ * before logging.
+ */
 export function toError(value) {
     if (value instanceof Error)
         return value;
@@ -25,6 +32,10 @@ function assertSafeInteger(value, field, nullishBehavior) {
     const prefix = nullishBehavior === 'throw' ? `invalid ${field}` : 'invalid long numeric value';
     throw new Error(`${prefix}: ${value}`);
 }
+/**
+ * Coerces a `number` or `{ toNumber() }` (protobufjs `Long`) to a finite
+ * safe-integer. Throws on missing/non-numeric/out-of-range inputs.
+ */
 export function toSafeNumber(value, field) {
     if (value === null || value === undefined)
         throw new Error(`missing ${field}`);
@@ -56,3 +67,11 @@ export function parseOptionalInt(value) {
         return undefined;
     return parseStrictUnsignedInt(value);
 }
+export function parseOptionalSignedInt(value) {
+    if (!value)
+        return undefined;
+    if (!SIGNED_DIGITS_RE.test(value))
+        return undefined;
+    const parsed = Number(value);
+    return Number.isSafeInteger(parsed) ? parsed : undefined;
+}

package/dist/esm/util/runtime.js

@@ -1,3 +1,7 @@
+/**
+ * Returns a human-friendly OS name (`Windows` / `Mac OS` / `Linux`) for the
+ * current process, falling back to `process.platform` for other OSes.
+ */
 export function getRuntimeOsDisplayName() {
     switch (process.platform) {
         case 'win32':
@@ -10,6 +14,7 @@ export function getRuntimeOsDisplayName() {
             return process.platform;
     }
 }
+/** Returns `true` when running under the Bun runtime. */
 export function isBunRuntime() {
     return typeof globalThis.Bun !== 'undefined';
 }

package/dist/esm/version-spec.js

@@ -0,0 +1 @@
+export { WA_VERSION } from '../spec/version';

package/dist/index.js

@@ -1,24 +1,52 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-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_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.parseSignalAddressFromJid = exports.parsePhoneJid = exports.normalizeRecipientJid = exports.normalizeDeviceJid = exports.isGroupJid = exports.getWaMediaHkdfInfo = exports.getWaCompanionPlatformId = exports.getLoginIdentity = exports.createStore = exports.createPinoLogger = exports.PinoLogger = exports.ConsoleLogger = exports.WaClient = void 0;
+exports.WA_DIRTY_PROTOCOLS = exports.WA_DEFAULTS = 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.resolveMessageTarget = exports.getContentType = exports.parseUsyncResultEnvelope = 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 = void 0;
 var _client_1 = require("./client/index.js");
 Object.defineProperty(exports, "WaClient", { enumerable: true, get: function () { return _client_1.WaClient; } });
+var usync_1 = require("./transport/node/builders/usync");
+Object.defineProperty(exports, "parseUsyncResultEnvelope", { enumerable: true, get: function () { return usync_1.parseUsyncResultEnvelope; } });
+var content_1 = require("./message/encode/content");
+Object.defineProperty(exports, "getContentType", { enumerable: true, get: function () { return content_1.getContentType; } });
+Object.defineProperty(exports, "resolveMessageTarget", { enumerable: true, get: function () { return content_1.resolveMessageTarget; } });
+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");
 Object.defineProperty(exports, "ConsoleLogger", { enumerable: true, get: function () { return ConsoleLogger_1.ConsoleLogger; } });
 var PinoLogger_1 = require("./infra/log/PinoLogger");
 Object.defineProperty(exports, "PinoLogger", { enumerable: true, get: function () { return PinoLogger_1.PinoLogger; } });
 Object.defineProperty(exports, "createPinoLogger", { enumerable: true, get: function () { return PinoLogger_1.createPinoLogger; } });
+var types_1 = require("./infra/log/types");
+Object.defineProperty(exports, "createNoopLogger", { enumerable: true, get: function () { return types_1.createNoopLogger; } });
 var _store_1 = require("./store/index.js");
 Object.defineProperty(exports, "createStore", { enumerable: true, get: function () { return _store_1.createStore; } });
+Object.defineProperty(exports, "WaAuthMemoryStore", { enumerable: true, get: function () { return _store_1.WaAuthMemoryStore; } });
+var async_1 = require("./util/async");
+Object.defineProperty(exports, "delay", { enumerable: true, get: function () { return async_1.delay; } });
 var _protocol_1 = require("./protocol/index.js");
+Object.defineProperty(exports, "buildDeviceJid", { enumerable: true, get: function () { return _protocol_1.buildDeviceJid; } });
+Object.defineProperty(exports, "canonicalizeSignalJid", { enumerable: true, get: function () { return _protocol_1.canonicalizeSignalJid; } });
+Object.defineProperty(exports, "canonicalizeSignalServer", { enumerable: true, get: function () { return _protocol_1.canonicalizeSignalServer; } });
 Object.defineProperty(exports, "getLoginIdentity", { enumerable: true, get: function () { return _protocol_1.getLoginIdentity; } });
 Object.defineProperty(exports, "getWaCompanionPlatformId", { enumerable: true, get: function () { return _protocol_1.getWaCompanionPlatformId; } });
 Object.defineProperty(exports, "getWaMediaHkdfInfo", { enumerable: true, get: function () { return _protocol_1.getWaMediaHkdfInfo; } });
+Object.defineProperty(exports, "isBotJid", { enumerable: true, get: function () { return _protocol_1.isBotJid; } });
+Object.defineProperty(exports, "isBroadcastJid", { enumerable: true, get: function () { return _protocol_1.isBroadcastJid; } });
 Object.defineProperty(exports, "isGroupJid", { enumerable: true, get: function () { return _protocol_1.isGroupJid; } });
+Object.defineProperty(exports, "isGroupOrBroadcastJid", { enumerable: true, get: function () { return _protocol_1.isGroupOrBroadcastJid; } });
+Object.defineProperty(exports, "isHostedDeviceId", { enumerable: true, get: function () { return _protocol_1.isHostedDeviceId; } });
+Object.defineProperty(exports, "isHostedDeviceJid", { enumerable: true, get: function () { return _protocol_1.isHostedDeviceJid; } });
+Object.defineProperty(exports, "isHostedServer", { enumerable: true, get: function () { return _protocol_1.isHostedServer; } });
+Object.defineProperty(exports, "isLidJid", { enumerable: true, get: function () { return _protocol_1.isLidJid; } });
+Object.defineProperty(exports, "isNewsletterJid", { enumerable: true, get: function () { return _protocol_1.isNewsletterJid; } });
+Object.defineProperty(exports, "isStatusBroadcastJid", { enumerable: true, get: function () { return _protocol_1.isStatusBroadcastJid; } });
+Object.defineProperty(exports, "isUserJid", { enumerable: true, get: function () { return _protocol_1.isUserJid; } });
 Object.defineProperty(exports, "normalizeDeviceJid", { enumerable: true, get: function () { return _protocol_1.normalizeDeviceJid; } });
 Object.defineProperty(exports, "normalizeRecipientJid", { enumerable: true, get: function () { return _protocol_1.normalizeRecipientJid; } });
+Object.defineProperty(exports, "parseJidFull", { enumerable: true, get: function () { return _protocol_1.parseJidFull; } });
 Object.defineProperty(exports, "parsePhoneJid", { enumerable: true, get: function () { return _protocol_1.parsePhoneJid; } });
 Object.defineProperty(exports, "parseSignalAddressFromJid", { enumerable: true, get: function () { return _protocol_1.parseSignalAddressFromJid; } });
+Object.defineProperty(exports, "signalAddressKey", { enumerable: true, get: function () { return _protocol_1.signalAddressKey; } });
 Object.defineProperty(exports, "splitJid", { enumerable: true, get: function () { return _protocol_1.splitJid; } });
 Object.defineProperty(exports, "toUserJid", { enumerable: true, get: function () { return _protocol_1.toUserJid; } });
 Object.defineProperty(exports, "WA_ACCOUNT_SYNC_PROTOCOLS", { enumerable: true, get: function () { return _protocol_1.WA_ACCOUNT_SYNC_PROTOCOLS; } });
@@ -29,6 +57,8 @@ Object.defineProperty(exports, "WA_APP_STATE_KDF_INFO", { enumerable: true, get:
 Object.defineProperty(exports, "WA_APP_STATE_KEY_TYPES", { enumerable: true, get: function () { return _protocol_1.WA_APP_STATE_KEY_TYPES; } });
 Object.defineProperty(exports, "WA_APP_STATE_SYNC_DATA_TYPE", { enumerable: true, get: function () { return _protocol_1.WA_APP_STATE_SYNC_DATA_TYPE; } });
 Object.defineProperty(exports, "WA_BROWSERS", { enumerable: true, get: function () { return _protocol_1.WA_BROWSERS; } });
+Object.defineProperty(exports, "WA_BUSINESS_HOURS_DAYS", { enumerable: true, get: function () { return _protocol_1.WA_BUSINESS_HOURS_DAYS; } });
+Object.defineProperty(exports, "WA_BUSINESS_HOURS_MODES", { enumerable: true, get: function () { return _protocol_1.WA_BUSINESS_HOURS_MODES; } });
 Object.defineProperty(exports, "WA_COMPANION_PLATFORM_IDS", { enumerable: true, get: function () { return _protocol_1.WA_COMPANION_PLATFORM_IDS; } });
 Object.defineProperty(exports, "WA_DEFAULTS", { enumerable: true, get: function () { return _protocol_1.WA_DEFAULTS; } });
 Object.defineProperty(exports, "WA_DIRTY_PROTOCOLS", { enumerable: true, get: function () { return _protocol_1.WA_DIRTY_PROTOCOLS; } });

package/dist/infra/log/ConsoleLogger.js

@@ -9,36 +9,60 @@ const LOG_LEVEL_PRIORITY = {
     error: 50
 };
 const CONSOLE_WRITERS = {
-    trace: console.debug,
-    debug: console.debug,
-    info: console.info,
-    warn: console.warn,
-    error: console.error
+    trace: (...args) => console.debug(...args),
+    debug: (...args) => console.debug(...args),
+    info: (...args) => console.info(...args),
+    warn: (...args) => console.warn(...args),
+    error: (...args) => console.error(...args)
 };
+/**
+ * Default zero-dependency {@link Logger} that writes structured records to
+ * the standard `console` sinks. Messages below the configured `level` are
+ * dropped without formatting cost.
+ */
 class ConsoleLogger {
-    constructor(level = 'info') {
+    /** @param level Minimum level to emit. Defaults to `'info'`. */
+    constructor(level = 'info', bindings = null) {
         this.level = level;
         this.minLevelPriority = LOG_LEVEL_PRIORITY[level];
+        this.bindings = bindings;
     }
+    /** Emits a `trace` record. */
     trace(message, context) {
         this.write('trace', message, context);
     }
+    /** Emits a `debug` record. */
     debug(message, context) {
         this.write('debug', message, context);
     }
+    /** Emits an `info` record. */
     info(message, context) {
         this.write('info', message, context);
     }
+    /** Emits a `warn` record. */
     warn(message, context) {
         this.write('warn', message, context);
     }
+    /** Emits an `error` record. */
     error(message, context) {
         this.write('error', message, context);
     }
+    /**
+     * Returns a derived logger with `bindings` merged into the parent's
+     * bindings. Per-call context still wins on key conflicts.
+     */
+    child(bindings) {
+        const merged = this.bindings ? { ...this.bindings, ...bindings } : { ...bindings };
+        return new ConsoleLogger(this.level, merged);
+    }
     write(level, message, context) {
         if (LOG_LEVEL_PRIORITY[level] < this.minLevelPriority) {
             return;
         }
+        if (this.bindings) {
+            CONSOLE_WRITERS[level](message, { ...this.bindings, ...context });
+            return;
+        }
         CONSOLE_WRITERS[level](message, context);
     }
 }

package/dist/infra/log/PinoLogger.js

@@ -53,27 +53,53 @@ async function loadPinoFactory() {
         throw new Error('optional dependency "pino" is not installed. Install with: npm i pino');
     }
 }
+/**
+ * {@link Logger} adapter over a Pino-shaped logger instance. Construct it
+ * directly when you already have a configured Pino logger, or use
+ * {@link createPinoLogger} to build one with the optional `pino` /
+ * `pino-pretty` dependencies.
+ */
 class PinoLogger {
+    /**
+     * @param logger Pino-compatible underlying logger.
+     * @param level  Minimum level to emit (also forwarded to `logger.level`).
+     */
     constructor(logger, level = 'info') {
         this.logger = logger;
         this.level = level;
         this.logger.level = level;
     }
+    /** Emits a `trace` record. */
     trace(message, context) {
         this.write('trace', message, context);
     }
+    /** Emits a `debug` record. */
     debug(message, context) {
         this.write('debug', message, context);
     }
+    /** Emits an `info` record. */
     info(message, context) {
         this.write('info', message, context);
     }
+    /** Emits a `warn` record. */
     warn(message, context) {
         this.write('warn', message, context);
     }
+    /** Emits an `error` record. */
     error(message, context) {
         this.write('error', message, context);
     }
+    /**
+     * Returns a derived logger that pre-binds `bindings` into every log
+     * call's context. Delegates to the underlying pino `child()` when
+     * available; otherwise wraps with a parent + bindings merge.
+     */
+    child(bindings) {
+        if (typeof this.logger.child === 'function') {
+            return new PinoLogger(this.logger.child(bindings), this.level);
+        }
+        return new BoundLogger(this, bindings);
+    }
     write(level, message, context) {
         if (context === null || context === undefined) {
             this.logger[level](message);
@@ -89,6 +115,44 @@ class PinoLogger {
     }
 }
 exports.PinoLogger = PinoLogger;
+/**
+ * Fallback {@link Logger} that pre-binds context fields by merging them
+ * into every call before delegating to a parent logger. Used when the
+ * underlying logger does not support `child()` natively.
+ */
+class BoundLogger {
+    constructor(parent, bindings) {
+        this.parent = parent;
+        this.level = parent.level;
+        this.bindings = bindings;
+    }
+    trace(message, context) {
+        this.parent.trace(message, this.merge(context));
+    }
+    debug(message, context) {
+        this.parent.debug(message, this.merge(context));
+    }
+    info(message, context) {
+        this.parent.info(message, this.merge(context));
+    }
+    warn(message, context) {
+        this.parent.warn(message, this.merge(context));
+    }
+    error(message, context) {
+        this.parent.error(message, this.merge(context));
+    }
+    child(bindings) {
+        return new BoundLogger(this.parent, { ...this.bindings, ...bindings });
+    }
+    merge(context) {
+        return context ? { ...this.bindings, ...context } : this.bindings;
+    }
+}
+/**
+ * Dynamically loads `pino` (and optionally `pino-pretty` when `pretty` is set),
+ * configures it with the given options, and wraps it in a {@link PinoLogger}.
+ * Throws if the optional `pino` dependency is not installed.
+ */
 async function createPinoLogger(options = {}) {
     const level = options.level ?? 'info';
     const pino = await loadPinoFactory();

package/dist/infra/log/types.js

@@ -3,12 +3,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createNoopLogger = createNoopLogger;
 function noop() { }
 function createNoopLogger(level = 'trace') {
-    return {
+    const logger = {
         level,
         trace: noop,
         debug: noop,
         info: noop,
         warn: noop,
-        error: noop
+        error: noop,
+        child: () => logger
     };
+    return logger;
 }

package/dist/infra/perf/BackgroundQueue.js

@@ -1,25 +1,23 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BackgroundQueue = void 0;
+const coercion_1 = require("../../util/coercion");
 const primitives_1 = require("../../util/primitives");
 const DEFAULT_MAX_PENDING_KEYS = 4096;
 const DEFAULT_FLUSH_TIMEOUT_MS = 5000;
+const DEFAULT_MAX_BATCH_SIZE = 250;
 const RETRY_BACKOFF_BASE_MS = 100;
 const RETRY_BACKOFF_MAX_MS = 2000;
 class BackgroundQueue {
     constructor(writer, options = {}) {
         this.writer = writer;
         this.coalesce = options.coalesce ?? ((_p, i) => i);
-        const maxPendingKeys = options.maxPendingKeys ?? DEFAULT_MAX_PENDING_KEYS;
-        if (!Number.isSafeInteger(maxPendingKeys) || maxPendingKeys < 1) {
-            throw new Error('BackgroundQueue maxPendingKeys must be a positive integer');
-        }
-        this.maxPendingKeys = maxPendingKeys;
-        const maxWriteConcurrency = options.maxWriteConcurrency ?? 1;
-        if (!Number.isSafeInteger(maxWriteConcurrency) || maxWriteConcurrency < 1) {
-            throw new Error('BackgroundQueue maxWriteConcurrency must be a positive integer');
-        }
-        this.maxWriteConcurrency = maxWriteConcurrency;
+        this.maxPendingKeys = (0, coercion_1.resolvePositive)(options.maxPendingKeys, DEFAULT_MAX_PENDING_KEYS, 'maxPendingKeys');
+        this.maxWriteConcurrency = (0, coercion_1.resolvePositive)(options.maxWriteConcurrency, 1, 'maxWriteConcurrency');
+        this.batchWriter = options.batchWriter ?? null;
+        this.maxBatchSize = this.batchWriter
+            ? (0, coercion_1.resolvePositive)(options.maxBatchSize, DEFAULT_MAX_BATCH_SIZE, 'maxBatchSize')
+            : DEFAULT_MAX_BATCH_SIZE;
         const flushTimeoutMs = options.flushTimeoutMs ?? DEFAULT_FLUSH_TIMEOUT_MS;
         if (!Number.isFinite(flushTimeoutMs) || flushTimeoutMs < 1) {
             throw new Error('BackgroundQueue flushTimeoutMs must be a positive finite number');
@@ -230,7 +228,15 @@ class BackgroundQueue {
     }
     async drainLoop() {
         while (true) {
-            const batch = this.takeBatch();
+            if (this.batchWriter) {
+                const batch = this.takeBatch(this.maxBatchSize);
+                if (batch.length === 0) {
+                    return;
+                }
+                await this.processBatch(batch);
+                continue;
+            }
+            const batch = this.takeBatch(this.maxWriteConcurrency);
             if (batch.length === 0) {
                 return;
             }
@@ -245,9 +251,9 @@ class BackgroundQueue {
             await Promise.all(tasks);
         }
     }
-    takeBatch() {
+    takeBatch(limit) {
         const batch = [];
-        for (let i = 0; i < this.maxWriteConcurrency; i += 1) {
+        for (let i = 0; i < limit; i += 1) {
             const next = this.takeNext();
             if (!next) {
                 break;
@@ -256,6 +262,42 @@ class BackgroundQueue {
         }
         return batch;
     }
+    async processBatch(batch) {
+        const batchWriter = this.batchWriter;
+        if (!batchWriter) {
+            throw new Error('processBatch called without batchWriter');
+        }
+        this.inFlight += batch.length;
+        const payload = new Array(batch.length);
+        for (let i = 0; i < batch.length; i += 1) {
+            payload[i] = { key: batch[i].key, value: batch[i].entry.value };
+        }
+        try {
+            await batchWriter(payload);
+            this.flushedCount += batch.length;
+            for (const item of batch) {
+                this.resolveEntry(item.entry);
+            }
+        }
+        catch (error) {
+            for (const item of batch) {
+                if (this.retryDisabled) {
+                    this.discardEntry(item.key, item.entry);
+                }
+                else {
+                    const merged = this.mergeForRetry(item.key, item.entry);
+                    const attempt = merged.attempt + 1;
+                    merged.attempt = attempt;
+                    this.invokeOnError(item.key, error, attempt);
+                    this.scheduleRetry(item.key, merged, this.retryDelayMs(attempt));
+                }
+            }
+        }
+        finally {
+            this.inFlight -= batch.length;
+            this.notifyStateChange();
+        }
+    }
     async processEntry(key, entry) {
         this.inFlight += 1;
         try {

package/dist/infra/perf/StoreLock.js

@@ -28,12 +28,14 @@ class StoreLock {
                 current = Promise.reject(error);
             }
         }
-        const tracker = current.then(() => undefined, () => undefined);
+        const tracker = current.then(StoreLock._noop, StoreLock._noop);
         this.chains.set(key, tracker);
-        void tracker.finally(() => {
-            if (this.chains.get(key) === tracker) {
+        tracker.then(() => {
+            if (this.chains.get(key) === tracker)
+                this.chains.delete(key);
+        }, () => {
+            if (this.chains.get(key) === tracker)
                 this.chains.delete(key);
-            }
         });
         return current;
     }
@@ -79,3 +81,4 @@ class StoreLock {
     }
 }
 exports.StoreLock = StoreLock;
+StoreLock._noop = () => undefined;

package/dist/media/constants.js

@@ -1,18 +1,20 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MEDIA_UPLOAD_PATHS = exports.HMAC_TRUNCATED_SIZE = exports.MAC_KEY_END = exports.MAC_KEY_START = exports.ENC_KEY_END = exports.ENC_KEY_START = exports.IV_SIZE = exports.MEDIA_HKDF_SIZE = exports.MEDIA_CONN_CACHE_GRACE_MS = exports.DEFAULT_MEDIA_HOSTS = void 0;
+exports.NEWSLETTER_MEDIA_UPLOAD_PATHS = exports.PPS_UPLOAD_PATHS = exports.MEDIA_UPLOAD_PATHS = exports.SIDECAR_HMAC_SIZE = exports.SIDECAR_CHUNK_SIZE = exports.HMAC_TRUNCATED_SIZE = exports.MAC_KEY_END = exports.MAC_KEY_START = exports.ENC_KEY_END = exports.ENC_KEY_START = exports.IV_SIZE = exports.MEDIA_HKDF_SIZE = exports.MEDIA_CONN_CACHE_GRACE_MS = exports.DEFAULT_MEDIA_HOSTS = void 0;
 exports.DEFAULT_MEDIA_HOSTS = Object.freeze([
     'mmg.whatsapp.net',
     'mmg-fallback.whatsapp.net'
 ]);
 exports.MEDIA_CONN_CACHE_GRACE_MS = 30000;
-exports.MEDIA_HKDF_SIZE = 112;
+exports.MEDIA_HKDF_SIZE = 80;
 exports.IV_SIZE = 16;
 exports.ENC_KEY_START = 16;
 exports.ENC_KEY_END = 48;
 exports.MAC_KEY_START = 48;
 exports.MAC_KEY_END = 80;
 exports.HMAC_TRUNCATED_SIZE = 10;
+exports.SIDECAR_CHUNK_SIZE = 65536;
+exports.SIDECAR_HMAC_SIZE = 10;
 exports.MEDIA_UPLOAD_PATHS = Object.freeze({
     image: '/mms/image',
     video: '/mms/video',
@@ -21,5 +23,36 @@ exports.MEDIA_UPLOAD_PATHS = Object.freeze({
     sticker: '/mms/sticker',
     gif: '/mms/gif',
     ptt: '/mms/ptt',
-    ptv: '/mms/video'
+    ptv: '/mms/video',
+    'ads-image': '/mms/ads-image',
+    'ads-video': '/mms/ads-video',
+    'group-history': '/mms/group-history',
+    'md-app-state': '/mms/md-app-state',
+    'md-msg-hist': '/mms/md-msg-hist',
+    'music-artwork': '/mms/music-artwork',
+    'newsletter-music-artwork': '/mms/newsletter-music-artwork',
+    'sticker-pack': '/mms/sticker-pack',
+    'thumbnail-document': '/mms/thumbnail-document',
+    'thumbnail-image': '/mms/thumbnail-image',
+    'thumbnail-link': '/mms/thumbnail-link',
+    'thumbnail-sticker-pack': '/mms/thumbnail-sticker-pack',
+    'thumbnail-video': '/mms/thumbnail-video',
+    'waffle-image': '/mms/waffle-image',
+    'waffle-video': '/mms/waffle-video'
+});
+exports.PPS_UPLOAD_PATHS = Object.freeze({
+    photo: '/pps/photo',
+    'biz-cover-photo': '/pps/biz-cover-photo'
+});
+exports.NEWSLETTER_MEDIA_UPLOAD_PATHS = Object.freeze({
+    image: '/newsletter/newsletter-image',
+    video: '/newsletter/newsletter-video',
+    audio: '/newsletter/newsletter-audio',
+    document: '/newsletter/newsletter-document',
+    sticker: '/newsletter/newsletter-sticker',
+    'sticker-pack': '/newsletter/newsletter-sticker-pack',
+    gif: '/newsletter/newsletter-gif',
+    ptt: '/newsletter/newsletter-ptt',
+    ptv: '/newsletter/newsletter-ptv',
+    'thumbnail-link': '/newsletter/newsletter-thumbnail-link'
 });