@oxidezap/baileyrs 0.0.7 → 0.0.8

package/lib/Utils/__tests__/wrap-legacy-store-lid-mapping.test.js

@@ -0,0 +1,157 @@
+/**
+ * Pin down the `lid_mapping` cross-impl gap. Same auth folder must work for
+ * both libraries; the LID↔PN mapping table is what lets every send-side
+ * lookup correctly route a PN JID to its LID device address.
+ *
+ * Bridge (`whatsapp-rust-bridge/src/js_backend.rs`):
+ *   • store: `lid_mapping`
+ *   • forward key: `lid:{lidUser}` → JSON `LidPnMappingEntry`
+ *     `{ lid, phone_number, created_at, updated_at, learning_source }`
+ *   • reverse key: `pn:{pnUser}` → raw bytes of the LID user (UTF-8)
+ *
+ * Upstream baileys (`Signal/lid-mapping.js`):
+ *   • store: `lid-mapping`
+ *   • forward key: bare `{pnUser}` → string `lidUser`
+ *   • reverse key: bare `{lidUser}_reverse` → string `pnUser`
+ *
+ * Without a converter, neither library finds the other's entries. Upstream
+ * has a USYNC fallback (re-fetch from server) so it doesn't crash, but
+ * costs an extra round-trip per cross-impl session start. These tests pin
+ * down direct compatibility so the fallback is no longer needed.
+ */
+import { Buffer } from 'node:buffer';
+import { describe, test } from 'node:test';
+import { wrapLegacyStore } from "../wrap-legacy-store.js";
+import { initAuthCreds } from "../generics.js";
+import { expect } from "../../__tests__/expect.js";
+// ── Helpers ──────────────────────────────────────────────────────────────
+function makeMemKeys() {
+    const data = {};
+    return {
+        raw: data,
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        async get(type, ids) {
+            const bucket = data[type] ?? {};
+            const out = {};
+            for (const id of ids)
+                out[id] = bucket[id] ?? null;
+            return out;
+        },
+        async set(updates) {
+            for (const [type, bucket] of Object.entries(updates)) {
+                data[type] ?? (data[type] = {});
+                for (const [id, val] of Object.entries(bucket)) {
+                    if (val === null || val === undefined)
+                        delete data[type][id];
+                    else
+                        data[type][id] = val;
+                }
+            }
+        }
+    };
+}
+async function makeWrapped() {
+    const creds = initAuthCreds();
+    const keys = makeMemKeys();
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const state = { creds, keys: keys };
+    const wrapped = await wrapLegacyStore(state, async () => { });
+    return { wrapped, keys, creds };
+}
+const PN_USER = '559980000003';
+const LID_USER = '100000037037034';
+// ── Tests ────────────────────────────────────────────────────────────────
+describe('wrap-legacy-store: lid_mapping key-name translation (cross-impl)', () => {
+    test('bridge SET pn:{X} writes under upstream bare key {X}', async () => {
+        const { wrapped, keys } = await makeWrapped();
+        await wrapped.set('lid_mapping', `pn:${PN_USER}`, new TextEncoder().encode(LID_USER));
+        // Upstream's `lid-mapping.js` looks here:
+        expect(keys.raw['lid-mapping']?.[PN_USER]).toBeDefined();
+        // And NOT here (would be a passthrough leak):
+        expect(keys.raw['lid-mapping']?.[`pn:${PN_USER}`]).toBeUndefined();
+    });
+    test('bridge SET lid:{X} writes under upstream key {X}_reverse', async () => {
+        const { wrapped, keys } = await makeWrapped();
+        const entry = {
+            lid: LID_USER,
+            phone_number: PN_USER,
+            created_at: 1700000000,
+            updated_at: 1700000000,
+            learning_source: 'usync'
+        };
+        await wrapped.set('lid_mapping', `lid:${LID_USER}`, new TextEncoder().encode(JSON.stringify(entry)));
+        expect(keys.raw['lid-mapping']?.[`${LID_USER}_reverse`]).toBeDefined();
+        expect(keys.raw['lid-mapping']?.[`lid:${LID_USER}`]).toBeUndefined();
+    });
+});
+describe('wrap-legacy-store: lid_mapping value-byte translation (cross-impl)', () => {
+    test('bridge-written pn mapping is loadable as a STRING for upstream lid-mapping', async () => {
+        const { wrapped, keys } = await makeWrapped();
+        await wrapped.set('lid_mapping', `pn:${PN_USER}`, new TextEncoder().encode(LID_USER));
+        // Upstream's `_getLIDsForPNsImpl` does
+        // `const stored = await this.keys.get('lid-mapping', [pnUser])` and
+        // then `stored[pnUser]` — expects a STRING (not a Buffer).
+        const stored = keys.raw['lid-mapping']?.[PN_USER];
+        expect(typeof stored).toBe('string');
+        expect(stored).toBe(LID_USER);
+    });
+    test('bridge-written lid entry surfaces phone_number STRING under {lid}_reverse for upstream', async () => {
+        const { wrapped, keys } = await makeWrapped();
+        const entry = {
+            lid: LID_USER,
+            phone_number: PN_USER,
+            created_at: 1700000000,
+            updated_at: 1700000000,
+            learning_source: 'usync'
+        };
+        await wrapped.set('lid_mapping', `lid:${LID_USER}`, new TextEncoder().encode(JSON.stringify(entry)));
+        const stored = keys.raw['lid-mapping']?.[`${LID_USER}_reverse`];
+        expect(typeof stored).toBe('string');
+        expect(stored).toBe(PN_USER);
+    });
+    test('bridge GET pn:{X} reads back upstream bare-string entry as raw LID bytes', async () => {
+        const { wrapped, keys } = await makeWrapped();
+        // Pretend upstream wrote first (real "swap from upstream" scenario).
+        keys.raw['lid-mapping'] = { [PN_USER]: LID_USER };
+        const out = (await wrapped.get('lid_mapping', `pn:${PN_USER}`));
+        expect(out).not.toBe(null);
+        expect(Buffer.from(out).toString('utf-8')).toBe(LID_USER);
+    });
+    test('bridge GET lid:{X} reconstructs synthetic LidPnMappingEntry from upstream {lid}_reverse', async () => {
+        const { wrapped, keys } = await makeWrapped();
+        keys.raw['lid-mapping'] = { [`${LID_USER}_reverse`]: PN_USER };
+        const out = (await wrapped.get('lid_mapping', `lid:${LID_USER}`));
+        expect(out).not.toBe(null);
+        const parsed = JSON.parse(Buffer.from(out).toString('utf-8'));
+        expect(parsed.lid).toBe(LID_USER);
+        expect(parsed.phone_number).toBe(PN_USER);
+        // Synthetic timestamps + source to satisfy bridge consumers without
+        // requiring upstream to track them.
+        expect(parsed.learning_source).toBe('wrap-legacy-store');
+        expect(parsed.created_at).toBeGreaterThan(0);
+        expect(parsed.updated_at).toBeGreaterThan(0);
+    });
+    test('round-trip: bridge SET both forward + reverse → upstream-shape on disk → bridge GET both directions', async () => {
+        const { wrapped, keys } = await makeWrapped();
+        // What the bridge does on `put_lid_mapping`: writes both lid: and pn:.
+        const entry = {
+            lid: LID_USER,
+            phone_number: PN_USER,
+            created_at: 1700000000,
+            updated_at: 1700000000,
+            learning_source: 'peer_pn_message'
+        };
+        await wrapped.set('lid_mapping', `lid:${LID_USER}`, new TextEncoder().encode(JSON.stringify(entry)));
+        await wrapped.set('lid_mapping', `pn:${PN_USER}`, new TextEncoder().encode(LID_USER));
+        // On-disk: upstream-shape, both keys present.
+        expect(keys.raw['lid-mapping']?.[PN_USER]).toBe(LID_USER);
+        expect(keys.raw['lid-mapping']?.[`${LID_USER}_reverse`]).toBe(PN_USER);
+        // Read back via bridge — both should resolve.
+        const lidBack = (await wrapped.get('lid_mapping', `pn:${PN_USER}`));
+        expect(Buffer.from(lidBack).toString('utf-8')).toBe(LID_USER);
+        const entryBack = JSON.parse(Buffer.from((await wrapped.get('lid_mapping', `lid:${LID_USER}`))).toString('utf-8'));
+        expect(entryBack.lid).toBe(LID_USER);
+        expect(entryBack.phone_number).toBe(PN_USER);
+    });
+});
+//# sourceMappingURL=wrap-legacy-store-lid-mapping.test.js.map

