@oxidezap/baileyrs 0.0.26 → 0.0.27

package/lib/Compatibility/public-api/message-retry-manager.js

@@ -0,0 +1,180 @@
+import { ExpiringLruMap } from '../internal/expiring-lru-map.js';
+import { makeNumericEnum } from '../internal/numeric-enum.js';
+const RECENT_MESSAGES_SIZE = 512;
+const MESSAGE_KEY_SEPARATOR = '\0';
+const RECREATE_SESSION_TIMEOUT = 60 * 60 * 1000;
+const PHONE_REQUEST_DELAY = 3000;
+const RetryReasonValues = {
+    UnknownError: 0,
+    SignalErrorNoSession: 1,
+    SignalErrorInvalidKey: 2,
+    SignalErrorInvalidKeyId: 3,
+    SignalErrorInvalidMessage: 4,
+    SignalErrorInvalidSignature: 5,
+    SignalErrorFutureMessage: 6,
+    SignalErrorBadMac: 7,
+    SignalErrorInvalidSession: 8,
+    SignalErrorInvalidMsgKey: 9,
+    BadBroadcastEphemeralSetting: 10,
+    UnknownCompanionNoPrekey: 11,
+    AdvFailure: 12,
+    StatusRevokeDelay: 13
+};
+export const RetryReason = makeNumericEnum(RetryReasonValues);
+const MAC_ERROR_CODES = new Set([RetryReason.SignalErrorInvalidMessage, RetryReason.SignalErrorBadMac]);
+export class MessageRetryManager {
+    constructor(logger, maxMsgRetryCount) {
+        this.recentMessagesMap = new ExpiringLruMap({
+            max: RECENT_MESSAGES_SIZE,
+            ttl: 5 * 60 * 1000,
+            dispose: (_value, key) => {
+                const separatorIndex = key.lastIndexOf(MESSAGE_KEY_SEPARATOR);
+                if (separatorIndex > -1)
+                    this.messageKeyIndex.delete(key.slice(separatorIndex + 1));
+            }
+        });
+        this.messageKeyIndex = new Map();
+        this.sessionRecreateHistory = new ExpiringLruMap({ ttl: RECREATE_SESSION_TIMEOUT * 2 });
+        this.retryCounters = new ExpiringLruMap({
+            ttl: 15 * 60 * 1000,
+            updateAgeOnGet: true
+        });
+        this.baseKeys = new ExpiringLruMap({ max: 1024, ttl: 15 * 60 * 1000 });
+        this.pendingPhoneRequests = {};
+        this.statistics = {
+            totalRetries: 0,
+            successfulRetries: 0,
+            failedRetries: 0,
+            mediaRetries: 0,
+            sessionRecreations: 0,
+            phoneRequests: 0
+        };
+        this.logger = logger;
+        this.maxMsgRetryCount = maxMsgRetryCount;
+    }
+    addRecentMessage(to, id, message) {
+        const keyString = this.keyToString({ to, id });
+        this.recentMessagesMap.set(keyString, { message, timestamp: Date.now() });
+        this.messageKeyIndex.set(id, keyString);
+        this.logger.debug(`Added message to retry cache: ${to}/${id}`);
+    }
+    getRecentMessage(to, id) {
+        return this.recentMessagesMap.get(this.keyToString({ to, id }));
+    }
+    shouldRecreateSession(jid, hasSession, errorCode) {
+        if (!hasSession) {
+            this.sessionRecreateHistory.set(jid, Date.now());
+            this.statistics.sessionRecreations++;
+            return { reason: "we don't have a Signal session with them", recreate: true };
+        }
+        if (errorCode !== undefined && MAC_ERROR_CODES.has(errorCode)) {
+            this.sessionRecreateHistory.set(jid, Date.now());
+            this.statistics.sessionRecreations++;
+            this.logger.warn({ jid, errorCode: RetryReason[errorCode] }, 'MAC error detected, forcing immediate session recreation');
+            return {
+                reason: `MAC error (code ${errorCode}: ${RetryReason[errorCode]}), immediate session recreation`,
+                recreate: true
+            };
+        }
+        const previous = this.sessionRecreateHistory.get(jid);
+        if (!previous || Date.now() - previous > RECREATE_SESSION_TIMEOUT) {
+            this.sessionRecreateHistory.set(jid, Date.now());
+            this.statistics.sessionRecreations++;
+            return { reason: 'retry count > 1 and over an hour since last recreation', recreate: true };
+        }
+        return { reason: '', recreate: false };
+    }
+    parseRetryErrorCode(errorAttr) {
+        if (errorAttr === undefined || errorAttr === '')
+            return undefined;
+        const code = Number.parseInt(errorAttr, 10);
+        if (Number.isNaN(code))
+            return undefined;
+        return code >= RetryReason.UnknownError && code <= RetryReason.StatusRevokeDelay
+            ? code
+            : RetryReason.UnknownError;
+    }
+    isMacError(errorCode) {
+        return errorCode !== undefined && MAC_ERROR_CODES.has(errorCode);
+    }
+    incrementRetryCount(messageId) {
+        this.retryCounters.set(messageId, (this.retryCounters.get(messageId) || 0) + 1);
+        this.statistics.totalRetries++;
+        return this.retryCounters.get(messageId);
+    }
+    getRetryCount(messageId) {
+        return this.retryCounters.get(messageId) || 0;
+    }
+    hasExceededMaxRetries(messageId) {
+        return this.getRetryCount(messageId) >= this.maxMsgRetryCount;
+    }
+    markRetrySuccess(messageId) {
+        this.statistics.successfulRetries++;
+        this.retryCounters.delete(messageId);
+        this.cancelPendingPhoneRequest(messageId);
+        this.removeRecentMessage(messageId);
+    }
+    markRetryFailed(messageId) {
+        this.statistics.failedRetries++;
+        this.retryCounters.delete(messageId);
+        this.cancelPendingPhoneRequest(messageId);
+        this.removeRecentMessage(messageId);
+    }
+    schedulePhoneRequest(messageId, callback, delay = PHONE_REQUEST_DELAY) {
+        this.cancelPendingPhoneRequest(messageId);
+        this.pendingPhoneRequests[messageId] = setTimeout(() => {
+            delete this.pendingPhoneRequests[messageId];
+            this.statistics.phoneRequests++;
+            callback();
+        }, delay);
+        this.logger.debug(`Scheduled phone request for message ${messageId} with ${delay}ms delay`);
+    }
+    cancelPendingPhoneRequest(messageId) {
+        const timeout = this.pendingPhoneRequests[messageId];
+        if (timeout) {
+            clearTimeout(timeout);
+            delete this.pendingPhoneRequests[messageId];
+            this.logger.debug(`Cancelled pending phone request for message ${messageId}`);
+        }
+    }
+    clear() {
+        this.recentMessagesMap.clear();
+        this.messageKeyIndex.clear();
+        this.sessionRecreateHistory.clear();
+        this.retryCounters.clear();
+        this.baseKeys.clear();
+        for (const messageId of Object.keys(this.pendingPhoneRequests))
+            this.cancelPendingPhoneRequest(messageId);
+        this.statistics = {
+            totalRetries: 0,
+            successfulRetries: 0,
+            failedRetries: 0,
+            mediaRetries: 0,
+            sessionRecreations: 0,
+            phoneRequests: 0
+        };
+    }
+    saveBaseKey(addr, msgId, baseKey) {
+        this.baseKeys.set(`${addr}:${msgId}`, baseKey);
+    }
+    hasSameBaseKey(addr, msgId, baseKey) {
+        const stored = this.baseKeys.get(`${addr}:${msgId}`);
+        if (!stored || stored.length !== baseKey.length)
+            return false;
+        return stored.every((byte, index) => byte === baseKey[index]);
+    }
+    deleteBaseKey(addr, msgId) {
+        this.baseKeys.delete(`${addr}:${msgId}`);
+    }
+    keyToString(key) {
+        return `${key.to}${MESSAGE_KEY_SEPARATOR}${key.id}`;
+    }
+    removeRecentMessage(messageId) {
+        const keyString = this.messageKeyIndex.get(messageId);
+        if (!keyString)
+            return;
+        this.recentMessagesMap.delete(keyString);
+        this.messageKeyIndex.delete(messageId);
+    }
+}
+//# sourceMappingURL=message-retry-manager.js.map

