sailfork / t3code-github / .repos/ alchemy-effect/ packages/ aws/ src/ IAM/ AccountAlias.ts

import * as iam from "@distilled.cloud/aws/iam";
import { isResolved } from "alchemy/Diff";
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 AccountAliasProps {
  /**
   * The AWS account alias to manage.
   */
  accountAlias: string;
}

export interface AccountAlias extends Resource<
  "AWS.IAM.AccountAlias",
  AccountAliasProps,
  {
    /** The alias assigned to the AWS account. */
    accountAlias: string;
  },
  never,
  Providers
> {}

/**
 * The singleton IAM account alias for an AWS account.
 *
 * `AccountAlias` manages the one account-level alias that customizes the AWS
 * sign-in URL for the current account.
 * ### Managing Account Identity
 * **Example:** Set the Account Alias
 * ```typescript
 * const alias = yield* AccountAlias("AccountAlias", {
 *   accountAlias: "my-company-prod",
 * });
 * ```
 *
 * @resource
 */
export const AccountAlias = Resource<AccountAlias>("AWS.IAM.AccountAlias");

const readAccountAlias = Effect.gen(function* () {
  const response = yield* iam.listAccountAliases({});
  return response.AccountAliases?.[0];
});

export const AccountAliasProvider = () =>
  Provider.succeed(AccountAlias, {
    stables: ["accountAlias"],
    diff: Effect.fn(function* ({ olds, news }) {
      if (!isResolved(news)) return;
      if (olds.accountAlias !== news.accountAlias) {
        return { action: "replace" } as const;
      }
    }),
    read: Effect.fn(function* () {
      const accountAlias = yield* readAccountAlias;
      if (!accountAlias) {
        return undefined;
      }
      return { accountAlias };
    }),
    // Account singleton: an AWS account has at most one alias. Enumerate the
    // single alias (if set) as a one-element array, or [] when none is set.
    list: Effect.fn(function* () {
      const accountAlias = yield* readAccountAlias;
      return accountAlias ? [{ accountAlias }] : [];
    }),
    reconcile: Effect.fn(function* ({ news, session }) {
      // Observe — the account alias is a singleton; the only way to know
      // which alias is set is to list and take the first entry.
      const existing = yield* readAccountAlias;

      // Ensure / Sync — IAM only allows a single alias per account, so
      // applying the desired alias is just `createAccountAlias`. If a
      // different alias already exists, replace it by creating the new one
      // and deleting the old (the API also supports overwriting in a
      // single call but we keep delete idempotent).
      if (existing !== news.accountAlias) {
        yield* iam.createAccountAlias({
          AccountAlias: news.accountAlias,
        });
        if (existing && existing !== news.accountAlias) {
          yield* iam
            .deleteAccountAlias({
              AccountAlias: existing,
            })
            .pipe(Effect.catchTag("NoSuchEntityException", () => Effect.void));
        }
      }

      yield* session.note(news.accountAlias);
      return { accountAlias: news.accountAlias };
    }),
    delete: Effect.fn(function* ({ output }) {
      yield* iam
        .deleteAccountAlias({
          AccountAlias: output.accountAlias,
        })
        .pipe(Effect.catchTag("NoSuchEntityException", () => Effect.void));
    }),
  });