import type * as WAFV2 from "@distilled.cloud/aws/wafv2";
import * as wafv2 from "@distilled.cloud/aws/wafv2";
import { Unowned } from "alchemy/AdoptPolicy";
import { deepEqual, isResolved } from "alchemy/Diff";
import { createPhysicalName } from "alchemy/PhysicalName";
import * as Provider from "alchemy/Provider";
import { Resource } from "alchemy/Resource";
import { createInternalTags, createTagsList, hasAlchemyTags } from "alchemy/Tags";
import * as Data from "effect/Data";
import * as Effect from "effect/Effect";
import { plainJson } from "../internal/Observe.ts";
import type { Providers } from "../Providers.ts";
import {
fetchWafTags,
normalizeWafRules,
retryAssociatedItem,
retryOptimisticLock,
retryUnavailableEntity,
syncWafTags,
type WafScope,
withWafScope,
} from "./internal.ts";
export class WebACLUnexpectedResponse extends Data.TaggedError("WebACLUnexpectedResponse")<{
readonly message: string;
readonly cause?: unknown;
}> {}
export interface WebACLProps {
/**
* Name of the web ACL. Must match `^[\w\-]+
.repos/alchemy-effect/packages/aws/src/WAFv2/WebACL.ts at main · sailfork/t3code-github · Sailfork
and be 1-128 characters.
* Changing the name replaces the web ACL.
* @default a physical name derived from the app, stage and logical ID
*/
webAclName?: string;
/**
* Scope of the web ACL. `REGIONAL` protects regional resources (ALB,
* API Gateway, AppSync, Cognito user pool, App Runner, Verified Access)
* in the ambient region; `CLOUDFRONT` protects CloudFront distributions
* and is always provisioned in `us-east-1` (the provider pins the region
* automatically). Changing the scope replaces the web ACL.
* @default "REGIONAL"
*/
scope?: WafScope;
/**
* Action to take on a request that matches none of the rules.
* @default { Allow: {} }
*/
defaultAction?: WAFV2.DefaultAction;
/**
* Description of the web ACL.
*/
description?: string;
/**
* Rules to evaluate, in `Priority` order. Supports custom statements
* (byte match, rate-based, geo, IP set references, ...) and managed rule
* groups (e.g. `AWSManagedRulesCommonRuleSet`). Raw WAFv2 API shapes.
*/
rules?: WAFV2.Rule[];
/**
* CloudWatch metrics and sampled-request settings for the web ACL itself.
* @default sampled requests + metrics enabled, MetricName = the web ACL name
*/
visibilityConfig?: WAFV2.VisibilityConfig;
/**
* Custom response bodies referenced by rule actions in this web ACL.
*/
customResponseBodies?: {
[key: string]: WAFV2.CustomResponseBody | undefined;
};
/**
* Default CAPTCHA immunity-time configuration.
*/
captchaConfig?: WAFV2.CaptchaConfig;
/**
* Default challenge immunity-time configuration.
*/
challengeConfig?: WAFV2.ChallengeConfig;
/**
* Domains that WAF accepts for CAPTCHA/challenge tokens.
*/
tokenDomains?: string[];
/**
* Association-level configuration (e.g. request body size limits).
*/
associationConfig?: WAFV2.AssociationConfig;
/**
* User-defined tags to apply to the web ACL.
*/
tags?: Record<string, string>;
}
export interface WebACL extends Resource<
"AWS.WAFv2.WebACL",
WebACLProps,
{
/**
* Name of the web ACL.
*/
webAclName: string;
/**
* WAF-assigned unique ID of the web ACL.
*/
webAclId: string;
/**
* ARN of the web ACL. Use this to associate regional resources
* (via {@link WebACLAssociation}) or as CloudFront's `webAclId`.
*/
webAclArn: string;
/**
* Scope the web ACL was created in.
*/
scope: WafScope;
/**
* The rules, default action, visibility settings, the optional aspects
* the props declare (custom responses, CAPTCHA/challenge, association
* config) and the tags, as observed. Lets `alchemy drift` detect
* out-of-band changes.
*/
configuration?: {
defaultAction?: unknown;
description?: string;
rules: unknown[];
visibilityConfig?: unknown;
tokenDomains?: string[];
customResponseBodies?: unknown;
captchaConfig?: unknown;
challengeConfig?: unknown;
associationConfig?: unknown;
tags: Record<string, string>;
};
},
never,
Providers
> {}
/**
* An AWS WAFv2 Web ACL — a collection of rules that inspect and control web
* requests for the AWS resources it is associated with.
*
* `REGIONAL` web ACLs protect regional resources (Application Load Balancer,
* API Gateway, AppSync, Cognito user pools, App Runner, Verified Access) via
* {@link WebACLAssociation}. `CLOUDFRONT` web ACLs protect CloudFront
* distributions (set `Distribution.webAclId` to the web ACL's ARN) and are
* always provisioned in `us-east-1` — the provider pins the region for you.
*
* ### Creating Web ACLs
* **Example:** Allow-by-Default Web ACL with a Managed Rule Group
* ```typescript
* const acl = yield* AWS.WAFv2.WebACL("ApiFirewall", {
* rules: [
* {
* Name: "common-rule-set",
* Priority: 0,
* Statement: {
* ManagedRuleGroupStatement: {
* VendorName: "AWS",
* Name: "AWSManagedRulesCommonRuleSet",
* },
* },
* OverrideAction: { None: {} },
* VisibilityConfig: {
* SampledRequestsEnabled: true,
* CloudWatchMetricsEnabled: true,
* MetricName: "common-rule-set",
* },
* },
* ],
* });
* ```
*
* **Example:** Rate Limiting Requests per IP
* ```typescript
* const acl = yield* AWS.WAFv2.WebACL("RateLimited", {
* defaultAction: { Allow: {} },
* rules: [
* {
* Name: "rate-limit",
* Priority: 0,
* Statement: {
* RateBasedStatement: { Limit: 100, AggregateKeyType: "IP" },
* },
* Action: { Block: {} },
* VisibilityConfig: {
* SampledRequestsEnabled: true,
* CloudWatchMetricsEnabled: true,
* MetricName: "rate-limit",
* },
* },
* ],
* });
* ```
*
* ### CloudFront Scope
* **Example:** Web ACL for a CloudFront Distribution
* ```typescript
* const acl = yield* AWS.WAFv2.WebACL("EdgeFirewall", {
* scope: "CLOUDFRONT", // provisioned in us-east-1 automatically
* defaultAction: { Allow: {} },
* });
*
* const distribution = yield* AWS.CloudFront.Distribution("Site", {
* // ...
* webAclId: acl.webAclArn,
* });
* ```
*
* ### Protecting Regional Resources
* **Example:** Associate with a Cognito User Pool
* ```typescript
* const association = yield* AWS.WAFv2.WebACLAssociation("PoolFirewall", {
* webAclArn: acl.webAclArn,
* resourceArn: userPool.userPoolArn,
* });
* ```
*
* @resource
*/
export const WebACL = Resource<WebACL>("AWS.WAFv2.WebACL");
const defaultScope: WafScope = "REGIONAL";
const defaultVisibilityConfig = (name: string): WAFV2.VisibilityConfig => ({
SampledRequestsEnabled: true,
CloudWatchMetricsEnabled: true,
MetricName: name,
});
const toAttrs = (acl: WAFV2.WebACL, scope: WafScope) => ({
webAclName: acl.Name,
webAclId: acl.Id,
webAclArn: acl.ARN,
scope,
});
/**
* The configuration `read` and `reconcile` both report, so a converged web
* ACL reads unchanged. Aspects WAF fills with defaults are observed only
* when the props declare them, matching what reconcile converges.
*/
const observeWebACLConfiguration = (
acl: WAFV2.WebACL,
props: WebACLProps | undefined,
tags: Record<string, string>,
) =>
plainJson({
defaultAction: acl.DefaultAction,
description: acl.Description || undefined,
rules: acl.Rules ?? [],
visibilityConfig: acl.VisibilityConfig,
tokenDomains: acl.TokenDomains?.length ? acl.TokenDomains : undefined,
customResponseBodies:
props?.customResponseBodies === undefined ? undefined : acl.CustomResponseBodies,
captchaConfig: props?.captchaConfig === undefined ? undefined : acl.CaptchaConfig,
challengeConfig: props?.challengeConfig === undefined ? undefined : acl.ChallengeConfig,
associationConfig: props?.associationConfig === undefined ? undefined : acl.AssociationConfig,
tags,
});
export const WebACLProvider = () =>
Provider.effect(
WebACL,
Effect.gen(function* () {
const createName = Effect.fn(function* (id: string, props: WebACLProps) {
return props.webAclName ?? (yield* createPhysicalName({ id, maxLength: 128 }));
});
// Resolve a web ACL to its full detail + LockToken. Prefers the
// cached Id (fast path); falls back to searching list pages by name.
const findWebACL = Effect.fn(function* (
scope: WafScope,
name: string,
cachedId: string | undefined,
) {
if (cachedId !== undefined) {
const byId = yield* withWafScope(
scope,
wafv2
.getWebACL({ Name: name, Scope: scope, Id: cachedId })
.pipe(Effect.catchTag("WAFNonexistentItemException", () => Effect.undefined)),
);
if (byId?.WebACL) {
return byId;
}
}
let marker: string | undefined;
for (let page = 0; page < 20; page++) {
const listed = yield* withWafScope(
scope,
wafv2.listWebACLs({ Scope: scope, NextMarker: marker, Limit: 100 }),
);
const summary = listed.WebACLs?.find((s) => s.Name === name);
if (summary?.Id !== undefined) {
return yield* withWafScope(
scope,
wafv2
.getWebACL({ Name: name, Scope: scope, Id: summary.Id })
.pipe(Effect.catchTag("WAFNonexistentItemException", () => Effect.undefined)),
);
}
if (!listed.NextMarker || (listed.WebACLs?.length ?? 0) === 0) {
break;
}
marker = listed.NextMarker;
}
return undefined;
});
const buildDesired = (name: string, props: WebACLProps) => ({
DefaultAction: props.defaultAction ?? { Allow: {} },
Description: props.description,
// props survive engine serialization as plain JSON — restore
// ByteMatchStatement SearchString blobs to Uint8Array
Rules: normalizeWafRules(props.rules),
VisibilityConfig: props.visibilityConfig ?? defaultVisibilityConfig(name),
CustomResponseBodies: props.customResponseBodies,
CaptchaConfig: props.captchaConfig,
ChallengeConfig: props.challengeConfig,
TokenDomains: props.tokenDomains,
AssociationConfig: props.associationConfig,
});
const listScope = Effect.fn(function* (scope: WafScope) {
const rows: ReturnType<typeof toAttrs>[] = [];
let marker: string | undefined;
for (let page = 0; page < 50; page++) {
const listed = yield* withWafScope(
scope,
wafv2.listWebACLs({ Scope: scope, NextMarker: marker, Limit: 100 }),
);
for (const summary of listed.WebACLs ?? []) {
if (summary.Name && summary.Id && summary.ARN) {
rows.push({
webAclName: summary.Name,
webAclId: summary.Id,
webAclArn: summary.ARN,
scope,
});
}
}
if (!listed.NextMarker || (listed.WebACLs?.length ?? 0) === 0) {
break;
}
marker = listed.NextMarker;
}
return rows;
});
return {
stables: ["webAclName", "webAclId", "webAclArn", "scope"],
list: () =>
Effect.gen(function* () {
const regional = yield* listScope("REGIONAL");
const cloudfront = yield* listScope("CLOUDFRONT");
return [...regional, ...cloudfront];
}),
diff: Effect.fn(function* ({ id, news, olds }) {
if (!isResolved(news)) return undefined;
const oldName = yield* createName(id, olds ?? {});
const newName = yield* createName(id, news);
if (oldName !== newName) {
return { action: "replace" } as const;
}
if ((olds?.scope ?? defaultScope) !== (news.scope ?? defaultScope)) {
return { action: "replace" } as const;
}
}),
read: Effect.fn(function* ({ id, olds, output }) {
const scope = output?.scope ?? olds?.scope ?? defaultScope;
const name = output?.webAclName ?? (yield* createName(id, olds ?? {}));
const found = yield* findWebACL(scope, name, output?.webAclId);
if (!found?.WebACL) {
return undefined;
}
const tags = yield* fetchWafTags(scope, found.WebACL.ARN);
const attrs = {
...toAttrs(found.WebACL, scope),
configuration: observeWebACLConfiguration(found.WebACL, olds, tags),
};
return (yield* hasAlchemyTags(id, tags)) ? attrs : Unowned(attrs);
}),
reconcile: Effect.fn(function* ({ id, news, output, session }) {
const scope = news.scope ?? defaultScope;
const name = output?.webAclName ?? (yield* createName(id, news));
const internalTags = yield* createInternalTags(id);
const desiredTags = { ...news.tags, ...internalTags };
const desired = buildDesired(name, news);
// 1. Observe — cloud state is authoritative; output only caches Id.
let observed = yield* findWebACL(scope, name, output?.webAclId);
// 2. Ensure — create if missing; a WAFDuplicateItemException is a
// race with a concurrent creator, so fall through to re-read.
if (!observed?.WebACL) {
yield* retryUnavailableEntity(
withWafScope(
scope,
wafv2
.createWebACL({
Name: name,
Scope: scope,
...desired,
Tags: createTagsList(desiredTags),
})
.pipe(Effect.catchTag("WAFDuplicateItemException", () => Effect.undefined)),
),
);
observed = yield* findWebACL(scope, name, undefined);
}
if (!observed?.WebACL) {
return yield* new WebACLUnexpectedResponse({
message: `Failed to observe WebACL '${name}' after create`,
});
}
const acl = observed.WebACL;
yield* session.note(acl.ARN);
// 3. Sync — diff the OBSERVED mutable aspects against desired and
// apply a single updateWebACL when drifted. The update re-reads
// the LockToken inside the retry so optimistic-lock conflicts
// converge.
const observedAspects: Record<string, unknown> = {
DefaultAction: acl.DefaultAction,
Description: acl.Description,
Rules: acl.Rules ?? [],
VisibilityConfig: acl.VisibilityConfig,
TokenDomains: acl.TokenDomains,
};
const desiredAspects: Record<string, unknown> = {
DefaultAction: desired.DefaultAction,
Description: desired.Description,
Rules: desired.Rules,
VisibilityConfig: desired.VisibilityConfig,
TokenDomains: desired.TokenDomains,
};
// WAF materializes defaults for aspects the user never set (e.g.
// CaptchaConfig immunity time), so only compare the optional
// aspects the user actually declared.
if (news.customResponseBodies !== undefined) {
observedAspects.CustomResponseBodies = acl.CustomResponseBodies;
desiredAspects.CustomResponseBodies = desired.CustomResponseBodies;
}
if (news.captchaConfig !== undefined) {
observedAspects.CaptchaConfig = acl.CaptchaConfig;
desiredAspects.CaptchaConfig = desired.CaptchaConfig;
}
if (news.challengeConfig !== undefined) {
observedAspects.ChallengeConfig = acl.ChallengeConfig;
desiredAspects.ChallengeConfig = desired.ChallengeConfig;
}
if (news.associationConfig !== undefined) {
observedAspects.AssociationConfig = acl.AssociationConfig;
desiredAspects.AssociationConfig = desired.AssociationConfig;
}
if (!deepEqual(observedAspects, desiredAspects, { stripNullish: true })) {
yield* retryOptimisticLock(
Effect.gen(function* () {
const fresh = yield* findWebACL(scope, name, acl.Id);
if (!fresh?.WebACL || fresh.LockToken === undefined) {
return;
}
yield* retryUnavailableEntity(
withWafScope(
scope,
wafv2.updateWebACL({
Name: name,
Scope: scope,
Id: fresh.WebACL.Id,
LockToken: fresh.LockToken,
...desired,
}),
),
);
}),
);
}
// 3b. Sync tags against OBSERVED cloud tags.
yield* syncWafTags(scope, acl.ARN, desiredTags);
// 4. Return fresh attributes.
const final = yield* findWebACL(scope, name, acl.Id);
return {
...toAttrs(acl, scope),
configuration: observeWebACLConfiguration(final?.WebACL ?? acl, news, desiredTags),
};
}),
delete: Effect.fn(function* ({ output }) {
const scope = output.scope;
// Re-read for a fresh LockToken on every attempt; tolerate the
// ACL already being gone, a stale lock, or a still-propagating
// disassociation.
yield* Effect.gen(function* () {
const found = yield* withWafScope(
scope,
wafv2
.getWebACL({
Name: output.webAclName,
Scope: scope,
Id: output.webAclId,
})
.pipe(Effect.catchTag("WAFNonexistentItemException", () => Effect.undefined)),
);
if (!found?.WebACL || found.LockToken === undefined) {
return;
}
yield* withWafScope(
scope,
wafv2
.deleteWebACL({
Name: output.webAclName,
Scope: scope,
Id: output.webAclId,
LockToken: found.LockToken,
})
.pipe(Effect.catchTag("WAFNonexistentItemException", () => Effect.void)),
);
}).pipe(retryOptimisticLock, retryAssociatedItem);
}),
};
}),
);
.repos/alchemy-effect/packages/aws/src/WAFv2/WebACL.ts at main · sailfork/t3code-github · Sailfork
and be 1-128 characters.\n * Changing the name replaces the web ACL.\n * @default a physical name derived from the app, stage and logical ID\n */\n webAclName?: string;\n /**\n * Scope of the web ACL. `REGIONAL` protects regional resources (ALB,\n * API Gateway, AppSync, Cognito user pool, App Runner, Verified Access)\n * in the ambient region; `CLOUDFRONT` protects CloudFront distributions\n * and is always provisioned in `us-east-1` (the provider pins the region\n * automatically). Changing the scope replaces the web ACL.\n * @default \"REGIONAL\"\n */\n scope?: WafScope;\n /**\n * Action to take on a request that matches none of the rules.\n * @default { Allow: {} }\n */\n defaultAction?: WAFV2.DefaultAction;\n /**\n * Description of the web ACL.\n */\n description?: string;\n /**\n * Rules to evaluate, in `Priority` order. Supports custom statements\n * (byte match, rate-based, geo, IP set references, ...) and managed rule\n * groups (e.g. `AWSManagedRulesCommonRuleSet`). Raw WAFv2 API shapes.\n */\n rules?: WAFV2.Rule[];\n /**\n * CloudWatch metrics and sampled-request settings for the web ACL itself.\n * @default sampled requests + metrics enabled, MetricName = the web ACL name\n */\n visibilityConfig?: WAFV2.VisibilityConfig;\n /**\n * Custom response bodies referenced by rule actions in this web ACL.\n */\n customResponseBodies?: {\n [key: string]: WAFV2.CustomResponseBody | undefined;\n };\n /**\n * Default CAPTCHA immunity-time configuration.\n */\n captchaConfig?: WAFV2.CaptchaConfig;\n /**\n * Default challenge immunity-time configuration.\n */\n challengeConfig?: WAFV2.ChallengeConfig;\n /**\n * Domains that WAF accepts for CAPTCHA/challenge tokens.\n */\n tokenDomains?: string[];\n /**\n * Association-level configuration (e.g. request body size limits).\n */\n associationConfig?: WAFV2.AssociationConfig;\n /**\n * User-defined tags to apply to the web ACL.\n */\n tags?: Record\u003cstring, string>;\n}\n\nexport interface WebACL extends Resource\u003c\n \"AWS.WAFv2.WebACL\",\n WebACLProps,\n {\n /**\n * Name of the web ACL.\n */\n webAclName: string;\n /**\n * WAF-assigned unique ID of the web ACL.\n */\n webAclId: string;\n /**\n * ARN of the web ACL. Use this to associate regional resources\n * (via {@link WebACLAssociation}) or as CloudFront's `webAclId`.\n */\n webAclArn: string;\n /**\n * Scope the web ACL was created in.\n */\n scope: WafScope;\n /**\n * The rules, default action, visibility settings, the optional aspects\n * the props declare (custom responses, CAPTCHA/challenge, association\n * config) and the tags, as observed. Lets `alchemy drift` detect\n * out-of-band changes.\n */\n configuration?: {\n defaultAction?: unknown;\n description?: string;\n rules: unknown[];\n visibilityConfig?: unknown;\n tokenDomains?: string[];\n customResponseBodies?: unknown;\n captchaConfig?: unknown;\n challengeConfig?: unknown;\n associationConfig?: unknown;\n tags: Record\u003cstring, string>;\n };\n },\n never,\n Providers\n> {}\n\n/**\n * An AWS WAFv2 Web ACL — a collection of rules that inspect and control web\n * requests for the AWS resources it is associated with.\n *\n * `REGIONAL` web ACLs protect regional resources (Application Load Balancer,\n * API Gateway, AppSync, Cognito user pools, App Runner, Verified Access) via\n * {@link WebACLAssociation}. `CLOUDFRONT` web ACLs protect CloudFront\n * distributions (set `Distribution.webAclId` to the web ACL's ARN) and are\n * always provisioned in `us-east-1` — the provider pins the region for you.\n *\n * ### Creating Web ACLs\n * **Example:** Allow-by-Default Web ACL with a Managed Rule Group\n * ```typescript\n * const acl = yield* AWS.WAFv2.WebACL(\"ApiFirewall\", {\n * rules: [\n * {\n * Name: \"common-rule-set\",\n * Priority: 0,\n * Statement: {\n * ManagedRuleGroupStatement: {\n * VendorName: \"AWS\",\n * Name: \"AWSManagedRulesCommonRuleSet\",\n * },\n * },\n * OverrideAction: { None: {} },\n * VisibilityConfig: {\n * SampledRequestsEnabled: true,\n * CloudWatchMetricsEnabled: true,\n * MetricName: \"common-rule-set\",\n * },\n * },\n * ],\n * });\n * ```\n *\n * **Example:** Rate Limiting Requests per IP\n * ```typescript\n * const acl = yield* AWS.WAFv2.WebACL(\"RateLimited\", {\n * defaultAction: { Allow: {} },\n * rules: [\n * {\n * Name: \"rate-limit\",\n * Priority: 0,\n * Statement: {\n * RateBasedStatement: { Limit: 100, AggregateKeyType: \"IP\" },\n * },\n * Action: { Block: {} },\n * VisibilityConfig: {\n * SampledRequestsEnabled: true,\n * CloudWatchMetricsEnabled: true,\n * MetricName: \"rate-limit\",\n * },\n * },\n * ],\n * });\n * ```\n *\n * ### CloudFront Scope\n * **Example:** Web ACL for a CloudFront Distribution\n * ```typescript\n * const acl = yield* AWS.WAFv2.WebACL(\"EdgeFirewall\", {\n * scope: \"CLOUDFRONT\", // provisioned in us-east-1 automatically\n * defaultAction: { Allow: {} },\n * });\n *\n * const distribution = yield* AWS.CloudFront.Distribution(\"Site\", {\n * // ...\n * webAclId: acl.webAclArn,\n * });\n * ```\n *\n * ### Protecting Regional Resources\n * **Example:** Associate with a Cognito User Pool\n * ```typescript\n * const association = yield* AWS.WAFv2.WebACLAssociation(\"PoolFirewall\", {\n * webAclArn: acl.webAclArn,\n * resourceArn: userPool.userPoolArn,\n * });\n * ```\n *\n * @resource\n */\nexport const WebACL = Resource\u003cWebACL>(\"AWS.WAFv2.WebACL\");\n\nconst defaultScope: WafScope = \"REGIONAL\";\n\nconst defaultVisibilityConfig = (name: string): WAFV2.VisibilityConfig => ({\n SampledRequestsEnabled: true,\n CloudWatchMetricsEnabled: true,\n MetricName: name,\n});\n\nconst toAttrs = (acl: WAFV2.WebACL, scope: WafScope) => ({\n webAclName: acl.Name,\n webAclId: acl.Id,\n webAclArn: acl.ARN,\n scope,\n});\n\n/**\n * The configuration `read` and `reconcile` both report, so a converged web\n * ACL reads unchanged. Aspects WAF fills with defaults are observed only\n * when the props declare them, matching what reconcile converges.\n */\nconst observeWebACLConfiguration = (\n acl: WAFV2.WebACL,\n props: WebACLProps | undefined,\n tags: Record\u003cstring, string>,\n) =>\n plainJson({\n defaultAction: acl.DefaultAction,\n description: acl.Description || undefined,\n rules: acl.Rules ?? [],\n visibilityConfig: acl.VisibilityConfig,\n tokenDomains: acl.TokenDomains?.length ? acl.TokenDomains : undefined,\n customResponseBodies:\n props?.customResponseBodies === undefined ? undefined : acl.CustomResponseBodies,\n captchaConfig: props?.captchaConfig === undefined ? undefined : acl.CaptchaConfig,\n challengeConfig: props?.challengeConfig === undefined ? undefined : acl.ChallengeConfig,\n associationConfig: props?.associationConfig === undefined ? undefined : acl.AssociationConfig,\n tags,\n });\n\nexport const WebACLProvider = () =>\n Provider.effect(\n WebACL,\n Effect.gen(function* () {\n const createName = Effect.fn(function* (id: string, props: WebACLProps) {\n return props.webAclName ?? (yield* createPhysicalName({ id, maxLength: 128 }));\n });\n\n // Resolve a web ACL to its full detail + LockToken. Prefers the\n // cached Id (fast path); falls back to searching list pages by name.\n const findWebACL = Effect.fn(function* (\n scope: WafScope,\n name: string,\n cachedId: string | undefined,\n ) {\n if (cachedId !== undefined) {\n const byId = yield* withWafScope(\n scope,\n wafv2\n .getWebACL({ Name: name, Scope: scope, Id: cachedId })\n .pipe(Effect.catchTag(\"WAFNonexistentItemException\", () => Effect.undefined)),\n );\n if (byId?.WebACL) {\n return byId;\n }\n }\n let marker: string | undefined;\n for (let page = 0; page \u003c 20; page++) {\n const listed = yield* withWafScope(\n scope,\n wafv2.listWebACLs({ Scope: scope, NextMarker: marker, Limit: 100 }),\n );\n const summary = listed.WebACLs?.find((s) => s.Name === name);\n if (summary?.Id !== undefined) {\n return yield* withWafScope(\n scope,\n wafv2\n .getWebACL({ Name: name, Scope: scope, Id: summary.Id })\n .pipe(Effect.catchTag(\"WAFNonexistentItemException\", () => Effect.undefined)),\n );\n }\n if (!listed.NextMarker || (listed.WebACLs?.length ?? 0) === 0) {\n break;\n }\n marker = listed.NextMarker;\n }\n return undefined;\n });\n\n const buildDesired = (name: string, props: WebACLProps) => ({\n DefaultAction: props.defaultAction ?? { Allow: {} },\n Description: props.description,\n // props survive engine serialization as plain JSON — restore\n // ByteMatchStatement SearchString blobs to Uint8Array\n Rules: normalizeWafRules(props.rules),\n VisibilityConfig: props.visibilityConfig ?? defaultVisibilityConfig(name),\n CustomResponseBodies: props.customResponseBodies,\n CaptchaConfig: props.captchaConfig,\n ChallengeConfig: props.challengeConfig,\n TokenDomains: props.tokenDomains,\n AssociationConfig: props.associationConfig,\n });\n\n const listScope = Effect.fn(function* (scope: WafScope) {\n const rows: ReturnType\u003ctypeof toAttrs>[] = [];\n let marker: string | undefined;\n for (let page = 0; page \u003c 50; page++) {\n const listed = yield* withWafScope(\n scope,\n wafv2.listWebACLs({ Scope: scope, NextMarker: marker, Limit: 100 }),\n );\n for (const summary of listed.WebACLs ?? []) {\n if (summary.Name && summary.Id && summary.ARN) {\n rows.push({\n webAclName: summary.Name,\n webAclId: summary.Id,\n webAclArn: summary.ARN,\n scope,\n });\n }\n }\n if (!listed.NextMarker || (listed.WebACLs?.length ?? 0) === 0) {\n break;\n }\n marker = listed.NextMarker;\n }\n return rows;\n });\n\n return {\n stables: [\"webAclName\", \"webAclId\", \"webAclArn\", \"scope\"],\n\n list: () =>\n Effect.gen(function* () {\n const regional = yield* listScope(\"REGIONAL\");\n const cloudfront = yield* listScope(\"CLOUDFRONT\");\n return [...regional, ...cloudfront];\n }),\n\n diff: Effect.fn(function* ({ id, news, olds }) {\n if (!isResolved(news)) return undefined;\n const oldName = yield* createName(id, olds ?? {});\n const newName = yield* createName(id, news);\n if (oldName !== newName) {\n return { action: \"replace\" } as const;\n }\n if ((olds?.scope ?? defaultScope) !== (news.scope ?? defaultScope)) {\n return { action: \"replace\" } as const;\n }\n }),\n\n read: Effect.fn(function* ({ id, olds, output }) {\n const scope = output?.scope ?? olds?.scope ?? defaultScope;\n const name = output?.webAclName ?? (yield* createName(id, olds ?? {}));\n const found = yield* findWebACL(scope, name, output?.webAclId);\n if (!found?.WebACL) {\n return undefined;\n }\n const tags = yield* fetchWafTags(scope, found.WebACL.ARN);\n const attrs = {\n ...toAttrs(found.WebACL, scope),\n configuration: observeWebACLConfiguration(found.WebACL, olds, tags),\n };\n return (yield* hasAlchemyTags(id, tags)) ? attrs : Unowned(attrs);\n }),\n\n reconcile: Effect.fn(function* ({ id, news, output, session }) {\n const scope = news.scope ?? defaultScope;\n const name = output?.webAclName ?? (yield* createName(id, news));\n const internalTags = yield* createInternalTags(id);\n const desiredTags = { ...news.tags, ...internalTags };\n const desired = buildDesired(name, news);\n\n // 1. Observe — cloud state is authoritative; output only caches Id.\n let observed = yield* findWebACL(scope, name, output?.webAclId);\n\n // 2. Ensure — create if missing; a WAFDuplicateItemException is a\n // race with a concurrent creator, so fall through to re-read.\n if (!observed?.WebACL) {\n yield* retryUnavailableEntity(\n withWafScope(\n scope,\n wafv2\n .createWebACL({\n Name: name,\n Scope: scope,\n ...desired,\n Tags: createTagsList(desiredTags),\n })\n .pipe(Effect.catchTag(\"WAFDuplicateItemException\", () => Effect.undefined)),\n ),\n );\n observed = yield* findWebACL(scope, name, undefined);\n }\n\n if (!observed?.WebACL) {\n return yield* new WebACLUnexpectedResponse({\n message: `Failed to observe WebACL '${name}' after create`,\n });\n }\n\n const acl = observed.WebACL;\n yield* session.note(acl.ARN);\n\n // 3. Sync — diff the OBSERVED mutable aspects against desired and\n // apply a single updateWebACL when drifted. The update re-reads\n // the LockToken inside the retry so optimistic-lock conflicts\n // converge.\n const observedAspects: Record\u003cstring, unknown> = {\n DefaultAction: acl.DefaultAction,\n Description: acl.Description,\n Rules: acl.Rules ?? [],\n VisibilityConfig: acl.VisibilityConfig,\n TokenDomains: acl.TokenDomains,\n };\n const desiredAspects: Record\u003cstring, unknown> = {\n DefaultAction: desired.DefaultAction,\n Description: desired.Description,\n Rules: desired.Rules,\n VisibilityConfig: desired.VisibilityConfig,\n TokenDomains: desired.TokenDomains,\n };\n // WAF materializes defaults for aspects the user never set (e.g.\n // CaptchaConfig immunity time), so only compare the optional\n // aspects the user actually declared.\n if (news.customResponseBodies !== undefined) {\n observedAspects.CustomResponseBodies = acl.CustomResponseBodies;\n desiredAspects.CustomResponseBodies = desired.CustomResponseBodies;\n }\n if (news.captchaConfig !== undefined) {\n observedAspects.CaptchaConfig = acl.CaptchaConfig;\n desiredAspects.CaptchaConfig = desired.CaptchaConfig;\n }\n if (news.challengeConfig !== undefined) {\n observedAspects.ChallengeConfig = acl.ChallengeConfig;\n desiredAspects.ChallengeConfig = desired.ChallengeConfig;\n }\n if (news.associationConfig !== undefined) {\n observedAspects.AssociationConfig = acl.AssociationConfig;\n desiredAspects.AssociationConfig = desired.AssociationConfig;\n }\n if (!deepEqual(observedAspects, desiredAspects, { stripNullish: true })) {\n yield* retryOptimisticLock(\n Effect.gen(function* () {\n const fresh = yield* findWebACL(scope, name, acl.Id);\n if (!fresh?.WebACL || fresh.LockToken === undefined) {\n return;\n }\n yield* retryUnavailableEntity(\n withWafScope(\n scope,\n wafv2.updateWebACL({\n Name: name,\n Scope: scope,\n Id: fresh.WebACL.Id,\n LockToken: fresh.LockToken,\n ...desired,\n }),\n ),\n );\n }),\n );\n }\n\n // 3b. Sync tags against OBSERVED cloud tags.\n yield* syncWafTags(scope, acl.ARN, desiredTags);\n\n // 4. Return fresh attributes.\n const final = yield* findWebACL(scope, name, acl.Id);\n return {\n ...toAttrs(acl, scope),\n configuration: observeWebACLConfiguration(final?.WebACL ?? acl, news, desiredTags),\n };\n }),\n\n delete: Effect.fn(function* ({ output }) {\n const scope = output.scope;\n // Re-read for a fresh LockToken on every attempt; tolerate the\n // ACL already being gone, a stale lock, or a still-propagating\n // disassociation.\n yield* Effect.gen(function* () {\n const found = yield* withWafScope(\n scope,\n wafv2\n .getWebACL({\n Name: output.webAclName,\n Scope: scope,\n Id: output.webAclId,\n })\n .pipe(Effect.catchTag(\"WAFNonexistentItemException\", () => Effect.undefined)),\n );\n if (!found?.WebACL || found.LockToken === undefined) {\n return;\n }\n yield* withWafScope(\n scope,\n wafv2\n .deleteWebACL({\n Name: output.webAclName,\n Scope: scope,\n Id: output.webAclId,\n LockToken: found.LockToken,\n })\n .pipe(Effect.catchTag(\"WAFNonexistentItemException\", () => Effect.void)),\n );\n }).pipe(retryOptimisticLock, retryAssociatedItem);\n }),\n };\n }),\n );\n","preview":null,"history":null,"version":"cb2410964cedb0b2d4bb1595b4118ad8b35f4cb3"},"/_session?shell=1":null}