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

main
ts 248 lines 8.25 KB
Raw
1 import * as firebaserules from "@distilled.cloud/gcp/firebaserules_v1";
2 import { createPhysicalName } from "alchemy/PhysicalName";
3 import * as Effect from "effect/Effect";
4 import * as Stream from "effect/Stream";
5 import { alchemyLabelKeys, createInternalLabels, hasAlchemyLabels } from "../Labels.ts";
6
7 export const MAX_RELEASE_ID_LENGTH = 63;
8 export const GENERATED_RELEASE_PREFIX = "alc-";
9
10 export type RulesetFile = {
11 /** Path of this file in the ruleset (e.g. `firestore.rules`). */
12 name: string;
13 /** Textual rules content. */
14 content: string;
15 /** Optional fingerprint (git SHA, etag, …) associated with the file. */
16 fingerprint?: string;
17 };
18
19 export type RulesetSource = {
20 /** Files that make up the ruleset. At least one file is required. */
21 files: RulesetFile[];
22 };
23
24 export const lastSegment = (value: string) => {
25 const trimmed = value.replace(/\/+$/, "");
26 const parts = trimmed.split("/");
27 return parts[parts.length - 1] || trimmed;
28 };
29
30 export const projectParent = (project: string) =>
31 project.startsWith("projects/") ? project : `projects/${project}`;
32
33 export const rulesetResourceName = (project: string, rulesetId: string) =>
34 `${projectParent(project)}/rulesets/${rulesetId}`;
35
36 export const releaseResourceName = (project: string, releaseId: string) =>
37 `${projectParent(project)}/releases/${releaseId}`;
38
39 export const expandRulesetName = (project: string, value: string) => {
40 const trimmed = value.replace(/\/+$/, "");
41 if (trimmed.includes("/")) return trimmed;
42 return rulesetResourceName(project, trimmed);
43 };
44
45 export const rulesetIdOf = (name: string) => {
46 const marker = "/rulesets/";
47 const index = name.indexOf(marker);
48 return index >= 0 ? name.slice(index + marker.length) : lastSegment(name);
49 };
50
51 export const releaseIdOf = (name: string) => {
52 const marker = "/releases/";
53 const index = name.indexOf(marker);
54 return index >= 0 ? name.slice(index + marker.length) : lastSegment(name);
55 };
56
57 export const sameText = (left: string | undefined, right: string | undefined) =>
58 (left ?? "") === (right ?? "");
59
60 const markerOf = (labels: Record<string, string>) =>
61 `// [alchemy ${alchemyLabelKeys.stack}=${labels[alchemyLabelKeys.stack]} ${alchemyLabelKeys.stage}=${labels[alchemyLabelKeys.stage]} ${alchemyLabelKeys.id}=${labels[alchemyLabelKeys.id]}]`;
62
63 const OWNERSHIP_LINE = /^\/\/ \[alchemy [^\]]*\]\r?\n?/;
64
65 export const stripOwnershipLine = (content: string | undefined): string =>
66 (content ?? "").replace(OWNERSHIP_LINE, "");
67
68 export const parseOwnership = (
69 content: string | undefined,
70 ): {
71 labels: Record<string, string>;
72 content: string;
73 } => {
74 const raw = content ?? "";
75 if (!raw.startsWith("// [alchemy ")) {
76 return { labels: {}, content: raw };
77 }
78 const end = raw.indexOf("]");
79 if (end < 0) return { labels: {}, content: raw };
80 const labels: Record<string, string> = {};
81 for (const part of raw.slice("// [alchemy ".length, end).split(/\s+/)) {
82 const eq = part.indexOf("=");
83 if (eq > 0) {
84 labels[part.slice(0, eq)] = part.slice(eq + 1);
85 }
86 }
87 return { labels, content: stripOwnershipLine(raw) };
88 };
89
90 export const hasOwnershipMarker = (content: string | undefined) =>
91 Object.keys(parseOwnership(content).labels).some((key) => key.startsWith("alchemy-"));
92
93 export const sourceHasOwnership = (source: firebaserules.Source | RulesetSource | undefined) =>
94 (source?.files ?? []).some((file) => hasOwnershipMarker(file.content));
95
96 const prefixMatch = (expected: string, observed: string) =>
97 expected === observed || expected.startsWith(observed) || observed.startsWith(expected);
98
99 export const ownedByAlchemy = (
100 id: string,
101 source: firebaserules.Source | RulesetSource | undefined,
102 ) =>
103 Effect.gen(function* () {
104 const expected = yield* createInternalLabels(id);
105 const file = (source?.files ?? []).find((item) => hasOwnershipMarker(item.content));
106 if (file === undefined) return false;
107 const { labels } = parseOwnership(file.content);
108 const exact = yield* hasAlchemyLabels(id, labels);
109 if (exact) return true;
110 return (
111 prefixMatch(expected[alchemyLabelKeys.stack] ?? "", labels[alchemyLabelKeys.stack] ?? "") &&
112 prefixMatch(expected[alchemyLabelKeys.stage] ?? "", labels[alchemyLabelKeys.stage] ?? "") &&
113 prefixMatch(expected[alchemyLabelKeys.id] ?? "", labels[alchemyLabelKeys.id] ?? "")
114 );
115 });
116
117 export const toUserFiles = (
118 files: readonly firebaserules.File[] | readonly RulesetFile[] | undefined,
119 ): RulesetFile[] =>
120 (files ?? []).map((file) => ({
121 name: file.name ?? "firestore.rules",
122 content: stripOwnershipLine(file.content),
123 fingerprint: file.fingerprint,
124 }));
125
126 export const stampSource = (
127 source: RulesetSource,
128 labels: Record<string, string>,
129 ): firebaserules.Source => {
130 const marker = markerOf(labels);
131 const files = source.files.length > 0 ? source.files : [{ name: "firestore.rules", content: "" }];
132 return {
133 files: files.map((file, index) => {
134 const content = stripOwnershipLine(file.content);
135 return {
136 name: file.name,
137 fingerprint: file.fingerprint,
138 content: index === 0 ? `${marker}\n${content}` : content,
139 };
140 }),
141 };
142 };
143
144 export const sourceFingerprint = (
145 files: readonly firebaserules.File[] | readonly RulesetFile[] | undefined,
146 ) =>
147 JSON.stringify(
148 toUserFiles(files)
149 .map((file) => ({
150 name: file.name,
151 content: file.content,
152 fingerprint: file.fingerprint ?? "",
153 }))
154 .slice()
155 .sort((left, right) => left.name.localeCompare(right.name)),
156 );
157
158 export const toReleaseId = (
159 id: string,
160 explicit: string | undefined,
161 existing: string | undefined,
162 ) =>
163 Effect.gen(function* () {
164 if (explicit !== undefined) return explicit;
165 if (existing !== undefined) return existing;
166 const generated = yield* createPhysicalName({
167 id,
168 maxLength: MAX_RELEASE_ID_LENGTH - GENERATED_RELEASE_PREFIX.length,
169 lowercase: true,
170 });
171 return `${GENERATED_RELEASE_PREFIX}${generated}`.slice(0, MAX_RELEASE_ID_LENGTH);
172 });
173
174 export const isGeneratedReleaseId = (releaseId: string | undefined) =>
175 (releaseId ?? "").startsWith(GENERATED_RELEASE_PREFIX);
176
177 export const getRuleset = (name: string) =>
178 name.length === 0
179 ? Effect.undefined
180 : firebaserules
181 .getProjectsRulesets({ name })
182 .pipe(Effect.catchTag("NotFound", () => Effect.undefined));
183
184 export const getRelease = (name: string) =>
185 name.length === 0
186 ? Effect.undefined
187 : firebaserules
188 .getProjectsReleases({ name })
189 .pipe(Effect.catchTag("NotFound", () => Effect.undefined));
190
191 const listRulesetMetas = (project: string) =>
192 firebaserules.listProjectsRulesets
193 .pages({
194 name: projectParent(project),
195 pageSize: 100,
196 })
197 .pipe(
198 Stream.flatMap((page) => Stream.fromIterable(page.rulesets ?? [])),
199 Stream.runCollect,
200 Effect.map((chunk) => Array.from(chunk)),
201 Effect.catchTag("NotFound", () => Effect.succeed([])),
202 );
203
204 export const listFullRulesets = (project: string) =>
205 Effect.gen(function* () {
206 const metas = yield* listRulesetMetas(project);
207 const loaded = yield* Effect.forEach(metas, (ruleset) => getRuleset(ruleset.name ?? ""), {
208 concurrency: 8,
209 });
210 return loaded.filter((ruleset): ruleset is firebaserules.Ruleset => ruleset !== undefined);
211 });
212
213 export const listOwnedRulesets = (project: string) =>
214 Effect.gen(function* () {
215 const rulesets = yield* listFullRulesets(project);
216 return rulesets.filter((ruleset) => sourceHasOwnership(ruleset.source));
217 });
218
219 export const findOwnedRuleset = (
220 rulesets: readonly firebaserules.Ruleset[],
221 id: string,
222 existingName: string | undefined,
223 ) =>
224 Effect.gen(function* () {
225 if (existingName) {
226 const hit = rulesets.find((ruleset) => ruleset.name === existingName);
227 if (hit) return hit;
228 }
229 for (const ruleset of rulesets) {
230 if (yield* ownedByAlchemy(id, ruleset.source)) {
231 return ruleset;
232 }
233 }
234 return undefined;
235 });
236
237 export const listReleases = (project: string) =>
238 firebaserules.listProjectsReleases
239 .pages({
240 name: projectParent(project),
241 pageSize: 100,
242 })
243 .pipe(
244 Stream.flatMap((page) => Stream.fromIterable(page.releases ?? [])),
245 Stream.runCollect,
246 Effect.map((chunk) => Array.from(chunk)),
247 Effect.catchTag("NotFound", () => Effect.succeed([])),
248 );