@_linked/core 2.12.0 → 2.13.0

package/lib/cjs/queries/MutationQuery.js

@@ -1,334 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MutationQueryFactory = void 0;
-const QueryFactory_js_1 = require("./QueryFactory.js");
-const ShapeClass_js_1 = require("../utils/ShapeClass.js");
-const ExpressionNode_js_1 = require("../expressions/ExpressionNode.js");
-const ProxiedPathBuilder_js_1 = require("./ProxiedPathBuilder.js");
-const QueryContext_js_1 = require("./QueryContext.js");
-const shacl_js_1 = require("../ontologies/shacl.js");
-class MutationQueryFactory extends QueryFactory_js_1.QueryFactory {
-    /**
-     * Normalize raw create/update data into a {@link NodeDescriptionValue} — the
-     * IR-free step shared by `toJSON()` and `lower()`. Kept on this base (which
-     * imports no IR) so the builders can normalize for serialization without
-     * pulling the canonical-IR pipeline.
-     */
-    describe(shape, data, allowTopLevelId = false) {
-        return this.convertUpdateObject(data, shape, allowTopLevelId);
-    }
-    /** Normalize delete ids (strings / `{id}`) to `NodeReferenceValue[]` (IR-free). */
-    normalizeNodeRefs(ids) {
-        return this.convertNodeReferences(ids);
-    }
-    convertUpdateObject(obj, shape, allowTopLevelId = false) {
-        if (typeof obj === 'object' && !(obj instanceof Date) && obj !== null) {
-            if (!allowTopLevelId && 'id' in obj) {
-                throw new Error('You cannot use id in the top level of an update object');
-            }
-            return this.convertNodeDescription(obj, shape);
-        }
-        else if (typeof obj === 'function') {
-            const shapeClass = shape.id ? (0, ShapeClass_js_1.getShapeClass)(shape.id) : undefined;
-            if (!shapeClass) {
-                throw new Error(`Shape class not found for ${shape.id || 'unknown'}`);
-            }
-            const proxy = (0, ProxiedPathBuilder_js_1.createProxiedPathBuilder)(shapeClass);
-            const result = obj(proxy);
-            if (typeof result !== 'object' || result === null) {
-                throw new Error('Update function must return an object');
-            }
-            return this.convertNodeDescription(result, shape);
-        }
-        else {
-            throw new Error('Invalid update object');
-        }
-    }
-    isSetModification(obj, shape) {
-        let hasAdd = obj.add;
-        let hasRemove = obj.remove;
-        let numKeysExpected = (hasAdd ? 1 : 0) + (hasRemove ? 1 : 0);
-        let numKeys = Object.getOwnPropertyNames(obj).length;
-        // A set modification is ONLY add/remove keys. Mixing them with other keys
-        // (e.g. {add:[…], name:'x'}) must NOT be silently treated as a set mod —
-        // that dropped the sibling fields. Require an exact key-count match for
-        // both add and remove (mirrors isSetModificationValue).
-        return (hasAdd || hasRemove) && numKeysExpected === numKeys;
-    }
-    convertSetModification(obj, shape) {
-        if (!obj.add && !obj.remove) {
-            throw new Error('Set modification should have either add or remove key');
-        }
-        const res = {};
-        if (obj.add) {
-            res.$add = this.convertSetAddValue(obj.add, shape);
-        }
-        if (obj.remove) {
-            res.$remove = this.convertSetRemoveValue(obj.remove, shape);
-        }
-        return res;
-    }
-    convertSetRemoveValue(obj, shape) {
-        //the user can either pass an array of node references or a single node reference
-        //either way we should return an array of node reference values
-        if (Array.isArray(obj)) {
-            return obj.map((o) => this.convertSingleRemoveValue(o, shape));
-        }
-        else {
-            return [this.convertSingleRemoveValue(obj, shape)];
-        }
-    }
-    convertSetAddValue(obj, shape) {
-        if (Array.isArray(obj)) {
-            return obj.map((o) => this.convertUpdateValue(o, shape));
-        }
-        else {
-            return [this.convertUpdateValue(obj, shape)];
-        }
-    }
-    convertSingleRemoveValue(value, shape) {
-        const ctx = (0, QueryContext_js_1.asContextRef)(value);
-        if (ctx) {
-            return ctx;
-        }
-        if (this.isNodeReference(value)) {
-            return this.convertNodeReference(value);
-        }
-        else {
-            throw new Error(`Invalid value for ${shape.label}.$remove. Expected an object with an id as key: {id:string}`);
-        }
-    }
-    convertNodeDescription(inputObj, shape) {
-        // Shallow-copy so we never mutate the caller's object
-        const obj = Object.assign({}, inputObj);
-        const props = shape.getPropertyShapes(true);
-        const fields = [];
-        let id;
-        if ('__id' in obj) {
-            //if the object has a __id key, then we should use that in the result
-            id = obj.__id.toString();
-            //but we should not include it in the fields
-            delete obj.__id;
-        }
-        else if ('id' in obj) {
-            //if the object has an id key alongside other data properties,
-            //treat it as a nested create with a predefined ID
-            id = String(obj.id);
-            delete obj.id;
-        }
-        for (var key in obj) {
-            let propShape = props.find((p) => p.label === key);
-            if (!propShape) {
-                throw Error(`Invalid property key: ${key}. The shape ${shape.label || shape.id.split('/').pop()} does not have a registered property with this name. Make sure the get/set method exists, and that it uses a @objectProperty or @literalProperty decorator.`);
-            }
-            else {
-                fields.push(this.createNodePropertyValue(obj[key], propShape));
-            }
-        }
-        const res = {
-            fields,
-            shape,
-        };
-        if (id) {
-            res.__id = id;
-        }
-        return res;
-    }
-    createNodePropertyValue(value, propShape) {
-        this.validateAgainstShape(value, propShape);
-        return {
-            prop: propShape,
-            val: this.convertUpdateValue(value, propShape),
-        };
-    }
-    /**
-     * Lightweight structural validation of a single property value against its
-     * PropertyShape — cardinality (`minCount`/`maxCount`) and node-kind (literal
-     * vs relation). This is *structural* only (from metadata already in hand); it
-     * does not duplicate datatype/deep validation, which the store performs. It
-     * fails fast at the call site with a clear message instead of surfacing a
-     * confusing store error later.
-     *
-     * Skips values whose final shape isn't known here: computed expressions,
-     * context refs, `unset` (null/undefined), and set-modifications (`{add,remove}`
-     * — the resulting count depends on the node's current state).
-     */
-    validateAgainstShape(value, propShape) {
-        // A `null` value clears the property. Clearing a required (minCount>=1)
-        // property is a cardinality violation — the same as providing zero values —
-        // so it is rejected exactly like an empty array (both spellings of "clear
-        // it" behave identically).
-        if (value === null) {
-            if (typeof propShape.minCount === 'number' && propShape.minCount > 0) {
-                throw new Error(`Property '${propShape.label || propShape.id}' requires at least ${propShape.minCount} value(s) and cannot be cleared.`);
-            }
-            return;
-        }
-        if (value === undefined ||
-            (0, ExpressionNode_js_1.isExpressionNode)(value) ||
-            (0, QueryContext_js_1.asContextRef)(value) ||
-            (typeof value === 'function') ||
-            (typeof value === 'object' && this.isSetModification(value, propShape))) {
-            return;
-        }
-        const label = propShape.label || propShape.id;
-        const elems = Array.isArray(value) ? value : [value];
-        const count = elems.length;
-        // --- cardinality ---
-        if (typeof propShape.maxCount === 'number' && count > propShape.maxCount) {
-            throw new Error(`Property '${label}' allows at most ${propShape.maxCount} value(s), but ${count} were provided.`);
-        }
-        if (typeof propShape.minCount === 'number' && propShape.minCount > 0 && count < propShape.minCount) {
-            throw new Error(`Property '${label}' requires at least ${propShape.minCount} value(s), but ${count} were provided.`);
-        }
-        // --- node kind: literal vs relation ---
-        const expectsLiteral = this.expectsLiteral(propShape);
-        const expectsNode = this.expectsNode(propShape);
-        if (!expectsLiteral && !expectsNode)
-            return; // ambiguous/unspecified kind — don't enforce
-        for (const el of elems) {
-            if (el === null || el === undefined || (0, ExpressionNode_js_1.isExpressionNode)(el) || (0, QueryContext_js_1.asContextRef)(el))
-                continue;
-            const isScalar = typeof el === 'string' ||
-                typeof el === 'number' ||
-                typeof el === 'boolean' ||
-                el instanceof Date;
-            if (expectsLiteral && !isScalar) {
-                throw new Error(`Property '${label}' is a literal property but was given a ${typeof el === 'object' ? 'node/object' : typeof el} value.`);
-            }
-            if (expectsNode && isScalar) {
-                throw new Error(`Property '${label}' is a relation (object) property but was given a literal (${typeof el}). Provide a {id} reference or a nested object.`);
-            }
-        }
-    }
-    /** True when the property clearly accepts only literal values. */
-    expectsLiteral(ps) {
-        if (ps.nodeKind)
-            return ps.nodeKind.id === shacl_js_1.shacl.Literal.id;
-        return !!ps.datatype && !ps.valueShape;
-    }
-    /** True when the property clearly accepts only nodes (IRIs/blank nodes). */
-    expectsNode(ps) {
-        if (ps.nodeKind) {
-            return (ps.nodeKind.id === shacl_js_1.shacl.IRI.id ||
-                ps.nodeKind.id === shacl_js_1.shacl.BlankNode.id ||
-                ps.nodeKind.id === shacl_js_1.shacl.BlankNodeOrIRI.id);
-        }
-        return !!ps.valueShape;
-    }
-    convertUpdateValue(value, propShape, allowArrays = true) {
-        // ExpressionNode → pass through as-is (will be converted to IRExpression by IRMutation)
-        if ((0, ExpressionNode_js_1.isExpressionNode)(value)) {
-            return value;
-        }
-        // Query-context reference → preserve the live ref (do NOT collapse to {id},
-        // which would read an unresolved `.id` as undefined). Handles both an unset
-        // PendingQueryContext and a resolved context shape; both serialize as a {@ctx}
-        // marker and are resolved — or throw — at lowering time.
-        {
-            const ctx = (0, QueryContext_js_1.asContextRef)(value);
-            if (ctx)
-                return ctx;
-        }
-        //single value which will
-        if (typeof value === 'string' ||
-            typeof value === 'number' ||
-            typeof value === 'boolean' ||
-            value instanceof Date) {
-            return value;
-        }
-        //if multiple items are given as value of this prop
-        if (Array.isArray(value)) {
-            if (!allowArrays) {
-                throw new Error('Nested arrays are not allowed as values of keys');
-            }
-            //then convert each value, but disallow nested arrays moving forward
-            return value.map((o) => {
-                return this.convertUpdateValue(o, propShape, false);
-            });
-        }
-        else if (typeof value === 'undefined') {
-            return value;
-        }
-        else if (value === null) {
-            //unsetting a value with null is also possible. But we pass it as undefined in the query object
-            return undefined;
-        }
-        else if (typeof value === 'object') {
-            if (this.isNodeReference(value)) {
-                return this.convertNodeReference(value);
-            }
-            else {
-                let valueShape = null;
-                if (propShape.valueShape) {
-                    const shapeClass = (0, ShapeClass_js_1.getShapeClass)(propShape.valueShape);
-                    valueShape = (shapeClass === null || shapeClass === void 0 ? void 0 : shapeClass.shape) || null;
-                    if (!valueShape) {
-                        throw new Error(`Shape class not found for ${propShape.valueShape.id}`);
-                    }
-                }
-                //pass the value shape of the property as the node shape of this value
-                if (!propShape.valueShape) {
-                    //It's possible to define the shape of the value in the value itself for properties who do not define the shape in their objectProperty
-                    if (value.shape) {
-                        if (!value.shape.shape || typeof value.shape.shape.getPropertyShapes !== 'function') {
-                            throw new Error(`The value of property "shape" is invalid and should be a class that extends Shape.`);
-                        }
-                        valueShape = value.shape.shape;
-                    }
-                    else {
-                        //TODO: not sure if this should be an error. Does every @linkedObject need to define the shape of the values?
-                        // If not, then how do we continue? because currently we use the value shape to look up further property shapes
-                        throw new Error(`Cannot update properties with plain objects if the shape of the values is not known. Make sure get/set ${propShape.parentNodeShape.label}.${propShape.label} defines the 'shape' key in its @objectProperty decorator.`);
-                    }
-                }
-                //never keep a shape key in the value object
-                if (value.shape) {
-                    //double check that IF a shape value is provided, that it matches the shape from the @objectProperty decorator
-                    if (value.shape.shape.id !== valueShape.id) {
-                        throw new Error(`The property 'shape' is reserved in LINCD and should not be used here in this way. The ${propShape.label} property already defines the shape of the value as ${propShape.label}. If you want to use a different shape, use the 'shape' key in the @objectProperty decorator.`);
-                    }
-                    delete value.shape;
-                }
-                if (this.isSetModification(value, propShape)) {
-                    return this.convertSetModification(value, propShape);
-                }
-                else {
-                    return this.convertNodeDescription(value, valueShape);
-                }
-            }
-        }
-        throw new Error(`Unsupported update value type: ${typeof value}`);
-    }
-    isNodeReference(obj) {
-        //check if obj is an object with only an id property
-        //if additional data properties are present, it's a nested create with predefined ID
-        return typeof obj === 'object' && obj !== null && 'id' in obj && Object.keys(obj).length === 1;
-    }
-    convertNodeReferences(input) {
-        if (Array.isArray(input)) {
-            return input.map((o) => {
-                return this.convertNodeReferenceOrString(o);
-            });
-        }
-        else {
-            return [this.convertNodeReferenceOrString(input)];
-        }
-    }
-    convertNodeReferenceOrString(o) {
-        if (typeof o === 'string') {
-            return { id: o };
-        }
-        else if (this.isNodeReference(o)) {
-            return this.convertNodeReference(o);
-        }
-        else {
-            throw new Error(`Invalid node reference: ${JSON.stringify(o)}`);
-        }
-    }
-    convertNodeReference(obj) {
-        return { id: obj.id };
-    }
-}
-exports.MutationQueryFactory = MutationQueryFactory;
-//# sourceMappingURL=MutationQuery.js.map

