sailfork / t3code-github / .repos/ alchemy-effect/ packages/ aws/ src/ ApiGatewayV2/ BindingHttp.ts

import type { Input } from "alchemy/Input";
import * as Effect from "effect/Effect";
import * as AWSBindings from "../AWSBindings.ts";
import { AWSEnvironment } from "../Environment.ts";

/**
 * Shared HTTP-binding scaffolding for the ApiGatewayV2 capabilities
 * (`ExportApiHttp`, `ResetAuthorizersCacheHttp`, …).
 *
 * NOT exported from `index.ts` — this is internal plumbing, like
 * Cloudflare's `BucketHttp.ts`.
 *
 * API Gateway's control plane (v2 included) authorizes by HTTP verb
 * (`apigateway:GET`, `apigateway:DELETE`, …) against path-shaped ARNs
 * (`arn:aws:apigateway:{region}::/apis/{apiId}/exports/{specification}`),
 * so every capability reduces to { verb, ARN paths, operation }.
 * Everything else — the runtime guard, host resolution, region lookup,
 * and the `host.bind` policy registration — is identical and lives here.
 *
 * The `@connections` data plane (`execute-api:ManageConnections`) is the
 * one genuinely different capability and stays bespoke in
 * `ManageConnectionsHttp.ts`.
 */

/** API Gateway authorizes control-plane calls by HTTP verb. */
export type ApiGatewayV2IamVerb = "GET" | "POST" | "PUT" | "PATCH" | "DELETE";

/**
 * Deploy-time half of an ApiGatewayV2 HTTP binding: resolves the host
 * Function, and registers an IAM policy statement for
 * `apigateway:{verb}` over the given API Gateway ARN paths. A no-op at
 * runtime (`__ALCHEMY_RUNTIME__`) and for non-Lambda hosts.
 *
 * @param cap fully-qualified capability name, e.g. `AWS.ApiGatewayV2.ExportApi`
 * @param target the bound resource — used for the binding's identity label
 * @param verb the API Gateway IAM verb the capability requires
 * @param paths builds the ARN path list once the deploy region is known;
 *        entries may be `Output`-derived (e.g. `Output.interpolate`)
 */
export const RegisterApiGatewayV2Binding = Effect.gen(function* () {
  const bind = yield* AWSBindings.Bind;
  return Effect.fn(function* (opts: {
    cap: string;
    target: unknown;
    verb: ApiGatewayV2IamVerb;
    paths: (region: string) => ReadonlyArray<Input<string>>;
  }) {
    if (globalThis.__ALCHEMY_RUNTIME__) return;
    const { region } = yield* AWSEnvironment.current as unknown as Effect.Effect<{
      region: string;
    }>;
    yield* bind`${opts.cap}(${opts.target})`({
      policyStatements: [
        {
          Effect: "Allow",
          Action: [`apigateway:${opts.verb}`],
          Resource: [...opts.paths(region)],
        },
      ],
    });
  });
});