@nerxa/socketon 0.0.0-stage → 1.21.0

package/src/Signal/libsignal.d.ts

@@ -0,0 +1,54 @@
+export function makeLibSignalRepository(auth: any, logger: any, pnToLIDFunc: any): {
+    decryptGroupMessage({ group, authorJid, msg }: {
+        group: any;
+        authorJid: any;
+        msg: any;
+    }): any;
+    processSenderKeyDistributionMessage({ item, authorJid }: {
+        item: any;
+        authorJid: any;
+    }): Promise<any>;
+    decryptMessage({ jid, type, ciphertext }: {
+        jid: any;
+        type: any;
+        ciphertext: any;
+    }): Promise<any>;
+    encryptMessage({ jid, data }: {
+        jid: any;
+        data: any;
+    }): Promise<any>;
+    encryptGroupMessage({ group, meId, data }: {
+        group: any;
+        meId: any;
+        data: any;
+    }): Promise<any>;
+    getSenderKeyDistributionMessage({ group, meId }: {
+        group: any;
+        meId: any;
+    }): Promise<any>;
+    hasSenderKey({ group, meId }: {
+        group: any;
+        meId: any;
+    }): Promise<boolean>;
+    getSessionInfo(jid: any): Promise<{
+        baseKey: Uint8Array<any>;
+        registrationId: number;
+    } | null>;
+    injectE2ESession({ jid, session }: {
+        jid: any;
+        session: any;
+    }): Promise<any>;
+    jidToSignalProtocolAddress(jid: any): any;
+    lidMapping: LIDMappingStore;
+    validateSession(jid: any): Promise<{
+        exists: boolean;
+        reason: string;
+    } | {
+        exists: boolean;
+        reason?: undefined;
+    }>;
+    deleteSession(jids: any): Promise<any>;
+    close(): void;
+    migrateSession(fromJid: any, toJid: any): Promise<any>;
+};
+import { LIDMappingStore } from './lid-mapping.js';

package/src/Signal/libsignal.js