package/lib/cjs/queries/MutationQuery.js.map

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

package/lib/cjs/queries/MutationSerialization.d.ts

@@ -1,102 +0,0 @@
-/**
- * Lossless JSON (de)serialization for mutations (create / update / delete) — the
- * **IR-free wire codec**. The companion IR side (`decodeNodeData` / `lowerMutationJSON`)
- * lives in `lowerMutationJSON.ts` so this module never pulls the canonical-IR pipeline.
- *
- * The serialization unit is the normalized `NodeDescriptionValue` produced by the
- * IR-free factory base (`MutationQueryFactory.describe()`) — i.e. after `.set()` and
- * after any update-expression callback has been evaluated, but before canonical IR.
- * Property keys are serialized as **labels** (shape-relative, lightweight); decoding
- * resolves them back via the registered shape.
- *
- * Values use the DSL-JSON grammar (documentation/dsl-json.md): a bare scalar is a
- * literal; objects tag the kinds `JSON.stringify` can't represent natively
- * (`{@date}`, `{@id}`, `{@ctx}`, `{@list}`, `{@add,@remove}`, `{@unset}`); and a
- * computed value is an S-expr array via the shared `DslJsonExpression` codec —
- * so the wire carries no IR.
- */
-import { type NodeDescriptionValue, type PropUpdateValue } from './QueryFactory.js';
-import type { WherePathJSON } from './QueryBuilderSerialization.js';
-import type { ContextRefJSON } from './ContextRef.js';
-import type { NodeShape, PropertyShape } from '../shapes/SHACL.js';
-import { type DslJsonValue } from './DslJsonExpression.js';
-/**
- * A mutation field value in the DSL-JSON grammar. A bare scalar is a literal; objects
- * tag the non-JSON-native kinds (`@`-sigiled); a computed value is an S-expr array (no IR); a
- * nested-node create is a bare path-keyed object ({@link MutationNodeDataJSON}),
- * disambiguated from the tagged forms by having no reserved value-key.
- */
-export type MutationValueJSON = string | number | boolean | null | {
-    '@date': string;
-} | {
-    '@id': string;
-} | {
-    '@ctx': string;
-} | {
-    '@list': MutationValueJSON[];
-} | {
-    '@add'?: MutationValueJSON[];
-    '@remove'?: string[];
-} | {
-    '@unset': true;
-} | MutationNodeDataJSON | DslJsonValue;
-/**
- * A node description in **path-keyed** form: `label → value`, plus two reserved
- * keys — `__id` (a fixed/predefined id) and `__shape` (the concrete shape IRI,
- * emitted only when it differs from the shape inferred from context, e.g. a
- * subclass instance under a superclass-typed relation).
- */
-export type MutationNodeDataJSON = {
-    [key: string]: MutationValueJSON | undefined;
-};
-export type CreateMutationJSON = {
-    v?: string;
-    op: 'create';
-    shape: string;
-    data: MutationNodeDataJSON;
-};
-export type UpdateMutationJSON = {
-    v?: string;
-    op: 'update';
-    shape: string;
-    mode: 'for' | 'forAll' | 'where';
-    /** A node id, or a `{@ctx: name}` context reference resolved at lowering. */
-    targetId?: string | ContextRefJSON;
-    where?: WherePathJSON;
-    data: MutationNodeDataJSON;
-};
-export type DeleteMutationJSON = {
-    v?: string;
-    op: 'delete';
-    shape: string;
-    mode: 'ids';
-    ids: (string | ContextRefJSON)[];
-} | {
-    v?: string;
-    op: 'delete';
-    shape: string;
-    mode: 'all';
-} | {
-    v?: string;
-    op: 'delete';
-    shape: string;
-    mode: 'where';
-    where: WherePathJSON;
-};
-export type MutationJSON = CreateMutationJSON | UpdateMutationJSON | DeleteMutationJSON;
-/** The shape a nested node is expected to have (a property's value shape), if resolvable. */
-export declare function valueShapeOf(prop?: PropertyShape): NodeShape | undefined;
-/** Encode any property value, including arrays and set modifications. */
-export declare function encodeValue(value: PropUpdateValue, prop?: PropertyShape): MutationValueJSON;
-/**
- * Encode a normalized node description to path-keyed form. `expectedShape` is the
- * shape inferable from context (the envelope, or the parent relation's value shape);
- * `__shape` is emitted only when the concrete shape differs (a subclass instance).
- */
-export declare function encodeNodeData(desc: NodeDescriptionValue, expectedShape?: NodeShape): MutationNodeDataJSON;
-/**
- * Decode path-keyed node data into a raw object the mutation builders' `.set()` accepts.
- * `__id` becomes `id`; `__shape` (if present) overrides the inferred `shape`. Mirrors
- * {@link encodeNodeData}.
- */
-export declare function decodeNodeDataToRaw(json: MutationNodeDataJSON, shape?: NodeShape): Record<string, unknown>;

