@enbox/dwn-sdk-js 0.3.9 → 0.4.1

package/dist/esm/src/core/protocols-grant-authorization.js

@@ -5,28 +5,28 @@ export class ProtocolsGrantAuthorization {
      * Authorizes the given ProtocolsConfigure in the scope of the DID given.
      */
     static async authorizeConfigure(input) {
-        const { protocolsConfigureMessage, expectedGrantor, expectedGrantee, permissionGrant, messageStore } = input;
+        const { protocolsConfigureMessage, expectedGrantor, expectedGrantee, permissionGrant, validationStateReader } = input;
         await GrantAuthorization.performBaseValidation({
             incomingMessage: protocolsConfigureMessage,
             expectedGrantor,
             expectedGrantee,
             permissionGrant,
-            messageStore
+            validationStateReader
         });
         ProtocolsGrantAuthorization.verifyScope(protocolsConfigureMessage, permissionGrant.scope);
     }
     /**
      * 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 async authorizeQuery(input) {
-        const { expectedGrantee, expectedGrantor, incomingMessage, permissionGrant, messageStore } = input;
+        const { expectedGrantee, expectedGrantor, incomingMessage, permissionGrant, validationStateReader } = input;
         await GrantAuthorization.performBaseValidation({
             incomingMessage: incomingMessage,
             expectedGrantor,
             expectedGrantee,
             permissionGrant,
-            messageStore
+            validationStateReader
         });
         // If the grant specifies a protocol, the query must specify the same protocol.
         const permissionScope = permissionGrant.scope;

package/dist/esm/src/core/protocols-grant-authorization.js.map

@@ -1 +1 @@
-{"version":3,"file":"protocols-grant-authorization.js","sourceRoot":"","sources":["../../../../src/core/protocols-grant-authorization.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAExD,MAAM,OAAO,2BAA2B;IACtC;;OAEG;IACI,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,KAMtC;QACC,MAAM,EACJ,yBAAyB,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,EAAE,YAAY,EAC3F,GAAG,KAAK,CAAC;QAEV,MAAM,kBAAkB,CAAC,qBAAqB,CAAC;YAC7C,eAAe,EAAE,yBAAyB;YAC1C,eAAe;YACf,eAAe;YACf,eAAe;YACf,YAAY;SACb,CAAC,CAAC;QAEH,2BAA2B,CAAC,WAAW,CAAC,yBAAyB,EAAE,eAAe,CAAC,KAAgC,CAAC,CAAC;IACvH,CAAC;IAED;;;OAGG;IACI,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,KAMlC;QACC,MAAM,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,EAAE,YAAY,EAAE,GAAG,KAAK,CAAC;QAEnG,MAAM,kBAAkB,CAAC,qBAAqB,CAAC;YAC7C,eAAe,EAAE,eAAe;YAChC,eAAe;YACf,eAAe;YACf,eAAe;YACf,YAAY;SACb,CAAC,CAAC;QAEH,+EAA+E;QAC/E,MAAM,eAAe,GAAG,eAAe,CAAC,KAAgC,CAAC;QACzE,MAAM,eAAe,GAAG,eAAe,CAAC,QAAQ,CAAC;QACjD,MAAM,iBAAiB,GAAG,eAAe,CAAC,UAAU,CAAC,MAAM,EAAE,QAAQ,CAAC;QACtE,IAAI,eAAe,KAAK,SAAS,IAAI,iBAAiB,KAAK,eAAe,EAAE,CAAC;YAC3E,MAAM,IAAI,QAAQ,CAChB,YAAY,CAAC,qDAAqD,EAClE,wBAAwB,eAAe,uCAAuC,iBAAiB,EAAE,CAClG,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,WAAW,CACxB,yBAAoD,EACpD,UAAmC;QAGnC,mFAAmF;QACnF,IAAI,UAAU,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACtC,OAAO;QACT,CAAC;QAED,IAAI,UAAU,CAAC,QAAQ,KAAK,yBAAyB,CAAC,UAAU,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;YACrF,MAAM,IAAI,QAAQ,CAChB,YAAY,CAAC,gDAAgD,EAC7D,sFAAsF,CACvF,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"protocols-grant-authorization.js","sourceRoot":"","sources":["../../../../src/core/protocols-grant-authorization.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAExD,MAAM,OAAO,2BAA2B;IACtC;;OAEG;IACI,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,KAMtC;QACC,MAAM,EACJ,yBAAyB,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,EAAE,qBAAqB,EACpG,GAAG,KAAK,CAAC;QAEV,MAAM,kBAAkB,CAAC,qBAAqB,CAAC;YAC7C,eAAe,EAAE,yBAAyB;YAC1C,eAAe;YACf,eAAe;YACf,eAAe;YACf,qBAAqB;SACtB,CAAC,CAAC;QAEH,2BAA2B,CAAC,WAAW,CAAC,yBAAyB,EAAE,eAAe,CAAC,KAAgC,CAAC,CAAC;IACvH,CAAC;IAED;;;OAGG;IACI,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,KAMlC;QACC,MAAM,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,EAAE,qBAAqB,EAAE,GAAG,KAAK,CAAC;QAE5G,MAAM,kBAAkB,CAAC,qBAAqB,CAAC;YAC7C,eAAe,EAAE,eAAe;YAChC,eAAe;YACf,eAAe;YACf,eAAe;YACf,qBAAqB;SACtB,CAAC,CAAC;QAEH,+EAA+E;QAC/E,MAAM,eAAe,GAAG,eAAe,CAAC,KAAgC,CAAC;QACzE,MAAM,eAAe,GAAG,eAAe,CAAC,QAAQ,CAAC;QACjD,MAAM,iBAAiB,GAAG,eAAe,CAAC,UAAU,CAAC,MAAM,EAAE,QAAQ,CAAC;QACtE,IAAI,eAAe,KAAK,SAAS,IAAI,iBAAiB,KAAK,eAAe,EAAE,CAAC;YAC3E,MAAM,IAAI,QAAQ,CAChB,YAAY,CAAC,qDAAqD,EAClE,wBAAwB,eAAe,uCAAuC,iBAAiB,EAAE,CAClG,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,WAAW,CACxB,yBAAoD,EACpD,UAAmC;QAGnC,mFAAmF;QACnF,IAAI,UAAU,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACtC,OAAO;QACT,CAAC;QAED,IAAI,UAAU,CAAC,QAAQ,KAAK,yBAAyB,CAAC,UAAU,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;YACrF,MAAM,IAAI,QAAQ,CAChB,YAAY,CAAC,gDAAgD,EAC7D,sFAAsF,CACvF,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/dist/esm/src/core/recording-validation-state-reader.js

@@ -0,0 +1,84 @@
+/**
+ * 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 class RecordingValidationStateReader {
+    inner;
+    recordedReads = [];
+    constructor(inner) {
+        this.inner = inner;
+    }
+    /** All reads recorded since construction or the last `clearRecordedReads()`. */
+    get reads() {
+        return [...this.recordedReads];
+    }
+    /** Clears the recorded reads, e.g. between closure-test scenarios. */
+    clearRecordedReads() {
+        this.recordedReads.length = 0;
+    }
+    /** @inheritdoc */
+    async fetchInitialRecordsWrite(tenant, recordId) {
+        this.recordedReads.push({ method: 'fetchInitialRecordsWrite' });
+        return this.inner.fetchInitialRecordsWrite(tenant, recordId);
+    }
+    /** @inheritdoc */
+    async fetchInitialWrite(tenant, recordId) {
+        this.recordedReads.push({ method: 'fetchInitialWrite' });
+        return this.inner.fetchInitialWrite(tenant, recordId);
+    }
+    /** @inheritdoc */
+    async constructRecordChain(tenant, descendantRecordId) {
+        this.recordedReads.push({ method: 'constructRecordChain' });
+        return this.inner.constructRecordChain(tenant, descendantRecordId);
+    }
+    /** @inheritdoc */
+    async fetchParentRecord(input) {
+        this.recordedReads.push({ method: 'fetchParentRecord' });
+        return this.inner.fetchParentRecord(input);
+    }
+    /** @inheritdoc */
+    async hasMatchingRoleRecord(input) {
+        this.recordedReads.push({ method: 'hasMatchingRoleRecord' });
+        return this.inner.hasMatchingRoleRecord(input);
+    }
+    /** @inheritdoc */
+    async queryLatestRoleRecords(input) {
+        this.recordedReads.push({ method: 'queryLatestRoleRecords' });
+        return this.inner.queryLatestRoleRecords(input);
+    }
+    /** @inheritdoc */
+    async fetchGrant(tenant, permissionGrantId) {
+        this.recordedReads.push({ method: 'fetchGrant' });
+        return this.inner.fetchGrant(tenant, permissionGrantId);
+    }
+    /** @inheritdoc */
+    async fetchOldestGrantRevocation(tenant, permissionGrantId) {
+        this.recordedReads.push({ method: 'fetchOldestGrantRevocation' });
+        return this.inner.fetchOldestGrantRevocation(tenant, permissionGrantId);
+    }
+    /** @inheritdoc */
+    async fetchNewestRecordsWrite(tenant, recordId) {
+        this.recordedReads.push({ method: 'fetchNewestRecordsWrite' });
+        return this.inner.fetchNewestRecordsWrite(tenant, recordId);
+    }
+    /** @inheritdoc */
+    async fetchProtocolDefinition(tenant, protocolUri, messageTimestamp) {
+        this.recordedReads.push({ method: 'fetchProtocolDefinition' });
+        return this.inner.fetchProtocolDefinition(tenant, protocolUri, messageTimestamp);
+    }
+    /** @inheritdoc */
+    async fetchLatestSquashRecordAtScope(input) {
+        this.recordedReads.push({ method: 'fetchLatestSquashRecordAtScope' });
+        return this.inner.fetchLatestSquashRecordAtScope(input);
+    }
+    /** @inheritdoc */
+    async hasStoredData(tenant, recordId, dataCid) {
+        this.recordedReads.push({ method: 'hasStoredData' });
+        return this.inner.hasStoredData(tenant, recordId, dataCid);
+    }
+}
+//# sourceMappingURL=recording-validation-state-reader.js.map

