@enbox/dwn-sdk-js 0.4.0 → 0.4.2

package/dist/types/src/core/protocols-grant-authorization.d.ts

@@ -1,5 +1,5 @@
-import type { MessageStore } from '../types/message-store.js';
 import type { PermissionGrant } from '../protocols/permission-grant.js';
+import type { ValidationStateReader } from '../types/validation-state-reader.js';
 import type { ProtocolsConfigureMessage, ProtocolsQueryMessage } from '../types/protocols-types.js';
 export declare class ProtocolsGrantAuthorization {
     /**
@@ -10,18 +10,18 @@ export declare class ProtocolsGrantAuthorization {
         expectedGrantor: string;
         expectedGrantee: string;
         permissionGrant: PermissionGrant;
-        messageStore: MessageStore;
+        validationStateReader: ValidationStateReader;
     }): Promise<void>;
     /**
      * Authorizes the scope of a permission grant for a ProtocolsQuery message.
-     * @param messageStore Used to check if the grant has been revoked.
+     * @param validationStateReader Used to check if the grant has been revoked.
      */
     static authorizeQuery(input: {
         expectedGrantor: string;
         expectedGrantee: string;
         incomingMessage: ProtocolsQueryMessage;
         permissionGrant: PermissionGrant;
-        messageStore: MessageStore;
+        validationStateReader: ValidationStateReader;
     }): Promise<void>;
     /**
      * Verifies a ProtocolsConfigure against the scope of the given grant.

package/dist/types/src/core/protocols-grant-authorization.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"protocols-grant-authorization.d.ts","sourceRoot":"","sources":["../../../../src/core/protocols-grant-authorization.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAExE,OAAO,KAAK,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAKpG,qBAAa,2BAA2B;IACtC;;OAEG;WACiB,kBAAkB,CAAC,KAAK,EAAE;QAC5C,yBAAyB,EAAE,yBAAyB,CAAC;QACrD,eAAe,EAAE,MAAM,CAAC;QACxB,eAAe,EAAE,MAAM,CAAC;QACxB,eAAe,EAAE,eAAe,CAAC;QACjC,YAAY,EAAE,YAAY,CAAC;KAC5B,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBjB;;;OAGG;WACiB,cAAc,CAAC,KAAK,EAAE;QACxC,eAAe,EAAE,MAAM,CAAC;QACxB,eAAe,EAAE,MAAM,CAAC;QACxB,eAAe,EAAE,qBAAqB,CAAC;QACvC,eAAe,EAAE,eAAe,CAAC;QACjC,YAAY,EAAE,YAAY,CAAC;KAC5B,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBjB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,WAAW;CAiB3B"}
+{"version":3,"file":"protocols-grant-authorization.d.ts","sourceRoot":"","sources":["../../../../src/core/protocols-grant-authorization.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAExE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AACjF,OAAO,KAAK,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAKpG,qBAAa,2BAA2B;IACtC;;OAEG;WACiB,kBAAkB,CAAC,KAAK,EAAE;QAC5C,yBAAyB,EAAE,yBAAyB,CAAC;QACrD,eAAe,EAAE,MAAM,CAAC;QACxB,eAAe,EAAE,MAAM,CAAC;QACxB,eAAe,EAAE,eAAe,CAAC;QACjC,qBAAqB,EAAE,qBAAqB,CAAC;KAC9C,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBjB;;;OAGG;WACiB,cAAc,CAAC,KAAK,EAAE;QACxC,eAAe,EAAE,MAAM,CAAC;QACxB,eAAe,EAAE,MAAM,CAAC;QACxB,eAAe,EAAE,qBAAqB,CAAC;QACvC,eAAe,EAAE,eAAe,CAAC;QACjC,qBAAqB,EAAE,qBAAqB,CAAC;KAC9C,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBjB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,WAAW;CAiB3B"}

package/dist/types/src/core/recording-validation-state-reader.d.ts

@@ -0,0 +1,75 @@
+import type { GenericMessage } from '../types/message-types.js';
+import type { PermissionGrant } from '../protocols/permission-grant.js';
+import type { ProtocolDefinition } from '../types/protocols-types.js';
+import type { RecordsWrite } from '../interfaces/records-write.js';
+import type { RecordsWriteMessage } from '../types/records-types.js';
+import type { ValidationStateReader } from '../types/validation-state-reader.js';
+/**
+ * One recorded validation-time state read: the reader method invoked.
+ */
+export type RecordedValidationRead = {
+    method: keyof ValidationStateReader;
+};
+/**
+ * A `ValidationStateReader` decorator that records every read before delegating to the wrapped
+ * reader. Used by the replay-basis closure tests (and harnesses) to assert that admission
+ * performs no validation read outside the reader surface, and to keep recorded read-traces as a
+ * regression artifact when validation reads change.
+ *
+ * Inject via `DwnConfig.instrumentValidationStateReader`.
+ */
+export declare class RecordingValidationStateReader implements ValidationStateReader {
+    private readonly inner;
+    private readonly recordedReads;
+    constructor(inner: ValidationStateReader);
+    /** All reads recorded since construction or the last `clearRecordedReads()`. */
+    get reads(): RecordedValidationRead[];
+    /** Clears the recorded reads, e.g. between closure-test scenarios. */
+    clearRecordedReads(): void;
+    /** @inheritdoc */
+    fetchInitialRecordsWrite(tenant: string, recordId: string): Promise<RecordsWrite | undefined>;
+    /** @inheritdoc */
+    fetchInitialWrite(tenant: string, recordId: string): Promise<RecordsWriteMessage | undefined>;
+    /** @inheritdoc */
+    constructRecordChain(tenant: string, descendantRecordId: string | undefined): Promise<RecordsWriteMessage[]>;
+    /** @inheritdoc */
+    fetchParentRecord(input: {
+        tenant: string;
+        parentProtocolUri: string;
+        parentId: string;
+    }): Promise<RecordsWriteMessage | undefined>;
+    /** @inheritdoc */
+    hasMatchingRoleRecord(input: {
+        tenant: string;
+        protocol: string;
+        protocolPath: string;
+        recipient: string;
+        contextIdPrefix?: string;
+    }): Promise<boolean>;
+    /** @inheritdoc */
+    queryLatestRoleRecords(input: {
+        tenant: string;
+        protocol: string;
+        protocolPath: string;
+        recipient: string;
+        contextIdPrefix?: string;
+    }): Promise<RecordsWriteMessage[]>;
+    /** @inheritdoc */
+    fetchGrant(tenant: string, permissionGrantId: string): Promise<PermissionGrant>;
+    /** @inheritdoc */
+    fetchOldestGrantRevocation(tenant: string, permissionGrantId: string): Promise<GenericMessage | undefined>;
+    /** @inheritdoc */
+    fetchNewestRecordsWrite(tenant: string, recordId: string): Promise<RecordsWriteMessage>;
+    /** @inheritdoc */
+    fetchProtocolDefinition(tenant: string, protocolUri: string, messageTimestamp?: string): Promise<ProtocolDefinition>;
+    /** @inheritdoc */
+    fetchLatestSquashRecordAtScope(input: {
+        tenant: string;
+        protocol: string;
+        protocolPath: string;
+        contextIdPrefix?: string;
+    }): Promise<RecordsWriteMessage | undefined>;
+    /** @inheritdoc */
+    hasStoredData(tenant: string, recordId: string, dataCid: string): Promise<boolean>;
+}
+//# sourceMappingURL=recording-validation-state-reader.d.ts.map

package/dist/types/src/core/recording-validation-state-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recording-validation-state-reader.d.ts","sourceRoot":"","sources":["../../../../src/core/recording-validation-state-reader.ts"],"names":[],"mappings":"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"}

package/dist/types/src/core/records-grant-authorization.d.ts

@@ -1,5 +1,5 @@
-import type { MessageStore } from '../types/message-store.js';
 import type { PermissionGrant } from '../protocols/permission-grant.js';
+import type { ValidationStateReader } from '../types/validation-state-reader.js';
 import type { RecordsCountMessage, RecordsDeleteMessage, RecordsQueryMessage, RecordsReadMessage, RecordsSubscribeMessage, RecordsWriteMessage } from '../types/records-types.js';
 export declare class RecordsGrantAuthorization {
     /**
@@ -10,11 +10,11 @@ export declare class RecordsGrantAuthorization {
         expectedGrantor: string;
         expectedGrantee: string;
         permissionGrant: PermissionGrant;
-        messageStore: MessageStore;
+        validationStateReader: ValidationStateReader;
     }): Promise<void>;
     /**
      * Authorizes a RecordsReadMessage using the given permission grant.
-     * @param messageStore Used to check if the given grant has been revoked.
+     * @param validationStateReader Used to check if the given grant has been revoked.
      */
     static authorizeRead(input: {
         recordsReadMessage: RecordsReadMessage;
@@ -22,22 +22,22 @@ export declare class RecordsGrantAuthorization {
         expectedGrantor: string;
         expectedGrantee: string;
         permissionGrant: PermissionGrant;
-        messageStore: MessageStore;
+        validationStateReader: ValidationStateReader;
     }): Promise<void>;
     /**
      * Authorizes the scope of a permission grant for RecordsQuery or RecordsSubscribe.
-     * @param messageStore Used to check if the grant has been revoked.
+     * @param validationStateReader Used to check if the grant has been revoked.
      */
     static authorizeQueryOrSubscribe(input: {
         incomingMessage: RecordsCountMessage | RecordsQueryMessage | RecordsSubscribeMessage;
         expectedGrantor: string;
         expectedGrantee: string;
         permissionGrant: PermissionGrant;
-        messageStore: MessageStore;
+        validationStateReader: ValidationStateReader;
     }): Promise<void>;
     /**
      * Authorizes the scope of a permission grant for RecordsDelete.
-     * @param messageStore Used to check if the grant has been revoked.
+     * @param validationStateReader Used to check if the grant has been revoked.
      */
     static authorizeDelete(input: {
         recordsDeleteMessage: RecordsDeleteMessage;
@@ -45,7 +45,7 @@ export declare class RecordsGrantAuthorization {
         expectedGrantor: string;
         expectedGrantee: string;
         permissionGrant: PermissionGrant;
-        messageStore: MessageStore;
+        validationStateReader: ValidationStateReader;
     }): Promise<void>;
     /**
      * Verifies a record against the scope of the given grant.

package/dist/types/src/core/records-grant-authorization.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"records-grant-authorization.d.ts","sourceRoot":"","sources":["../../../../src/core/records-grant-authorization.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAGxE,OAAO,KAAK,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAOlL,qBAAa,yBAAyB;IACpC;;OAEG;WACiB,cAAc,CAAC,KAAK,EAAE;QACxC,mBAAmB,EAAE,mBAAmB,CAAC;QACzC,eAAe,EAAE,MAAM,CAAC;QACxB,eAAe,EAAE,MAAM,CAAC;QACxB,eAAe,EAAE,eAAe,CAAC;QACjC,YAAY,EAAE,YAAY,CAAC;KAC5B,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBjB;;;OAGG;WACiB,aAAa,CAAC,KAAK,EAAE;QACvC,kBAAkB,EAAE,kBAAkB,CAAC;QACvC,2BAA2B,EAAE,mBAAmB,CAAC;QACjD,eAAe,EAAE,MAAM,CAAC;QACxB,eAAe,EAAE,MAAM,CAAC;QACxB,eAAe,EAAE,eAAe,CAAC;QACjC,YAAY,EAAE,YAAY,CAAC;KAC5B,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBjB;;;OAGG;WACiB,yBAAyB,CAAC,KAAK,EAAE;QACnD,eAAe,EAAE,mBAAmB,GAAG,mBAAmB,GAAG,uBAAuB,CAAC;QACrF,eAAe,EAAE,MAAM,CAAC;QACxB,eAAe,EAAE,MAAM,CAAC;QACxB,eAAe,EAAE,eAAe,CAAC;QACjC,YAAY,EAAE,YAAY,CAAC;KAC5B,GAAG,OAAO,CAAC,IAAI,CAAC;IA6BjB;;;OAGG;WACiB,eAAe,CAAC,KAAK,EAAE;QACzC,oBAAoB,EAAE,oBAAoB,CAAC;QAC3C,oBAAoB,EAAE,mBAAmB,CAAC;QAC1C,eAAe,EAAE,MAAM,CAAC;QACxB,eAAe,EAAE,MAAM,CAAC;QACxB,eAAe,EAAE,eAAe,CAAC;QACjC,YAAY,EAAE,YAAY,CAAC;KAC5B,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBjB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,WAAW;IAoB1B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAoBhC,OAAO,CAAC,MAAM,CAAC,sBAAsB;IAQrC,OAAO,CAAC,MAAM,CAAC,oCAAoC;IA0BnD;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;CAkBhC"}
+{"version":3,"file":"records-grant-authorization.d.ts","sourceRoot":"","sources":["../../../../src/core/records-grant-authorization.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAExE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAEjF,OAAO,KAAK,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAOlL,qBAAa,yBAAyB;IACpC;;OAEG;WACiB,cAAc,CAAC,KAAK,EAAE;QACxC,mBAAmB,EAAE,mBAAmB,CAAC;QACzC,eAAe,EAAE,MAAM,CAAC;QACxB,eAAe,EAAE,MAAM,CAAC;QACxB,eAAe,EAAE,eAAe,CAAC;QACjC,qBAAqB,EAAE,qBAAqB,CAAC;KAC9C,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBjB;;;OAGG;WACiB,aAAa,CAAC,KAAK,EAAE;QACvC,kBAAkB,EAAE,kBAAkB,CAAC;QACvC,2BAA2B,EAAE,mBAAmB,CAAC;QACjD,eAAe,EAAE,MAAM,CAAC;QACxB,eAAe,EAAE,MAAM,CAAC;QACxB,eAAe,EAAE,eAAe,CAAC;QACjC,qBAAqB,EAAE,qBAAqB,CAAC;KAC9C,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBjB;;;OAGG;WACiB,yBAAyB,CAAC,KAAK,EAAE;QACnD,eAAe,EAAE,mBAAmB,GAAG,mBAAmB,GAAG,uBAAuB,CAAC;QACrF,eAAe,EAAE,MAAM,CAAC;QACxB,eAAe,EAAE,MAAM,CAAC;QACxB,eAAe,EAAE,eAAe,CAAC;QACjC,qBAAqB,EAAE,qBAAqB,CAAC;KAC9C,GAAG,OAAO,CAAC,IAAI,CAAC;IA6BjB;;;OAGG;WACiB,eAAe,CAAC,KAAK,EAAE;QACzC,oBAAoB,EAAE,oBAAoB,CAAC;QAC3C,oBAAoB,EAAE,mBAAmB,CAAC;QAC1C,eAAe,EAAE,MAAM,CAAC;QACxB,eAAe,EAAE,MAAM,CAAC;QACxB,eAAe,EAAE,eAAe,CAAC;QACjC,qBAAqB,EAAE,qBAAqB,CAAC;KAC9C,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBjB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,WAAW;IAoB1B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAoBhC,OAAO,CAAC,MAAM,CAAC,sBAAsB;IAQrC,OAAO,CAAC,MAAM,CAAC,oCAAoC;IA0BnD;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;CAkBhC"}

package/dist/types/src/core/replication-apply.d.ts

@@ -1,10 +1,16 @@
 import type { GenericMessage } from '../types/message-types.js';
+import type { ProgressToken } from '../types/subscriptions.js';
 import type { ProtocolDefinition } from '../types/protocols-types.js';
+import type { ValidationStateReader } from '../types/validation-state-reader.js';
 export type ReplicationApplyOptions = {
     dataStream?: ReadableStream<Uint8Array>;
 };
 export type ReplicationApplyResult = {
     kind: 'Applied';
+    /** True when the local store retained dependency ancestry but did not advance latest state. */
+    ancestryOnly?: true;
+    /** Local admission position, when the receiving store has a durable replication log. */
+    position?: ProgressToken;
 } | {
     kind: 'Duplicate';
 } | {
@@ -21,6 +27,14 @@ export type ReplicationApplyResult = {
 };
 export type ReplicationApplyResultContext = {
     protocolDefinition?: ProtocolDefinition;
+    /**
+     * Complete set of locally-missing ancestor recordIds for a missing-ancestor failure
+     * (immediate parent or record-chain construction), ordered root-first with the failure-named
+     * ancestor last, as computed by `missingAncestorRecordIdsFromReply()`. When present, the
+     * resulting `Incomplete` carries one ref per entry so the entire ancestry resolves in a
+     * single fetch pass instead of one ancestry level per retry.
+     */
+    missingAncestorRecordIds?: string[];
 };
 export type DependencyRef = {
     type: 'Protocol';
@@ -89,5 +103,27 @@ export declare function replicationApplyResultFromReply(message: GenericMessage,
         code: number;
         detail?: string;
     };
+    position?: ProgressToken;
 }, context?: ReplicationApplyResultContext): ReplicationApplyResult;
+/**
+ * Computes the complete set of locally-missing ancestor recordIds for a replicated message that
+ * failed on a missing ancestor — either the immediate parent referential check
+ * (`ProtocolAuthorizationParentRecordNotFound`) or record-chain construction
+ * (`ProtocolAuthorizationParentNotFoundConstructingRecordChain`).
+ *
+ * Both failures name a single ancestor, but the message's `contextId` names the full ancestor
+ * recordId chain, so every segment the failed check could not reach is presence-checked here and
+ * all absent segments are returned in one batch (ordered root-first, named ancestor last).
+ * Feeding the result to `replicationApplyResultFromReply()` via `ReplicationApplyResultContext`
+ * lets sync fetch the entire ancestry in a single pass instead of one level per retry.
+ *
+ * @returns the missing ancestor recordIds, or `undefined` when the reply is not a
+ *          missing-ancestor failure or the chain cannot be determined from the message (callers
+ *          then fall back to emitting the single ancestor named by the failure).
+ */
+export declare function missingAncestorRecordIdsFromReply(tenant: string, message: GenericMessage, reply: {
+    status: {
+        detail?: string;
+    };
+}, validationStateReader: ValidationStateReader): Promise<string[] | undefined>;
 //# sourceMappingURL=replication-apply.d.ts.map

package/dist/types/src/core/replication-apply.d.ts.map

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

package/dist/types/src/core/resumable-task-manager.d.ts

@@ -20,7 +20,7 @@ export declare class ResumableTaskManager {
     /**
      * Runs a new resumable task.
      */
-    run(task: ResumableTask): Promise<void>;
+    run<T = unknown>(task: ResumableTask): Promise<T>;
     /**
      * Runs a resumable task with automatic timeout extension.
      * Deletes the task from the resumable task store once it is completed.

package/dist/types/src/core/resumable-task-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resumable-task-manager.d.ts","sourceRoot":"","sources":["../../../../src/core/resumable-task-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,KAAK,EAAwB,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAEjG,oBAAY,iBAAiB;IAC3B,aAAa,kBAAkB;IAC/B,aAAa,kBAAkB;CAChC;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,iBAAiB,CAAC;IACxB,IAAI,EAAE,GAAG,CAAC;CACX,CAAC;AAGF,qBAAa,oBAAoB;IAUZ,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IARtD;;OAEG;IACH,gBAAuB,kCAAkC,MAAM;IAE/D,OAAO,CAAC,sBAAsB,CAAO;IACrC,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAqD;gBAEvD,kBAAkB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,iBAAiB;IAUhH;;OAEG;IACU,GAAG,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAQpD;;;OAGG;YACW,gCAAgC;IAkB9C;;;;OAIG;WACW,0BAA0B,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,GAAG,IAAI;IAIrF;;OAEG;IACU,+BAA+B,IAAI,OAAO,CAAC,IAAI,CAAC;IAa7D;;;OAGG;YACW,yBAAyB;CAkBxC"}
+{"version":3,"file":"resumable-task-manager.d.ts","sourceRoot":"","sources":["../../../../src/core/resumable-task-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,KAAK,EAAwB,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAEjG,oBAAY,iBAAiB;IAC3B,aAAa,kBAAkB;IAC/B,aAAa,kBAAkB;CAChC;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,iBAAiB,CAAC;IACxB,IAAI,EAAE,GAAG,CAAC;CACX,CAAC;AAIF,qBAAa,oBAAoB;IAUZ,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IARtD;;OAEG;IACH,gBAAuB,kCAAkC,MAAM;IAE/D,OAAO,CAAC,sBAAsB,CAAO;IACrC,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAyC;gBAE3C,kBAAkB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,iBAAiB;IAUhH;;OAEG;IACU,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,CAAC,CAAC;IAQ9D;;;OAGG;YACW,gCAAgC;IAmB9C;;;;OAIG;WACW,0BAA0B,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,GAAG,IAAI;IAIrF;;OAEG;IACU,+BAA+B,IAAI,OAAO,CAAC,IAAI,CAAC;IAa7D;;;OAGG;YACW,yBAAyB;CAkBxC"}

package/dist/types/src/core/validation-state-reader.d.ts

@@ -0,0 +1,79 @@
+import type { CoreProtocolRegistry } from './core-protocol.js';
+import type { DataStore } from '../types/data-store.js';
+import type { GenericMessage } from '../types/message-types.js';
+import type { MessageStore } from '../types/message-store.js';
+import type { ValidationStateReader } from '../types/validation-state-reader.js';
+import type { RecordsWriteMessage } from '../types/records-types.js';
+import type { ProtocolDefinition } from '../types/protocols-types.js';
+import { PermissionGrant } from '../protocols/permission-grant.js';
+import { RecordsWrite } from '../interfaces/records-write.js';
+/**
+ * The store-backed `ValidationStateReader` — the single place where validation-time state reads
+ * touch the `MessageStore`/`DataStore`.
+ */
+export declare class StoreValidationStateReader implements ValidationStateReader {
+    private readonly messageStore;
+    private readonly dataStore;
+    private readonly coreProtocols?;
+    constructor(input: {
+        messageStore: MessageStore;
+        dataStore: DataStore;
+        coreProtocols?: CoreProtocolRegistry;
+    });
+    /** @inheritdoc */
+    fetchInitialRecordsWrite(tenant: string, recordId: string): Promise<RecordsWrite | undefined>;
+    /** @inheritdoc */
+    fetchInitialWrite(tenant: string, recordId: string): Promise<RecordsWriteMessage | undefined>;
+    /** @inheritdoc */
+    constructRecordChain(tenant: string, descendantRecordId: string | undefined): Promise<RecordsWriteMessage[]>;
+    /** @inheritdoc */
+    fetchParentRecord(input: {
+        tenant: string;
+        parentProtocolUri: string;
+        parentId: string;
+    }): Promise<RecordsWriteMessage | undefined>;
+    /** @inheritdoc */
+    hasMatchingRoleRecord(input: {
+        tenant: string;
+        protocol: string;
+        protocolPath: string;
+        recipient: string;
+        contextIdPrefix?: string;
+    }): Promise<boolean>;
+    /** @inheritdoc */
+    queryLatestRoleRecords(input: {
+        tenant: string;
+        protocol: string;
+        protocolPath: string;
+        recipient: string;
+        contextIdPrefix?: string;
+    }): Promise<RecordsWriteMessage[]>;
+    /** @inheritdoc */
+    fetchGrant(tenant: string, permissionGrantId: string): Promise<PermissionGrant>;
+    /** @inheritdoc */
+    fetchOldestGrantRevocation(tenant: string, permissionGrantId: string): Promise<GenericMessage | undefined>;
+    /** @inheritdoc */
+    fetchNewestRecordsWrite(tenant: string, recordId: string): Promise<RecordsWriteMessage>;
+    /** @inheritdoc */
+    fetchProtocolDefinition(tenant: string, protocolUri: string, messageTimestamp?: string): Promise<ProtocolDefinition>;
+    /** @inheritdoc */
+    fetchLatestSquashRecordAtScope(input: {
+        tenant: string;
+        protocol: string;
+        protocolPath: string;
+        contextIdPrefix?: string;
+    }): Promise<RecordsWriteMessage | undefined>;
+    /** @inheritdoc */
+    hasStoredData(tenant: string, recordId: string, dataCid: string): Promise<boolean>;
+    /**
+     * Checks whether a `RecordsDelete` tombstone for the given record is locally present.
+     * Retained initial writes can prove immutable parent/role facts, but a tombstone still wins.
+     */
+    private recordHasLocalTombstone;
+    /**
+     * Constructs the role-record selector filter shared by the invoked-role lookup and the
+     * duplicate-role-recipient uniqueness check.
+     */
+    private static constructRoleRecordFilter;
+}
+//# sourceMappingURL=validation-state-reader.d.ts.map

package/dist/types/src/core/validation-state-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-state-reader.d.ts","sourceRoot":"","sources":["../../../../src/core/validation-state-reader.ts"],"names":[],"mappings":"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"}

package/dist/types/src/dwn.d.ts

@@ -2,28 +2,33 @@ import type { DataStore } from './types/data-store.js';
 import type { DidResolver } from '@enbox/dids';
 import type { MessageStore } from './types/message-store.js';
 import type { ResumableTaskStore } from './types/resumable-task-store.js';
-import type { StateIndex } from './types/state-index.js';
 import type { TenantGate } from './core/tenant-gate.js';
 import type { UnionMessageReply } from './core/message-reply.js';
+import type { ValidationStateReader } from './types/validation-state-reader.js';
 import type { EventLog, SubscriptionListener } from './types/subscriptions.js';
 import type { GenericMessage, GenericMessageReply } from './types/message-types.js';
-import type { MessagesReadMessage, MessagesReadReply, MessagesSubscribeMessage, MessagesSubscribeMessageOptions, MessagesSubscribeReply, MessagesSyncMessage, MessagesSyncReply } from './types/messages-types.js';
+import type { MessagesQueryMessage, MessagesQueryReply, MessagesReadMessage, MessagesReadReply, MessagesSubscribeMessage, MessagesSubscribeMessageOptions, MessagesSubscribeReply } from './types/messages-types.js';
 import type { ProtocolsConfigureMessage, ProtocolsQueryMessage, ProtocolsQueryReply } from './types/protocols-types.js';
 import type { RecordsCountMessage, RecordsCountReply, RecordsDeleteMessage, RecordsQueryMessage, RecordsQueryReply, RecordsReadMessage, RecordsReadReply, RecordsSubscribeMessage, RecordsSubscribeMessageOptions, RecordsSubscribeReply, RecordsWriteMessage, RecordsWriteMessageOptions } from './types/records-types.js';
 import type { ReplicationApplyOptions, ReplicationApplyResult } from './core/replication-apply.js';
 import { CoreProtocolRegistry } from './core/core-protocol.js';
+type DwnStorage = {
+    dataStore: DataStore;
+    messageStore: MessageStore;
+    eventLog: EventLog | undefined;
+};
 export declare class Dwn {
     private readonly methodHandlers;
     private readonly didResolver;
     private readonly messageStore;
     private readonly dataStore;
     private readonly resumableTaskStore;
-    private readonly stateIndex;
     private readonly tenantGate;
     private readonly eventLog?;
     private readonly storageController;
     private readonly resumableTaskManager;
     private readonly _coreProtocols;
+    private readonly validationStateReader;
     /** Whether the DWN owns the resolver's lifecycle (i.e., created it via defaults). */
     private readonly ownsResolver;
     private constructor();
@@ -44,23 +49,18 @@ export declare class Dwn {
     get coreProtocols(): CoreProtocolRegistry;
     /**
      * Returns the internal storage components for advanced operations that
-     * cannot be expressed through the standard `processMessage()` pipeline
-     * (e.g., owner-upgrade of externally authored encrypted records).
+     * cannot be expressed through the standard `processMessage()` pipeline.
      *
      * Callers are responsible for maintaining consistency across stores.
      */
-    get storage(): {
-        messageStore: MessageStore;
-        stateIndex: StateIndex;
-        eventLog: EventLog | undefined;
-    };
+    get storage(): DwnStorage;
     /**
      * Processes the given DWN message and returns with a reply.
      * @param tenant The tenant DID to route the given message to.
      */
     processMessage(tenant: string, rawMessage: MessagesSubscribeMessage, options?: MessagesSubscribeMessageOptions): Promise<MessagesSubscribeReply>;
     processMessage(tenant: string, rawMessage: MessagesReadMessage): Promise<MessagesReadReply>;
-    processMessage(tenant: string, rawMessage: MessagesSyncMessage): Promise<MessagesSyncReply>;
+    processMessage(tenant: string, rawMessage: MessagesQueryMessage): Promise<MessagesQueryReply>;
     processMessage(tenant: string, rawMessage: ProtocolsConfigureMessage): Promise<GenericMessageReply>;
     processMessage(tenant: string, rawMessage: ProtocolsQueryMessage): Promise<ProtocolsQueryReply>;
     processMessage(tenant: string, rawMessage: RecordsCountMessage): Promise<RecordsCountReply>;
@@ -78,18 +78,25 @@ export declare class Dwn {
      * message as permanently invalid.
      */
     applyReplicatedMessage(tenant: string, rawMessage: GenericMessage, options?: ReplicationApplyOptions): Promise<ReplicationApplyResult>;
+    /**
+     * Computes the layer-batched missing-ancestor set for a replicated message that failed on a
+     * missing ancestor (immediate parent or record-chain construction), so the resulting
+     * `Incomplete` names every locally-absent ancestor at once. Returns `undefined`
+     * (single-ancestor emission) when the set cannot be computed.
+     */
+    private getReplicationApplyMissingAncestors;
+    private storeReplicatedWriteBeatenByDelete;
+    private validateReplicatedWriteBeatenByDelete;
+    private validateReplicatedWriteBeatenByDeleteOrThrow;
+    private static validateReplicatedWriteBeatenByDeleteDataStream;
+    private validateReplicatedWriteBeatenByDeleteExistingData;
+    private static getDataStreamByteLength;
     private getReplicationApplyProtocolDefinition;
+    private static getReplicationApplyProtocolDefinitionLookup;
     private static getMessageProtocolForReplicationApply;
+    private static isRecordsWriteMessage;
     private replicatedMessageAlreadyStored;
     private getExistingMessagesForReplicationDedup;
-    private static existingReplicatedWriteMayNeedDataCompletion;
-    private repairReplicationIndexesForDuplicate;
-    private eventLogHasMessage;
-    private constructReplicationIndexRepair;
-    private static isNewestStoredMessage;
-    private static getStoredMessageForCid;
-    private getInitialWriteForReplicationEvent;
-    private static replicatedWriteHasQueryableData;
     /**
      * Checks tenant gate to see if tenant is allowed.
      * @param tenant The tenant DID to route the given message to.
@@ -131,9 +138,15 @@ export type DwnConfig = {
      * Optional — if not provided, subscriptions will not be supported.
      */
     eventLog?: EventLog;
+    /**
+     * Instrumentation seam: wraps the internally constructed `ValidationStateReader` before it is
+     * handed to the handlers (e.g. with a `RecordingValidationStateReader`). Used by the
+     * replay-basis closure tests and harnesses to record every validation-time state read.
+     */
+    instrumentValidationStateReader?: (validationStateReader: ValidationStateReader) => ValidationStateReader;
     messageStore: MessageStore;
     dataStore: DataStore;
-    stateIndex: StateIndex;
     resumableTaskStore: ResumableTaskStore;
 };
+export {};
 //# sourceMappingURL=dwn.d.ts.map

package/dist/types/src/dwn.d.ts.map

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

package/dist/types/src/enums/dwn-interface-method.d.ts

@@ -10,7 +10,6 @@ export declare enum DwnMethodName {
     Query = "Query",
     Read = "Read",
     Subscribe = "Subscribe",
-    Sync = "Sync",
     Write = "Write"
 }
 //# sourceMappingURL=dwn-interface-method.d.ts.map

package/dist/types/src/enums/dwn-interface-method.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dwn-interface-method.d.ts","sourceRoot":"","sources":["../../../../src/enums/dwn-interface-method.ts"],"names":[],"mappings":"AAAA,oBAAY,gBAAgB;IAC1B,QAAQ,aAAa;IACrB,SAAS,cAAc;IACvB,OAAO,YAAY;CACpB;AAED,oBAAY,aAAa;IACvB,SAAS,cAAc;IACvB,KAAK,UAAU;IACf,MAAM,WAAW;IACjB,KAAK,UAAU;IACf,IAAI,SAAS;IACb,SAAS,cAAc;IACvB,IAAI,SAAS;IACb,KAAK,UAAU;CAChB"}
+{"version":3,"file":"dwn-interface-method.d.ts","sourceRoot":"","sources":["../../../../src/enums/dwn-interface-method.ts"],"names":[],"mappings":"AAAA,oBAAY,gBAAgB;IAC1B,QAAQ,aAAa;IACrB,SAAS,cAAc;IACvB,OAAO,YAAY;CACpB;AAED,oBAAY,aAAa;IACvB,SAAS,cAAc;IACvB,KAAK,UAAU;IACf,MAAM,WAAW;IACjB,KAAK,UAAU;IACf,IAAI,SAAS;IACb,SAAS,cAAc;IACvB,KAAK,UAAU;CAChB"}

package/dist/types/src/event-stream/durable-event-log.d.ts

@@ -0,0 +1,69 @@
+import type { MessageStore } from '../types/message-store.js';
+import type { EventLog, EventLogReadOptions, EventLogReadResult, EventLogSubscribeOptions, EventSubscription, ProgressToken, ReplicationFeedReader, SubscriptionListener, WakeSubscriber } from '../types/subscriptions.js';
+export type DurableEventLogStore = ReplicationFeedReader & Pick<MessageStore, 'query'>;
+export type DurableEventLogConfig = {
+    /**
+     * Maximum number of log rows read per drain step.
+     * Defaults to 100.
+     */
+    readLimit?: number;
+    /**
+     * Interval for idle re-drain. This bounds dropped-wake latency.
+     * Set to 0 to disable the interval.
+     */
+    idleRedrainIntervalMs?: number;
+    /**
+     * Optional handler for background subscription-drain errors.
+     */
+    errorHandler?: (error: unknown) => void;
+};
+/**
+ * EventLog implementation backed by the durable replication feed.
+ *
+ * Writes are store-owned: MessageStore commits publish wakes after the row is
+ * durable.
+ */
+export declare class DurableEventLog implements EventLog {
+    private readonly store;
+    private readonly wakeSubscriber;
+    private readonly subscriptions;
+    private readonly readLimit;
+    private readonly idleRedrainIntervalMs;
+    private readonly errorHandler;
+    private unsubscribeWake?;
+    private idleRedrainTimer?;
+    private isOpen;
+    constructor(store: DurableEventLogStore, wakeSubscriber: WakeSubscriber, config?: DurableEventLogConfig);
+    open(): Promise<void>;
+    close(): Promise<void>;
+    read(tenant: string, options?: EventLogReadOptions): Promise<EventLogReadResult>;
+    subscribe(tenant: string, id: string, listener: SubscriptionListener, options?: EventLogSubscribeOptions): Promise<EventSubscription>;
+    getReplayBounds(tenant: string): Promise<{
+        oldest: ProgressToken;
+        latest: ProgressToken;
+    } | undefined>;
+    private getInitialCursor;
+    private handleWake;
+    private redrainAll;
+    private scheduleDrain;
+    private handleDrainError;
+    private catchUpSubscription;
+    private getCatchUpHighWater;
+    private deliverCatchUpPage;
+    private drainSubscription;
+    private drainOnce;
+    private deliverEntry;
+    private attachInitialWrites;
+    private attachInitialWrite;
+    private static needsInitialWrite;
+    private static getRecordId;
+    private buildToken;
+    private static getEntryPosition;
+    private static getProgressGapInfo;
+    private static isCatchUpComplete;
+    private static finishCatchUp;
+    private static isLatestBaseState;
+    private static getProtocol;
+    private static detachEntryEncodedData;
+}
+//# sourceMappingURL=durable-event-log.d.ts.map

package/dist/types/src/event-stream/durable-event-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"durable-event-log.d.ts","sourceRoot":"","sources":["../../../../src/event-stream/durable-event-log.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAE9D,OAAO,KAAK,EACV,QAAQ,EAER,mBAAmB,EACnB,kBAAkB,EAClB,wBAAwB,EACxB,iBAAiB,EAGjB,aAAa,EACb,qBAAqB,EAErB,oBAAoB,EAEpB,cAAc,EACf,MAAM,2BAA2B,CAAC;AASnC,MAAM,MAAM,oBAAoB,GAAG,qBAAqB,GAAG,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;AAEvF,MAAM,MAAM,qBAAqB,GAAG;IAClC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAE/B;;OAEG;IACH,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACzC,CAAC;AAsBF;;;;;GAKG;AACH,qBAAa,eAAgB,YAAW,QAAQ;IAU5C,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,cAAc;IAVjC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA+C;IAC7E,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAS;IAC/C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA2B;IACxD,OAAO,CAAC,eAAe,CAAC,CAAa;IACrC,OAAO,CAAC,gBAAgB,CAAC,CAAiC;IAC1D,OAAO,CAAC,MAAM,CAAkB;gBAGb,KAAK,EAAE,oBAAoB,EAC3B,cAAc,EAAE,cAAc,EAC/C,MAAM,GAAE,qBAA0B;IAOvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAkBrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBtB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAQpF,SAAS,CACpB,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,oBAAoB,EAC9B,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,iBAAiB,CAAC;IAwChB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,aAAa,CAAC;QAAC,MAAM,EAAE,aAAa,CAAA;KAAE,GAAG,SAAS,CAAC;YAIrG,gBAAgB;IAS9B,OAAO,CAAC,UAAU;IAUlB,OAAO,CAAC,UAAU;IAUlB,OAAO,CAAC,aAAa;IAWrB,OAAO,CAAC,gBAAgB;YA6BV,mBAAmB;YA+BnB,mBAAmB;YAQnB,kBAAkB;YAyBlB,iBAAiB;YAiBjB,SAAS;YAgCT,YAAY;YA4BZ,mBAAmB;YAYnB,kBAAkB;mBAoBX,iBAAiB;IAStC,OAAO,CAAC,MAAM,CAAC,WAAW;YAUZ,UAAU;IAcxB,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAI/B,OAAO,CAAC,MAAM,CAAC,kBAAkB;IASjC,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAShC,OAAO,CAAC,MAAM,CAAC,aAAa;IAI5B,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAIhC,OAAO,CAAC,MAAM,CAAC,WAAW;IAK1B,OAAO,CAAC,MAAM,CAAC,sBAAsB;CAatC"}

package/dist/types/src/event-stream/event-emitter-wake-publisher.d.ts

@@ -0,0 +1,13 @@
+import type { Wake, WakePublisher } from '../types/subscriptions.js';
+export type WakeListener = (wake: Wake) => void;
+/**
+ * In-process {@link WakePublisher}. Publication is best-effort: listener
+ * failures must not affect the write path that already committed the row.
+ */
+export declare class EventEmitterWakePublisher implements WakePublisher {
+    private readonly emitter;
+    publish(wake: Wake): void;
+    subscribe(listener: WakeListener): () => void;
+    clear(): void;
+}
+//# sourceMappingURL=event-emitter-wake-publisher.d.ts.map

package/dist/types/src/event-stream/event-emitter-wake-publisher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-emitter-wake-publisher.d.ts","sourceRoot":"","sources":["../../../../src/event-stream/event-emitter-wake-publisher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAQrE,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;AAEhD;;;GAGG;AACH,qBAAa,yBAA0B,YAAW,aAAa;IAC7D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAEvC,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAQzB,SAAS,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,IAAI;IAK7C,KAAK,IAAI,IAAI;CAGrB"}