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

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

export interface AccountPasswordPolicyProps extends Omit<
  iam.UpdateAccountPasswordPolicyRequest,
  "MaxPasswordAge"
> {
  /**
   * Maximum password validity duration, e.g. `"90 days"` or
   * `Duration.days(90)`. Sent to IAM as whole days (a bare number is
   * milliseconds).
   */
  MaxPasswordAge?: Duration.Input;
}

export interface AccountPasswordPolicy extends Resource<
  "AWS.IAM.AccountPasswordPolicy",
  AccountPasswordPolicyProps,
  iam.PasswordPolicy,
  never,
  Providers
> {}

/**
 * The singleton IAM account password policy.
 *
 * `AccountPasswordPolicy` manages the account-wide password requirements that
 * apply to IAM users with console passwords.
 * ### Managing Password Rules
 * **Example:** Require Strong Passwords
 * ```typescript
 * const policy = yield* AccountPasswordPolicy("PasswordPolicy", {
 *   MinimumPasswordLength: 16,
 *   RequireSymbols: true,
 *   RequireNumbers: true,
 *   RequireUppercaseCharacters: true,
 *   RequireLowercaseCharacters: true,
 *   AllowUsersToChangePassword: true,
 * });
 * ```
 *
 * @resource
 */
export const AccountPasswordPolicy = Resource<AccountPasswordPolicy>(
  "AWS.IAM.AccountPasswordPolicy",
);

export const AccountPasswordPolicyProvider = () =>
  Provider.succeed(AccountPasswordPolicy, {
    read: Effect.fn(function* () {
      const response = yield* iam
        .getAccountPasswordPolicy({})
        .pipe(Effect.catchTag("NoSuchEntityException", () => Effect.undefined));
      return response?.PasswordPolicy;
    }),
    // Account-level singleton: IAM exposes no enumeration API, only
    // `getAccountPasswordPolicy`. Return the single policy as a one-element
    // array, or `[]` when none is set (typed `NoSuchEntityException`).
    list: () =>
      iam.getAccountPasswordPolicy({}).pipe(
        Effect.map((response) => [response.PasswordPolicy]),
        Effect.catchTag("NoSuchEntityException", () => Effect.succeed([])),
      ),
    reconcile: Effect.fn(function* ({ news, session }) {
      // The account password policy is a singleton driven entirely by
      // `updateAccountPasswordPolicy`, which is itself a full upsert.
      // Observation is implicit in the API — there is nothing meaningful
      // to diff because the request payload *is* the desired state.
      const request = {
        ...news,
        MaxPasswordAge: toWireDays(news.MaxPasswordAge),
      };
      yield* iam.updateAccountPasswordPolicy(request);
      yield* session.note("account-password-policy");
      return request;
    }),
    delete: Effect.fn(function* () {
      yield* iam
        .deleteAccountPasswordPolicy({})
        .pipe(Effect.catchTag("NoSuchEntityException", () => Effect.void));
    }),
  });