sailfork / t3code-github / .repos/ alchemy-effect/ packages/ aws/ src/ CloudFront/ OriginAccessControl.ts

import * as cloudfront from "@distilled.cloud/aws/cloudfront";
import { isResolved } from "alchemy/Diff";
import { createPhysicalName } from "alchemy/PhysicalName";
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 Option from "effect/Option";
import * as Stream from "effect/Stream";
import type { Providers } from "../Providers.ts";

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

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

export interface OriginAccessControlProps {
  /**
   * Name of the origin access control. If omitted, a deterministic name is generated.
   */
  name?: string;
  /**
   * Optional description of the origin access control.
   */
  description?: string;
  /**
   * The origin type this OAC signs for.
   * @default "s3"
   */
  originType?: cloudfront.OriginAccessControlOriginTypes;
  /**
   * How CloudFront should apply signing.
   * @default "always"
   */
  signingBehavior?: cloudfront.OriginAccessControlSigningBehaviors;
  /**
   * Signing protocol used by CloudFront.
   * @default "sigv4"
   */
  signingProtocol?: cloudfront.OriginAccessControlSigningProtocols;
}

export interface OriginAccessControl extends Resource<
  "AWS.CloudFront.OriginAccessControl",
  OriginAccessControlProps,
  {
    /**
     * CloudFront-assigned OAC identifier.
     */
    originAccessControlId: string;
    /**
     * Name of the OAC.
     */
    name: string;
    /**
     * Current description of the OAC.
     */
    description: string | undefined;
    /**
     * Origin type configured for the OAC.
     */
    originType: cloudfront.OriginAccessControlOriginTypes;
    /**
     * Signing behavior configured for the OAC.
     */
    signingBehavior: cloudfront.OriginAccessControlSigningBehaviors;
    /**
     * Signing protocol configured for the OAC.
     */
    signingProtocol: cloudfront.OriginAccessControlSigningProtocols;
    /**
     * Most recent entity tag for update/delete operations.
     */
    etag: string | undefined;
  },
  never,
  Providers
> {}

/**
 * A CloudFront Origin Access Control for private origins.
 *
 * `OriginAccessControl` is the recommended CloudFront access model for private
 * S3 origins and newer signed-origin integrations.
 * ### Creating Origin Access Controls
 * **Example:** S3 Origin Access Control
 * ```typescript
 * const oac = yield* OriginAccessControl("SiteOriginAccess", {
 *   originType: "s3",
 * });
 * ```
 *
 * @resource
 */
export const OriginAccessControl = Resource<OriginAccessControl>(
  "AWS.CloudFront.OriginAccessControl",
);

