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

package/lib/AWS/ApiGateway/GatewayResource.js

@@ -0,0 +1,162 @@
+import * as ag from "@distilled.cloud/aws/api-gateway";
+import * as Effect from "effect/Effect";
+import { isResolved } from "../../Diff.js";
+import * as Provider from "../../Provider.js";
+import { Resource as ResourceFactory, } from "../../Resource.js";
+/**
+ * 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 const GatewayResource = ResourceFactory("AWS.ApiGateway.Resource");
+/**
+ * User-facing wrapper. Accepts `restApi: RestApi` to register this resource
+ * as a binding on the API (so deployments wait for it transitively).
+ */
+const ResourceImpl = (id, props) => Effect.gen(function* () {
+    const { restApi, ...rest } = props;
+    const restApiId = rest.restApiId ?? restApi?.restApiId;
+    if (!restApiId) {
+        return yield* Effect.die("ApiGateway.Resource requires either `restApi` (preferred) or " +
+            "explicit `restApiId`.");
+    }
+    const resource = yield* GatewayResource(id, {
+        ...rest,
+        restApiId,
+    });
+    if (restApi) {
+        yield* restApi.bind `${resource}`({
+            kind: "resource",
+            resourceId: resource.resourceId,
+            parentId: resource.parentId,
+            pathPart: resource.pathPart,
+        });
+    }
+    return resource;
+});
+export const Resource = ResourceImpl;
+export const ResourceProvider = () => Provider.effect(GatewayResource, Effect.gen(function* () {
+    return {
+        stables: ["resourceId", "restApiId", "parentId"],
+        diff: Effect.fn(function* ({ news: newsIn, olds }) {
+            if (!isResolved(newsIn))
+                return;
+            const news = newsIn;
+            if (news.restApiId !== olds.restApiId ||
+                news.pathPart !== olds.pathPart ||
+                news.parentId !== olds.parentId) {
+                return { action: "replace" };
+            }
+        }),
+        read: Effect.fn(function* ({ output }) {
+            if (!output?.resourceId)
+                return undefined;
+            const r = yield* ag
+                .getResource({
+                restApiId: output.restApiId,
+                resourceId: output.resourceId,
+            })
+                .pipe(Effect.catchTag("NotFoundException", () => Effect.succeed(undefined)));
+            if (!r?.id)
+                return undefined;
+            return {
+                resourceId: r.id,
+                restApiId: output.restApiId,
+                parentId: r.parentId,
+                pathPart: r.pathPart,
+            };
+        }),
+        reconcile: Effect.fn(function* ({ news: newsIn, output, session }) {
+            if (!isResolved(newsIn)) {
+                return yield* Effect.die("Resource props were not resolved");
+            }
+            const news = newsIn;
+            const restApiId = (output?.restApiId ?? news.restApiId);
+            // Observe — fetch the live resource if we have a cached id. We
+            // never trust `output.pathPart` for diffing; we re-read the
+            // pathPart from cloud state every reconcile.
+            let observed = output?.resourceId
+                ? yield* ag
+                    .getResource({
+                    restApiId,
+                    resourceId: output.resourceId,
+                })
+                    .pipe(Effect.catchTag("NotFoundException", () => Effect.succeed(undefined)))
+                : undefined;
+            // Ensure — create the resource if missing.
+            if (!observed?.id) {
+                const created = yield* ag.createResource({
+                    restApiId: news.restApiId,
+                    parentId: news.parentId,
+                    pathPart: news.pathPart,
+                });
+                if (!created.id) {
+                    return yield* Effect.die("createResource missing id");
+                }
+                yield* session.note(`Created API Gateway resource ${created.id} (${news.pathPart})`);
+                observed = yield* ag.getResource({
+                    restApiId: news.restApiId,
+                    resourceId: created.id,
+                });
+            }
+            const resourceId = observed.id;
+            // Sync pathPart — observed ↔ desired. parentId moves are modeled
+            // as `replace` in `diff`, so we don't try to patch them here.
+            if (news.pathPart !== observed.pathPart) {
+                yield* ag.updateResource({
+                    restApiId,
+                    resourceId,
+                    patchOperations: [
+                        { op: "replace", path: "/pathPart", value: news.pathPart },
+                    ],
+                });
+                yield* session.note(`Updated resource ${resourceId}`);
+            }
+            return {
+                resourceId,
+                restApiId,
+                parentId: observed.parentId,
+                pathPart: news.pathPart,
+            };
+        }),
+        delete: Effect.fn(function* ({ output, session }) {
+            yield* ag
+                .deleteResource({
+                restApiId: output.restApiId,
+                resourceId: output.resourceId,
+            })
+                .pipe(Effect.catchTag("NotFoundException", () => Effect.void));
+            yield* session.note(`Deleted resource ${output.resourceId}`);
+        }),
+    };
+}));
+//# sourceMappingURL=GatewayResource.js.map

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

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

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

