@lynovratech/baileys 1.0.0

package/lib/esm/Signal/Group/sender-key-state.js

@@ -0,0 +1,84 @@
+import { SenderChainKey } from './sender-chain-key.js';
+import { SenderMessageKey } from './sender-message-key.js';
+export class SenderKeyState {
+    constructor(id, iteration, chainKey, signatureKeyPair, signatureKeyPublic, signatureKeyPrivate, senderKeyStateStructure) {
+        this.MAX_MESSAGE_KEYS = 2000;
+        if (senderKeyStateStructure) {
+            this.senderKeyStateStructure = {
+                ...senderKeyStateStructure,
+                senderMessageKeys: Array.isArray(senderKeyStateStructure.senderMessageKeys)
+                    ? senderKeyStateStructure.senderMessageKeys
+                    : []
+            };
+        }
+        else {
+            if (signatureKeyPair) {
+                signatureKeyPublic = signatureKeyPair.public;
+                signatureKeyPrivate = signatureKeyPair.private;
+            }
+            this.senderKeyStateStructure = {
+                senderKeyId: id || 0,
+                senderChainKey: {
+                    iteration: iteration || 0,
+                    seed: Buffer.from(chainKey || [])
+                },
+                senderSigningKey: {
+                    public: Buffer.from(signatureKeyPublic || []),
+                    private: Buffer.from(signatureKeyPrivate || [])
+                },
+                senderMessageKeys: []
+            };
+        }
+    }
+    getKeyId() {
+        return this.senderKeyStateStructure.senderKeyId;
+    }
+    getSenderChainKey() {
+        return new SenderChainKey(this.senderKeyStateStructure.senderChainKey.iteration, this.senderKeyStateStructure.senderChainKey.seed);
+    }
+    setSenderChainKey(chainKey) {
+        this.senderKeyStateStructure.senderChainKey = {
+            iteration: chainKey.getIteration(),
+            seed: chainKey.getSeed()
+        };
+    }
+    getSigningKeyPublic() {
+        const publicKey = Buffer.from(this.senderKeyStateStructure.senderSigningKey.public);
+        if (publicKey.length === 32) {
+            const fixed = Buffer.alloc(33);
+            fixed[0] = 0x05;
+            publicKey.copy(fixed, 1);
+            return fixed;
+        }
+        return publicKey;
+    }
+    getSigningKeyPrivate() {
+        const privateKey = this.senderKeyStateStructure.senderSigningKey.private;
+        return Buffer.from(privateKey || []);
+    }
+    hasSenderMessageKey(iteration) {
+        return this.senderKeyStateStructure.senderMessageKeys.some(key => key.iteration === iteration);
+    }
+    addSenderMessageKey(senderMessageKey) {
+        this.senderKeyStateStructure.senderMessageKeys.push({
+            iteration: senderMessageKey.getIteration(),
+            seed: senderMessageKey.getSeed()
+        });
+        if (this.senderKeyStateStructure.senderMessageKeys.length > this.MAX_MESSAGE_KEYS) {
+            this.senderKeyStateStructure.senderMessageKeys.shift();
+        }
+    }
+    removeSenderMessageKey(iteration) {
+        const index = this.senderKeyStateStructure.senderMessageKeys.findIndex(key => key.iteration === iteration);
+        if (index !== -1) {
+            const messageKey = this.senderKeyStateStructure.senderMessageKeys[index];
+            this.senderKeyStateStructure.senderMessageKeys.splice(index, 1);
+            return new SenderMessageKey(messageKey.iteration, messageKey.seed);
+        }
+        return null;
+    }
+    getStructure() {
+        return this.senderKeyStateStructure;
+    }
+}
+//# sourceMappingURL=sender-key-state.js.map

package/lib/esm/Signal/Group/sender-key-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sender-key-state.js","sourceRoot":"","sources":["../../../../src/Signal/Group/sender-key-state.ts"],"names":[],"mappings":"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"}

package/lib/esm/Signal/Group/sender-message-key.d.ts