package/lib/Compatibility/public-api/message-retry-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-retry-manager.js","sourceRoot":"","sources":["../../../src/Compatibility/public-api/message-retry-manager.ts"],"names":[],"mappings":"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"}

package/lib/Compatibility/public-api/pre-key-manager.d.ts

@@ -0,0 +1,14 @@
+import type { SignalDataSet, SignalDataTypeMap, SignalKeyStore } from '../../Types/index.js';
+import type { ILogger } from '../../Utils/logger.js';
+/** Serializes and validates legacy Signal pre-key mutations. */
+export declare class PreKeyManager {
+    private readonly queues;
+    private readonly store;
+    private readonly logger;
+    constructor(store: SignalKeyStore, logger: ILogger);
+    private getQueue;
+    processOperations(data: SignalDataSet, keyType: keyof SignalDataTypeMap, transactionCache: SignalDataSet, mutations: SignalDataSet, isInTransaction: boolean): Promise<void>;
+    private processDeletions;
+    validateDeletions(data: SignalDataSet, keyType: keyof SignalDataTypeMap): Promise<void>;
+}
+//# sourceMappingURL=pre-key-manager.d.ts.map

package/lib/Compatibility/public-api/pre-key-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pre-key-manager.d.ts","sourceRoot":"","sources":["../../../src/Compatibility/public-api/pre-key-manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAC5F,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAA;AAEpD,gEAAgE;AAChE,qBAAa,aAAa;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiC;IACxD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAEhC,YAAY,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,OAAO,EAGjD;IAED,OAAO,CAAC,QAAQ;IASV,iBAAiB,CACtB,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,MAAM,iBAAiB,EAChC,gBAAgB,EAAE,aAAa,EAC/B,SAAS,EAAE,aAAa,EACxB,eAAe,EAAE,OAAO,GACtB,OAAO,CAAC,IAAI,CAAC,CAqBf;YAEa,gBAAgB;IA8BxB,iBAAiB,CAAC,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAc5F;CACD"}

package/lib/Compatibility/public-api/pre-key-manager.js