package/lib/Utils/__tests__/wrap-legacy-store-lid-mapping.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrap-legacy-store-lid-mapping.test.js","sourceRoot":"","sources":["../../../src/Utils/__tests__/wrap-legacy-store-lid-mapping.test.ts"],"names":[],"mappings":"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"}

package/lib/Utils/__tests__/wrap-legacy-store-sender-key.test.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Pin down the sender_key cross-impl gap that broke the e2e handoff test
+ * (`baileys-handoff.test-e2e.ts`, Phase 10). This is the fast unit-level
+ * version: no socket, no mock server, in-memory keys store, deterministic.
+ *
+ * Two formats are at play:
+ *
+ *   ── Bridge (Rust libsignal, what whatsapp-rust-bridge writes) ─────────
+ *     • store name:  `sender_key`
+ *     • key (cache_key): `{group}:{user}[:jidDev]@{server}.{signalDev}`
+ *           e.g. "120363@g.us:100000037037034@lid.0"
+ *     • value: raw protobuf bytes of `waproto.SenderKeyRecordStructure`
+ *
+ *   ── Upstream baileys (JS libsignal, what `useMultiFileAuthState` produces)
+ *     • store name:  `sender-key`  (hyphen, not underscore!)
+ *     • key (SenderKeyName.serialize): `{group}::{signalUser}::{deviceId}`
+ *           where signalUser = `${user}` for s.whatsapp.net (domainType 0)
+ *           or `${user}_${domainType}` for LID (1) / hosted (2) / etc.
+ *           e.g. "120363@g.us::100000037037034_1::0"
+ *     • value: `Buffer.from(JSON.stringify(senderKeyStates, BufferJSON.replacer))`
+ *           where each state is `{ senderKeyId, senderChainKey: { iteration, seed:Buffer },
+ *           senderSigningKey: { public:Buffer, private:Buffer }, senderMessageKeys: [] }`
+ *           and Buffer is replaced by `{ type:'Buffer', data:'<base64>' }` in the JSON.
+ *
+ * Both the **store name**, the **key shape**, AND the **value encoding**
+ * differ. So the bridge-write cannot be read by upstream-load and vice-versa
+ * unless `wrap-legacy-store` translates at the boundary. These tests pin
+ * that contract — they MUST remain green for the handoff to work.
+ */
+export {};
+//# sourceMappingURL=wrap-legacy-store-sender-key.test.d.ts.map

