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

main
ts 198 lines 7.16 KB
Raw
1 import * as appconfig from "@distilled.cloud/aws/appconfig";
2 import { Unowned } from "alchemy/AdoptPolicy";
3 import { isResolved } from "alchemy/Diff";
4 import { createPhysicalName } from "alchemy/PhysicalName";
5 import * as Provider from "alchemy/Provider";
6 import { Resource } from "alchemy/Resource";
7 import { createInternalTags, hasAlchemyTags } from "alchemy/Tags";
8 import * as Effect from "effect/Effect";
9 import * as Schedule from "effect/Schedule";
10 import * as Stream from "effect/Stream";
11 import { AWSEnvironment } from "../Environment.ts";
12 import type { Providers } from "../Providers.ts";
13 import { applicationArn, readAppConfigTags, syncAppConfigTags } from "./internal.ts";
14
15 export interface ApplicationProps {
16 /**
17 * Name of the application. Must be 1-64 characters. If omitted, a
18 * deterministic physical name is generated. Changing the name replaces the
19 * application.
20 */
21 applicationName?: string;
22 /**
23 * Description of the application.
24 */
25 description?: string;
26 /**
27 * User-defined tags for the application.
28 */
29 tags?: Record<string, string>;
30 }
31
32 export interface Application extends Resource<
33 "AWS.AppConfig.Application",
34 ApplicationProps,
35 {
36 applicationId: string;
37 applicationName: string;
38 applicationArn: string;
39 },
40 never,
41 Providers
42 > {}
43
44 /**
45 * An AWS AppConfig application — the top-level container that groups the
46 * environments and configuration profiles for one application's configuration.
47 *
48 * ### Creating an Application
49 * **Example:** Basic Application
50 * ```typescript
51 * const app = yield* AppConfig.Application("MyApp", {
52 * description: "Configuration for my service",
53 * });
54 * ```
55 *
56 * **Example:** Named Application with Tags
57 * ```typescript
58 * const app = yield* AppConfig.Application("MyApp", {
59 * applicationName: "my-service",
60 * tags: { team: "platform" },
61 * });
62 * ```
63 *
64 * @resource
65 */
66 export const Application = Resource<Application>("AWS.AppConfig.Application");
67
68 export const ApplicationProvider = () =>
69 Provider.effect(
70 Application,
71 Effect.gen(function* () {
72 const toName = (id: string, props: Partial<ApplicationProps>) =>
73 props.applicationName
74 ? Effect.succeed(props.applicationName)
75 : createPhysicalName({ id, maxLength: 64 });
76
77 /** Find an application by name (get requires the generated id). */
78 const findByName = Effect.fn(function* (name: string) {
79 const apps = yield* appconfig.listApplications.pages({}).pipe(
80 Stream.runCollect,
81 Effect.map((chunk) => Array.from(chunk).flatMap((page) => page.Items ?? [])),
82 );
83 return apps.find((a) => a.Name === name);
84 });
85
86 const readApplication = Effect.fn(function* (applicationId: string) {
87 return yield* appconfig
88 .getApplication({ ApplicationId: applicationId })
89 .pipe(Effect.catchTag("ResourceNotFoundException", () => Effect.undefined));
90 });
91
92 return {
93 stables: ["applicationId", "applicationName", "applicationArn"],
94
95 diff: Effect.fn(function* ({ id, olds, news }) {
96 if (!isResolved(news)) return undefined;
97 if ((yield* toName(id, olds ?? {})) !== (yield* toName(id, news ?? {}))) {
98 return { action: "replace" } as const;
99 }
100 }),
101
102 read: Effect.fn(function* ({ id, olds, output }) {
103 const { accountId, region } = yield* AWSEnvironment.current;
104 const app = output?.applicationId
105 ? yield* readApplication(output.applicationId)
106 : yield* findByName(yield* toName(id, olds ?? {}));
107 if (app?.Id === undefined) return undefined;
108 const arn = applicationArn(region, accountId, app.Id);
109 const attrs = {
110 applicationId: app.Id,
111 applicationName: app.Name!,
112 applicationArn: arn,
113 };
114 const tags = yield* readAppConfigTags(arn);
115 return (yield* hasAlchemyTags(id, tags)) ? attrs : Unowned(attrs);
116 }),
117
118 reconcile: Effect.fn(function* ({ id, news, output, session }) {
119 const { accountId, region } = yield* AWSEnvironment.current;
120 const name = output?.applicationName ?? (yield* toName(id, news));
121 const internalTags = yield* createInternalTags(id);
122 const desiredTags = { ...internalTags, ...news.tags };
123
124 // 1. Observe — cloud state is authoritative; output is only a cache.
125 let observed = output?.applicationId
126 ? yield* readApplication(output.applicationId)
127 : undefined;
128 if (observed === undefined) {
129 observed = yield* findByName(name);
130 }
131
132 // 2. Ensure — create if missing.
133 if (observed?.Id === undefined) {
134 observed = yield* appconfig.createApplication({
135 Name: name,
136 Description: news.description,
137 Tags: desiredTags,
138 });
139 } else if (news.description !== undefined && observed.Description !== news.description) {
140 // 3. Sync — description is mutable in place.
141 observed = yield* appconfig.updateApplication({
142 ApplicationId: observed.Id,
143 Description: news.description,
144 });
145 }
146
147 const arn = applicationArn(region, accountId, observed.Id!);
148
149 // 3b. Sync tags — diff against OBSERVED cloud tags.
150 yield* syncAppConfigTags(arn, desiredTags);
151
152 yield* session.note(name);
153 return {
154 applicationId: observed.Id!,
155 applicationName: observed.Name ?? name,
156 applicationArn: arn,
157 };
158 }),
159
160 delete: Effect.fn(function* ({ output }) {
161 // An application cannot be deleted while environments or
162 // configuration profiles still exist under it ("Cannot delete
163 // application ..., because there are still environments existing
164 // under it" — surfaced as BadRequestException). Children are
165 // deleted first by the engine/nuke, but their deletion is
166 // eventually consistent, so absorb the window with a bounded retry.
167 yield* appconfig.deleteApplication({ ApplicationId: output.applicationId }).pipe(
168 Effect.retry({
169 while: (e): boolean => e._tag === "BadRequestException",
170 schedule: Schedule.fixed("3 seconds"),
171 times: 5,
172 }),
173 Effect.catchTag("ResourceNotFoundException", () => Effect.void),
174 );
175 }),
176
177 list: () =>
178 Effect.gen(function* () {
179 const { accountId, region } = yield* AWSEnvironment.current;
180 const apps = yield* appconfig.listApplications.pages({}).pipe(
181 Stream.runCollect,
182 Effect.map((chunk) => Array.from(chunk).flatMap((page) => page.Items ?? [])),
183 );
184 return apps.flatMap((a) =>
185 a.Id !== undefined && a.Name !== undefined
186 ? [
187 {
188 applicationId: a.Id,
189 applicationName: a.Name,
190 applicationArn: applicationArn(region, accountId, a.Id),
191 },
192 ]
193 : [],
194 );
195 }),
196 };
197 }),
198 );