alchemy 2.0.0-beta.30 → 2.0.0-beta.32

package/lib/AWS/ApiGateway/Deployment.js

@@ -0,0 +1,237 @@
+import * as ag from "@distilled.cloud/aws/api-gateway";
+import * as Effect from "effect/Effect";
+import { createHash } from "node:crypto";
+import { deepEqual, isResolved } from "../../Diff.js";
+import * as Output from "../../Output.js";
+import * as Provider from "../../Provider.js";
+import { Resource } from "../../Resource.js";
+import { Stack } from "../../Stack.js";
+import { retryOnApiStatusUpdating } from "./common.js";
+/**
+ * A point-in-time snapshot of a REST API, ready to be served through a
+ * `Stage`.
+ *
+ * @section Creating a deployment
+ * A Deployment captures whatever methods, integrations, resources, and
+ * authorizers currently exist on the REST API and produces an immutable
+ * `deploymentId` that a `Stage` can point at. Pass the `RestApi` value on
+ * `restApi` and Alchemy handles all the ordering for you — the deployment
+ * will run after every method bound to the API.
+ *
+ * @example Deployment of a REST API
+ * ```typescript
+ * const api = yield* ApiGateway.RestApi("Api", {
+ *   endpointConfiguration: { types: ["REGIONAL"] },
+ * });
+ *
+ * yield* ApiGateway.Method("GetRoot", {
+ *   restApi: api,
+ *   httpMethod: "GET",
+ *   authorizationType: "NONE",
+ *   integration: { type: "MOCK" },
+ * });
+ *
+ * const deployment = yield* ApiGateway.Deployment("Release", {
+ *   restApi: api,
+ *   description: "v1",
+ * });
+ * ```
+ *
+ * @section Forcing a redeploy
+ * Usually you do not have to: `restApi` already makes the Deployment
+ * depend on every method, so any change to a method re-plans a new
+ * deployment. Use `triggers` when you want to couple the deployment to a
+ * signal Alchemy cannot see — for example, a manual version bump or a
+ * hash of configuration computed outside the stack.
+ *
+ * @example Force redeploy on a version bump
+ * ```typescript
+ * const deployment = yield* ApiGateway.Deployment("Release", {
+ *   restApi: api,
+ *   triggers: { version: "2026-05-01" },
+ * });
+ * ```
+ *
+ * @section Why no DependsOn?
+ * CloudFormation's `AWS::ApiGateway::Deployment` famously requires a
+ * hand-written `DependsOn: [Method1, Method2, ...]` listing every method.
+ * Alchemy derives that list automatically from the bindings registered on
+ * the `RestApi`, so adding a method never requires editing the deployment.
+ */
+export const DeploymentResource = Resource("AWS.ApiGateway.Deployment");
+/**
+ * User-facing wrapper that adds a dependency edge from the Deployment to
+ * every resource bound to the supplied `restApi`. Implementation detail:
+ * each binding's output references get copied into the deployment's
+ * `triggers` map so `resolveUpstream` sees them as real upstream dependencies.
+ */
+export const Deployment = (id, props) => Effect.gen(function* () {
+    const { restApi, ...rest } = props;
+    const restApiId = rest.restApiId ?? restApi?.restApiId;
+    if (!restApiId) {
+        return yield* Effect.die("Deployment requires either `restApi` (preferred) or explicit " +
+            "`restApiId`.");
+    }
+    let triggers = rest.triggers;
+    if (restApi) {
+        const stack = yield* Stack;
+        const bindings = stack.bindings[restApi.FQN] ?? [];
+        const autoTriggers = {};
+        for (const b of bindings) {
+            autoTriggers[`@alchemy:binding:${b.sid}`] = bindingDigest(b.data);
+        }
+        triggers = { ...autoTriggers, ...(triggers ?? {}) };
+    }
+    return yield* DeploymentResource(id, {
+        ...rest,
+        restApiId,
+        triggers,
+    });
+});
+/**
+ * Serializes a binding payload down to a deterministic `Input<string>` so
+ * it can ride along as a trigger value. The inner `Output.all` is what
+ * surfaces the underlying resource FQNs to the dependency resolver.
+ */
+const bindingDigest = (data) => {
+    const entries = Object.entries(data).filter(([k]) => k !== "kind");
+    const values = entries.map(([, v]) => Output.asOutput(v));
+    return Output.map(Output.all(...values), (parts) => [data.kind, ...parts.map(String)].join("|"));
+};
+const embedTriggers = (description, triggers) => Effect.gen(function* () {
+    if (!triggers || Object.keys(triggers).length === 0) {
+        return description;
+    }
+    const fp = yield* Effect.sync(() => createHash("sha256")
+        .update(JSON.stringify(triggers))
+        .digest("hex")
+        .slice(0, 24));
+    const suffix = `@alchemy:triggers:${fp}`;
+    return description ? `${description}\n${suffix}` : suffix;
+});
+export const DeploymentProvider = () => Provider.effect(DeploymentResource, Effect.gen(function* () {
+    return {
+        stables: ["deploymentId", "restApiId"],
+        diff: Effect.fn(function* ({ news: newsIn, olds }) {
+            if (!isResolved(newsIn))
+                return;
+            const news = newsIn;
+            const oldsP = olds;
+            if (news.restApiId !== oldsP.restApiId) {
+                return { action: "replace" };
+            }
+            if (!deepEqual(news.triggers, oldsP.triggers)) {
+                return { action: "replace" };
+            }
+            if (news.stageName !== oldsP.stageName ||
+                news.stageDescription !== oldsP.stageDescription ||
+                news.cacheClusterEnabled !== oldsP.cacheClusterEnabled ||
+                news.cacheClusterSize !== oldsP.cacheClusterSize ||
+                !deepEqual(news.variables, oldsP.variables) ||
+                !deepEqual(news.canarySettings, oldsP.canarySettings) ||
+                news.tracingEnabled !== oldsP.tracingEnabled) {
+                return { action: "replace" };
+            }
+            if (news.description !== oldsP.description) {
+                return { action: "update" };
+            }
+        }),
+        read: Effect.fn(function* ({ output }) {
+            if (!output?.deploymentId)
+                return undefined;
+            const d = yield* ag
+                .getDeployment({
+                restApiId: output.restApiId,
+                deploymentId: output.deploymentId,
+            })
+                .pipe(Effect.catchTag("NotFoundException", () => Effect.succeed(undefined)));
+            if (!d?.id)
+                return undefined;
+            return {
+                deploymentId: d.id,
+                restApiId: output.restApiId,
+                description: d.description,
+            };
+        }),
+        reconcile: Effect.fn(function* ({ news: newsIn, output, session }) {
+            if (!isResolved(newsIn)) {
+                return yield* Effect.die("Deployment props were not resolved");
+            }
+            const news = newsIn;
+            const description = yield* embedTriggers(news.description, news.triggers);
+            const restApiId = (output?.restApiId ?? news.restApiId);
+            // Observe — fetch the live deployment if we have a cached id.
+            // A Deployment is immutable apart from `description`, so we never
+            // trust a stale `output.description` for diffing.
+            let observed = output?.deploymentId
+                ? yield* ag
+                    .getDeployment({
+                    restApiId,
+                    deploymentId: output.deploymentId,
+                })
+                    .pipe(Effect.catchTag("NotFoundException", () => Effect.succeed(undefined)))
+                : undefined;
+            // Ensure — create a new deployment if there isn't one yet.
+            // `createDeployment` always produces a fresh deploymentId, so we
+            // only call it when missing; any change that should produce a new
+            // deployment is modeled as `replace` in `diff`.
+            if (!observed?.id) {
+                const created = yield* retryOnApiStatusUpdating(ag.createDeployment({
+                    restApiId: news.restApiId,
+                    stageName: news.stageName,
+                    stageDescription: news.stageDescription,
+                    description,
+                    cacheClusterEnabled: news.cacheClusterEnabled,
+                    cacheClusterSize: news.cacheClusterSize,
+                    variables: news.variables,
+                    canarySettings: news.canarySettings,
+                    tracingEnabled: news.tracingEnabled,
+                }));
+                if (!created.id)
+                    return yield* Effect.die("createDeployment missing id");
+                yield* session.note(`Created deployment ${created.id}`);
+                observed = yield* ag.getDeployment({
+                    restApiId: news.restApiId,
+                    deploymentId: created.id,
+                });
+            }
+            const deploymentId = observed.id;
+            // Sync description — observed ↔ desired.
+            if (description !== observed.description) {
+                yield* retryOnApiStatusUpdating(ag.updateDeployment({
+                    restApiId,
+                    deploymentId,
+                    patchOperations: description
+                        ? [
+                            {
+                                op: "replace",
+                                path: "/description",
+                                value: description,
+                            },
+                        ]
+                        : [{ op: "remove", path: "/description" }],
+                }));
+            }
+            yield* session.note(`Reconciled deployment ${deploymentId}`);
+            const final = yield* ag.getDeployment({
+                restApiId,
+                deploymentId,
+            });
+            return {
+                deploymentId,
+                restApiId,
+                description: final?.description,
+            };
+        }),
+        delete: Effect.fn(function* ({ output, session }) {
+            yield* retryOnApiStatusUpdating(ag
+                .deleteDeployment({
+                restApiId: output.restApiId,
+                deploymentId: output.deploymentId,
+            })
+                .pipe(Effect.catchTag("NotFoundException", () => Effect.void)));
+            yield* session.note(`Deleted deployment ${output.deploymentId}`);
+        }),
+    };
+}));
+//# sourceMappingURL=Deployment.js.map