package/dist/esm/src/core/recording-validation-state-reader.js.map

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

package/dist/esm/src/core/records-grant-authorization.js

@@ -7,13 +7,13 @@ export class RecordsGrantAuthorization {
      * Authorizes the given RecordsWrite in the scope of the DID given.
      */
     static async authorizeWrite(input) {
-        const { recordsWriteMessage, expectedGrantor, expectedGrantee, permissionGrant, messageStore } = input;
+        const { recordsWriteMessage, expectedGrantor, expectedGrantee, permissionGrant, validationStateReader } = input;
         await GrantAuthorization.performBaseValidation({
             incomingMessage: recordsWriteMessage,
             expectedGrantor,
             expectedGrantee,
             permissionGrant,
-            messageStore
+            validationStateReader
         });
         // NOTE: validated the invoked permission is for Records in GrantAuthorization.performBaseValidation()
         RecordsGrantAuthorization.verifyScope(recordsWriteMessage, permissionGrant.scope);
@@ -21,32 +21,32 @@ export class RecordsGrantAuthorization {
     }
     /**
      * 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 async authorizeRead(input) {
-        const { recordsReadMessage, recordsWriteMessageToBeRead, expectedGrantor, expectedGrantee, permissionGrant, messageStore } = input;
+        const { recordsReadMessage, recordsWriteMessageToBeRead, expectedGrantor, expectedGrantee, permissionGrant, validationStateReader } = input;
         await GrantAuthorization.performBaseValidation({
             incomingMessage: recordsReadMessage,
             expectedGrantor,
             expectedGrantee,
             permissionGrant,
-            messageStore
+            validationStateReader
         });
         // NOTE: validated the invoked permission is for Records in GrantAuthorization.performBaseValidation()
         RecordsGrantAuthorization.verifyScope(recordsWriteMessageToBeRead, permissionGrant.scope);
     }
     /**
      * 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 async authorizeQueryOrSubscribe(input) {
-        const { incomingMessage, expectedGrantor, expectedGrantee, permissionGrant, messageStore } = input;
+        const { incomingMessage, expectedGrantor, expectedGrantee, permissionGrant, validationStateReader } = input;
         await GrantAuthorization.performBaseValidation({
             incomingMessage,
             expectedGrantor,
             expectedGrantee,
             permissionGrant,
-            messageStore
+            validationStateReader
         });
         // The grant's protocol must match the query/subscribe filter's protocol.
         // NOTE: validated the invoked permission is for Records in GrantAuthorization.performBaseValidation()
@@ -62,16 +62,16 @@ export class RecordsGrantAuthorization {
     }
     /**
      * 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 async authorizeDelete(input) {
-        const { recordsDeleteMessage, recordsWriteToDelete, expectedGrantor, expectedGrantee, permissionGrant, messageStore } = input;
+        const { recordsDeleteMessage, recordsWriteToDelete, expectedGrantor, expectedGrantee, permissionGrant, validationStateReader } = input;
         await GrantAuthorization.performBaseValidation({
             incomingMessage: recordsDeleteMessage,
             expectedGrantor,
             expectedGrantee,
             permissionGrant,
-            messageStore
+            validationStateReader
         });
         // NOTE: validated the invoked permission is for Records in GrantAuthorization.performBaseValidation()
         RecordsGrantAuthorization.verifyDeleteScope(recordsWriteToDelete, permissionGrant.scope);

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

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

package/dist/esm/src/core/replication-apply.js

@@ -0,0 +1,295 @@
+import { DwnErrorCode } from './dwn-error.js';
+import { Encoder } from '../utils/encoder.js';
+import { Message } from './message.js';
+import { DwnInterfaceName, DwnMethodName } from '../enums/dwn-interface-method.js';
+import { isCrossProtocolRef, parseCrossProtocolRef } from '../utils/protocols.js';
+/**
+ * Converts a regular handler reply into the structured result consumed by
+ * replication sync. The DWN handler remains the dependency authority; this
+ * adapter only gives the sync transport a typed way to distinguish missing
+ * dependencies from terminal invalid messages.
+ */
+export function replicationApplyResultFromReply(message, reply, context = {}) {
+    const { code, detail = '' } = reply.status;
+    if (code === 202 || code === 204) {
+        return {
+            kind: 'Applied',
+            ...(code === 204 ? { ancestryOnly: true } : {}),
+            ...(reply.position === undefined ? {} : { position: reply.position }),
+        };
+    }
+    if (code === 409) {
+        return { kind: 'Superseded' };
+    }
+    if (getDwnErrorCode(detail) === DwnErrorCode.RecordsWriteNotAllowedAfterDelete) {
+        return { kind: 'Superseded' };
+    }
+    if (isResolverFailure(detail)) {
+        return { kind: 'Deferred', reason: 'resolver-unavailable' };
+    }
+    const missing = dependencyRefsFromStatus(message, code, detail, context);
+    if (missing.length > 0) {
+        return { kind: 'Incomplete', missing };
+    }
+    if (code >= 500) {
+        return { kind: 'Deferred', reason: 'storage' };
+    }
+    return { kind: 'Invalid', reason: detail || `replicated message rejected with status ${code}` };
+}
+/**
+ * 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 async function missingAncestorRecordIdsFromReply(tenant, message, reply, validationStateReader) {
+    const detail = reply.status.detail ?? '';
+    const errorCode = getDwnErrorCode(detail);
+    let namedRecordId;
+    if (errorCode === DwnErrorCode.ProtocolAuthorizationParentRecordNotFound) {
+        namedRecordId = parentRecordIdFromMessage(message, detail);
+    }
+    else if (errorCode === DwnErrorCode.ProtocolAuthorizationParentNotFoundConstructingRecordChain) {
+        namedRecordId = ancestorRecordIdFromDetail(detail);
+    }
+    else {
+        return undefined;
+    }
+    const contextId = message.contextId;
+    if (namedRecordId === undefined || typeof contextId !== 'string') {
+        return undefined;
+    }
+    // `contextId` is the ancestor recordId chain ending with the record's own recordId. The failed
+    // check stopped at `namedRecordId`, so every segment below it is locally present; only the
+    // segments above it (closer to the root) still need a presence check. Presence means an initial
+    // write exists — exactly what record-chain construction reads for the segments above the
+    // immediate parent.
+    const ancestorRecordIds = contextId.split('/').slice(0, -1);
+    const namedIndex = ancestorRecordIds.indexOf(namedRecordId);
+    if (namedIndex === -1) {
+        return undefined;
+    }
+    const missingRecordIds = [];
+    for (const ancestorRecordId of ancestorRecordIds.slice(0, namedIndex)) {
+        const initialWrite = await validationStateReader.fetchInitialWrite(tenant, ancestorRecordId);
+        if (initialWrite === undefined) {
+            missingRecordIds.push(ancestorRecordId);
+        }
+    }
+    missingRecordIds.push(namedRecordId);
+    return missingRecordIds;
+}
+function dependencyRefsFromStatus(message, code, detail, context) {
+    const errorCode = getDwnErrorCode(detail);
+    switch (errorCode) {
+        case DwnErrorCode.ProtocolAuthorizationProtocolNotFound:
+        case DwnErrorCode.ProtocolsConfigureComposedProtocolNotInstalled:
+            return toRefList(protocolDependencyFromMessage(message, detail));
+        case DwnErrorCode.ProtocolAuthorizationParentRecordNotFound:
+            return parentDependenciesFromMessage(message, detail, context);
+        case DwnErrorCode.ProtocolAuthorizationCrossProtocolParentNotFound:
+            return toRefList(parentDependencyFromMessage(message, detail));
+        case DwnErrorCode.ProtocolAuthorizationParentNotFoundConstructingRecordChain:
+            return ancestorDependenciesFromMessage(message, detail, context);
+        case DwnErrorCode.RecordsWriteGetInitialWriteNotFound:
+            return toRefList(initialWriteDependencyFromMessage(message));
+        case DwnErrorCode.GrantAuthorizationGrantMissing:
+            return toRefList(grantDependencyFromMessage(message));
+        case DwnErrorCode.ProtocolAuthorizationMatchingRoleRecordNotFound:
+            return toRefList(roleDependencyFromMessage(message, context));
+        case DwnErrorCode.RecordsWriteMissingDataInPrevious:
+        case DwnErrorCode.RecordsWriteMissingEncodedDataInPrevious:
+            return toRefList(recordDataDependencyFromMessage(message));
+        default:
+            break;
+    }
+    if (code === 404 && isRecordsDelete(message)) {
+        return [{ type: 'InitialWrite', recordId: getRecordsDeleteRecordId(message) }];
+    }
+    return [];
+}
+function toRefList(ref) {
+    return ref === undefined ? [] : [ref];
+}
+function getDwnErrorCode(detail) {
+    const delimiter = detail.indexOf(':');
+    return delimiter === -1 ? undefined : detail.slice(0, delimiter);
+}
+function isResolverFailure(detail) {
+    return getDwnErrorCode(detail) === DwnErrorCode.GeneralJwsVerifierGetPublicKeyNotFound;
+}
+function protocolDependencyFromMessage(message, detail) {
+    const composedProtocol = /composed protocol '([^']+)'/.exec(detail)?.[1];
+    if (composedProtocol !== undefined) {
+        return { type: 'Protocol', protocol: composedProtocol };
+    }
+    const protocol = message.descriptor.protocol;
+    return typeof protocol === 'string' ? { type: 'Protocol', protocol } : undefined;
+}
+/**
+ * Emits the refs for an immediate-parent referential failure. The missing parent keeps its
+ * existing `Parent` ref; when the apply context carries the layer-batched missing-ancestor set
+ * (see `missingAncestorRecordIdsFromReply()`), an `Ancestor` ref is additionally emitted for
+ * every locally-absent segment above the parent, so the entire ancestry resolves in a single
+ * fetch pass instead of one level per retry.
+ */
+function parentDependenciesFromMessage(message, detail, context) {
+    const parentRef = parentDependencyFromMessage(message, detail);
+    if (parentRef === undefined) {
+        return [];
+    }
+    const protocol = message.descriptor.protocol;
+    const protocolProperty = typeof protocol === 'string' ? { protocol } : {};
+    const ancestorRefs = (context.missingAncestorRecordIds ?? [])
+        .filter((recordId) => recordId !== parentRef.recordId)
+        .map((recordId) => ({ type: 'Ancestor', recordId, ...protocolProperty }));
+    return [...ancestorRefs, parentRef];
+}
+function parentDependencyFromMessage(message, detail) {
+    const descriptor = message.descriptor;
+    const parentId = parentRecordIdFromMessage(message, detail);
+    const protocol = /in protocol '([^']+)'/.exec(detail)?.[1] ?? descriptor.protocol;
+    if (parentId === undefined || typeof protocol !== 'string') {
+        return undefined;
+    }
+    return { type: 'Parent', recordId: parentId, protocol };
+}
+function parentRecordIdFromMessage(message, detail) {
+    const descriptor = message.descriptor;
+    return typeof descriptor.parentId === 'string'
+        ? descriptor.parentId
+        : /parent record '([^']+)'/.exec(detail)?.[1];
+}
+/**
+ * Emits `Ancestor` refs for a record-chain construction failure. When the apply context carries
+ * the layer-batched missing-ancestor set (see `missingAncestorRecordIdsFromReply()`), one ref is
+ * emitted per missing segment so the entire ancestry resolves in a single fetch pass; otherwise
+ * falls back to the single ancestor named by the failure detail (e.g. for messages that carry no
+ * `contextId` chain).
+ */
+function ancestorDependenciesFromMessage(message, detail, context) {
+    const protocol = message.descriptor.protocol;
+    const protocolProperty = typeof protocol === 'string' ? { protocol } : {};
+    const batchedRecordIds = context.missingAncestorRecordIds;
+    if (batchedRecordIds !== undefined && batchedRecordIds.length > 0) {
+        return batchedRecordIds.map((recordId) => ({ type: 'Ancestor', recordId, ...protocolProperty }));
+    }
+    const namedRecordId = ancestorRecordIdFromDetail(detail);
+    if (namedRecordId === undefined) {
+        return [];
+    }
+    return [{ type: 'Ancestor', recordId: namedRecordId, ...protocolProperty }];
+}
+function ancestorRecordIdFromDetail(detail) {
+    return /ID ([^ ]+)/.exec(detail)?.[1];
+}
+function initialWriteDependencyFromMessage(message) {
+    if (!isRecordsWrite(message)) {
+        return undefined;
+    }
+    const protocol = message.descriptor.protocol;
+    return {
+        type: 'InitialWrite',
+        recordId: message.recordId,
+        ...(typeof protocol === 'string' ? { protocol } : {}),
+    };
+}
+function grantDependencyFromMessage(message) {
+    const descriptorGrantId = message.descriptor.permissionGrantId;
+    if (typeof descriptorGrantId === 'string') {
+        return { type: 'Grant', permissionGrantId: descriptorGrantId };
+    }
+    const payloadGrantId = getSignaturePayload(message)?.permissionGrantId;
+    return typeof payloadGrantId === 'string'
+        ? { type: 'Grant', permissionGrantId: payloadGrantId }
+        : undefined;
+}
+function recordDataDependencyFromMessage(message) {
+    if (!isRecordsWrite(message)) {
+        return undefined;
+    }
+    const descriptor = message.descriptor;
+    const dataCid = descriptor.dataCid;
+    const protocol = descriptor.protocol;
+    return typeof dataCid === 'string'
+        ? {
+            type: 'RecordData',
+            recordId: message.recordId,
+            dataCid,
+            ...(typeof protocol === 'string' ? { protocol } : {}),
+        }
+        : undefined;
+}
+function roleDependencyFromMessage(message, context) {
+    const descriptor = message.descriptor;
+    const filter = descriptor.filter;
+    const protocol = descriptor.protocol ?? filter?.protocol;
+    const protocolRole = getSignaturePayload(message)?.protocolRole;
+    const recipient = Message.getAuthor(message);
+    if (typeof protocol !== 'string' || typeof protocolRole !== 'string' || recipient === undefined) {
+        return undefined;
+    }
+    let roleProtocol = protocol;
+    let roleProtocolPath = protocolRole;
+    if (isCrossProtocolRef(protocolRole)) {
+        const parsed = parseCrossProtocolRef(protocolRole);
+        const referencedProtocol = parsed === undefined ? undefined : context.protocolDefinition?.uses?.[parsed.alias];
+        if (parsed !== undefined && referencedProtocol !== undefined) {
+            roleProtocol = referencedProtocol;
+            roleProtocolPath = parsed.protocolPath;
+        }
+    }
+    let contextId;
+    if (typeof descriptor.contextId === 'string') {
+        contextId = descriptor.contextId;
+    }
+    else if (typeof filter?.contextId === 'string') {
+        contextId = filter.contextId;
+    }
+    const roleSegments = roleProtocolPath.split('/').length - 1;
+    const contextPrefix = roleSegments > 0 && contextId !== undefined
+        ? contextId.split('/').slice(0, roleSegments).join('/')
+        : undefined;
+    return {
+        type: 'Role',
+        protocol: roleProtocol,
+        protocolPath: roleProtocolPath,
+        recipient,
+        ...(contextPrefix === undefined ? {} : { contextPrefix }),
+    };
+}
+function isRecordsWrite(message) {
+    return message.descriptor.interface === DwnInterfaceName.Records &&
+        message.descriptor.method === DwnMethodName.Write &&
+        typeof message.recordId === 'string';
+}
+function isRecordsDelete(message) {
+    return message.descriptor.interface === DwnInterfaceName.Records &&
+        message.descriptor.method === DwnMethodName.Delete;
+}
+function getRecordsDeleteRecordId(message) {
+    return message.descriptor.recordId;
+}
+function getSignaturePayload(message) {
+    const payload = message.authorization?.signature.payload;
+    if (payload === undefined) {
+        return undefined;
+    }
+    try {
+        return Encoder.base64UrlToObject(payload);
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=replication-apply.js.map

package/dist/esm/src/core/replication-apply.js.map

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

package/dist/esm/src/core/resumable-task-manager.js

@@ -17,8 +17,8 @@ export class ResumableTaskManager {
         this.resumableTaskHandlers = {
             // NOTE: The arrow function is IMPORTANT here, else the `this` context will be lost within the invoked method.
             // e.g. code within performRecordsDelete() won't know `this` refers to the `storageController` instance.
-            [ResumableTaskName.RecordsDelete]: async (task) => await storageController.performRecordsDelete(task),
-            [ResumableTaskName.RecordsSquash]: async (task) => await storageController.performRecordsSquash(task),
+            [ResumableTaskName.RecordsDelete]: async (task) => storageController.performRecordsDelete(task),
+            [ResumableTaskName.RecordsSquash]: async (task) => storageController.performRecordsSquash(task),
         };
     }
     /**
@@ -28,7 +28,7 @@ export class ResumableTaskManager {
         const timeoutInSeconds = ResumableTaskManager.timeoutExtensionFrequencyInSeconds * 2; // give ample time for extension to take place
         // register the new resumable task before running it so that it can be resumed if it times out for any reason
         const managedResumableTask = await this.resumableTaskStore.register(task, timeoutInSeconds);
-        await this.runWithAutomaticTimeoutExtension(managedResumableTask);
+        return this.runWithAutomaticTimeoutExtension(managedResumableTask);
     }
     /**
      * Runs a resumable task with automatic timeout extension.
@@ -43,8 +43,9 @@ export class ResumableTaskManager {
                 this.resumableTaskStore.extend(managedTask.id, timeoutInSeconds);
             }, ResumableTaskManager.timeoutExtensionFrequencyInSeconds * 1000);
             const handler = this.resumableTaskHandlers[managedTask.task.name];
-            await handler(managedTask.task.data);
+            const result = await handler(managedTask.task.data);
             await this.resumableTaskStore.delete(managedTask.id);
+            return result;
         }
         finally {
             ResumableTaskManager.clearTimeoutExtensionTimer(timer);

package/dist/esm/src/core/resumable-task-manager.js.map

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