@@ -0,0 +1,83 @@
+import { SerialQueue } from '../internal/async-primitives.js';
+/** Serializes and validates legacy Signal pre-key mutations. */
+export class PreKeyManager {
+    constructor(store, logger) {
+        this.queues = new Map();
+        this.store = store;
+        this.logger = logger;
+    }
+    getQueue(keyType) {
+        let queue = this.queues.get(keyType);
+        if (!queue) {
+            queue = new SerialQueue();
+            this.queues.set(keyType, queue);
+        }
+        return queue;
+    }
+    async processOperations(data, keyType, transactionCache, mutations, isInTransaction) {
+        const keyData = data[keyType];
+        if (!keyData)
+            return;
+        await this.getQueue(keyType).add(async () => {
+            transactionCache[keyType] || (transactionCache[keyType] = {});
+            mutations[keyType] || (mutations[keyType] = {});
+            const deletions = [];
+            const updates = {};
+            for (const keyId in keyData) {
+                if (keyData[keyId] === null)
+                    deletions.push(keyId);
+                else
+                    updates[keyId] = keyData[keyId];
+            }
+            if (Object.keys(updates).length) {
+                Object.assign(transactionCache[keyType], updates);
+                Object.assign(mutations[keyType], updates);
+            }
+            if (deletions.length) {
+                await this.processDeletions(keyType, deletions, transactionCache, mutations, isInTransaction);
+            }
+        });
+    }
+    async processDeletions(keyType, ids, transactionCache, mutations, isInTransaction) {
+        if (isInTransaction) {
+            for (const keyId of ids) {
+                if (transactionCache[keyType]?.[keyId]) {
+                    transactionCache[keyType][keyId] = null;
+                    mutations[keyType][keyId] = null;
+                }
+                else {
+                    this.logger.warn(`Skipping deletion of non-existent ${keyType} in transaction: ${keyId}`);
+                }
+            }
+            return;
+        }
+        const existingKeys = await this.store.get(keyType, ids);
+        for (const keyId of ids) {
+            if (existingKeys[keyId]) {
+                transactionCache[keyType][keyId] = null;
+                mutations[keyType][keyId] = null;
+            }
+            else {
+                this.logger.warn(`Skipping deletion of non-existent ${keyType}: ${keyId}`);
+            }
+        }
+    }
+    async validateDeletions(data, keyType) {
+        const keyData = data[keyType];
+        if (!keyData)
+            return;
+        await this.getQueue(keyType).add(async () => {
+            const deletionIds = Object.keys(keyData).filter(id => keyData[id] === null);
+            if (!deletionIds.length)
+                return;
+            const existingKeys = await this.store.get(keyType, deletionIds);
+            for (const keyId of deletionIds) {
+                if (!existingKeys[keyId]) {
+                    this.logger.warn(`Skipping deletion of non-existent ${keyType}: ${keyId}`);
+                    delete data[keyType][keyId];
+                }
+            }
+        });
+    }
+}
+//# sourceMappingURL=pre-key-manager.js.map

package/lib/Compatibility/public-api/pre-key-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pre-key-manager.js","sourceRoot":"","sources":["../../../src/Compatibility/public-api/pre-key-manager.ts"],"names":[],"mappings":"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"}

package/lib/Compatibility/public-api/stanza-ack.d.ts

@@ -0,0 +1,4 @@
+import type { BinaryNode } from '../../Types/index.js';
+/** Build the ACK/NACK stanza corresponding to a received node. */
+export declare function buildAckStanza(node: BinaryNode, errorCode?: number, meId?: string): BinaryNode;
+//# sourceMappingURL=stanza-ack.d.ts.map

package/lib/Compatibility/public-api/stanza-ack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stanza-ack.d.ts","sourceRoot":"","sources":["../../../src/Compatibility/public-api/stanza-ack.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAEtD,kEAAkE;AAClE,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU,CAY9F"}

package/lib/Compatibility/public-api/stanza-ack.js

@@ -0,0 +1,20 @@
+/** Build the ACK/NACK stanza corresponding to a received node. */
+export function buildAckStanza(node, errorCode, meId) {
+    const { tag, attrs } = node;
+    const stanza = {
+        tag: 'ack',
+        attrs: { id: attrs.id, to: attrs.from, class: tag }
+    };
+    if (errorCode)
+        stanza.attrs.error = errorCode.toString();
+    if (attrs.participant)
+        stanza.attrs.participant = attrs.participant;
+    if (attrs.recipient)
+        stanza.attrs.recipient = attrs.recipient;
+    if (attrs.type)
+        stanza.attrs.type = attrs.type;
+    if (tag === 'message' && meId)
+        stanza.attrs.from = meId;
+    return stanza;
+}
+//# sourceMappingURL=stanza-ack.js.map

package/lib/Compatibility/public-api/stanza-ack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stanza-ack.js","sourceRoot":"","sources":["../../../src/Compatibility/public-api/stanza-ack.ts"],"names":[],"mappings":"AAEA,kEAAkE;AAClE,MAAM,UAAU,cAAc,CAAC,IAAgB,EAAE,SAAkB,EAAE,IAAa;IACjF,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,IAAI,CAAA;IAC3B,MAAM,MAAM,GAAe;QAC1B,GAAG,EAAE,KAAK;QACV,KAAK,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,EAAG,EAAE,EAAE,EAAE,KAAK,CAAC,IAAK,EAAE,KAAK,EAAE,GAAG,EAAE;KACrD,CAAA;IACD,IAAI,SAAS;QAAE,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,SAAS,CAAC,QAAQ,EAAE,CAAA;IACxD,IAAI,KAAK,CAAC,WAAW;QAAE,MAAM,CAAC,KAAK,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAA;IACnE,IAAI,KAAK,CAAC,SAAS;QAAE,MAAM,CAAC,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAA;IAC7D,IAAI,KAAK,CAAC,IAAI;QAAE,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAA;IAC9C,IAAI,GAAG,KAAK,SAAS,IAAI,IAAI;QAAE,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAA;IACvD,OAAO,MAAM,CAAA;AACd,CAAC"}

