@azure/provisioning-core 0.1.0-alpha.20261014.1

package/dist/constructs/resource/resource.js

@@ -0,0 +1,584 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+import { ProvisioningComponent } from "../provisioning-component.js";
+import { createBinaryExpression, unwrapExpression, wrapExpression, } from "../../expression/expressions.js";
+import { symbolicValueExpressionNode } from "../../expression/ast-nodes.js";
+import { namingRequiredPolicy, resolveResourceName, } from "../../naming/naming-policy.js";
+import { RAW_RESOURCE_HANDLE, RESOURCE_BRAND, RESOURCE_DECLARATION_BRAND, LOOPED_RESOURCE_BRAND, PROXY_INDEX_REF, INDEXED_PROXY_TARGET, STATE_PARENT_INDEX, createIndexedResourceProxy, createResourceMemberProxy, createResourceProxy, normalizeAssignedValue, unwrapResourceHandle, } from "./resource-proxy.js";
+import { isResourceDeclaration } from "./resource-utils.js";
+import { getShape, registerShape as registerShapeInRegistry, } from "../../shape/shape-registry.js";
+import { registerResource as registerResourceInRegistry, } from "./resource-registry.js";
+/**
+ * Shared base for resource declaration implementations.
+ *
+ * @remarks
+ *
+ * Both represent one Bicep resource declaration in the component tree and
+ * share the same declaration-level state layout: identity fields
+ * (`type`, `apiVersion`, `existing`), the `if(...)` guard (`condition`),
+ * the optional cross-scope reference (`scope`), and the raw prop bag that
+ * becomes the resource body.
+ *
+ * This class owns the common declaration state layout, raw-handle escape
+ * hatch, and identity accessors. Subclasses supply their construction and
+ * access behavior.
+ */
+export class ResourceDeclaration extends ProvisioningComponent {
+    /**
+     * Brand marker for cross-realm `isResourceDeclaration()` checks. Uses
+     * `Symbol.for` so it survives multiple copies of `@azure/provisioning-core`.
+     * Inherited by every resource declaration implementation.
+     */
+    [RESOURCE_DECLARATION_BRAND] = true;
+    // Not `readonly`: the ctor writes `this.state = data` once. TypeScript
+    // forbids subclass writes to a `readonly` parent field, so the
+    // immutability is a runtime contract (never reassigned after ctor)
+    // rather than a static one.
+    state;
+    /**
+     * Base constructor for every Bicep resource declaration.
+     *
+     * @remarks
+     *
+     * Responsibilities:
+     * 1. Register in the component tree (`super(context)`).
+     * 2. Enforce a deployment context ancestor.
+     * 3. Unwrap `context` if it's an indexed proxy from `.at(i)` /
+     *    `parent.at(loop.index)`, and stash `parentIndex` on `state` so the
+     *    serializer can emit `parent: parentSym[index]` on the child.
+     * 4. Inherit `condition` from the immediate parent resource
+     *    declaration when the caller doesn't supply one (Bicep requires
+     *    children of a conditional resource to share the same guard).
+     * 5. Populate `state` — existing arm records only identity fields;
+     *    deployable arm runs the naming policy and applies
+     *    `DeploymentContext` defaults for `location` / `tags` per the
+     *    shape descriptor.
+     *
+     * Subclasses supply the last mile, including their public handle behavior.
+     *
+     * @param namingRules - per-resource-type constraints for the naming
+     *   policy. `Resource` reads this reflectively off the concrete subclass
+     *   constructor; internal declaration implementations receive it from
+     *   the concrete resource constructor they represent.
+     */
+    constructor(context, props, options, namingRules) {
+        super(context);
+        if (!this.hasDeploymentContext()) {
+            throw new Error("Resource declaration must have a parent deployment context.");
+        }
+        // If `context` is an indexed proxy returned by
+        // `LoopedResource.at(i)`, unwrap `this.parent`
+        // back to the raw parent so tree walks and symbol-map lookups continue
+        // to work, and capture the index so the serializer can emit
+        // `parent: parentSym[index]` on this child. The `ProvisioningComponent` constructor
+        // already pushed `this` into the correct children array (indexed proxy
+        // passes `.children` through to the raw parent's array), so nothing to
+        // fix up there.
+        //
+        // The index is recorded on the child's state (not the parent's) because
+        // siblings can have different indices — `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 per-child.
+        const indexRef = context[PROXY_INDEX_REF];
+        let parentIndex = undefined;
+        if (indexRef !== undefined) {
+            const rawParent = context[INDEXED_PROXY_TARGET];
+            if (rawParent !== undefined) {
+                this.parent = rawParent;
+            }
+            parentIndex = indexRef;
+        }
+        // `existing` lives on `props` (it's the discriminant of the generated
+        // `{ existing?: false } | { existing: true }` union). `condition` is
+        // routed through `options`.
+        //
+        // Bicep requires a child of a conditional resource to itself be
+        // conditional on the same expression. When no explicit `condition` is
+        // supplied, inherit the immediate parent resource declaration's
+        // condition so the emitted template stays valid — child authoring
+        // shouldn't have to redundantly restate the parent's guard.
+        const isExisting = props.existing === true;
+        const parent = this.parent;
+        const inheritedCondition = isResourceDeclaration(parent)
+            ? parent.self.state["condition"]
+            : undefined;
+        const explicitCondition = options?.condition;
+        const condition = explicitCondition !== undefined && inheritedCondition !== undefined
+            ? createBinaryExpression("&&", inheritedCondition, explicitCondition)
+            : (explicitCondition ??
+                inheritedCondition);
+        const dependsOn = options?.dependsOn;
+        let data;
+        if (isExisting) {
+            // Existing arm: only name + optional scope land in state. Any other
+            // keys on the props object are ignored — the deserialize path may pass
+            // them through, but they're never emitted on an `existing` resource.
+            if (props.name === undefined) {
+                throw new Error(`Resource ${props.type} marked as 'existing' but no 'name' was provided.`);
+            }
+            data = {
+                name: props.name,
+                type: props.type,
+                apiVersion: props.apiVersion,
+                existing: true,
+                scope: props.scope === undefined ? undefined : unwrapExpression(props.scope),
+                condition,
+                dependsOn,
+            };
+            if (parentIndex !== undefined) {
+                data[STATE_PARENT_INDEX] = parentIndex;
+            }
+        }
+        else {
+            // Deployable arm: name flows through the naming policy; the keys
+            // handled explicitly here are stripped from the props bag, and
+            // every remaining key is copied verbatim into state as a user-
+            // authored property.
+            const { name: _name, type: _type, apiVersion: _apiVersion, existing: _existing, scope: _scope, ...userProps } = props;
+            const ctx = this.deploymentContext;
+            data = {
+                name: resolveResourceName(ctx.namingPolicy ?? namingRequiredPolicy, props.name, props.type, namingRules),
+                type: props.type,
+                apiVersion: props.apiVersion,
+                condition,
+                dependsOn,
+                ...userProps,
+            };
+            if (parentIndex !== undefined) {
+                data[STATE_PARENT_INDEX] = parentIndex;
+            }
+            // Apply DeploymentContext defaults for `location` and `tags`, gated
+            // on the shape descriptor declaring those properties as writable.
+            // The TypeSpec model is the source of truth: a field marked
+            // readonly in the ARM contract (e.g. `location` on most child
+            // resources) is server-set, so propagating an inherited value
+            // would produce an invalid PUT body. Both fields are user-wins:
+            // if the user supplied a value, the inherited value is ignored
+            // entirely (no merge for tags either — explicit user tags fully
+            // replace inherited tags).
+            const shape = getShape(props.type, props.apiVersion, data);
+            if (shape !== undefined) {
+                const locationShape = shape.byJsName["location"];
+                if (locationShape !== undefined &&
+                    locationShape.readOnly !== true &&
+                    data["location"] === undefined &&
+                    ctx.location !== undefined) {
+                    data["location"] = ctx.location;
+                }
+                const tagsShape = shape.byJsName["tags"];
+                if (tagsShape !== undefined &&
+                    tagsShape.readOnly !== true &&
+                    data["tags"] === undefined &&
+                    ctx.tags !== undefined &&
+                    Object.keys(ctx.tags).length > 0) {
+                    data["tags"] = { ...ctx.tags };
+                }
+            }
+        }
+        this.state = data;
+    }
+    /**
+     * Core-internal escape hatch: exposes the raw `state` backing object to
+     * the proxy layer (`resource-proxy.ts`) so it can read/unwrap the
+     * declaration's data across module boundaries. Keyed by the
+     * module-scoped {@link RAW_RESOURCE_HANDLE} symbol, which is **not**
+     * exported from `@azure/provisioning-core`, so package consumers can't name it.
+     *
+     * `protected` (not `private`) because the accessors that read it use
+     * `Reflect.get` / structural casts that bypass TS visibility anyway;
+     * the modifier just keeps it off the public type surface. It can't be a
+     * `#private` field because the proxy layer lives in a different class.
+     *
+     * @internal
+     */
+    get [RAW_RESOURCE_HANDLE]() {
+        return this.state;
+    }
+    get type() {
+        return this.state.type;
+    }
+    get apiVersion() {
+        return this.state.apiVersion;
+    }
+    get existing() {
+        return this.state.existing;
+    }
+    get condition() {
+        return this.state.condition;
+    }
+    get dependsOn() {
+        return this.state.dependsOn;
+    }
+    expr(...path) {
+        return createResourceMemberProxy({
+            resource: this,
+            root: unwrapResourceHandle(this),
+        }, path);
+    }
+    setProperty(key, value) {
+        this.state[key] = normalizeAssignedValue(value, this);
+    }
+}
+/**
+ * Base class for all Azure resources.
+ *
+ * @remarks
+ * Resources are fully initialized at construction time. Pass a parent
+ * `ProvisioningComponent` (typically a `Stack` or `ResourceGroup`) as the first
+ * argument — the resource registers itself in the tree automatically.
+ *
+ * Properties use expression-backed proxies: reading `resource.name`
+ * returns an `Expression` that compiles to a Bicep symbolic reference,
+ * not a plain string. Use `this.expr()` in subclasses to create
+ * property getters and `this.setProperty()` for setters.
+ *
+ * @example
+ * ```typescript
+ * import { ResourceGroup, Stack } from "@azure/provisioning-core";
+ * import { KeyVault } from "@azure/provisioning-keyvault";
+ *
+ * const stack = new Stack("my-app", { targetScope: "subscription" });
+ * const rg = new ResourceGroup(stack, { name: "rg-my-app", location: "eastus" });
+ * const vault = new KeyVault(rg, {
+ *   name: "kv-my-app",
+ *   properties: {
+ *     tenantId: "11111111-1111-1111-1111-111111111111",
+ *     sku: { family: "A", name: "standard" },
+ *   },
+ * });
+ *
+ * // vault.name is an Expression, not a string
+ * // vault.id compiles to resourceId(...)
+ * ```
+ */
+export class Resource extends ResourceDeclaration {
+    /**
+     * Brand marker for cross-realm `isResource()` checks.
+     * Uses `Symbol.for` so it survives multiple copies of `@azure/provisioning-core`.
+     */
+    [RESOURCE_BRAND] = true;
+    /**
+     * Register a {@link FlatModelShape} for this resource class's
+     * `(resourceType, apiVersion)` pair. Intended to be invoked from a
+     * `static {}` initializer in generated subclasses so the registration
+     * happens at module load.
+     *
+     * The static method reads `resourceType` and `apiVersion` off `this`
+     * (the subclass that called it), so callers don't repeat the literals.
+     */
+    static registerShape(shape, variantSelector) {
+        registerShapeInRegistry(this.resourceType, this.apiVersion, shape, variantSelector);
+    }
+    /**
+     * Register this class with the global resource registry so the
+     * deserializer can reconstruct instances of it (instead of falling
+     * back to base `Resource`) for matching `(resourceType, apiVersion)`
+     * pairs. Intended to be invoked from a `static {}` initializer in
+     * generated classes alongside {@link Resource.registerShape}.
+     *
+     * Pass an ordered discriminator path for concrete resource variants. A
+     * singleton is one segment (`name=signin`); model-discriminated resources
+     * may use `kind` or several nested segments. Omit for ordinary resources.
+     */
+    static register(variantSelector) {
+        registerResourceInRegistry(this, variantSelector);
+    }
+    /**
+     * Assemble the base-`Resource` constructor payload (the second `super(...)`
+     * argument) from the user-facing props. This is a **static "virtual"**:
+     * it runs before an instance exists (to compute the `super` argument), so
+     * it can't be an instance method — but it still dispatches through the
+     * calling constructor, so a subclass's override wins.
+     *
+     * Every emitter-generated resource overrides this to inject its fixed
+     * identity (`type` / `apiVersion`), the singleton `name`, and its explicit
+     * writable-field copy. Both ordinary construction and internal resource
+     * reconstruction funnel through this method so prop shaping remains
+     * consistent.
+     *
+     * This base default is the fallback used when the wrapped constructor is
+     * base `Resource` itself — the deserialize path for an unregistered
+     * `(type, apiVersion)` pair, where `type` / `apiVersion` are threaded in
+     * through `props` rather than read off statics. Keeping the default here
+     * guarantees the method is always present for internal reconstruction.
+     */
+    static buildResourceProps(props) {
+        const p = props ?? {};
+        return {
+            ...p,
+            type: p["type"] ??
+                this.resourceType,
+            apiVersion: p["apiVersion"] ??
+                this.apiVersion,
+        };
+    }
+    /**
+     * Per-resource-type naming constraints, consumed by the active
+     * {@link NamingPolicy} when a resource is created without an explicit
+     * `name`. Generated CDK subclasses override this with a concrete value;
+     * the base default of `undefined` yields `MOST_RESTRICTIVE` behavior.
+     *
+     * This is type metadata, not user input, so it is kept off the public
+     * props surface and read reflectively in the constructor via
+     * `this.constructor` rather than being threaded through `ResourceProps`.
+     */
+    static namingRules;
+    _selfProxy;
+    constructor(context, props, options) {
+        super(context, props, options, 
+        // Naming rules live as a `protected static namingRules` field on
+        // each concrete resource subclass, not on the public props bag.
+        // Read reflectively off `new.target` (the most-derived class being
+        // instantiated) — `this.constructor` would work too but TS forbids
+        // touching `this` before `super()`. Static inheritance falls back
+        // to `Resource`'s `undefined` default when a subclass omits the
+        // field (e.g. singleton children). `resolveResourceName` (called
+        // inside `ResourceDeclaration`) treats `undefined` as
+        // `MOST_RESTRICTIVE`.
+        new.target.namingRules);
+        const proxy = createResourceProxy(this);
+        this._selfProxy = proxy;
+        // Tricky part for the proxy implementation:
+        // ProvisioningComponent constructor pushed `this` (bare instance) into parent.children
+        // before the proxy existed. Swap it for the proxy so external consumers
+        // see proxy-backed handles (with property access, etc.) when iterating.
+        const idx = context.children.indexOf(this);
+        if (idx >= 0)
+            context.children[idx] = proxy;
+        return proxy;
+    }
+    get self() {
+        return this._selfProxy ?? this;
+    }
+    /**
+     * The Azure resource name as a Bicep symbolic-reference expression.
+     *
+     * The value is established at construction time (either user-supplied
+     * via `props.name` or filled in by the naming policy) and stored on
+     * `state.name`. The setter routes through `setProperty` so post-
+     * construction edits flow through the same proxy/expression machinery
+     * as any other property — useful when working with a base `Resource`
+     * reference and re-binding the name dynamically. Singleton subclasses
+     * override this getter to narrow the return type to the literal
+     * `Expression<"<singletonName>">`; non-singleton subclasses inherit
+     * this accessor pair as-is.
+     */
+    get name() {
+        return this.expr("name");
+    }
+    set name(value) {
+        this.setProperty("name", value);
+    }
+    get id() {
+        return this.expr("id");
+    }
+}
+/**
+ * Describes a Bicep `[for item in collection: ...]` loop as a plain data
+ * object. Construct one and pass it to
+ * `Ctor.fromLoop(loop, context, props, options?)` (e.g.
+ * `StorageAccount.fromLoop(...)`) to expand a resource declaration into a
+ * resource-copy loop.
+ *
+ * The item and index variable names default to `item` / `i`. Bicep
+ * for-expressions bind their loop variables only within their own body,
+ * so two sibling `[for item in xs: …]` / `[for item in ys: …]` in the
+ * same file do **not** collide — each `item` is scoped to its own
+ * expression. If you nest a `Loop` inside another loop's body (rare),
+ * pass `{ itemVariable, indexVariable }` explicitly on the inner one to
+ * disambiguate. `batchSize` on the loop renders as `@batchSize(n)` on
+ * the resource that consumes it.
+ *
+ * The `indexVariable` name is always materialized on read (never
+ * `undefined`), but whether the wire actually **records** it — and
+ * therefore whether the renderer emits the `[for (item, i) in …]` tuple
+ * binding — is decided by whether anyone accessed `loop.index` (or the
+ * caller supplied `{ indexVariable }` explicitly). A loop whose body
+ * never mentions an index emits a bare `[for item in xs: …]`.
+ *
+ * `Loop` instances are pure data — creating one has no side effect.
+ */
+export class Loop {
+    collection;
+    itemVariable;
+    item;
+    batchSize;
+    // The default name assigned to `indexVariable` on first materialization,
+    // if the caller neither passed `{ indexVariable }` nor accessed `.index`.
+    #defaultIndexVariable;
+    #indexVariable;
+    #indexExpr;
+    #indexRequested = false;
+    constructor(collection, options) {
+        this.collection = collection;
+        this.itemVariable = options?.itemVariable ?? "item";
+        this.#defaultIndexVariable = "i";
+        if (options?.indexVariable !== undefined) {
+            // Explicit option counts as a request — the wire and renderer must
+            // honor the caller's chosen name whether or not they read `.index`.
+            this.#indexVariable = options.indexVariable;
+            this.#indexRequested = true;
+        }
+        if (options?.batchSize !== undefined) {
+            this.batchSize = options.batchSize;
+        }
+        this.item = wrapExpression(symbolicValueExpressionNode(this.itemVariable));
+    }
+    /**
+     * Name of the loop's index variable. Always defined — reading it
+     * materializes the default (`i`) if the caller neither passed
+     * `{ indexVariable }` nor accessed `.index` yet.
+     *
+     * Reading `.indexVariable` also marks the index as requested (same as
+     * reading `.index`), because a caller who wants the variable name is
+     * almost certainly going to use it. If the wire-omit optimization
+     * (bare `[for item in …]` with no index binding) matters, callers
+     * should gate on `.indexRequested` first before touching this getter.
+     */
+    get indexVariable() {
+        this.#indexRequested = true;
+        if (this.#indexVariable === undefined) {
+            this.#indexVariable = this.#defaultIndexVariable;
+        }
+        return this.#indexVariable;
+    }
+    /**
+     * Expression referencing the current iteration's index. Reading this the
+     * first time marks the index as requested, which causes the wire to
+     * include `indexVariable` on the `for-expression` node and the renderer
+     * to emit `[for (item, i) in …]`. Callers who never touch `.index` get
+     * the cleaner index-less form.
+     */
+    get index() {
+        this.#indexRequested = true;
+        if (this.#indexExpr === undefined) {
+            const name = this.indexVariable;
+            this.#indexExpr = wrapExpression(symbolicValueExpressionNode(name));
+        }
+        return this.#indexExpr;
+    }
+    /**
+     * Framework-internal signal used by `Resource.fromLoop` to decide
+     * whether the wire should include the index binding. `true` when the
+     * caller either supplied `{ indexVariable }` explicitly or has accessed
+     * `.index` / `.indexVariable` at least once. Not exported from
+     * `@azure/provisioning-core`.
+     *
+     * @internal
+     */
+    get indexRequested() {
+        return this.#indexRequested;
+    }
+}
+// ---------------------------------------------------------------------------
+// LoopedResource<T> — a Bicep for-expanded resource declaration as a real
+// ProvisioningComponent in the tree, sitting alongside scalar `Resource` under the same
+// `ResourceDeclaration` base.
+// ---------------------------------------------------------------------------
+/**
+ * A `LoopedResource<T>` represents a single Bicep resource declaration
+ * expanded across a loop (`[for x in xs: {...}]`). It is a real
+ * `ProvisioningComponent` in the tree — one node per emitted declaration — and
+ * exposes indexed access into individual iterations via
+ * {@link LoopedResource.at}.
+ *
+ * @remarks
+ *
+ * Property access on a `LoopedResource` is deliberately not exposed at
+ * the type level: pick an index (`at`) to obtain a proxy that emits
+ * `sym[i].prop`. This mirrors Bicep's requirement that individual
+ * iterations be accessed by index.
+ *
+ * `.at(i)` returns the concrete resource type `T`. The returned proxy
+ * exposes the essential ARM surface — the property getters/setters that
+ * funnel through `this.expr(...)` (`.id`, `.name`, `.sku`,
+ * `.properties.*`, …) rooted at `sym[i]` — as well as the child
+ * accessors (`keyVault.secrets`, singleton getter/setters), which are
+ * derived from the parent's `children` scoped to element `i`. To attach
+ * per-iteration children, parent them to `parent.at(loop.index)` — e.g.
+ * `Child.fromLoop(loop, parent.at(loop.index), ...)`.
+ *
+ * Projection over the loop (Bicep `map(sym, x => body)`) is tracked as
+ * a follow-up effort — see the "lambda + fn.map" issue.
+ */
+export class LoopedResource extends ResourceDeclaration {
+    /**
+     * Cross-realm brand — same technique as the scalar `RESOURCE_BRAND`.
+     * Use {@link isLoopedResource} instead of `instanceof`
+     * when multiple copies of `@azure/provisioning-core` may be loaded.
+     */
+    [LOOPED_RESOURCE_BRAND] = true;
+    /** Metadata describing the loop that produced this declaration. */
+    loop;
+    #wrappedCtor;
+    constructor(context, wrappedCtor, userProps, loop, options) {
+        // The subclass constructor never runs for a looped row — only this
+        // shared `ResourceDeclaration` ctor does. To keep the scalar and
+        // looped construction paths from drifting, shape the props bag through
+        // the SAME static the scalar ctor uses: every `Resource` (sub)class
+        // inherits or overrides `buildResourceProps`, which returns the exact
+        // `super()` payload the scalar ctor passes — including the fixed `name`
+        // for singletons and any other prop shaping. (This is what fixes looped
+        // singletons losing their fixed `name`.)
+        //
+        // It is always present: base `Resource` — the deserialize fallback ctor
+        // for an unregistered `(type, apiVersion)` pair — supplies a default
+        // that threads `type` / `apiVersion` in from `userProps`. So there's no
+        // existence branch here.
+        const props = wrappedCtor.buildResourceProps.call(wrappedCtor, userProps);
+        super(context, props, options, wrappedCtor
+            .namingRules);
+        this.#wrappedCtor = wrappedCtor;
+        // Snapshot the loop metadata at declaration time. `indexVariable` is
+        // recorded only if the index was requested by now — either the caller
+        // supplied `{ indexVariable }` or read `loop.index` / `loop.indexVariable`
+        // before this declaration. Reading `loop.index` (e.g. via
+        // `parent.at(loop.index)`) marks the live loop so descendant
+        // declarations (which snapshot the same loop afterwards) pick up the
+        // binding, while this declaration's own for-expression stays index-less.
+        this.loop = {
+            collection: loop.collection,
+            itemVariable: loop.itemVariable,
+            ...(loop.indexRequested ? { indexVariable: loop.indexVariable } : {}),
+            ...(loop.batchSize !== undefined ? { batchSize: loop.batchSize } : {}),
+        };
+    }
+    /**
+     * The concrete `Resource` subclass this looped declaration wraps.
+     * Used by query machinery to answer "which subclass is this looped
+     * resource" — the analogue of `instanceof T` for `LoopedResource<T>`.
+     *
+     * This is always the full subclass the user constructed via
+     * `Xxx.fromLoop(...)` — query identity matches on that class, and it is
+     * the prototype the `.at(i)` proxy uses to resolve ARM accessors.
+     */
+    get wrappedCtor() {
+        return this.#wrappedCtor;
+    }
+    /**
+     * Reference the element at `index`. Emits `sym[index].<...>` for
+     * subsequent property access.
+     *
+     * Returns the concrete resource type `T`. At runtime an indexed proxy is
+     * spliced over the full class prototype (`#wrappedCtor.prototype`):
+     * prototype getters that funnel through `this.expr(...)` (`.id`, `.name`,
+     * `.properties.*`, …) resolve rooted at `sym[index]`. A child created with
+     * `parent.at(i)` is stamped with that index for serialization.
+     */
+    at(index) {
+        // `this` is a `ResourceDeclaration`; the handle derives the subclass
+        // prototype from `this.wrappedCtor`. The explicit type argument pins
+        // the return type, which TypeScript can't otherwise resolve from the
+        // deferred polymorphic `this`.
+        return createIndexedResourceProxy(this, index);
+    }
+}
+/** @internal */
+export function createLoopedResource(wrappedCtor, loop, context, ...rest) {
+    const [userProps, options] = rest;
+    // `LoopedResource`'s ctor is private; access via cast because this module
+    // owns both the declaration and its internal construction boundary.
+    const LoopedCtor = LoopedResource;
+    return new LoopedCtor(context, wrappedCtor, userProps, loop, options);
+}
+//# sourceMappingURL=resource.js.map

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

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