@azure/provisioning-core 1.0.0-beta.1

package/dist/browser/serialization/json/expression.js

@@ -0,0 +1,494 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+import { accessExpressionNode, arrayAccessExpressionNode, functionCallExpressionNode, identifierExpressionNode, instanceFunctionCallExpressionNode, isExpressionNode, propertyAccessExpressionNode, } from "../../expression/ast-nodes.js";
+import { isExpression, unwrapExpression, wrapExpression, } from "../../expression/expressions.js";
+import { isResource, isLoopedResource } from "../../constructs/resource/resource-utils.js";
+// ---------------------------------------------------------------------------
+// ARM property-access lowering
+// ---------------------------------------------------------------------------
+/**
+ * Expands armPath stamps along a core property-access chain, replacing each
+ * stamped property with its ARM path relative to the lowered base. Empty
+ * paths fall back to the original property name. Generated accesses carry
+ * no stamps; unchanged nodes retain their identity.
+ *
+ * Recursion stops at non-property-access nodes and leaves their children
+ * untouched. serializeExpression traverses those children and invokes this
+ * helper as it reaches them; this is not a whole-expression lowering pass.
+ */
+export function lowerArmPropertyAccessChain(node) {
+    if (node.kind !== "property-access")
+        return node;
+    const loweredBase = lowerArmPropertyAccessChain(node.base);
+    if (node.armPath !== undefined) {
+        const path = node.armPath.length > 0 ? node.armPath : [node.property];
+        let current = loweredBase;
+        for (const segment of path) {
+            // A flattened optional property may be absent at any wire-path segment.
+            current = accessExpressionNode(current, segment, {
+                nullish: node.nullish,
+            });
+        }
+        return current;
+    }
+    if (loweredBase === node.base)
+        return node;
+    return { ...node, base: loweredBase };
+}
+// ---------------------------------------------------------------------------
+// Expression serialization: CDK value -> AST
+// ---------------------------------------------------------------------------
+function splitSymbolicPath(path) {
+    const parts = [];
+    let current = "";
+    let depth = 0;
+    for (const character of path) {
+        if (character === "." && depth === 0) {
+            if (current.length > 0) {
+                parts.push(current);
+                current = "";
+            }
+            continue;
+        }
+        if (character === "(") {
+            depth += 1;
+        }
+        else if (character === ")") {
+            depth -= 1;
+        }
+        current += character;
+    }
+    if (current.length > 0) {
+        parts.push(current);
+    }
+    return parts;
+}
+function serializeSymbolicPath(path) {
+    const parts = splitSymbolicPath(path);
+    let current;
+    for (const part of parts) {
+        if (part.endsWith("()")) {
+            const target = part.slice(0, -2);
+            const callNode = {
+                kind: "function-call",
+                target,
+                args: [],
+            };
+            current =
+                current === undefined
+                    ? callNode
+                    : {
+                        kind: "instance-function-call",
+                        base: current,
+                        name: target,
+                        args: [],
+                    };
+            continue;
+        }
+        current =
+            current === undefined
+                ? {
+                    kind: "identifier",
+                    id: part,
+                }
+                : {
+                    kind: "property-access",
+                    base: current,
+                    property: part,
+                    nullish: false,
+                };
+    }
+    if (current === undefined) {
+        throw new Error(`Cannot serialize empty symbolic path.`);
+    }
+    return current;
+}
+function serializePlainObject(value, symbolMap) {
+    return {
+        kind: "object",
+        value: serializeDefinedObjectEntries(value, symbolMap),
+    };
+}
+export function serializeDefinedObjectEntries(value, symbolMap) {
+    return Object.fromEntries(Object.entries(value).flatMap(([key, propertyValue]) => propertyValue === undefined ? [] : [[key, serializeExpression(propertyValue, symbolMap)]]));
+}
+function serializeArray(value, symbolMap) {
+    return {
+        kind: "array",
+        items: value.map((item) => serializeExpression(item, symbolMap)),
+    };
+}
+function isSerializableObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function serializeIdentifierExpression(value, symbolMap) {
+    if (typeof value.id === "string") {
+        return {
+            kind: "identifier",
+            id: value.id,
+        };
+    }
+    const identifier = symbolMap.get(value.id);
+    if (identifier === undefined) {
+        throw new Error(`Missing synthesized symbol for referenced resource type ${value.id.type}.`);
+    }
+    return {
+        kind: "identifier",
+        id: identifier,
+    };
+}
+function isBicepIdentifierSegment(segment) {
+    return /^[A-Za-z_][A-Za-z0-9_]*$/u.test(segment);
+}
+function serializeMemberAccessExpression(value, symbolMap) {
+    const base = serializeExpression(value.base, symbolMap);
+    if (value.kind === "property-access") {
+        return {
+            kind: "property-access",
+            base,
+            property: value.property,
+            nullish: value.nullish,
+        };
+    }
+    if (typeof value.index === "number") {
+        return {
+            kind: "array-access",
+            base,
+            index: {
+                kind: "integer",
+                value: String(value.index),
+            },
+            nullish: value.nullish,
+            fromEnd: value.fromEnd,
+        };
+    }
+    if (typeof value.index === "string") {
+        if (value.fromEnd) {
+            throw new Error("Reverse indexing requires an integer index, not a string.");
+        }
+        return isBicepIdentifierSegment(value.index)
+            ? {
+                kind: "property-access",
+                base,
+                property: value.index,
+                nullish: value.nullish,
+            }
+            : {
+                kind: "array-access",
+                base,
+                index: {
+                    kind: "string",
+                    value: value.index,
+                },
+                nullish: value.nullish,
+                fromEnd: value.fromEnd,
+            };
+    }
+    // Expression-shaped index (e.g. a loop's `.index` symbolic value or any
+    // `Expression<number>` proxy). Recursively serialize into the wire
+    // array-access's `index` slot.
+    return {
+        kind: "array-access",
+        base,
+        index: serializeExpression(value.index, symbolMap),
+        nullish: value.nullish,
+        fromEnd: value.fromEnd,
+    };
+}
+export function serializeExpression(value, symbolMap = new Map()) {
+    if (isExpression(value)) {
+        return serializeExpression(unwrapExpression(value), symbolMap);
+    }
+    // Lower the current property-access chain. Recursive serialization below
+    // visits other child expressions, lowering their property chains in turn.
+    if (value !== null && typeof value === "object" && isExpressionNode(value)) {
+        const lowered = lowerArmPropertyAccessChain(value);
+        if (lowered !== value) {
+            return serializeExpression(lowered, symbolMap);
+        }
+    }
+    if (typeof value === "string") {
+        return {
+            kind: "string",
+            value,
+        };
+    }
+    if (typeof value === "number") {
+        if (!Number.isInteger(value)) {
+            throw new Error(`Bicep serialization currently only supports integer numbers.`);
+        }
+        if (!Number.isSafeInteger(value)) {
+            throw new Error(`Bicep serialization currently only supports safe integer numbers.`);
+        }
+        return {
+            kind: "integer",
+            value: String(value),
+        };
+    }
+    if (typeof value === "boolean") {
+        return {
+            kind: "boolean",
+            value,
+        };
+    }
+    if (value === null) {
+        return {
+            kind: "null",
+            value: null,
+        };
+    }
+    if (Array.isArray(value)) {
+        return serializeArray(value, symbolMap);
+    }
+    if (isExpressionNode(value)) {
+        switch (value.kind) {
+            case "binary":
+                return {
+                    kind: "binary-operation",
+                    operator: value.operator,
+                    left: serializeExpression(value.left, symbolMap),
+                    right: serializeExpression(value.right, symbolMap),
+                };
+            case "unary":
+                return {
+                    kind: "unary-operation",
+                    operator: value.operator,
+                    argument: serializeExpression(value.argument, symbolMap),
+                };
+            case "ternary":
+                return {
+                    kind: "ternary-operation",
+                    condition: serializeExpression(value.condition, symbolMap),
+                    trueValue: serializeExpression(value.trueValue, symbolMap),
+                    falseValue: serializeExpression(value.falseValue, symbolMap),
+                };
+            case "fn-call":
+                return {
+                    kind: "function-call",
+                    target: value.operator,
+                    args: value.args.map((argument) => serializeExpression(argument, symbolMap)),
+                };
+            case "instance-function-call":
+                return {
+                    kind: "instance-function-call",
+                    base: serializeExpression(value.base, symbolMap),
+                    name: value.name,
+                    args: value.args.map((argument) => serializeExpression(argument, symbolMap)),
+                };
+            case "interpolated-string":
+                return {
+                    kind: "interpolated-string",
+                    segments: value.segments.map((segment) => serializeExpression(segment, symbolMap)),
+                };
+            case "identifier":
+                return serializeIdentifierExpression(value, symbolMap);
+            case "property-access":
+            case "array-access":
+                return serializeMemberAccessExpression(value, symbolMap);
+            case "symbolic-value": {
+                const identifier = symbolMap.get(value);
+                return identifier === undefined
+                    ? serializeSymbolicPath(value.path)
+                    : { kind: "identifier", id: identifier };
+            }
+        }
+    }
+    if (isSerializableObject(value)) {
+        return serializePlainObject(value, symbolMap);
+    }
+    throw new Error(`Unsupported serialization input.`);
+}
+// ---------------------------------------------------------------------------
+// Resource-reference validation
+// ---------------------------------------------------------------------------
+export function requireResourceHandle(targetIdentifier, symbols, resourceIdentifier, field) {
+    const handle = symbols.get(targetIdentifier);
+    if (handle === undefined) {
+        throw new Error(`Resource "${resourceIdentifier}" references unknown resource ` +
+            `"${targetIdentifier}" in "${field}".`);
+    }
+    if (!isResource(handle) && !isLoopedResource(handle)) {
+        throw new Error(`Resource "${resourceIdentifier}" references non-resource symbol ` +
+            `"${targetIdentifier}" in "${field}".`);
+    }
+    return handle;
+}
+export function deserializeDependsOnExpression(node, symbols, resourceIdentifier) {
+    if (node.kind !== "array") {
+        throw new Error(`Resource "${resourceIdentifier}" has an invalid "dependsOn" value; expected an array.`);
+    }
+    return node.items.map((item) => {
+        if (item.kind !== "identifier") {
+            throw new Error(`Resource "${resourceIdentifier}" has an invalid "dependsOn" reference; expected a resource identifier.`);
+        }
+        return requireResourceHandle(item.id, symbols, resourceIdentifier, "dependsOn");
+    });
+}
+// ---------------------------------------------------------------------------
+// Expression deserialization: AST -> CDK value
+// ---------------------------------------------------------------------------
+export function deserializeExpression(node, symbols) {
+    // TODO(#330): Legacy `contextual-variable` shim. The JS side no longer
+    // produces this kind (it emits the composed `property-access` over a
+    // zero-arg `function-call` form), but the .NET `ModelReaderWriter`
+    // still emits it on re-serialization. Accept it on input by lowering
+    // to the composed form, then fall through. Delete this whole block
+    // (and any cast it requires) once .NET stops emitting it.
+    const legacyKind = node.kind;
+    if (legacyKind === "contextual-variable") {
+        const legacy = node;
+        return wrapExpression(propertyAccessExpressionNode(functionCallExpressionNode(legacy.context, []), legacy.property));
+    }
+    switch (node.kind) {
+        case "string":
+            return node.value;
+        case "integer": {
+            const value = parseInt(node.value, 10);
+            if (!Number.isSafeInteger(value)) {
+                throw new Error(`Cannot deserialize unsafe integer literal "${node.value}".`);
+            }
+            return value;
+        }
+        case "boolean":
+            return node.value;
+        case "null":
+            return null;
+        case "identifier": {
+            const sym = symbols.get(node.id);
+            if (sym !== undefined)
+                return sym;
+            return wrapExpression(identifierExpressionNode(node.id));
+        }
+        case "function-call":
+            if (typeof node.target !== "string") {
+                throw new Error("Cannot deserialize function call with an expression target.");
+            }
+            return wrapExpression(functionCallExpressionNode(node.target, node.args.map((a) => deserializeExpression(a, symbols))));
+        case "instance-function-call": {
+            const base = deserializeExpression(node.base, symbols);
+            const baseNode = isExpression(base)
+                ? unwrapExpression(base)
+                : identifierExpressionNode(isResource(base) ? base : String(base));
+            return wrapExpression(instanceFunctionCallExpressionNode(baseNode, node.name, node.args.map((a) => deserializeExpression(a, symbols))));
+        }
+        case "property-access": {
+            const base = deserializeExpression(node.base, symbols);
+            if (isResource(base)) {
+                if (node.nullish) {
+                    return wrapExpression(propertyAccessExpressionNode(identifierExpressionNode(base), node.property, {
+                        nullish: node.nullish,
+                    }));
+                }
+                return base[node.property];
+            }
+            if (isExpression(base)) {
+                const inner = unwrapExpression(base);
+                return wrapExpression(propertyAccessExpressionNode(inner, node.property, {
+                    nullish: node.nullish,
+                }));
+            }
+            return wrapExpression(propertyAccessExpressionNode(identifierExpressionNode(String(base)), node.property, {
+                nullish: node.nullish,
+            }));
+        }
+        case "array-access": {
+            const base = deserializeExpression(node.base, symbols);
+            // Preserve non-literal indexes as expressions so `sym[<expr>]` round-
+            // trips faithfully. Literal integer/string indexes lower to native
+            // JS number/string values as before.
+            let idx;
+            if (node.index.kind === "integer") {
+                idx = parseInt(node.index.value, 10);
+            }
+            else if (node.index.kind === "string") {
+                idx = node.index.value;
+            }
+            else {
+                const deserializedIndex = deserializeExpression(node.index, symbols);
+                idx = isExpression(deserializedIndex)
+                    ? unwrapExpression(deserializedIndex)
+                    : deserializedIndex;
+            }
+            if (isResource(base)) {
+                if (node.nullish || node.fromEnd) {
+                    return wrapExpression(arrayAccessExpressionNode(identifierExpressionNode(base), idx, {
+                        nullish: node.nullish,
+                        fromEnd: node.fromEnd,
+                    }));
+                }
+                return base[String(idx)];
+            }
+            if (isLoopedResource(base)) {
+                // `sym[idx]` on a looped declaration. Carry the handle itself as the
+                // identifier id (not `String(base)`, which would stringify to
+                // "[object Object]") so re-serialize maps it back to the resource's
+                // symbol. The resulting expression proxy lets an outer `.prop` chain
+                // (e.g. `looped.at(0).id`) render as `sym[idx].prop`.
+                return wrapExpression(arrayAccessExpressionNode(identifierExpressionNode(base), idx, {
+                    nullish: node.nullish,
+                    fromEnd: node.fromEnd,
+                }));
+            }
+            if (isExpression(base)) {
+                const inner = unwrapExpression(base);
+                return wrapExpression(arrayAccessExpressionNode(inner, idx, {
+                    nullish: node.nullish,
+                    fromEnd: node.fromEnd,
+                }));
+            }
+            return wrapExpression(arrayAccessExpressionNode(identifierExpressionNode(String(base)), idx, {
+                nullish: node.nullish,
+                fromEnd: node.fromEnd,
+            }));
+        }
+        case "object": {
+            const obj = Object.create(null);
+            for (const [key, value] of Object.entries(node.value)) {
+                Object.defineProperty(obj, key, {
+                    value: deserializeExpression(value, symbols),
+                    enumerable: true,
+                    configurable: true,
+                    writable: true,
+                });
+            }
+            return obj;
+        }
+        case "array":
+            return node.items.map((item) => deserializeExpression(item, symbols));
+        case "binary-operation": {
+            const operation = node;
+            return wrapExpression({
+                kind: "binary",
+                operator: operation.operator,
+                left: deserializeExpression(operation.left, symbols),
+                right: deserializeExpression(operation.right, symbols),
+            });
+        }
+        case "unary-operation": {
+            const operation = node;
+            return wrapExpression({
+                kind: "unary",
+                operator: operation.operator,
+                argument: deserializeExpression(operation.argument, symbols),
+            });
+        }
+        case "ternary-operation": {
+            const operation = node;
+            return wrapExpression({
+                kind: "ternary",
+                condition: deserializeExpression(operation.condition, symbols),
+                trueValue: deserializeExpression(operation.trueValue, symbols),
+                falseValue: deserializeExpression(operation.falseValue, symbols),
+            });
+        }
+        case "interpolated-string": {
+            return wrapExpression({
+                kind: "interpolated-string",
+                segments: node.segments.map((segment) => deserializeExpression(segment, symbols)),
+            });
+        }
+        default:
+            throw new Error(`Unsupported expression node kind: ${node.kind}`);
+    }
+}
+//# sourceMappingURL=expression.js.map

