@skenora/scene-plan 0.1.2

package/dist/patch/patch.js

@@ -0,0 +1,319 @@
+import { createDiagnostic, finalizeDiagnostics, hasErrors, ScenePlanValidationError, } from "../diagnostics/diagnostics.js";
+import { isJsonObject, isJsonValue } from "../model/json.js";
+import { normalizeScenePatch } from "../normalization/normalize.js";
+import { isStableScenePlanId, validateSceneBlueprint, } from "../validation/validate.js";
+const TARGET_KINDS = new Set([
+    "entity",
+    "resource",
+    "material",
+    "materialBinding",
+    "textureAnimation",
+    "cameraPath",
+    "light",
+    "flow",
+    "setting",
+]);
+const SETTING_IDS = new Set([
+    "camera",
+    "environment",
+    "ground",
+    "fog",
+    "weather",
+    "postProcess",
+    "variables",
+]);
+const RESERVED_PATH_SEGMENTS = new Set([
+    "",
+    "__proto__",
+    "prototype",
+    "constructor",
+    "id",
+]);
+export function validateScenePatch(input, context = {}) {
+    const normalized = normalizeScenePatch(input);
+    if (!normalized.ok || !normalized.value) {
+        return { valid: false, diagnostics: normalized.diagnostics };
+    }
+    const diagnostics = [...normalized.diagnostics];
+    const patch = normalized.value;
+    validateTargetPrecondition(patch, context, diagnostics);
+    const seenTargets = new Set();
+    for (const [index, operation] of patch.operations.entries()) {
+        validateOperation(operation, index, context, seenTargets, diagnostics);
+    }
+    const finalized = finalizeDiagnostics(diagnostics);
+    return {
+        valid: !hasErrors(finalized),
+        normalized: patch,
+        diagnostics: finalized,
+    };
+}
+export function compileScenePatch(input, context = {}) {
+    const validation = validateScenePatch(input, context);
+    if (!validation.normalized || !validation.valid) {
+        return {
+            ok: false,
+            ...(validation.normalized === undefined
+                ? {}
+                : {
+                    patch: validation.normalized,
+                    planHash: hashJson(validation.normalized),
+                }),
+            diagnostics: validation.diagnostics,
+        };
+    }
+    const patch = validation.normalized;
+    const operations = [];
+    const diagnostics = [...validation.diagnostics];
+    for (const [index, operation] of patch.operations.entries()) {
+        const path = targetPath(operation.target);
+        const state = targetState(context.document, operation.target);
+        if (operation.op === "create") {
+            operations.push({
+                op: "create",
+                sourceOperationIndex: index,
+                target: structuredClone(operation.target),
+                path,
+                value: structuredClone(operation.value),
+                targetState: state,
+            });
+        }
+        else if (operation.op === "update") {
+            operations.push({
+                op: "update",
+                sourceOperationIndex: index,
+                target: structuredClone(operation.target),
+                path,
+                changes: structuredClone(operation.changes),
+                targetState: state,
+                ...(context.document === undefined
+                    ? {}
+                    : {
+                        previousValues: operation.changes.map((change) => {
+                            const value = readRelativeValue(context.document, operation.target, change.path);
+                            return {
+                                path: [...change.path],
+                                ...(value === undefined ? {} : { value }),
+                            };
+                        }),
+                    }),
+            });
+        }
+        else {
+            const previousValue = context.document
+                ? readTargetValue(context.document, operation.target)
+                : undefined;
+            operations.push({
+                op: "remove",
+                sourceOperationIndex: index,
+                target: structuredClone(operation.target),
+                path,
+                targetState: state,
+                ...(previousValue === undefined ? {} : { previousValue }),
+            });
+        }
+    }
+    const requiresBaseDocument = operations.some((operation) => operation.targetState === "unknown");
+    if (requiresBaseDocument) {
+        diagnostics.push(createDiagnostic({
+            code: "patch-target-conflict",
+            stage: "patch",
+            path: ["operations"],
+            message: "Patch candidate requires a current SceneDocument snapshot before commit",
+            recoverable: true,
+        }));
+    }
+    const finalized = finalizeDiagnostics(diagnostics);
+    const candidate = Object.freeze({
+        schema: "skenora.scene.patch.candidate",
+        version: 1,
+        target: structuredClone(patch.target),
+        operations: Object.freeze(operations.map((operation) => structuredClone(operation))),
+        requiresBaseDocument,
+    });
+    return {
+        ok: !hasErrors(finalized),
+        patch: structuredClone(patch),
+        candidate,
+        planHash: hashJson(patch),
+        diagnostics: finalized,
+    };
+}
+export function assertSceneBlueprint(input, context = {}) {
+    const result = validateSceneBlueprint(input, context);
+    if (!result.valid)
+        throw new ScenePlanValidationError(result.diagnostics);
+}
+function validateTargetPrecondition(patch, context, diagnostics) {
+    if (!isStableScenePlanId(patch.target.sceneId)) {
+        add(diagnostics, "invalid-id", ["target", "sceneId"], "Patch sceneId is invalid");
+    }
+    if (!Number.isSafeInteger(patch.target.expectedRevision) ||
+        patch.target.expectedRevision < 0) {
+        add(diagnostics, "patch-invalid", ["target", "expectedRevision"], "Patch expectedRevision must be a non-negative safe integer");
+    }
+    if (patch.target.expectedDocumentHash !== undefined &&
+        (typeof patch.target.expectedDocumentHash !== "string" ||
+            patch.target.expectedDocumentHash.trim().length === 0)) {
+        add(diagnostics, "patch-invalid", ["target", "expectedDocumentHash"], "Patch expectedDocumentHash must be a non-empty string");
+    }
+    if (context.document && context.document.id !== patch.target.sceneId) {
+        add(diagnostics, "patch-target-conflict", ["target", "sceneId"], "Patch sceneId does not match the supplied document", { recoverable: true });
+    }
+    if (context.documentRevision !== undefined &&
+        context.documentRevision !== patch.target.expectedRevision) {
+        add(diagnostics, "patch-target-conflict", ["target", "expectedRevision"], "Patch expected revision " +
+            patch.target.expectedRevision +
+            " does not match " +
+            context.documentRevision, { recoverable: true });
+    }
+    if (context.documentHash !== undefined &&
+        patch.target.expectedDocumentHash !== undefined &&
+        context.documentHash !== patch.target.expectedDocumentHash) {
+        add(diagnostics, "patch-target-conflict", ["target", "expectedDocumentHash"], "Patch document hash does not match the supplied document", { recoverable: true });
+    }
+}
+function validateOperation(operation, index, context, seenTargets, diagnostics) {
+    const path = ["operations", index];
+    const target = operation?.target;
+    if (!target || !isJsonObject(target)) {
+        add(diagnostics, "patch-invalid", [...path, "target"], "Patch operation target is required", { operationIndex: index });
+        return;
+    }
+    if (!TARGET_KINDS.has(target.kind)) {
+        add(diagnostics, "patch-unsupported-target", [...path, "target", "kind"], "Patch target kind is unsupported", { operationIndex: index });
+        return;
+    }
+    if (target.kind === "setting") {
+        if (!SETTING_IDS.has(target.id)) {
+            add(diagnostics, "patch-unsupported-target", [...path, "target", "id"], "Patch setting target is unsupported", { operationIndex: index });
+        }
+    }
+    else if (!isStableScenePlanId(target.id)) {
+        add(diagnostics, "invalid-id", [...path, "target", "id"], "Patch target id is invalid", { operationIndex: index });
+    }
+    const targetKey = target.kind + ":" + target.id;
+    if (seenTargets.has(targetKey)) {
+        add(diagnostics, "patch-target-conflict", [...path, "target"], "Patch target is addressed more than once: " + targetKey, { operationIndex: index, recoverable: true });
+    }
+    seenTargets.add(targetKey);
+    if (operation.op === "create") {
+        if (!isJsonObject(operation.value)) {
+            add(diagnostics, "patch-invalid", [...path, "value"], "Create operation requires a JSON object value", { operationIndex: index });
+        }
+        if (targetState(context.document, target) === "present") {
+            add(diagnostics, "patch-target-conflict", [...path, "target"], "Create target already exists", { operationIndex: index, recoverable: true });
+        }
+        return;
+    }
+    if (operation.op === "update") {
+        if (!Array.isArray(operation.changes) || operation.changes.length === 0) {
+            add(diagnostics, "patch-invalid", [...path, "changes"], "Update operation requires at least one change", { operationIndex: index });
+            return;
+        }
+        const changePaths = new Set();
+        for (const [changeIndex, change] of operation.changes.entries()) {
+            validateChange(change, [...path, "changes", changeIndex], index, changePaths, diagnostics);
+        }
+        if (targetState(context.document, target) === "absent") {
+            add(diagnostics, "patch-target-conflict", [...path, "target"], "Update target does not exist", { operationIndex: index, recoverable: true });
+        }
+        return;
+    }
+    if (operation.op !== "remove") {
+        add(diagnostics, "patch-invalid", [...path, "op"], "Patch operation must be create, update, or remove", { operationIndex: index });
+    }
+    else if (targetState(context.document, target) === "absent") {
+        add(diagnostics, "patch-target-conflict", [...path, "target"], "Remove target does not exist", { operationIndex: index, recoverable: true });
+    }
+}
+function validateChange(change, path, operationIndex, seenPaths, diagnostics) {
+    if (!change || !Array.isArray(change.path) || change.path.length === 0) {
+        add(diagnostics, "patch-invalid", path, "Patch change path must be non-empty", { operationIndex });
+        return;
+    }
+    const key = change.path.join(".");
+    if (seenPaths.has(key)) {
+        add(diagnostics, "patch-target-conflict", path, "Patch change path is repeated: " + key, { operationIndex, recoverable: true });
+    }
+    seenPaths.add(key);
+    if (change.path.some((segment) => typeof segment !== "string" || RESERVED_PATH_SEGMENTS.has(segment))) {
+        add(diagnostics, "reserved-field", path, "Patch cannot update identity or prototype fields", { operationIndex });
+    }
+    if (change.path.some((segment) => typeof segment !== "string" || !segment || segment.includes("."))) {
+        add(diagnostics, "patch-invalid", path, "Patch change path contains an invalid segment", { operationIndex });
+    }
+    if (!isJsonValue(change.value)) {
+        add(diagnostics, "invalid-value", [...path, "value"], "Patch change value must be JSON", { operationIndex });
+    }
+}
+function targetPath(target) {
+    if (target.kind === "setting")
+        return [target.id];
+    const roots = {
+        entity: "entities",
+        resource: "assets",
+        material: "materials",
+        materialBinding: "materialBindings",
+        textureAnimation: "textureAnimations",
+        cameraPath: "cameraPaths",
+        light: "lights",
+        flow: "flows",
+    };
+    return [roots[target.kind], target.id];
+}
+function targetState(document, target) {
+    if (!document)
+        return "unknown";
+    return readTargetValue(document, target) === undefined ? "absent" : "present";
+}
+function readTargetValue(document, target) {
+    if (target.kind === "setting") {
+        return structuredClone(document[target.id]);
+    }
+    const root = targetPath(target)[0];
+    if (root === "lights") {
+        const light = document.lights.find((item) => item.id === target.id);
+        return light === undefined
+            ? undefined
+            : structuredClone(light);
+    }
+    return structuredClone(document[root]?.[target.id]);
+}
+function readRelativeValue(document, target, relativePath) {
+    let value = readTargetValue(document, target);
+    for (const segment of relativePath) {
+        if (!value || typeof value !== "object")
+            return undefined;
+        value = value[segment];
+    }
+    return isJsonValue(value) ? structuredClone(value) : undefined;
+}
+function add(diagnostics, code, path, message, options = {}) {
+    diagnostics.push(createDiagnostic({
+        code,
+        stage: "patch",
+        path,
+        message,
+        ...options,
+    }));
+}
+function hashJson(value) {
+    const serialized = JSON.stringify(canonicalize(value));
+    let hash = 0xcbf29ce484222325n;
+    for (const character of serialized) {
+        hash ^= BigInt(character.charCodeAt(0));
+        hash = BigInt.asUintN(64, hash * 0x100000001b3n);
+    }
+    return "fnv1a64:" + hash.toString(16).padStart(16, "0");
+}
+function canonicalize(value) {
+    if (Array.isArray(value))
+        return value.map(canonicalize);
+    if (!value || typeof value !== "object")
+        return value;
+    return Object.fromEntries(Object.entries(value)
+        .sort(([left], [right]) => (left < right ? -1 : left > right ? 1 : 0))
+        .map(([key, child]) => [key, canonicalize(child)]));
+}
+//# sourceMappingURL=patch.js.map