@@ -0,0 +1,12 @@
+export declare class SenderMessageKey {
+    private readonly iteration;
+    private readonly iv;
+    private readonly cipherKey;
+    private readonly seed;
+    constructor(iteration: number, seed: Uint8Array);
+    getIteration(): number;
+    getIv(): Uint8Array;
+    getCipherKey(): Uint8Array;
+    getSeed(): Uint8Array;
+}
+//# sourceMappingURL=sender-message-key.d.ts.map

package/lib/esm/Signal/Group/sender-message-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sender-message-key.d.ts","sourceRoot":"","sources":["../../../../src/Signal/Group/sender-message-key.ts"],"names":[],"mappings":"AAEA,qBAAa,gBAAgB;IAC5B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAQ;IAClC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAY;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAY;gBAErB,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU;IAYxC,YAAY,IAAI,MAAM;IAItB,KAAK,IAAI,UAAU;IAInB,YAAY,IAAI,UAAU;IAI1B,OAAO,IAAI,UAAU;CAG5B"}

package/lib/esm/Signal/Group/sender-message-key.js

@@ -0,0 +1,26 @@
+import { deriveSecrets } from 'libsignal/src/crypto.js';
+export class SenderMessageKey {
+    constructor(iteration, seed) {
+        const derivative = deriveSecrets(seed, Buffer.alloc(32), Buffer.from('WhisperGroup'));
+        const keys = new Uint8Array(32);
+        keys.set(new Uint8Array(derivative[0].slice(16)));
+        keys.set(new Uint8Array(derivative[1].slice(0, 16)), 16);
+        this.iv = Buffer.from(derivative[0].slice(0, 16));
+        this.cipherKey = Buffer.from(keys.buffer);
+        this.iteration = iteration;
+        this.seed = seed;
+    }
+    getIteration() {
+        return this.iteration;
+    }
+    getIv() {
+        return this.iv;
+    }
+    getCipherKey() {
+        return this.cipherKey;
+    }
+    getSeed() {
+        return this.seed;
+    }
+}
+//# sourceMappingURL=sender-message-key.js.map

package/lib/esm/Signal/Group/sender-message-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sender-message-key.js","sourceRoot":"","sources":["../../../../src/Signal/Group/sender-message-key.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAEpD,MAAM,OAAO,gBAAgB;IAM5B,YAAY,SAAiB,EAAE,IAAgB;QAC9C,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAA;QACrF,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,CAAA;QAC/B,IAAI,CAAC,GAAG,CAAC,IAAI,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;QACjD,IAAI,CAAC,GAAG,CAAC,IAAI,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;QAExD,IAAI,CAAC,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAA;QACjD,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QACzC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IACjB,CAAC;IAEM,YAAY;QAClB,OAAO,IAAI,CAAC,SAAS,CAAA;IACtB,CAAC;IAEM,KAAK;QACX,OAAO,IAAI,CAAC,EAAE,CAAA;IACf,CAAC;IAEM,YAAY;QAClB,OAAO,IAAI,CAAC,SAAS,CAAA;IACtB,CAAC;IAEM,OAAO;QACb,OAAO,IAAI,CAAC,IAAI,CAAA;IACjB,CAAC;CACD"}

package/lib/esm/Signal/jid-mapping.d.ts

