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

main
ts 262 lines 8.82 KB
Raw
1 import * as logging from "@distilled.cloud/gcp/logging_v2";
2 import { Unowned } from "alchemy/AdoptPolicy";
3 import { isResolved } from "alchemy/Diff";
4 import * as Provider from "alchemy/Provider";
5 import { Resource } from "alchemy/Resource";
6 import * as Data from "effect/Data";
7 import * as Effect from "effect/Effect";
8 import * as Stream from "effect/Stream";
9 import { GcpEnvironment } from "../Environment.ts";
10 import type { Providers } from "../Providers.ts";
11 import {
12 createOwnership,
13 encodeDescription,
14 hasOwnershipMarker,
15 lastSegment,
16 ownedBy,
17 parseDescription,
18 parseLoggingName,
19 toPhysicalId,
20 } from "./internal.ts";
21
22 export type LocationsBucketsViewProps = {
23 /**
24 * Full resource name of the parent log bucket
25 * (`{parent}/locations/{location}/buckets/{bucket}`). Immutable —
26 * changing it replaces the view.
27 */
28 bucketName: string;
29 /**
30 * View id (the `{view}` segment of `{bucket}/views/{view}`). If omitted,
31 * a unique name is generated from the stack, stage, and logical id.
32 * Limited to 100 characters: letters, digits, underscores, hyphens.
33 * Immutable — changing it replaces the view.
34 */
35 viewId?: string;
36 /**
37 * Filter that restricts which log entries in the bucket are visible.
38 * Must be a logical conjunction of `SOURCE()`, `resource.type`, and
39 * `LOG_ID()`, optionally negated with `NOT`.
40 */
41 filter?: string;
42 /**
43 * Human-readable description. Log views have no labels field, so
44 * Alchemy ownership is stored in a `[alchemy …]` prefix and stripped
45 * from attributes.
46 */
47 description?: string;
48 };
49
50 export type LocationsBucketsView = Resource<
51 "GCP.Logging.LocationsBucketsView",
52 LocationsBucketsViewProps,
53 {
54 /** Full resource name `{bucket}/views/{viewId}`. */
55 name: string;
56 /** View id (last path segment). */
57 viewId: string;
58 /** Parent bucket resource name. */
59 bucketName: string;
60 /** View filter, if set. */
61 filter: string | undefined;
62 /** User description with the Alchemy ownership prefix stripped. */
63 description: string | undefined;
64 /** RFC3339 creation timestamp. */
65 createTime: string | undefined;
66 /** RFC3339 last-update timestamp. */
67 updateTime: string | undefined;
68 },
69 never,
70 Providers
71 >;
72
73 /**
74 * A Cloud Logging view over log entries in a log bucket, managed through
75 * the generic locations APIs.
76 *
77 * A bucket may contain at most 30 views. Views have no labels field, so
78 * Alchemy stamps ownership into the description for `list` / nuke.
79 * `viewId` and `bucketName` are identity — changing either replaces the
80 * view.
81 *
82 * ### Creating a Locations Bucket View
83 * **Example:** View over stdout
84 * ```typescript
85 * const bucket = yield* GCP.Logging.LocationsBucket("AppLogs", {
86 * description: "application logs",
87 * });
88 * const view = yield* GCP.Logging.LocationsBucketsView("Stdout", {
89 * bucketName: bucket.name,
90 * filter: 'LOG_ID("stdout")',
91 * description: "stdout only",
92 * });
93 * ```
94 *
95 * **Example:** Named view
96 * ```typescript
97 * const view = yield* GCP.Logging.LocationsBucketsView("Stdout", {
98 * bucketName: bucket.name,
99 * viewId: "stdout",
100 * filter: 'LOG_ID("stdout")',
101 * });
102 * ```
103 *
104 * ### Updating a Locations Bucket View
105 * **Example:** Change the filter
106 * ```typescript
107 * const view = yield* GCP.Logging.LocationsBucketsView("Stdout", {
108 * bucketName: bucket.name,
109 * filter: 'LOG_ID("stderr")',
110 * description: "stderr only",
111 * });
112 * ```
113 *
114 * @resource
115 * @category Logging
116 */
117 export const LocationsBucketsView = Resource<LocationsBucketsView>(
118 "GCP.Logging.LocationsBucketsView",
119 );
120
121 export class LocationsBucketsViewNotResolved extends Data.TaggedError(
122 "GCP.Logging.LocationsBucketsViewNotResolved",
123 )<{
124 resourceName: string;
125 }> {}
126
127 const resourceName = (bucketName: string, viewId: string) => `${bucketName}/views/${viewId}`;
128
129 const toAttrs = (view: logging.LogView, bucketName: string) => {
130 const parsed = parseLoggingName(view.name ?? "");
131 const viewId = parsed.viewId ?? lastSegment(view.name ?? "");
132 const description = parseDescription(view.description);
133 return {
134 name: view.name ?? resourceName(bucketName, viewId),
135 viewId,
136 bucketName,
137 filter: view.filter,
138 description: description.description,
139 createTime: view.createTime,
140 updateTime: view.updateTime,
141 };
142 };
143
144 const getByName = (name: string) =>
145 logging
146 .getLocationsBucketsViews({ name })
147 .pipe(Effect.catchTag("NotFound", () => Effect.undefined));
148
149 export const LocationsBucketsViewProvider = () =>
150 Provider.succeed(LocationsBucketsView, {
151 stables: ["name", "viewId", "bucketName", "createTime"],
152
153 diff: Effect.fn(function* ({ news, olds, output }) {
154 if (!isResolved(news)) return undefined;
155 const previousId = olds?.viewId ?? output?.viewId;
156 const idChanged =
157 previousId !== undefined && news.viewId !== undefined && news.viewId !== previousId;
158 const previousBucket = olds?.bucketName ?? output?.bucketName;
159 const bucketChanged = previousBucket !== undefined && news.bucketName !== previousBucket;
160 if (!idChanged && !bucketChanged) return undefined;
161 return { action: "replace" as const, deleteFirst: false };
162 }),
163
164 read: Effect.fn(function* ({ id, olds, output }) {
165 const viewId = yield* toPhysicalId(id, olds?.viewId, output?.viewId, "v");
166 const bucketName = olds?.bucketName ?? output?.bucketName;
167 if (bucketName === undefined) return undefined;
168 const name = output?.name ?? resourceName(bucketName, viewId);
169 const existing = yield* getByName(name);
170 if (existing === undefined) return undefined;
171 const attrs = toAttrs(existing, bucketName);
172 const { labels } = parseDescription(existing.description);
173 return (yield* ownedBy(id, labels)) ? attrs : Unowned(attrs);
174 }),
175
176 list: () =>
177 Effect.gen(function* () {
178 const env = yield* GcpEnvironment.current;
179 const buckets = yield* logging.listLocationsBuckets
180 .pages({
181 parent: `projects/${env.project}/locations/-`,
182 pageSize: 1000,
183 })
184 .pipe(
185 Stream.flatMap((page) => Stream.fromIterable(page.buckets ?? [])),
186 Stream.runCollect,
187 Effect.map((chunk) => Array.from(chunk)),
188 );
189 const views: ReturnType<typeof toAttrs>[] = [];
190 for (const bucket of buckets) {
191 if (bucket.name === undefined) continue;
192 const listed = yield* logging.listLocationsBucketsViews
193 .pages({
194 parent: bucket.name,
195 pageSize: 1000,
196 })
197 .pipe(
198 Stream.flatMap((page) => Stream.fromIterable(page.views ?? [])),
199 Stream.filter((view) => hasOwnershipMarker(view.description)),
200 Stream.map((view) => toAttrs(view, bucket.name ?? "")),
201 Stream.runCollect,
202 Effect.map((chunk) => Array.from(chunk)),
203 Effect.catchTag("NotFound", () => Effect.succeed([] as ReturnType<typeof toAttrs>[])),
204 );
205 views.push(...listed);
206 }
207 return views;
208 }),
209
210 reconcile: Effect.fn(function* ({ id, news, output }) {
211 const viewId = yield* toPhysicalId(id, news.viewId, output?.viewId, "v");
212 const name = resourceName(news.bucketName, viewId);
213 const ownership = yield* createOwnership(id);
214 const desiredDescription = encodeDescription(ownership, news.description);
215
216 let current = yield* getByName(output?.name ?? name);
217
218 if (current === undefined) {
219 const created = yield* logging
220 .createLocationsBucketsViews({
221 parent: news.bucketName,
222 viewId,
223 body: {
224 filter: news.filter,
225 description: desiredDescription,
226 },
227 })
228 .pipe(Effect.catchTag("Conflict", () => getByName(name)));
229 current = created ?? undefined;
230 }
231
232 if (current === undefined) {
233 return yield* new LocationsBucketsViewNotResolved({ resourceName: name });
234 }
235
236 const filterChanged = (current.filter ?? "") !== (news.filter ?? "");
237 const descriptionChanged = (current.description ?? "") !== desiredDescription;
238 const updateMask = [
239 filterChanged ? "filter" : undefined,
240 descriptionChanged ? "description" : undefined,
241 ].filter((field): field is string => field !== undefined);
242
243 if (updateMask.length > 0) {
244 current = yield* logging.patchLocationsBucketsViews({
245 name: current.name ?? name,
246 updateMask: updateMask.join(","),
247 body: {
248 filter: news.filter ?? "",
249 description: desiredDescription,
250 },
251 });
252 }
253
254 return toAttrs(current, news.bucketName);
255 }),
256
257 delete: Effect.fn(function* ({ output }) {
258 yield* logging
259 .deleteLocationsBucketsViews({ name: output.name })
260 .pipe(Effect.catchTag("NotFound", () => Effect.void));
261 }),
262 });