sailfork / t3code-github / .repos/ alchemy-effect/ packages/ aws/ src/ SES/ ActiveReceiptRuleSet.ts

import * as ses from "@distilled.cloud/aws/ses";
import * as Provider from "alchemy/Provider";
import { Resource } from "alchemy/Resource";
import * as Effect from "effect/Effect";
import type { Providers } from "../Providers.ts";

export interface ActiveReceiptRuleSetProps {
  /**
   * Name of the receipt rule set to make active for the account in the current
   * region. Typically the `ruleSetName` output of a `SES.ReceiptRuleSet`.
   * Re-pointing to a different rule set updates the active pointer in place.
   */
  ruleSetName: string;
}

export interface ActiveReceiptRuleSet extends Resource<
  "AWS.SES.ActiveReceiptRuleSet",
  ActiveReceiptRuleSetProps,
  {
    /** Name of the rule set that is active for the account. */
    ruleSetName: string;
  },
  never,
  Providers
> {}

/**
 * The account's active Amazon SES receipt rule set — the single rule set (per
 * account, per region) that SES actually evaluates against inbound mail.
 *
 * This is an account-level singleton pointer, not a container: only one rule
 * set can be active at a time. Deleting this resource deactivates email
 * receiving (clears the pointer) only when the account is still pointed at the
 * rule set this resource set; if something else has since become active, the
 * delete is a no-op.
 * ### Activating a Rule Set
 * **Example:** Make a Rule Set Active
 * ```typescript
 * import * as SES from "@alchemy.run/aws/SES";
 *
 * const ruleSet = yield* SES.ReceiptRuleSet("Inbound", {});
 * const active = yield* SES.ActiveReceiptRuleSet("Active", {
 *   ruleSetName: ruleSet.ruleSetName,
 * });
 * ```
 *
 * @resource
 */
export const ActiveReceiptRuleSet = Resource<ActiveReceiptRuleSet>("AWS.SES.ActiveReceiptRuleSet");

const activeRuleSetName = Effect.fn(function* () {
  const response = yield* ses.describeActiveReceiptRuleSet({});
  return response.Metadata?.Name;
});

export const ActiveReceiptRuleSetProvider = () =>
  Provider.succeed(ActiveReceiptRuleSet, {
    // Account/region singleton setting: "deleting" it only clears the active
    // pointer, so nuke skips it (and would otherwise disable email receiving
    // account-wide).
    nuke: { singleton: true },

    list: () => Effect.succeed([]),

    read: Effect.fn(function* () {
      const name = yield* activeRuleSetName();
      return name ? { ruleSetName: name } : undefined;
    }),

    reconcile: Effect.fn(function* ({ news }) {
      // OBSERVE the current active pointer; only re-point on a mismatch.
      const observed = yield* activeRuleSetName();
      if (observed !== news.ruleSetName) {
        yield* ses.setActiveReceiptRuleSet({ RuleSetName: news.ruleSetName });
      }
      return { ruleSetName: news.ruleSetName };
    }),

    delete: Effect.fn(function* ({ output }) {
      // Only deactivate if the account is still pointed at the rule set we
      // activated; otherwise another owner has taken over and we leave it be.
      const observed = yield* activeRuleSetName();
      if (observed === output.ruleSetName) {
        yield* ses.setActiveReceiptRuleSet({});
      }
    }),
  });