package/lib/Utils/__tests__/wrap-legacy-store-sender-key.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrap-legacy-store-sender-key.test.d.ts","sourceRoot":"","sources":["../../../src/Utils/__tests__/wrap-legacy-store-sender-key.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG"}

package/lib/Utils/__tests__/wrap-legacy-store-sender-key.test.js

@@ -0,0 +1,253 @@
+/**
+ * Pin down the sender_key cross-impl gap that broke the e2e handoff test
+ * (`baileys-handoff.test-e2e.ts`, Phase 10). This is the fast unit-level
+ * version: no socket, no mock server, in-memory keys store, deterministic.
+ *
+ * Two formats are at play:
+ *
+ *   ── Bridge (Rust libsignal, what whatsapp-rust-bridge writes) ─────────
+ *     • store name:  `sender_key`
+ *     • key (cache_key): `{group}:{user}[:jidDev]@{server}.{signalDev}`
+ *           e.g. "120363@g.us:100000037037034@lid.0"
+ *     • value: raw protobuf bytes of `waproto.SenderKeyRecordStructure`
+ *
+ *   ── Upstream baileys (JS libsignal, what `useMultiFileAuthState` produces)
+ *     • store name:  `sender-key`  (hyphen, not underscore!)
+ *     • key (SenderKeyName.serialize): `{group}::{signalUser}::{deviceId}`
+ *           where signalUser = `${user}` for s.whatsapp.net (domainType 0)
+ *           or `${user}_${domainType}` for LID (1) / hosted (2) / etc.
+ *           e.g. "120363@g.us::100000037037034_1::0"
+ *     • value: `Buffer.from(JSON.stringify(senderKeyStates, BufferJSON.replacer))`
+ *           where each state is `{ senderKeyId, senderChainKey: { iteration, seed:Buffer },
+ *           senderSigningKey: { public:Buffer, private:Buffer }, senderMessageKeys: [] }`
+ *           and Buffer is replaced by `{ type:'Buffer', data:'<base64>' }` in the JSON.
+ *
+ * Both the **store name**, the **key shape**, AND the **value encoding**
+ * differ. So the bridge-write cannot be read by upstream-load and vice-versa
+ * unless `wrap-legacy-store` translates at the boundary. These tests pin
+ * that contract — they MUST remain green for the handoff to work.
+ */
+import { Buffer } from 'node:buffer';
+import { describe, test } from 'node:test';
+// Upstream baileys's actual classes — NOT a mock. We are asserting the same
+// loadSenderKey/storeSenderKey path that runs inside upstream's libsignal at
+// runtime.
+import { SenderKeyRecord } from 'baileys/lib/Signal/Group/sender-key-record.js';
+// eslint-disable-next-line @typescript-eslint/no-explicit-any -- bridge proto-types ambient
+import { proto as bridgeProto } from 'whatsapp-rust-bridge/proto-types';
+import { wrapLegacyStore } from "../wrap-legacy-store.js";
+import { initAuthCreds } from "../generics.js";
+import { expect } from "../../__tests__/expect.js";
+// ─── In-memory keys store identical in shape to upstream's `useMultiFileAuthState`
+// keys callback (the surface wrap-legacy-store talks to). ────────────────────
+function makeMemKeys() {
+    const data = {};
+    return {
+        raw: data,
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any -- mirrors upstream `keys.get` shape
+        async get(type, ids) {
+            const bucket = data[type] ?? {};
+            const out = {};
+            for (const id of ids)
+                out[id] = bucket[id] ?? null;
+            return out;
+        },
+        async set(updates) {
+            for (const [type, bucket] of Object.entries(updates)) {
+                data[type] ?? (data[type] = {});
+                for (const [id, val] of Object.entries(bucket)) {
+                    if (val === null || val === undefined)
+                        delete data[type][id];
+                    else
+                        data[type][id] = val;
+                }
+            }
+        }
+    };
+}
+// ─── Helpers to build a realistic, fully-populated proto sender-key record ─
+function buildBridgeSenderKeyBytes(opts) {
+    const { keyId = 17, iteration = 3, chainSeed = new Uint8Array(32).map((_, i) => (i * 7) & 0xff), signingPublic = new Uint8Array(33).map((_, i) => (i * 11) & 0xff), signingPrivate = new Uint8Array(32).map((_, i) => (i * 13) & 0xff) } = opts;
+    const struct = bridgeProto.SenderKeyRecordStructure.create({
+        senderKeyStates: [
+            {
+                senderKeyId: keyId,
+                senderChainKey: { iteration, seed: chainSeed },
+                senderSigningKey: { public: signingPublic, private: signingPrivate },
+                senderMessageKeys: []
+            }
+        ]
+    });
+    return bridgeProto.SenderKeyRecordStructure.encode(struct).finish();
+}
+const SAMPLE_GROUP = '120363012345678900@g.us';
+// LID sender, no JID device. This is the mock-server default and the case
+// our e2e test exercises.
+const SAMPLE_BRIDGE_KEY_LID = `${SAMPLE_GROUP}:100000037037034@lid.0`;
+const EXPECTED_UPSTREAM_KEY_LID = `${SAMPLE_GROUP}::100000037037034_1::0`;
+// PN sender on s.whatsapp.net with a JID device — exercises the
+// `user:device@server` userPart branch + the no-suffix signalUser branch.
+const SAMPLE_BRIDGE_KEY_PN_DEV = `${SAMPLE_GROUP}:559980000003:5@s.whatsapp.net.0`;
+const EXPECTED_UPSTREAM_KEY_PN_DEV = `${SAMPLE_GROUP}::559980000003::5`;
+async function makeWrapped() {
+    const creds = initAuthCreds();
+    const keys = makeMemKeys();
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any -- minimal AuthenticationState surface
+    const state = { creds, keys: keys };
+    const wrapped = await wrapLegacyStore(state, async () => { });
+    return { wrapped, keys, creds };
+}
+describe('wrap-legacy-store: sender_key key-name translation (cross-impl)', () => {
+    test('bridge SET writes under the upstream-formatted key (LID, no JID device)', async () => {
+        const { wrapped, keys } = await makeWrapped();
+        await wrapped.set('sender_key', SAMPLE_BRIDGE_KEY_LID, buildBridgeSenderKeyBytes({}));
+        // Upstream's libsignal will look here:
+        const stored = keys.raw['sender-key']?.[EXPECTED_UPSTREAM_KEY_LID];
+        expect(stored).toBeDefined();
+        // AND the bridge-shaped key must NOT exist (would mean we just wrote
+        // raw bytes verbatim and hadn't translated the key).
+        const bridgeKeyValue = keys.raw['sender-key']?.[SAMPLE_BRIDGE_KEY_LID];
+        expect(bridgeKeyValue).toBeUndefined();
+    });
+    test('bridge SET writes under the upstream-formatted key (PN with device suffix)', async () => {
+        const { wrapped, keys } = await makeWrapped();
+        await wrapped.set('sender_key', SAMPLE_BRIDGE_KEY_PN_DEV, buildBridgeSenderKeyBytes({}));
+        const stored = keys.raw['sender-key']?.[EXPECTED_UPSTREAM_KEY_PN_DEV];
+        expect(stored).toBeDefined();
+    });
+    test('bridge GET reads back from the upstream-formatted key (LID)', async () => {
+        const { wrapped, keys } = await makeWrapped();
+        // Pretend upstream's libsignal already wrote here — this is the
+        // scenario where a bot ran on upstream first and is now booting
+        // baileyrs against the same auth folder.
+        const samples = [
+            {
+                senderKeyId: 17,
+                senderChainKey: { iteration: 3, seed: Buffer.from(new Uint8Array(32).map((_, i) => (i * 7) & 0xff)) },
+                senderSigningKey: {
+                    public: Buffer.from(new Uint8Array(33).map((_, i) => (i * 11) & 0xff)),
+                    private: Buffer.from(new Uint8Array(32).map((_, i) => (i * 13) & 0xff))
+                },
+                senderMessageKeys: []
+            }
+        ];
+        const upstreamBytes = Buffer.from(JSON.stringify(samples, (_k, v) => {
+            if (Buffer.isBuffer(v) || v instanceof Uint8Array || v?.type === 'Buffer') {
+                return { type: 'Buffer', data: Buffer.from(v?.data ?? v).toString('base64') };
+            }
+            return v;
+        }), 'utf-8');
+        keys.raw['sender-key'] = { [EXPECTED_UPSTREAM_KEY_LID]: upstreamBytes };
+        const out = (await wrapped.get('sender_key', SAMPLE_BRIDGE_KEY_LID));
+        expect(out).toBeDefined();
+        expect(out).not.toBe(null);
+    });
+});
+describe('wrap-legacy-store: sender_key value-byte translation (cross-impl)', () => {
+    test('bridge-written proto bytes are loadable by upstream SenderKeyRecord.deserialize', async () => {
+        const { wrapped, keys } = await makeWrapped();
+        const keyId = 42;
+        const iteration = 9;
+        const chainSeed = Buffer.from(new Uint8Array(32).map((_, i) => (i + 1) & 0xff));
+        const signPub = Buffer.from(new Uint8Array(33).map((_, i) => (200 - i) & 0xff));
+        const signPriv = Buffer.from(new Uint8Array(32).map((_, i) => (i * 5 + 11) & 0xff));
+        const protoBytes = buildBridgeSenderKeyBytes({
+            keyId,
+            iteration,
+            chainSeed: new Uint8Array(chainSeed),
+            signingPublic: new Uint8Array(signPub),
+            signingPrivate: new Uint8Array(signPriv)
+        });
+        await wrapped.set('sender_key', SAMPLE_BRIDGE_KEY_LID, protoBytes);
+        const onDisk = keys.raw['sender-key']?.[EXPECTED_UPSTREAM_KEY_LID];
+        expect(onDisk).toBeDefined();
+        // This is the EXACT call upstream's `loadSenderKey` makes. If it
+        // throws or produces an empty record, the e2e regression remains.
+        const rec = SenderKeyRecord.deserialize(onDisk);
+        expect(rec.isEmpty()).toBe(false);
+        const state = rec.getSenderKeyState();
+        expect(state.getKeyId()).toBe(keyId);
+        expect(state.getSenderChainKey().getIteration()).toBe(iteration);
+        // Buffer comparison via .equals — chain seed must round-trip byte-for-byte.
+        const seedOut = state.getSenderChainKey().getSeed();
+        expect(Buffer.from(seedOut).equals(chainSeed)).toBe(true);
+        // Signing keys: upstream prepends 0x05 to a 32-byte public on read,
+        // so we compare against the stored 33-byte value verbatim.
+        const pubOut = state.getSigningKeyPublic();
+        expect(Buffer.from(pubOut).equals(signPub)).toBe(true);
+        const privOut = state.getSigningKeyPrivate();
+        expect(Buffer.from(privOut).equals(signPriv)).toBe(true);
+    });
+    test('upstream-written JSON bytes round-trip through bridge GET to valid proto bytes', async () => {
+        const { wrapped, keys } = await makeWrapped();
+        // Build a record exactly the way upstream writes it (sender-key-state.js:19+).
+        const keyId = 99;
+        const iteration = 4;
+        const chainSeed = Buffer.alloc(32, 0xab);
+        const signPub = Buffer.alloc(33, 0xcd);
+        const signPriv = Buffer.alloc(32, 0xef);
+        const senderKeyStates = [
+            {
+                senderKeyId: keyId,
+                senderChainKey: { iteration, seed: chainSeed },
+                senderSigningKey: { public: signPub, private: signPriv },
+                senderMessageKeys: []
+            }
+        ];
+        // Same replacer baileys uses (BufferJSON in lib/Utils/generics.js).
+        const upstreamBytes = Buffer.from(JSON.stringify(senderKeyStates, (_k, v) => {
+            if (Buffer.isBuffer(v) || v instanceof Uint8Array || v?.type === 'Buffer') {
+                return { type: 'Buffer', data: Buffer.from(v?.data ?? v).toString('base64') };
+            }
+            return v;
+        }), 'utf-8');
+        keys.raw['sender-key'] = { [EXPECTED_UPSTREAM_KEY_LID]: upstreamBytes };
+        const bytesOut = (await wrapped.get('sender_key', SAMPLE_BRIDGE_KEY_LID));
+        expect(bytesOut).toBeDefined();
+        expect(bytesOut).not.toBe(null);
+        // These bytes must be valid `SenderKeyRecordStructure` proto for the
+        // Rust libsignal that lives in the bridge to consume them.
+        const decoded = bridgeProto.SenderKeyRecordStructure.decode(bytesOut);
+        expect(decoded.senderKeyStates.length).toBe(1);
+        const s = decoded.senderKeyStates[0];
+        expect(s.senderKeyId).toBe(keyId);
+        expect(s.senderChainKey?.iteration).toBe(iteration);
+        expect(Buffer.from(s.senderChainKey.seed).equals(chainSeed)).toBe(true);
+        expect(Buffer.from(s.senderSigningKey.public).equals(signPub)).toBe(true);
+        expect(Buffer.from(s.senderSigningKey.private).equals(signPriv)).toBe(true);
+    });
+    test('round-trip: bridge SET → upstream raw read → upstream-style modify → bridge GET → valid proto', async () => {
+        // End-to-end durability test: simulates a session where the bridge
+        // writes initially, upstream reads + advances chain (as it does on
+        // each receive), upstream writes back, and the bridge reads the
+        // final state.
+        const { wrapped, keys } = await makeWrapped();
+        const initialBytes = buildBridgeSenderKeyBytes({ keyId: 5, iteration: 1 });
+        await wrapped.set('sender_key', SAMPLE_BRIDGE_KEY_LID, initialBytes);
+        const onDisk = keys.raw['sender-key']?.[EXPECTED_UPSTREAM_KEY_LID];
+        const rec = SenderKeyRecord.deserialize(onDisk);
+        // Advance the iteration counter the way upstream's group cipher does
+        // after consuming a message.
+        const state = rec.getSenderKeyState();
+        const ck = state.getSenderChainKey();
+        // Simulate an iteration bump. We pass a duck-typed object that
+        // matches the SenderChainKey getter shape upstream uses internally.
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any -- SenderChainKey is structurally typed inside upstream
+        const bumped = { getIteration: () => ck.getIteration() + 5, getSeed: () => ck.getSeed() };
+        state.setSenderChainKey(bumped);
+        // Re-serialize the upstream way and put it back on disk.
+        const newJson = JSON.stringify(rec.serialize(), (_k, v) => {
+            if (Buffer.isBuffer(v) || v instanceof Uint8Array || v?.type === 'Buffer') {
+                return { type: 'Buffer', data: Buffer.from(v?.data ?? v).toString('base64') };
+            }
+            return v;
+        });
+        keys.raw['sender-key'][EXPECTED_UPSTREAM_KEY_LID] = Buffer.from(newJson, 'utf-8');
+        // Now the bridge re-reads — it must see the bumped iteration.
+        const bytesOut = (await wrapped.get('sender_key', SAMPLE_BRIDGE_KEY_LID));
+        expect(bytesOut).not.toBe(null);
+        const decoded = bridgeProto.SenderKeyRecordStructure.decode(bytesOut);
+        expect(decoded.senderKeyStates[0].senderChainKey?.iteration).toBe(6);
+    });
+});
+//# sourceMappingURL=wrap-legacy-store-sender-key.test.js.map