package/lib/AWS/ApiGateway/Deployment.js.map

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

package/lib/AWS/ApiGateway/DomainName.d.ts

@@ -0,0 +1,50 @@
+import * as ag from "@distilled.cloud/aws/api-gateway";
+import * as Provider from "../../Provider.ts";
+import { Resource } from "../../Resource.ts";
+import type { Providers } from "../Providers.ts";
+export interface DomainNameProps {
+    domainName: string;
+    certificateName?: string;
+    certificateBody?: string;
+    certificatePrivateKey?: string;
+    certificateChain?: string;
+    certificateArn?: string;
+    regionalCertificateName?: string;
+    regionalCertificateArn?: string;
+    endpointConfiguration?: ag.EndpointConfiguration;
+    securityPolicy?: ag.SecurityPolicy;
+    endpointAccessMode?: ag.EndpointAccessMode;
+    mutualTlsAuthentication?: ag.MutualTlsAuthenticationInput;
+    ownershipVerificationCertificateArn?: string;
+    policy?: string;
+    routingMode?: ag.RoutingMode;
+    tags?: Record<string, string>;
+}
+export interface DomainName extends Resource<"AWS.ApiGateway.DomainName", DomainNameProps, {
+    domainName: string;
+    regionalDomainName: string | undefined;
+    regionalHostedZoneId: string | undefined;
+    distributionDomainName: string | undefined;
+    distributionHostedZoneId: string | undefined;
+    domainNameArn: string | undefined;
+    tags: Record<string, string>;
+}, never, Providers> {
+}
+/**
+ * Custom domain name for an Amazon API Gateway REST API.
+ *
+ * @section Custom domain
+ * @example Regional custom domain
+ * ```typescript
+ * const domain = yield* ApiGateway.DomainName("ApiDomain", {
+ *   domainName: "api.example.com",
+ *   regionalCertificateArn: cert.certificateArn,
+ *   endpointConfiguration: { types: ["REGIONAL"] },
+ *   securityPolicy: "TLS_1_2",
+ * });
+ * ```
+ */
+declare const DomainNameResource: import("../../Resource.ts").ResourceClass<DomainName>;
+export { DomainNameResource as DomainName };
+export declare const DomainNameProvider: () => import("effect/Layer").Layer<Provider.Provider<DomainName>, never, import("effect/unstable/http/HttpClient").HttpClient | import("../../Stage.ts").Stage | import("../../Stack.ts").Stack | import("@distilled.cloud/aws/Region").Region | import("@distilled.cloud/aws/Credentials").Credentials>;
+//# sourceMappingURL=DomainName.d.ts.map

