sailfork / t3code-github / .repos/ alchemy-effect/ packages/ aws/ src/ Organizations/ TrustedServiceAccess.ts

import * as organizations from "@distilled.cloud/aws/organizations";
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 type { Providers } from "../Providers.ts";
import { collectPages, retryOrganizations } from "./common.ts";

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

export interface TrustedServiceAccessProps {
  /**
   * Service principal granted trusted access to the organization.
   */
  servicePrincipal: string;
}

export interface TrustedServiceAccess extends Resource<
  "AWS.Organizations.TrustedServiceAccess",
  TrustedServiceAccessProps,
  {
    /**
     * Service principal granted trusted access.
     */
    servicePrincipal: string;
    /**
     * When trusted access was enabled.
     */
    dateEnabled: Date | undefined;
  },
  never,
  Providers
> {}

/**
 * Enables trusted access for an AWS service principal, allowing that service
 * to operate across all accounts in the organization.
 *
 * Typically paired with a {@link DelegatedAdministrator} that hands day-to-day
 * administration of the service to a member account. Existence-only resource:
 * changing `servicePrincipal` replaces it.
 * ### Enabling Trusted Access
 * **Example:** Enable IAM Identity Center
 * ```typescript
 * yield* TrustedServiceAccess("SsoTrustedAccess", {
 *   servicePrincipal: "sso.amazonaws.com",
 * });
 * ```
 *
 * **Example:** Trusted Access Plus a Delegated Administrator
 * ```typescript
 * const guardDutyAccess = yield* TrustedServiceAccess("GuardDutyAccess", {
 *   servicePrincipal: "guardduty.amazonaws.com",
 * });
 *
 * yield* DelegatedAdministrator("GuardDutyAdmin", {
 *   accountId: securityAccount.accountId,
 *   servicePrincipal: guardDutyAccess.servicePrincipal,
 * });
 * ```
 *
 * @resource
 */
export const TrustedServiceAccess = Resource<TrustedServiceAccess>(
  "AWS.Organizations.TrustedServiceAccess",
);

export const TrustedServiceAccessProvider = () =>
  Provider.effect(
    TrustedServiceAccess,
    Effect.gen(function* () {
      return {
        stables: ["servicePrincipal"],
        diff: Effect.fn(function* ({ olds, news }) {
          if (!isResolved(news)) return;
          if (olds?.servicePrincipal !== news.servicePrincipal) {
            return { action: "replace" } as const;
          }
        }),
        read: Effect.fn(function* ({ olds, output }) {
          const servicePrincipal = output?.servicePrincipal ?? olds?.servicePrincipal;
          if (servicePrincipal === undefined) {
            // Output-valued props don't survive a `creating`-state round-trip
            // (they deserialize as `undefined`) — report "not found" so the
            // engine re-drives the create.
            return undefined;
          }
          return yield* readTrustedServiceAccess(servicePrincipal);
        }),
        list: () =>
          Effect.gen(function* () {
            // Enumerate every service principal granted trusted access to the
            // organization. The list response already carries the full `read`
            // shape (servicePrincipal + dateEnabled), so each enabled principal
            // maps directly to one Attributes — no per-item hydration needed.
            const principals = yield* retryOrganizations(
              collectPages(
                (NextToken) =>
                  organizations.listAWSServiceAccessForOrganization({
                    NextToken,
                  }),
                (page) => page.EnabledServicePrincipals,
              ),
            );

            return principals
              .filter(
                (
                  candidate,
                ): candidate is organizations.EnabledServicePrincipal & {
                  ServicePrincipal: string;
                } => candidate.ServicePrincipal != null,
              )
              .map(
                (candidate) =>
                  ({
                    servicePrincipal: candidate.ServicePrincipal,
                    dateEnabled: candidate.DateEnabled,
                  }) satisfies TrustedServiceAccess["Attributes"],
              );
          }).pipe(
            // Not an org management account (or lacking access) — there's no
            // organization to enumerate, so degrade to an empty list.
            Effect.catchTags({
              AWSOrganizationsNotInUseException: () =>
                Effect.succeed([] as TrustedServiceAccess["Attributes"][]),
              AccessDeniedException: () =>
                Effect.succeed([] as TrustedServiceAccess["Attributes"][]),
            }),
          ),
        reconcile: Effect.fn(function* ({ news, session }) {
          // Observe — fetch live trusted-access state. We never trust prior
          // `output` blindly; if access was disabled out-of-band we re-enable.
          let state = yield* readTrustedServiceAccess(news.servicePrincipal);

          // Ensure — enable trusted access if it's missing. This API is
          // effectively idempotent for already-enabled principals, but we
          // gate the call to avoid unnecessary churn.
          if (!state) {
            yield* retryOrganizations(
              organizations.enableAWSServiceAccess({
                ServicePrincipal: news.servicePrincipal,
              }),
            );
            state = yield* readTrustedServiceAccess(news.servicePrincipal);
            if (!state) {
              return yield* new TrustedServiceAccessUnexpectedResponse({
                message: `trusted service access '${news.servicePrincipal}' not found after create`,
              });
            }
          }

          yield* session.note(state.servicePrincipal);
          return state;
        }),
        delete: Effect.fn(function* ({ output }) {
          if (!(yield* readTrustedServiceAccess(output.servicePrincipal))) {
            return;
          }

          yield* retryOrganizations(
            organizations.disableAWSServiceAccess({
              ServicePrincipal: output.servicePrincipal,
            }),
          );
        }),
      };
    }),
  );

const readTrustedServiceAccess = Effect.fn(function* (servicePrincipal: string) {
  const principals = yield* retryOrganizations(
    collectPages(
      (NextToken) => organizations.listAWSServiceAccessForOrganization({ NextToken }),
      (page) => page.EnabledServicePrincipals,
    ),
  );

  const match = principals.find((candidate) => candidate.ServicePrincipal === servicePrincipal);

  return match
    ? ({
        servicePrincipal,
        dateEnabled: match.DateEnabled,
      } satisfies TrustedServiceAccess["Attributes"])
    : undefined;
});