@@ -0,0 +1,427 @@
+import * as libsignal from 'libsignal';
+
+import { PreKeyWhisperMessage } from 'libsignal/src/protobufs.js';
+import { LRUCache } from 'lru-cache';
+import { generateSignalPubKey } from '../Utils/index.js';
+import { isHostedLidUser, isHostedPnUser, isLidUser, isPnUser, jidDecode, transferDevice, WAJIDDomains } from '../WABinary/index.js';
+import { SenderKeyName } from './Group/sender-key-name.js';
+import { SenderKeyRecord } from './Group/sender-key-record.js';
+import { GroupCipher, GroupSessionBuilder, SenderKeyDistributionMessage } from './Group/index.js';
+import { LIDMappingStore } from './lid-mapping.js';
+
+function extractIdentityFromPkmsg(ciphertext) {
+    try {
+        if (!ciphertext || ciphertext.length < 2) {
+            return undefined;
+        }
+
+        const version = ciphertext[0];
+        if ((version & 0xf) !== 3) {
+            return undefined;
+        }
+
+        const preKeyProto = PreKeyWhisperMessage.decode(ciphertext.slice(1));
+        if (preKeyProto.identityKey?.length === 33) {
+            return new Uint8Array(preKeyProto.identityKey);
+        }
+        return undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+export function makeLibSignalRepository(auth, logger, pnToLIDFunc) {
+    const lidMapping = new LIDMappingStore(auth.keys, logger, pnToLIDFunc);
+    const storage = signalStorage(auth, lidMapping);
+    const parsedKeys = auth.keys;
+    const migratedSessionCache = new LRUCache({
+        ttl: 3 * 24 * 60 * 60 * 1000,
+        ttlAutopurge: true,
+        updateAgeOnGet: true
+    });
+    const ensureSenderKeyAndCreateSkdm = async (group, meId) => {
+        const senderName = jidToSignalSenderKeyName(group, meId);
+        const senderNameStr = senderName.toString();
+        const { [senderNameStr]: senderKey } = await auth.keys.get('sender-key', [senderNameStr]);
+        if (!senderKey) {
+            await storage.storeSenderKey(senderName, new SenderKeyRecord());
+        }
+        const skdm = await new GroupSessionBuilder(storage).create(senderName);
+        return { senderName, skdm };
+    };
+    const repository = {
+        decryptGroupMessage({ group, authorJid, msg }) {
+            const senderName = jidToSignalSenderKeyName(group, authorJid);
+            const cipher = new GroupCipher(storage, senderName);
+
+            return parsedKeys.transaction(async () => {
+                return cipher.decrypt(msg);
+            }, group);
+        },
+        async processSenderKeyDistributionMessage({ item, authorJid }) {
+            const builder = new GroupSessionBuilder(storage);
+            if (!item.groupId) {
+                throw new Error('Group ID is required for sender key distribution message');
+            }
+            const senderName = jidToSignalSenderKeyName(item.groupId, authorJid);
+            const senderMsg = new SenderKeyDistributionMessage(null, null, null, null, item.axolotlSenderKeyDistributionMessage);
+            const senderNameStr = senderName.toString();
+            const { [senderNameStr]: senderKey } = await auth.keys.get('sender-key', [senderNameStr]);
+            if (!senderKey) {
+                await storage.storeSenderKey(senderName, new SenderKeyRecord());
+            }
+            return parsedKeys.transaction(async () => {
+                const { [senderNameStr]: senderKey } = await auth.keys.get('sender-key', [senderNameStr]);
+                if (!senderKey) {
+                    await storage.storeSenderKey(senderName, new SenderKeyRecord());
+                }
+                await builder.process(senderName, senderMsg);
+            }, item.groupId);
+        },
+        async decryptMessage({ jid, type, ciphertext }) {
+            const addr = jidToSignalProtocolAddress(jid);
+            const session = new libsignal.SessionCipher(storage, addr);
+
+            if (type === 'pkmsg') {
+                const identityKey = extractIdentityFromPkmsg(ciphertext);
+                if (identityKey) {
+                    const addrStr = addr.toString();
+                    const identityChanged = await storage.saveIdentity(addrStr, identityKey);
+                    if (identityChanged) {
+                        logger.info({ jid, addr: addrStr }, 'identity key changed or new contact, session will be re-established');
+                    }
+                }
+            }
+            async function doDecrypt() {
+                let result;
+                switch (type) {
+                    case 'pkmsg':
+                        result = await session.decryptPreKeyWhisperMessage(ciphertext);
+                        break;
+                    case 'msg':
+                        result = await session.decryptWhisperMessage(ciphertext);
+                        break;
+                }
+                return result;
+            }
+
+            return parsedKeys.transaction(async () => {
+                return await doDecrypt();
+            }, jid);
+        },
+        async encryptMessage({ jid, data }) {
+            const addr = jidToSignalProtocolAddress(jid);
+            const cipher = new libsignal.SessionCipher(storage, addr);
+
+            return parsedKeys.transaction(async () => {
+                const { type: sigType, body } = await cipher.encrypt(data);
+                const type = sigType === 3 ? 'pkmsg' : 'msg';
+                return { type, ciphertext: Buffer.from(body, 'binary') };
+            }, jid);
+        },
+        async encryptGroupMessage({ group, meId, data }) {
+            return parsedKeys.transaction(async () => {
+                const { senderName, skdm } = await ensureSenderKeyAndCreateSkdm(group, meId);
+                const ciphertext = await new GroupCipher(storage, senderName).encrypt(data);
+                return { ciphertext, senderKeyDistributionMessage: skdm.serialize() };
+            }, group);
+        },
+        async getSenderKeyDistributionMessage({ group, meId }) {
+            return parsedKeys.transaction(async () => {
+                const { skdm } = await ensureSenderKeyAndCreateSkdm(group, meId);
+                return skdm.serialize();
+            }, group);
+        },
+        async hasSenderKey({ group, meId }) {
+            const senderName = jidToSignalSenderKeyName(group, meId).toString();
+            const { [senderName]: key } = await auth.keys.get('sender-key', [senderName]);
+            return !!key;
+        },
+        async getSessionInfo(jid) {
+            const addr = jidToSignalProtocolAddress(jid).toString();
+            const session = (await storage.loadSession(addr));
+            if (!session) {
+                return null;
+            }
+            const open = session.getOpenSession?.();
+            const baseKey = open?.indexInfo?.baseKey;
+            const registrationId = open?.registrationId;
+            if (!baseKey || typeof registrationId !== 'number') {
+                return null;
+            }
+            return { baseKey: new Uint8Array(baseKey), registrationId };
+        },
+        async injectE2ESession({ jid, session }) {
+            logger.trace({ jid }, 'injecting E2EE session');
+            const cipher = new libsignal.SessionBuilder(storage, jidToSignalProtocolAddress(jid));
+            return parsedKeys.transaction(async () => {
+
+                await cipher.initOutgoing(session);
+            }, jid);
+        },
+        jidToSignalProtocolAddress(jid) {
+            return jidToSignalProtocolAddress(jid).toString();
+        },
+
+        lidMapping,
+        async validateSession(jid) {
+            try {
+                const addr = jidToSignalProtocolAddress(jid);
+                const session = await storage.loadSession(addr.toString());
+                if (!session) {
+                    return { exists: false, reason: 'no session' };
+                }
+                if (!session.haveOpenSession()) {
+                    return { exists: false, reason: 'no open session' };
+                }
+                return { exists: true };
+            }
+            catch (error) {
+                return { exists: false, reason: 'validation error' };
+            }
+        },
+        async deleteSession(jids) {
+            if (!jids.length)
+                return;
+
+            const sessionUpdates = {};
+            jids.forEach(jid => {
+                const addr = jidToSignalProtocolAddress(jid);
+                sessionUpdates[addr.toString()] = null;
+            });
+
+            return parsedKeys.transaction(async () => {
+                await auth.keys.set({ session: sessionUpdates });
+            }, `delete-${jids.length}-sessions`);
+        },
+        close() {
+            migratedSessionCache.clear();
+            lidMapping.close();
+        },
+        async migrateSession(fromJid, toJid) {
+
+            if (!fromJid || (!isLidUser(toJid) && !isHostedLidUser(toJid)))
+                return { migrated: 0, skipped: 0, total: 0 };
+
+            if (!isPnUser(fromJid) && !isHostedPnUser(fromJid)) {
+                return { migrated: 0, skipped: 0, total: 1 };
+            }
+            const { user } = jidDecode(fromJid);
+            logger.debug({ fromJid }, 'bulk device migration - loading all user devices');
+
+            const { [user]: userDevices } = await parsedKeys.get('device-list', [user]);
+            if (!userDevices) {
+                return { migrated: 0, skipped: 0, total: 0 };
+            }
+            const { device: fromDevice } = jidDecode(fromJid);
+            const fromDeviceStr = fromDevice?.toString() || '0';
+            if (!userDevices.includes(fromDeviceStr)) {
+                userDevices.push(fromDeviceStr);
+            }
+
+            const uncachedDevices = userDevices.filter(device => {
+                const deviceKey = `${user}.${device}`;
+                return !migratedSessionCache.has(deviceKey);
+            });
+
+            const deviceSessionKeys = uncachedDevices.map(device => `${user}.${device}`);
+            const existingSessions = await parsedKeys.get('session', deviceSessionKeys);
+
+            const deviceJids = [];
+            for (const [sessionKey, sessionData] of Object.entries(existingSessions)) {
+                if (sessionData) {
+
+                    const deviceStr = sessionKey.split('.')[1];
+                    if (!deviceStr)
+                        continue;
+                    const deviceNum = parseInt(deviceStr);
+                    let jid = deviceNum === 0 ? `${user}@s.whatsapp.net` : `${user}:${deviceNum}@s.whatsapp.net`;
+                    if (deviceNum === 99) {
+                        jid = `${user}:99@hosted`;
+                    }
+                    deviceJids.push(jid);
+                }
+            }
+            logger.debug({
+                fromJid,
+                totalDevices: userDevices.length,
+                devicesWithSessions: deviceJids.length,
+                devices: deviceJids
+            }, 'bulk device migration complete - all user devices processed');
+
+            return parsedKeys.transaction(async () => {
+                const migrationOps = deviceJids.map(jid => {
+                    const lidWithDevice = transferDevice(jid, toJid);
+                    const fromDecoded = jidDecode(jid);
+                    const toDecoded = jidDecode(lidWithDevice);
+                    return {
+                        fromJid: jid,
+                        toJid: lidWithDevice,
+                        pnUser: fromDecoded.user,
+                        lidUser: toDecoded.user,
+                        deviceId: fromDecoded.device || 0,
+                        fromAddr: jidToSignalProtocolAddress(jid),
+                        toAddr: jidToSignalProtocolAddress(lidWithDevice)
+                    };
+                });
+                const totalOps = migrationOps.length;
+                let migratedCount = 0;
+
+                const pnAddrStrings = Array.from(new Set(migrationOps.map(op => op.fromAddr.toString())));
+                const pnSessions = await parsedKeys.get('session', pnAddrStrings);
+
+                const sessionUpdates = {};
+                for (const op of migrationOps) {
+                    const pnAddrStr = op.fromAddr.toString();
+                    const lidAddrStr = op.toAddr.toString();
+                    const pnSession = pnSessions[pnAddrStr];
+                    if (pnSession) {
+
+                        const fromSession = libsignal.SessionRecord.deserialize(pnSession);
+                        if (fromSession.haveOpenSession()) {
+
+                            sessionUpdates[lidAddrStr] = fromSession.serialize();
+                            sessionUpdates[pnAddrStr] = null;
+                            migratedCount++;
+                        }
+                    }
+                }
+
+                if (Object.keys(sessionUpdates).length > 0) {
+                    await parsedKeys.set({ session: sessionUpdates });
+                    logger.debug({ migratedSessions: migratedCount }, 'bulk session migration complete');
+
+                    for (const op of migrationOps) {
+                        if (sessionUpdates[op.toAddr.toString()]) {
+                            const deviceKey = `${op.pnUser}.${op.deviceId}`;
+                            migratedSessionCache.set(deviceKey, true);
+                        }
+                    }
+                }
+                const skippedCount = totalOps - migratedCount;
+                return { migrated: migratedCount, skipped: skippedCount, total: totalOps };
+            }, `migrate-${deviceJids.length}-sessions-${jidDecode(toJid)?.user}`);
+        }
+    };
+    return repository;
+}
+const jidToSignalProtocolAddress = (jid) => {
+    const decoded = jidDecode(jid);
+    const { user, device, server, domainType } = decoded;
+    if (!user) {
+        throw new Error(`JID decoded but user is empty: "${jid}" -> user: "${user}", server: "${server}", device: ${device}`);
+    }
+    const signalUser = domainType !== WAJIDDomains.WHATSAPP ? `${user}_${domainType}` : user;
+    const finalDevice = device || 0;
+    if (device === 99 && decoded.server !== 'hosted' && decoded.server !== 'hosted.lid') {
+        throw new Error('Unexpected non-hosted device JID with device 99. This ID seems invalid. ID:' + jid);
+    }
+    return new libsignal.ProtocolAddress(signalUser, finalDevice);
+};
+const jidToSignalSenderKeyName = (group, user) => {
+    return new SenderKeyName(group, jidToSignalProtocolAddress(user));
+};
+function signalStorage({ creds, keys }, lidMapping) {
+
+    const resolveLIDSignalAddress = async (id) => {
+        if (id.includes('.')) {
+            const [deviceId, device] = id.split('.');
+            const [user, domainType_] = deviceId.split('_');
+            const domainType = parseInt(domainType_ || '0');
+            if (domainType === WAJIDDomains.LID || domainType === WAJIDDomains.HOSTED_LID)
+                return id;
+            const pnJid = `${user}${device !== '0' ? `:${device}` : ''}@${domainType === WAJIDDomains.HOSTED ? 'hosted' : 's.whatsapp.net'}`;
+            const lidForPN = await lidMapping.getLIDForPN(pnJid);
+            if (lidForPN) {
+                const lidAddr = jidToSignalProtocolAddress(lidForPN);
+                return lidAddr.toString();
+            }
+        }
+        return id;
+    };
+    return {
+        loadSession: async (id) => {
+            try {
+                const wireJid = await resolveLIDSignalAddress(id);
+                const { [wireJid]: sess } = await keys.get('session', [wireJid]);
+                if (sess) {
+                    return libsignal.SessionRecord.deserialize(sess);
+                }
+            }
+            catch (e) {
+                return null;
+            }
+            return null;
+        },
+        storeSession: async (id, session) => {
+            const wireJid = await resolveLIDSignalAddress(id);
+            await keys.set({ session: { [wireJid]: session.serialize() } });
+        },
+        isTrustedIdentity: () => {
+            return true;
+        },
+        loadIdentityKey: async (id) => {
+            const wireJid = await resolveLIDSignalAddress(id);
+            const { [wireJid]: key } = await keys.get('identity-key', [wireJid]);
+            return key || undefined;
+        },
+        saveIdentity: async (id, identityKey) => {
+            const wireJid = await resolveLIDSignalAddress(id);
+            const { [wireJid]: existingKey } = await keys.get('identity-key', [wireJid]);
+            const keysMatch = existingKey?.length === identityKey.length && existingKey.every((byte, i) => byte === identityKey[i]);
+            if (existingKey && !keysMatch) {
+
+                await keys.set({
+                    session: { [wireJid]: null },
+                    'identity-key': { [wireJid]: identityKey }
+                });
+                return true;
+            }
+            if (!existingKey) {
+
+                await keys.set({ 'identity-key': { [wireJid]: identityKey } });
+                return true;
+            }
+            return false;
+        },
+        loadPreKey: async (id) => {
+            const keyId = id.toString();
+            const { [keyId]: key } = await keys.get('pre-key', [keyId]);
+            if (key) {
+                return {
+                    privKey: Buffer.from(key.private),
+                    pubKey: Buffer.from(key.public)
+                };
+            }
+        },
+        removePreKey: (id) => keys.set({ 'pre-key': { [id]: null } }),
+        loadSignedPreKey: () => {
+            const key = creds.signedPreKey;
+            return {
+                privKey: Buffer.from(key.keyPair.private),
+                pubKey: Buffer.from(key.keyPair.public)
+            };
+        },
+        loadSenderKey: async (senderKeyName) => {
+            const keyId = senderKeyName.toString();
+            const { [keyId]: key } = await keys.get('sender-key', [keyId]);
+            if (key) {
+                return SenderKeyRecord.deserialize(key);
+            }
+            return new SenderKeyRecord();
+        },
+        storeSenderKey: async (senderKeyName, key) => {
+            const keyId = senderKeyName.toString();
+            const serialized = JSON.stringify(key.serialize());
+            await keys.set({ 'sender-key': { [keyId]: Buffer.from(serialized, 'utf-8') } });
+        },
+        getOurRegistrationId: () => creds.registrationId,
+        getOurIdentity: () => {
+            const { signedIdentityKey } = creds;
+            return {
+                privKey: Buffer.from(signedIdentityKey.private),
+                pubKey: Buffer.from(generateSignalPubKey(signedIdentityKey.public))
+            };
+        }
+    };
+}

package/src/Signal/lid-mapping.d.ts

@@ -0,0 +1,20 @@
+export class LIDMappingStore {
+    constructor(keys: any, logger: any, pnToLIDFunc: any);
+    mappingCache: any;
+    inflightLIDLookups: Map<any, any>;
+    inflightPNLookups: Map<any, any>;
+    keys: any;
+    pnToLIDFunc: any;
+    logger: any;
+    storeLIDPNMappings(pairs: any): Promise<void>;
+    getLIDForPN(pn: any): Promise<any>;
+    getLIDsForPNs(pns: any): Promise<any>;
+    _getLIDsForPNsImpl(pns: any): Promise<any[] | null>;
+    getPNForLID(lid: any): Promise<any>;
+    getPNsForLIDs(lids: any): Promise<any>;
+    _getPNsForLIDsImpl(lids: any): Promise<any[] | null>;
+    /**
+     * Close the cache and release resources
+     */
+    close(): void;
+}