The best way to control Claude Code, Codex and more from any computer or phone

main
ts 217 lines 8.08 KB
Raw
1 import * as Cloudflare from "@alchemy.run/cloudflare";
2 import { CloudflareEnvironment } from "@alchemy.run/cloudflare/CloudflareEnvironment";
3 import { findZoneByName } from "@alchemy.run/cloudflare/Zone/lookup";
4 import { expect } from "@alchemy.run/test";
5 import * as Test from "@alchemy.run/test/Alchemy";
6 import * as firewall from "@distilled.cloud/cloudflare/firewall";
7 import { adopt } from "alchemy/AdoptPolicy";
8 import * as Provider from "alchemy/Provider";
9 import * as Effect from "effect/Effect";
10 import { MinimumLogLevel } from "effect/References";
11 import * as Schedule from "effect/Schedule";
12 import * as Stream from "effect/Stream";
13
14 const { test } = Test.make({ providers: Cloudflare.providers() });
15
16 const logLevel = Effect.provideService(MinimumLogLevel, process.env.DEBUG ? "Debug" : "Info");
17
18 const zoneName = process.env.CLOUDFLARE_TEST_DNS_ZONE_NAME ?? "alchemy-test-2.us";
19
20 // Deterministic per-test User-Agent strings. A UA rule's User-Agent value
21 // is its identity within a zone (duplicates are rejected), so each test
22 // owns disjoint values and the same strings are reused on every run
23 // (never Date.now()/random).
24 const UA_LIFECYCLE_V1 = "AlchemyTestBot/1.0 (+https://alchemy.run)";
25 const UA_LIFECYCLE_V2 = "AlchemyTestBot/2.0 (+https://alchemy.run)";
26 const UA_LIST = "AlchemyListBot/1.0 (+https://alchemy.run)";
27
28 const resolveZoneId = Effect.gen(function* () {
29 const { accountId } = yield* yield* CloudflareEnvironment;
30 const zone = yield* findZoneByName({ accountId, name: zoneName });
31 if (!zone) {
32 return yield* Effect.die(new Error(`zone "${zoneName}" not found in account`));
33 }
34 return zone.id;
35 });
36
37 // The scoped API token the test harness mints propagates eventually-
38 // consistently across Cloudflare's edge — ride out 403 blips (`Forbidden`,
39 // declared in the distilled error union via patches) on the test's own
40 // out-of-band verification calls.
41 const forbiddenRetry = {
42 while: (e: { _tag: string }) => e._tag === "Forbidden",
43 schedule: Schedule.exponential("500 millis"),
44 times: 8,
45 } as const;
46
47 const getUaRule = (zoneId: string, uaRuleId: string) =>
48 firewall.getUaRule({ zoneId, uaRuleId }).pipe(Effect.retry(forbiddenRetry));
49
50 // List every rule matching one of the given User-Agent strings — used to
51 // purge leftovers from interrupted runs so each test starts from a clean
52 // slate (a leaked rule would surface as Unowned/duplicate because the
53 // User-Agent value is identity).
54 const listByUserAgents = (zoneId: string, userAgents: string[]) =>
55 firewall.listUaRules.items({ zoneId }).pipe(
56 Stream.filter((r) => userAgents.includes(r.configuration?.value ?? "")),
57 Stream.runCollect,
58 Effect.map((chunk) => Array.from(chunk)),
59 Effect.retry(forbiddenRetry),
60 );
61
62 const purgeUaRules = (zoneId: string, userAgents: string[]) =>
63 listByUserAgents(zoneId, userAgents).pipe(
64 Effect.flatMap(
65 Effect.forEach((r) =>
66 firewall.deleteUaRule({ zoneId, uaRuleId: r.id ?? "" }).pipe(
67 Effect.retry(forbiddenRetry),
68 Effect.catchTag("UaRuleNotFound", () => Effect.void),
69 ),
70 ),
71 ),
72 );
73
74 // Poll until the rule is gone — a missing rule surfaces as the typed
75 // `UaRuleNotFound` (Cloudflare code 10001, firewalluablock.api.not_found).
76 const expectUaRuleGone = (zoneId: string, uaRuleId: string) =>
77 getUaRule(zoneId, uaRuleId).pipe(
78 Effect.flatMap(() => Effect.fail({ _tag: "UaRuleNotDeleted" } as const)),
79 Effect.catchTag("UaRuleNotFound", () => Effect.void),
80 Effect.retry({
81 while: (e) => e._tag === "UaRuleNotDeleted",
82 schedule: Schedule.max([Schedule.exponential("500 millis"), Schedule.recurs(10)]),
83 }),
84 );
85
86 test.provider(
87 "create, update mode/paused/description/userAgent in place, destroy",
88 (stack) =>
89 Effect.gen(function* () {
90 const zoneId = yield* resolveZoneId;
91
92 yield* stack.destroy();
93 yield* purgeUaRules(zoneId, [UA_LIFECYCLE_V1, UA_LIFECYCLE_V2]);
94
95 const initial = yield* stack.deploy(
96 Effect.gen(function* () {
97 return yield* Cloudflare.Firewall.UaRule("LifecycleUaRule", {
98 zoneId,
99 userAgent: UA_LIFECYCLE_V1,
100 mode: "block",
101 description: "alchemy ua rule test (v1)",
102 }).pipe(adopt(true));
103 }),
104 );
105
106 expect(initial.uaRuleId).toBeDefined();
107 expect(initial.zoneId).toEqual(zoneId);
108 expect(initial.userAgent).toEqual(UA_LIFECYCLE_V1);
109 expect(initial.mode).toEqual("block");
110 expect(initial.description).toEqual("alchemy ua rule test (v1)");
111 expect(initial.paused).toEqual(false);
112
113 const live = yield* getUaRule(zoneId, initial.uaRuleId);
114 expect(live.id).toEqual(initial.uaRuleId);
115 expect(live.configuration?.value).toEqual(UA_LIFECYCLE_V1);
116 expect(live.mode).toEqual("block");
117
118 // Update every mutable aspect in one PUT: new User-Agent value, a
119 // softer mode, a new description, and pause the rule — all in place.
120 const updated = yield* stack.deploy(
121 Effect.gen(function* () {
122 return yield* Cloudflare.Firewall.UaRule("LifecycleUaRule", {
123 zoneId,
124 userAgent: UA_LIFECYCLE_V2,
125 mode: "managed_challenge",
126 description: "alchemy ua rule test (v2)",
127 paused: true,
128 }).pipe(adopt(true));
129 }),
130 );
131
132 // Same rule updated in place — not a replacement.
133 expect(updated.uaRuleId).toEqual(initial.uaRuleId);
134 expect(updated.userAgent).toEqual(UA_LIFECYCLE_V2);
135 expect(updated.mode).toEqual("managed_challenge");
136 expect(updated.description).toEqual("alchemy ua rule test (v2)");
137 expect(updated.paused).toEqual(true);
138
139 const liveUpdated = yield* getUaRule(zoneId, updated.uaRuleId);
140 expect(liveUpdated.configuration?.value).toEqual(UA_LIFECYCLE_V2);
141 expect(liveUpdated.mode).toEqual("managed_challenge");
142 expect(liveUpdated.description).toEqual("alchemy ua rule test (v2)");
143 expect(liveUpdated.paused).toEqual(true);
144
145 // Redeploying identical props is a no-op (still the same rule).
146 const noop = yield* stack.deploy(
147 Effect.gen(function* () {
148 return yield* Cloudflare.Firewall.UaRule("LifecycleUaRule", {
149 zoneId,
150 userAgent: UA_LIFECYCLE_V2,
151 mode: "managed_challenge",
152 description: "alchemy ua rule test (v2)",
153 paused: true,
154 }).pipe(adopt(true));
155 }),
156 );
157 expect(noop.uaRuleId).toEqual(initial.uaRuleId);
158
159 yield* stack.destroy();
160
161 yield* expectUaRuleGone(zoneId, initial.uaRuleId);
162 }).pipe(logLevel),
163 {
164 tags: [
165 "provider:cloudflare",
166 "provider:cloudflare:firewall",
167 "provider:cloudflare:zone",
168 "live",
169 ],
170 },
171 );
172
173 // Canonical `list()` test (zone-scoped collection): UA rules live inside a
174 // zone with no account-wide list, so `list()` enumerates every zone via
175 // `listAllZones` and exhaustively paginates each. Deploy one rule and assert
176 // it appears in the result, hydrated into the full `read` Attributes shape.
177 test.provider(
178 "list enumerates UA rules across all zones",
179 (stack) =>
180 Effect.gen(function* () {
181 const zoneId = yield* resolveZoneId;
182
183 yield* stack.destroy();
184 yield* purgeUaRules(zoneId, [UA_LIST]);
185
186 const deployed = yield* stack.deploy(
187 Effect.gen(function* () {
188 return yield* Cloudflare.Firewall.UaRule("ListUaRule", {
189 zoneId,
190 userAgent: UA_LIST,
191 mode: "block",
192 description: "alchemy ua rule list test",
193 }).pipe(adopt(true));
194 }),
195 );
196
197 const provider = yield* Provider.findProvider(Cloudflare.Firewall.UaRule);
198 const all = yield* provider.list();
199
200 const found = all.find((r) => r.uaRuleId === deployed.uaRuleId);
201 expect(found).toBeDefined();
202 expect(found?.zoneId).toEqual(zoneId);
203 expect(found?.userAgent).toEqual(UA_LIST);
204 expect(found?.mode).toEqual("block");
205
206 yield* stack.destroy();
207 yield* purgeUaRules(zoneId, [UA_LIST]);
208 }).pipe(logLevel),
209 {
210 tags: [
211 "provider:cloudflare",
212 "provider:cloudflare:firewall",
213 "provider:cloudflare:zone",
214 "live",
215 ],
216 },
217 );