kage-baileys 3.0.6 → 3.2.3

package/lib/Signal/libsignal.js

@@ -182,3 +182,938 @@ function signalStorage({ creds, keys }) {
         }
     };
 }
+
+// Kage: compatibilidad de API.
+const __kageModule19 = (() => {
+const module = { exports: {} }; const exports = module.exports;
+"use strict"
+
+Object.defineProperty(exports, "__esModule", { value: true })
+
+const {
+  SessionCipher, 
+  SessionBuilder, 
+  SessionRecord, 
+  ProtocolAddress
+} = require("@itsukichan/libsignal-node")
+const { generateSignalPubKey } = require("../Utils")
+const { 
+  isHostedLidUser, 
+  isHostedPnUser, 
+  isLidUser, 
+  isPnUser, 
+  jidDecode, 
+  transferDevice, 
+  WAJIDDomains 
+} = require("../WABinary")
+const { SenderKeyName } = require("./Group/sender-key-name")
+const { SenderKeyRecord } = require("./Group/sender-key-record")
+const {
+  GroupCipher, 
+  GroupSessionBuilder, 
+  SenderKeyDistributionMessage
+} = require("./Group")
+const { LRUCache } = require("lru-cache")
+const { LIDMappingStore } = require("./lid-mapping") 
+
+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, // 7 days
+        ttlAutopurge: true,
+        updateAgeOnGet: true
+    })
+    
+    const repository = {
+        decryptGroupMessage({ group, authorJid, msg }) {
+            const senderName = jidToSignalSenderKeyName(group, authorJid)
+            const cipher = new GroupCipher(storage, senderName)
+            
+            // Use transaction to ensure atomicity
+            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 SessionCipher(storage, addr)
+            
+            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
+            }
+            
+            // If it's not a sync message, we need to ensure atomicity
+            // For regular messages, we use a transaction to ensure atomicity
+            return parsedKeys.transaction(async () => {
+                return await doDecrypt()
+            }, jid)
+        },
+        
+        async encryptMessage({ jid, data }) {
+            const addr = jidToSignalProtocolAddress(jid)
+            const cipher = new SessionCipher(storage, addr)
+            
+            // Use transaction to ensure atomicity
+            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 }) {
+            const senderName = jidToSignalSenderKeyName(group, meId)
+            const builder = new GroupSessionBuilder(storage)
+            const senderNameStr = senderName.toString()
+            
+            return parsedKeys.transaction(async () => {
+                const { [senderNameStr]: senderKey } = await auth.keys.get('sender-key', [senderNameStr])
+                
+                if (!senderKey) {
+                    await storage.storeSenderKey(senderName, new SenderKeyRecord())
+                }
+                
+                const senderKeyDistributionMessage = await builder.create(senderName)
+                const session = new GroupCipher(storage, senderName)
+                const ciphertext = await session.encrypt(data)
+                
+                return {
+                    ciphertext,
+                    senderKeyDistributionMessage: senderKeyDistributionMessage.serialize()
+                }
+            }, group)
+        },
+        
+        async injectE2ESession({ jid, session }) {
+            logger.trace({ jid }, 'injecting E2EE session')
+            
+            const cipher = new SessionBuilder(storage, jidToSignalProtocolAddress(jid))
+            
+            return parsedKeys.transaction(async () => {
+                await cipher.initOutgoing(session)
+            }, jid)
+        },
+        
+        jidToSignalProtocolAddress(jid) {
+            return jidToSignalProtocolAddress(jid).toString()
+        },
+        
+        // Optimized direct access to LID mapping store
+        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
+            
+            // Convert JIDs to signal addresses and prepare for bulk deletion
+            const sessionUpdates = {}
+            
+            jids.forEach(jid => {
+                const addr = jidToSignalProtocolAddress(jid)
+                sessionUpdates[addr.toString()] = null
+            })
+            
+            // Single transaction for all deletions
+            return parsedKeys.transaction(async () => {
+                await auth.keys.set({ session: sessionUpdates })
+            }, `delete-${jids.length}-sessions`)
+        },
+        
+        async migrateSession(fromJid, toJid) {
+            // TODO: use usync to handle this entire mess
+            if (!fromJid || (!isLidUser(toJid) && !isHostedLidUser(toJid))) {
+                return { migrated: 0, skipped: 0, total: 0 }
+            }
+            
+            // Only support PN to LID migration
+            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')
+            
+            // Get user's device list from storage
+            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)
+            }
+            
+            // Filter out cached devices before database fetch
+            const uncachedDevices = userDevices.filter(device => {
+                const deviceKey = `${user}.${device}`
+                return !migratedSessionCache.has(deviceKey)
+            })
+            
+            // Bulk check session existence only for uncached devices
+            const deviceSessionKeys = uncachedDevices.map(device => `${user}.${device}`)
+            const existingSessions = await parsedKeys.get('session', deviceSessionKeys)
+            
+            // Step 3: Convert existing sessions to JIDs (only migrate sessions that exist)
+            const deviceJids = []
+            
+            for (const [sessionKey, sessionData] of Object.entries(existingSessions)) {
+                if (sessionData) {
+                    // Session exists in storage
+                    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')
+            
+            // Single transaction for all migrations
+            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
+                
+                // Bulk fetch PN sessions - already exist (verified during device discovery)
+                const pnAddrStrings = Array.from(new Set(migrationOps.map(op => op.fromAddr.toString())))
+                const pnSessions = await parsedKeys.get('session', pnAddrStrings)
+                
+                // Prepare bulk session updates (PN → LID migration + deletion)
+                const sessionUpdates = {}
+                
+                for (const op of migrationOps) {
+                    const pnAddrStr = op.fromAddr.toString()
+                    const lidAddrStr = op.toAddr.toString()
+                    const pnSession = pnSessions[pnAddrStr]
+                    
+                    if (pnSession) {
+                        // Session exists (guaranteed from device discovery)
+                        const fromSession = SessionRecord.deserialize(pnSession)
+                        
+                        if (fromSession.haveOpenSession()) {
+                            // Queue for bulk update: copy to LID, delete from PN
+                            sessionUpdates[lidAddrStr] = fromSession.serialize()
+                            sessionUpdates[pnAddrStr] = null
+                            migratedCount++
+                        }
+                    }
+                }
+                
+                // Single bulk session update for all migrations
+                if (Object.keys(sessionUpdates).length > 0) {
+                    await parsedKeys.set({ session: sessionUpdates })
+                    
+                    logger.debug({ migratedSessions: migratedCount }, 'bulk session migration complete')
+                    
+                    // Cache device-level migrations
+                    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 ProtocolAddress(signalUser, finalDevice)
+}
+
+const jidToSignalSenderKeyName = (group, user) => {
+    return new SenderKeyName(group, jidToSignalProtocolAddress(user))
+}
+
+function signalStorage({ creds, keys }, lidMapping) {
+    // Shared function to resolve PN signal address to LID if mapping exists
+    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 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 // todo: implement
+        },
+        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))
+            }
+        }
+    }
+}
+
+module.exports = {
+  makeLibSignalRepository
+}
+return module.exports;
+})();
+for (const key of Object.keys(__kageModule19)) {
+ if (key !== '__esModule' && !Object.prototype.hasOwnProperty.call(exports,key)) Object.defineProperty(exports,key,{enumerable:true,configurable:true,get:()=>__kageModule19[key]});
+}
+
+// Kage: funciones avanzadas.
+const __kageModule125 = (() => {
+const module = { exports: {} }; const exports = module.exports;
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeLibSignalRepository = makeLibSignalRepository;
+// @ts-ignore
+const libsignal = __importStar(require("libsignal"));
+// @ts-ignore
+const protobufs_js_1 = require("libsignal/src/protobufs.js");
+const index_js_1 = require("../Addon/index.js");
+const index_js_2 = require("../Utils/index.js");
+const index_js_3 = require("../WABinary/index.js");
+const sender_key_name_js_1 = require("./Group/sender-key-name.js");
+const sender_key_record_js_1 = require("./Group/sender-key-record.js");
+const index_js_4 = require("./Group/index.js");
+const lid_mapping_js_1 = require("./lid-mapping.js");
+/** Extract identity key from PreKeyWhisperMessage for identity change detection */
+function extractIdentityFromPkmsg(ciphertext) {
+    try {
+        if (!ciphertext || ciphertext.length < 2) {
+            return undefined;
+        }
+        // Version byte check (version 3)
+        const version = ciphertext[0];
+        if ((version & 0xf) !== 3) {
+            return undefined;
+        }
+        // Parse protobuf (skip version byte)
+        const preKeyProto = protobufs_js_1.PreKeyWhisperMessage.decode(ciphertext.slice(1));
+        if (preKeyProto.identityKey?.length === 33) {
+            return new Uint8Array(preKeyProto.identityKey);
+        }
+        return undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function makeLibSignalRepository(auth, logger, pnToLIDFunc) {
+    const lidMapping = new lid_mapping_js_1.LIDMappingStore(auth.keys, logger, pnToLIDFunc);
+    const storage = signalStorage(auth, lidMapping);
+    const parsedKeys = auth.keys;
+    const migratedSessionCache = (0, index_js_1.createCache)({
+        ttl: 3 * 24 * 60 * 60 // 3 days
+    });
+    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 sender_key_record_js_1.SenderKeyRecord());
+        }
+        const skdm = await new index_js_4.GroupSessionBuilder(storage).create(senderName);
+        return { senderName, skdm };
+    };
+    const repository = {
+        decryptGroupMessage({ group, authorJid, msg }) {
+            const senderName = jidToSignalSenderKeyName(group, authorJid);
+            const cipher = new index_js_4.GroupCipher(storage, senderName);
+            // Use transaction to ensure atomicity
+            return parsedKeys.transaction(async () => {
+                return cipher.decrypt(msg);
+            }, group);
+        },
+        async processSenderKeyDistributionMessage({ item, authorJid }) {
+            const builder = new index_js_4.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 index_js_4.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 sender_key_record_js_1.SenderKeyRecord());
+            }
+            return parsedKeys.transaction(async () => {
+                const { [senderNameStr]: senderKey } = await auth.keys.get('sender-key', [senderNameStr]);
+                if (!senderKey) {
+                    await storage.storeSenderKey(senderName, new sender_key_record_js_1.SenderKeyRecord());
+                }
+                await builder.process(senderName, senderMsg);
+            }, item.groupId);
+        },
+        async decryptMessage({ jid, type, ciphertext }) {
+            const addr = jidToSignalProtocolAddress(jid);
+            const session = new libsignal.SessionCipher(storage, addr);
+            // Extract and save sender's identity key before decryption for identity change detection
+            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;
+            }
+            // If it's not a sync message, we need to ensure atomicity
+            // For regular messages, we use a transaction to ensure atomicity
+            return parsedKeys.transaction(async () => {
+                return await doDecrypt();
+            }, jid);
+        },
+        async encryptMessage({ jid, data }) {
+            const addr = jidToSignalProtocolAddress(jid);
+            const cipher = new libsignal.SessionCipher(storage, addr);
+            // Use transaction to ensure atomicity
+            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 index_js_4.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 () => {
+                // libsignal runtime accepts an absent prekey (initOutgoing checks `device.preKey && ...`)
+                // but the bundled .d.ts marks it required.
+                await cipher.initOutgoing(session);
+            }, jid);
+        },
+        jidToSignalProtocolAddress(jid) {
+            return jidToSignalProtocolAddress(jid).toString();
+        },
+        // Optimized direct access to LID mapping store
+        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;
+            // Convert JIDs to signal addresses and prepare for bulk deletion
+            const sessionUpdates = {};
+            jids.forEach(jid => {
+                const addr = jidToSignalProtocolAddress(jid);
+                sessionUpdates[addr.toString()] = null;
+            });
+            // Single transaction for all deletions
+            return parsedKeys.transaction(async () => {
+                await auth.keys.set({ session: sessionUpdates });
+            }, `delete-${jids.length}-sessions`);
+        },
+        close() {
+            migratedSessionCache.flushAll();
+            lidMapping.close();
+        },
+        async migrateSession(fromJid, toJid) {
+            // TODO: use usync to handle this entire mess
+            if (!fromJid || (!(0, index_js_3.isLidUser)(toJid) && !(0, index_js_3.isHostedLidUser)(toJid)))
+                return { migrated: 0, skipped: 0, total: 0 };
+            // Only support PN to LID migration
+            if (!(0, index_js_3.isPnUser)(fromJid) && !(0, index_js_3.isHostedPnUser)(fromJid)) {
+                return { migrated: 0, skipped: 0, total: 1 };
+            }
+            const { user } = (0, index_js_3.jidDecode)(fromJid);
+            logger.debug({ fromJid }, 'bulk device migration - loading all user devices');
+            // Get user's device list from storage
+            const { [user]: userDevices } = await parsedKeys.get('device-list', [user]);
+            if (!userDevices) {
+                return { migrated: 0, skipped: 0, total: 0 };
+            }
+            const { device: fromDevice } = (0, index_js_3.jidDecode)(fromJid);
+            const fromDeviceStr = fromDevice?.toString() || '0';
+            if (!userDevices.includes(fromDeviceStr)) {
+                userDevices.push(fromDeviceStr);
+            }
+            // Filter out cached devices before database fetch
+            const uncachedDevices = userDevices.filter(device => {
+                const deviceKey = `${user}.${device}`;
+                return !migratedSessionCache.has(deviceKey);
+            });
+            // Bulk check session existence only for uncached devices
+            const deviceSessionKeys = uncachedDevices.map(device => `${user}.${device}`);
+            const existingSessions = await parsedKeys.get('session', deviceSessionKeys);
+            // Step 3: Convert existing sessions to JIDs (only migrate sessions that exist)
+            const deviceJids = [];
+            for (const [sessionKey, sessionData] of Object.entries(existingSessions)) {
+                if (sessionData) {
+                    // Session exists in storage
+                    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');
+            // Single transaction for all migrations
+            return parsedKeys.transaction(async () => {
+                const migrationOps = deviceJids.map(jid => {
+                    const lidWithDevice = (0, index_js_3.transferDevice)(jid, toJid);
+                    const fromDecoded = (0, index_js_3.jidDecode)(jid);
+                    const toDecoded = (0, index_js_3.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;
+                // Bulk fetch PN sessions - already exist (verified during device discovery)
+                const pnAddrStrings = Array.from(new Set(migrationOps.map(op => op.fromAddr.toString())));
+                const pnSessions = await parsedKeys.get('session', pnAddrStrings);
+                // Prepare bulk session updates (PN → LID migration + deletion)
+                const sessionUpdates = {};
+                for (const op of migrationOps) {
+                    const pnAddrStr = op.fromAddr.toString();
+                    const lidAddrStr = op.toAddr.toString();
+                    const pnSession = pnSessions[pnAddrStr];
+                    if (pnSession) {
+                        // Session exists (guaranteed from device discovery)
+                        const fromSession = libsignal.SessionRecord.deserialize(pnSession);
+                        if (fromSession.haveOpenSession()) {
+                            // Queue for bulk update: copy to LID, delete from PN
+                            sessionUpdates[lidAddrStr] = fromSession.serialize();
+                            sessionUpdates[pnAddrStr] = null;
+                            migratedCount++;
+                        }
+                    }
+                }
+                // Single bulk session update for all migrations
+                if (Object.keys(sessionUpdates).length > 0) {
+                    await parsedKeys.set({ session: sessionUpdates });
+                    logger.debug({ migratedSessions: migratedCount }, 'bulk session migration complete');
+                    // Cache device-level migrations
+                    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-${(0, index_js_3.jidDecode)(toJid)?.user}`);
+        }
+    };
+    return repository;
+}
+const jidToSignalProtocolAddress = (jid) => {
+    const decoded = (0, index_js_3.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 !== index_js_3.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 sender_key_name_js_1.SenderKeyName(group, jidToSignalProtocolAddress(user));
+};
+function signalStorage({ creds, keys }, lidMapping) {
+    // Shared function to resolve PN signal address to LID if mapping exists
+    const resolveLIDSignalAddress = async (id) => {
+        if (id.includes('.')) {
+            const [deviceId, device] = id.split('.');
+            const [user, domainType_] = deviceId.split('_');
+            const domainType = parseInt(domainType_ || '0');
+            if (domainType === index_js_3.WAJIDDomains.LID || domainType === index_js_3.WAJIDDomains.HOSTED_LID)
+                return id;
+            const pnJid = `${user}${device !== '0' ? `:${device}` : ''}@${domainType === index_js_3.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; // TOFU - Trust on First Use (same as WhatsApp Web)
+        },
+        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) {
+                // Identity changed - clear session and update key
+                await keys.set({
+                    session: { [wireJid]: null },
+                    'identity-key': { [wireJid]: identityKey }
+                });
+                return true;
+            }
+            if (!existingKey) {
+                // New contact - Trust on First Use (TOFU)
+                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 sender_key_record_js_1.SenderKeyRecord.deserialize(key);
+            }
+            return new sender_key_record_js_1.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((0, index_js_2.generateSignalPubKey)(signedIdentityKey.public))
+            };
+        }
+    };
+}
+
+return module.exports;
+})();
+for (const key of Object.keys(__kageModule125)) {
+ if (key !== '__esModule' && !Object.prototype.hasOwnProperty.call(exports,key)) Object.defineProperty(exports,key,{enumerable:true,configurable:true,get:()=>__kageModule125[key]});
+}
+Object.defineProperty(exports, Symbol.for('kage.advanced'), {value:__kageModule125, configurable:true});