@@ -0,0 +1,50 @@
+import type { JIDMapping, SignalKeyStoreWithTransaction } from '../Types/index.js';
+import type { ILogger } from '../Utils/logger.js';
+export declare class JIDMappingStore {
+    private readonly mappingCache;
+    private readonly keys;
+    private readonly logger;
+    private pnToJIDFunc?;
+    private readonly inflightJIDLookups;
+    private readonly inflightPNLookups;
+    constructor(keys: SignalKeyStoreWithTransaction, logger: ILogger, pnToJIDFunc?: (jids: string[]) => Promise<JIDMapping[] | undefined>);
+    /**
+     * Converts a LID JID to a regular JID if possible.
+     * e.g. "1939293939393@lid" → "628xxx@s.whatsapp.net"
+     */
+    private lidToJid;
+    /**
+     * Store JID-PN mappings.
+     * Accepts both JID-style and LID-style addresses for backwards compat.
+     */
+    storeJIDPNMappings(pairs: JIDMapping[]): Promise<void>;
+    /** @deprecated use storeJIDPNMappings */
+    storeLIDPNMappings(pairs: {
+        lid: string;
+        pn: string;
+    }[]): Promise<void>;
+    /**
+     * Get the JID for a given PN. Returns the same PN as JID if no mapping found
+     * (because PN IS already a JID in our system).
+     */
+    getJIDForPN(pn: string): Promise<string | null>;
+    /** @deprecated use getJIDForPN */
+    getLIDForPN(pn: string): Promise<string | null>;
+    getJIDsForPNs(pns: string[]): Promise<JIDMapping[] | null>;
+    /** @deprecated use getJIDsForPNs */
+    getLIDsForPNs(pns: string[]): Promise<JIDMapping[] | null>;
+    private _getJIDsForPNsImpl;
+    getPNForJID(jid: string): Promise<string | null>;
+    /** @deprecated use getPNForJID */
+    getPNForLID(lid: string): Promise<string | null>;
+    getPNsForJIDs(jids: string[]): Promise<JIDMapping[] | null>;
+    /** @deprecated use getPNsForJIDs */
+    getPNsForLIDs(lids: string[]): Promise<JIDMapping[] | null>;
+    private _getPNsForJIDsImpl;
+    /**
+     * Resolve any address (JID, PN, or legacy LID) to a canonical JID.
+     * This is the main utility method for internal use.
+     */
+    resolveToJID(address: string): Promise<string>;
+}
+//# sourceMappingURL=jid-mapping.d.ts.map

package/lib/esm/Signal/jid-mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jid-mapping.d.ts","sourceRoot":"","sources":["../../../src/Signal/jid-mapping.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,UAAU,EAAE,6BAA6B,EAAE,MAAM,UAAU,CAAA;AACzE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAG9C,qBAAa,eAAe;IAC3B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAI3B;IACF,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA+B;IACpD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAEhC,OAAO,CAAC,WAAW,CAAC,CAAuD;IAE3E,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAkD;IACrF,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAkD;gBAGnF,IAAI,EAAE,6BAA6B,EACnC,MAAM,EAAE,OAAO,EACf,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,UAAU,EAAE,GAAG,SAAS,CAAC;IAOpE;;;OAGG;YACW,QAAQ;IAetB;;;OAGG;IACG,kBAAkB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA4C5D,yCAAyC;IACnC,kBAAkB,CAAC,KAAK,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7E;;;OAGG;IACG,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAIrD,kCAAkC;IAC5B,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAI/C,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC;IAmBhE,oCAAoC;IAC9B,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC;YAIlD,kBAAkB;IAsB1B,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAItD,kCAAkC;IAC5B,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAShD,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC;IAmBjE,oCAAoC;IAC9B,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC;YAInD,kBAAkB;IAwBhC;;;OAGG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAWpD"}

package/lib/esm/Signal/jid-mapping.js