@@ -0,0 +1,39 @@
+import * as ag from "@distilled.cloud/aws/api-gateway";
+import type { Input } from "../../Input.ts";
+import * as Provider from "../../Provider.ts";
+import { Resource } from "../../Resource.ts";
+import type { Providers } from "../Providers.ts";
+export interface GatewayResponseProps {
+    restApiId: Input<string>;
+    responseType: ag.GatewayResponseType;
+    statusCode?: string;
+    responseParameters?: {
+        [key: string]: string | undefined;
+    };
+    responseTemplates?: {
+        [key: string]: string | undefined;
+    };
+}
+export interface GatewayResponse extends Resource<"AWS.ApiGateway.GatewayResponse", GatewayResponseProps, {
+    restApiId: string;
+    responseType: ag.GatewayResponseType;
+    statusCode: string | undefined;
+}, never, Providers> {
+}
+/**
+ * Gateway response mapping for a REST API (e.g. DEFAULT_4XX, DEFAULT_5XX).
+ *
+ * @section Gateway responses
+ * @example Default 4xx JSON body
+ * ```typescript
+ * yield* ApiGateway.GatewayResponse("Default4xx", {
+ *   restApiId: api.restApiId,
+ *   responseType: "DEFAULT_4XX",
+ *   responseTemplates: { "application/json": '{"message":$context.error.messageString}' },
+ * });
+ * ```
+ */
+declare const GatewayResponseResource: import("../../Resource.ts").ResourceClass<GatewayResponse>;
+export { GatewayResponseResource as GatewayResponse };
+export declare const GatewayResponseProvider: () => import("effect/Layer").Layer<Provider.Provider<GatewayResponse>, never, import("effect/unstable/http/HttpClient").HttpClient | import("@distilled.cloud/aws/Region").Region | import("@distilled.cloud/aws/Credentials").Credentials>;
+//# sourceMappingURL=GatewayResponse.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GatewayResponse.d.ts","sourceRoot":"","sources":["../../../src/AWS/ApiGateway/GatewayResponse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,kCAAkC,CAAC;AAGvD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,QAAQ,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGjD,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACzB,YAAY,EAAE,EAAE,CAAC,mBAAmB,CAAC;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;KAAE,CAAC;IAC3D,iBAAiB,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;KAAE,CAAC;CAC3D;AAED,MAAM,WAAW,eAAgB,SAAQ,QAAQ,CAC/C,gCAAgC,EAChC,oBAAoB,EACpB;IACE,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,EAAE,CAAC,mBAAmB,CAAC;IACrC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC,EACD,KAAK,EACL,SAAS,CACV;CAAG;AAEJ;;;;;;;;;;;;GAYG;AACH,QAAA,MAAM,uBAAuB,4DAE5B,CAAC;AAEF,OAAO,EAAE,uBAAuB,IAAI,eAAe,EAAE,CAAC;AAEtD,eAAO,MAAM,uBAAuB,6OAiFjC,CAAC"}

package/lib/AWS/ApiGateway/GatewayResponse.js

