narraeon 0.4.0 → 0.5.0

package/dist/node/runtime/world/FileNativeAuthorityV3.js

@@ -146,6 +146,17 @@ export class FileNativeAuthorityV3 {
             history,
             historyLength: basis.historyLength + historyAppend.length,
             materials,
+            ...(input.narrativeCheckpoint === undefined
+                ? basis.narrativeCheckpoint === undefined
+                    ? {}
+                    : { narrativeCheckpoint: basis.narrativeCheckpoint }
+                : {
+                    narrativeCheckpoint: {
+                        ...input.narrativeCheckpoint,
+                        head,
+                        historyMessageId: historyAppend.at(-1)?.messageId ?? "",
+                    },
+                }),
         };
         assertEndpoint(endpointValue);
         const endpoint = await this.#writeObject(sequence, "endpoint.json", endpointValue);
@@ -169,6 +180,12 @@ export class FileNativeAuthorityV3 {
         };
         const timelineParent = await this.#authorityRefAt(basisHead);
         const commit = {
+            ...(input.playContext === undefined
+                ? {}
+                : { playContext: input.playContext }),
+            ...(input.worldClock === undefined
+                ? {}
+                : { worldClock: input.worldClock }),
             schemaVersion: 3,
             type: "file_native_authority_commit",
             sequence,
@@ -180,6 +197,9 @@ export class FileNativeAuthorityV3 {
             stateChanges: storedChanges,
             nextAdditionalMaterials: structuredClone(input.nextMaterials),
             result: endpoint,
+            ...(input.narrativeCheckpoint === undefined
+                ? {}
+                : { narrativeCheckpoint: structuredClone(input.narrativeCheckpoint) }),
             ...(input.correctionTargets === undefined
                 ? {}
                 : { correctionTargets: structuredClone(input.correctionTargets) }),
@@ -241,8 +261,20 @@ export class FileNativeAuthorityV3 {
             history,
             additionalMaterials: structuredClone([...materials.items]),
             result,
+            ...(endpoint.narrativeCheckpoint === undefined
+                ? {}
+                : {
+                    narrativeCheckpoint: structuredClone(endpoint.narrativeCheckpoint),
+                }),
         };
     }
+    async readNarrativeCheckpoint(head) {
+        const current = await this.readHead();
+        const endpoint = await this.#readEndpoint(head === undefined || head === current.head
+            ? current.result
+            : await this.#resultRefAt(head));
+        return structuredClone(endpoint.narrativeCheckpoint);
+    }
     async recoverState(head) {
         const current = await this.readHead();
         const selected = head ?? current.head;
@@ -283,6 +315,18 @@ export class FileNativeAuthorityV3 {
             throw new FileNativeAuthorityV3Error("corrupt", "Continuity head does not match the immutable Authority chain");
         return { head: head.head, commits };
     }
+    /** Exact bytes of an accepted state change, with the same digest check as recovery. */
+    async readStateChangeContents(change) {
+        const blob = change.nextBlob;
+        if (!isBlobRef(blob))
+            throw corruptShape("State-change blob");
+        const contents = await readFile(join(this.#epochRoot(blob.epoch), "blobs", `${blob.digest}.txt`), "utf8");
+        if (hashHex(contents) !== blob.digest ||
+            hashWithPrefix(contents) !== change.nextHash ||
+            blob.sha256 !== change.nextHash)
+            throw corruptShape("State-change blob digest");
+        return contents;
+    }
     async commitAt(head) {
         if (head === "genesis")
             return null;
@@ -572,6 +616,9 @@ function assertEndpoint(value) {
             "history",
             "historyLength",
             "materials",
+            ...(value.narrativeCheckpoint === undefined
+                ? []
+                : ["narrativeCheckpoint"]),
         ]) ||
         value.schemaVersion !== 3 ||
         value.type !== "file_native_authority_endpoint" ||
@@ -579,7 +626,9 @@ function assertEndpoint(value) {
         (value.history !== null && !isObjectRef(value.history)) ||
         !Number.isSafeInteger(value.historyLength) ||
         Number(value.historyLength) < 0 ||
-        !isObjectRef(value.materials))
+        !isObjectRef(value.materials) ||
+        (value.narrativeCheckpoint !== undefined &&
+            !isNarrativeCheckpoint(value.narrativeCheckpoint, true)))
         throw corruptShape("Authority endpoint");
 }
 function assertStateManifest(value) {
@@ -640,6 +689,16 @@ function assertCommit(value) {
         throw corruptShape("Authority commit");
     const correction = value.mode === "correction";
     const revision = value.mode === "timeline_revision";
+    const lastHistory = Array.isArray(value.historyAppend)
+        ? value.historyAppend.at(-1)
+        : undefined;
+    if (value.narrativeCheckpoint !== undefined &&
+        (!isNarrativeCheckpoint(value.narrativeCheckpoint, false) ||
+            value.mode !== "play" ||
+            !Array.isArray(value.historyAppend) ||
+            !isRecord(lastHistory) ||
+            lastHistory.role !== "narrator"))
+        throw corruptShape("Narrative checkpoint declaration");
     if (!hasExactKeys(value, [
         "schemaVersion",
         "type",
@@ -647,6 +706,11 @@ function assertCommit(value) {
         "head",
         "auditParent",
         "timelineParent",
+        ...(value.playContext === undefined ? [] : ["playContext"]),
+        ...(value.worldClock === undefined ? [] : ["worldClock"]),
+        ...(value.narrativeCheckpoint === undefined
+            ? []
+            : ["narrativeCheckpoint"]),
         "mode",
         "historyAppend",
         "stateChanges",
@@ -657,6 +721,10 @@ function assertCommit(value) {
     ]) ||
         value.schemaVersion !== 3 ||
         value.type !== "file_native_authority_commit" ||
+        (value.playContext !== undefined &&
+            (typeof value.playContext !== "string" ||
+                value.playContext.length === 0)) ||
+        (value.worldClock !== undefined && typeof value.worldClock !== "string") ||
         !Number.isSafeInteger(value.sequence) ||
         Number(value.sequence) < 1 ||
         value.head !== `commit:${String(value.sequence)}` ||
@@ -848,6 +916,25 @@ function hasExactKeys(value, keys) {
     return (Object.keys(value).length === keys.length &&
         keys.every((key) => Object.hasOwn(value, key)));
 }
+function isNarrativeCheckpoint(value, effective) {
+    if (!isRecord(value) ||
+        !hasExactKeys(value, [
+            "contextId",
+            "completedPlayerRounds",
+            ...(effective ? ["head", "historyMessageId"] : []),
+        ]) ||
+        typeof value.contextId !== "string" ||
+        value.contextId.length === 0 ||
+        !Number.isSafeInteger(value.completedPlayerRounds) ||
+        Number(value.completedPlayerRounds) < 0)
+        return false;
+    return (!effective ||
+        (typeof value.head === "string" &&
+            /^commit:[1-9][0-9]*$/u.test(value.head) &&
+            typeof value.historyMessageId === "string" &&
+            value.historyMessageId.startsWith(`message.${value.head.slice("commit:".length)}.`) &&
+            /^message\.[1-9][0-9]*\.[1-9][0-9]*\.narrator$/u.test(value.historyMessageId)));
+}
 function corruptShape(label) {
     return new FileNativeAuthorityV3Error("corrupt", `${label} has an invalid shape`);
 }