export const OriginAccessControlProvider = () =>
  Provider.effect(
    OriginAccessControl,
    Effect.gen(function* () {
      const getByName = Effect.fn(function* (name: string) {
        const summary = yield* cloudfront.listOriginAccessControls.pages({}).pipe(
          Stream.map((page) => page.OriginAccessControlList?.Items ?? []),
          Stream.flattenIterable,
          Stream.filter((item) => item.Name === name),
          Stream.runHead,
          Effect.map(Option.getOrUndefined),
        );
        if (!summary?.Id) {
          return undefined;
        }
        const config = yield* cloudfront.getOriginAccessControlConfig({
          Id: summary.Id,
        });
        return {
          OriginAccessControl: {
            Id: summary.Id,
            OriginAccessControlConfig: config.OriginAccessControlConfig,
          },
          ETag: config.ETag,
        };
      });

      const getCurrent = Effect.fn(function* (
        output: OriginAccessControl["Attributes"] | undefined,
      ) {
        if (!output?.originAccessControlId) {
          return undefined;
        }
        const config = yield* cloudfront
          .getOriginAccessControlConfig({
            Id: output.originAccessControlId,
          })
          .pipe(Effect.catchTag("NoSuchOriginAccessControl", () => Effect.undefined));

        if (!config?.OriginAccessControlConfig) {
          return undefined;
        }

        return {
          OriginAccessControl: {
            Id: output.originAccessControlId,
            OriginAccessControlConfig: config.OriginAccessControlConfig,
          },
          ETag: config.ETag,
        };
      });

      return {
        stables: ["originAccessControlId"],
        list: () =>
          cloudfront.listOriginAccessControls.pages({}).pipe(
            Stream.map((page) => page.OriginAccessControlList?.Items ?? []),
            Stream.flattenIterable,
            Stream.filter((summary) => summary.Id !== undefined),
            Stream.mapEffect((summary) =>
              Effect.gen(function* () {
                // Fetch per-item config for the fresh ETag (the list summary
                // omits it). Tolerate a concurrent delete between list and get.
                const config = yield* cloudfront
                  .getOriginAccessControlConfig({ Id: summary.Id! })
                  .pipe(Effect.catchTag("NoSuchOriginAccessControl", () => Effect.undefined));
                return toAttrs(
                  {
                    Id: summary.Id!,
                    OriginAccessControlConfig: config?.OriginAccessControlConfig ?? {
                      Name: summary.Name,
                      Description: summary.Description,
                      OriginAccessControlOriginType: summary.OriginAccessControlOriginType,
                      SigningBehavior: summary.SigningBehavior,
                      SigningProtocol: summary.SigningProtocol,
                    },
                  },
                  config?.ETag,
                  summary.Name,
                );
              }),
            ),
            Stream.runCollect,
            Effect.map((chunk) => Array.from(chunk)),
          ),
        diff: Effect.fn(function* ({ id, olds, news: _news }) {
          if (!isResolved(_news)) return undefined;
          const news = _news as typeof olds;
          if ((yield* createName(id, olds ?? {})) !== (yield* createName(id, news))) {
            return { action: "replace" } as const;
          }
        }),
        read: Effect.fn(function* ({ id, olds, output }) {
          const existing =
            (yield* getCurrent(output)) ?? (yield* getByName(yield* createName(id, olds ?? {})));

          if (!existing?.OriginAccessControl?.Id) {
            return undefined;
          }

          return toAttrs(
            existing.OriginAccessControl,
            existing.ETag,
            yield* createName(id, olds ?? {}),
          );
        }),
        reconcile: Effect.fn(function* ({ id, news, output, session }) {
          const name = yield* createName(id, news);

          // Observe — locate the OAC by id (cached on `output`) or by
          // name. Trust observed cloud state, not stale `olds`.
          const observed = (yield* getCurrent(output)) ?? (yield* getByName(name));

          // Ensure — create the OAC if it's missing. Tolerate
          // `OriginAccessControlAlreadyExists` (race with a peer
          // reconciler).
          if (!observed?.OriginAccessControl?.Id) {
            const created = yield* cloudfront
              .createOriginAccessControl({
                OriginAccessControlConfig: {
                  Name: name,
                  Description: news.description,
                  OriginAccessControlOriginType: news.originType ?? "s3",
                  SigningBehavior: news.signingBehavior ?? "always",
                  SigningProtocol: news.signingProtocol ?? "sigv4",
                },
              })
              .pipe(
                Effect.catchTag("OriginAccessControlAlreadyExists", () =>
                  getByName(name).pipe(
                    Effect.flatMap((existing) =>
                      existing
                        ? Effect.succeed(existing)
                        : Effect.fail(
                            new OriginAccessControlConflict({
                              message: `Origin access control '${name}' already exists but could not be recovered`,
                            }),
                          ),
                    ),
                  ),
                ),
              );

            if (!created.OriginAccessControl?.Id) {
              return yield* new OriginAccessControlUnexpectedResponse({
                message: "createOriginAccessControl returned no identifier",
              });
            }

            yield* session.note(created.OriginAccessControl.Id);
            return toAttrs(created.OriginAccessControl, created.ETag, name);
          }

          // Sync — patch the observed config to the desired state. The
          // freshly observed ETag handles optimistic concurrency.
          const observedConfig = observed.OriginAccessControl.OriginAccessControlConfig;
          const updated = yield* cloudfront.updateOriginAccessControl({
            Id: observed.OriginAccessControl.Id,
            IfMatch: observed.ETag,
            OriginAccessControlConfig: {
              Name: observedConfig?.Name ?? name,
              Description: news.description,
              OriginAccessControlOriginType:
                news.originType ?? observedConfig?.OriginAccessControlOriginType ?? "s3",
              SigningBehavior: news.signingBehavior ?? observedConfig?.SigningBehavior ?? "always",
              SigningProtocol: news.signingProtocol ?? observedConfig?.SigningProtocol ?? "sigv4",
            },
          });

          if (!updated.OriginAccessControl?.Id) {
            return yield* new OriginAccessControlUnexpectedResponse({
              message: "updateOriginAccessControl returned no identifier",
            });
          }

          yield* session.note(observed.OriginAccessControl.Id);
          return toAttrs(updated.OriginAccessControl, updated.ETag, observedConfig?.Name ?? name);
        }),
        delete: Effect.fn(function* ({ output }) {
          yield* cloudfront
            .deleteOriginAccessControl({
              Id: output.originAccessControlId,
              IfMatch: output.etag,
            })
            .pipe(Effect.catchTag("NoSuchOriginAccessControl", () => Effect.void));
        }),
      };
    }),
  );

const createName = (id: string, props: OriginAccessControlProps) =>
  props.name
    ? Effect.succeed(props.name)
    : createPhysicalName({
        id,
        maxLength: 64,
        lowercase: true,
      });

const toAttrs = (
  oac: cloudfront.OriginAccessControl,
  etag: string | undefined,
  fallbackName: string,
) => ({
  originAccessControlId: oac.Id,
  name: oac.OriginAccessControlConfig?.Name ?? fallbackName,
  description: oac.OriginAccessControlConfig?.Description,
  originType: oac.OriginAccessControlConfig?.OriginAccessControlOriginType ?? "s3",
  signingBehavior: oac.OriginAccessControlConfig?.SigningBehavior ?? "always",
  signingProtocol: oac.OriginAccessControlConfig?.SigningProtocol ?? "sigv4",
  etag,
});