package/dist/browser/serialization/json/expression.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expression.js","sourceRoot":"","sources":["../../../../src/serialization/json/expression.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport {\n  accessExpressionNode,\n  arrayAccessExpressionNode,\n  functionCallExpressionNode,\n  identifierExpressionNode,\n  instanceFunctionCallExpressionNode,\n  isExpressionNode,\n  propertyAccessExpressionNode,\n  type ArrayAccessIndex,\n  type ArrayAccessExpressionNode,\n  type BinaryExpressionNode,\n  type ExpressionNode as CoreExpressionNode,\n  type IdentifierExpressionNode,\n  type PropertyAccessExpressionNode,\n  type TernaryExpressionNode,\n  type UnaryExpressionNode,\n} from \"../../expression/ast-nodes.js\";\nimport {\n  isExpression,\n  unwrapExpression,\n  wrapExpression,\n  type Expression,\n} from \"../../expression/expressions.js\";\nimport { isResource, isLoopedResource } from \"../../constructs/resource/resource-utils.js\";\nimport {\n  type LoopedResource,\n  type Resource,\n  type ResourceDeclaration,\n} from \"../../constructs/resource/resource.js\";\nimport type {\n  ArrayValue,\n  BinaryOperationExpression,\n  ExpressionNode,\n  FunctionCallExpression,\n  ObjectValue,\n  TernaryOperationExpression,\n  UnaryOperationExpression,\n} from \"../contract/index.js\";\nimport type { ParameterMetadata } from \"../../constructs/parameter.js\";\nimport type { VariableMetadata } from \"../../constructs/variable.js\";\n\nexport type SerializableValue =\n  | CoreExpressionNode\n  | Expression<unknown>\n  | string\n  | number\n  | boolean\n  | null\n  | readonly SerializableValue[]\n  | {\n      readonly [key: string]: SerializableValue | undefined;\n    };\n\nexport type SerializationSymbolMap = Map<\n  ResourceDeclaration | CoreExpressionNode | ParameterMetadata | VariableMetadata,\n  string\n>;\n\ntype SymbolValue = Expression<unknown> | Resource | LoopedResource<Resource>;\nexport type DeserializationSymbolMap = Map<string, SymbolValue>;\n\n// ---------------------------------------------------------------------------\n// ARM property-access lowering\n// ---------------------------------------------------------------------------\n\n/**\n * Expands armPath stamps along a core property-access chain, replacing each\n * stamped property with its ARM path relative to the lowered base. Empty\n * paths fall back to the original property name. Generated accesses carry\n * no stamps; unchanged nodes retain their identity.\n *\n * Recursion stops at non-property-access nodes and leaves their children\n * untouched. serializeExpression traverses those children and invokes this\n * helper as it reaches them; this is not a whole-expression lowering pass.\n */\nexport function lowerArmPropertyAccessChain(node: CoreExpressionNode): CoreExpressionNode {\n  if (node.kind !== \"property-access\") return node;\n\n  const loweredBase = lowerArmPropertyAccessChain(node.base);\n  if (node.armPath !== undefined) {\n    const path = node.armPath.length > 0 ? node.armPath : [node.property];\n    let current: CoreExpressionNode = loweredBase;\n    for (const segment of path) {\n      // A flattened optional property may be absent at any wire-path segment.\n      current = accessExpressionNode(current, segment, {\n        nullish: node.nullish,\n      });\n    }\n    return current;\n  }\n  if (loweredBase === node.base) return node;\n  return { ...node, base: loweredBase };\n}\n\n// ---------------------------------------------------------------------------\n// Expression serialization: CDK value -> AST\n// ---------------------------------------------------------------------------\n\nfunction splitSymbolicPath(path: string): string[] {\n  const parts: string[] = [];\n  let current = \"\";\n  let depth = 0;\n\n  for (const character of path) {\n    if (character === \".\" && depth === 0) {\n      if (current.length > 0) {\n        parts.push(current);\n        current = \"\";\n      }\n      continue;\n    }\n\n    if (character === \"(\") {\n      depth += 1;\n    } else if (character === \")\") {\n      depth -= 1;\n    }\n\n    current += character;\n  }\n\n  if (current.length > 0) {\n    parts.push(current);\n  }\n\n  return parts;\n}\n\nfunction serializeSymbolicPath(path: string): ExpressionNode {\n  const parts = splitSymbolicPath(path);\n  let current: ExpressionNode | undefined;\n\n  for (const part of parts) {\n    if (part.endsWith(\"()\")) {\n      const target = part.slice(0, -2);\n      const callNode: FunctionCallExpression = {\n        kind: \"function-call\",\n        target,\n        args: [],\n      };\n\n      current =\n        current === undefined\n          ? callNode\n          : {\n              kind: \"instance-function-call\",\n              base: current,\n              name: target,\n              args: [],\n            };\n      continue;\n    }\n\n    current =\n      current === undefined\n        ? {\n            kind: \"identifier\",\n            id: part,\n          }\n        : {\n            kind: \"property-access\",\n            base: current,\n            property: part,\n            nullish: false,\n          };\n  }\n\n  if (current === undefined) {\n    throw new Error(`Cannot serialize empty symbolic path.`);\n  }\n\n  return current;\n}\n\nfunction serializePlainObject(\n  value: { readonly [key: string]: SerializableValue | undefined },\n  symbolMap: SerializationSymbolMap,\n): ObjectValue {\n  return {\n    kind: \"object\",\n    value: serializeDefinedObjectEntries(value, symbolMap),\n  };\n}\n\nexport function serializeDefinedObjectEntries(\n  value: { readonly [key: string]: SerializableValue | undefined },\n  symbolMap: SerializationSymbolMap,\n): Record<string, ExpressionNode> {\n  return Object.fromEntries(\n    Object.entries(value).flatMap(([key, propertyValue]) =>\n      propertyValue === undefined ? [] : [[key, serializeExpression(propertyValue, symbolMap)]],\n    ),\n  );\n}\n\nfunction serializeArray(\n  value: readonly SerializableValue[],\n  symbolMap: SerializationSymbolMap,\n): ArrayValue {\n  return {\n    kind: \"array\",\n    items: value.map((item) => serializeExpression(item, symbolMap)),\n  };\n}\n\nfunction isSerializableObject(\n  value: SerializableValue,\n): value is { readonly [key: string]: SerializableValue | undefined } {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction serializeIdentifierExpression(\n  value: IdentifierExpressionNode,\n  symbolMap: SerializationSymbolMap,\n): ExpressionNode {\n  if (typeof value.id === \"string\") {\n    return {\n      kind: \"identifier\",\n      id: value.id,\n    };\n  }\n\n  const identifier = symbolMap.get(value.id);\n\n  if (identifier === undefined) {\n    throw new Error(`Missing synthesized symbol for referenced resource type ${value.id.type}.`);\n  }\n\n  return {\n    kind: \"identifier\",\n    id: identifier,\n  };\n}\n\nfunction isBicepIdentifierSegment(segment: string): boolean {\n  return /^[A-Za-z_][A-Za-z0-9_]*$/u.test(segment);\n}\n\nfunction serializeMemberAccessExpression(\n  value: PropertyAccessExpressionNode | ArrayAccessExpressionNode,\n  symbolMap: SerializationSymbolMap,\n): ExpressionNode {\n  const base = serializeExpression(value.base, symbolMap);\n\n  if (value.kind === \"property-access\") {\n    return {\n      kind: \"property-access\",\n      base,\n      property: value.property,\n      nullish: value.nullish,\n    };\n  }\n\n  if (typeof value.index === \"number\") {\n    return {\n      kind: \"array-access\",\n      base,\n      index: {\n        kind: \"integer\",\n        value: String(value.index),\n      },\n      nullish: value.nullish,\n      fromEnd: value.fromEnd,\n    };\n  }\n\n  if (typeof value.index === \"string\") {\n    if (value.fromEnd) {\n      throw new Error(\"Reverse indexing requires an integer index, not a string.\");\n    }\n    return isBicepIdentifierSegment(value.index)\n      ? {\n          kind: \"property-access\",\n          base,\n          property: value.index,\n          nullish: value.nullish,\n        }\n      : {\n          kind: \"array-access\",\n          base,\n          index: {\n            kind: \"string\",\n            value: value.index,\n          },\n          nullish: value.nullish,\n          fromEnd: value.fromEnd,\n        };\n  }\n\n  // Expression-shaped index (e.g. a loop's `.index` symbolic value or any\n  // `Expression<number>` proxy). Recursively serialize into the wire\n  // array-access's `index` slot.\n  return {\n    kind: \"array-access\",\n    base,\n    index: serializeExpression(value.index as SerializableValue, symbolMap),\n    nullish: value.nullish,\n    fromEnd: value.fromEnd,\n  };\n}\n\nexport function serializeExpression(\n  value: SerializableValue,\n  symbolMap: SerializationSymbolMap = new Map(),\n): ExpressionNode {\n  if (isExpression(value)) {\n    return serializeExpression(unwrapExpression(value) as SerializableValue, symbolMap);\n  }\n\n  // Lower the current property-access chain. Recursive serialization below\n  // visits other child expressions, lowering their property chains in turn.\n  if (value !== null && typeof value === \"object\" && isExpressionNode(value)) {\n    const lowered = lowerArmPropertyAccessChain(value as CoreExpressionNode);\n    if (lowered !== value) {\n      return serializeExpression(lowered as SerializableValue, symbolMap);\n    }\n  }\n\n  if (typeof value === \"string\") {\n    return {\n      kind: \"string\",\n      value,\n    };\n  }\n\n  if (typeof value === \"number\") {\n    if (!Number.isInteger(value)) {\n      throw new Error(`Bicep serialization currently only supports integer numbers.`);\n    }\n    if (!Number.isSafeInteger(value)) {\n      throw new Error(`Bicep serialization currently only supports safe integer numbers.`);\n    }\n\n    return {\n      kind: \"integer\",\n      value: String(value),\n    };\n  }\n\n  if (typeof value === \"boolean\") {\n    return {\n      kind: \"boolean\",\n      value,\n    };\n  }\n\n  if (value === null) {\n    return {\n      kind: \"null\",\n      value: null,\n    };\n  }\n\n  if (Array.isArray(value)) {\n    return serializeArray(value, symbolMap);\n  }\n\n  if (isExpressionNode(value)) {\n    switch (value.kind) {\n      case \"binary\":\n        return {\n          kind: \"binary-operation\",\n          operator: value.operator,\n          left: serializeExpression(value.left as SerializableValue, symbolMap),\n          right: serializeExpression(value.right as SerializableValue, symbolMap),\n        };\n\n      case \"unary\":\n        return {\n          kind: \"unary-operation\",\n          operator: value.operator,\n          argument: serializeExpression(value.argument as SerializableValue, symbolMap),\n        };\n\n      case \"ternary\":\n        return {\n          kind: \"ternary-operation\",\n          condition: serializeExpression(value.condition as SerializableValue, symbolMap),\n          trueValue: serializeExpression(value.trueValue as SerializableValue, symbolMap),\n          falseValue: serializeExpression(value.falseValue as SerializableValue, symbolMap),\n        };\n\n      case \"fn-call\":\n        return {\n          kind: \"function-call\",\n          target: value.operator,\n          args: value.args.map((argument) =>\n            serializeExpression(argument as SerializableValue, symbolMap),\n          ),\n        };\n\n      case \"instance-function-call\":\n        return {\n          kind: \"instance-function-call\",\n          base: serializeExpression(value.base as SerializableValue, symbolMap),\n          name: value.name,\n          args: value.args.map((argument) =>\n            serializeExpression(argument as SerializableValue, symbolMap),\n          ),\n        };\n\n      case \"interpolated-string\":\n        return {\n          kind: \"interpolated-string\",\n          segments: value.segments.map((segment) =>\n            serializeExpression(segment as SerializableValue, symbolMap),\n          ),\n        };\n\n      case \"identifier\":\n        return serializeIdentifierExpression(value, symbolMap);\n\n      case \"property-access\":\n      case \"array-access\":\n        return serializeMemberAccessExpression(value, symbolMap);\n\n      case \"symbolic-value\": {\n        const identifier = symbolMap.get(value);\n        return identifier === undefined\n          ? serializeSymbolicPath(value.path)\n          : { kind: \"identifier\", id: identifier };\n      }\n    }\n  }\n\n  if (isSerializableObject(value)) {\n    return serializePlainObject(value, symbolMap);\n  }\n\n  throw new Error(`Unsupported serialization input.`);\n}\n\n// ---------------------------------------------------------------------------\n// Resource-reference validation\n// ---------------------------------------------------------------------------\n\nexport function requireResourceHandle(\n  targetIdentifier: string,\n  symbols: DeserializationSymbolMap,\n  resourceIdentifier: string,\n  field: \"parent\" | \"scope\" | \"dependsOn\",\n): Resource | LoopedResource<Resource> {\n  const handle = symbols.get(targetIdentifier);\n  if (handle === undefined) {\n    throw new Error(\n      `Resource \"${resourceIdentifier}\" references unknown resource ` +\n        `\"${targetIdentifier}\" in \"${field}\".`,\n    );\n  }\n  if (!isResource(handle) && !isLoopedResource(handle)) {\n    throw new Error(\n      `Resource \"${resourceIdentifier}\" references non-resource symbol ` +\n        `\"${targetIdentifier}\" in \"${field}\".`,\n    );\n  }\n  return handle;\n}\n\nexport function deserializeDependsOnExpression(\n  node: ExpressionNode,\n  symbols: DeserializationSymbolMap,\n  resourceIdentifier: string,\n): readonly ResourceDeclaration[] {\n  if (node.kind !== \"array\") {\n    throw new Error(\n      `Resource \"${resourceIdentifier}\" has an invalid \"dependsOn\" value; expected an array.`,\n    );\n  }\n\n  return node.items.map((item) => {\n    if (item.kind !== \"identifier\") {\n      throw new Error(\n        `Resource \"${resourceIdentifier}\" has an invalid \"dependsOn\" reference; expected a resource identifier.`,\n      );\n    }\n    return requireResourceHandle(item.id, symbols, resourceIdentifier, \"dependsOn\");\n  });\n}\n\n// ---------------------------------------------------------------------------\n// Expression deserialization: AST -> CDK value\n// ---------------------------------------------------------------------------\n\nexport function deserializeExpression(\n  node: ExpressionNode,\n  symbols: DeserializationSymbolMap,\n): unknown {\n  // TODO(#330): Legacy `contextual-variable` shim. The JS side no longer\n  // produces this kind (it emits the composed `property-access` over a\n  // zero-arg `function-call` form), but the .NET `ModelReaderWriter`\n  // still emits it on re-serialization. Accept it on input by lowering\n  // to the composed form, then fall through. Delete this whole block\n  // (and any cast it requires) once .NET stops emitting it.\n  const legacyKind = (node as { kind: string }).kind;\n  if (legacyKind === \"contextual-variable\") {\n    const legacy = node as unknown as {\n      kind: \"contextual-variable\";\n      context: string;\n      property: string;\n    };\n    return wrapExpression(\n      propertyAccessExpressionNode(functionCallExpressionNode(legacy.context, []), legacy.property),\n    );\n  }\n\n  switch (node.kind) {\n    case \"string\":\n      return node.value;\n    case \"integer\": {\n      const value = parseInt(node.value, 10);\n      if (!Number.isSafeInteger(value)) {\n        throw new Error(`Cannot deserialize unsafe integer literal \"${node.value}\".`);\n      }\n      return value;\n    }\n    case \"boolean\":\n      return node.value;\n    case \"null\":\n      return null;\n\n    case \"identifier\": {\n      const sym = symbols.get(node.id);\n      if (sym !== undefined) return sym;\n      return wrapExpression(identifierExpressionNode(node.id));\n    }\n\n    case \"function-call\":\n      if (typeof node.target !== \"string\") {\n        throw new Error(\"Cannot deserialize function call with an expression target.\");\n      }\n      return wrapExpression(\n        functionCallExpressionNode(\n          node.target,\n          node.args.map((a) => deserializeExpression(a, symbols)),\n        ),\n      );\n\n    case \"instance-function-call\": {\n      const base = deserializeExpression(node.base, symbols);\n      const baseNode = isExpression(base)\n        ? unwrapExpression(base as Expression<unknown>)\n        : identifierExpressionNode(isResource(base) ? base : String(base));\n      return wrapExpression(\n        instanceFunctionCallExpressionNode(\n          baseNode,\n          node.name,\n          node.args.map((a) => deserializeExpression(a, symbols)),\n        ),\n      );\n    }\n\n    case \"property-access\": {\n      const base = deserializeExpression(node.base, symbols);\n      if (isResource(base)) {\n        if (node.nullish) {\n          return wrapExpression(\n            propertyAccessExpressionNode(identifierExpressionNode(base), node.property, {\n              nullish: node.nullish,\n            }),\n          );\n        }\n        return (base as unknown as Record<string, unknown>)[node.property];\n      }\n      if (isExpression(base)) {\n        const inner = unwrapExpression(base as Expression<unknown>);\n        return wrapExpression(\n          propertyAccessExpressionNode(inner, node.property, {\n            nullish: node.nullish,\n          }),\n        );\n      }\n      return wrapExpression(\n        propertyAccessExpressionNode(identifierExpressionNode(String(base)), node.property, {\n          nullish: node.nullish,\n        }),\n      );\n    }\n\n    case \"array-access\": {\n      const base = deserializeExpression(node.base, symbols);\n      // Preserve non-literal indexes as expressions so `sym[<expr>]` round-\n      // trips faithfully. Literal integer/string indexes lower to native\n      // JS number/string values as before.\n      let idx: ArrayAccessIndex;\n      if (node.index.kind === \"integer\") {\n        idx = parseInt(node.index.value, 10);\n      } else if (node.index.kind === \"string\") {\n        idx = node.index.value;\n      } else {\n        const deserializedIndex = deserializeExpression(node.index, symbols);\n        idx = isExpression(deserializedIndex)\n          ? unwrapExpression(deserializedIndex as Expression<unknown>)\n          : (deserializedIndex as ArrayAccessIndex);\n      }\n      if (isResource(base)) {\n        if (node.nullish || node.fromEnd) {\n          return wrapExpression(\n            arrayAccessExpressionNode(identifierExpressionNode(base), idx, {\n              nullish: node.nullish,\n              fromEnd: node.fromEnd,\n            }),\n          );\n        }\n        return (base as unknown as Record<string, unknown>)[String(idx)];\n      }\n      if (isLoopedResource(base)) {\n        // `sym[idx]` on a looped declaration. Carry the handle itself as the\n        // identifier id (not `String(base)`, which would stringify to\n        // \"[object Object]\") so re-serialize maps it back to the resource's\n        // symbol. The resulting expression proxy lets an outer `.prop` chain\n        // (e.g. `looped.at(0).id`) render as `sym[idx].prop`.\n        return wrapExpression(\n          arrayAccessExpressionNode(identifierExpressionNode(base as unknown as Resource), idx, {\n            nullish: node.nullish,\n            fromEnd: node.fromEnd,\n          }),\n        );\n      }\n      if (isExpression(base)) {\n        const inner = unwrapExpression(base as Expression<unknown>);\n        return wrapExpression(\n          arrayAccessExpressionNode(inner, idx, {\n            nullish: node.nullish,\n            fromEnd: node.fromEnd,\n          }),\n        );\n      }\n      return wrapExpression(\n        arrayAccessExpressionNode(identifierExpressionNode(String(base)), idx, {\n          nullish: node.nullish,\n          fromEnd: node.fromEnd,\n        }),\n      );\n    }\n\n    case \"object\": {\n      const obj: Record<string, unknown> = Object.create(null);\n      for (const [key, value] of Object.entries(node.value)) {\n        Object.defineProperty(obj, key, {\n          value: deserializeExpression(value, symbols),\n          enumerable: true,\n          configurable: true,\n          writable: true,\n        });\n      }\n      return obj;\n    }\n\n    case \"array\":\n      return node.items.map((item) => deserializeExpression(item, symbols));\n\n    case \"binary-operation\": {\n      const operation = node as BinaryOperationExpression;\n      return wrapExpression({\n        kind: \"binary\",\n        operator: operation.operator,\n        left: deserializeExpression(operation.left, symbols),\n        right: deserializeExpression(operation.right, symbols),\n      } as BinaryExpressionNode as CoreExpressionNode);\n    }\n\n    case \"unary-operation\": {\n      const operation = node as UnaryOperationExpression;\n      return wrapExpression({\n        kind: \"unary\",\n        operator: operation.operator,\n        argument: deserializeExpression(operation.argument, symbols),\n      } as UnaryExpressionNode as CoreExpressionNode);\n    }\n\n    case \"ternary-operation\": {\n      const operation = node as TernaryOperationExpression;\n      return wrapExpression({\n        kind: \"ternary\",\n        condition: deserializeExpression(operation.condition, symbols),\n        trueValue: deserializeExpression(operation.trueValue, symbols),\n        falseValue: deserializeExpression(operation.falseValue, symbols),\n      } as TernaryExpressionNode as CoreExpressionNode);\n    }\n\n    case \"interpolated-string\": {\n      return wrapExpression({\n        kind: \"interpolated-string\",\n        segments: node.segments.map((segment) => deserializeExpression(segment, symbols)),\n      } as CoreExpressionNode);\n    }\n\n    default:\n      throw new Error(`Unsupported expression node kind: ${node.kind}`);\n  }\n}\n"]}

