@azure/provisioning-core 0.1.0-alpha.20261014.1

package/dist/constructs/resource/resource-proxy.js

@@ -0,0 +1,523 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+import { EXPRESSION_BRAND, isExpression, unwrapExpression, } from "../../expression/expressions.js";
+import { accessExpressionNode, arrayAccessExpressionNode, identifierExpressionNode, isExpressionNode, } from "../../expression/ast-nodes.js";
+import { navigateShape, } from "../../shape/shape.js";
+import { getShape } from "../../shape/shape-registry.js";
+export const RAW_RESOURCE_HANDLE = Symbol("raw-resource-handle");
+export const RESOURCE_BRAND = Symbol.for("@azure/provisioning-core.Resource");
+/**
+ * Brand present on every `LoopedResource` instance. Lives here (rather than
+ * on the `LoopedResource` class) so tree-walking utilities can brand-check
+ * for looped declarations without a runtime import of `resource.ts` — which
+ * would create an eval-time import cycle (`resource.ts` extends `ProvisioningComponent`).
+ * Use {@link isLoopedResource} in normal code.
+ */
+export const LOOPED_RESOURCE_BRAND = Symbol.for("@azure/provisioning-core.LoopedResource");
+/**
+ * Brand present on every `ResourceDeclaration` instance (both scalar
+ * `Resource` and looped `LoopedResource`). Use
+ * {@link isResourceDeclaration} instead of a direct
+ * brand check.
+ */
+export const RESOURCE_DECLARATION_BRAND = Symbol.for("@azure/provisioning-core.ResourceDeclaration");
+/**
+ * Present on indexed resource proxies (see {@link createIndexedResourceProxy}).
+ * Reading it off any resource-like value returns the stored index expression
+ * for indexed proxies, and `undefined` for plain outer proxies. The base
+ * `Resource` constructor probes for it on the `context` argument to detect
+ * `parents.at(i)` / `parents.current()` being passed as a child parent
+ * context; other consumers may probe it for their own purposes (the proxy
+ * itself doesn't imply any parent-child relationship — the index is simply
+ * what identifies which element of a looped declaration this proxy refers
+ * to).
+ */
+export const PROXY_INDEX_REF = Symbol.for("@azure/provisioning-core.PROXY_INDEX_REF");
+/**
+ * Present on indexed resource proxies. Reading it returns the underlying
+ * outer-proxy resource that the indexed proxy wraps. Used by the base
+ * `Resource` constructor to normalize `this.parent` back to the raw parent
+ * (so tree walks and symbol-map lookups continue to work) while
+ * `PROXY_INDEX_REF` carries the "which index" information onto `state`.
+ */
+export const INDEXED_PROXY_TARGET = Symbol.for("@azure/provisioning-core.INDEXED_PROXY_TARGET");
+/**
+ * State-object key under which the base `Resource` constructor records the
+ * index expression when the `context` argument is an indexed proxy (i.e.,
+ * `parent.at(i)` / `parent.current()`). The serializer reads this key
+ * from the child's raw state to emit `parent: parentSym[<index>]` instead
+ * of the bare `parent: parentSym` form. Kept as a shared const so writer
+ * (`resource.ts`) and reader (`serialize.ts`) never drift.
+ *
+ * Lives on the **child**, not the parent: siblings under the same parent
+ * can be created via different indexed proxies (e.g. `new Child(p.at(0), …)`
+ * and `new Child(p.at(1), …)` both resolve `.parent` to the same raw parent,
+ * so the index that distinguishes them must be recorded per-child).
+ */
+export const STATE_PARENT_INDEX = "parentIndex";
+function stepsToPath(steps) {
+    return steps.map((s) => s.segment);
+}
+const PROPERTY_PROXY_STATE = Symbol("property-proxy-state");
+function isPropertyProxy(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        Reflect.get(value, PROPERTY_PROXY_STATE) !== undefined);
+}
+function getPropertyProxyState(value) {
+    return value[PROPERTY_PROXY_STATE];
+}
+export function deref(value) {
+    if (isPropertyProxy(value)) {
+        const state = getPropertyProxyState(value);
+        return getValueAtPath(state.root, stepsToPath(state.steps));
+    }
+    if (isResourceHandle(value)) {
+        return unwrapResourceHandle(value);
+    }
+    return value;
+}
+// ---------------------------------------------------------------------------
+// Path helpers
+// ---------------------------------------------------------------------------
+function isPlainObject(value) {
+    if (typeof value !== "object" || value === null) {
+        return false;
+    }
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+function getValueAtPath(root, path) {
+    let current = root;
+    for (const segment of path) {
+        if (typeof current !== "object" || current === null) {
+            return undefined;
+        }
+        if (!Object.prototype.hasOwnProperty.call(current, String(segment))) {
+            return undefined;
+        }
+        current = current[String(segment)];
+    }
+    return current;
+}
+function setValueAtPath(root, path, value) {
+    let current = root;
+    for (let index = 0; index < path.length - 1; index += 1) {
+        const segment = String(path[index]);
+        const nextSegment = path[index + 1];
+        const existing = Object.prototype.hasOwnProperty.call(current, segment)
+            ? current[segment]
+            : undefined;
+        if (typeof existing === "object" && existing !== null) {
+            current = existing;
+            continue;
+        }
+        const container = (typeof nextSegment === "number" ? [] : Object.create(null));
+        Object.defineProperty(current, segment, {
+            value: container,
+            enumerable: true,
+            configurable: true,
+            writable: true,
+        });
+        current = container;
+    }
+    Object.defineProperty(current, String(path[path.length - 1]), {
+        value,
+        enumerable: true,
+        configurable: true,
+        writable: true,
+    });
+}
+// ---------------------------------------------------------------------------
+// Expression construction
+// ---------------------------------------------------------------------------
+function createMemberAccessPathExpression(resource, steps, index) {
+    let current = identifierExpressionNode(resource);
+    if (index !== undefined) {
+        current = arrayAccessExpressionNode(current, index);
+    }
+    for (const { segment, armPath } of steps) {
+        current = accessExpressionNode(current, segment, { armPath });
+    }
+    return current;
+}
+// ---------------------------------------------------------------------------
+// Value normalization
+// ---------------------------------------------------------------------------
+export function normalizeAssignedValue(value, currentResource) {
+    if (isPropertyProxy(value)) {
+        const state = getPropertyProxyState(value);
+        if (currentResource && state.resource === currentResource) {
+            // Same-resource proxy → inline raw value (avoids self-references)
+            return getValueAtPath(state.root, stepsToPath(state.steps));
+        }
+        return createMemberAccessPathExpression(state.resource, state.steps, state.index);
+    }
+    if (isResourceHandle(value)) {
+        return identifierExpressionNode(value);
+    }
+    if (isExpression(value)) {
+        return unwrapExpression(value);
+    }
+    if (isExpressionNode(value)) {
+        return value;
+    }
+    if (Array.isArray(value)) {
+        return value.map((item) => normalizeAssignedValue(item, currentResource));
+    }
+    if (isPlainObject(value)) {
+        return normalizeObjectValue(value, currentResource);
+    }
+    return value;
+}
+function normalizeObjectValue(obj, currentResource) {
+    const entries = Object.entries(obj);
+    const result = Object.create(null);
+    for (const [key, value] of entries) {
+        if (isPropertyProxy(value)) {
+            const state = getPropertyProxyState(value);
+            if (currentResource && state.resource === currentResource) {
+                // Same-resource → inline raw value (avoids self-references)
+                result[key] = getValueAtPath(state.root, stepsToPath(state.steps));
+                continue;
+            }
+        }
+        result[key] = normalizeAssignedValue(value, currentResource);
+    }
+    return result;
+}
+// ---------------------------------------------------------------------------
+// Property proxy
+// ---------------------------------------------------------------------------
+function toPropertySegment(property, nav, currentValue) {
+    const isIndexedContainer = nav?.kind === "array" ||
+        nav?.kind === "tuple" ||
+        Array.isArray(currentValue);
+    return isIndexedContainer && /^\d+$/u.test(property)
+        ? Number(property)
+        : property;
+}
+function getPropertyProxyTarget(state) {
+    const currentValue = getValueAtPath(state.root, stepsToPath(state.steps));
+    if (typeof currentValue === "object" && currentValue !== null) {
+        return currentValue;
+    }
+    return {};
+}
+function createPropertyProxy(state) {
+    // Always use a fresh empty target — avoids Proxy invariant violations
+    // when the stored value has non-configurable properties (e.g. EXPRESSION_BRAND).
+    const target = {};
+    return new Proxy(target, {
+        has(proxyTarget, property) {
+            if (property === PROPERTY_PROXY_STATE || property === EXPRESSION_BRAND) {
+                return true;
+            }
+            const backing = getPropertyProxyTarget(state);
+            if (Reflect.has(backing, property))
+                return true;
+            return Reflect.has(proxyTarget, property);
+        },
+        ownKeys() {
+            const backing = getPropertyProxyTarget(state);
+            return Reflect.ownKeys(backing).filter((k) => typeof k === "string");
+        },
+        getOwnPropertyDescriptor(_proxyTarget, property) {
+            const backing = getPropertyProxyTarget(state);
+            if (typeof property === "string" &&
+                Object.prototype.hasOwnProperty.call(backing, property)) {
+                return { enumerable: true, configurable: true, writable: true };
+            }
+            return undefined;
+        },
+        get(proxyTarget, property, receiver) {
+            if (property === PROPERTY_PROXY_STATE) {
+                return state;
+            }
+            if (property === EXPRESSION_BRAND) {
+                return createMemberAccessPathExpression(state.resource, state.steps, state.index);
+            }
+            if (property === Symbol.toPrimitive) {
+                return () => `[ResourceMember ${stepsToPath(state.steps).map(String).join(".")}]`;
+            }
+            if (typeof property !== "string") {
+                return Reflect.get(proxyTarget, property, receiver);
+            }
+            if (property === "toString") {
+                return () => `[ResourceMember ${stepsToPath(state.steps).map(String).join(".")}]`;
+            }
+            if (property === "valueOf") {
+                return () => createMemberAccessPathExpression(state.resource, state.steps, state.index);
+            }
+            if (property === "then") {
+                return undefined;
+            }
+            const currentValue = getValueAtPath(state.root, stepsToPath(state.steps));
+            const segment = toPropertySegment(property, state.nav, currentValue);
+            // Pass the value at the current position so a discriminated nav
+            // can select its variant (see `resolveModelShape`).
+            const step = navigateShape(state.nav, segment, currentValue);
+            const nextArmPath = step.stamp?.armPath;
+            const nextNav = step.next;
+            return createPropertyProxy({
+                ...state,
+                steps: [...state.steps, { segment, armPath: nextArmPath }],
+                nav: nextNav,
+            });
+        },
+        set(_proxyTarget, property, value) {
+            if (typeof property !== "string") {
+                return false;
+            }
+            // A looped element (`parent.at(i)`) yields member proxies stamped with
+            // an index. Writing through one would mutate the shared for-loop body,
+            // which is not valid Bicep — `sym[i].prop = ...` cannot be expressed.
+            if (state.index !== undefined) {
+                throwLoopedElementWriteError();
+            }
+            setValueAtPath(state.root, [
+                ...stepsToPath(state.steps),
+                toPropertySegment(property, state.nav, getValueAtPath(state.root, stepsToPath(state.steps))),
+            ], normalizeAssignedValue(value, state.resource));
+            return true;
+        },
+    });
+}
+// ---------------------------------------------------------------------------
+// Resource member proxy
+// ---------------------------------------------------------------------------
+function isNonEnumerableOwnProperty(target, property) {
+    const descriptor = Reflect.getOwnPropertyDescriptor(target, property);
+    return descriptor?.enumerable === false;
+}
+function hasOwnOrPrototypeProperty(target, property) {
+    let current = target;
+    while (current !== null) {
+        if (Object.prototype.hasOwnProperty.call(current, property)) {
+            return true;
+        }
+        current = Object.getPrototypeOf(current);
+    }
+    return false;
+}
+export function createResourceMemberProxy(source, path) {
+    // Seed nav from the resource's shape (if any). Walk the existing
+    // path, transitioning nav at each step so every segment is stamped
+    // correctly. Pre-existing callers pass paths they built manually, so
+    // we treat unknown navigations as passthrough.
+    const rootShape = getResourceShape(source.resource);
+    let nav = rootShape;
+    const steps = [];
+    for (const segment of path) {
+        const step = navigateShape(nav, segment, getValueAtPath(source.root, stepsToPath(steps)));
+        steps.push({ segment, armPath: step.stamp?.armPath });
+        nav = step.next;
+    }
+    return createPropertyProxy({
+        ...source,
+        steps,
+        nav,
+    });
+}
+function getResourceShape(resource) {
+    // Look up by (armType, apiVersion), letting the registry resolve
+    // any discriminated variant from the instance's own state (typically
+    // the hardcoded `name` literal each variant class sets).
+    const state = resource[RAW_RESOURCE_HANDLE];
+    return getShape(resource.type, resource.apiVersion, state);
+}
+// ---------------------------------------------------------------------------
+// Resource-level proxy
+// ---------------------------------------------------------------------------
+export function createResourceProxy(resource) {
+    function getBackingResourceData(target) {
+        return Reflect.get(target, RAW_RESOURCE_HANDLE);
+    }
+    const proxy = new Proxy(resource, {
+        ownKeys(target) {
+            return Array.from(new Set([
+                ...Reflect.ownKeys(target),
+                ...Reflect.ownKeys(getBackingResourceData(target)).filter((key) => key !== RAW_RESOURCE_HANDLE),
+            ]));
+        },
+        getOwnPropertyDescriptor(target, property) {
+            const targetDescriptor = Reflect.getOwnPropertyDescriptor(target, property);
+            if (targetDescriptor !== undefined) {
+                return targetDescriptor;
+            }
+            const backing = getBackingResourceData(target);
+            if (Object.prototype.hasOwnProperty.call(backing, property)) {
+                return { enumerable: true, configurable: true, writable: true };
+            }
+            return undefined;
+        },
+        get(target, property, receiver) {
+            if (typeof property !== "string") {
+                return Reflect.get(target, property, receiver);
+            }
+            if (property === "then") {
+                return Reflect.get(target, property, receiver);
+            }
+            if (hasOwnOrPrototypeProperty(target, property) ||
+                isNonEnumerableOwnProperty(target, property)) {
+                return Reflect.get(target, property, receiver);
+            }
+            const rootState = unwrapResourceHandle(proxy);
+            const rootShape = getResourceShape(target);
+            const segment = toPropertySegment(property, rootShape, rootState);
+            const step = navigateShape(rootShape, segment, rootState);
+            const armPath = step.stamp?.armPath;
+            const nav = step.next;
+            return createPropertyProxy({
+                resource: proxy,
+                root: rootState,
+                steps: [{ segment, armPath }],
+                nav,
+            });
+        },
+        set(target, property, value, receiver) {
+            if (typeof property !== "string") {
+                return Reflect.set(target, property, value, receiver);
+            }
+            if (hasOwnOrPrototypeProperty(target, property) ||
+                isNonEnumerableOwnProperty(target, property)) {
+                return Reflect.set(target, property, value, receiver);
+            }
+            setValueAtPath(unwrapResourceHandle(proxy), [
+                toPropertySegment(property, getResourceShape(target), unwrapResourceHandle(proxy)),
+            ], normalizeAssignedValue(value, proxy));
+            return true;
+        },
+    });
+    return proxy;
+}
+// ---------------------------------------------------------------------------
+// Resource handle detection
+// ---------------------------------------------------------------------------
+function isResourceHandle(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        value[RESOURCE_BRAND] === true);
+}
+export function unwrapResourceHandle(resource) {
+    const maybeRaw = Reflect.get(resource, RAW_RESOURCE_HANDLE);
+    if (maybeRaw === undefined) {
+        return resource;
+    }
+    return maybeRaw;
+}
+function throwLoopedElementWriteError() {
+    throw new Error("Cannot assign to a property of a looped resource declaration. Individual loop iterations cannot be mutated. Set the property in the declaration passed to `fromLoop(loop, ...)`");
+}
+export function createIndexedResourceProxy(resource, index) {
+    const resourceIndexExpression = isExpression(index)
+        ? unwrapExpression(index)
+        : index;
+    const root = unwrapResourceHandle(resource);
+    // A looped declaration (`LoopedResource`) exposes the concrete subclass
+    // ctor it wraps via `wrappedCtor`; its prototype carries the subclass's
+    // ARM accessors (`.sku`, `.properties.*`, `.id`, `.name`). The `get` trap
+    // below walks this prototype to resolve those reads rooted at
+    // `sym[index]`. A scalar `Resource` has no `wrappedCtor` — it already
+    // carries those accessors on its own prototype, so `subclassProto` stays
+    // `undefined` and lookups resolve via the target's own chain.
+    const subclassProto = resource.wrappedCtor?.prototype;
+    return new Proxy(resource, {
+        // Deliberately NO `getPrototypeOf` trap. Exposing the subclass
+        // prototype here would make `proxy instanceof Subclass` report `true`,
+        // invoking subclass getters/methods against the bare `LoopedResource`
+        // target (which lacks the subclass's own instance slots). Property
+        // reads and writes don't need it: the `get`/`set` traps below have
+        // their own `subclassProto` fallbacks that run accessors with
+        // `this = receiver` (the proxy) so `this.expr(...)` resolves against the
+        // indexed element.
+        get(target, property, receiver) {
+            // Reveal-only symbols consulted by the base `Resource` constructor
+            // and by serialization; both are marker keys with no runtime prototype
+            // representation on plain resources.
+            if (property === PROXY_INDEX_REF)
+                return resourceIndexExpression;
+            if (property === INDEXED_PROXY_TARGET)
+                return target;
+            // Intercept the single funnel for ARM reads. `this.expr(...path)` is
+            // the getter body used by every generated ARM property (`.name`,
+            // `.id`, `.properties.*`, etc.). Route it through
+            // `createResourceMemberProxy` with our `resourceIndexExpression` so
+            // the whole emitted expression roots at `sym[index]` instead of `sym`.
+            if (property === "expr") {
+                return function boundIndexedExpr(...path) {
+                    return createResourceMemberProxy({
+                        resource: target,
+                        root,
+                        index: resourceIndexExpression,
+                    }, path);
+                };
+            }
+            // Block ARM property writes on a looped element. Every generated ARM
+            // setter (`set sku`, `set properties`, `set name`, …) funnels through
+            // `this.setProperty(...)`, so intercepting that single method turns
+            // `parent.at(i).sku = ...` into a clear error.
+            if (property === "setProperty") {
+                return throwLoopedElementWriteError;
+            }
+            // First try the target's own chain. Two subtleties:
+            //
+            // 1. Getters (`.type`, `.apiVersion`, `.children`, `.parent`, …) must
+            //    run with `this = target` so they see the raw resource's own
+            //    properties — including class private fields (`#…`). Passing the
+            //    proxy as `receiver` would cause private-field access inside a
+            //    getter to fail because the proxy has no such slot.
+            // 2. Subclass methods need `this = target` for the same reason — private
+            //    fields again — so
+            //    we return a bound wrapper. This means `ctx.method === ctx.method`
+            //    yields `false` between reads; acceptable trade-off given no
+            //    caller relies on function identity on an indexed proxy.
+            if (property in target) {
+                const value = Reflect.get(target, property, target);
+                return typeof value === "function" ? value.bind(target) : value;
+            }
+            // Fall through to `subclassProto` for subclass-specific getters
+            // (e.g. `.id`, `.name`, `.sku`) when wrapping a `LoopedResource`.
+            // Getters must run with `this = receiver` (the proxy) so their
+            // `this.expr(...)` calls hit our intercept above, yielding an
+            // expression rooted at `sym[index]`. Methods bind to `target` to
+            // stay consistent with the passthrough branch above.
+            if (subclassProto !== undefined) {
+                let proto = subclassProto;
+                while (proto !== null && proto !== Object.prototype) {
+                    const descriptor = Object.getOwnPropertyDescriptor(proto, property);
+                    if (descriptor !== undefined) {
+                        if (descriptor.get !== undefined) {
+                            return descriptor.get.call(receiver);
+                        }
+                        const value = descriptor.value;
+                        return typeof value === "function" ? value.bind(target) : value;
+                    }
+                    proto = Object.getPrototypeOf(proto);
+                }
+            }
+            return undefined;
+        },
+        // Route writes to an ARM property setter with `this = receiver` (the
+        // proxy), allowing its `setProperty` call to hit the rejection above.
+        // Falls back to a plain write on the raw target.
+        set(target, property, value, receiver) {
+            if (subclassProto !== undefined) {
+                let proto = subclassProto;
+                while (proto !== null && proto !== Object.prototype) {
+                    const descriptor = Object.getOwnPropertyDescriptor(proto, property);
+                    if (descriptor !== undefined) {
+                        if (descriptor.set !== undefined) {
+                            descriptor.set.call(receiver, value);
+                            return true;
+                        }
+                        break;
+                    }
+                    proto = Object.getPrototypeOf(proto);
+                }
+            }
+            return Reflect.set(target, property, value, target);
+        },
+    });
+}
+//# sourceMappingURL=resource-proxy.js.map