package/lib/Compatibility/signal-repository.d.ts

@@ -0,0 +1,12 @@
+import type { LIDMapping, SignalAuthState, SignalRepositoryWithLIDStore } from '../Types/index.js';
+import type { ILogger } from '../Utils/logger.js';
+import type { SocketContext } from '../Socket/types.js';
+type SignalRepositoryContext = Pick<SocketContext, 'getClient' | 'logger'>;
+export declare const jidToSignalProtocolAddressCompat: (jid: string) => string;
+export declare const bindSignalRepositoryContext: (auth: SignalAuthState, ctx: SignalRepositoryContext) => void;
+/** Default public factory; the socket binds its native context before invoking it. */
+export declare const makeDefaultSignalRepository: (auth: SignalAuthState, logger: ILogger, _pnToLIDFunc?: (jids: string[]) => Promise<LIDMapping[] | undefined>) => SignalRepositoryWithLIDStore;
+/** Translate the neutral bridge Signal surface into the public repository contract. */
+export declare const makeSignalRepository: (ctx: SignalRepositoryContext) => SignalRepositoryWithLIDStore;
+export {};
+//# sourceMappingURL=signal-repository.d.ts.map

package/lib/Compatibility/signal-repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal-repository.d.ts","sourceRoot":"","sources":["../../src/Compatibility/signal-repository.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,4BAA4B,EAAE,MAAM,mBAAmB,CAAA;AAClG,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AAUjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAEvD,KAAK,uBAAuB,GAAG,IAAI,CAAC,aAAa,EAAE,WAAW,GAAG,QAAQ,CAAC,CAAA;AAqB1E,eAAO,MAAM,gCAAgC,QAAS,MAAM,KAAG,MAa9D,CAAA;AAED,eAAO,MAAM,2BAA2B,SAAU,eAAe,OAAO,uBAAuB,SAE9F,CAAA;AAED,sFAAsF;AACtF,eAAO,MAAM,2BAA2B,SACjC,eAAe,UACb,OAAO,iBACA,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,UAAU,EAAE,GAAG,SAAS,CAAC,KAClE,4BAYA,CAAA;AAoCH,uFAAuF;AACvF,eAAO,MAAM,oBAAoB,QAAS,uBAAuB,KAAG,4BAwDlE,CAAA"}

package/lib/Compatibility/signal-repository.js