package/dist/browser/serialization/json/lower.d.ts

@@ -0,0 +1,41 @@
+/**
+ * ARM state-shape conversion.
+ *
+ * lowerState maps JS property names to ARM paths, restores flattened
+ * nesting, and encodes terminal values using the supplied model shape.
+ * raiseState performs the inverse conversion for deserialization.
+ * Both follow nested model, array, and record shapes and preserve unknown
+ * keys. Property-access expression lowering lives in expression.ts.
+ */
+import { type ModelShape } from "../../shape/shape.js";
+/**
+ * Recursively rewrite a raw state object into its ARM wire shape. Keys
+ * not present in `shape.byJsName` pass through unchanged. Multi-
+ * segment ARM paths (from `@flattenProperty`) re-nest objects; nested
+ * models, arrays-of-models and records-of-models recurse via
+ * `target`. Empty ARM paths fall back to the JS property name.
+ *
+ * Collisions where two JS-side keys map to overlapping ARM paths merge
+ * when both sides are compatible objects; non-object / object collisions
+ * throw.
+ */
+export declare function lowerState(state: Record<string, unknown>, shape: ModelShape, visited?: WeakSet<object>): Record<string, unknown>;
+/**
+ * Inverse of `lowerState`: walks a wire-shape state object and lifts
+ * values at each property entry's `armPath` back onto the flat
+ * `jsName` key. Recurses into nested model / array / record values via
+ * `target`. Empty ARM paths fall back to the JS property name.
+ *
+ * ARM-shape keys that consumed a nested object entirely (single-segment
+ * paths carrying a model `target`) pop that segment from the source
+ * so leftovers at intermediate nodes don't silently leak into the
+ * output. For multi-segment paths (`@flattenProperty`), only the leaf
+ * is extracted; intermediate shared objects may survive as their own
+ * top-level entries if the shape also declares a jsName for them.
+ *
+ * Keys present in the state but not consumed by any property entry
+ * pass through unchanged (preserving the "unknown key" escape hatch
+ * documented in `lowerState`).
+ */
+export declare function raiseState(state: Record<string, unknown>, shape: ModelShape, visited?: WeakSet<object>): Record<string, unknown>;
+//# sourceMappingURL=lower.d.ts.map

package/dist/browser/serialization/json/lower.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lower.d.ts","sourceRoot":"","sources":["../../../../src/serialization/json/lower.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AAEH,OAAO,EAEL,KAAK,UAAU,EAGhB,MAAM,sBAAsB,CAAC;AAwB9B;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,KAAK,EAAE,UAAU,EACjB,OAAO,GAAE,OAAO,CAAC,MAAM,CAAiB,GACvC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA8BzB;AAmJD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,KAAK,EAAE,UAAU,EACjB,OAAO,GAAE,OAAO,CAAC,MAAM,CAAiB,GACvC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA8CzB"}