@enbox/dwn-sdk-js 0.3.9 → 0.4.1

package/dist/esm/tests/core/records-grant-authorization.spec.js.map

@@ -1 +1 @@
-{"version":3,"file":"records-grant-authorization.spec.js","sourceRoot":"","sources":["../../../../tests/core/records-grant-authorization.spec.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAEhD,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,yBAAyB,EAAE,MAAM,+CAA+C,CAAC;AAC1F,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AAE1F,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;IACzC,MAAM,OAAO,GAAG,mBAAmB,CAAC;IACpC,MAAM,OAAO,GAAG,iBAAiB,CAAC;IAClC,MAAM,QAAQ,GAAG,8BAA8B,CAAC;IAChD,MAAM,SAAS,GAAG,6BAA6B,CAAC;IAChD,MAAM,YAAY,GAAG;QACnB,KAAK,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;KACX,CAAC;IAE7B,SAAS,gBAAgB,CAAC,SAAiB;QACzC,MAAM,iBAAiB,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/C,OAAO;YACL,QAAQ,EAAK,iBAAiB,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,SAAS;YACzE,SAAS;YACT,UAAU,EAAG;gBACX,SAAS,EAAU,gBAAgB,CAAC,OAAO;gBAC3C,MAAM,EAAa,aAAa,CAAC,KAAK;gBACtC,QAAQ,EAAW,8BAA8B;gBACjD,YAAY,EAAO,gBAAgB;gBACnC,UAAU,EAAS,kBAAkB;gBACrC,OAAO,EAAY,mBAAmB;gBACtC,QAAQ,EAAW,CAAC;gBACpB,WAAW,EAAQ,6BAA6B;gBAChD,gBAAgB,EAAG,6BAA6B;aACjD;SACqB,CAAC;IAC3B,CAAC;IAED,SAAS,mBAAmB,CAC1B,MAAwC,EACxC,KAAqH;QAErH,OAAO;YACL,EAAE,EAAY,iBAAiB;YAC/B,OAAO;YACP,OAAO;YACP,WAAW,EAAG,6BAA6B;YAC3C,WAAW,EAAG,6BAA6B;YAC3C,KAAK,EAAS;gBACZ,SAAS,EAAE,gBAAgB,CAAC,OAAO;gBACnC,MAAM;gBACN,GAAG,KAAK;aACT;SACiB,CAAC;IACvB,CAAC;IAED,SAAS,mBAAmB,CAC1B,MAA2E,EAC3E,MAAqB;QAErB,OAAO;YACL,UAAU,EAAE;gBACV,SAAS,EAAU,gBAAgB,CAAC,OAAO;gBAC3C,MAAM;gBACN,gBAAgB,EAAG,SAAS;gBAC5B,MAAM;aACP;SACqE,CAAC;IAC3E,CAAC;IAED,KAAK,UAAU,mCAAmC,CAChD,MAA2E,EAC3E,UAA0H,EAC1H,MAAqB;QAErB,MAAM,MAAM,CAAC,yBAAyB,CAAC,yBAAyB,CAAC;YAC/D,eAAe,EAAG,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC;YACrD,eAAe,EAAG,OAAO;YACzB,eAAe,EAAG,OAAO;YACzB,eAAe,EAAG,mBAAmB,CAAC,MAAM,EAAE,UAAU,CAAC;YACzD,YAAY;SACb,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,8DAA8D,CAAC,CAAC;IACnG,CAAC;IAED,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,KAAK,GAA2B;YACpC,SAAS,EAAG,gBAAgB,CAAC,OAAO;YACpC,MAAM,EAAM,aAAa,CAAC,IAAI;YAC9B,QAAQ,EAAI,8BAA8B;YAC1C,SAAS,EAAG,MAAM;SACnB,CAAC;QAEF,MAAM,CAAC,GAAG,EAAE;YACT,yBAAiC,CAAC,WAAW,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC,CAAC;QAClF,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACjB,MAAM,CAAC,GAAG,EAAE;YACT,yBAAiC,CAAC,WAAW,CAAC,gBAAgB,CAAC,YAAY,CAAC,EAAE,KAAK,CAAC,CAAC;QACxF,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACjB,MAAM,CAAC,GAAG,EAAE;YACT,yBAAiC,CAAC,WAAW,CAAC,gBAAgB,CAAC,UAAU,CAAC,EAAE,KAAK,CAAC,CAAC;QACtF,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,+CAA+C,CAAC,CAAC;IAC3E,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,6BAA6B,EAAE,GAAG,EAAE;QAC3C,EAAE,CAAC,wDAAwD,EAAE,KAAK,IAAI,EAAE;YACtE,MAAM,mCAAmC,CACvC,aAAa,CAAC,KAAK,EACnB,EAAE,QAAQ,EAAE,YAAY,EAAE,gBAAgB,EAAE,EAC5C,EAAE,QAAQ,EAAE,CACb,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,6CAA6C,EAAE,KAAK,IAAI,EAAE;YAC3D,MAAM,MAAM,CAAC,yBAAyB,CAAC,yBAAyB,CAAC;gBAC/D,eAAe,EAAE,mBAAmB,CAAC,aAAa,CAAC,KAAK,EAAE;oBACxD,QAAQ;oBACR,YAAY,EAAE,gBAAgB;iBAC/B,CAAC;gBACF,eAAe,EAAG,OAAO;gBACzB,eAAe,EAAG,OAAO;gBACzB,eAAe,EAAG,mBAAmB,CAAC,aAAa,CAAC,KAAK,EAAE;oBACzD,QAAQ;oBACR,YAAY,EAAE,gBAAgB;iBAC/B,CAAC;gBACF,YAAY;aACb,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC;QAC/B,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;YAClE,MAAM,mCAAmC,CACvC,aAAa,CAAC,KAAK,EACnB,EAAE,QAAQ,EAAE,YAAY,EAAE,gBAAgB,EAAE,EAC5C,EAAE,QAAQ,EAAE,YAAY,EAAE,iBAAiB,EAAE,CAC9C,CAAC;YAEF,MAAM,mCAAmC,CACvC,aAAa,CAAC,SAAS,EACvB,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,EAC/B,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,CACpC,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;YAC9D,KAAK,MAAM,MAAM,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,aAAa,CAAC,KAAK,CAAU,EAAE,CAAC;gBACzE,MAAM,MAAM,CAAC,yBAAyB,CAAC,yBAAyB,CAAC;oBAC/D,eAAe,EAAG,mBAAmB,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC;oBAC3D,eAAe,EAAG,OAAO;oBACzB,eAAe,EAAG,OAAO;oBACzB,eAAe,EAAG,mBAAmB,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC;oBAC3D,YAAY;iBACb,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC;YAC/B,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"records-grant-authorization.spec.js","sourceRoot":"","sources":["../../../../tests/core/records-grant-authorization.spec.ts"],"names":[],"mappings":"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"}

package/dist/esm/tests/core/replication-apply.spec.js

@@ -0,0 +1,274 @@
+import { describe, expect, it } from 'bun:test';
+import { TestDataGenerator } from '../utils/test-data-generator.js';
+import { DwnErrorCode, replicationApplyResultFromReply } from '../../src/index.js';
+describe('replicationApplyResultFromReply', () => {
+    it('classifies successful and idempotent replies', async () => {
+        const { message } = await TestDataGenerator.generateRecordsWrite();
+        expect(replicationApplyResultFromReply(message, { status: { code: 202 } }))
+            .toEqual({ kind: 'Applied' });
+        expect(replicationApplyResultFromReply(message, { status: { code: 204 } }))
+            .toEqual({ kind: 'Applied', ancestryOnly: true });
+        expect(replicationApplyResultFromReply(message, {
+            status: { code: 202 },
+            position: { streamId: 's', epoch: 'e', position: '1', messageCid: 'c' },
+        })).toEqual({
+            kind: 'Applied',
+            position: { streamId: 's', epoch: 'e', position: '1', messageCid: 'c' },
+        });
+        expect(replicationApplyResultFromReply(message, { status: { code: 409 } }))
+            .toEqual({ kind: 'Superseded' });
+        expect(replicationApplyResultFromReply(message, {
+            status: {
+                code: 400,
+                detail: `${DwnErrorCode.RecordsWriteNotAllowedAfterDelete}: record is deleted`,
+            },
+        })).toEqual({ kind: 'Superseded' });
+    });
+    it('classifies missing initial writes as retryable dependencies', async () => {
+        const protocol = 'https://example.com/protocol';
+        const { message } = await TestDataGenerator.generateRecordsWrite({ protocol });
+        expect(replicationApplyResultFromReply(message, {
+            status: {
+                code: 400,
+                detail: `${DwnErrorCode.RecordsWriteGetInitialWriteNotFound}: Initial write is not found.`,
+            },
+        })).toEqual({
+            kind: 'Incomplete',
+            missing: [{ type: 'InitialWrite', recordId: message.recordId, protocol }],
+        });
+    });
+    it('classifies protocol and parent misses from status detail', async () => {
+        const protocol = 'https://example.com/protocol';
+        const composedProtocol = 'https://example.com/composed';
+        const { message } = await TestDataGenerator.generateRecordsWrite({ protocol });
+        expect(replicationApplyResultFromReply(message, {
+            status: {
+                code: 400,
+                detail: `${DwnErrorCode.ProtocolAuthorizationProtocolNotFound}: protocol is not installed`,
+            },
+        })).toEqual({
+            kind: 'Incomplete',
+            missing: [{ type: 'Protocol', protocol }],
+        });
+        expect(replicationApplyResultFromReply(message, {
+            status: {
+                code: 400,
+                detail: `${DwnErrorCode.ProtocolsConfigureComposedProtocolNotInstalled}: composed protocol '${composedProtocol}' is not installed`,
+            },
+        })).toEqual({
+            kind: 'Incomplete',
+            missing: [{ type: 'Protocol', protocol: composedProtocol }],
+        });
+        expect(replicationApplyResultFromReply(message, {
+            status: {
+                code: 400,
+                detail: `${DwnErrorCode.ProtocolAuthorizationParentRecordNotFound}: parent record 'parent-record' in protocol '${protocol}' was not found`,
+            },
+        })).toEqual({
+            kind: 'Incomplete',
+            missing: [{ type: 'Parent', recordId: 'parent-record', protocol }],
+        });
+    });
+    it('classifies parent-chain misses with the incoming protocol', async () => {
+        const protocol = 'https://example.com/protocol';
+        const { message } = await TestDataGenerator.generateRecordsWrite({ protocol });
+        expect(replicationApplyResultFromReply(message, {
+            status: {
+                code: 401,
+                detail: `${DwnErrorCode.ProtocolAuthorizationParentNotFoundConstructingRecordChain}: parent with ID parent-record was not found`,
+            },
+        })).toEqual({
+            kind: 'Incomplete',
+            missing: [{ type: 'Ancestor', recordId: 'parent-record', protocol }],
+        });
+    });
+    it('emits Ancestor refs above a batched missing parent in a single Incomplete', async () => {
+        const protocol = 'https://example.com/protocol';
+        const { message } = await TestDataGenerator.generateRecordsWrite({ protocol });
+        expect(replicationApplyResultFromReply(message, {
+            status: {
+                code: 400,
+                detail: `${DwnErrorCode.ProtocolAuthorizationParentRecordNotFound}: Could not find parent record 'baz-record'.`,
+            },
+        }, { missingAncestorRecordIds: ['foo-record', 'bar-record', 'baz-record'] })).toEqual({
+            kind: 'Incomplete',
+            missing: [
+                { type: 'Ancestor', recordId: 'foo-record', protocol },
+                { type: 'Ancestor', recordId: 'bar-record', protocol },
+                { type: 'Parent', recordId: 'baz-record', protocol },
+            ],
+        });
+    });
+    it('emits one Ancestor ref per batched missing ancestor in a single Incomplete', async () => {
+        const protocol = 'https://example.com/protocol';
+        const { message } = await TestDataGenerator.generateRecordsWrite({ protocol });
+        expect(replicationApplyResultFromReply(message, {
+            status: {
+                code: 401,
+                detail: `${DwnErrorCode.ProtocolAuthorizationParentNotFoundConstructingRecordChain}: parent with ID baz-record was not found`,
+            },
+        }, { missingAncestorRecordIds: ['foo-record', 'bar-record', 'baz-record'] })).toEqual({
+            kind: 'Incomplete',
+            missing: [
+                { type: 'Ancestor', recordId: 'foo-record', protocol },
+                { type: 'Ancestor', recordId: 'bar-record', protocol },
+                { type: 'Ancestor', recordId: 'baz-record', protocol },
+            ],
+        });
+    });
+    it('falls back to the failure-named ancestor when the batched missing-ancestor set is empty', async () => {
+        const protocol = 'https://example.com/protocol';
+        const { message } = await TestDataGenerator.generateRecordsWrite({ protocol });
+        expect(replicationApplyResultFromReply(message, {
+            status: {
+                code: 401,
+                detail: `${DwnErrorCode.ProtocolAuthorizationParentNotFoundConstructingRecordChain}: parent with ID parent-record was not found`,
+            },
+        }, { missingAncestorRecordIds: [] })).toEqual({
+            kind: 'Incomplete',
+            missing: [{ type: 'Ancestor', recordId: 'parent-record', protocol }],
+        });
+    });
+    it('classifies grant, record data, and delete initial-write dependencies', async () => {
+        const protocol = 'https://example.com/protocol';
+        const permissionGrantId = 'grant-1';
+        const dataCid = 'bafyreib3xmaq5x6o6lhn5jvcnv6hvgh7e64xw66z3c3rgyk7wwq7qv2b5a';
+        const { message } = await TestDataGenerator.generateRecordsWrite({
+            dataCid,
+            dataSize: 42,
+            permissionGrantId,
+            protocol,
+        });
+        const deleteMessage = await TestDataGenerator.generateRecordsDelete({ recordId: 'deleted-record' });
+        expect(replicationApplyResultFromReply(message, {
+            status: {
+                code: 401,
+                detail: `${DwnErrorCode.GrantAuthorizationGrantMissing}: grant was not found`,
+            },
+        })).toEqual({
+            kind: 'Incomplete',
+            missing: [{ type: 'Grant', permissionGrantId }],
+        });
+        expect(replicationApplyResultFromReply(message, {
+            status: {
+                code: 400,
+                detail: `${DwnErrorCode.RecordsWriteMissingDataInPrevious}: data is missing`,
+            },
+        })).toEqual({
+            kind: 'Incomplete',
+            missing: [{ type: 'RecordData', recordId: message.recordId, dataCid, protocol }],
+        });
+        expect(replicationApplyResultFromReply(deleteMessage.message, {
+            status: { code: 404 },
+        })).toEqual({
+            kind: 'Incomplete',
+            missing: [{ type: 'InitialWrite', recordId: 'deleted-record' }],
+        });
+    });
+    it('classifies missing role records from the signed authorization payload', async () => {
+        const protocol = 'https://example.com/protocol';
+        const protocolRole = 'member';
+        const { author, message } = await TestDataGenerator.generateRecordsWrite({
+            protocol,
+            protocolPath: 'chat/message',
+            protocolRole,
+        });
+        expect(replicationApplyResultFromReply(message, {
+            status: {
+                code: 401,
+                detail: `${DwnErrorCode.ProtocolAuthorizationMatchingRoleRecordNotFound}: matching role record was not found`,
+            },
+        })).toEqual({
+            kind: 'Incomplete',
+            missing: [{
+                    type: 'Role',
+                    protocol,
+                    protocolPath: protocolRole,
+                    recipient: author.did,
+                }],
+        });
+    });
+    it('includes context prefixes for nested role dependencies', async () => {
+        const protocol = 'https://example.com/protocol';
+        const protocolRole = 'thread/member';
+        const { author, message } = await TestDataGenerator.generateRecordsWrite({
+            protocol,
+            protocolPath: 'thread/message',
+            protocolRole,
+        });
+        message.descriptor.contextId = 'thread-context/member-context';
+        expect(replicationApplyResultFromReply(message, {
+            status: {
+                code: 401,
+                detail: `${DwnErrorCode.ProtocolAuthorizationMatchingRoleRecordNotFound}: matching role record was not found`,
+            },
+        })).toEqual({
+            kind: 'Incomplete',
+            missing: [{
+                    type: 'Role',
+                    contextPrefix: 'thread-context',
+                    protocol,
+                    protocolPath: protocolRole,
+                    recipient: author.did,
+                }],
+        });
+    });
+    it('resolves cross-protocol role dependencies through the composing protocol uses map', async () => {
+        const protocol = 'https://example.com/composing-protocol';
+        const roleProtocol = 'https://example.com/roles-protocol';
+        const protocolRole = 'roles:thread/member';
+        const protocolDefinition = {
+            protocol,
+            published: false,
+            uses: {
+                roles: roleProtocol,
+            },
+            types: {
+                message: {},
+            },
+            structure: {
+                message: {},
+            },
+        };
+        const { author, message } = await TestDataGenerator.generateRecordsWrite({
+            protocol,
+            protocolPath: 'message',
+            protocolRole,
+        });
+        message.descriptor.contextId = 'thread-context/member-context';
+        expect(replicationApplyResultFromReply(message, {
+            status: {
+                code: 401,
+                detail: `${DwnErrorCode.ProtocolAuthorizationMatchingRoleRecordNotFound}: matching role record was not found`,
+            },
+        }, { protocolDefinition })).toEqual({
+            kind: 'Incomplete',
+            missing: [{
+                    type: 'Role',
+                    contextPrefix: 'thread-context',
+                    protocol: roleProtocol,
+                    protocolPath: 'thread/member',
+                    recipient: author.did,
+                }],
+        });
+    });
+    it('classifies resolver and storage failures as deferred', async () => {
+        const { message } = await TestDataGenerator.generateRecordsWrite();
+        expect(replicationApplyResultFromReply(message, {
+            status: {
+                code: 401,
+                detail: `${DwnErrorCode.GeneralJwsVerifierGetPublicKeyNotFound}: unable to resolve DID`,
+            },
+        })).toEqual({ kind: 'Deferred', reason: 'resolver-unavailable' });
+        expect(replicationApplyResultFromReply(message, {
+            status: { code: 500, detail: 'storage unavailable' },
+        })).toEqual({ kind: 'Deferred', reason: 'storage' });
+    });
+    it('classifies unmatched client errors as invalid', async () => {
+        const { message } = await TestDataGenerator.generateRecordsWrite();
+        expect(replicationApplyResultFromReply(message, {
+            status: { code: 400 },
+        })).toEqual({ kind: 'Invalid', reason: 'replicated message rejected with status 400' });
+    });
+});
+//# sourceMappingURL=replication-apply.spec.js.map

package/dist/esm/tests/core/replication-apply.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replication-apply.spec.js","sourceRoot":"","sources":["../../../../tests/core/replication-apply.spec.ts"],"names":[],"mappings":"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"}

package/dist/esm/tests/core/replication-replay-property.spec.js

@@ -0,0 +1,350 @@
+import fc from 'fast-check';
+import { rm } from 'node:fs/promises';
+import { TestDataGenerator } from '../utils/test-data-generator.js';
+import { afterAll, describe, expect, it } from 'bun:test';
+import { DataStoreLevel, DataStream, Dwn, DwnInterfaceName, DwnMethodName, Encoder, Jws, Message, MessageStoreLevel, Records, RecordsDelete, Replication, ResumableTaskStoreLevel, Time, } from '../../src/index.js';
+import { DidKey, UniversalResolver } from '@enbox/dids';
+// Keep CI deterministic and cheap; set FAST_CHECK_NUM_RUNS for deeper local or nightly sweeps.
+const numRuns = Math.min(Number(process.env.FAST_CHECK_NUM_RUNS) || 5, 20);
+const replayOperations = [
+    'config-churn',
+    'create-note',
+    'create-pin',
+    'create-profile',
+    'create-thread-reply',
+    'delete-note',
+    'prune-thread',
+    'squash-patch',
+    'update-note',
+];
+describe('replication replay property', () => {
+    const didResolver = new UniversalResolver({ didResolvers: [DidKey] });
+    const harnesses = [];
+    afterAll(async () => {
+        for (const harness of harnesses) {
+            await harness.dwn.close();
+            await rm(harness.dataPath, { force: true, recursive: true });
+        }
+    });
+    it('should replay the retained feed into a fresh DWN with equal live records, fingerprints, and data bytes', async () => {
+        await fc.assert(fc.asyncProperty(fc.record({
+            operations: fc.array(fc.constantFrom(...replayOperations), { minLength: 8, maxLength: 14 }),
+            replayOrderSeed: fc.integer({ min: 0, max: 0xffffffff }),
+            runId: fc.uuid(),
+        }), async ({ operations, replayOrderSeed, runId }) => {
+            const source = await createHarness(`${runId}-source`);
+            const replica = await createHarness(`${runId}-replica`);
+            harnesses.push(source, replica);
+            const alice = await TestDataGenerator.generateDidKeyPersona();
+            const protocol = `https://replay-property.example/${runId}`;
+            await driveSourceMutationPlan(source.dwn, alice, protocol, operations);
+            await replayFeed(source.dwn, replica.dwn, alice, replayOrderSeed);
+            await expectFingerprintsEqual(source.messageStore, replica.messageStore, alice.did, protocol);
+            await expectLiveRecordsEqual(source.dwn, replica.dwn, alice, protocol);
+            await expectOccupantsEqual(source.dwn, replica.dwn, alice, protocol, 'profile', 1);
+            await expectOccupantsEqual(source.dwn, replica.dwn, alice, protocol, 'pin', 2);
+        }), { numRuns, seed: 1046 });
+    });
+    async function createHarness(path) {
+        const dataPath = `__TESTDATA__/replication-replay-property/${path}`;
+        await rm(dataPath, { force: true, recursive: true });
+        const messageStore = new MessageStoreLevel({ location: `${dataPath}/messages` });
+        const dataStore = new DataStoreLevel({ blockstoreLocation: `${dataPath}/data` });
+        const resumableTaskStore = new ResumableTaskStoreLevel({ location: `${dataPath}/resumable-tasks` });
+        const dwn = await Dwn.create({ dataStore, didResolver, messageStore, resumableTaskStore });
+        return { dataPath, dwn, messageStore };
+    }
+});
+async function driveSourceMutationPlan(dwn, alice, protocol, operations) {
+    let sequence = 1;
+    let configRevision = 1;
+    const nextTimestamp = () => Time.createOffsetTimestamp({ seconds: sequence++ }, Time.createTimestamp({ year: 2025, month: 1, day: 1 }));
+    const notes = [];
+    const threads = [];
+    await installProtocol(dwn, alice, protocolDefinition(protocol, configRevision), nextTimestamp());
+    const firstNote = await writeRecord(dwn, alice, protocol, 'note', 'initial-note-a', nextTimestamp());
+    const secondNote = await writeRecord(dwn, alice, protocol, 'note', 'initial-note-b', nextTimestamp());
+    notes.push({ deleted: false, latest: firstNote.recordsWrite, recordId: firstNote.message.recordId }, { deleted: false, latest: secondNote.recordsWrite, recordId: secondNote.message.recordId });
+    await writeRecord(dwn, alice, protocol, 'profile', 'profile-a', nextTimestamp());
+    await writeRecord(dwn, alice, protocol, 'profile', 'profile-b', nextTimestamp());
+    await writeRecord(dwn, alice, protocol, 'pin', 'pin-a', nextTimestamp());
+    await writeRecord(dwn, alice, protocol, 'pin', 'pin-b', nextTimestamp());
+    await writeRecord(dwn, alice, protocol, 'pin', 'pin-c', nextTimestamp());
+    const thread = await writeRecord(dwn, alice, protocol, 'thread', 'thread-a', nextTimestamp());
+    await writeRecord(dwn, alice, protocol, 'thread/reply', 'reply-a', nextTimestamp(), thread.message.contextId);
+    threads.push({ deleted: false, recordId: thread.message.recordId });
+    await writeRecord(dwn, alice, protocol, 'patch', 'patch-before-squash', nextTimestamp());
+    for (const operation of operations) {
+        if (operation === 'config-churn') {
+            configRevision++;
+            await installProtocol(dwn, alice, protocolDefinition(protocol, configRevision), nextTimestamp());
+        }
+        else if (operation === 'create-note') {
+            const note = await writeRecord(dwn, alice, protocol, 'note', `${operation}-${sequence}`, nextTimestamp());
+            notes.push({ deleted: false, latest: note.recordsWrite, recordId: note.message.recordId });
+        }
+        else if (operation === 'create-pin') {
+            await writeRecord(dwn, alice, protocol, 'pin', `${operation}-${sequence}`, nextTimestamp());
+        }
+        else if (operation === 'create-profile') {
+            await writeRecord(dwn, alice, protocol, 'profile', `${operation}-${sequence}`, nextTimestamp());
+        }
+        else if (operation === 'create-thread-reply') {
+            const createdThread = await writeRecord(dwn, alice, protocol, 'thread', `${operation}-thread-${sequence}`, nextTimestamp());
+            await writeRecord(dwn, alice, protocol, 'thread/reply', `${operation}-reply-${sequence}`, nextTimestamp(), createdThread.message.contextId);
+            threads.push({ deleted: false, recordId: createdThread.message.recordId });
+        }
+        else if (operation === 'delete-note') {
+            const note = notes.find(candidate => !candidate.deleted);
+            if (note !== undefined) {
+                await deleteRecord(dwn, alice, note.recordId);
+                note.deleted = true;
+            }
+        }
+        else if (operation === 'prune-thread') {
+            const activeThread = threads.find(candidate => !candidate.deleted);
+            if (activeThread !== undefined) {
+                await deleteRecord(dwn, alice, activeThread.recordId, true);
+                activeThread.deleted = true;
+            }
+        }
+        else if (operation === 'squash-patch') {
+            await writeRecord(dwn, alice, protocol, 'patch', `${operation}-${sequence}`, nextTimestamp(), undefined, true);
+        }
+        else {
+            const note = notes.find(candidate => !candidate.deleted);
+            if (note !== undefined) {
+                const update = await TestDataGenerator.generateFromRecordsWrite({
+                    author: alice,
+                    data: Encoder.stringToBytes(`${operation}-${sequence}`),
+                    existingWrite: note.latest,
+                    messageTimestamp: nextTimestamp(),
+                });
+                const reply = await dwn.processMessage(alice.did, update.message, { dataStream: update.dataStream });
+                expect(reply.status.code).toBe(202);
+                note.latest = update.recordsWrite;
+            }
+        }
+    }
+}
+function protocolDefinition(protocol, revision) {
+    const extraType = `extra${revision}`;
+    return {
+        protocol,
+        published: false,
+        types: {
+            [extraType]: {},
+            note: {},
+            patch: {},
+            pin: {},
+            profile: {},
+            reply: {},
+            thread: {},
+        },
+        structure: {
+            [extraType]: {},
+            note: {},
+            patch: { $squash: true },
+            pin: { $recordLimit: { max: 2, strategy: 'reject' } },
+            profile: { $recordLimit: { max: 1, strategy: 'reject' } },
+            thread: { reply: {} },
+        },
+    };
+}
+async function installProtocol(dwn, alice, definition, timestamp) {
+    const configure = await TestDataGenerator.generateProtocolsConfigure({
+        author: alice,
+        messageTimestamp: timestamp,
+        protocolDefinition: definition,
+    });
+    const reply = await dwn.processMessage(alice.did, configure.message);
+    expect(reply.status.code).toBe(202);
+}
+async function writeRecord(dwn, alice, protocol, protocolPath, data, timestamp, parentContextId, squash) {
+    const record = await TestDataGenerator.generateRecordsWrite({
+        author: alice,
+        data: Encoder.stringToBytes(data),
+        dataFormat: 'text/plain',
+        dateCreated: timestamp,
+        messageTimestamp: timestamp,
+        parentContextId,
+        protocol,
+        protocolPath,
+        schema: `${protocol}/schema/${protocolPath.split('/').at(-1)}`,
+        squash,
+    });
+    const reply = await dwn.processMessage(alice.did, record.message, { dataStream: record.dataStream });
+    expect(reply.status.code).toBe(202);
+    return record;
+}
+async function deleteRecord(dwn, alice, recordId, prune) {
+    const recordsDelete = await RecordsDelete.create({
+        prune,
+        recordId,
+        signer: Jws.createSigner(alice),
+    });
+    const reply = await dwn.processMessage(alice.did, recordsDelete.message);
+    expect(reply.status.code).toBe(202);
+}
+async function replayFeed(source, replica, alice, replayOrderSeed) {
+    const entries = permuteReplayEntries(await queryAllReplayEntries(source, alice), replayOrderSeed);
+    let pending = entries;
+    let incompleteDeferrals = 0;
+    for (let attempt = 0; attempt < entries.length + 1 && pending.length > 0; attempt++) {
+        const nextPending = [];
+        for (const replayEntry of pending) {
+            const { dataBytes, entry } = replayEntry;
+            expect(entry.message).toBeDefined();
+            const result = await replica.applyReplicatedMessage(alice.did, entry.message, {
+                ...(dataBytes === undefined ? {} : { dataStream: DataStream.fromBytes(dataBytes) }),
+            });
+            if (result.kind === 'Incomplete') {
+                incompleteDeferrals++;
+                nextPending.push(replayEntry);
+                continue;
+            }
+            if (result.kind === 'Deferred') {
+                throw new Error(`replay unexpectedly deferred CID ${entry.messageCid}: ${result.reason}`);
+            }
+            expect(['Applied', 'Duplicate', 'Superseded']).toContain(result.kind);
+        }
+        if (nextPending.length === pending.length) {
+            throw new Error(`replay made no progress; unresolved CIDs: ${nextPending.map(item => item.entry.messageCid).join(', ')}`);
+        }
+        pending = nextPending;
+    }
+    expect(pending).toHaveLength(0);
+    expect(incompleteDeferrals).toBeGreaterThan(0);
+}
+// Shuffling puts records before protocol configs, forcing dependency Incomplete outcomes before retry convergence.
+function permuteReplayEntries(entries, replayOrderSeed) {
+    return entries
+        .map((entry, index) => ({
+        entry,
+        group: replayDependencyGroup(entry),
+        index,
+        sortKey: replaySortKey(replayOrderSeed, entry.entry.messageCid, index),
+    }))
+        .sort((left, right) => {
+        const groupComparison = left.group - right.group;
+        if (groupComparison !== 0) {
+            return groupComparison;
+        }
+        const sortKeyComparison = left.sortKey - right.sortKey;
+        if (sortKeyComparison !== 0) {
+            return sortKeyComparison;
+        }
+        return left.index - right.index;
+    })
+        .map(item => item.entry);
+}
+function replayDependencyGroup(replayEntry) {
+    const descriptor = replayEntry.entry.message?.descriptor;
+    return descriptor?.interface === DwnInterfaceName.Protocols && descriptor.method === DwnMethodName.Configure ? 1 : 0;
+}
+function replaySortKey(replayOrderSeed, messageCid, index) {
+    let hash = replayOrderSeed >>> 0;
+    const input = `${messageCid}:${index}`;
+    for (let i = 0; i < input.length; i++) {
+        hash = Math.imul(hash ^ input.charCodeAt(i), 16777619) >>> 0;
+    }
+    return hash;
+}
+async function queryAllReplayEntries(source, alice) {
+    const entries = [];
+    let cursor;
+    while (true) {
+        const query = await TestDataGenerator.generateMessagesQuery({
+            author: alice,
+            cursor,
+            limit: 3,
+        });
+        const reply = await source.processMessage(alice.did, query.message);
+        expect(reply.status.code).toBe(200);
+        for (const entry of reply.entries ?? []) {
+            entries.push({
+                dataBytes: await dataBytesForEntry(source, alice, entry),
+                entry: entry,
+            });
+        }
+        if (reply.drained === true) {
+            break;
+        }
+        cursor = reply.cursor;
+    }
+    return entries;
+}
+async function dataBytesForEntry(source, alice, entry) {
+    if (!isRecordsWriteMessage(entry.message)) {
+        return undefined;
+    }
+    if (entry.encodedData !== undefined) {
+        return Encoder.base64UrlToBytes(entry.encodedData);
+    }
+    const read = await TestDataGenerator.generateMessagesRead({
+        author: alice,
+        messageCid: entry.messageCid,
+    });
+    const reply = await source.processMessage(alice.did, read.message);
+    if (reply.status.code !== 200) {
+        return undefined;
+    }
+    const data = reply.entry?.data;
+    return data === undefined ? undefined : await DataStream.toBytes(data);
+}
+function isRecordsWriteMessage(message) {
+    return typeof message === 'object' && message !== null && Records.isRecordsWrite(message);
+}
+async function expectFingerprintsEqual(source, replica, tenant, protocol) {
+    const scopes = [Replication.globalDomain];
+    expect(await replica.fingerprint(tenant, scopes)).toBe(await source.fingerprint(tenant, scopes));
+    const protocolScopes = [
+        Replication.protocolDomain(protocol),
+        Replication.permissionDomain(protocol),
+    ];
+    expect(await replica.fingerprint(tenant, protocolScopes)).toBe(await source.fingerprint(tenant, protocolScopes));
+}
+async function expectLiveRecordsEqual(source, replica, alice, protocol) {
+    expect(await liveRecordSnapshot(replica, alice, protocol)).toEqual(await liveRecordSnapshot(source, alice, protocol));
+}
+async function liveRecordSnapshot(dwn, alice, protocol) {
+    const query = await TestDataGenerator.generateRecordsQuery({
+        author: alice,
+        filter: { protocol },
+    });
+    const reply = await dwn.processMessage(alice.did, query.message);
+    expect(reply.status.code).toBe(200);
+    const snapshot = [];
+    for (const entry of reply.entries ?? []) {
+        const { encodedData, initialWrite, ...recordsWrite } = entry;
+        snapshot.push({
+            data: encodedData ?? '',
+            initialCid: initialWrite === undefined ? undefined : await Message.getCid(initialWrite),
+            latestCid: await Message.getCid(recordsWrite),
+            protocolPath: recordsWrite.descriptor.protocolPath,
+            recordId: recordsWrite.recordId,
+        });
+    }
+    return snapshot.sort(compareLiveRecords);
+}
+function compareLiveRecords(left, right) {
+    const leftKey = `${left.protocolPath}:${left.recordId}`;
+    const rightKey = `${right.protocolPath}:${right.recordId}`;
+    return leftKey < rightKey ? -1 : leftKey > rightKey ? 1 : 0;
+}
+async function expectOccupantsEqual(source, replica, alice, protocol, protocolPath, expectedMax) {
+    const sourceOccupants = await queryRecordIds(source, alice, protocol, protocolPath);
+    const replicaOccupants = await queryRecordIds(replica, alice, protocol, protocolPath);
+    expect(replicaOccupants).toEqual(sourceOccupants);
+    expect(sourceOccupants.length).toBeLessThanOrEqual(expectedMax);
+}
+async function queryRecordIds(dwn, alice, protocol, protocolPath) {
+    const query = await TestDataGenerator.generateRecordsQuery({
+        author: alice,
+        filter: { protocol, protocolPath },
+    });
+    const reply = await dwn.processMessage(alice.did, query.message);
+    expect(reply.status.code).toBe(200);
+    return (reply.entries ?? []).map(entry => entry.recordId).sort();
+}
+//# sourceMappingURL=replication-replay-property.spec.js.map