import * as Cloudflare from "@alchemy.run/cloudflare";
import { expect } from "@alchemy.run/test";
import * as Test from "@alchemy.run/test/Alchemy";
import * as ddos from "@distilled.cloud/cloudflare/ddos-protection";
import * as Provider from "alchemy/Provider";
import * as Effect from "effect/Effect";
import { MinimumLogLevel } from "effect/References";
const { test } = Test.make({ providers: Cloudflare.providers() });
const logLevel = Effect.provideService(MinimumLogLevel, process.env.DEBUG ? "Debug" : "Info");
// Advanced TCP Protection is a Magic Transit (Enterprise add-on)
// entitlement that the testing account does not have — every API call fails
// with the typed `AdvancedTcpProtectionNotEntitled` error (Cloudflare code
// 8888; asserted in AllowlistEntry.test.ts). The lifecycle suite is gated
// behind an opt-in env var for entitled accounts.
const magicTransit = process.env.CLOUDFLARE_TEST_MAGIC_TRANSIT;
const accountId = Effect.gen(function* () {
const { accountId } = yield* yield* Cloudflare.CloudflareEnvironment;
return accountId;
});
test.provider.skipIf(!magicTransit)(
"creates a global TCP flow protection rule, updates it in place, and destroys",
(stack) =>
Effect.gen(function* () {
const acct = yield* accountId;
yield* stack.destroy();
// Create.
const rule = yield* stack.deploy(
Effect.gen(function* () {
return yield* Cloudflare.DdosProtection.TcpFlowProtectionRule("Rule", {
scope: "global",
mode: "monitoring",
burstSensitivity: "medium",
rateSensitivity: "medium",
});
}),
);
expect(rule.scope).toEqual("global");
expect(rule.name).toEqual("global");
expect(rule.mode).toEqual("monitoring");
// Out-of-band verification via the distilled API.
const live = yield* ddos.getAdvancedTcpProtectionTcpFlowProtectionRuleItem({
accountId: acct,
ruleId: rule.ruleId,
});
expect(live.mode).toEqual("monitoring");
expect(live.rateSensitivity).toEqual("medium");
// In-place update — mode and sensitivities are patched, id is stable.
const updated = yield* stack.deploy(
Effect.gen(function* () {
return yield* Cloudflare.DdosProtection.TcpFlowProtectionRule("Rule", {
scope: "global",
mode: "disabled",
burstSensitivity: "low",
rateSensitivity: "high",
});
}),
);
expect(updated.ruleId).toEqual(rule.ruleId);
expect(updated.mode).toEqual("disabled");
expect(updated.burstSensitivity).toEqual("low");
expect(updated.rateSensitivity).toEqual("high");
yield* stack.destroy();
// Gone — the typed TcpFlowProtectionRuleNotFound error proves deletion.
const error = yield* ddos
.getAdvancedTcpProtectionTcpFlowProtectionRuleItem({ accountId: acct, ruleId: rule.ruleId })
.pipe(Effect.flip);
expect(error._tag).toEqual("TcpFlowProtectionRuleNotFound");
}).pipe(logLevel),
{ tags: ["provider:cloudflare", "provider:cloudflare:ddosprotection", "live"], timeout: 120_000 },
);
// Account-scoped collection `list()` (pattern (b)): enumerate every TCP flow
// protection rule under the ambient account. On accounts without the Magic
// Transit / Advanced TCP Protection entitlement the enumeration API rejects
// with the typed `AdvancedTcpProtectionNotEntitled` error (Cloudflare code
// 8888), which `list()` maps to a well-typed empty array — assert that here,
// ungated.
test.provider(
"list returns a well-typed empty array without Magic Transit",
(stack) =>
Effect.gen(function* () {
if (magicTransit) return;
yield* stack.destroy();
const provider = yield* Provider.findProvider(
Cloudflare.DdosProtection.TcpFlowProtectionRule,
);
const all = yield* provider.list();
expect(Array.isArray(all)).toBe(true);
expect(all).toEqual([]);
yield* stack.destroy();
}).pipe(logLevel),
{ tags: ["provider:cloudflare", "provider:cloudflare:ddosprotection", "live"] },
);
// Entitled accounts (CLOUDFLARE_TEST_MAGIC_TRANSIT set): deploy a rule and
// assert it appears in the exhaustively-paginated `list()` result, carrying
// the exact `read` Attributes shape.
test.provider.skipIf(!magicTransit)(
"list enumerates the deployed TCP flow protection rule",
(stack) =>
Effect.gen(function* () {
yield* stack.destroy();
const deployed = yield* stack.deploy(
Effect.gen(function* () {
return yield* Cloudflare.DdosProtection.TcpFlowProtectionRule("ListRule", {
scope: "global",
mode: "monitoring",
burstSensitivity: "medium",
rateSensitivity: "medium",
});
}),
);
const provider = yield* Provider.findProvider(
Cloudflare.DdosProtection.TcpFlowProtectionRule,
);
const all = yield* provider.list();
expect(all.some((x) => x.ruleId === deployed.ruleId)).toBe(true);
const found = all.find((x) => x.ruleId === deployed.ruleId)!;
expect(found.scope).toEqual("global");
expect(found.name).toEqual("global");
yield* stack.destroy();
}).pipe(logLevel),
{ tags: ["provider:cloudflare", "provider:cloudflare:ddosprotection", "live"], timeout: 120_000 },
);