@@ -0,0 +1,214 @@
+/**
+ * JID Mapping Store
+ *
+ * Replaces the old LID mapping system. Instead of mapping phone numbers (PN)
+ * to random LID identifiers, we now use JIDs directly (e.g. 628xxx@s.whatsapp.net).
+ *
+ * The store still handles cases where the server sends LID addresses by
+ * transparently converting them to JIDs on the fly.
+ */
+import { LRUCache } from 'lru-cache';
+import { isHostedPnUser, isLidUser, isPnUser, jidDecode, jidNormalizedUser, jidEncode } from '../WABinary/index.js';
+export class JIDMappingStore {
+    constructor(keys, logger, pnToJIDFunc) {
+        this.mappingCache = new LRUCache({
+            ttl: 3 * 24 * 60 * 60 * 1000,
+            ttlAutopurge: true,
+            updateAgeOnGet: true
+        });
+        this.inflightJIDLookups = new Map();
+        this.inflightPNLookups = new Map();
+        this.keys = keys;
+        this.pnToJIDFunc = pnToJIDFunc;
+        this.logger = logger;
+    }
+    /**
+     * Converts a LID JID to a regular JID if possible.
+     * e.g. "1939293939393@lid" → "628xxx@s.whatsapp.net"
+     */
+    async lidToJid(lid) {
+        if (!isLidUser(lid))
+            return null;
+        const decoded = jidDecode(lid);
+        if (!decoded)
+            return null;
+        const cached = this.mappingCache.get(`lid:${decoded.user}`);
+        if (cached)
+            return cached;
+        const stored = await this.keys.get('jid-mapping', [`lid:${decoded.user}`]);
+        const jid = stored[`lid:${decoded.user}`];
+        if (jid) {
+            this.mappingCache.set(`lid:${decoded.user}`, jid);
+            return jid;
+        }
+        return null;
+    }
+    /**
+     * Store JID-PN mappings.
+     * Accepts both JID-style and LID-style addresses for backwards compat.
+     */
+    async storeJIDPNMappings(pairs) {
+        if (pairs.length === 0)
+            return;
+        const batchData = {};
+        for (const pair of pairs) {
+            // pair.jid may be a real JID or a legacy LID address
+            let jid = pair.jid;
+            const pn = pair.pn;
+            if (!pn || !jid)
+                continue;
+            const pnDecoded = jidDecode(pn);
+            if (!pnDecoded)
+                continue;
+            // If jid is actually a LID, store a lid→pn entry too
+            if (isLidUser(jid)) {
+                const lidDecoded = jidDecode(jid);
+                if (lidDecoded) {
+                    const pnJid = `${pnDecoded.user}@s.whatsapp.net`;
+                    batchData[`lid:${lidDecoded.user}`] = pnJid;
+                    this.mappingCache.set(`lid:${lidDecoded.user}`, pnJid);
+                    this.logger.debug({ lid: jid, jid: pnJid }, 'Stored LID→JID mapping');
+                }
+                continue;
+            }
+            // Standard PN→JID mapping
+            const jidDecoded = jidDecode(jid);
+            if (!jidDecoded)
+                continue;
+            const normalizedJid = `${jidDecoded.user}@s.whatsapp.net`;
+            batchData[`pn:${pnDecoded.user}`] = normalizedJid;
+            batchData[`jid:${jidDecoded.user}`] = `${pnDecoded.user}@s.whatsapp.net`;
+            this.mappingCache.set(`pn:${pnDecoded.user}`, normalizedJid);
+            this.mappingCache.set(`jid:${jidDecoded.user}`, `${pnDecoded.user}@s.whatsapp.net`);
+        }
+        if (Object.keys(batchData).length === 0)
+            return;
+        await this.keys.transaction(async () => {
+            await this.keys.set({ 'jid-mapping': batchData });
+        }, 'jid-mapping');
+    }
+    /** @deprecated use storeJIDPNMappings */
+    async storeLIDPNMappings(pairs) {
+        return this.storeJIDPNMappings(pairs.map(p => ({ jid: p.lid, pn: p.pn })));
+    }
+    /**
+     * Get the JID for a given PN. Returns the same PN as JID if no mapping found
+     * (because PN IS already a JID in our system).
+     */
+    async getJIDForPN(pn) {
+        return (await this.getJIDsForPNs([pn]))?.[0]?.jid || null;
+    }
+    /** @deprecated use getJIDForPN */
+    async getLIDForPN(pn) {
+        return this.getJIDForPN(pn);
+    }
+    async getJIDsForPNs(pns) {
+        if (pns.length === 0)
+            return null;
+        const sortedPns = [...new Set(pns)].sort();
+        const cacheKey = sortedPns.join(',');
+        const inflight = this.inflightJIDLookups.get(cacheKey);
+        if (inflight)
+            return inflight;
+        const promise = this._getJIDsForPNsImpl(pns);
+        this.inflightJIDLookups.set(cacheKey, promise);
+        try {
+            return await promise;
+        }
+        finally {
+            this.inflightJIDLookups.delete(cacheKey);
+        }
+    }
+    /** @deprecated use getJIDsForPNs */
+    async getLIDsForPNs(pns) {
+        return this.getJIDsForPNs(pns);
+    }
+    async _getJIDsForPNsImpl(pns) {
+        const results = [];
+        for (const pn of pns) {
+            if (!isPnUser(pn) && !isHostedPnUser(pn))
+                continue;
+            const decoded = jidDecode(pn);
+            if (!decoded)
+                continue;
+            // In JID-first mode, the PN is already a valid JID
+            const normalizedJid = `${decoded.user}@s.whatsapp.net`;
+            // Check if we have a cached different JID for this PN
+            const cached = this.mappingCache.get(`pn:${decoded.user}`);
+            const jid = cached || normalizedJid;
+            results.push({ pn, jid });
+        }
+        return results.length > 0 ? results : null;
+    }
+    async getPNForJID(jid) {
+        return (await this.getPNsForJIDs([jid]))?.[0]?.pn || null;
+    }
+    /** @deprecated use getPNForJID */
+    async getPNForLID(lid) {
+        // If it's a real LID, try to resolve it
+        if (isLidUser(lid)) {
+            const resolved = await this.lidToJid(lid);
+            return resolved || null;
+        }
+        return this.getPNForJID(lid);
+    }
+    async getPNsForJIDs(jids) {
+        if (jids.length === 0)
+            return null;
+        const sortedJids = [...new Set(jids)].sort();
+        const cacheKey = sortedJids.join(',');
+        const inflight = this.inflightPNLookups.get(cacheKey);
+        if (inflight)
+            return inflight;
+        const promise = this._getPNsForJIDsImpl(jids);
+        this.inflightPNLookups.set(cacheKey, promise);
+        try {
+            return await promise;
+        }
+        finally {
+            this.inflightPNLookups.delete(cacheKey);
+        }
+    }
+    /** @deprecated use getPNsForJIDs */
+    async getPNsForLIDs(lids) {
+        return this.getPNsForJIDs(lids);
+    }
+    async _getPNsForJIDsImpl(jids) {
+        const results = [];
+        for (const jid of jids) {
+            // Handle legacy LID addresses
+            if (isLidUser(jid)) {
+                const resolved = await this.lidToJid(jid);
+                if (resolved) {
+                    results.push({ jid: resolved, pn: resolved });
+                }
+                continue;
+            }
+            const decoded = jidDecode(jid);
+            if (!decoded)
+                continue;
+            // In JID-first mode, JID == PN, just normalise
+            const pn = `${decoded.user}@s.whatsapp.net`;
+            results.push({ jid, pn });
+        }
+        return results.length > 0 ? results : null;
+    }
+    /**
+     * Resolve any address (JID, PN, or legacy LID) to a canonical JID.
+     * This is the main utility method for internal use.
+     */
+    async resolveToJID(address) {
+        if (isLidUser(address)) {
+            const resolved = await this.lidToJid(address);
+            if (resolved)
+                return resolved;
+            this.logger.warn({ address }, 'Could not resolve LID to JID, returning as-is');
+            return address;
+        }
+        const decoded = jidDecode(address);
+        if (!decoded)
+            return address;
+        return `${decoded.user}@s.whatsapp.net`;
+    }
+}
+//# sourceMappingURL=jid-mapping.js.map

