sailfork / t3code-github / .repos/ alchemy-effect/ packages/ aws/ src/ IdentityCenter/ AccountAssignment.ts

import * as ssoAdmin from "@distilled.cloud/aws/sso-admin";
import { isResolved } from "alchemy/Diff";
import * as Provider from "alchemy/Provider";
import { Resource } from "alchemy/Resource";
import * as Data from "effect/Data";
import * as Effect from "effect/Effect";
import * as Schedule from "effect/Schedule";
import * as Stream from "effect/Stream";
import type { Providers } from "../Providers.ts";
import { listInstances, resolveInstance, retryIdentityCenter } from "./common.ts";

export class AccountAssignmentUnexpectedResponse extends Data.TaggedError(
  "AccountAssignmentUnexpectedResponse",
)<{
  readonly message: string;
  readonly cause?: unknown;
}> {}

export class AccountAssignmentOperationFailed extends Data.TaggedError(
  "AccountAssignmentOperationFailed",
)<{
  readonly message: string;
  readonly cause?: unknown;
}> {}

export interface AccountAssignmentProps {
  /**
   * Explicit Identity Center instance ARN.
   * If omitted, Alchemy adopts the only visible instance.
   */
  instanceArn?: string;
  /**
   * Permission set ARN to assign.
   */
  permissionSetArn: string;
  /**
   * Principal ID from the IAM Identity Center identity store.
   */
  principalId: string;
  /**
   * Principal type.
   */
  principalType: "USER" | "GROUP";
  /**
   * Target AWS account ID.
   */
  targetId: string;
}

export interface AccountAssignment extends Resource<
  "AWS.IdentityCenter.AccountAssignment",
  AccountAssignmentProps,
  {
    /** The Identity Center instance the assignment lives in. */
    instanceArn: string;
    /** The permission set provisioned to the target. */
    permissionSetArn: string;
    /** The user or group ID that was assigned. */
    principalId: string;
    /** Whether the principal is a `USER` or `GROUP`. */
    principalType: "USER" | "GROUP";
    /** The AWS account ID the assignment targets. */
    targetId: string;
    /** The target type (`AWS_ACCOUNT`). */
    targetType: "AWS_ACCOUNT";
  },
  never,
  Providers
> {}

/**
 * Assigns an IAM Identity Center permission set to a user or group in an AWS
 * account.
 * ### Creating Assignments
 * **Example:** Assign A Group To A Workload Account
 * ```typescript
 * const assignment = yield* AccountAssignment("ProdAdminAssignment", {
 *   permissionSetArn: admin.permissionSetArn,
 *   principalType: "GROUP",
 *   principalId: engineers.groupId,
 *   targetId: prod.accountId,
 * });
 * ```
 *
 * @resource
 */
export const AccountAssignment = Resource<AccountAssignment>(
  "AWS.IdentityCenter.AccountAssignment",
);