package/lib/AWS/ApiGateway/DomainName.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DomainName.d.ts","sourceRoot":"","sources":["../../../src/AWS/ApiGateway/DomainName.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,kCAAkC,CAAC;AAIvD,OAAO,KAAK,QAAQ,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAKjD,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,qBAAqB,CAAC,EAAE,EAAE,CAAC,qBAAqB,CAAC;IACjD,cAAc,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC;IACnC,kBAAkB,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC;IAC3C,uBAAuB,CAAC,EAAE,EAAE,CAAC,4BAA4B,CAAC;IAC1D,mCAAmC,CAAC,EAAE,MAAM,CAAC;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,UAAW,SAAQ,QAAQ,CAC1C,2BAA2B,EAC3B,eAAe,EACf;IACE,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,oBAAoB,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,sBAAsB,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3C,wBAAwB,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7C,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B,EACD,KAAK,EACL,SAAS,CACV;CAAG;AAEJ;;;;;;;;;;;;;GAaG;AACH,QAAA,MAAM,kBAAkB,uDAAoD,CAAC;AAE7E,OAAO,EAAE,kBAAkB,IAAI,UAAU,EAAE,CAAC;AAS5C,eAAO,MAAM,kBAAkB,0SA+L5B,CAAC"}

package/lib/AWS/ApiGateway/DomainName.js