@@ -0,0 +1,88 @@
+import * as ag from "@distilled.cloud/aws/api-gateway";
+import * as Effect from "effect/Effect";
+import { isResolved } from "../../Diff.js";
+import * as Provider from "../../Provider.js";
+import { Resource } from "../../Resource.js";
+import { retryOnApiStatusUpdating } from "./common.js";
+/**
+ * Gateway response mapping for a REST API (e.g. DEFAULT_4XX, DEFAULT_5XX).
+ *
+ * @section Gateway responses
+ * @example Default 4xx JSON body
+ * ```typescript
+ * yield* ApiGateway.GatewayResponse("Default4xx", {
+ *   restApiId: api.restApiId,
+ *   responseType: "DEFAULT_4XX",
+ *   responseTemplates: { "application/json": '{"message":$context.error.messageString}' },
+ * });
+ * ```
+ */
+const GatewayResponseResource = Resource("AWS.ApiGateway.GatewayResponse");
+export { GatewayResponseResource as GatewayResponse };
+export const GatewayResponseProvider = () => Provider.effect(GatewayResponseResource, Effect.gen(function* () {
+    return {
+        stables: ["restApiId", "responseType"],
+        diff: Effect.fn(function* ({ news: newsIn, olds }) {
+            if (!isResolved(newsIn))
+                return;
+            const news = newsIn;
+            if (news.restApiId !== olds.restApiId ||
+                news.responseType !== olds.responseType) {
+                return { action: "replace" };
+            }
+        }),
+        read: Effect.fn(function* ({ output }) {
+            if (!output)
+                return undefined;
+            const g = yield* ag
+                .getGatewayResponse({
+                restApiId: output.restApiId,
+                responseType: output.responseType,
+            })
+                .pipe(Effect.catchTag("NotFoundException", () => Effect.succeed(undefined)));
+            if (!g?.responseType)
+                return undefined;
+            return {
+                restApiId: output.restApiId,
+                responseType: g.responseType,
+                statusCode: g.statusCode,
+            };
+        }),
+        reconcile: Effect.fn(function* ({ news: newsIn, output, session }) {
+            if (!isResolved(newsIn)) {
+                return yield* Effect.die("GatewayResponse props were not resolved");
+            }
+            const news = newsIn;
+            const restApiId = (output?.restApiId ?? news.restApiId);
+            const responseType = output?.responseType ?? news.responseType;
+            // Observe + Ensure + Sync as one atomic op.
+            // `putGatewayResponse` is an upsert: it creates the response if
+            // missing, replaces it if present. The reconciler is therefore a
+            // single put against the desired state regardless of whether
+            // `output` exists.
+            yield* retryOnApiStatusUpdating(ag.putGatewayResponse({
+                restApiId,
+                responseType,
+                statusCode: news.statusCode,
+                responseParameters: news.responseParameters,
+                responseTemplates: news.responseTemplates,
+            }));
+            yield* session.note(`Reconciled gateway response ${responseType} on ${restApiId}`);
+            return {
+                restApiId,
+                responseType,
+                statusCode: news.statusCode,
+            };
+        }),
+        delete: Effect.fn(function* ({ output, session }) {
+            yield* retryOnApiStatusUpdating(ag
+                .deleteGatewayResponse({
+                restApiId: output.restApiId,
+                responseType: output.responseType,
+            })
+                .pipe(Effect.catchTag("NotFoundException", () => Effect.void)));
+            yield* session.note(`Deleted gateway response ${output.responseType}`);
+        }),
+    };
+}));
+//# sourceMappingURL=GatewayResponse.js.map

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

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

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

