zapo-js 0.2.0 → 1.0.0

package/dist/store/createStore.js

@@ -1,34 +1,61 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createStore = createStore;
+const identity_cache_1 = require("./cache/identity.cache");
+const privacy_token_cache_1 = require("./cache/privacy-token.cache");
+const sender_key_cache_1 = require("./cache/sender-key.cache");
+const session_cache_1 = require("./cache/session.cache");
 const appstate_lock_1 = require("./locks/appstate.lock");
 const auth_lock_1 = require("./locks/auth.lock");
 const contact_lock_1 = require("./locks/contact.lock");
 const device_list_lock_1 = require("./locks/device-list.lock");
+const group_metadata_lock_1 = require("./locks/group-metadata.lock");
+const identity_lock_1 = require("./locks/identity.lock");
+const message_secret_lock_1 = require("./locks/message-secret.lock");
 const message_lock_1 = require("./locks/message.lock");
-const participants_lock_1 = require("./locks/participants.lock");
+const pre_key_lock_1 = require("./locks/pre-key.lock");
 const privacy_token_lock_1 = require("./locks/privacy-token.lock");
 const retry_lock_1 = require("./locks/retry.lock");
 const sender_key_lock_1 = require("./locks/sender-key.lock");
+const session_lock_1 = require("./locks/session.lock");
 const signal_lock_1 = require("./locks/signal.lock");
 const thread_lock_1 = require("./locks/thread.lock");
+const appstate_store_1 = require("./memory/appstate.store");
+const auth_store_1 = require("./memory/auth.store");
+const contact_store_1 = require("./memory/contact.store");
+const device_list_store_1 = require("./memory/device-list.store");
+const group_metadata_store_1 = require("./memory/group-metadata.store");
+const identity_store_1 = require("./memory/identity.store");
+const message_secret_store_1 = require("./memory/message-secret.store");
+const message_store_1 = require("./memory/message.store");
+const pre_key_store_1 = require("./memory/pre-key.store");
+const privacy_token_store_1 = require("./memory/privacy-token.store");
+const retry_store_1 = require("./memory/retry.store");
+const sender_key_store_1 = require("./memory/sender-key.store");
+const session_store_1 = require("./memory/session.store");
+const signal_store_1 = require("./memory/signal.store");
+const thread_store_1 = require("./memory/thread.store");
 const noop_store_1 = require("./noop.store");
-const appstate_store_1 = require("./providers/memory/appstate.store");
-const contact_store_1 = require("./providers/memory/contact.store");
-const device_list_store_1 = require("./providers/memory/device-list.store");
-const message_store_1 = require("./providers/memory/message.store");
-const participants_store_1 = require("./providers/memory/participants.store");
-const privacy_token_store_1 = require("./providers/memory/privacy-token.store");
-const retry_store_1 = require("./providers/memory/retry.store");
-const sender_key_store_1 = require("./providers/memory/sender-key.store");
-const signal_store_1 = require("./providers/memory/signal.store");
-const thread_store_1 = require("./providers/memory/thread.store");
 const coercion_1 = require("../util/coercion");
 const DEFAULT_CACHE_TTLS_MS = Object.freeze({
     retryMs: 60 * 1000,
-    participantsMs: 5 * 60 * 1000,
-    deviceListMs: 5 * 60 * 1000
+    groupMetadataMs: 5 * 60 * 1000,
+    deviceListMs: 5 * 60 * 1000,
+    messageSecretMs: 30 * 60 * 1000
 });