package/lib/esm/Signal/jid-mapping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jid-mapping.js","sourceRoot":"","sources":["../../../src/Signal/jid-mapping.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAGpC,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAE1G,MAAM,OAAO,eAAe;IAc3B,YACC,IAAmC,EACnC,MAAe,EACf,WAAmE;QAhBnD,iBAAY,GAAG,IAAI,QAAQ,CAAiB;YAC5D,GAAG,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI;YAC5B,YAAY,EAAE,IAAI;YAClB,cAAc,EAAE,IAAI;SACpB,CAAC,CAAA;QAMe,uBAAkB,GAAG,IAAI,GAAG,EAAwC,CAAA;QACpE,sBAAiB,GAAG,IAAI,GAAG,EAAwC,CAAA;QAOnF,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAA;QAC9B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACrB,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,QAAQ,CAAC,GAAW;QACjC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC;YAAE,OAAO,IAAI,CAAA;QAChC,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,CAAA;QAC9B,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAA;QACzB,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC,CAAA;QAC3D,IAAI,MAAM;YAAE,OAAO,MAAM,CAAA;QACzB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;QAC1E,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC,CAAA;QACzC,IAAI,GAAG,EAAE,CAAC;YACT,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,OAAO,CAAC,IAAI,EAAE,EAAE,GAAG,CAAC,CAAA;YACjD,OAAO,GAAG,CAAA;QACX,CAAC;QACD,OAAO,IAAI,CAAA;IACZ,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,kBAAkB,CAAC,KAAmB;QAC3C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAM;QAE9B,MAAM,SAAS,GAA8B,EAAE,CAAA;QAC/C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YAC1B,qDAAqD;YACrD,IAAI,GAAG,GAAG,IAAI,CAAC,GAAG,CAAA;YAClB,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAA;YAElB,IAAI,CAAC,EAAE,IAAI,CAAC,GAAG;gBAAE,SAAQ;YAEzB,MAAM,SAAS,GAAG,SAAS,CAAC,EAAE,CAAC,CAAA;YAC/B,IAAI,CAAC,SAAS;gBAAE,SAAQ;YAExB,qDAAqD;YACrD,IAAI,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;gBACpB,MAAM,UAAU,GAAG,SAAS,CAAC,GAAG,CAAC,CAAA;gBACjC,IAAI,UAAU,EAAE,CAAC;oBAChB,MAAM,KAAK,GAAG,GAAG,SAAS,CAAC,IAAI,iBAAiB,CAAA;oBAChD,SAAS,CAAC,OAAO,UAAU,CAAC,IAAI,EAAE,CAAC,GAAG,KAAK,CAAA;oBAC3C,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,UAAU,CAAC,IAAI,EAAE,EAAE,KAAK,CAAC,CAAA;oBACtD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,wBAAwB,CAAC,CAAA;gBACtE,CAAC;gBACD,SAAQ;YACT,CAAC;YAED,0BAA0B;YAC1B,MAAM,UAAU,GAAG,SAAS,CAAC,GAAG,CAAC,CAAA;YACjC,IAAI,CAAC,UAAU;gBAAE,SAAQ;YAEzB,MAAM,aAAa,GAAG,GAAG,UAAU,CAAC,IAAI,iBAAiB,CAAA;YACzD,SAAS,CAAC,MAAM,SAAS,CAAC,IAAI,EAAE,CAAC,GAAG,aAAa,CAAA;YACjD,SAAS,CAAC,OAAO,UAAU,CAAC,IAAI,EAAE,CAAC,GAAG,GAAG,SAAS,CAAC,IAAI,iBAAiB,CAAA;YACxE,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,SAAS,CAAC,IAAI,EAAE,EAAE,aAAa,CAAC,CAAA;YAC5D,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,UAAU,CAAC,IAAI,EAAE,EAAE,GAAG,SAAS,CAAC,IAAI,iBAAiB,CAAC,CAAA;QACpF,CAAC;QAED,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,KAAK,CAAC;YAAE,OAAM;QAE/C,MAAM,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,IAAI,EAAE;YACtC,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC,CAAA;QAClD,CAAC,EAAE,aAAa,CAAC,CAAA;IAClB,CAAC;IAED,yCAAyC;IACzC,KAAK,CAAC,kBAAkB,CAAC,KAAoC;QAC5D,OAAO,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAA;IAC3E,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,WAAW,CAAC,EAAU;QAC3B,OAAO,CAAC,MAAM,IAAI,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,IAAI,CAAA;IAC1D,CAAC;IAED,kCAAkC;IAClC,KAAK,CAAC,WAAW,CAAC,EAAU;QAC3B,OAAO,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAA;IAC5B,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,GAAa;QAChC,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAA;QAEjC,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;QAC1C,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAEpC,MAAM,QAAQ,GAAG,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QACtD,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAA;QAE7B,MAAM,OAAO,GAAG,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAA;QAC5C,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;QAE9C,IAAI,CAAC;YACJ,OAAO,MAAM,OAAO,CAAA;QACrB,CAAC;gBAAS,CAAC;YACV,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;QACzC,CAAC;IACF,CAAC;IAED,oCAAoC;IACpC,KAAK,CAAC,aAAa,CAAC,GAAa;QAChC,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAA;IAC/B,CAAC;IAEO,KAAK,CAAC,kBAAkB,CAAC,GAAa;QAC7C,MAAM,OAAO,GAAiB,EAAE,CAAA;QAEhC,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;YACtB,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC;gBAAE,SAAQ;YAElD,MAAM,OAAO,GAAG,SAAS,CAAC,EAAE,CAAC,CAAA;YAC7B,IAAI,CAAC,OAAO;gBAAE,SAAQ;YAEtB,mDAAmD;YACnD,MAAM,aAAa,GAAG,GAAG,OAAO,CAAC,IAAI,iBAAiB,CAAA;YAEtD,sDAAsD;YACtD,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC,CAAA;YAC1D,MAAM,GAAG,GAAG,MAAM,IAAI,aAAa,CAAA;YAEnC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,CAAA;QAC1B,CAAC;QAED,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAA;IAC3C,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,GAAW;QAC5B,OAAO,CAAC,MAAM,IAAI,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,IAAI,CAAA;IAC1D,CAAC;IAED,kCAAkC;IAClC,KAAK,CAAC,WAAW,CAAC,GAAW;QAC5B,wCAAwC;QACxC,IAAI,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;YACpB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA;YACzC,OAAO,QAAQ,IAAI,IAAI,CAAA;QACxB,CAAC;QACD,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAA;IAC7B,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,IAAc;QACjC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAA;QAElC,MAAM,UAAU,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;QAC5C,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAErC,MAAM,QAAQ,GAAG,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QACrD,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAA;QAE7B,MAAM,OAAO,GAAG,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAA;QAC7C,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;QAE7C,IAAI,CAAC;YACJ,OAAO,MAAM,OAAO,CAAA;QACrB,CAAC;gBAAS,CAAC;YACV,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;QACxC,CAAC;IACF,CAAC;IAED,oCAAoC;IACpC,KAAK,CAAC,aAAa,CAAC,IAAc;QACjC,OAAO,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAA;IAChC,CAAC;IAEO,KAAK,CAAC,kBAAkB,CAAC,IAAc;QAC9C,MAAM,OAAO,GAAiB,EAAE,CAAA;QAEhC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACxB,8BAA8B;YAC9B,IAAI,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;gBACpB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA;gBACzC,IAAI,QAAQ,EAAE,CAAC;oBACd,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAA;gBAC9C,CAAC;gBACD,SAAQ;YACT,CAAC;YAED,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,CAAA;YAC9B,IAAI,CAAC,OAAO;gBAAE,SAAQ;YAEtB,+CAA+C;YAC/C,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,iBAAiB,CAAA;YAC3C,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,CAAA;QAC1B,CAAC;QAED,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAA;IAC3C,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,YAAY,CAAC,OAAe;QACjC,IAAI,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;YACxB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;YAC7C,IAAI,QAAQ;gBAAE,OAAO,QAAQ,CAAA;YAC7B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,EAAE,+CAA+C,CAAC,CAAA;YAC9E,OAAO,OAAO,CAAA;QACf,CAAC;QACD,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC,CAAA;QAClC,IAAI,CAAC,OAAO;YAAE,OAAO,OAAO,CAAA;QAC5B,OAAO,GAAG,OAAO,CAAC,IAAI,iBAAiB,CAAA;IACxC,CAAC;CACD"}