export const AccountAssignmentProvider = () =>
  Provider.effect(
    AccountAssignment,
    Effect.gen(function* () {
      return {
        stables: [
          "instanceArn",
          "permissionSetArn",
          "principalId",
          "principalType",
          "targetId",
          "targetType",
        ],
        diff: Effect.fn(function* ({ olds, news }) {
          if (!isResolved(news)) return;
          if (
            olds?.instanceArn !== news.instanceArn ||
            olds?.permissionSetArn !== news.permissionSetArn ||
            olds?.principalId !== news.principalId ||
            olds?.principalType !== news.principalType ||
            olds?.targetId !== news.targetId
          ) {
            return { action: "replace" } as const;
          }
        }),
        // Enumerate every account assignment in the account/region. Assignments
        // are keyed by (instance, permissionSet, account, principal) with no
        // top-level list API, so fan out: list instances -> permission sets per
        // instance -> accounts provisioned to each permission set -> account
        // assignments per (account, permissionSet). Each `listAccountAssignments`
        // item already carries every field of the `read`-shaped Attributes, so
        // no per-item hydration is needed. All pagination is exhausted; missing
        // parents (deleted concurrently) are skipped via the typed
        // `ResourceNotFoundException` tag. Bounded concurrency keeps the fan-out
        // from exploding.
        list: () =>
          Effect.gen(function* () {
            const instances = yield* listInstances();

            const perInstance = yield* Effect.forEach(
              instances,
              (instance) => {
                const instanceArn = instance.InstanceArn;
                if (!instanceArn) {
                  return Effect.succeed([] as AccountAssignment["Attributes"][]);
                }
                return listAssignmentsForInstance(instanceArn);
              },
              { concurrency: 5 },
            );

            return perInstance.flat();
          }),
        read: Effect.fn(function* ({ olds, output }) {
          if (output?.instanceArn) {
            return yield* readAssignment({
              instanceArn: output.instanceArn,
              permissionSetArn: output.permissionSetArn,
              principalId: output.principalId,
              principalType: output.principalType,
              targetId: output.targetId,
            });
          }

          if (!olds) {
            return undefined;
          }

          return yield* readAssignment(olds);
        }),
        reconcile: Effect.fn(function* ({ news, output, session }) {
          // Observe — look up the assignment between (principal,
          // permissionSet, target). All identifying fields are stable;
          // diff() forces a replace on any change, so this reconcile is
          // existence-only.
          const existing = yield* readAssignment({
            ...news,
            instanceArn: output?.instanceArn ?? news.instanceArn,
          });
          if (existing) {
            yield* session.note(
              `${existing.targetId}:${existing.permissionSetArn}:${existing.principalId}`,
            );
            return existing;
          }

          // Ensure — create the assignment if missing.
          const instance = yield* resolveInstance(news.instanceArn);
          const response = yield* retryIdentityCenter(
            ssoAdmin.createAccountAssignment({
              InstanceArn: instance.InstanceArn!,
              PermissionSetArn: news.permissionSetArn,
              PrincipalId: news.principalId,
              PrincipalType: news.principalType,
              TargetId: news.targetId,
              TargetType: "AWS_ACCOUNT",
            }),
          );

          const requestId = response.AccountAssignmentCreationStatus?.RequestId ?? undefined;
          if (requestId) {
            yield* waitForAssignmentCreation(instance.InstanceArn!, requestId);
          }

          const created = yield* readAssignment({
            ...news,
            instanceArn: instance.InstanceArn,
          });
          if (!created) {
            return yield* new AccountAssignmentUnexpectedResponse({
              message: "account assignment not found after create",
            });
          }

          yield* session.note(
            `${created.targetId}:${created.permissionSetArn}:${created.principalId}`,
          );
          return created;
        }),
        delete: Effect.fn(function* ({ output }) {
          if (!(yield* readAssignment(output))) {
            return;
          }

          const response = yield* retryIdentityCenter(
            ssoAdmin
              .deleteAccountAssignment({
                InstanceArn: output.instanceArn,
                PermissionSetArn: output.permissionSetArn,
                PrincipalId: output.principalId,
                PrincipalType: output.principalType,
                TargetId: output.targetId,
                TargetType: "AWS_ACCOUNT",
              })
              .pipe(Effect.catchTag("ResourceNotFoundException", () => Effect.undefined)),
          );

          const requestId = response?.AccountAssignmentDeletionStatus?.RequestId ?? undefined;
          if (requestId) {
            yield* waitForAssignmentDeletion(output.instanceArn, requestId);
          }
        }),
      };
    }),
  );

const listAssignmentsForInstance = Effect.fn(function* (instanceArn: string) {
  const permissionSetArns = yield* retryIdentityCenter(
    ssoAdmin.listPermissionSets.items({ InstanceArn: instanceArn, MaxResults: 100 }).pipe(
      Stream.runCollect,
      Effect.map((items) => Array.from(items) as string[]),
    ),
  ).pipe(Effect.catchTag("ResourceNotFoundException", () => Effect.succeed([])));

  const perPermissionSet = yield* Effect.forEach(
    permissionSetArns,
    (permissionSetArn) => listAssignmentsForPermissionSet(instanceArn, permissionSetArn),
    { concurrency: 10 },
  );

  return perPermissionSet.flat();
});

