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

import * as Effect from "effect/Effect";
import * as AWSBindings from "../AWSBindings.ts";
import type { AnomalyMonitor } from "./AnomalyMonitor.ts";
import { pinCe } from "./common.ts";
import type { CostCategory } from "./CostCategory.ts";

/**
 * Shared HTTP scaffolding for the Cost Explorer runtime bindings.
 *
 * NOT exported from `index.ts` — every `{Op}Http.ts` in this service is a
 * thin `Layer.effect(Cap, make…HttpBinding({ … }))` over one of the builders
 * below. Everything except the operation, the IAM action, and (for the
 * scoped builders) the injected ARN is boilerplate.
 *
 * Cost Explorer is a global service served exclusively from the `us-east-1`
 * endpoint, so every operation is resolved with the Region pinned via
 * {@link pinCe} — exactly like the resource providers in `common.ts`.
 *
 * Per the `ce` service authorization reference, most query actions support
 * no resource types, so the account-level builder grants on
 * `Resource: ["*"]`. `ce:GetAnomalies` authorizes on the `anomalymonitor`
 * resource type, so the anomaly-monitor builder grants on the bound
 * monitor's ARN.
 */

/**
 * Build the impl Effect for an account-level Cost Explorer operation (the
 * cost/usage queries, forecasts, recommendations, and cost allocation tag
 * operations — none of which are resource-scoped).
 */
export const makeCostExplorerHttpBinding = <
  I extends object,
  A,
  // `{ _tag: string }` bound so `pinCe` (whose throttle retry inspects
  // `_tag`) applies without collapsing the inferred error union.
  E extends { _tag: string },
  R,
>(options: {
  /**
   * Short capability name used in the binding sid and runtime span, e.g.
   * `"GetCostAndUsage"`.
   */
  capability: string;
  /** IAM actions granted on `Resource: ["*"]`. */
  iamActions: readonly string[];
  /** The distilled operation implementing the capability. */
  operation: Effect.Effect<(input: I) => Effect.Effect<A, E>, never, R>;
}) =>
  Effect.gen(function* () {
    const bind = yield* AWSBindings.Bind;
    const op = yield* options.operation.pipe(pinCe, AWSBindings.withCredentials);

    return Effect.fn(function* () {
      if (!globalThis.__ALCHEMY_RUNTIME__) {
        yield* bind`AWS.CostExplorer.${options.capability}()`({
          policyStatements: [
            {
              Effect: "Allow",
              Action: [...options.iamActions],
              Resource: ["*"],
            },
          ],
        });
      }
      return Effect.fn(`AWS.CostExplorer.${options.capability}`)(function* (request?: I) {
        // The region must also be pinned at the call site: the yield-time
        // snapshot is only a fallback — the calling fiber's ambient Region
        // (the host Function's own region) wins over it.
        return yield* pinCe(op((request ?? {}) as I));
      });
    });
  });

/**
 * Build the impl Effect for an operation scoped to one
 * {@link AnomalyMonitor}. The runtime callable injects the bound monitor's
 * ARN as the request's `MonitorArn`; the deploy-time half grants
 * `iamActions` on the monitor's ARN.
 */
export const makeAnomalyMonitorHttpBinding = <
  I extends { MonitorArn?: string },
  A,
  // See makeCostExplorerHttpBinding.
  E extends { _tag: string },
  R,
>(options: {
  /**
   * Short capability name used in the binding sid and runtime span, e.g.
   * `"GetAnomalies"`.
   */
  capability: string;
  /** IAM actions granted on the monitor ARN. */
  iamActions: readonly string[];
  /** The distilled operation; `MonitorArn` is injected. */
  operation: Effect.Effect<(input: I) => Effect.Effect<A, E>, never, R>;
}) =>
  Effect.gen(function* () {
    const bind = yield* AWSBindings.Bind;
    const op = yield* options.operation.pipe(pinCe, AWSBindings.withCredentials);

    return Effect.fn(function* (monitor: AnomalyMonitor) {
      const MonitorArn = yield* monitor.monitorArn;
      if (!globalThis.__ALCHEMY_RUNTIME__) {
        yield* bind`AWS.CostExplorer.${options.capability}(${monitor})`({
          policyStatements: [
            {
              Effect: "Allow",
              Action: [...options.iamActions],
              Resource: [monitor.monitorArn],
            },
          ],
        });
      }
      return Effect.fn(`AWS.CostExplorer.${options.capability}(${monitor.LogicalId})`)(function* (
        request: Omit<I, "MonitorArn">,
      ) {
        // Call-site region pin — see makeCostExplorerHttpBinding above.
        return yield* pinCe(
          op({
            ...request,
            MonitorArn: yield* MonitorArn,
          } as I),
        );
      });
    });
  });

/**
 * Build the impl Effect for an operation bound to one {@link CostCategory}.
 * The runtime callable injects the bound category's ARN as the request's
 * `CostCategoryArn`. The deploy-time half grants `iamActions` on
 * `Resource: ["*"]` — per the `ce` service authorization reference,
 * `ce:ListCostCategoryResourceAssociations` supports no resource types, so
 * a grant scoped to the category ARN would never match.
 */
export const makeCostCategoryHttpBinding = <
  I extends { CostCategoryArn?: string },
  A,
  // See makeCostExplorerHttpBinding.
  E extends { _tag: string },
  R,
>(options: {
  /**
   * Short capability name used in the binding sid and runtime span, e.g.
   * `"ListCostCategoryResourceAssociations"`.
   */
  capability: string;
  /** IAM actions granted on `Resource: ["*"]` (no resource types). */
  iamActions: readonly string[];
  /** The distilled operation; `CostCategoryArn` is injected. */
  operation: Effect.Effect<(input: I) => Effect.Effect<A, E>, never, R>;
}) =>
  Effect.gen(function* () {
    const bind = yield* AWSBindings.Bind;
    const op = yield* options.operation.pipe(pinCe, AWSBindings.withCredentials);

    return Effect.fn(function* (category: CostCategory) {
      const CostCategoryArn = yield* category.costCategoryArn;
      if (!globalThis.__ALCHEMY_RUNTIME__) {
        yield* bind`AWS.CostExplorer.${options.capability}(${category})`({
          policyStatements: [
            {
              Effect: "Allow",
              Action: [...options.iamActions],
              Resource: ["*"],
            },
          ],
        });
      }
      return Effect.fn(`AWS.CostExplorer.${options.capability}(${category.LogicalId})`)(function* (
        request?: Omit<I, "CostCategoryArn">,
      ) {
        // Call-site region pin — see makeCostExplorerHttpBinding above.
        return yield* pinCe(
          op({
            ...request,
            CostCategoryArn: yield* CostCategoryArn,
          } as I),
        );
      });
    });
  });