@@ -0,0 +1,202 @@
+import * as ag from "@distilled.cloud/aws/api-gateway";
+import * as Effect from "effect/Effect";
+import type { Input } from "../../Input.ts";
+import * as Provider from "../../Provider.ts";
+import { Resource } from "../../Resource.ts";
+import type { Providers } from "../Providers.ts";
+import type { RestApi } from "./RestApi.ts";
+/**
+ * Integration configuration for an API Gateway method (passed to `putIntegration`).
+ */
+export interface MethodIntegrationProps {
+    type: ag.IntegrationType;
+    integrationHttpMethod?: string;
+    uri?: Input<string>;
+    connectionType?: ag.ConnectionType;
+    connectionId?: string;
+    /**
+     * IAM role ARN used by API Gateway for integration credentials.
+     *
+     * This is not a secret value; API Gateway stores an ARN or passthrough marker.
+     */
+    credentials?: string;
+    requestParameters?: {
+        [key: string]: string | undefined;
+    };
+    requestTemplates?: {
+        [key: string]: string | undefined;
+    };
+    passthroughBehavior?: string;
+    cacheNamespace?: string;
+    cacheKeyParameters?: string[];
+    contentHandling?: ag.ContentHandlingStrategy;
+    timeoutInMillis?: number;
+    tlsConfig?: ag.TlsConfig;
+    responseTransferMode?: ag.ResponseTransferMode;
+    integrationTarget?: string;
+}
+export interface MethodProps {
+    /**
+     * The `RestApi` this method lives on. When supplied, the method auto-binds
+     * itself to the API so that any `Deployment` of this API waits for the
+     * method to be created before snapshotting.
+     *
+     * When `restApi` is provided, `resourceId` defaults to `restApi.rootResourceId`,
+     * which is the common case for methods on the API root (`/`). Pass an
+     * explicit `resourceId` when targeting a sub-path defined by
+     * `ApiGateway.Resource`.
+     *
+     * Passing a raw `restApiId` instead is still supported but opts out of
+     * automatic deployment ordering — you must then manage `Deployment.triggers`
+     * yourself.
+     */
+    restApi?: RestApi;
+    /**
+     * ID of the REST API. Usually derived from `restApi.restApiId`; supply
+     * explicitly only when not using `restApi`.
+     */
+    restApiId?: Input<string>;
+    /**
+     * ID of the API Gateway Resource this method attaches to. Defaults to
+     * `restApi.rootResourceId` when `restApi` is provided.
+     */
+    resourceId?: Input<string>;
+    /** HTTP verb, e.g. `GET`, `POST`, `ANY`. */
+    httpMethod: string;
+    /**
+     * Authorization type (`NONE`, `IAM`, `CUSTOM`, `COGNITO_USER_POOLS`, etc.).
+     * @default "NONE"
+     */
+    authorizationType?: string;
+    authorizerId?: string;
+    apiKeyRequired?: boolean;
+    operationName?: string;
+    requestParameters?: {
+        [key: string]: boolean | undefined;
+    };
+    requestModels?: {
+        [key: string]: string | undefined;
+    };
+    requestValidatorId?: string;
+    authorizationScopes?: string[];
+    /** When set, `putIntegration` is applied after `putMethod`. */
+    integration?: MethodIntegrationProps;
+}
+export interface MethodType extends Resource<"AWS.ApiGateway.Method", MethodProps, {
+    restApiId: string;
+    resourceId: string;
+    httpMethod: string;
+    authorizationType: string;
+    authorizerId: string | undefined;
+    apiKeyRequired: boolean | undefined;
+    operationName: string | undefined;
+    requestParameters: {
+        [key: string]: boolean | undefined;
+    } | undefined;
+    requestModels: {
+        [key: string]: string | undefined;
+    } | undefined;
+    requestValidatorId: string | undefined;
+    authorizationScopes: string[] | undefined;
+    integration: MethodIntegrationProps | undefined;
+}, never, Providers> {
+}
+/**
+ * An HTTP method on an API Gateway Resource.
+ *
+ * A `Method` is a single HTTP verb (`GET`, `POST`, `ANY`, …) attached to a
+ * REST API resource path. Most methods also carry an `integration` — the
+ * downstream target that actually handles the request (a Lambda function,
+ * an HTTP endpoint, a mock response, etc.).
+ *
+ * @section Binding to a RestApi
+ * Pass the `RestApi` value on `restApi`. This threads the API id through
+ * and registers the method as a `RestApiBinding` on the API, so that any
+ * `Deployment` of the same API is automatically ordered after this method
+ * completes. You do not need to manage `Deployment.triggers` yourself.
+ *
+ * @example GET on the API root with a mock integration
+ * ```typescript
+ * yield* ApiGateway.Method("GetRoot", {
+ *   restApi: api,
+ *   httpMethod: "GET",
+ *   authorizationType: "NONE",
+ *   integration: { type: "MOCK" },
+ * });
+ * ```
+ *
+ * @section Lambda proxy integration
+ * For Lambda-backed APIs, the integration `uri` follows the
+ * `arn:aws:apigateway:<region>:lambda:path/2015-03-31/functions/<function-arn>/invocations`
+ * shape. Use `Output.map` to resolve the function ARN before building the
+ * URI, since the function's ARN is only known at deploy time.
+ *
+ * @example ANY method with Lambda AWS_PROXY integration
+ * ```typescript
+ * import * as Output from "alchemy/Output";
+ *
+ * const invokeUri = Output.map(
+ *   fn.functionArn,
+ *   (arn) =>
+ *     `arn:aws:apigateway:${region}:lambda:path/2015-03-31/functions/${arn}/invocations`,
+ * );
+ *
+ * yield* ApiGateway.Method("RootAny", {
+ *   restApi: api,
+ *   httpMethod: "ANY",
+ *   authorizationType: "NONE",
+ *   integration: {
+ *     type: "AWS_PROXY",
+ *     integrationHttpMethod: "POST",
+ *     uri: invokeUri,
+ *   },
+ * });
+ * ```
+ *
+ * @section Methods on sub-paths
+ * Attach a method to a nested path by creating an `ApiGateway.Resource` and
+ * passing its `resourceId` explicitly. `restApi` is still required so the
+ * method binds for deployment ordering.
+ *
+ * @example Method on `/items`
+ * ```typescript
+ * const items = yield* ApiGateway.Resource("Items", {
+ *   restApi: api,
+ *   parentId: api.rootResourceId,
+ *   pathPart: "items",
+ * });
+ *
+ * yield* ApiGateway.Method("ListItems", {
+ *   restApi: api,
+ *   resourceId: items.resourceId,
+ *   httpMethod: "GET",
+ *   authorizationType: "NONE",
+ *   integration: { type: "MOCK" },
+ * });
+ * ```
+ */
+export declare const MethodResource: import("../../Resource.ts").ResourceClass<MethodType>;
+export interface MethodInputProps {
+    restApi?: RestApi;
+    restApiId?: Input<string>;
+    resourceId?: Input<string>;
+    httpMethod: Input<string>;
+    authorizationType?: Input<string>;
+    authorizerId?: Input<string>;
+    apiKeyRequired?: Input<boolean>;
+    operationName?: Input<string>;
+    requestParameters?: Input<MethodProps["requestParameters"]>;
+    requestModels?: Input<MethodProps["requestModels"]>;
+    requestValidatorId?: Input<string>;
+    authorizationScopes?: Input<string[]>;
+    integration?: Input<MethodIntegrationProps>;
+}
+/**
+ * User-facing wrapper for the Method resource. Accepts `restApi: RestApi`
+ * as the idiomatic way to attach a method — this both forwards the API id
+ * and registers the method as a binding on the RestApi so the scheduler
+ * orders `Deployment` after it.
+ */
+export declare const Method: (id: string, props: MethodInputProps) => Effect.Effect<MethodType, never, Providers>;
+export declare const MethodProvider: () => import("effect/Layer").Layer<Provider.Provider<MethodType>, never, import("effect/unstable/http/HttpClient").HttpClient | import("@distilled.cloud/aws/Region").Region | import("@distilled.cloud/aws/Credentials").Credentials>;
+//# sourceMappingURL=Method.d.ts.map

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

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