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

import * as Effect from "effect/Effect";
import * as AWSBindings from "../AWSBindings.ts";
import type { PlatformApplication } from "./PlatformApplication.ts";
import type { Subscription } from "./Subscription.ts";
import type { Topic } from "./Topic.ts";

/**
 * Shared scaffolding for AWS SNS HTTP bindings.
 *
 * NOT exported from `index.ts` — every near-identical `{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 list,
 * and the injected identifier is boilerplate. Genuinely-different bindings
 * (the batched `TopicSink`) stay bespoke.
 */

/**
 * Build the impl Effect for an account-level operation (`ListTopics`,
 * `ListSubscriptions`, the SMS/sandbox APIs): the runtime callable passes
 * the caller's request through unchanged and the deploy-time half grants
 * `actions` on `*` (these SNS actions do not support resource-level
 * permissions — only topic-scoped actions do).
 */
export const makeSnsAccountHttpBinding = <I, A, E, R>(options: {
  /** Fully-qualified binding tag, e.g. `AWS.SNS.ListTopics`. */
  tag: string;
  /** The distilled operation, invoked with the caller's request as-is. */
  operation: Effect.Effect<(input: I) => Effect.Effect<A, E>, never, R>;
  /** IAM actions granted on `*`. */
  actions: readonly string[];
}) =>
  Effect.gen(function* () {
    const bind = yield* AWSBindings.Bind;
    const op = yield* AWSBindings.withCredentials(options.operation);

    return Effect.fn(function* () {
      if (!globalThis.__ALCHEMY_RUNTIME__) {
        yield* bind`${options.tag}()`({
          policyStatements: [
            {
              Effect: "Allow",
              Action: [...options.actions],
              Resource: ["*"],
            },
          ],
        });
      }
      return Effect.fn(options.tag)(function* (request?: I) {
        return yield* op((request ?? {}) as I);
      });
    });
  });

/**
 * Build the impl Effect for a topic-scoped operation: the runtime callable
 * injects the bound {@link Topic}'s ARN under `key` (`TopicArn` for the
 * pub/sub and attribute APIs, `ResourceArn` for the tagging and
 * data-protection-policy APIs) and the deploy-time half grants `actions` on
 * the topic's ARN.
 */
export const makeSnsTopicHttpBinding = <
  K extends "TopicArn" | "ResourceArn",
  I extends { [P in K]?: string },
  A,
  E,
  R,
>(options: {
  /** Fully-qualified binding tag, e.g. `AWS.SNS.Publish`. */
  tag: string;
  /** The distilled operation; the topic ARN is injected under `key`. */
  operation: Effect.Effect<(input: I) => Effect.Effect<A, E>, never, R>;
  /** IAM actions granted on the topic ARN. */
  actions: readonly string[];
  /** The request field the topic ARN is injected under. */
  key: K;
}) =>
  Effect.gen(function* () {
    const bind = yield* AWSBindings.Bind;
    const op = yield* AWSBindings.withCredentials(options.operation);

    return Effect.fn(function* (topic: Topic) {
      const TopicArn = yield* topic.topicArn;
      if (!globalThis.__ALCHEMY_RUNTIME__) {
        yield* bind`${options.tag}(${topic})`({
          policyStatements: [
            {
              Effect: "Allow",
              Action: [...options.actions],
              Resource: [topic.topicArn],
            },
          ],
        });
      }
      return Effect.fn(`${options.tag}(${topic.LogicalId})`)(function* (request?: Omit<I, K>) {
        return yield* op({
          ...request,
          [options.key]: yield* TopicArn,
        } as I);
      });
    });
  });

/**
 * Build the impl Effect for a subscription-scoped operation: the runtime
 * callable injects the bound {@link Subscription}'s identity under `key`
 * (`SubscriptionArn` for the attribute APIs, `TopicArn` for
 * `ConfirmSubscription`) and the deploy-time half grants `actions` on the
 * subscription's parent topic ARN (SNS checks subscription actions against
 * the topic resource).
 */
export const makeSnsSubscriptionHttpBinding = <
  K extends "SubscriptionArn" | "TopicArn",
  I extends { [P in K]?: string },
  A,
  E,
  R,