package/lib/cjs/queries/MutationSerialization.js

@@ -1,207 +0,0 @@
-"use strict";
-/*
- * This Source Code Form is subject to the terms of the Mozilla Public
- * License, v. 2.0. If a copy of the MPL was not distributed with this
- * file, You can obtain one at https://mozilla.org/MPL/2.0/.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.valueShapeOf = valueShapeOf;
-exports.encodeValue = encodeValue;
-exports.encodeNodeData = encodeNodeData;
-exports.decodeNodeDataToRaw = decodeNodeDataToRaw;
-/**
- * Lossless JSON (de)serialization for mutations (create / update / delete) — the
- * **IR-free wire codec**. The companion IR side (`decodeNodeData` / `lowerMutationJSON`)
- * lives in `lowerMutationJSON.ts` so this module never pulls the canonical-IR pipeline.
- *
- * The serialization unit is the normalized `NodeDescriptionValue` produced by the
- * IR-free factory base (`MutationQueryFactory.describe()`) — i.e. after `.set()` and
- * after any update-expression callback has been evaluated, but before canonical IR.
- * Property keys are serialized as **labels** (shape-relative, lightweight); decoding
- * resolves them back via the registered shape.
- *
- * Values use the DSL-JSON grammar (documentation/dsl-json.md): a bare scalar is a
- * literal; objects tag the kinds `JSON.stringify` can't represent natively
- * (`{@date}`, `{@id}`, `{@ctx}`, `{@list}`, `{@add,@remove}`, `{@unset}`); and a
- * computed value is an S-expr array via the shared `DslJsonExpression` codec —
- * so the wire carries no IR.
- */
-const QueryFactory_js_1 = require("./QueryFactory.js");
-const ExpressionNode_js_1 = require("../expressions/ExpressionNode.js");
-const QueryContext_js_1 = require("./QueryContext.js");
-const ShapeClass_js_1 = require("../utils/ShapeClass.js");
-const DslJsonExpression_js_1 = require("./DslJsonExpression.js");
-/** Reserved node-data keys (not property labels). */
-const NODE_ID_KEY = '__id';
-const NODE_SHAPE_KEY = '__shape';
-// =============================================================================
-// Value codec
-// =============================================================================
-/** The shape a nested node is expected to have (a property's value shape), if resolvable. */
-function valueShapeOf(prop) {
-    var _a, _b;
-    const id = (_a = prop === null || prop === void 0 ? void 0 : prop.valueShape) === null || _a === void 0 ? void 0 : _a.id;
-    return id ? (_b = (0, ShapeClass_js_1.getShapeClass)(id)) === null || _b === void 0 ? void 0 : _b.shape : undefined;
-}
-/** Encode a single (non-array, non-setMod) property value. `prop` gives the nested-node shape. */
-function encodeSingleValue(value, prop) {
-    if (value === undefined)
-        return { '@unset': true };
-    if ((0, ExpressionNode_js_1.isExpressionNode)(value)) {
-        // A computed value is an S-expr (or {@path}) via the shared codec — no IR.
-        return (0, DslJsonExpression_js_1.encodeValueExpr)(value.ir, value._refs);
-    }
-    if (value instanceof Date)
-        return { '@date': value.toISOString() };
-    if (typeof value === 'string' ||
-        typeof value === 'number' ||
-        typeof value === 'boolean') {
-        return value;
-    }
-    if (value && typeof value === 'object') {
-        // Query-context reference — carry the name, resolve at lowering (checked
-        // before the generic `.id` branch since a PendingQueryContext has an `.id` getter).
-        if (value instanceof QueryContext_js_1.PendingQueryContext) {
-            return { '@ctx': value.contextName };
-        }
-        if ('fields' in value) {
-            // Nested-node create — bare path-keyed; expected shape = the relation's value shape.
-            return encodeNodeData(value, valueShapeOf(prop));
-        }
-        if ('id' in value)
-            return { '@id': value.id };
-    }
-    throw new Error(`Cannot serialize mutation value: ${JSON.stringify(value)}`);
-}
-/** Encode any property value, including arrays and set modifications. */
-function encodeValue(value, prop) {
-    if (value === undefined)
-        return { '@unset': true };
-    if (Array.isArray(value)) {
-        return { '@list': value.map((v) => encodeSingleValue(v, prop)) };
-    }
-    if ((0, QueryFactory_js_1.isSetModificationValue)(value)) {
-        const mod = value;
-        const json = {};
-        if (mod.$add)
-            json['@add'] = mod.$add.map((v) => encodeValue(v, prop));
-        if (mod.$remove)
-            json['@remove'] = mod.$remove.map((r) => r.id);
-        return json;
-    }
-    return encodeSingleValue(value, prop);
-}
-/**
- * Encode a normalized node description to path-keyed form. `expectedShape` is the
- * shape inferable from context (the envelope, or the parent relation's value shape);
- * `__shape` is emitted only when the concrete shape differs (a subclass instance).
- */
-function encodeNodeData(desc, expectedShape) {
-    const json = {};
-    if (desc.__id)
-        json[NODE_ID_KEY] = desc.__id;
-    if (!expectedShape || desc.shape.id !== expectedShape.id) {
-        json[NODE_SHAPE_KEY] = desc.shape.id;
-    }
-    for (const f of desc.fields) {
-        json[f.prop.label] = encodeValue(f.val, f.prop);
-    }
-    return json;
-}
-// =============================================================================
-// JSON → raw UpdatePartial (for builder rehydration / fromJSON)
-// =============================================================================
-// Bound the DSL-JSON decode recursion (rehydration path) against a deeply-nested
-// payload exhausting the stack. Mirrors the cap in lowerMutationJSON.
-const MAX_DECODE_DEPTH = 128;
-let _decodeDepth = 0;
-/**
- * Decode a DSL-JSON value back to a raw DSL value (the form `.set()` accepts).
- * `currentShape` resolves computed `{@path}`/S-expr; `prop` gives a nested node's shape.
- * Depth-guarded wrapper around {@link decodeValueToRawInner}.
- */
-function decodeValueToRaw(json, currentShape, prop) {
-    if (++_decodeDepth > MAX_DECODE_DEPTH) {
-        _decodeDepth = 0;
-        throw new Error('DSL-JSON value nested too deeply');
-    }
-    try {
-        return decodeValueToRawInner(json, currentShape, prop);
-    }
-    finally {
-        _decodeDepth--;
-    }
-}
-function decodeValueToRawInner(json, currentShape, prop) {
-    var _a;
-    // S-expr computed value
-    if (Array.isArray(json)) {
-        const { ir, refs } = (0, DslJsonExpression_js_1.decodeValueExpr)(json, requireShapeForExpr(currentShape));
-        return new ExpressionNode_js_1.ExpressionNode(ir, refs);
-    }
-    if (json === null)
-        return null;
-    if (typeof json !== 'object')
-        return json; // bare scalar literal
-    const o = json;
-    if ('@unset' in o)
-        return undefined;
-    if ('@date' in o)
-        return new Date(o['@date']);
-    // Rehydration path: preserve the live reference so it re-serializes as a
-    // `{@ctx}` marker and resolves at the rebuilt builder's own lowering.
-    if ('@ctx' in o)
-        return new QueryContext_js_1.PendingQueryContext(o['@ctx']);
-    if ('@id' in o)
-        return { id: o['@id'] };
-    if ('@list' in o) {
-        return o['@list'].map((i) => decodeValueToRaw(i, currentShape, prop));
-    }
-    if ('@add' in o || '@remove' in o) {
-        // Raw DSL set-modifications use `@add`/`@remove` on the wire.
-        const mod = {};
-        if (o['@add'])
-            mod.add = o['@add'].map((i) => decodeValueToRaw(i, currentShape, prop));
-        if (o['@remove'])
-            mod.remove = o['@remove'].map((id) => ({ id }));
-        return mod;
-    }
-    // A computed-path value (`{@path}`) used as a value.
-    if ('@path' in o) {
-        const { ir, refs } = (0, DslJsonExpression_js_1.decodeValueExpr)(json, requireShapeForExpr(currentShape));
-        return new ExpressionNode_js_1.ExpressionNode(ir, refs);
-    }
-    // Otherwise: a bare path-keyed nested-node create.
-    return decodeNodeDataToRaw(o, (_a = valueShapeOf(prop)) !== null && _a !== void 0 ? _a : currentShape);
-}
-function requireShapeForExpr(shape) {
-    if (!shape) {
-        throw new Error('A shape is required to decode a computed mutation value');
-    }
-    return shape;
-}
-/**
- * Decode path-keyed node data into a raw object the mutation builders' `.set()` accepts.
- * `__id` becomes `id`; `__shape` (if present) overrides the inferred `shape`. Mirrors
- * {@link encodeNodeData}.
- */
-function decodeNodeDataToRaw(json, shape) {
-    var _a, _b;
-    const nodeShape = typeof json[NODE_SHAPE_KEY] === 'string'
-        ? (_b = (_a = (0, ShapeClass_js_1.getShapeClass)(json[NODE_SHAPE_KEY])) === null || _a === void 0 ? void 0 : _a.shape) !== null && _b !== void 0 ? _b : shape
-        : shape;
-    const obj = {};
-    if (typeof json[NODE_ID_KEY] === 'string')
-        obj.id = json[NODE_ID_KEY];
-    for (const [key, val] of Object.entries(json)) {
-        if (key === NODE_ID_KEY || key === NODE_SHAPE_KEY || val === undefined)
-            continue;
-        // Skip prototype-polluting keys from untrusted DSL-JSON input.
-        if (key === '__proto__' || key === 'constructor' || key === 'prototype')
-            continue;
-        const prop = nodeShape === null || nodeShape === void 0 ? void 0 : nodeShape.getPropertyShape(key);
-        obj[key] = decodeValueToRaw(val, nodeShape, prop);
-    }
-    return obj;
-}
-//# sourceMappingURL=MutationSerialization.js.map