@@ -0,0 +1,131 @@
+import { isHostedLidUser, isHostedPnUser, isLidUser, isPnUser, jidDecode, jidEncode, WAJIDDomains } from '../WABinary/index.js';
+const nativeContexts = new WeakMap();
+const isPnNamespace = (jid) => isPnUser(jid) || isHostedPnUser(jid);
+const isLidNamespace = (jid) => isLidUser(jid) || isHostedLidUser(jid);
+const lidForPnDevice = (pn, lid) => {
+    const source = jidDecode(pn);
+    const target = jidDecode(lid);
+    if (!source || !target)
+        return null;
+    return jidEncode(target.user, isHostedPnUser(pn) ? 'hosted.lid' : 'lid', source.device);
+};
+const pnForLidDevice = (lid, pn) => {
+    const source = jidDecode(lid);
+    const target = jidDecode(pn);
+    if (!source || !target)
+        return null;
+    return jidEncode(target.user, isHostedLidUser(lid) ? 'hosted' : 's.whatsapp.net', source.device);
+};
+export const jidToSignalProtocolAddressCompat = (jid) => {
+    const decoded = jidDecode(jid);
+    if (!decoded?.user) {
+        throw new Error(`JID decoded but user is empty: "${jid}"`);
+    }
+    const { user, device, server, domainType } = decoded;
+    if (device === 99 && server !== 'hosted' && server !== 'hosted.lid') {
+        throw new Error('Unexpected non-hosted device JID with device 99. This ID seems invalid. ID:' + jid);
+    }
+    const signalUser = domainType !== WAJIDDomains.WHATSAPP ? `${user}_${domainType}` : user;
+    return `${signalUser}.${device || 0}`;
+};
+export const bindSignalRepositoryContext = (auth, ctx) => {
+    nativeContexts.set(auth, ctx);
+};
+/** Default public factory; the socket binds its native context before invoking it. */
+export const makeDefaultSignalRepository = (auth, logger, _pnToLIDFunc) => makeSignalRepository({
+    logger,
+    getClient: () => {
+        const ctx = nativeContexts.get(auth);
+        if (!ctx) {
+            return Promise.reject(new Error('Signal repository is not bound to an active socket; pass it through SocketConfig'));
+        }
+        return ctx.getClient();
+    }
+});
+const resolveMappings = async (client, inputs, direction, ctx) => {
+    if (inputs.length === 0)
+        return null;
+    const unique = [...new Set(inputs)].filter(jid => direction === 'pn-to-lid' ? isPnNamespace(jid) : isLidNamespace(jid));
+    const settled = await Promise.allSettled(unique.map(async (input) => {
+        if (direction === 'pn-to-lid') {
+            const resolved = await client.lidForPn(input);
+            const lid = resolved ? lidForPnDevice(input, resolved) : null;
+            return lid ? { pn: input, lid } : null;
+        }
+        const resolved = await client.pnForLid(input);
+        const pn = resolved ? pnForLidDevice(input, resolved) : null;
+        return pn ? { pn, lid: input } : null;
+    }));
+    const mappings = [];
+    for (const result of settled) {
+        if (result.status === 'fulfilled') {
+            if (result.value)
+                mappings.push(result.value);
+        }
+        else {
+            ctx.logger.debug({ err: result.reason, direction }, 'LID-PN lookup rejected — skipping');
+        }
+    }
+    return mappings.length ? mappings : null;
+};
+/** Translate the neutral bridge Signal surface into the public repository contract. */
+export const makeSignalRepository = (ctx) => ({
+    decryptMessage: async (opts) => (await ctx.getClient()).signalDecryptMessage(opts.jid, opts.type, opts.ciphertext),
+    encryptMessage: async (opts) => (await ctx.getClient()).signalEncryptMessage(opts.jid, opts.data),
+    decryptGroupMessage: async (opts) => (await ctx.getClient()).signalDecryptGroupMessage(opts.group, opts.authorJid, opts.msg),
+    encryptGroupMessage: async (opts) => (await ctx.getClient()).signalEncryptGroupMessage(opts.group, opts.data, opts.meId),
+    processSenderKeyDistributionMessage: async ({ item, authorJid }) => {
+        if (!item.groupId) {
+            throw new Error('Group ID is required for sender key distribution message');
+        }
+        const distribution = item.axolotlSenderKeyDistributionMessage;
+        if (!distribution) {
+            throw new Error('Sender key distribution payload is required');
+        }
+        await (await ctx.getClient()).signalProcessSenderKeyDistribution(item.groupId, authorJid, distribution);
+    },
+    getSenderKeyDistributionMessage: async ({ group, meId }) => (await ctx.getClient()).signalGetSenderKeyDistribution(group, meId),
+    hasSenderKey: async ({ group, meId }) => (await ctx.getClient()).signalHasSenderKey(group, meId),
+    getSessionInfo: async (jid) => (await (await ctx.getClient()).signalGetSessionInfo(jid)) ?? null,
+    injectE2ESession: async ({ jid, session }) => {
+        await (await ctx.getClient()).signalInstallPreKeyBundle(jid, session);
+    },
+    validateSession: async (jid) => ({ exists: await (await ctx.getClient()).signalValidateSession(jid) }),
+    jidToSignalProtocolAddress: jidToSignalProtocolAddressCompat,
+    migrateSession: async (fromJid, toJid) => {
+        if (!fromJid || !isLidNamespace(toJid))
+            return { migrated: 0, skipped: 0, total: 0 };
+        if (!isPnNamespace(fromJid))
+            return { migrated: 0, skipped: 0, total: 1 };
+        return (await ctx.getClient()).signalMigrateSessions(fromJid, toJid);
+    },
+    deleteSession: async (jids) => {
+        if (jids.length)
+            await (await ctx.getClient()).signalDeleteSessions(jids);
+    },
+    lidMapping: {
+        storeLIDPNMappings: async (pairs) => {
+            const valid = pairs.filter(({ lid, pn }) => {
+                const accepted = isLidNamespace(lid) && isPnNamespace(pn);
+                if (!accepted)
+                    ctx.logger.warn(`Invalid LID-PN mapping: ${lid}, ${pn}`);
+                return accepted;
+            });
+            if (valid.length)
+                await (await ctx.getClient()).addLidPnMappings(valid);
+        },
+        getLIDForPN: async (pn) => {
+            const client = await ctx.getClient();
+            return (await resolveMappings(client, [pn], 'pn-to-lid', ctx))?.[0]?.lid ?? null;
+        },
+        getLIDsForPNs: async (pns) => resolveMappings(await ctx.getClient(), pns, 'pn-to-lid', ctx),
+        getPNForLID: async (lid) => {
+            const client = await ctx.getClient();
+            return (await resolveMappings(client, [lid], 'lid-to-pn', ctx))?.[0]?.pn ?? null;
+        },
+        getPNsForLIDs: async (lids) => resolveMappings(await ctx.getClient(), lids, 'lid-to-pn', ctx),
+        close: () => undefined
+    },
+    close: () => undefined
+});
+//# sourceMappingURL=signal-repository.js.map