>(options: {
  /** Fully-qualified binding tag, e.g. `AWS.SNS.GetSubscriptionAttributes`. */
  tag: string;
  /** The distilled operation; the subscription identity is injected under `key`. */
  operation: Effect.Effect<(input: I) => Effect.Effect<A, E>, never, R>;
  /** IAM actions granted on the subscription's topic ARN. */
  actions: readonly string[];
  /** The request field the subscription identity is injected under. */
  key: K;
}) =>
  Effect.gen(function* () {
    const bind = yield* AWSBindings.Bind;
    const op = yield* AWSBindings.withCredentials(options.operation);

    return Effect.fn(function* (subscription: Subscription) {
      const identity = yield* options.key === "TopicArn"
        ? subscription.topicArn
        : subscription.subscriptionArn;
      if (!globalThis.__ALCHEMY_RUNTIME__) {
        yield* bind`${options.tag}(${subscription})`({
          policyStatements: [
            {
              Effect: "Allow",
              Action: [...options.actions],
              Resource: [subscription.topicArn],
            },
          ],
        });
      }
      return Effect.fn(`${options.tag}(${subscription.LogicalId})`)(function* (
        request?: Omit<I, K>,
      ) {
        return yield* op({
          ...request,
          [options.key]: yield* identity,
        } as I);
      });
    });
  });

/**
 * Build the impl Effect for a platform-application-scoped mobile-push
 * operation whose request accepts `PlatformApplicationArn`
 * (`CreatePlatformEndpoint`, `ListEndpointsByPlatformApplication`): the
 * runtime callable injects the bound {@link PlatformApplication}'s ARN and
 * the deploy-time half grants `actions` on `*` (SNS mobile-push actions do
 * not support resource-level permissions).
 */
export const makeSnsPlatformHttpBinding = <
  I extends { PlatformApplicationArn?: string },
  A,
  E,
  R,
>(options: {
  /** Fully-qualified binding tag, e.g. `AWS.SNS.CreatePlatformEndpoint`. */
  tag: string;
  /** The distilled operation; the application ARN is injected. */
  operation: Effect.Effect<(input: I) => Effect.Effect<A, E>, never, R>;
  /** IAM actions granted on `*` (no resource-level support). */
  actions: readonly string[];
}) =>
  Effect.gen(function* () {
    const bind = yield* AWSBindings.Bind;
    const op = yield* AWSBindings.withCredentials(options.operation);

    return Effect.fn(function* (application: PlatformApplication) {
      const PlatformApplicationArn = yield* application.platformApplicationArn;
      if (!globalThis.__ALCHEMY_RUNTIME__) {
        yield* bind`${options.tag}(${application})`({
          policyStatements: [
            {
              Effect: "Allow",
              Action: [...options.actions],
              Resource: ["*"],
            },
          ],
        });
      }
      return Effect.fn(`${options.tag}(${application.LogicalId})`)(function* (
        request?: Omit<I, "PlatformApplicationArn">,
      ) {
        return yield* op({
          ...request,
          PlatformApplicationArn: yield* PlatformApplicationArn,
        } as I);
      });
    });
  });

/**
 * Build the impl Effect for an endpoint-scoped mobile-push operation
 * (`GetEndpointAttributes`, `SetEndpointAttributes`, `DeleteEndpoint`,
 * publish-to-endpoint): the caller's request already carries the endpoint
 * identity (`EndpointArn`/`TargetArn`) and is passed through unchanged; the
 * binding is still scoped to a {@link PlatformApplication} for IAM naming
 * and grants `actions` on `*` (SNS mobile-push actions do not support
 * resource-level permissions).
 */
export const makeSnsEndpointHttpBinding = <I, A, E, R>(options: {
  /** Fully-qualified binding tag, e.g. `AWS.SNS.DeleteEndpoint`. */
  tag: string;
  /** The distilled operation, invoked with the caller's request as-is. */
  operation: Effect.Effect<(input: I) => Effect.Effect<A, E>, never, R>;
  /** IAM actions granted on `*` (no resource-level support). */
  actions: readonly string[];
}) =>
  Effect.gen(function* () {
    const bind = yield* AWSBindings.Bind;
    const op = yield* AWSBindings.withCredentials(options.operation);

    return Effect.fn(function* (application: PlatformApplication) {
      if (!globalThis.__ALCHEMY_RUNTIME__) {
        yield* bind`${options.tag}(${application})`({
          policyStatements: [
            {
              Effect: "Allow",
              Action: [...options.actions],
              Resource: ["*"],
            },
          ],
        });
      }
      return Effect.fn(`${options.tag}(${application.LogicalId})`)(function* (request: I) {
        return yield* op(request);
      });
    });
  });