package/dist/patch/patch.js.map

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

package/dist/validation/validate.d.ts

@@ -0,0 +1,16 @@
+import { type SceneDocumentData } from "@skenora/contracts";
+import { type ScenePlanDiagnostic, type ScenePlanValidationResult } from "../diagnostics/diagnostics.js";
+import type { SceneBlueprint, ScenePlanContext } from "../model/types.js";
+export interface SceneBlueprintValidationOptions {
+    readonly requireResourceBindings?: boolean;
+}
+export declare function validateSceneBlueprint(input: unknown, context?: ScenePlanContext): ScenePlanValidationResult;
+export declare function validateNormalizedSceneBlueprint(blueprint: SceneBlueprint, context?: ScenePlanContext, options?: SceneBlueprintValidationOptions): readonly ScenePlanDiagnostic[];
+export declare function validateSceneDocumentCandidate(document: unknown): readonly ScenePlanDiagnostic[];
+export declare function isStableScenePlanId(value: unknown): value is string;
+export declare function validateNativeDocumentShape(document: unknown): {
+    readonly valid: boolean;
+    readonly diagnostics: readonly ScenePlanDiagnostic[];
+};
+export type { SceneDocumentData };
+//# sourceMappingURL=validate.d.ts.map

package/dist/validation/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/validation/validate.ts"],"names":[],"mappings":"AAKA,OAAO,EAEL,KAAK,iBAAiB,EAOvB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAIL,KAAK,mBAAmB,EACxB,KAAK,yBAAyB,EAC/B,MAAM,4BAA4B,CAAC;AAGpC,OAAO,KAAK,EACV,cAAc,EAOd,gBAAgB,EAGjB,MAAM,gBAAgB,CAAC;AAuBxB,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,uBAAuB,CAAC,EAAE,OAAO,CAAC;CAC5C;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,gBAAqB,GAC7B,yBAAyB,CAoB3B;AAED,wBAAgB,gCAAgC,CAC9C,SAAS,EAAE,cAAc,EACzB,OAAO,GAAE,gBAAqB,EAC9B,OAAO,GAAE,+BAAoC,GAC5C,SAAS,mBAAmB,EAAE,CAwEhC;AAED,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,OAAO,GAChB,SAAS,mBAAmB,EAAE,CAKhC;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAEnE;AA61CD,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,OAAO,GAAG;IAC9D,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACtD,CAGA;AAED,YAAY,EAAE,iBAAiB,EAAE,CAAC"}