package/lib/esm/Signal/libsignal.d.ts

@@ -0,0 +1,7 @@
+import type { JIDMapping, LIDMapping, SignalAuthState } from '../Types/index.js';
+import type { SignalRepositoryWithJIDStore } from '../Types/Signal.js';
+import type { ILogger } from '../Utils/logger.js';
+export declare function makeLibSignalRepository(auth: SignalAuthState, logger: ILogger, pnToJIDFunc?: (jids: string[]) => Promise<JIDMapping[] | undefined>, 
+/** @deprecated use pnToJIDFunc */
+pnToLIDFunc?: (jids: string[]) => Promise<LIDMapping[] | undefined>): SignalRepositoryWithJIDStore;
+//# sourceMappingURL=libsignal.d.ts.map

package/lib/esm/Signal/libsignal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"libsignal.d.ts","sourceRoot":"","sources":["../../../src/Signal/libsignal.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,eAAe,EAAiC,MAAM,UAAU,CAAA;AACtG,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,iBAAiB,CAAA;AAEnE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AA2C9C,wBAAgB,uBAAuB,CACtC,IAAI,EAAE,eAAe,EACrB,MAAM,EAAE,OAAO,EACf,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,UAAU,EAAE,GAAG,SAAS,CAAC;AACnE,kCAAkC;AAClC,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,UAAU,EAAE,GAAG,SAAS,CAAC,GACjE,4BAA4B,CAiU9B"}