+const REQUIRED_PROVIDER_DOMAINS = [
+    'auth',
+    'signal',
+    'preKey',
+    'session',
+    'identity',
+    'senderKey',
+    'appState',
+    'messages',
+    'threads',
+    'contacts',
+    'privacyToken'
+];
 function hasDestroy(value) {
     return (!!value &&
         typeof value === 'object' &&
@@ -40,6 +67,9 @@ async function destroyIfSupported(value) {
         return;
     await value.destroy();
 }
+function usesBackend(provider) {
+    return !!provider && provider !== 'memory' && provider !== 'none';
+}
 function resolveStore(sessionId, backends, provider, domain, kind, fallback) {
     if (!provider || provider === 'memory' || provider === 'none') {
         return fallback();
@@ -55,13 +85,31 @@ function resolveStore(sessionId, backends, provider, domain, kind, fallback) {
     return factory(sessionId);
 }
 function createStore(options) {
+    options = options ?? {};
     const backends = (options.backends ?? {});
     const providers = options.providers ?? {};
     const cacheProviders = options.cacheProviders ?? {};
+    const cacheLayer = options.cacheLayer ?? {};
+    const storeLogger = options.logger?.child({ scope: 'store' });
+    const memoryLogger = storeLogger?.child({ provider: 'memory' });
+    if (Object.keys(backends).length > 0) {
+        const missingProviders = REQUIRED_PROVIDER_DOMAINS.filter((domain) => providers[domain] === undefined);
+        if (missingProviders.length > 0) {
+            throw new Error(`createStore: when backends is set, every persistence domain must be assigned ` +
+                `explicitly via providers. Missing: ${missingProviders
+                    .map((d) => `providers.${d}`)
+                    .join(', ')}. Pass a backend name (e.g. 'sqlite') to persist, or ` +
+                `'memory' to use the in-tree memory provider. For the mailbox domains ` +
+                `(messages/threads/contacts) 'none' skips the domain entirely; for the ` +
+                `other domains 'none' falls back to memory. Cache providers ` +
+                `(retry/groupMetadata/deviceList/messageSecret) stay opt-in and default to memory.`);
+        }
+    }
     const cacheTtlsMs = Object.freeze({
         retry: (0, coercion_1.resolvePositive)(options.memory?.cacheTtlMs?.retryMs, DEFAULT_CACHE_TTLS_MS.retryMs, 'memory.cacheTtlMs.retryMs'),
-        participants: (0, coercion_1.resolvePositive)(options.memory?.cacheTtlMs?.participantsMs, DEFAULT_CACHE_TTLS_MS.participantsMs, 'memory.cacheTtlMs.participantsMs'),
-        deviceList: (0, coercion_1.resolvePositive)(options.memory?.cacheTtlMs?.deviceListMs, DEFAULT_CACHE_TTLS_MS.deviceListMs, 'memory.cacheTtlMs.deviceListMs')
+        groupMetadata: (0, coercion_1.resolvePositive)(options.memory?.cacheTtlMs?.groupMetadataMs, DEFAULT_CACHE_TTLS_MS.groupMetadataMs, 'memory.cacheTtlMs.groupMetadataMs'),
+        deviceList: (0, coercion_1.resolvePositive)(options.memory?.cacheTtlMs?.deviceListMs, DEFAULT_CACHE_TTLS_MS.deviceListMs, 'memory.cacheTtlMs.deviceListMs'),
+        messageSecret: (0, coercion_1.resolvePositive)(options.memory?.cacheTtlMs?.messageSecretMs, DEFAULT_CACHE_TTLS_MS.messageSecretMs, 'memory.cacheTtlMs.messageSecretMs')
     });
     const sessions = new Map();
     let storeDestroyed = false;
@@ -78,12 +126,11 @@ function createStore(options) {
             if (cached)
                 return cached;
             const ml = options.memory?.limits ?? {};
-            const rawAuth = resolveStore(id, backends, providers.auth, 'auth', 'stores', () => {
-                throw new Error('providers.auth is required — register a backend or set providers.auth');
-            });
-            const rawSignal = resolveStore(id, backends, providers.signal ?? 'memory', 'signal', 'stores', () => new signal_store_1.WaSignalMemoryStore({
-                maxPreKeys: ml.signalPreKeys,
-                maxSessions: ml.signalSessions,
+            const rawAuth = resolveStore(id, backends, providers.auth ?? 'memory', 'auth', 'stores', () => new auth_store_1.WaAuthMemoryStore());
+            const rawSignal = resolveStore(id, backends, providers.signal ?? 'memory', 'signal', 'stores', () => new signal_store_1.WaSignalMemoryStore());
+            const rawPreKey = resolveStore(id, backends, providers.preKey ?? 'memory', 'preKey', 'stores', () => new pre_key_store_1.WaPreKeyMemoryStore({ maxPreKeys: ml.signalPreKeys }));
+            const rawSession = resolveStore(id, backends, providers.session ?? 'memory', 'session', 'stores', () => new session_store_1.WaSessionMemoryStore({ maxSessions: ml.signalSessions }));
+            const rawIdentity = resolveStore(id, backends, providers.identity ?? 'memory', 'identity', 'stores', () => new identity_store_1.WaIdentityMemoryStore({
                 maxRemoteIdentities: ml.signalRemoteIdentities
             }));
             const rawSenderKey = resolveStore(id, backends, providers.senderKey ?? 'memory', 'senderKey', 'stores', () => new sender_key_store_1.SenderKeyMemoryStore({
@@ -104,28 +151,60 @@ function createStore(options) {
                 ? new contact_store_1.WaContactMemoryStore({ maxContacts: ml.contacts })
                 : noop_store_1.NOOP_CONTACT_STORE);
             const rawPrivacyToken = resolveStore(id, backends, providers.privacyToken ?? 'memory', 'privacyToken', 'stores', () => new privacy_token_store_1.WaPrivacyTokenMemoryStore(ml.privacyTokens));
-            const rawRetry = resolveStore(id, backends, cacheProviders.retry ?? 'memory', 'retry', 'caches', () => new retry_store_1.WaRetryMemoryStore(cacheTtlsMs.retry));
-            const rawParticipants = resolveStore(id, backends, cacheProviders.participants ?? 'memory', 'participants', 'caches', () => cacheProviders.participants === 'memory'
-                ? new participants_store_1.WaParticipantsMemoryStore(cacheTtlsMs.participants, {
-                    maxGroups: ml.participantsGroups
+            const rawRetry = resolveStore(id, backends, cacheProviders.retry ?? 'memory', 'retry', 'caches', () => cacheProviders.retry === 'memory' || !cacheProviders.retry
+                ? new retry_store_1.WaRetryMemoryStore(cacheTtlsMs.retry, {
+                    maxOutboundMessages: ml.retryOutboundMessages,
+                    maxInboundCounters: ml.retryInboundCounters,
+                    logger: memoryLogger?.child({ domain: 'retry', sessionId: id })
                 })
-                : noop_store_1.NOOP_PARTICIPANTS_STORE);
+                : noop_store_1.NOOP_RETRY_STORE);
+            const rawGroupMetadata = resolveStore(id, backends, cacheProviders.groupMetadata ?? 'memory', 'groupMetadata', 'caches', () => cacheProviders.groupMetadata === 'memory' || !cacheProviders.groupMetadata
+                ? new group_metadata_store_1.WaGroupMetadataMemoryStore(cacheTtlsMs.groupMetadata, {
+                    maxGroups: ml.groupMetadataGroups,
+                    logger: memoryLogger?.child({
+                        domain: 'groupMetadata',
+                        sessionId: id
+                    })
+                })
+                : noop_store_1.NOOP_GROUP_METADATA_STORE);
             const rawDeviceList = resolveStore(id, backends, cacheProviders.deviceList ?? 'memory', 'deviceList', 'caches', () => cacheProviders.deviceList === 'memory'
                 ? new device_list_store_1.WaDeviceListMemoryStore(cacheTtlsMs.deviceList, {
-                    maxUsers: ml.deviceListUsers
+                    maxUsers: ml.deviceListUsers,
+                    logger: memoryLogger?.child({ domain: 'deviceList', sessionId: id })
                 })
                 : noop_store_1.NOOP_DEVICE_LIST_STORE);
+            const rawMessageSecret = resolveStore(id, backends, cacheProviders.messageSecret ?? 'memory', 'messageSecret', 'caches', () => cacheProviders.messageSecret === 'memory' || !cacheProviders.messageSecret
+                ? new message_secret_store_1.WaMessageSecretMemoryStore(cacheTtlsMs.messageSecret, {
+                    maxSecrets: ml.messageSecrets,
+                    logger: memoryLogger?.child({
+                        domain: 'messageSecret',
+                        sessionId: id
+                    })
+                })
+                : noop_store_1.NOOP_MESSAGE_SECRET_STORE);
             const authStore = (0, auth_lock_1.withAuthLock)(rawAuth);
             const signalStore = (0, signal_lock_1.withSignalLock)(rawSignal);
-            const senderKeyStore = (0, sender_key_lock_1.withSenderKeyLock)(rawSenderKey);
+            const preKeyStore = (0, pre_key_lock_1.withPreKeyLock)(rawPreKey);
+            const sessionStore = (0, session_lock_1.withSessionLock)(cacheLayer.session && usesBackend(providers.session)
+                ? (0, session_cache_1.withSessionCache)(rawSession, cacheLayer.limits?.session)
+                : rawSession);
+            const identityStore = (0, identity_lock_1.withIdentityLock)(cacheLayer.identity && usesBackend(providers.identity)
+                ? (0, identity_cache_1.withIdentityCache)(rawIdentity, cacheLayer.limits?.identity)
+                : rawIdentity);
+            const senderKeyStore = (0, sender_key_lock_1.withSenderKeyLock)(cacheLayer.senderKey && usesBackend(providers.senderKey)
+                ? (0, sender_key_cache_1.withSenderKeyCache)(rawSenderKey, cacheLayer.limits?.senderKey)
+                : rawSenderKey);
             const appStateStore = (0, appstate_lock_1.withAppStateLock)(rawAppState);
             const retryStore = (0, retry_lock_1.withRetryLock)(rawRetry);
-            const participantsStore = (0, participants_lock_1.withParticipantsLock)(rawParticipants);
+            const groupMetadataStore = (0, group_metadata_lock_1.withGroupMetadataLock)(rawGroupMetadata);
             const deviceListStore = (0, device_list_lock_1.withDeviceListLock)(rawDeviceList);
             const messageStore = (0, message_lock_1.withMessageLock)(rawMessages);
+            const messageSecretStore = (0, message_secret_lock_1.withMessageSecretLock)(rawMessageSecret);
             const threadStore = (0, thread_lock_1.withThreadLock)(rawThreads);
             const contactStore = (0, contact_lock_1.withContactLock)(rawContacts);
-            const privacyTokenStore = (0, privacy_token_lock_1.withPrivacyTokenLock)(rawPrivacyToken);
+            const privacyTokenStore = (0, privacy_token_lock_1.withPrivacyTokenLock)(cacheLayer.privacyToken && usesBackend(providers.privacyToken)
+                ? (0, privacy_token_cache_1.withPrivacyTokenCache)(rawPrivacyToken, cacheLayer.limits?.privacyToken)
+                : rawPrivacyToken);
             let cachesDestroyed = false;
             let sessionDestroyed = false;
             const destroyCaches = async () => {
@@ -134,13 +213,15 @@ function createStore(options) {
                 cachesDestroyed = true;
                 await Promise.all([
                     retryStore.clear(),
-                    participantsStore.clear(),
-                    deviceListStore.clear()
+                    groupMetadataStore.clear(),
+                    deviceListStore.clear(),
+                    messageSecretStore.clear()
                 ]);
                 await Promise.all([
                     destroyIfSupported(retryStore),
-                    destroyIfSupported(participantsStore),
-                    destroyIfSupported(deviceListStore)
+                    destroyIfSupported(groupMetadataStore),
+                    destroyIfSupported(deviceListStore),
+                    destroyIfSupported(messageSecretStore)
                 ]);
             };
             const destroy = async () => {
@@ -151,6 +232,9 @@ function createStore(options) {
                 await Promise.all([
                     destroyIfSupported(authStore),
                     destroyIfSupported(signalStore),
+                    destroyIfSupported(preKeyStore),
+                    destroyIfSupported(sessionStore),
+                    destroyIfSupported(identityStore),
                     destroyIfSupported(senderKeyStore),
                     destroyIfSupported(appStateStore),
                     destroyIfSupported(messageStore),
@@ -159,23 +243,27 @@ function createStore(options) {
                     destroyIfSupported(privacyTokenStore)
                 ]);
             };
-            const session = {
+            const storeSession = {
                 auth: authStore,
                 signal: signalStore,
+                preKey: preKeyStore,
+                session: sessionStore,
+                identity: identityStore,
                 senderKey: senderKeyStore,
                 appState: appStateStore,
                 retry: retryStore,
-                participants: participantsStore,
+                groupMetadata: groupMetadataStore,
                 deviceList: deviceListStore,
                 messages: messageStore,
+                messageSecret: messageSecretStore,
                 threads: threadStore,
                 contacts: contactStore,
                 privacyToken: privacyTokenStore,
                 destroyCaches,
                 destroy
             };
-            sessions.set(id, session);
-            return session;
+            sessions.set(id, storeSession);
+            return storeSession;
         },
         async destroyCaches() {
             const list = Array.from(sessions.values());
@@ -188,6 +276,8 @@ function createStore(options) {
             const list = Array.from(sessions.values());
             sessions.clear();
             await Promise.all(list.map((s) => s.destroy()));
+            const uniqueBackends = new Set(Object.values(backends));
+            await Promise.all(Array.from(uniqueBackends, (backend) => destroyIfSupported(backend)));
         }
     };
 }

package/dist/store/index.js

@@ -1,25 +1,35 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.WaPrivacyTokenMemoryStore = exports.WaThreadMemoryStore = exports.WaMessageMemoryStore = exports.WaContactMemoryStore = exports.WaDeviceListMemoryStore = exports.WaParticipantsMemoryStore = exports.WaRetryMemoryStore = exports.SenderKeyMemoryStore = exports.WaSignalMemoryStore = exports.WaAppStateMemoryStore = exports.createStore = void 0;
+exports.WaPrivacyTokenMemoryStore = exports.WaThreadMemoryStore = exports.WaMessageMemoryStore = exports.WaMessageSecretMemoryStore = exports.WaContactMemoryStore = exports.WaDeviceListMemoryStore = exports.WaGroupMetadataMemoryStore = exports.WaRetryMemoryStore = exports.SenderKeyMemoryStore = exports.WaIdentityMemoryStore = exports.WaSessionMemoryStore = exports.WaPreKeyMemoryStore = exports.WaSignalMemoryStore = exports.WaAuthMemoryStore = exports.WaAppStateMemoryStore = exports.createStore = void 0;
 var createStore_1 = require("./createStore");
 Object.defineProperty(exports, "createStore", { enumerable: true, get: function () { return createStore_1.createStore; } });
-var appstate_store_1 = require("./providers/memory/appstate.store");
+var appstate_store_1 = require("./memory/appstate.store");
 Object.defineProperty(exports, "WaAppStateMemoryStore", { enumerable: true, get: function () { return appstate_store_1.WaAppStateMemoryStore; } });
-var signal_store_1 = require("./providers/memory/signal.store");
+var auth_store_1 = require("./memory/auth.store");
+Object.defineProperty(exports, "WaAuthMemoryStore", { enumerable: true, get: function () { return auth_store_1.WaAuthMemoryStore; } });
+var signal_store_1 = require("./memory/signal.store");
 Object.defineProperty(exports, "WaSignalMemoryStore", { enumerable: true, get: function () { return signal_store_1.WaSignalMemoryStore; } });
-var sender_key_store_1 = require("./providers/memory/sender-key.store");
+var pre_key_store_1 = require("./memory/pre-key.store");
+Object.defineProperty(exports, "WaPreKeyMemoryStore", { enumerable: true, get: function () { return pre_key_store_1.WaPreKeyMemoryStore; } });
+var session_store_1 = require("./memory/session.store");
+Object.defineProperty(exports, "WaSessionMemoryStore", { enumerable: true, get: function () { return session_store_1.WaSessionMemoryStore; } });
+var identity_store_1 = require("./memory/identity.store");
+Object.defineProperty(exports, "WaIdentityMemoryStore", { enumerable: true, get: function () { return identity_store_1.WaIdentityMemoryStore; } });
+var sender_key_store_1 = require("./memory/sender-key.store");
 Object.defineProperty(exports, "SenderKeyMemoryStore", { enumerable: true, get: function () { return sender_key_store_1.SenderKeyMemoryStore; } });
-var retry_store_1 = require("./providers/memory/retry.store");
+var retry_store_1 = require("./memory/retry.store");
 Object.defineProperty(exports, "WaRetryMemoryStore", { enumerable: true, get: function () { return retry_store_1.WaRetryMemoryStore; } });
-var participants_store_1 = require("./providers/memory/participants.store");
-Object.defineProperty(exports, "WaParticipantsMemoryStore", { enumerable: true, get: function () { return participants_store_1.WaParticipantsMemoryStore; } });
-var device_list_store_1 = require("./providers/memory/device-list.store");
+var group_metadata_store_1 = require("./memory/group-metadata.store");
+Object.defineProperty(exports, "WaGroupMetadataMemoryStore", { enumerable: true, get: function () { return group_metadata_store_1.WaGroupMetadataMemoryStore; } });
+var device_list_store_1 = require("./memory/device-list.store");
 Object.defineProperty(exports, "WaDeviceListMemoryStore", { enumerable: true, get: function () { return device_list_store_1.WaDeviceListMemoryStore; } });
-var contact_store_1 = require("./providers/memory/contact.store");
+var contact_store_1 = require("./memory/contact.store");
 Object.defineProperty(exports, "WaContactMemoryStore", { enumerable: true, get: function () { return contact_store_1.WaContactMemoryStore; } });
-var message_store_1 = require("./providers/memory/message.store");
+var message_secret_store_1 = require("./memory/message-secret.store");
+Object.defineProperty(exports, "WaMessageSecretMemoryStore", { enumerable: true, get: function () { return message_secret_store_1.WaMessageSecretMemoryStore; } });
+var message_store_1 = require("./memory/message.store");
 Object.defineProperty(exports, "WaMessageMemoryStore", { enumerable: true, get: function () { return message_store_1.WaMessageMemoryStore; } });
-var thread_store_1 = require("./providers/memory/thread.store");
+var thread_store_1 = require("./memory/thread.store");
 Object.defineProperty(exports, "WaThreadMemoryStore", { enumerable: true, get: function () { return thread_store_1.WaThreadMemoryStore; } });
-var privacy_token_store_1 = require("./providers/memory/privacy-token.store");
+var privacy_token_store_1 = require("./memory/privacy-token.store");
 Object.defineProperty(exports, "WaPrivacyTokenMemoryStore", { enumerable: true, get: function () { return privacy_token_store_1.WaPrivacyTokenMemoryStore; } });

package/dist/store/locks/contact.lock.js

@@ -12,6 +12,7 @@ function withContactLock(store) {
         upsert: (record) => gate.runShared(() => lock.run(`contact:${record.jid}`, () => store.upsert(record))),
         upsertBatch: (records) => gate.runShared(() => lock.runMany(records.map((record) => `contact:${record.jid}`), () => store.upsertBatch(records))),
         getByJid: (jid) => gate.runShared(() => store.getByJid(jid)),
+        getByPhoneNumber: (pn) => gate.runShared(() => store.getByPhoneNumber(pn)),
         deleteByJid: (jid) => gate.runShared(() => lock.run(`contact:${jid}`, () => store.deleteByJid(jid))),
         clear: () => gate.runExclusive(() => lock.run(WA_CONTACT_CLEAR_KEY, () => store.clear())),
         destroy: async () => {

package/dist/store/locks/device-list.lock.js

@@ -16,6 +16,7 @@ function withDeviceListLock(store) {
         },
         upsertUserDevicesBatch: (snapshots) => gate.runShared(() => lock.runMany(snapshots.map((snapshot) => `deviceList:user:${snapshot.userJid}`), () => store.upsertUserDevicesBatch(snapshots))),
         getUserDevicesBatch: (userJids, nowMs) => gate.runShared(() => store.getUserDevicesBatch(userJids, nowMs)),
+        findByAnyUserJid: (jid, nowMs) => gate.runShared(() => store.findByAnyUserJid(jid, nowMs)),
         deleteUserDevices: (userJid) => gate.runShared(() => lock.run(`deviceList:user:${userJid}`, () => store.deleteUserDevices(userJid))),
         cleanupExpired: (nowMs) => gate.runExclusive(() => lock.run(WA_DEVICE_LIST_CLEANUP_KEY, () => store.cleanupExpired(nowMs))),
         clear: () => gate.runExclusive(() => lock.run(WA_DEVICE_LIST_CLEAR_KEY, () => store.clear()))

package/dist/store/locks/group-metadata.lock.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withGroupMetadataLock = withGroupMetadataLock;
+const SharedExclusiveGate_1 = require("../../infra/perf/SharedExclusiveGate");
+const StoreLock_1 = require("../../infra/perf/StoreLock");
+const WA_GROUP_METADATA_CLEAR_KEY = 'group-metadata:clear';
+const WA_GROUP_METADATA_CLEANUP_KEY = 'group-metadata:cleanup';
+function withGroupMetadataLock(store) {
+    const lock = new StoreLock_1.StoreLock();
+    const gate = new SharedExclusiveGate_1.SharedExclusiveGate();
+    return {
+        destroy: async () => {
+            await gate.close();
+            await lock.shutdown();
+            await store.destroy?.();
+        },
+        upsertGroupMetadata: (snapshot) => gate.runShared(() => lock.run(`group-metadata:group:${snapshot.groupJid}`, () => store.upsertGroupMetadata(snapshot))),
+        getGroupMetadata: (groupJid, nowMs) => gate.runShared(() => store.getGroupMetadata(groupJid, nowMs)),
+        deleteGroupMetadata: (groupJid) => gate.runShared(() => lock.run(`group-metadata:group:${groupJid}`, () => store.deleteGroupMetadata(groupJid))),
+        cleanupExpired: (nowMs) => gate.runExclusive(() => lock.run(WA_GROUP_METADATA_CLEANUP_KEY, () => store.cleanupExpired(nowMs))),
+        clear: () => gate.runExclusive(() => lock.run(WA_GROUP_METADATA_CLEAR_KEY, () => store.clear()))
+    };
+}

package/dist/store/locks/identity.lock.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withIdentityLock = withIdentityLock;
+const SharedExclusiveGate_1 = require("../../infra/perf/SharedExclusiveGate");
+function withIdentityLock(store) {
+    const gate = new SharedExclusiveGate_1.SharedExclusiveGate();
+    const destroyStore = store;
+    return {
+        getRemoteIdentity: (address) => gate.runShared(() => store.getRemoteIdentity(address)),
+        getRemoteIdentities: (addresses) => gate.runShared(() => store.getRemoteIdentities(addresses)),
+        setRemoteIdentity: (address, identityKey) => gate.runShared(() => store.setRemoteIdentity(address, identityKey)),
+        setRemoteIdentities: (entries) => gate.runShared(() => store.setRemoteIdentities(entries)),
+        clear: () => gate.runExclusive(() => store.clear()),
+        destroy: async () => {
+            await gate.close();
+            await destroyStore.destroy?.();
+        }
+    };
+}

package/dist/store/locks/message-secret.lock.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withMessageSecretLock = withMessageSecretLock;
+const SharedExclusiveGate_1 = require("../../infra/perf/SharedExclusiveGate");
+function withMessageSecretLock(store) {
+    const gate = new SharedExclusiveGate_1.SharedExclusiveGate();
+    const destroyStore = store;
+    return {
+        get: (messageId, nowMs) => gate.runShared(() => store.get(messageId, nowMs)),
+        getBatch: (messageIds, nowMs) => gate.runShared(() => store.getBatch(messageIds, nowMs)),
+        set: (messageId, entry) => gate.runShared(() => store.set(messageId, entry)),
+        setBatch: (entries) => gate.runShared(() => store.setBatch(entries)),
+        cleanupExpired: (nowMs) => gate.runExclusive(() => store.cleanupExpired(nowMs)),
+        clear: () => gate.runExclusive(() => store.clear()),
+        destroy: async () => {
+            await gate.close();
+            await destroyStore.destroy?.();
+        }
+    };
+}

package/dist/store/locks/pre-key.lock.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withPreKeyLock = withPreKeyLock;
+const SharedExclusiveGate_1 = require("../../infra/perf/SharedExclusiveGate");
+const StoreLock_1 = require("../../infra/perf/StoreLock");
+const WA_PREKEY_KEY = 'prekey:prekeys';
+const WA_PREKEY_SERVER_KEY = 'prekey:serverHasPreKeys';
+const WA_PREKEY_CLEAR_KEY = 'prekey:clear';
+function withPreKeyLock(store) {
+    const lock = new StoreLock_1.StoreLock();
+    const gate = new SharedExclusiveGate_1.SharedExclusiveGate();
+    const destroyStore = store;
+    return {
+        putPreKey: (record) => gate.runShared(() => lock.run(WA_PREKEY_KEY, () => store.putPreKey(record))),
+        getOrGenPreKeys: (count, generator) => gate.runShared(() => lock.run(WA_PREKEY_KEY, () => store.getOrGenPreKeys(count, generator))),
+        getPreKeyById: (keyId) => gate.runShared(() => store.getPreKeyById(keyId)),
+        getPreKeysById: (keyIds) => gate.runShared(() => store.getPreKeysById(keyIds)),
+        consumePreKeyById: (keyId) => gate.runShared(() => lock.run(WA_PREKEY_KEY, () => store.consumePreKeyById(keyId))),
+        getOrGenSinglePreKey: (generator) => gate.runShared(() => lock.run(WA_PREKEY_KEY, () => store.getOrGenSinglePreKey(generator))),
+        markKeyAsUploaded: (keyId) => gate.runShared(() => lock.run(WA_PREKEY_KEY, () => store.markKeyAsUploaded(keyId))),
+        setServerHasPreKeys: (value) => gate.runShared(() => lock.run(WA_PREKEY_SERVER_KEY, () => store.setServerHasPreKeys(value))),
+        getServerHasPreKeys: () => gate.runShared(() => store.getServerHasPreKeys()),
+        clear: () => gate.runExclusive(() => lock.run(WA_PREKEY_CLEAR_KEY, () => store.clear())),
+        destroy: async () => {
+            await gate.close();
+            await lock.shutdown();
+            await destroyStore.destroy?.();
+        }
+    };
+}

package/dist/store/locks/session.lock.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withSessionLock = withSessionLock;
+const SharedExclusiveGate_1 = require("../../infra/perf/SharedExclusiveGate");
+function withSessionLock(store) {
+    const gate = new SharedExclusiveGate_1.SharedExclusiveGate();
+    const destroyStore = store;
+    return {
+        hasSession: (address) => gate.runShared(() => store.hasSession(address)),
+        hasSessions: (addresses) => gate.runShared(() => store.hasSessions(addresses)),
+        getSession: (address) => gate.runShared(() => store.getSession(address)),
+        getSessionsBatch: (addresses) => gate.runShared(() => store.getSessionsBatch(addresses)),
+        setSession: (address, session) => gate.runShared(() => store.setSession(address, session)),
+        setSessionsBatch: (entries) => gate.runShared(() => store.setSessionsBatch(entries)),
+        deleteSession: (address) => gate.runShared(() => store.deleteSession(address)),
+        clear: () => gate.runExclusive(() => store.clear()),
+        destroy: async () => {
+            await gate.close();
+            await destroyStore.destroy?.();
+        }
+    };
+}

package/dist/store/locks/signal.lock.js

@@ -5,8 +5,6 @@ const SharedExclusiveGate_1 = require("../../infra/perf/SharedExclusiveGate");
 const StoreLock_1 = require("../../infra/perf/StoreLock");
 const WA_SIGNAL_REGISTRATION_KEY = 'signal:registration';
 const WA_SIGNAL_SIGNED_PREKEY_KEY = 'signal:signedPreKey';
-const WA_SIGNAL_PREKEYS_KEY = 'signal:prekeys';
-const WA_SIGNAL_SERVER_HAS_PREKEYS_KEY = 'signal:serverHasPreKeys';
 const WA_SIGNAL_CLEAR_KEY = 'signal:clear';
 function withSignalLock(store) {
     const lock = new StoreLock_1.StoreLock();
@@ -31,28 +29,6 @@ function withSignalLock(store) {
         getSignedPreKeyById: (keyId) => gate.runShared(() => store.getSignedPreKeyById(keyId)),
         setSignedPreKeyRotationTs: (value) => gate.runShared(() => lock.run(WA_SIGNAL_SIGNED_PREKEY_KEY, () => store.setSignedPreKeyRotationTs(value))),
         getSignedPreKeyRotationTs: () => gate.runShared(() => store.getSignedPreKeyRotationTs()),
-        putPreKey: (record) => gate.runShared(() => lock.run(WA_SIGNAL_PREKEYS_KEY, () => store.putPreKey(record))),
-        getOrGenPreKeys: (count, generator) => gate.runShared(() => lock.run(WA_SIGNAL_PREKEYS_KEY, () => store.getOrGenPreKeys(count, generator))),
-        getPreKeyById: (keyId) => gate.runShared(() => store.getPreKeyById(keyId)),
-        getPreKeysById: (keyIds) => gate.runShared(() => store.getPreKeysById(keyIds)),
-        consumePreKeyById: (keyId) => gate.runShared(() => lock.run(WA_SIGNAL_PREKEYS_KEY, () => store.consumePreKeyById(keyId))),
-        getOrGenSinglePreKey: (generator) => gate.runShared(() => lock.run(WA_SIGNAL_PREKEYS_KEY, () => store.getOrGenSinglePreKey(generator))),
-        markKeyAsUploaded: (keyId) => gate.runShared(() => lock.run(WA_SIGNAL_PREKEYS_KEY, () => store.markKeyAsUploaded(keyId))),
-        setServerHasPreKeys: (value) => gate.runShared(() => lock.run(WA_SIGNAL_SERVER_HAS_PREKEYS_KEY, () => store.setServerHasPreKeys(value))),
-        getServerHasPreKeys: () => gate.runShared(() => store.getServerHasPreKeys()),
-        getSignalMeta: () => gate.runShared(() => store.getSignalMeta()),
-        hasSession: (address) => gate.runShared(() => store.hasSession(address)),
-        hasSessions: (addresses) => gate.runShared(() => store.hasSessions(addresses)),
-        getSession: (address) => gate.runShared(() => store.getSession(address)),
-        getSessionsBatch: (addresses) => gate.runShared(() => store.getSessionsBatch(addresses)),
-        // Session and identity read-modify-write semantics are serialized in SignalProtocol per address.
-        setSession: (address, session) => gate.runShared(() => store.setSession(address, session)),
-        setSessionsBatch: (entries) => gate.runShared(() => store.setSessionsBatch(entries)),
-        deleteSession: (address) => gate.runShared(() => store.deleteSession(address)),
-        getRemoteIdentity: (address) => gate.runShared(() => store.getRemoteIdentity(address)),
-        getRemoteIdentities: (addresses) => gate.runShared(() => store.getRemoteIdentities(addresses)),
-        setRemoteIdentity: (address, identityKey) => gate.runShared(() => store.setRemoteIdentity(address, identityKey)),
-        setRemoteIdentities: (entries) => gate.runShared(() => store.setRemoteIdentities(entries)),
         clear: () => gate.runExclusive(() => lock.run(WA_SIGNAL_CLEAR_KEY, async () => {
             await store.clear();
             cachedRegInfo = undefined;

package/dist/store/{providers/memory → memory}/appstate.store.js

@@ -1,11 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.WaAppStateMemoryStore = void 0;
-const constants_1 = require("../../../appstate/constants");
-const utils_1 = require("../../../appstate/utils");
-const bytes_1 = require("../../../util/bytes");
-const coercion_1 = require("../../../util/coercion");
-const collections_1 = require("../../../util/collections");
+const constants_1 = require("../../appstate/constants");
+const utils_1 = require("../../appstate/utils");
+const bytes_1 = require("../../util/bytes");
+const coercion_1 = require("../../util/coercion");
+const collections_1 = require("../../util/collections");
 const DEFAULT_APPSTATE_MEMORY_STORE_LIMITS = Object.freeze({
     syncKeys: 4096,
     collectionEntries: 50000

package/dist/store/memory/auth.store.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WaAuthMemoryStore = void 0;
+/**
+ * In-memory {@link WaAuthStore} implementation. Holds a single
+ * {@link WaAuthCredentials} per instance in a field – nothing is persisted.
+ *
+ * @sensitive Holds private key material from {@link WaAuthCredentials} in
+ * RAM. Never log instances, never `JSON.stringify`. Pairing credentials are
+ * lost when the process exits, so the next connect will re-pair from scratch
+ * (QR/link-code). Prefer a persistent backend (e.g. `@zapo-js/store-sqlite`)
+ * for production.
+ */
+class WaAuthMemoryStore {
+    constructor() {
+        this.credentials = null;
+    }
+    async load() {
+        return this.credentials;
+    }
+    async save(credentials) {
+        this.credentials = credentials;
+    }
+    async clear() {
+        this.credentials = null;
+    }
+}
+exports.WaAuthMemoryStore = WaAuthMemoryStore;

package/dist/store/memory/contact.store.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WaContactMemoryStore = void 0;
+const jid_1 = require("../../protocol/jid");
+const coercion_1 = require("../../util/coercion");
+const collections_1 = require("../../util/collections");
+const DEFAULT_CONTACT_MEMORY_STORE_LIMITS = Object.freeze({
+    contacts: 20000
+});
+function mergeContactRecords(previous, incoming) {
+    if (!previous)
+        return incoming;
+    return {
+        jid: incoming.jid,
+        displayName: incoming.displayName ?? previous.displayName,
+        pushName: incoming.pushName ?? previous.pushName,
+        lid: incoming.lid ?? previous.lid,
+        phoneNumber: incoming.phoneNumber ?? previous.phoneNumber,
+        lastUpdatedMs: Math.max(previous.lastUpdatedMs, incoming.lastUpdatedMs)
+    };
+}
+class WaContactMemoryStore {
+    constructor(options = {}) {
+        this.contacts = new Map();
+        /** Secondary index: phone_number -> primary jid (typically the LID form). */
+        this.phoneIndex = new Map();
+        this.maxContacts = (0, coercion_1.resolvePositive)(options.maxContacts, DEFAULT_CONTACT_MEMORY_STORE_LIMITS.contacts, 'WaContactMemoryStoreOptions.maxContacts');
+    }
+    writeRecord(record) {
+        const previous = this.contacts.get(record.jid);
+        const merged = mergeContactRecords(previous, record);
+        (0, collections_1.setBoundedMapEntry)(this.contacts, merged.jid, merged, this.maxContacts);
+        if (previous?.phoneNumber &&
+            previous.phoneNumber !== merged.phoneNumber &&
+            this.phoneIndex.get(previous.phoneNumber) === merged.jid) {
+            this.phoneIndex.delete(previous.phoneNumber);
+        }
+        if (merged.phoneNumber) {
+            this.phoneIndex.set(merged.phoneNumber, merged.jid);
+        }
+    }
+    async upsert(record) {
+        this.writeRecord(record);
+    }
+    async upsertBatch(records) {
+        for (const record of records) {
+            this.writeRecord(record);
+        }
+    }
+    async getByJid(jid) {
+        const direct = this.contacts.get(jid);
+        if (direct)
+            return direct;
+        if ((0, jid_1.isUserJid)(jid)) {
+            return this.getByPhoneNumberSync(jid);
+        }
+        return null;
+    }
+    async getByPhoneNumber(pn) {
+        return this.getByPhoneNumberSync(pn);
+    }
+    getByPhoneNumberSync(pn) {
+        const jid = this.phoneIndex.get(pn);
+        if (!jid)
+            return null;
+        return this.contacts.get(jid) ?? null;
+    }
+    async deleteByJid(jid) {
+        const existing = this.contacts.get(jid);
+        if (!existing)
+            return 0;
+        this.contacts.delete(jid);
+        if (existing.phoneNumber && this.phoneIndex.get(existing.phoneNumber) === jid) {
+            this.phoneIndex.delete(existing.phoneNumber);
+        }
+        return 1;
+    }
+    async clear() {
+        this.contacts.clear();
+        this.phoneIndex.clear();
+    }
+}
+exports.WaContactMemoryStore = WaContactMemoryStore;