package/lib/Utils/__tests__/wrap-legacy-store-sender-key.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrap-legacy-store-sender-key.test.js","sourceRoot":"","sources":["../../../src/Utils/__tests__/wrap-legacy-store-sender-key.test.ts"],"names":[],"mappings":"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"}

package/lib/Utils/__tests__/wrap-legacy-store-session.test.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Pin down the `session` cross-impl gap. Sister of the sender_key test.
+ *
+ * Bridge (Rust libsignal) writes:
+ *   • store: `session`
+ *   • key:   `{user}[:jidDev]@{server}.{signalDev}`  e.g. "100000037037034@lid.0"
+ *   • value: raw protobuf bytes of `waproto.RecordStructure`
+ *           (current_session + previous_sessions, both `SessionStructure`)
+ *
+ * Upstream baileys (JS libsignal) writes:
+ *   • store: `session`           (same name, so no rename)
+ *   • key:   `{signalUser}.{deviceId}`           e.g. "100000037037034_1.0"
+ *           where signalUser = `${user}` for s.whatsapp.net (domainType 0),
+ *                            `${user}_${domainType}` otherwise
+ *   • value: a plain JS object (NOT bytes!) with shape
+ *           `{ _sessions: { [base64BaseKey]: SessionEntry }, version: 'v1' }`
+ *           The keys store is responsible for JSON-stringifying it on disk.
+ *
+ * Two diffs at the boundary:
+ *   1. KEY format: bridge `addr@server.dev` ↔ upstream `signalUser.deviceId`
+ *   2. VALUE format: proto bytes ↔ JS object (with base64-encoded byte fields)
+ *
+ * If wrap-legacy-store doesn't translate, upstream's `loadSession` either
+ *   (a) doesn't find the key at all, OR
+ *   (b) finds it (Buffer of proto bytes) and throws inside SessionRecord.deserialize
+ * → returns null → falls back to fresh PreKey signal handshake. The e2e
+ * 1:1 phases still pass via that fallback, but every cross-impl swap then
+ * costs an extra ~3 wire roundtrips per peer pair. These tests pin down
+ * the contract for direct, no-re-handshake compatibility.
+ */
+export {};
+//# sourceMappingURL=wrap-legacy-store-session.test.d.ts.map

package/lib/Utils/__tests__/wrap-legacy-store-session.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrap-legacy-store-session.test.d.ts","sourceRoot":"","sources":["../../../src/Utils/__tests__/wrap-legacy-store-session.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG"}