package/lib/Compatibility/signal-repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal-repository.js","sourceRoot":"","sources":["../../src/Compatibility/signal-repository.ts"],"names":[],"mappings":"AAGA,OAAO,EACN,eAAe,EACf,cAAc,EACd,SAAS,EACT,QAAQ,EACR,SAAS,EACT,SAAS,EACT,YAAY,EACZ,MAAM,sBAAsB,CAAA;AAK7B,MAAM,cAAc,GAAG,IAAI,OAAO,EAA4C,CAAA;AAE9E,MAAM,aAAa,GAAG,CAAC,GAAuB,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,cAAc,CAAC,GAAG,CAAC,CAAA;AACvF,MAAM,cAAc,GAAG,CAAC,GAAuB,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,eAAe,CAAC,GAAG,CAAC,CAAA;AAE1F,MAAM,cAAc,GAAG,CAAC,EAAU,EAAE,GAAW,EAAiB,EAAE;IACjE,MAAM,MAAM,GAAG,SAAS,CAAC,EAAE,CAAC,CAAA;IAC5B,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,CAAA;IAC7B,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAA;IACnC,OAAO,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,cAAc,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAA;AACxF,CAAC,CAAA;AAED,MAAM,cAAc,GAAG,CAAC,GAAW,EAAE,EAAU,EAAiB,EAAE;IACjE,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,CAAA;IAC7B,MAAM,MAAM,GAAG,SAAS,CAAC,EAAE,CAAC,CAAA;IAC5B,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAA;IACnC,OAAO,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,gBAAgB,EAAE,MAAM,CAAC,MAAM,CAAC,CAAA;AACjG,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,GAAW,EAAU,EAAE;IACvE,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,CAAA;IAC9B,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,mCAAmC,GAAG,GAAG,CAAC,CAAA;IAC3D,CAAC;IAED,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAA;IACpD,IAAI,MAAM,KAAK,EAAE,IAAI,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,YAAY,EAAE,CAAC;QACrE,MAAM,IAAI,KAAK,CAAC,6EAA6E,GAAG,GAAG,CAAC,CAAA;IACrG,CAAC;IAED,MAAM,UAAU,GAAG,UAAU,KAAK,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,UAAU,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;IACxF,OAAO,GAAG,UAAU,IAAI,MAAM,IAAI,CAAC,EAAE,CAAA;AACtC,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,IAAqB,EAAE,GAA4B,EAAE,EAAE;IAClG,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;AAC9B,CAAC,CAAA;AAED,sFAAsF;AACtF,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAC1C,IAAqB,EACrB,MAAe,EACf,YAAoE,EACrC,EAAE,CACjC,oBAAoB,CAAC;IACpB,MAAM;IACN,SAAS,EAAE,GAAG,EAAE;QACf,MAAM,GAAG,GAAG,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QACpC,IAAI,CAAC,GAAG,EAAE,CAAC;YACV,OAAO,OAAO,CAAC,MAAM,CACpB,IAAI,KAAK,CAAC,kFAAkF,CAAC,CAC7F,CAAA;QACF,CAAC;QACD,OAAO,GAAG,CAAC,SAAS,EAAE,CAAA;IACvB,CAAC;CACD,CAAC,CAAA;AAEH,MAAM,eAAe,GAAG,KAAK,EAC5B,MAA0B,EAC1B,MAAgB,EAChB,SAAoC,EACpC,GAAkC,EACH,EAAE;IACjC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IACpC,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAChD,SAAS,KAAK,WAAW,CAAC,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,CACpE,CAAA;IACD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CACvC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAC,KAAK,EAAC,EAAE;QACxB,IAAI,SAAS,KAAK,WAAW,EAAE,CAAC;YAC/B,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;YAC7C,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;YAC7D,OAAO,GAAG,CAAC,CAAC,CAAE,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAwB,CAAC,CAAC,CAAC,IAAI,CAAA;QAC9D,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;QAC7C,MAAM,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;QAC5D,OAAO,EAAE,CAAC,CAAC,CAAE,EAAE,EAAE,EAAE,GAAG,EAAE,KAAK,EAAwB,CAAC,CAAC,CAAC,IAAI,CAAA;IAC7D,CAAC,CAAC,CACF,CAAA;IACD,MAAM,QAAQ,GAAiB,EAAE,CAAA;IACjC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC9B,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;YACnC,IAAI,MAAM,CAAC,KAAK;gBAAE,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QAC9C,CAAC;aAAM,CAAC;YACP,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,mCAAmC,CAAC,CAAA;QACzF,CAAC;IACF,CAAC;IACD,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAA;AACzC,CAAC,CAAA;AAED,uFAAuF;AACvF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,GAA4B,EAAgC,EAAE,CAAC,CAAC;IACpG,cAAc,EAAE,KAAK,EAAC,IAAI,EAAC,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,oBAAoB,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC;IAChH,cAAc,EAAE,KAAK,EAAC,IAAI,EAAC,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,oBAAoB,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC;IAC/F,mBAAmB,EAAE,KAAK,EAAC,IAAI,EAAC,EAAE,CACjC,CAAC,MAAM,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,yBAAyB,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC;IACxF,mBAAmB,EAAE,KAAK,EAAC,IAAI,EAAC,EAAE,CACjC,CAAC,MAAM,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,yBAAyB,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC;IACpF,mCAAmC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE;QAClE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAA;QAC5E,CAAC;QACD,MAAM,YAAY,GAAG,IAAI,CAAC,mCAAmC,CAAA;QAC7D,IAAI,CAAC,YAAY,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAA;QAC/D,CAAC;QACD,MAAM,CAAC,MAAM,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,kCAAkC,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,YAAY,CAAC,CAAA;IACxG,CAAC;IACD,+BAA+B,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,CAC1D,CAAC,MAAM,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,8BAA8B,CAAC,KAAK,EAAE,IAAI,CAAC;IACpE,YAAY,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,kBAAkB,CAAC,KAAK,EAAE,IAAI,CAAC;IAChG,cAAc,EAAE,KAAK,EAAC,GAAG,EAAC,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI;IAC9F,gBAAgB,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE;QAC5C,MAAM,CAAC,MAAM,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,yBAAyB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;IACtE,CAAC;IACD,eAAe,EAAE,KAAK,EAAC,GAAG,EAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,qBAAqB,CAAC,GAAG,CAAC,EAAE,CAAC;IACpG,0BAA0B,EAAE,gCAAgC;IAC5D,cAAc,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;QACxC,IAAI,CAAC,OAAO,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC;YAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAA;QACpF,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC;YAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAA;QACzE,OAAO,CAAC,MAAM,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,qBAAqB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;IACrE,CAAC;IACD,aAAa,EAAE,KAAK,EAAC,IAAI,EAAC,EAAE;QAC3B,IAAI,IAAI,CAAC,MAAM;YAAE,MAAM,CAAC,MAAM,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAA;IAC1E,CAAC;IACD,UAAU,EAAE;QACX,kBAAkB,EAAE,KAAK,EAAC,KAAK,EAAC,EAAE;YACjC,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE;gBAC1C,MAAM,QAAQ,GAAG,cAAc,CAAC,GAAG,CAAC,IAAI,aAAa,CAAC,EAAE,CAAC,CAAA;gBACzD,IAAI,CAAC,QAAQ;oBAAE,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,2BAA2B,GAAG,KAAK,EAAE,EAAE,CAAC,CAAA;gBACvE,OAAO,QAAQ,CAAA;YAChB,CAAC,CAAC,CAAA;YACF,IAAI,KAAK,CAAC,MAAM;gBAAE,MAAM,CAAC,MAAM,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAA;QACxE,CAAC;QACD,WAAW,EAAE,KAAK,EAAC,EAAE,EAAC,EAAE;YACvB,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,SAAS,EAAE,CAAA;YACpC,OAAO,CAAC,MAAM,eAAe,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,WAAW,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,IAAI,CAAA;QACjF,CAAC;QACD,aAAa,EAAE,KAAK,EAAC,GAAG,EAAC,EAAE,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,SAAS,EAAE,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,CAAC;QACzF,WAAW,EAAE,KAAK,EAAC,GAAG,EAAC,EAAE;YACxB,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,SAAS,EAAE,CAAA;YACpC,OAAO,CAAC,MAAM,eAAe,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,WAAW,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,IAAI,CAAA;QACjF,CAAC;QACD,aAAa,EAAE,KAAK,EAAC,IAAI,EAAC,EAAE,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,CAAC;QAC3F,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS;KACtB;IACD,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS;CACtB,CAAC,CAAA"}

