sailfork / t3code-github / .repos/ alchemy-effect/ packages/ aws/ src/ IAM/ LoginProfile.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 * as Redacted from "effect/Redacted";
import * as Stream from "effect/Stream";
import type { Providers } from "../Providers.ts";
import { unwrapRedactedString } from "./common.ts";

export interface LoginProfileProps {
  /**
   * User that owns the console login profile.
   */
  userName: string;
  /**
   * Console password. AWS never returns this value after create/update.
   */
  password: Redacted.Redacted<string> | string;
  /**
   * Require a password reset on next sign in.
   */
  passwordResetRequired?: boolean;
}

export interface LoginProfile extends Resource<
  "AWS.IAM.LoginProfile",
  LoginProfileProps,
  {
    /** The IAM user the login profile belongs to. */
    userName: string;
    /** When the login profile was created. */
    createDate: Date | undefined;
    /** Whether the user must set a new password on next sign-in. */
    passwordResetRequired: boolean | undefined;
  },
  never,
  Providers
> {}

/**
 * An IAM console login profile for a user.
 *
 * `LoginProfile` manages AWS Management Console access for an IAM user. The
 * password is write-only, so AWS never returns it during later reads.
 * ### Managing Console Access
 * **Example:** Create a Console Login Profile
 * ```typescript
 * const user = yield* User("ConsoleUser", {
 *   userName: "console-user",
 * });
 *
 * const profile = yield* LoginProfile("ConsoleLogin", {
 *   userName: user.userName,
 *   password: Redacted.make("TempPassword123!"),
 *   passwordResetRequired: true,
 * });
 * ```
 *
 * @resource
 */
export const LoginProfile = Resource<LoginProfile>("AWS.IAM.LoginProfile");

export const LoginProfileProvider = () =>
  Provider.succeed(LoginProfile, {
    stables: ["userName"],
    diff: Effect.fn(function* ({ olds, news }) {
      if (!isResolved(news)) return;
      if (olds.userName !== news.userName) {
        return { action: "replace" } as const;
      }
    }),
    read: Effect.fn(function* ({ output }) {
      if (!output) {
        return undefined;
      }
      const response = yield* iam
        .getLoginProfile({
          UserName: output.userName,
        })
        .pipe(Effect.catchTag("NoSuchEntityException", () => Effect.undefined));
      if (!response?.LoginProfile) {
        return undefined;
      }
      return {
        userName: response.LoginProfile.UserName,
        createDate: response.LoginProfile.CreateDate,
        passwordResetRequired: response.LoginProfile.PasswordResetRequired,
      };
    }),
    reconcile: Effect.fn(function* ({ news, session }) {
      // Observe — read the live login profile (or absence) for the user.
      const observed = yield* iam
        .getLoginProfile({ UserName: news.userName })
        .pipe(Effect.catchTag("NoSuchEntityException", () => Effect.undefined));

      // Ensure / Sync — the password is write-only, so we always send the
      // desired value. Use `createLoginProfile` when the profile is
      // missing and `updateLoginProfile` otherwise. A race that turns the
      // create into `EntityAlreadyExistsException` is recovered by
      // calling update.
      let response = observed;
      if (!observed?.LoginProfile) {
        response = yield* iam
          .createLoginProfile({
            UserName: news.userName,
            Password: unwrapRedactedString(news.password),
            PasswordResetRequired: news.passwordResetRequired,
          })
          .pipe(
            Effect.catchTag("EntityAlreadyExistsException", () =>
              Effect.gen(function* () {
                yield* iam.updateLoginProfile({
                  UserName: news.userName,
                  Password: unwrapRedactedString(news.password),
                  PasswordResetRequired: news.passwordResetRequired,
                });
                return yield* iam.getLoginProfile({
                  UserName: news.userName,
                });
              }),
            ),
          );
      } else {
        yield* iam.updateLoginProfile({
          UserName: news.userName,
          Password: unwrapRedactedString(news.password),
          PasswordResetRequired: news.passwordResetRequired,
        });
        response = yield* iam.getLoginProfile({ UserName: news.userName });
      }

      yield* session.note(news.userName);
      return {
        userName: response!.LoginProfile.UserName,
        createDate: response!.LoginProfile.CreateDate,
        passwordResetRequired: response!.LoginProfile.PasswordResetRequired,
      };
    }),
    delete: Effect.fn(function* ({ output }) {
      yield* iam
        .deleteLoginProfile({
          UserName: output.userName,
        })
        .pipe(Effect.catchTag("NoSuchEntityException", () => Effect.void));
    }),
    // There is no list-login-profiles API: a login profile is a per-user
    // singleton. Enumerate every IAM user (paginated), then probe each with
    // `getLoginProfile`; users without console access return a typed
    // `NoSuchEntityException`, which we skip. Bounded concurrency keeps the
    // fan-out reasonable.
    list: Effect.fn(function* () {
      const users = yield* iam.listUsers.pages({}).pipe(
        Stream.runCollect,
        Effect.map((chunk) => Array.from(chunk).flatMap((page) => page.Users)),
      );
      const profiles = yield* Effect.forEach(
        users,
        (user) =>
          iam.getLoginProfile({ UserName: user.UserName }).pipe(
            Effect.map((response) => ({
              userName: response.LoginProfile.UserName,
              createDate: response.LoginProfile.CreateDate,
              passwordResetRequired: response.LoginProfile.PasswordResetRequired,
            })),
            // The user has no console login profile, or was deleted between
            // enumeration and the per-user probe.
            Effect.catchTag("NoSuchEntityException", () => Effect.undefined),
          ),
        { concurrency: 10 },
      );
      const result: LoginProfile["Attributes"][] = profiles.filter(
        (profile): profile is NonNullable<typeof profile> => profile !== undefined,
      );
      return result;
    }),
  });