@gadicc/loom 1.15.4 → 1.16.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/db/drizzle-config.d.ts +2 -1
- package/db/drizzle-config.js +6 -3
- package/esm/src/cli/migrationEnv.d.ts +16 -0
- package/esm/src/cli/migrationEnv.d.ts.map +1 -0
- package/esm/src/cli/migrationEnv.js +46 -0
- package/esm/src/cli/mod.d.ts +12 -0
- package/esm/src/cli/mod.d.ts.map +1 -1
- package/esm/src/cli/mod.js +240 -7
- package/esm/src/cli/vercelBuildEnv.d.ts +30 -0
- package/esm/src/cli/vercelBuildEnv.d.ts.map +1 -0
- package/esm/src/cli/vercelBuildEnv.js +186 -0
- package/package.json +2 -2
- package/script/src/cli/migrationEnv.d.ts +16 -0
- package/script/src/cli/migrationEnv.d.ts.map +1 -0
- package/script/src/cli/migrationEnv.js +49 -0
- package/script/src/cli/mod.d.ts +12 -0
- package/script/src/cli/mod.d.ts.map +1 -1
- package/script/src/cli/mod.js +241 -7
- package/script/src/cli/vercelBuildEnv.d.ts +30 -0
- package/script/src/cli/vercelBuildEnv.d.ts.map +1 -0
- package/script/src/cli/vercelBuildEnv.js +191 -0
- package/skills/loom/SKILL.md +11 -3
- package/skills/loom-auth/SKILL.md +18 -8
- package/skills/loom-db/SKILL.md +25 -8
package/db/drizzle-config.d.ts
CHANGED
|
@@ -3,7 +3,8 @@ import type { defineConfig } from "drizzle-kit";
|
|
|
3
3
|
export interface CreateDrizzleConfigOptions {
|
|
4
4
|
/**
|
|
5
5
|
* Override the database URL variable. When omitted, Loom prefers
|
|
6
|
-
* `
|
|
6
|
+
* `MIGRATION_DATABASE_URL_UNPOOLED`, then `MIGRATION_DATABASE_URL`, before
|
|
7
|
+
* the gradual-adoption fallbacks `DATABASE_URL_UNPOOLED` and `DATABASE_URL`.
|
|
7
8
|
*/
|
|
8
9
|
databaseUrlEnvVar?: string;
|
|
9
10
|
/**
|
package/db/drizzle-config.js
CHANGED
|
@@ -6,9 +6,12 @@ export function createDrizzleConfig({
|
|
|
6
6
|
outDir,
|
|
7
7
|
schemaDir,
|
|
8
8
|
}) {
|
|
9
|
-
const databaseUrlEnvVars = databaseUrlEnvVar
|
|
10
|
-
|
|
11
|
-
|
|
9
|
+
const databaseUrlEnvVars = databaseUrlEnvVar ? [databaseUrlEnvVar] : [
|
|
10
|
+
"MIGRATION_DATABASE_URL_UNPOOLED",
|
|
11
|
+
"MIGRATION_DATABASE_URL",
|
|
12
|
+
"DATABASE_URL_UNPOOLED",
|
|
13
|
+
"DATABASE_URL",
|
|
14
|
+
];
|
|
12
15
|
const resolvedDatabaseUrlEnvVar = databaseUrlEnvVars.find((envName) =>
|
|
13
16
|
process.env[envName]
|
|
14
17
|
);
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
declare const DEFAULT_MIGRATION_DATABASE_URL_ENV_NAMES: readonly ["MIGRATION_DATABASE_URL_UNPOOLED", "MIGRATION_DATABASE_URL", "DATABASE_URL_UNPOOLED", "DATABASE_URL"];
|
|
2
|
+
export type MigrationDatabaseUrlEnvName = typeof DEFAULT_MIGRATION_DATABASE_URL_ENV_NAMES[number];
|
|
3
|
+
export type MigrationEnvironmentResolution = {
|
|
4
|
+
database: string;
|
|
5
|
+
direct: boolean;
|
|
6
|
+
envName: MigrationDatabaseUrlEnvName;
|
|
7
|
+
hostname: string;
|
|
8
|
+
role: string;
|
|
9
|
+
};
|
|
10
|
+
/**
|
|
11
|
+
* Resolves and validates the migration database URL without returning or
|
|
12
|
+
* printing the credential itself.
|
|
13
|
+
*/
|
|
14
|
+
export declare function resolveMigrationEnvironment(env: Record<string, string | undefined>): MigrationEnvironmentResolution;
|
|
15
|
+
export {};
|
|
16
|
+
//# sourceMappingURL=migrationEnv.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"migrationEnv.d.ts","sourceRoot":"","sources":["../../../src/src/cli/migrationEnv.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,wCAAwC,iHAKpC,CAAC;AAEX,MAAM,MAAM,2BAA2B,GACrC,OAAO,wCAAwC,CAAC,MAAM,CAAC,CAAC;AAE1D,MAAM,MAAM,8BAA8B,GAAG;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,2BAA2B,CAAC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAOF;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GACtC,8BAA8B,CA2ChC"}
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
const DEFAULT_MIGRATION_DATABASE_URL_ENV_NAMES = [
|
|
2
|
+
"MIGRATION_DATABASE_URL_UNPOOLED",
|
|
3
|
+
"MIGRATION_DATABASE_URL",
|
|
4
|
+
"DATABASE_URL_UNPOOLED",
|
|
5
|
+
"DATABASE_URL",
|
|
6
|
+
];
|
|
7
|
+
function isUsableDatabaseUrl(value) {
|
|
8
|
+
return Boolean(value?.trim()) &&
|
|
9
|
+
!/(?:sensitive|redacted)/i.test(value ?? "");
|
|
10
|
+
}
|
|
11
|
+
/**
|
|
12
|
+
* Resolves and validates the migration database URL without returning or
|
|
13
|
+
* printing the credential itself.
|
|
14
|
+
*/
|
|
15
|
+
export function resolveMigrationEnvironment(env) {
|
|
16
|
+
const envName = DEFAULT_MIGRATION_DATABASE_URL_ENV_NAMES.find((name) => isUsableDatabaseUrl(env[name]));
|
|
17
|
+
if (!envName) {
|
|
18
|
+
throw new Error(`${DEFAULT_MIGRATION_DATABASE_URL_ENV_NAMES.join(" or ")} is not defined with a usable database URL.`);
|
|
19
|
+
}
|
|
20
|
+
const value = env[envName];
|
|
21
|
+
let url;
|
|
22
|
+
try {
|
|
23
|
+
url = new URL(value);
|
|
24
|
+
}
|
|
25
|
+
catch {
|
|
26
|
+
throw new Error(`${envName} is not a valid URL.`);
|
|
27
|
+
}
|
|
28
|
+
if (url.protocol !== "postgres:" && url.protocol !== "postgresql:") {
|
|
29
|
+
throw new Error(`${envName} must use the postgres or postgresql scheme.`);
|
|
30
|
+
}
|
|
31
|
+
if (!url.username || !url.hostname || !url.pathname.slice(1)) {
|
|
32
|
+
throw new Error(`${envName} must include a database role, hostname, and database name.`);
|
|
33
|
+
}
|
|
34
|
+
const role = decodeURIComponent(url.username);
|
|
35
|
+
const expectedRole = env.LOOM_MIGRATION_DATABASE_ROLE?.trim();
|
|
36
|
+
if (expectedRole && role !== expectedRole) {
|
|
37
|
+
throw new Error(`${envName} uses database role ${role}, but LOOM_MIGRATION_DATABASE_ROLE expects ${expectedRole}.`);
|
|
38
|
+
}
|
|
39
|
+
return {
|
|
40
|
+
database: decodeURIComponent(url.pathname.slice(1)),
|
|
41
|
+
direct: !/(?:^|-)pooler(?:\.|$)/i.test(url.hostname),
|
|
42
|
+
envName,
|
|
43
|
+
hostname: url.hostname,
|
|
44
|
+
role,
|
|
45
|
+
};
|
|
46
|
+
}
|
package/esm/src/cli/mod.d.ts
CHANGED
|
@@ -281,6 +281,18 @@ type GithubVercelReleaseSetupOptions = {
|
|
|
281
281
|
io?: CliOutput;
|
|
282
282
|
tokenName?: string;
|
|
283
283
|
};
|
|
284
|
+
type GithubMigrationCredentialSetupOptions = {
|
|
285
|
+
commandRunner?: CommandRunner;
|
|
286
|
+
env?: Record<string, string | undefined>;
|
|
287
|
+
environment?: string;
|
|
288
|
+
};
|
|
289
|
+
/**
|
|
290
|
+
* Stores an already-provisioned direct migration URL in a protected GitHub
|
|
291
|
+
* Environment without persisting or printing the credential.
|
|
292
|
+
*/
|
|
293
|
+
export declare function setupGithubMigrationCredential(cwd: string, options?: GithubMigrationCredentialSetupOptions): Promise<{
|
|
294
|
+
notes: string[];
|
|
295
|
+
}>;
|
|
284
296
|
export declare function setupGithubVercelRelease(cwd: string, options?: GithubVercelReleaseSetupOptions): Promise<{
|
|
285
297
|
notes: string[];
|
|
286
298
|
}>;
|
package/esm/src/cli/mod.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../src/src/cli/mod.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../src/src/cli/mod.ts"],"names":[],"mappings":"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"}
|
package/esm/src/cli/mod.js
CHANGED
|
@@ -8,6 +8,8 @@ import process from "node:process";
|
|
|
8
8
|
import { parseArgs } from "node:util";
|
|
9
9
|
import { DEFAULT_API_KEY_AUDIT_RETENTION } from "../apiKeys/retention.js";
|
|
10
10
|
import { checkProjectSkills, getProjectSkillStatus, LOOM_EXTERNAL_SKILLS_GITIGNORE_LINE, removeLegacyNextSkillLink, setProjectSkillDisabled, syncExternalProjectSkills, syncInstalledPackageSkills, } from "./projectSkills.js";
|
|
11
|
+
import { resolveMigrationEnvironment } from "./migrationEnv.js";
|
|
12
|
+
import { prepareVercelBuildEnvironment, verifyVercelBuildArtifact, } from "./vercelBuildEnv.js";
|
|
11
13
|
export const DEFAULT_LOOM_RANGE = "^1.0.0";
|
|
12
14
|
export const LOOM_DEPENDENCY = "@gadicc/loom";
|
|
13
15
|
export const LOOM_MANIFEST_SCHEMA = "https://loom.gadicc.local/project-manifest.schema.json";
|
|
@@ -43,6 +45,15 @@ const REQUIRED_GITHUB_VERCEL_ID_NAMES = [
|
|
|
43
45
|
"VERCEL_ORG_ID",
|
|
44
46
|
"VERCEL_PROJECT_ID",
|
|
45
47
|
];
|
|
48
|
+
const GITHUB_MIGRATION_DATABASE_SECRET_NAME = "MIGRATION_DATABASE_URL_UNPOOLED";
|
|
49
|
+
const GITHUB_MIGRATION_DATABASE_ROLE_VARIABLE_NAME = "LOOM_MIGRATION_DATABASE_ROLE";
|
|
50
|
+
const LEGACY_GITHUB_MIGRATION_DATABASE_SECRET_NAME = "DATABASE_URL_UNPOOLED";
|
|
51
|
+
const GITHUB_DATABASE_URL_VARIABLE_NAMES = [
|
|
52
|
+
"DATABASE_URL",
|
|
53
|
+
"DATABASE_URL_UNPOOLED",
|
|
54
|
+
"MIGRATION_DATABASE_URL",
|
|
55
|
+
"MIGRATION_DATABASE_URL_UNPOOLED",
|
|
56
|
+
];
|
|
46
57
|
const STALE_GITHUB_RELEASE_SECRET_NAMES = [
|
|
47
58
|
"DATABASE_URL",
|
|
48
59
|
"VERCEL_DEPLOY_HOOK",
|
|
@@ -2762,6 +2773,24 @@ function workflowStepBuildsVercelProductionArtifact(block) {
|
|
|
2762
2773
|
return workflowStepUsesVercelCommand(block, "build") &&
|
|
2763
2774
|
/\s--prod\b/.test(block);
|
|
2764
2775
|
}
|
|
2776
|
+
function workflowStepPreservesVercelProductionEnv(block) {
|
|
2777
|
+
return workflowStepPullsVercelProductionSettings(block) &&
|
|
2778
|
+
/\bcp\s+\.vercel\/\.env\.production\.local\s+["']?\$RUNNER_TEMP\/vercel-production\.env["']?/
|
|
2779
|
+
.test(block);
|
|
2780
|
+
}
|
|
2781
|
+
function workflowStepQueriesVercelProductionEnvMetadata(block) {
|
|
2782
|
+
return workflowStepUsesVercelCommand(block, "env") &&
|
|
2783
|
+
/\benv\s+ls\s+production\b/.test(block) &&
|
|
2784
|
+
/\s--format(?:=|\s+)json\b/.test(block);
|
|
2785
|
+
}
|
|
2786
|
+
function workflowStepPreparesVercelBuildEnv(block) {
|
|
2787
|
+
return (/\bvercel-build-env(?:\.mjs)?\b[\s\S]*\bprepare\b/.test(block) ||
|
|
2788
|
+
/\bloom\b[\s\S]*\bdb\s+release\s+prepare-build-env\b/.test(block));
|
|
2789
|
+
}
|
|
2790
|
+
function workflowStepVerifiesVercelBuildEnv(block) {
|
|
2791
|
+
return (/\bvercel-build-env(?:\.mjs)?\b[\s\S]*\bverify\b/.test(block) ||
|
|
2792
|
+
/\bloom\b[\s\S]*\bdb\s+release\s+verify-build-env\b/.test(block)) && /\.vercel\/output\b/.test(block);
|
|
2793
|
+
}
|
|
2765
2794
|
function workflowStepStagesVercelProductionDeployment(block) {
|
|
2766
2795
|
return workflowStepUsesVercelCommand(block, "deploy") &&
|
|
2767
2796
|
/\s--prebuilt\b/.test(block) &&
|
|
@@ -2773,6 +2802,10 @@ function workflowStepRunsDbMigrateWithVercelProductionEnv(block) {
|
|
|
2773
2802
|
/\bnode\s+--env-file(?:=|\s+)["']?\.vercel\/\.env\.production\.local["']?/
|
|
2774
2803
|
.test(block);
|
|
2775
2804
|
}
|
|
2805
|
+
function workflowStepRestoresVercelMigrationEnv(block) {
|
|
2806
|
+
return /\bcp\s+["']?\$RUNNER_TEMP\/vercel-production\.env["']?\s+\.vercel\/\.env\.production\.local\b/
|
|
2807
|
+
.test(block);
|
|
2808
|
+
}
|
|
2776
2809
|
function workflowStepPromotesVercelDeployment(block) {
|
|
2777
2810
|
return workflowStepUsesVercelCommand(block, "promote");
|
|
2778
2811
|
}
|
|
@@ -2789,6 +2822,15 @@ function workflowUsesOldVercelDeployHook(text) {
|
|
|
2789
2822
|
function workflowUsesGithubDatabaseUrlSecret(text) {
|
|
2790
2823
|
return /\$\{\{\s*secrets\.DATABASE_URL\s*\}\}/.test(text);
|
|
2791
2824
|
}
|
|
2825
|
+
function workflowUsesGithubUnpooledDatabaseUrlSecret(text) {
|
|
2826
|
+
return /\$\{\{\s*secrets\.DATABASE_URL_UNPOOLED\s*\}\}/.test(text);
|
|
2827
|
+
}
|
|
2828
|
+
function workflowUsesGithubMigrationDatabaseUrlSecret(text) {
|
|
2829
|
+
return /\$\{\{\s*secrets\.MIGRATION_DATABASE_URL(?:_UNPOOLED)?\s*\}\}/.test(text);
|
|
2830
|
+
}
|
|
2831
|
+
function workflowUsesGithubDatabaseUrlVariable(text) {
|
|
2832
|
+
return /\$\{\{\s*vars\.(?:MIGRATION_)?DATABASE_URL(?:_UNPOOLED)?\s*\}\}/.test(text);
|
|
2833
|
+
}
|
|
2792
2834
|
function getGithubWorkflowJobBlocks(text) {
|
|
2793
2835
|
const lines = normalizeText(text).split("\n");
|
|
2794
2836
|
const jobsIndex = lines.findIndex((line) => /^\s*jobs:\s*(?:#.*)?$/.test(line));
|
|
@@ -2840,6 +2882,10 @@ function inspectDbMigrationWorkflow(relativePath, workflowText) {
|
|
|
2840
2882
|
const jobs = getGithubWorkflowJobBlocks(normalized).map((job) => {
|
|
2841
2883
|
const pullStepIndex = job.stepBlocks.findIndex(workflowStepPullsVercelProductionSettings);
|
|
2842
2884
|
const buildStepIndex = job.stepBlocks.findIndex(workflowStepBuildsVercelProductionArtifact);
|
|
2885
|
+
const snapshotStepIndex = job.stepBlocks.findIndex(workflowStepPreservesVercelProductionEnv);
|
|
2886
|
+
const metadataStepIndex = job.stepBlocks.findIndex(workflowStepQueriesVercelProductionEnvMetadata);
|
|
2887
|
+
const prepareBuildEnvStepIndex = job.stepBlocks.findIndex(workflowStepPreparesVercelBuildEnv);
|
|
2888
|
+
const verifyBuildEnvStepIndex = job.stepBlocks.findIndex(workflowStepVerifiesVercelBuildEnv);
|
|
2843
2889
|
const stageStepIndex = job.stepBlocks.findIndex(workflowStepStagesVercelProductionDeployment);
|
|
2844
2890
|
const migrateStepIndex = job.stepBlocks.findIndex(workflowStepRunsDbMigrate);
|
|
2845
2891
|
const migrateWithVercelProductionEnvStepIndex = job.stepBlocks.findIndex(workflowStepRunsDbMigrateWithVercelProductionEnv);
|
|
@@ -2857,35 +2903,50 @@ function inspectDbMigrationWorkflow(relativePath, workflowText) {
|
|
|
2857
2903
|
hasWorkflowEnvBinding(jobPreambleBeforeSteps(job.text), "DATABASE_URL") ||
|
|
2858
2904
|
hasWorkflowEnvBinding(migrateStep, "DATABASE_URL"),
|
|
2859
2905
|
id: job.id,
|
|
2906
|
+
metadataStepIndex,
|
|
2860
2907
|
migrateStepIndex,
|
|
2908
|
+
migrateStepRestoresPulledEnv: workflowStepRestoresVercelMigrationEnv(migrateStep),
|
|
2861
2909
|
migrateWithVercelProductionEnvStepIndex,
|
|
2910
|
+
prepareBuildEnvStepIndex,
|
|
2862
2911
|
promoteStepIndex,
|
|
2863
2912
|
promoteStepUsesExplicitScope: workflowStepUsesExplicitVercelScope(promoteStep),
|
|
2864
2913
|
pullStepIndex,
|
|
2865
2914
|
relativePath,
|
|
2915
|
+
snapshotStepIndex,
|
|
2866
2916
|
stageStepIndex,
|
|
2867
2917
|
text: job.text,
|
|
2868
2918
|
vercelCurlStepIndex,
|
|
2919
|
+
verifyBuildEnvStepIndex,
|
|
2869
2920
|
};
|
|
2870
2921
|
});
|
|
2871
2922
|
return {
|
|
2872
2923
|
jobs,
|
|
2873
2924
|
mainPush: githubWorkflowRunsOnMainPush(normalized),
|
|
2925
|
+
usesGithubDatabaseUrlVariable: workflowUsesGithubDatabaseUrlVariable(normalized),
|
|
2874
2926
|
relativePath,
|
|
2875
2927
|
usesGithubDatabaseUrlSecret: workflowUsesGithubDatabaseUrlSecret(normalized),
|
|
2928
|
+
usesGithubMigrationDatabaseUrlSecret: workflowUsesGithubMigrationDatabaseUrlSecret(normalized),
|
|
2929
|
+
usesGithubUnpooledDatabaseUrlSecret: workflowUsesGithubUnpooledDatabaseUrlSecret(normalized),
|
|
2876
2930
|
usesOldVercelDeployHook: workflowUsesOldVercelDeployHook(normalized),
|
|
2877
2931
|
};
|
|
2878
2932
|
}
|
|
2879
2933
|
function dbMigrationJobHasOrderedStagedRelease(job) {
|
|
2880
2934
|
return (job.pullStepIndex >= 0 &&
|
|
2881
|
-
job.
|
|
2882
|
-
job.
|
|
2935
|
+
job.snapshotStepIndex === job.pullStepIndex &&
|
|
2936
|
+
job.metadataStepIndex > job.pullStepIndex &&
|
|
2937
|
+
job.prepareBuildEnvStepIndex > job.metadataStepIndex &&
|
|
2938
|
+
job.buildStepIndex > job.prepareBuildEnvStepIndex &&
|
|
2939
|
+
job.verifyBuildEnvStepIndex > job.buildStepIndex &&
|
|
2940
|
+
job.stageStepIndex > job.verifyBuildEnvStepIndex &&
|
|
2883
2941
|
job.migrateWithVercelProductionEnvStepIndex > job.stageStepIndex &&
|
|
2942
|
+
job.migrateStepRestoresPulledEnv &&
|
|
2884
2943
|
job.promoteStepIndex > job.migrateWithVercelProductionEnvStepIndex);
|
|
2885
2944
|
}
|
|
2886
2945
|
function dbMigrationWorkflowIsValid(workflow) {
|
|
2887
2946
|
return workflow.jobs.some((job) => dbMigrationJobHasOrderedStagedRelease(job) &&
|
|
2888
|
-
job.promoteStepUsesExplicitScope
|
|
2947
|
+
job.promoteStepUsesExplicitScope &&
|
|
2948
|
+
(workflow.usesGithubMigrationDatabaseUrlSecret ||
|
|
2949
|
+
workflow.usesGithubUnpooledDatabaseUrlSecret));
|
|
2889
2950
|
}
|
|
2890
2951
|
function isJsonObject(value) {
|
|
2891
2952
|
return typeof value === "object" && value !== null && !Array.isArray(value);
|
|
@@ -2943,6 +3004,9 @@ async function checkDbProductionMigrationFlow(cwd, production) {
|
|
|
2943
3004
|
const validMigrationWorkflow = mainPushWorkflows.find(dbMigrationWorkflowIsValid);
|
|
2944
3005
|
const oldDeployHookWorkflows = mainPushWorkflows.filter((inspection) => inspection.usesOldVercelDeployHook);
|
|
2945
3006
|
const duplicatedDatabaseUrlWorkflows = mainPushWorkflows.filter((inspection) => inspection.usesGithubDatabaseUrlSecret);
|
|
3007
|
+
const databaseUrlVariableWorkflows = mainPushWorkflows.filter((inspection) => inspection.usesGithubDatabaseUrlVariable);
|
|
3008
|
+
const legacyUnpooledSecretWorkflows = mainPushWorkflows.filter((inspection) => inspection.usesGithubUnpooledDatabaseUrlSecret &&
|
|
3009
|
+
!inspection.usesGithubMigrationDatabaseUrlSecret);
|
|
2946
3010
|
const vercelCurlWorkflowPaths = mainPushWorkflows.flatMap((inspection) => inspection.jobs.some((job) => job.vercelCurlStepIndex >= 0)
|
|
2947
3011
|
? [inspection.relativePath]
|
|
2948
3012
|
: []);
|
|
@@ -2967,6 +3031,22 @@ async function checkDbProductionMigrationFlow(cwd, production) {
|
|
|
2967
3031
|
findings.push("DB production migration flow does not promote the staged deployment after migrations: " +
|
|
2968
3032
|
migrationWorkflowPaths.join(", "));
|
|
2969
3033
|
}
|
|
3034
|
+
else if (!mainPushWorkflows.some((inspection) => inspection.jobs.some((job) => job.snapshotStepIndex === job.pullStepIndex &&
|
|
3035
|
+
job.metadataStepIndex > job.pullStepIndex &&
|
|
3036
|
+
job.prepareBuildEnvStepIndex > job.metadataStepIndex &&
|
|
3037
|
+
job.verifyBuildEnvStepIndex > job.buildStepIndex))) {
|
|
3038
|
+
findings.push("DB production migration flow does not preserve the pulled migration env and verify metadata-backed build placeholders: " +
|
|
3039
|
+
migrationWorkflowPaths.join(", "));
|
|
3040
|
+
}
|
|
3041
|
+
else if (!mainPushWorkflows.some((inspection) => inspection.jobs.some((job) => job.migrateStepRestoresPulledEnv))) {
|
|
3042
|
+
findings.push("DB production migration flow does not restore the untouched pulled env before migrations: " +
|
|
3043
|
+
migrationWorkflowPaths.join(", "));
|
|
3044
|
+
}
|
|
3045
|
+
else if (!mainPushWorkflows.some((inspection) => inspection.usesGithubMigrationDatabaseUrlSecret ||
|
|
3046
|
+
inspection.usesGithubUnpooledDatabaseUrlSecret)) {
|
|
3047
|
+
findings.push("DB production migration flow is not ready for Sensitive database variables because it lacks a GitHub migration-secret binding: " +
|
|
3048
|
+
migrationWorkflowPaths.join(", "));
|
|
3049
|
+
}
|
|
2970
3050
|
else if (mainPushWorkflows.some((inspection) => inspection.jobs.some((job) => dbMigrationJobHasOrderedStagedRelease(job) &&
|
|
2971
3051
|
!job.promoteStepUsesExplicitScope))) {
|
|
2972
3052
|
findings.push("DB production migration flow promotes the staged deployment without an explicit Vercel team scope: " +
|
|
@@ -2976,7 +3056,19 @@ async function checkDbProductionMigrationFlow(cwd, production) {
|
|
|
2976
3056
|
findings.push("DB production migration flow does not order build, staged deploy, migration, and promotion correctly: " +
|
|
2977
3057
|
migrationWorkflowPaths.join(", "));
|
|
2978
3058
|
}
|
|
2979
|
-
suggestions.add('Add a production GitHub Actions workflow that runs `vercel pull --environment=production --scope "$VERCEL_ORG_ID"`, masks
|
|
3059
|
+
suggestions.add('Add a production GitHub Actions workflow that runs `vercel pull --environment=production --scope "$VERCEL_ORG_ID"`, preserves an untouched migration snapshot, masks usable pulled values, queries `vercel env ls production --format=json`, adds unique build-only placeholders for unreadable Sensitive values, runs `vercel build --prod --scope "$VERCEL_ORG_ID"`, rejects placeholder leakage from `.vercel/output`, stages with `vercel deploy --prebuilt --prod --skip-domain --scope "$VERCEL_ORG_ID"`, restores the migration snapshot with an optional GitHub `MIGRATION_DATABASE_URL_UNPOOLED` override, runs migrations, then runs `vercel promote --scope "$VERCEL_ORG_ID"`.');
|
|
3060
|
+
}
|
|
3061
|
+
if (legacyUnpooledSecretWorkflows.length) {
|
|
3062
|
+
warnings.push("DB production migration flow still uses the gradual-adoption GitHub secret `DATABASE_URL_UNPOOLED` instead of the migration-scoped `MIGRATION_DATABASE_URL_UNPOOLED`: " +
|
|
3063
|
+
legacyUnpooledSecretWorkflows.map((workflow) => workflow.relativePath)
|
|
3064
|
+
.join(", "));
|
|
3065
|
+
suggestions.add("When rotating the migration credential, store the new direct URL as the protected GitHub Environment secret `MIGRATION_DATABASE_URL_UNPOOLED` and update the workflow binding. The existing `DATABASE_URL_UNPOOLED` flow remains supported during gradual adoption.");
|
|
3066
|
+
}
|
|
3067
|
+
if (databaseUrlVariableWorkflows.length) {
|
|
3068
|
+
warnings.push("DB production migration flow reads a database URL from a readable GitHub Actions variable: " +
|
|
3069
|
+
databaseUrlVariableWorkflows.map((workflow) => workflow.relativePath)
|
|
3070
|
+
.join(", "));
|
|
3071
|
+
suggestions.add("Rotate that credential into the protected GitHub Environment secret `MIGRATION_DATABASE_URL_UNPOOLED`; keep GitHub variables for non-secret IDs and the expected migration role only.");
|
|
2980
3072
|
}
|
|
2981
3073
|
if (oldDeployHookWorkflows.length) {
|
|
2982
3074
|
findings.push("DB production migration flow still references a Vercel Deploy Hook: " +
|
|
@@ -2987,7 +3079,7 @@ async function checkDbProductionMigrationFlow(cwd, production) {
|
|
|
2987
3079
|
findings.push("DB production migration flow still reads `secrets.DATABASE_URL` from GitHub: " +
|
|
2988
3080
|
duplicatedDatabaseUrlWorkflows.map((workflow) => workflow.relativePath)
|
|
2989
3081
|
.join(", "));
|
|
2990
|
-
suggestions.add("
|
|
3082
|
+
suggestions.add("Remove the duplicate GitHub `DATABASE_URL`. While Vercel database variables remain readable, migrate with an untouched `vercel pull` snapshot; before making them Sensitive, store only `MIGRATION_DATABASE_URL_UNPOOLED` in the protected GitHub Environment and expose it to the migration step.");
|
|
2991
3083
|
}
|
|
2992
3084
|
if (vercelCurlWorkflowPaths.length) {
|
|
2993
3085
|
findings.push("DB production migration flow still uses beta `vercel curl` for smoke checks: " +
|
|
@@ -5369,6 +5461,32 @@ function createGithubReleaseConfigCheckStep(state, context) {
|
|
|
5369
5461
|
suggestions.add(`After confirming no other workflow uses it, run \`gh secret delete ${staleSecret}\`.`);
|
|
5370
5462
|
}
|
|
5371
5463
|
}
|
|
5464
|
+
const hasCanonicalMigrationSecret = environmentSecrets.names.has(GITHUB_MIGRATION_DATABASE_SECRET_NAME);
|
|
5465
|
+
const hasRepositoryCanonicalMigrationSecret = repoSecrets.names.has(GITHUB_MIGRATION_DATABASE_SECRET_NAME);
|
|
5466
|
+
const hasLegacyMigrationSecret = collectionHasName(LEGACY_GITHUB_MIGRATION_DATABASE_SECRET_NAME, environmentSecrets, repoSecrets);
|
|
5467
|
+
if (!hasCanonicalMigrationSecret) {
|
|
5468
|
+
if (hasRepositoryCanonicalMigrationSecret) {
|
|
5469
|
+
warnings.push(`GitHub Actions stores ${GITHUB_MIGRATION_DATABASE_SECRET_NAME} at repository scope instead of the protected ${PRODUCTION_GITHUB_ENVIRONMENT} environment.`);
|
|
5470
|
+
}
|
|
5471
|
+
else if (hasLegacyMigrationSecret) {
|
|
5472
|
+
warnings.push(`GitHub Actions still uses the gradual-adoption migration secret ${LEGACY_GITHUB_MIGRATION_DATABASE_SECRET_NAME}; rotate into ${GITHUB_MIGRATION_DATABASE_SECRET_NAME} when convenient.`);
|
|
5473
|
+
}
|
|
5474
|
+
else {
|
|
5475
|
+
warnings.push(`GitHub Actions has no dedicated ${GITHUB_MIGRATION_DATABASE_SECRET_NAME} production secret. The existing pulled Vercel URL remains supported while it is readable.`);
|
|
5476
|
+
}
|
|
5477
|
+
suggestions.add("Provision a dedicated direct migration credential, then run `loom db migrations setup-github` to store it without making the Vercel integration variables Sensitive yet.");
|
|
5478
|
+
}
|
|
5479
|
+
if (hasCanonicalMigrationSecret &&
|
|
5480
|
+
findGithubVariableValue(GITHUB_MIGRATION_DATABASE_ROLE_VARIABLE_NAME, environmentVariables, repoVariables) === null) {
|
|
5481
|
+
warnings.push(`GitHub Actions has ${GITHUB_MIGRATION_DATABASE_SECRET_NAME} but no ${GITHUB_MIGRATION_DATABASE_ROLE_VARIABLE_NAME} metadata variable.`);
|
|
5482
|
+
suggestions.add("Run `loom db migrations setup-github` with the migration URL loaded in the environment so Loom can record the expected non-secret role.");
|
|
5483
|
+
}
|
|
5484
|
+
for (const name of GITHUB_DATABASE_URL_VARIABLE_NAMES) {
|
|
5485
|
+
if (collectionHasName(name, environmentVariables, repoVariables)) {
|
|
5486
|
+
warnings.push(`GitHub Actions stores database credential ${name} as a readable variable.`);
|
|
5487
|
+
suggestions.add(`Rotate ${name} into the protected ${PRODUCTION_GITHUB_ENVIRONMENT} Environment secret ${GITHUB_MIGRATION_DATABASE_SECRET_NAME}, then delete the readable variable.`);
|
|
5488
|
+
}
|
|
5489
|
+
}
|
|
5372
5490
|
if (collectionHasName("VERCEL_DEPLOY_HOOK", environmentSecrets, repoSecrets) ||
|
|
5373
5491
|
[...STALE_GITHUB_RELEASE_SECRET_NAMES].some((name) => name.startsWith("VERCEL_DEPLOY") &&
|
|
5374
5492
|
collectionHasName(name, environmentSecrets, repoSecrets))) {
|
|
@@ -5959,6 +6077,54 @@ export async function setupVercelNeon(cwd, options = {}) {
|
|
|
5959
6077
|
notes,
|
|
5960
6078
|
};
|
|
5961
6079
|
}
|
|
6080
|
+
/**
|
|
6081
|
+
* Stores an already-provisioned direct migration URL in a protected GitHub
|
|
6082
|
+
* Environment without persisting or printing the credential.
|
|
6083
|
+
*/
|
|
6084
|
+
export async function setupGithubMigrationCredential(cwd, options = {}) {
|
|
6085
|
+
const commandRunner = options.commandRunner ?? defaultCommandRunner;
|
|
6086
|
+
const env = options.env ?? process.env;
|
|
6087
|
+
const environment = options.environment ?? PRODUCTION_GITHUB_ENVIRONMENT;
|
|
6088
|
+
const migration = resolveMigrationEnvironment(env);
|
|
6089
|
+
if (!migration.envName.startsWith("MIGRATION_")) {
|
|
6090
|
+
throw new Error(`Load ${GITHUB_MIGRATION_DATABASE_SECRET_NAME} in the process environment before running \`loom db migrations setup-github\`; application database fallbacks are not copied into GitHub.`);
|
|
6091
|
+
}
|
|
6092
|
+
if (!migration.direct) {
|
|
6093
|
+
throw new Error(`${migration.envName} appears pooled. Configure a direct, unpooled migration connection before storing it in GitHub.`);
|
|
6094
|
+
}
|
|
6095
|
+
const githubCli = await detectGithubCliCommand(cwd, commandRunner, env);
|
|
6096
|
+
if (!githubCli.command) {
|
|
6097
|
+
throw new Error("GitHub CLI is not available. Install and authenticate `gh` before running `loom db migrations setup-github`.");
|
|
6098
|
+
}
|
|
6099
|
+
await requireCommand(`Set GitHub ${GITHUB_MIGRATION_DATABASE_SECRET_NAME} secret`, commandRunner, githubCli.command, [
|
|
6100
|
+
"secret",
|
|
6101
|
+
"set",
|
|
6102
|
+
GITHUB_MIGRATION_DATABASE_SECRET_NAME,
|
|
6103
|
+
"--env",
|
|
6104
|
+
environment,
|
|
6105
|
+
], {
|
|
6106
|
+
cwd,
|
|
6107
|
+
env,
|
|
6108
|
+
input: env[migration.envName],
|
|
6109
|
+
stdio: "pipe",
|
|
6110
|
+
});
|
|
6111
|
+
await requireCommand(`Set GitHub ${GITHUB_MIGRATION_DATABASE_ROLE_VARIABLE_NAME} variable`, commandRunner, githubCli.command, [
|
|
6112
|
+
"variable",
|
|
6113
|
+
"set",
|
|
6114
|
+
GITHUB_MIGRATION_DATABASE_ROLE_VARIABLE_NAME,
|
|
6115
|
+
"--env",
|
|
6116
|
+
environment,
|
|
6117
|
+
"--body",
|
|
6118
|
+
migration.role,
|
|
6119
|
+
], { cwd, env, stdio: "pipe" });
|
|
6120
|
+
return {
|
|
6121
|
+
notes: [
|
|
6122
|
+
`Stored ${GITHUB_MIGRATION_DATABASE_SECRET_NAME} in the protected GitHub \`${environment}\` environment.`,
|
|
6123
|
+
`Recorded migration role ${migration.role} as ${GITHUB_MIGRATION_DATABASE_ROLE_VARIABLE_NAME}.`,
|
|
6124
|
+
"Vercel application database variables were not changed.",
|
|
6125
|
+
],
|
|
6126
|
+
};
|
|
6127
|
+
}
|
|
5962
6128
|
export async function setupGithubVercelRelease(cwd, options = {}) {
|
|
5963
6129
|
const commandRunner = options.commandRunner ?? defaultCommandRunner;
|
|
5964
6130
|
const env = options.env ?? process.env;
|
|
@@ -8421,7 +8587,11 @@ function printHelp({ out }) {
|
|
|
8421
8587
|
out(" db schemas sync Materialize active Loom-managed DB schema blueprints into app-local schema files.");
|
|
8422
8588
|
out(" db neon setup Provision and connect a Vercel-managed Neon database for Production and Preview.");
|
|
8423
8589
|
out(" db neon check Run the DB/Neon network checks registered for the active DB feature.");
|
|
8590
|
+
out(" db migrations verify-env Validate migration URL precedence and role metadata without printing credentials.");
|
|
8591
|
+
out(" db migrations setup-github Store an existing direct migration URL as a protected GitHub Environment secret.");
|
|
8424
8592
|
out(" db release setup-github Create/update GitHub production release config for staged Vercel deploys.");
|
|
8593
|
+
out(" db release prepare-build-env <env> <metadata> <policy> <manifest> Prepare metadata-backed placeholders for an external Vercel build.");
|
|
8594
|
+
out(" db release verify-build-env <output> <manifest> Reject build-only placeholders in a deployable Vercel artifact.");
|
|
8425
8595
|
out(" dev local Enable local Loom development using a managed file: override in pnpm-workspace.yaml.");
|
|
8426
8596
|
out(" dev sync Rebuild the local Loom package and refresh this project's pnpm install when the managed local-dev override is active.");
|
|
8427
8597
|
out(" dev published Remove the managed local-dev override and return to the published dependency.");
|
|
@@ -8450,6 +8620,7 @@ function printHelp({ out }) {
|
|
|
8450
8620
|
out(" --configure-secrets Ask Vercel to prompt securely for missing R2 credentials; never replaces existing credentials.");
|
|
8451
8621
|
out(" --repair Apply declared non-secret Files provider drift; never deletes resources or rotates credentials.");
|
|
8452
8622
|
out(" --token-name <name> Override the Vercel token name for `loom db release setup-github`.");
|
|
8623
|
+
out(" --environment <name> GitHub Environment for migration credential setup (default production).");
|
|
8453
8624
|
out(" --resource <name> Permission resource for API-key integration.");
|
|
8454
8625
|
out(" --action <name> Permission action for API-key integration.");
|
|
8455
8626
|
out(" --allow-query Allow the integration's explicit query credential transport.");
|
|
@@ -8976,14 +9147,39 @@ async function runDbNeon(cwd, command, io, options) {
|
|
|
8976
9147
|
return 1;
|
|
8977
9148
|
}
|
|
8978
9149
|
}
|
|
8979
|
-
async function runDbRelease(cwd, command, io, options) {
|
|
9150
|
+
async function runDbRelease(cwd, command, args, io, options) {
|
|
8980
9151
|
if (!command) {
|
|
8981
9152
|
io.err("Missing release subcommand. Example: `loom db release setup-github`.");
|
|
8982
9153
|
return 1;
|
|
8983
9154
|
}
|
|
8984
9155
|
switch (command) {
|
|
9156
|
+
case "prepare-build-env": {
|
|
9157
|
+
if (args.length !== 4) {
|
|
9158
|
+
io.err("Usage: loom db release prepare-build-env <env-file> <metadata-file> <policy-file> <manifest-file>");
|
|
9159
|
+
return 1;
|
|
9160
|
+
}
|
|
9161
|
+
prepareVercelBuildEnvironment({
|
|
9162
|
+
envFile: resolve(cwd, args[0]),
|
|
9163
|
+
manifestFile: resolve(cwd, args[3]),
|
|
9164
|
+
metadataFile: resolve(cwd, args[1]),
|
|
9165
|
+
policyFile: resolve(cwd, args[2]),
|
|
9166
|
+
}, io);
|
|
9167
|
+
return 0;
|
|
9168
|
+
}
|
|
9169
|
+
case "verify-build-env": {
|
|
9170
|
+
if (args.length !== 2) {
|
|
9171
|
+
io.err("Usage: loom db release verify-build-env <output-directory> <manifest-file>");
|
|
9172
|
+
return 1;
|
|
9173
|
+
}
|
|
9174
|
+
verifyVercelBuildArtifact({
|
|
9175
|
+
manifestFile: resolve(cwd, args[1]),
|
|
9176
|
+
outputDirectory: resolve(cwd, args[0]),
|
|
9177
|
+
}, io);
|
|
9178
|
+
return 0;
|
|
9179
|
+
}
|
|
8985
9180
|
case "setup-github": {
|
|
8986
9181
|
const result = await setupGithubVercelRelease(cwd, {
|
|
9182
|
+
environment: options.environment,
|
|
8987
9183
|
io,
|
|
8988
9184
|
tokenName: options.tokenName,
|
|
8989
9185
|
});
|
|
@@ -8999,6 +9195,39 @@ async function runDbRelease(cwd, command, io, options) {
|
|
|
8999
9195
|
return 1;
|
|
9000
9196
|
}
|
|
9001
9197
|
}
|
|
9198
|
+
async function runDbMigrations(cwd, command, io, options) {
|
|
9199
|
+
if (!command) {
|
|
9200
|
+
io.err("Missing migrations subcommand. Example: `loom db migrations verify-env`.");
|
|
9201
|
+
return 1;
|
|
9202
|
+
}
|
|
9203
|
+
switch (command) {
|
|
9204
|
+
case "setup-github": {
|
|
9205
|
+
const result = await setupGithubMigrationCredential(cwd, {
|
|
9206
|
+
environment: options.environment,
|
|
9207
|
+
});
|
|
9208
|
+
for (const note of result.notes) {
|
|
9209
|
+
io.out(`Note: ${note}`);
|
|
9210
|
+
}
|
|
9211
|
+
io.out("Next step: update the release workflow to bind `secrets.MIGRATION_DATABASE_URL_UNPOOLED`, then run `loom check --production --network`.");
|
|
9212
|
+
return 0;
|
|
9213
|
+
}
|
|
9214
|
+
case "verify-env": {
|
|
9215
|
+
const result = resolveMigrationEnvironment(process.env);
|
|
9216
|
+
io.out(`Migration database environment is usable: ${result.envName} selects role ${result.role} and database ${result.database}.`);
|
|
9217
|
+
if (!result.envName.startsWith("MIGRATION_")) {
|
|
9218
|
+
io.out("Warning: using the gradual-adoption application database fallback; prefer MIGRATION_DATABASE_URL_UNPOOLED after provisioning a dedicated migration credential.");
|
|
9219
|
+
}
|
|
9220
|
+
if (!result.direct) {
|
|
9221
|
+
io.out("Warning: the selected URL appears pooled; migrations should prefer a direct, unpooled connection.");
|
|
9222
|
+
}
|
|
9223
|
+
return 0;
|
|
9224
|
+
}
|
|
9225
|
+
default:
|
|
9226
|
+
io.err(`Unknown migrations subcommand: ${command}`);
|
|
9227
|
+
io.err("Run `loom --help` for usage.");
|
|
9228
|
+
return 1;
|
|
9229
|
+
}
|
|
9230
|
+
}
|
|
9002
9231
|
async function runDb(cwd, command, args, io, options = {}) {
|
|
9003
9232
|
if (!command) {
|
|
9004
9233
|
io.err("Missing db subcommand. Example: `loom db schema-gen`.");
|
|
@@ -9013,8 +9242,10 @@ async function runDb(cwd, command, args, io, options = {}) {
|
|
|
9013
9242
|
return await runDbSchemas(cwd, args[0], io);
|
|
9014
9243
|
case "neon":
|
|
9015
9244
|
return await runDbNeon(cwd, args[0], io, options);
|
|
9245
|
+
case "migrations":
|
|
9246
|
+
return await runDbMigrations(cwd, args[0], io, options);
|
|
9016
9247
|
case "release":
|
|
9017
|
-
return await runDbRelease(cwd, args[0], io, options);
|
|
9248
|
+
return await runDbRelease(cwd, args[0], args.slice(1), io, options);
|
|
9018
9249
|
default:
|
|
9019
9250
|
io.err(`Unknown db subcommand: ${command}`);
|
|
9020
9251
|
io.err("Run `loom --help` for usage.");
|
|
@@ -9160,6 +9391,7 @@ export async function runCli(args = process.argv.slice(2), io = {
|
|
|
9160
9391
|
"cleanup-batch-size": { type: "string" },
|
|
9161
9392
|
"configure-secrets": { type: "boolean" },
|
|
9162
9393
|
cwd: { type: "string" },
|
|
9394
|
+
environment: { type: "string" },
|
|
9163
9395
|
force: { type: "boolean" },
|
|
9164
9396
|
help: { short: "h", type: "boolean" },
|
|
9165
9397
|
jurisdiction: { type: "string" },
|
|
@@ -9262,6 +9494,7 @@ export async function runCli(args = process.argv.slice(2), io = {
|
|
|
9262
9494
|
case "db":
|
|
9263
9495
|
return await runDb(cwd, arg1, [arg2, ...rest].filter(Boolean), io, {
|
|
9264
9496
|
name: parsed.values.name,
|
|
9497
|
+
environment: parsed.values.environment,
|
|
9265
9498
|
noColor: parsed.values["no-color"],
|
|
9266
9499
|
noProgress: parsed.values["no-progress"],
|
|
9267
9500
|
neonAuth: parsed.values["neon-auth"],
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
type BuildPlaceholder = {
|
|
2
|
+
key: string;
|
|
3
|
+
marker: string;
|
|
4
|
+
requirement: string;
|
|
5
|
+
};
|
|
6
|
+
type CliOutput = {
|
|
7
|
+
out: (line: string) => void;
|
|
8
|
+
};
|
|
9
|
+
export declare function isUsablePulledValue(value: string | undefined): boolean;
|
|
10
|
+
/**
|
|
11
|
+
* Validates required Production variables and fills unreadable Sensitive values
|
|
12
|
+
* with unique build-only placeholders without replacing readable pulled values.
|
|
13
|
+
*/
|
|
14
|
+
export declare function prepareVercelBuildEnvironment({ envFile, manifestFile, metadataFile, policyFile, }: {
|
|
15
|
+
envFile: string;
|
|
16
|
+
manifestFile: string;
|
|
17
|
+
metadataFile: string;
|
|
18
|
+
policyFile: string;
|
|
19
|
+
}, io?: CliOutput): {
|
|
20
|
+
placeholders: BuildPlaceholder[];
|
|
21
|
+
};
|
|
22
|
+
/**
|
|
23
|
+
* Rejects a Vercel artifact containing any unique build-only marker.
|
|
24
|
+
*/
|
|
25
|
+
export declare function verifyVercelBuildArtifact({ manifestFile, outputDirectory, }: {
|
|
26
|
+
manifestFile: string;
|
|
27
|
+
outputDirectory: string;
|
|
28
|
+
}, io?: CliOutput): void;
|
|
29
|
+
export {};
|
|
30
|
+
//# sourceMappingURL=vercelBuildEnv.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"vercelBuildEnv.d.ts","sourceRoot":"","sources":["../../../src/src/cli/vercelBuildEnv.ts"],"names":[],"mappings":"AAyBA,KAAK,gBAAgB,GAAG;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAMF,KAAK,SAAS,GAAG;IACf,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B,CAAC;AAgBF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,WAG5D;AAmFD;;;GAGG;AACH,wBAAgB,6BAA6B,CAC3C,EACE,OAAO,EACP,YAAY,EACZ,YAAY,EACZ,UAAU,GACX,EAAE;IACD,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB,EACD,EAAE,GAAE,SAAgD;;EAoGrD;AAeD;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,EACE,YAAY,EACZ,eAAe,GAChB,EAAE;IACD,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;CACzB,EACD,EAAE,GAAE,SAAgD,QAyCrD"}
|