package/lib/Compatibility/socket-results.d.ts

@@ -0,0 +1,28 @@
+import type { BlocklistEntryResult, BusinessProfileResult, MembershipRequestResult, ParticipantChangeResult } from 'whatsapp-rust-bridge';
+import type { BinaryNode, WABusinessProfile } from '../Types/index.js';
+export type ParticipantUpdateResult = {
+    status: string;
+    jid: string | undefined;
+    content: BinaryNode;
+};
+export type MembershipRequestUpdateResult = {
+    status: string;
+    jid: string | undefined;
+};
+/** Translate the neutral blocklist result without exposing transport metadata. */
+export declare const bridgeBlocklistToBaileys: (entries: readonly BlocklistEntryResult[]) => Array<string | undefined>;
+/** Rebuild the public participant node from the bridge's typed response. */
+export declare const bridgeParticipantChangeToBaileys: (result: ParticipantChangeResult) => ParticipantUpdateResult;
+export declare const bridgeParticipantChangesToBaileys: (results: readonly ParticipantChangeResult[]) => ParticipantUpdateResult[];
+export declare const bridgeMembershipRequestUpdatesToBaileys: (results: readonly ParticipantChangeResult[]) => MembershipRequestUpdateResult[];
+/** Preserve the wire attribute names and string values exposed by the public socket. */
+export declare const bridgeMembershipRequestsToBaileys: (results: readonly MembershipRequestResult[]) => Array<Record<string, string>>;
+/** The bridge exposes a full invite URL; the public socket exposes only its code. */
+export declare const bridgeInviteLinkToCode: (value: string | null | undefined) => string | undefined;
+/**
+ * Translate the neutral business-profile DTO at the public compatibility
+ * boundary. The lower layers retain their own field naming and richer category
+ * collection; the public socket exposes the established single-category shape.
+ */
+export declare const bridgeBusinessProfileToBaileys: (profile: BusinessProfileResult | null | undefined) => WABusinessProfile | undefined;
+//# sourceMappingURL=socket-results.d.ts.map

package/lib/Compatibility/socket-results.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket-results.d.ts","sourceRoot":"","sources":["../../src/Compatibility/socket-results.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,uBAAuB,EACvB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,KAAK,EAAE,UAAU,EAAyB,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAE7F,MAAM,MAAM,uBAAuB,GAAG;IACrC,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;IACvB,OAAO,EAAE,UAAU,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,6BAA6B,GAAG;IAC3C,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CACvB,CAAA;AAED,kFAAkF;AAClF,eAAO,MAAM,wBAAwB,YAAa,SAAS,oBAAoB,EAAE,KAAG,KAAK,CAAC,MAAM,GAAG,SAAS,CAC5E,CAAA;AAEhC,4EAA4E;AAC5E,eAAO,MAAM,gCAAgC,WAAY,uBAAuB,KAAG,uBAyBlF,CAAA;AAED,eAAO,MAAM,iCAAiC,YACpC,SAAS,uBAAuB,EAAE,KACzC,uBAAuB,EAAmD,CAAA;AAE7E,eAAO,MAAM,uCAAuC,YAC1C,SAAS,uBAAuB,EAAE,KACzC,6BAA6B,EAAiF,CAAA;AAEjH,wFAAwF;AACxF,eAAO,MAAM,iCAAiC,YACpC,SAAS,uBAAuB,EAAE,KACzC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAI3B,CAAA;AAEJ,qFAAqF;AACrF,eAAO,MAAM,sBAAsB,UAAW,MAAM,GAAG,IAAI,GAAG,SAAS,KAAG,MAAM,GAAG,SAKlF,CAAA;AAWD;;;;GAIG;AACH,eAAO,MAAM,8BAA8B,YACjC,qBAAqB,GAAG,IAAI,GAAG,SAAS,KAC/C,iBAAiB,GAAG,SAkBtB,CAAA"}