package/dist/constructs/resource/resource-proxy.js.map

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

package/dist/constructs/resource/resource-query.d.ts

@@ -0,0 +1,23 @@
+import type { ProvisioningComponent } from "../provisioning-component.js";
+import type { LoopedResource, Resource } from "./resource.js";
+import type { ResourceCtor } from "./resource-registry.js";
+/** Options accepted by the `Stack` resource queries. */
+export interface QueryOptions {
+    /**
+     * Whether to walk the stack's entire subtree (default `true`) or only its
+     * **direct children** (`false`).
+     */
+    readonly recursive?: boolean;
+}
+/** Scalar (un-looped) resource declarations. */
+export declare function getResources(root: ProvisioningComponent, typeOrOptions?: ResourceCtor<Resource> | QueryOptions, maybeOptions?: QueryOptions): Resource[];
+/** Loop-expanded resource declarations (`Ctor.fromLoop(...)`). */
+export declare function getLoopedResources(root: ProvisioningComponent, typeOrOptions?: ResourceCtor<Resource> | QueryOptions, maybeOptions?: QueryOptions): LoopedResource<Resource>[];
+/**
+ * First scalar resource of `type` whose literal name equals `name`, or
+ * `undefined`. `deref` resolves the name's expression proxy to its literal
+ * (a `Resource`'s `name` is an `Expression`, so `r.name === name` is always
+ * false without it).
+ */
+export declare function getResource<T extends Resource>(root: ProvisioningComponent, type: ResourceCtor<T>, name: string, options?: QueryOptions): T | undefined;
+//# sourceMappingURL=resource-query.d.ts.map

