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,
});