package/lib/Compatibility/socket-results.js

@@ -0,0 +1,72 @@
+/** Translate the neutral blocklist result without exposing transport metadata. */
+export const bridgeBlocklistToBaileys = (entries) => entries.map(entry => entry.jid);
+/** Rebuild the public participant node from the bridge's typed response. */
+export const bridgeParticipantChangeToBaileys = (result) => {
+    const attrs = {
+        jid: result.jid,
+        ...(result.status === undefined ? {} : { type: result.status }),
+        ...(result.error === undefined ? {} : { error: result.error }),
+        ...(result.phoneNumber === undefined ? {} : { phone_number: result.phoneNumber }),
+        ...(result.username === undefined ? {} : { username: result.username })
+    };
+    const addRequest = result.addRequest;
+    const content = {
+        tag: 'participant',
+        attrs,
+        ...(addRequest === undefined
+            ? {}
+            : {
+                content: [
+                    {
+                        tag: 'add_request',
+                        attrs: { code: addRequest.code, expiration: String(addRequest.expiration) }
+                    }
+                ]
+            })
+    };
+    return { status: result.error || '200', jid: result.jid, content };
+};
+export const bridgeParticipantChangesToBaileys = (results) => results.map(bridgeParticipantChangeToBaileys);
+export const bridgeMembershipRequestUpdatesToBaileys = (results) => results.map(result => ({ status: result.error || '200', jid: result.jid }));
+/** Preserve the wire attribute names and string values exposed by the public socket. */
+export const bridgeMembershipRequestsToBaileys = (results) => results.map(result => ({
+    jid: result.jid,
+    ...(result.requestTime === undefined ? {} : { request_time: String(result.requestTime) })
+}));
+/** The bridge exposes a full invite URL; the public socket exposes only its code. */
+export const bridgeInviteLinkToCode = (value) => {
+    if (!value)
+        return undefined;
+    const match = /^https?:\/\/chat\.whatsapp\.com\/(?:invite\/)?([^/?#]+)/i.exec(value);
+    return match?.[1] || value;
+};
+const bridgeBusinessHoursConfigToBaileys = (config) => ({
+    day_of_week: config.dayOfWeek,
+    mode: config.mode,
+    ...(config.openTime === undefined ? {} : { open_time: config.openTime }),
+    ...(config.closeTime === undefined ? {} : { close_time: config.closeTime })
+});
+/**
+ * Translate the neutral business-profile DTO at the public compatibility
+ * boundary. The lower layers retain their own field naming and richer category
+ * collection; the public socket exposes the established single-category shape.
+ */
+export const bridgeBusinessProfileToBaileys = (profile) => {
+    if (!profile)
+        return undefined;
+    const businessConfig = profile.businessHours.businessConfig?.map(bridgeBusinessHoursConfigToBaileys);
+    const category = profile.categories[0]?.name;
+    return {
+        description: profile.description,
+        email: profile.email,
+        business_hours: {
+            ...(profile.businessHours.timezone === undefined ? {} : { timezone: profile.businessHours.timezone }),
+            ...(businessConfig === undefined ? {} : { business_config: businessConfig })
+        },
+        website: [...profile.website],
+        ...(category === undefined ? {} : { category }),
+        ...(profile.wid === undefined ? {} : { wid: profile.wid }),
+        ...(profile.address === undefined ? {} : { address: profile.address })
+    };
+};
+//# sourceMappingURL=socket-results.js.map

package/lib/Compatibility/socket-results.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket-results.js","sourceRoot":"","sources":["../../src/Compatibility/socket-results.ts"],"names":[],"mappings":"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"}

package/lib/Compatibility/stanza-responses.d.ts

@@ -0,0 +1,13 @@
+import type { WasmWhatsAppClient } from 'whatsapp-rust-bridge';
+import type { BinaryNode } from '../Types/index.js';
+type StanzaResponseClient = Pick<WasmWhatsAppClient, 'acknowledgeStanza' | 'rejectStanza' | 'requestMessageRetry'>;
+export interface StanzaResponseContext {
+    getClient: () => Promise<StanzaResponseClient>;
+}
+/** Translate the public socket calls into the core-owned response operations. */
+export declare const makeStanzaResponseMethods: ({ getClient }: StanzaResponseContext) => {
+    sendMessageAck: (node: BinaryNode, errorCode?: number) => Promise<void>;
+    sendRetryRequest: (node: BinaryNode, forceIncludeKeys?: boolean) => Promise<void>;
+};
+export {};
+//# sourceMappingURL=stanza-responses.d.ts.map

package/lib/Compatibility/stanza-responses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stanza-responses.d.ts","sourceRoot":"","sources":["../../src/Compatibility/stanza-responses.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAEnD,KAAK,oBAAoB,GAAG,IAAI,CAAC,kBAAkB,EAAE,mBAAmB,GAAG,cAAc,GAAG,qBAAqB,CAAC,CAAA;AAElH,MAAM,WAAW,qBAAqB;IACrC,SAAS,EAAE,MAAM,OAAO,CAAC,oBAAoB,CAAC,CAAA;CAC9C;AAED,iFAAiF;AACjF,eAAO,MAAM,yBAAyB,kBAAmB,qBAAqB;IAC7E,cAAc,SAAe,UAAU,cAAc,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;IAQ3E,gBAAgB,SAAe,UAAU,iCAA6B,OAAO,CAAC,IAAI,CAAC;CAGlF,CAAA"}