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

main
ts 301 lines 10.2 KB
Raw
1 import * as dlp from "@distilled.cloud/gcp/dlp_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 Effect from "effect/Effect";
7 import * as Stream from "effect/Stream";
8 import { GcpEnvironment } from "../Environment.ts";
9 import { createInternalLabels } from "../Labels.ts";
10 import type { Providers } from "../Providers.ts";
11 import {
12 DEFAULT_LOCATION,
13 DlpNotResolved,
14 encodeDescription,
15 fingerprint,
16 hasOwnershipMarker,
17 lastSegment,
18 locationParentsOf,
19 organizationLocationParent,
20 normalizeLocation,
21 organizationIdOf,
22 ownedByAlchemy,
23 parseName,
24 parseOwnership,
25 replaceOn,
26 resolveOrganization,
27 sameText,
28 toPhysicalId,
29 tryResolveOrganization,
30 updateMaskOf,
31 } from "./internal.ts";
32
33 type DeidentifyConfig = dlp.GooglePrivacyDlpV2DeidentifyConfig;
34
35 export type OrganizationsLocationsDeidentifyTemplateProps = {
36 /**
37 * Template id (the `{deidentifyTemplate}` segment of
38 * `organizations/{organization}/locations/{location}/deidentifyTemplates/{deidentifyTemplate}`).
39 * If omitted, a unique id is generated. Letters, digits, hyphens, and
40 * underscores; max 100 characters. Immutable — changing it replaces
41 * the template.
42 */
43 templateId?: string;
44 /**
45 * Parent organization (`organizations/{organization}` or the numeric
46 * id). Defaults to `GOOGLE_ORGANIZATION_ID` or the project's Resource
47 * Manager ancestor. Immutable — changing it replaces the template.
48 */
49 organization?: string;
50 /**
51 * Processing location (`us-central1`, `global`, `us`, …). Immutable —
52 * changing it replaces the template.
53 * @default "global"
54 */
55 location?: string;
56 /**
57 * Human-readable display name (max 256 characters).
58 */
59 displayName?: string;
60 /**
61 * Human-readable description (max 256 characters). Deidentify templates
62 * have no labels field, so Alchemy ownership is stored in a
63 * `[alchemy …]` prefix and stripped from attributes.
64 */
65 description?: string;
66 /**
67 * De-identification configuration applied when this template is used.
68 */
69 deidentifyConfig: DeidentifyConfig;
70 };
71
72 export type OrganizationsLocationsDeidentifyTemplate = Resource<
73 "GCP.DLP.OrganizationsLocationsDeidentifyTemplate",
74 OrganizationsLocationsDeidentifyTemplateProps,
75 {
76 /** Full resource name. */
77 name: string;
78 /** Template id (last path segment). */
79 templateId: string;
80 /** Organization resource name. */
81 organization: string;
82 /** Organization id. */
83 organizationId: string;
84 /** Location id. */
85 location: string;
86 /** Project id of the deploying stack. */
87 project: string;
88 /** User display name. */
89 displayName: string | undefined;
90 /** User description with the Alchemy ownership prefix stripped. */
91 description: string | undefined;
92 /** De-identification configuration. */
93 deidentifyConfig: DeidentifyConfig | undefined;
94 /** RFC3339 creation timestamp. */
95 createTime: string | undefined;
96 /** RFC3339 last-update timestamp. */
97 updateTime: string | undefined;
98 },
99 never,
100 Providers
101 >;
102
103 /**
104 * A location-scoped Sensitive Data Protection de-identify template on an
105 * organization.
106 *
107 * Templates have no labels field — Alchemy stamps ownership into the
108 * description so `list` / nuke can find them. Template id, organization,
109 * and location are identity. Display name, description, and de-identify
110 * config update in place.
111 *
112 * ### Creating a Location Deidentify Template
113 * **Example:** Redact matched infoTypes in us-central1
114 * ```typescript
115 * const template = yield* GCP.DLP.OrganizationsLocationsDeidentifyTemplate(
116 * "RedactPhone",
117 * {
118 * location: "us-central1",
119 * deidentifyConfig: {
120 * infoTypeTransformations: {
121 * transformations: [
122 * {
123 * primitiveTransformation: { replaceWithInfoTypeConfig: {} },
124 * },
125 * ],
126 * },
127 * },
128 * },
129 * );
130 * ```
131 *
132 * @resource
133 * @category DLP
134 */
135 export const OrganizationsLocationsDeidentifyTemplate =
136 Resource<OrganizationsLocationsDeidentifyTemplate>(
137 "GCP.DLP.OrganizationsLocationsDeidentifyTemplate",
138 );
139
140 const resourceName = (organization: string, location: string, templateId: string) =>
141 `${organizationLocationParent(organization, location)}/deidentifyTemplates/${templateId}`;
142
143 const toAttrs = (
144 template: dlp.GooglePrivacyDlpV2DeidentifyTemplate,
145 organization: string,
146 project: string,
147 ) => {
148 const name = template.name ?? "";
149 const parsed = parseName(name, "deidentifyTemplates");
150 const ownership = parseOwnership(template.description);
151 return {
152 name,
153 templateId: parsed.id || lastSegment(name),
154 organization,
155 organizationId: organizationIdOf(organization),
156 location: parsed.location || DEFAULT_LOCATION,
157 project,
158 displayName: template.displayName,
159 description: ownership.text,
160 deidentifyConfig: template.deidentifyConfig,
161 createTime: template.createTime,
162 updateTime: template.updateTime,
163 };
164 };
165
166 const getByName = (name: string) =>
167 name.length === 0
168 ? Effect.undefined
169 : dlp
170 .getOrganizationsLocationsDeidentifyTemplates({ name })
171 .pipe(Effect.catchTag("NotFound", () => Effect.undefined));
172
173 const listAt = (parent: string, organization: string, project: string) =>
174 dlp.listOrganizationsLocationsDeidentifyTemplates.pages({ parent, pageSize: 100 }).pipe(
175 Stream.flatMap((page) => Stream.fromIterable(page.deidentifyTemplates ?? [])),
176 Stream.filter((template) => hasOwnershipMarker(template.description)),
177 Stream.map((template) => toAttrs(template, organization, project)),
178 Stream.runCollect,
179 Effect.map((chunk) => Array.from(chunk)),
180 Effect.catchTag("NotFound", () => Effect.succeed([])),
181 );
182
183 export const OrganizationsLocationsDeidentifyTemplateProvider = () =>
184 Provider.succeed(OrganizationsLocationsDeidentifyTemplate, {
185 stables: [
186 "name",
187 "templateId",
188 "organization",
189 "organizationId",
190 "location",
191 "project",
192 "createTime",
193 ],
194
195 diff: Effect.fn(function* ({ news, olds, output }) {
196 if (!isResolved(news)) return undefined;
197 const previousLocation = normalizeLocation(olds?.location ?? output?.location);
198 const nextLocation = normalizeLocation(news.location ?? olds?.location ?? output?.location);
199 return (
200 replaceOn(olds?.templateId ?? output?.templateId, news.templateId) ??
201 replaceOn(olds?.organization ?? output?.organization, news.organization) ??
202 replaceOn(previousLocation, nextLocation)
203 );
204 }),
205
206 read: Effect.fn(function* ({ id, olds, output }) {
207 const env = yield* GcpEnvironment.current;
208 const organization = yield* resolveOrganization(
209 olds?.organization ?? output?.organization,
210 output?.organization,
211 );
212 const location = normalizeLocation(olds?.location ?? output?.location);
213 const templateId = yield* toPhysicalId(id, olds?.templateId, output?.templateId);
214 const name = output?.name ?? resourceName(organization, location, templateId);
215 const existing = yield* getByName(name);
216 if (existing === undefined) return undefined;
217 const attrs = toAttrs(existing, organization, env.project);
218 return (yield* ownedByAlchemy(id, existing.description)) ? attrs : Unowned(attrs);
219 }),
220
221 list: () =>
222 Effect.gen(function* () {
223 const env = yield* GcpEnvironment.current;
224 const organization = yield* tryResolveOrganization();
225 if (organization === undefined) return [];
226 const pages = yield* Effect.forEach(
227 locationParentsOf(organization, env.region),
228 (parent) => listAt(parent, organization, env.project),
229 { concurrency: 3 },
230 );
231 return pages.flat();
232 }),
233
234 reconcile: Effect.fn(function* ({ id, news, output }) {
235 const env = yield* GcpEnvironment.current;
236 const organization = yield* resolveOrganization(news.organization, output?.organization);
237 const location = normalizeLocation(news.location ?? output?.location);
238 const templateId = yield* toPhysicalId(id, news.templateId, output?.templateId);
239 const parent = organizationLocationParent(organization, location);
240 const name = resourceName(organization, location, templateId);
241 const ownership = yield* createInternalLabels(id);
242 const description = encodeDescription(ownership, news.description);
243 const displayName = news.displayName;
244 const deidentifyConfig = news.deidentifyConfig;
245
246 let current = yield* getByName(output?.name ?? name);
247
248 if (current === undefined) {
249 const created = yield* dlp
250 .createOrganizationsLocationsDeidentifyTemplates({
251 parent,
252 body: {
253 templateId,
254 deidentifyTemplate: {
255 displayName,
256 description,
257 deidentifyConfig,
258 },
259 },
260 })
261 .pipe(Effect.catchTag("Conflict", () => getByName(name)));
262 current = created ?? undefined;
263 }
264
265 if (current === undefined) {
266 return yield* new DlpNotResolved({ resourceName: name });
267 }
268
269 const currentName = current.name ?? name;
270 const displayChanged = !sameText(current.displayName, displayName);
271 const descriptionChanged = !sameText(current.description, description);
272 const configChanged = fingerprint(current.deidentifyConfig) !== fingerprint(deidentifyConfig);
273 const updateMask = updateMaskOf(
274 displayChanged ? "displayName" : undefined,
275 descriptionChanged ? "description" : undefined,
276 configChanged ? "deidentifyConfig" : undefined,
277 );
278
279 if (updateMask.length > 0) {
280 current = yield* dlp.patchOrganizationsLocationsDeidentifyTemplates({
281 name: currentName,
282 body: {
283 updateMask,
284 deidentifyTemplate: {
285 displayName,
286 description,
287 deidentifyConfig,
288 },
289 },
290 });
291 }
292
293 return toAttrs(current, organization, env.project);
294 }),
295
296 delete: Effect.fn(function* ({ output }) {
297 yield* dlp
298 .deleteOrganizationsLocationsDeidentifyTemplates({ name: output.name })
299 .pipe(Effect.catchTag("NotFound", () => Effect.void));
300 }),
301 });