@@ -0,0 +1,194 @@
+import * as ag from "@distilled.cloud/aws/api-gateway";
+import * as Effect from "effect/Effect";
+import * as Schedule from "effect/Schedule";
+import { deepEqual, isResolved } from "../../Diff.js";
+import * as Provider from "../../Provider.js";
+import { Resource } from "../../Resource.js";
+import { createInternalTags, tagRecord } from "../../Tags.js";
+import { syncTags } from "./common.js";
+/**
+ * Custom domain name for an Amazon API Gateway REST API.
+ *
+ * @section Custom domain
+ * @example Regional custom domain
+ * ```typescript
+ * const domain = yield* ApiGateway.DomainName("ApiDomain", {
+ *   domainName: "api.example.com",
+ *   regionalCertificateArn: cert.certificateArn,
+ *   endpointConfiguration: { types: ["REGIONAL"] },
+ *   securityPolicy: "TLS_1_2",
+ * });
+ * ```
+ */
+const DomainNameResource = Resource("AWS.ApiGateway.DomainName");
+export { DomainNameResource as DomainName };
+const retryDomainNameMutation = Effect.retry({
+    while: (e) => e._tag === "ConflictException" || e._tag === "TooManyRequestsException",
+    schedule: Schedule.spaced("1 second"),
+    times: 8,
+});
+export const DomainNameProvider = () => Provider.effect(DomainNameResource, Effect.gen(function* () {
+    return {
+        stables: ["domainName"],
+        diff: Effect.fn(function* ({ news: newsIn, olds }) {
+            if (!isResolved(newsIn))
+                return;
+            const news = newsIn;
+            if (news.domainName !== olds.domainName) {
+                return { action: "replace" };
+            }
+            if (!deepEqual(news.endpointConfiguration, olds.endpointConfiguration)) {
+                return { action: "replace" };
+            }
+            if (news.endpointAccessMode !== olds.endpointAccessMode) {
+                return { action: "replace" };
+            }
+            if (news.certificateBody !== olds.certificateBody) {
+                return { action: "replace" };
+            }
+            if (news.certificatePrivateKey !== olds.certificatePrivateKey) {
+                return { action: "replace" };
+            }
+            if (news.certificateChain !== olds.certificateChain) {
+                return { action: "replace" };
+            }
+            if (news.certificateName !== olds.certificateName) {
+                return { action: "replace" };
+            }
+            if (news.regionalCertificateName !== olds.regionalCertificateName) {
+                return { action: "replace" };
+            }
+            if (!deepEqual(news.mutualTlsAuthentication, olds.mutualTlsAuthentication)) {
+                return { action: "replace" };
+            }
+            if (news.policy !== olds.policy) {
+                return { action: "replace" };
+            }
+            if (news.routingMode !== olds.routingMode) {
+                return { action: "replace" };
+            }
+            if (news.ownershipVerificationCertificateArn !==
+                olds.ownershipVerificationCertificateArn) {
+                return { action: "replace" };
+            }
+        }),
+        read: Effect.fn(function* ({ output }) {
+            if (!output?.domainName)
+                return undefined;
+            const d = yield* ag
+                .getDomainName({ domainName: output.domainName })
+                .pipe(Effect.catchTag("NotFoundException", () => Effect.succeed(undefined)));
+            if (!d?.domainName)
+                return undefined;
+            return {
+                domainName: d.domainName,
+                regionalDomainName: d.regionalDomainName,
+                regionalHostedZoneId: d.regionalHostedZoneId,
+                distributionDomainName: d.distributionDomainName,
+                distributionHostedZoneId: d.distributionHostedZoneId,
+                domainNameArn: d.domainNameArn,
+                tags: tagRecord(d.tags),
+            };
+        }),
+        reconcile: Effect.fn(function* ({ id, news: newsIn, output, session }) {
+            if (!isResolved(newsIn)) {
+                return yield* Effect.die("DomainName props were not resolved");
+            }
+            const news = newsIn;
+            const domainName = output?.domainName ?? news.domainName;
+            const internalTags = yield* createInternalTags(id);
+            const desiredTags = { ...news.tags, ...internalTags };
+            // Observe — fetch the live domain name. Domain names are
+            // user-supplied physical names so the lookup key is stable; we
+            // never trust `output.tags`/`output.securityPolicy` etc. for
+            // diffing, only re-read the cloud state.
+            let observed = yield* ag
+                .getDomainName({ domainName })
+                .pipe(Effect.catchTag("NotFoundException", () => Effect.succeed(undefined)));
+            // Ensure — create the domain name if it's missing.
+            if (!observed?.domainName) {
+                yield* ag.createDomainName({
+                    domainName: news.domainName,
+                    certificateName: news.certificateName,
+                    certificateBody: news.certificateBody,
+                    certificatePrivateKey: news.certificatePrivateKey,
+                    certificateChain: news.certificateChain,
+                    certificateArn: news.certificateArn,
+                    regionalCertificateName: news.regionalCertificateName,
+                    regionalCertificateArn: news.regionalCertificateArn,
+                    endpointConfiguration: news.endpointConfiguration,
+                    tags: desiredTags,
+                    securityPolicy: news.securityPolicy,
+                    endpointAccessMode: news.endpointAccessMode,
+                    mutualTlsAuthentication: news.mutualTlsAuthentication,
+                    ownershipVerificationCertificateArn: news.ownershipVerificationCertificateArn,
+                    policy: news.policy,
+                    routingMode: news.routingMode,
+                });
+                yield* session.note(`Created domain name ${news.domainName}`);
+                observed = yield* ag.getDomainName({ domainName });
+            }
+            // Sync mutable scalar fields — observed ↔ desired patch list.
+            const patches = [];
+            if (news.securityPolicy !== observed.securityPolicy) {
+                patches.push({
+                    op: news.securityPolicy === undefined ? "remove" : "replace",
+                    path: "/securityPolicy",
+                    value: news.securityPolicy,
+                });
+            }
+            if (news.regionalCertificateArn !== observed.regionalCertificateArn) {
+                patches.push({
+                    op: news.regionalCertificateArn === undefined
+                        ? "remove"
+                        : "replace",
+                    path: "/regionalCertificateArn",
+                    value: news.regionalCertificateArn,
+                });
+            }
+            if (news.certificateArn !== observed.certificateArn) {
+                patches.push({
+                    op: news.certificateArn === undefined ? "remove" : "replace",
+                    path: "/certificateArn",
+                    value: news.certificateArn,
+                });
+            }
+            if (patches.length > 0) {
+                // Domain name mutations can briefly conflict while API Gateway
+                // propagates certificate, policy, or routing changes.
+                yield* ag
+                    .updateDomainName({
+                    domainName,
+                    patchOperations: patches,
+                })
+                    .pipe(retryDomainNameMutation);
+            }
+            // Sync tags — diff observed cloud tags against desired so adoption
+            // converges without fighting whatever was already there.
+            const observedTags = tagRecord(observed.tags);
+            if (!deepEqual(observedTags, desiredTags) && observed.domainNameArn) {
+                yield* syncTags({
+                    resourceArn: observed.domainNameArn,
+                    oldTags: observedTags,
+                    newTags: desiredTags,
+                });
+            }
+            yield* session.note(`Reconciled domain name ${domainName}`);
+            const final = yield* ag.getDomainName({ domainName });
+            return {
+                domainName: final.domainName,
+                regionalDomainName: final.regionalDomainName,
+                regionalHostedZoneId: final.regionalHostedZoneId,
+                distributionDomainName: final.distributionDomainName,
+                distributionHostedZoneId: final.distributionHostedZoneId,
+                domainNameArn: final.domainNameArn,
+                tags: tagRecord(final.tags),
+            };
+        }),
+        delete: Effect.fn(function* ({ output, session }) {
+            yield* ag.deleteDomainName({ domainName: output.domainName }).pipe(Effect.catchTag("NotFoundException", () => Effect.void), retryDomainNameMutation);
+            yield* session.note(`Deleted domain name ${output.domainName}`);
+        }),
+    };
+}));
+//# sourceMappingURL=DomainName.js.map