const listAssignmentsForPermissionSet = Effect.fn(function* (
  instanceArn: string,
  permissionSetArn: string,
) {
  const accountIds = yield* retryIdentityCenter(
    ssoAdmin.listAccountsForProvisionedPermissionSet
      .items({
        InstanceArn: instanceArn,
        PermissionSetArn: permissionSetArn,
        MaxResults: 100,
      })
      .pipe(
        Stream.runCollect,
        Effect.map((items) => Array.from(items) as string[]),
      ),
  ).pipe(Effect.catchTag("ResourceNotFoundException", () => Effect.succeed([])));

  const perAccount = yield* Effect.forEach(
    accountIds,
    (accountId) =>
      ssoAdmin.listAccountAssignments
        .items({
          InstanceArn: instanceArn,
          AccountId: accountId,
          PermissionSetArn: permissionSetArn,
          MaxResults: 100,
        })
        .pipe(
          Stream.runCollect,
          Effect.map((items) => Array.from(items) as ssoAdmin.AccountAssignment[]),
          retryIdentityCenter,
          Effect.map((assignments) =>
            assignments.flatMap((assignment): AccountAssignment["Attributes"][] => {
              if (
                !assignment.AccountId ||
                !assignment.PermissionSetArn ||
                !assignment.PrincipalId ||
                (assignment.PrincipalType !== "USER" && assignment.PrincipalType !== "GROUP")
              ) {
                return [];
              }
              return [
                {
                  instanceArn,
                  permissionSetArn: assignment.PermissionSetArn,
                  principalId: assignment.PrincipalId,
                  principalType: assignment.PrincipalType as "USER" | "GROUP",
                  targetId: assignment.AccountId,
                  targetType: "AWS_ACCOUNT",
                },
              ];
            }),
          ),
          Effect.catchTag("ResourceNotFoundException", () => Effect.succeed([])),
        ),
    { concurrency: 10 },
  );

  return perAccount.flat();
});

const readAssignment = Effect.fn(function* ({
  instanceArn,
  permissionSetArn,
  principalId,
  principalType,
  targetId,
}: AccountAssignmentProps) {
  // A `creating` row can serialize without resolved Outputs (`targetId`
  // from `account.accountId`, etc.). Distilled `ListAccountAssignments`
  // then fails with `ParseError: Expected string at ["AccountId"]`.
  if (!targetId || !permissionSetArn || !principalId) {
    return undefined;
  }

  const instance = yield* resolveInstance(instanceArn);
  const assignments = yield* ssoAdmin.listAccountAssignments
    .items({
      InstanceArn: instance.InstanceArn!,
      AccountId: targetId,
      PermissionSetArn: permissionSetArn,
      MaxResults: 100,
    })
    .pipe(
      Stream.runCollect,
      Effect.map((items) => Array.from(items) as ssoAdmin.AccountAssignment[]),
    );

  const match = assignments.find(
    (assignment) =>
      assignment.PrincipalId === principalId && assignment.PrincipalType === principalType,
  );

  if (!match) {
    return undefined;
  }
  const result: AccountAssignment["Attributes"] = {
    instanceArn: instance.InstanceArn!,
    permissionSetArn,
    principalId,
    principalType,
    targetId,
    targetType: "AWS_ACCOUNT",
  };
  return result;
});

const waitForAssignmentCreation = (instanceArn: string, requestId: string) =>
  Effect.gen(function* () {
    const response = yield* retryIdentityCenter(
      ssoAdmin.describeAccountAssignmentCreationStatus({
        InstanceArn: instanceArn,
        AccountAssignmentCreationRequestId: requestId,
      }),
    );
    const status = response.AccountAssignmentCreationStatus;

    if (!status?.Status || status.Status === "IN_PROGRESS") {
      return yield* Effect.fail({
        _tag: "AssignmentCreationInProgress" as const,
      });
    }

    if (status.Status === "FAILED") {
      return yield* new AccountAssignmentOperationFailed({
        message: `account assignment creation failed: ${status.FailureReason ?? "unknown failure"}`,
      });
    }

    return status;
  }).pipe(
    Effect.retry({
      while: (error: any) => error?._tag === "AssignmentCreationInProgress",
      schedule: Schedule.max([Schedule.spaced("2 seconds"), Schedule.recurs(120)]),
    }),
  );

const waitForAssignmentDeletion = (instanceArn: string, requestId: string) =>
  Effect.gen(function* () {
    const response = yield* retryIdentityCenter(
      ssoAdmin.describeAccountAssignmentDeletionStatus({
        InstanceArn: instanceArn,
        AccountAssignmentDeletionRequestId: requestId,
      }),
    );
    const status = response.AccountAssignmentDeletionStatus;

    if (!status?.Status || status.Status === "IN_PROGRESS") {
      return yield* Effect.fail({
        _tag: "AssignmentDeletionInProgress" as const,
      });
    }

    if (status.Status === "FAILED") {
      return yield* new AccountAssignmentOperationFailed({
        message: `account assignment deletion failed: ${status.FailureReason ?? "unknown failure"}`,
      });
    }

    return status;
  }).pipe(
    Effect.retry({
      while: (error: any) => error?._tag === "AssignmentDeletionInProgress",
      schedule: Schedule.max([Schedule.spaced("2 seconds"), Schedule.recurs(120)]),
    }),
  );