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

main
ts 297 lines 11.9 KB
Raw
1 import * as KinesisAnalyticsV2 from "@alchemy.run/aws/KinesisAnalyticsV2";
2 import * as Lambda from "@alchemy.run/aws/Lambda";
3 import * as Duration from "effect/Duration";
4 import * as Effect from "effect/Effect";
5 import { HttpServerRequest } from "effect/http/HttpServerRequest";
6 import * as HttpServerResponse from "effect/http/HttpServerResponse";
7 import * as Layer from "effect/Layer";
8 import path from "pathe";
9
10 const main = path.resolve(import.meta.dirname, "handler.ts");
11
12 /**
13 * Deterministic out-of-band code bucket, provisioned by the test's
14 * `beforeAll` (see code-bucket.ts) BEFORE the stack deploys — the service
15 * reads the code object at application-create time.
16 */
17 export const FIXTURE_CODE_BUCKET = "alchemy-test-kav2-bindings-code";
18 /** Must match `codeKey` in code-bucket.ts. */
19 const FIXTURE_CODE_KEY = "code/app.zip";
20
21 export class KinesisAnalyticsV2TestFunction extends Lambda.Function<Lambda.Function>()(
22 "KinesisAnalyticsV2TestFunction",
23 ) {}
24
25 /**
26 * Every route answers `{ …fields }` on success or `{ errorTag }` when the
27 * operation fails with a TYPED error — the test asserts the tag is a typed,
28 * non-authorization tag, which proves both the binding wiring and the IAM
29 * grant. An untyped error crashes into a 500 instead.
30 */
31 const errorTagged = <A, E extends { _tag: string }, R>(
32 effect: Effect.Effect<A, E, R>,
33 ): Effect.Effect<A | { errorTag: string }, never, R> =>
34 effect.pipe(
35 Effect.map((a): A | { errorTag: string } => a),
36 Effect.catch((e) => Effect.succeed({ errorTag: e._tag })),
37 );
38
39 export default KinesisAnalyticsV2TestFunction.make(
40 {
41 main,
42 functionUrl: true,
43 // Application probes fan out SDK calls — AWS's 3s default intermittently
44 // times out under cold starts.
45 timeout: Duration.seconds(30),
46 },
47 Effect.gen(function* () {
48 // The application never starts (the staged zip is a placeholder, not a
49 // real Flink jar) — it stays READY, so every route below either reads
50 // harmlessly or drives a typed service-side rejection.
51 const app = yield* KinesisAnalyticsV2.Application("BindingsApp", {
52 runtimeEnvironment: "FLINK-1_20",
53 code: {
54 bucketArn: `arn:aws:s3:::${FIXTURE_CODE_BUCKET}`,
55 fileKey: FIXTURE_CODE_KEY,
56 },
57 snapshotsEnabled: true,
58 });
59
60 const describeApplication = yield* KinesisAnalyticsV2.DescribeApplication(app);
61 const describeApplicationVersion = yield* KinesisAnalyticsV2.DescribeApplicationVersion(app);
62 const listApplicationVersions = yield* KinesisAnalyticsV2.ListApplicationVersions(app);
63 const describeApplicationOperation =
64 yield* KinesisAnalyticsV2.DescribeApplicationOperation(app);
65 const listApplicationOperations = yield* KinesisAnalyticsV2.ListApplicationOperations(app);
66 const startApplication = yield* KinesisAnalyticsV2.StartApplication(app);
67 const stopApplication = yield* KinesisAnalyticsV2.StopApplication(app);
68 const rollbackApplication = yield* KinesisAnalyticsV2.RollbackApplication(app);
69 const createApplicationSnapshot = yield* KinesisAnalyticsV2.CreateApplicationSnapshot(app);
70 const describeApplicationSnapshot = yield* KinesisAnalyticsV2.DescribeApplicationSnapshot(app);
71 const listApplicationSnapshots = yield* KinesisAnalyticsV2.ListApplicationSnapshots(app);
72 const deleteApplicationSnapshot = yield* KinesisAnalyticsV2.DeleteApplicationSnapshot(app);
73 const createApplicationPresignedUrl =
74 yield* KinesisAnalyticsV2.CreateApplicationPresignedUrl(app);
75 // Account-level binding — takes no resource argument.
76 const listApplications = yield* KinesisAnalyticsV2.ListApplications();
77
78 const bound = {
79 describeApplication,
80 describeApplicationVersion,
81 listApplicationVersions,
82 describeApplicationOperation,
83 listApplicationOperations,
84 startApplication,
85 stopApplication,
86 rollbackApplication,
87 createApplicationSnapshot,
88 describeApplicationSnapshot,
89 listApplicationSnapshots,
90 deleteApplicationSnapshot,
91 createApplicationPresignedUrl,
92 listApplications,
93 };
94
95 return {
96 fetch: Effect.gen(function* () {
97 const request = yield* HttpServerRequest;
98 const url = new URL(request.originalUrl);
99 const route = `${request.method} ${url.pathname}`;
100
101 switch (route) {
102 case "GET /bindings":
103 return yield* HttpServerResponse.json({
104 bound: Object.keys(bound),
105 });
106
107 case "GET /describe": {
108 const result = yield* errorTagged(describeApplication());
109 return yield* HttpServerResponse.json(
110 "errorTag" in result
111 ? result
112 : {
113 status: result.ApplicationDetail.ApplicationStatus,
114 runtime: result.ApplicationDetail.RuntimeEnvironment,
115 name: result.ApplicationDetail.ApplicationName,
116 },
117 );
118 }
119
120 case "GET /applications": {
121 // Self-verifying: the account list must contain the bound
122 // application (looked up by name via the describe binding).
123 const result = yield* errorTagged(
124 Effect.gen(function* () {
125 const { ApplicationDetail } = yield* describeApplication();
126 const listed = yield* listApplications({ Limit: 50 });
127 return {
128 count: (listed.ApplicationSummaries ?? []).length,
129 containsSelf: (listed.ApplicationSummaries ?? []).some(
130 (summary) => summary.ApplicationName === ApplicationDetail.ApplicationName,
131 ),
132 };
133 }),
134 );
135 return yield* HttpServerResponse.json(result);
136 }
137
138 case "GET /versions": {
139 const result = yield* errorTagged(listApplicationVersions());
140 return yield* HttpServerResponse.json(
141 "errorTag" in result
142 ? result
143 : { count: (result.ApplicationVersionSummaries ?? []).length },
144 );
145 }
146
147 case "GET /version": {
148 const result = yield* errorTagged(
149 describeApplicationVersion({ ApplicationVersionId: 1 }),
150 );
151 return yield* HttpServerResponse.json(
152 "errorTag" in result
153 ? result
154 : {
155 versionId: result.ApplicationVersionDetail?.ApplicationVersionId,
156 },
157 );
158 }
159
160 case "GET /operations": {
161 const result = yield* errorTagged(listApplicationOperations());
162 return yield* HttpServerResponse.json(
163 "errorTag" in result
164 ? result
165 : { count: (result.ApplicationOperationInfoList ?? []).length },
166 );
167 }
168
169 case "GET /operation": {
170 // A well-formed-but-nonexistent operation id — an IAM gap would
171 // surface AccessDeniedException (an opaque 500) instead of the
172 // typed rejection.
173 const result = yield* errorTagged(
174 describeApplicationOperation({
175 OperationId: "aaaaaaaaaaaaaaaaaaaaaaaaaa",
176 }),
177 );
178 return yield* HttpServerResponse.json("errorTag" in result ? result : { ok: true });
179 }
180
181 case "GET /snapshots": {
182 const result = yield* errorTagged(listApplicationSnapshots());
183 return yield* HttpServerResponse.json(
184 "errorTag" in result ? result : { count: (result.SnapshotSummaries ?? []).length },
185 );
186 }
187
188 case "GET /snapshot": {
189 const result = yield* errorTagged(
190 describeApplicationSnapshot({ SnapshotName: "does-not-exist" }),
191 );
192 return yield* HttpServerResponse.json("errorTag" in result ? result : { ok: true });
193 }
194
195 case "POST /snapshot/create": {
196 // The application is READY (not RUNNING) — the service rejects
197 // the snapshot with a typed error, proving the grant without
198 // mutating anything.
199 const result = yield* errorTagged(
200 createApplicationSnapshot({ SnapshotName: "bindings-probe" }),
201 );
202 return yield* HttpServerResponse.json("errorTag" in result ? result : { ok: true });
203 }
204
205 case "POST /snapshot/delete": {
206 const result = yield* errorTagged(
207 deleteApplicationSnapshot({
208 SnapshotName: "does-not-exist",
209 SnapshotCreationTimestamp: new Date(0),
210 }),
211 );
212 return yield* HttpServerResponse.json("errorTag" in result ? result : { ok: true });
213 }
214
215 case "GET /presigned-url": {
216 const result = yield* errorTagged(
217 createApplicationPresignedUrl({
218 UrlType: "FLINK_DASHBOARD_URL",
219 SessionExpirationDurationInSeconds: 1800,
220 }),
221 );
222 return yield* HttpServerResponse.json(
223 "errorTag" in result ? result : { hasUrl: typeof result.AuthorizedUrl === "string" },
224 );
225 }
226
227 case "POST /rollback": {
228 // A READY application has nothing to roll back — typed rejection
229 // proves the grant.
230 const result = yield* errorTagged(
231 Effect.gen(function* () {
232 const { ApplicationDetail } = yield* describeApplication();
233 return yield* rollbackApplication({
234 CurrentApplicationVersionId: ApplicationDetail.ApplicationVersionId,
235 });
236 }),
237 );
238 return yield* HttpServerResponse.json("errorTag" in result ? result : { ok: true });
239 }
240
241 case "POST /stop": {
242 // Force-stopping a READY application is a typed no-op rejection.
243 const result = yield* errorTagged(stopApplication({ Force: true }));
244 return yield* HttpServerResponse.json("errorTag" in result ? result : { ok: true });
245 }
246
247 case "POST /start": {
248 // Restoring from a nonexistent custom snapshot rejects before
249 // the placeholder zip ever runs. If the service accepts the
250 // start anyway, force-stop immediately so the fixture returns
251 // to READY for teardown.
252 const result = yield* errorTagged(
253 startApplication({
254 RunConfiguration: {
255 ApplicationRestoreConfiguration: {
256 ApplicationRestoreType: "RESTORE_FROM_CUSTOM_SNAPSHOT",
257 SnapshotName: "does-not-exist",
258 },
259 },
260 }),
261 );
262 if ("errorTag" in result) {
263 return yield* HttpServerResponse.json(result);
264 }
265 yield* errorTagged(stopApplication({ Force: true }));
266 return yield* HttpServerResponse.json({
267 started: true,
268 stopped: true,
269 });
270 }
271
272 default:
273 return yield* HttpServerResponse.json({ error: "Not found", route }, { status: 404 });
274 }
275 }).pipe(Effect.orDie),
276 };
277 }).pipe(
278 Effect.provide(
279 Layer.mergeAll(
280 KinesisAnalyticsV2.DescribeApplicationHttp,
281 KinesisAnalyticsV2.DescribeApplicationVersionHttp,
282 KinesisAnalyticsV2.ListApplicationVersionsHttp,
283 KinesisAnalyticsV2.DescribeApplicationOperationHttp,
284 KinesisAnalyticsV2.ListApplicationOperationsHttp,
285 KinesisAnalyticsV2.StartApplicationHttp,
286 KinesisAnalyticsV2.StopApplicationHttp,
287 KinesisAnalyticsV2.RollbackApplicationHttp,
288 KinesisAnalyticsV2.CreateApplicationSnapshotHttp,
289 KinesisAnalyticsV2.DescribeApplicationSnapshotHttp,
290 KinesisAnalyticsV2.ListApplicationSnapshotsHttp,
291 KinesisAnalyticsV2.DeleteApplicationSnapshotHttp,
292 KinesisAnalyticsV2.CreateApplicationPresignedUrlHttp,
293 KinesisAnalyticsV2.ListApplicationsHttp,
294 ),
295 ),
296 ),
297 );