package/lib/AWS/ApiGateway/DomainName.js.map

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

package/lib/AWS/ApiGateway/GatewayResource.d.ts

@@ -0,0 +1,80 @@
+import * as Effect from "effect/Effect";
+import type { Input } from "../../Input.ts";
+import * as Provider from "../../Provider.ts";
+import { type Resource as ResourceType } from "../../Resource.ts";
+import type { Providers } from "../Providers.ts";
+import type { RestApi } from "./RestApi.ts";
+export interface ApiGatewayResourceProps {
+    /**
+     * The `RestApi` this path segment belongs to. Binding via `restApi`
+     * registers this resource on the API so that any `Deployment` of the
+     * same API waits for it — and for the methods attached to it — before
+     * snapshotting.
+     */
+    restApi?: RestApi;
+    /**
+     * Identifier of the parent REST API. Usually derived from `restApi.restApiId`.
+     */
+    restApiId?: Input<string>;
+    /**
+     * Parent resource id (use `api.rootResourceId` for top-level paths, or
+     * the `resourceId` of another `ApiGateway.Resource` to nest deeper).
+     */
+    parentId: Input<string>;
+    /**
+     * Path segment (e.g. `items` or `{proxy+}`).
+     */
+    pathPart: string;
+}
+export interface ApiGatewayResource extends ResourceType<"AWS.ApiGateway.Resource", ApiGatewayResourceProps, {
+    resourceId: string;
+    restApiId: string;
+    parentId: string;
+    pathPart: string;
+}, never, Providers> {
+}
+/**
+ * A path segment under a REST API resource tree.
+ *
+ * Resources form the URL hierarchy of a REST API: every path segment
+ * (`/items`, `/items/{id}`, `/{proxy+}`) is a `Resource` whose `parentId`
+ * points either at `api.rootResourceId` (for top-level paths) or at
+ * another `Resource`'s `resourceId` (for nested paths). Attach methods
+ * to a resource by passing its `resourceId` to `ApiGateway.Method`.
+ *
+ * @section Path resources
+ * @example Top-level path
+ * ```typescript
+ * const items = yield* ApiGateway.Resource("Items", {
+ *   restApi: api,
+ *   parentId: api.rootResourceId,
+ *   pathPart: "items",
+ * });
+ * ```
+ *
+ * @example Nested path with a greedy proxy
+ * ```typescript
+ * const items = yield* ApiGateway.Resource("Items", {
+ *   restApi: api,
+ *   parentId: api.rootResourceId,
+ *   pathPart: "items",
+ * });
+ *
+ * const anyItem = yield* ApiGateway.Resource("AnyItem", {
+ *   restApi: api,
+ *   parentId: items.resourceId,
+ *   pathPart: "{proxy+}",
+ * });
+ * ```
+ */
+export declare const GatewayResource: import("../../Resource.ts").ResourceClass<ApiGatewayResource>;
+interface ApiGatewayResourceInputProps {
+    restApi?: RestApi;
+    restApiId?: Input<string>;
+    parentId: Input<string>;
+    pathPart: Input<string>;
+}
+export declare const Resource: (id: string, props: ApiGatewayResourceInputProps) => Effect.Effect<ApiGatewayResource, never, Providers>;
+export declare const ResourceProvider: () => import("effect/Layer").Layer<Provider.Provider<ApiGatewayResource>, never, import("effect/unstable/http/HttpClient").HttpClient | import("@distilled.cloud/aws/Region").Region | import("@distilled.cloud/aws/Credentials").Credentials>;
+export {};
+//# sourceMappingURL=GatewayResource.d.ts.map

package/lib/AWS/ApiGateway/GatewayResource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GatewayResource.d.ts","sourceRoot":"","sources":["../../../src/AWS/ApiGateway/GatewayResource.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,QAAQ,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAEL,KAAK,QAAQ,IAAI,YAAY,EAC9B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,WAAW,uBAAuB;IACtC;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;OAEG;IACH,SAAS,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC1B;;;OAGG;IACH,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACxB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAmB,SAAQ,YAAY,CACtD,yBAAyB,EACzB,uBAAuB,EACvB;IACE,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB,EACD,KAAK,EACL,SAAS,CACV;CAAG;AAEJ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,eAAO,MAAM,eAAe,+DAE3B,CAAC;AAEF,UAAU,4BAA4B;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC1B,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACxB,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CACzB;AA+BD,eAAO,MAAM,QAAQ,OAzBK,MAAM,SAAS,4BAA4B,wDAyBjC,CAAC;AAErC,eAAO,MAAM,gBAAgB,gPAgH1B,CAAC"}