package/dist/constructs/resource/resource-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-query.d.ts","sourceRoot":"","sources":["../../../src/constructs/resource/resource-query.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAM3D,wDAAwD;AACxD,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B;AAsCD,gDAAgD;AAChD,wBAAgB,YAAY,CAC1B,IAAI,EAAE,qBAAqB,EAC3B,aAAa,CAAC,EAAE,YAAY,CAAC,QAAQ,CAAC,GAAG,YAAY,EACrD,YAAY,CAAC,EAAE,YAAY,GAC1B,QAAQ,EAAE,CASZ;AAED,kEAAkE;AAClE,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,qBAAqB,EAC3B,aAAa,CAAC,EAAE,YAAY,CAAC,QAAQ,CAAC,GAAG,YAAY,EACrD,YAAY,CAAC,EAAE,YAAY,GAC1B,cAAc,CAAC,QAAQ,CAAC,EAAE,CAe5B;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,QAAQ,EAC5C,IAAI,EAAE,qBAAqB,EAC3B,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,EACrB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,YAAY,GACrB,CAAC,GAAG,SAAS,CAKf"}

package/dist/constructs/resource/resource-query.js

@@ -0,0 +1,71 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+import { isResourceDeclaration, isLoopedResource, isLoopedResourceOf, } from "./resource-utils.js";
+import { deref } from "./resource-proxy.js";
+// ---------------------------------------------------------------------------
+// Query engine (module-private)
+// ---------------------------------------------------------------------------
+// Imports only brand guards (`resource-utils`) — which do not import
+// `ProvisioningComponent`/`Stack` at runtime — plus types (type-only), so there is no
+// import cycle.
+/**
+ * Collect the resource declarations beneath `root` (the root itself is never
+ * included). `recursive` descends the whole subtree via `visit`; otherwise
+ * only `root`'s direct children are considered. `wantLooped` selects the
+ * looped declarations (`Ctor.fromLoop(...)`) vs. the scalar ones.
+ */
+function collectResourcesUnder(root, wantLooped, recursive) {
+    const result = [];
+    const consider = (node) => {
+        if (!isResourceDeclaration(node))
+            return;
+        const r = node.self;
+        if (isLoopedResource(r) === wantLooped)
+            result.push(r);
+    };
+    for (const child of root.children) {
+        if (recursive)
+            child.visit(consider);
+        else
+            consider(child);
+    }
+    return result;
+}
+// ---------------------------------------------------------------------------
+// Engine entry points — thin, loosely-typed; `Stack` supplies the public
+// typed overloads and delegates here.
+// ---------------------------------------------------------------------------
+/** Scalar (un-looped) resource declarations. */
+export function getResources(root, typeOrOptions, maybeOptions) {
+    const isCtor = typeof typeOrOptions === "function";
+    const type = isCtor ? typeOrOptions : undefined;
+    const options = (isCtor ? maybeOptions : typeOrOptions);
+    const recursive = options?.recursive ?? true;
+    const found = collectResourcesUnder(root, false, recursive);
+    return type === undefined ? found : found.filter((r) => r instanceof type);
+}
+/** Loop-expanded resource declarations (`Ctor.fromLoop(...)`). */
+export function getLoopedResources(root, typeOrOptions, maybeOptions) {
+    const isCtor = typeof typeOrOptions === "function";
+    const type = isCtor ? typeOrOptions : undefined;
+    const options = (isCtor ? maybeOptions : typeOrOptions);
+    const recursive = options?.recursive ?? true;
+    const found = collectResourcesUnder(root, true, recursive);
+    return type === undefined
+        ? found
+        : found.filter((r) => isLoopedResourceOf(r, type));
+}
+/**
+ * First scalar resource of `type` whose literal name equals `name`, or
+ * `undefined`. `deref` resolves the name's expression proxy to its literal
+ * (a `Resource`'s `name` is an `Expression`, so `r.name === name` is always
+ * false without it).
+ */
+export function getResource(root, type, name, options) {
+    for (const r of getResources(root, type, options)) {
+        if (deref(r.name) === name)
+            return r;
+    }
+    return undefined;
+}
+//# sourceMappingURL=resource-query.js.map

package/dist/constructs/resource/resource-query.js.map

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