@geekmidas/cli 10.0.0-alpha.11 → 10.0.0-alpha.110

package/dist/migrate-BZ0GnSZQ.mjs

@@ -0,0 +1,181 @@
+import { t as GkmError } from "./errors-D8Gwp5kU.mjs";
+import { N as assertDeployedStage, ct as UnknownSecretsStoreProvider, st as SECRETS_STORE_PROVIDERS, ut as s3SecretsLocation } from "./workspace-D1QbNd55.mjs";
+import { It as secretsStoreFor, Lt as storeFromConfig } from "./seeds-BjcO4DDa.mjs";
+import { loadWorkspaceSettings } from "./config.mjs";
+import { n as secretsParameterName } from "./aws-8QQ8n-t6.mjs";
+import { t as secretsManagerSecretName } from "./secretsManager-CQORubp9.mjs";
+import { isDeepStrictEqual } from "node:util";
+//#region src/secrets/migrate.ts
+/**
+* `gkm secrets:migrate` — copy a deployed stage's secrets from the store
+* `secrets.store` names to another one, whole: service passwords, URLs and
+* custom keys alike, so nothing is regenerated and running services keep
+* their credentials.
+*
+* It copies, reads the copy back and compares it, and nothing more. The source
+* is never deleted, and gkm.config.ts is not edited: pointing `secrets.store`
+* at the new store is the switch, and the old copy is deleted by hand — with
+* the command this prints — once deploys read from the new one. Run again, a
+* target already holding the same secrets is verified and left alone.
+*/
+const logger = console;
+/** An AWS store to copy to, with no region given and none configured. */
+var MigrateTargetNeedsRegion = class extends GkmError {
+	to;
+	constructor(to) {
+		super(`Copying to ${to} needs a region, and secrets.store has none to reuse. Pass it: gkm secrets:migrate --to ${to} --region <region> --stage <stage>.`);
+		this.to = to;
+		this.name = "MigrateTargetNeedsRegion";
+	}
+};
+/** The target is the store the stage is already read from. */
+var MigrateTargetIsSource = class extends GkmError {
+	stage;
+	to;
+	constructor(stage, to) {
+		super(`Stage "${stage}" is already kept in ${to}, so there is nothing to copy. Name a different store with --to, or a different region with --region.`);
+		this.stage = stage;
+		this.to = to;
+		this.name = "MigrateTargetIsSource";
+	}
+};
+/** The configured store holds nothing for the stage. */
+var NoSecretsToMigrate = class extends GkmError {
+	stage;
+	store;
+	constructor(stage, store) {
+		super(`The ${store} store holds no secrets for stage "${stage}", so there is nothing to copy. Check secrets.store in gkm.config.ts still names the store the stage is in, or create the stage there with gkm secrets:init --stage ${stage}.`);
+		this.stage = stage;
+		this.store = store;
+		this.name = "NoSecretsToMigrate";
+	}
+};
+/**
+* The target already holds different secrets for the stage, and `--force` was
+* not given.
+*/
+var MigrateTargetHoldsStage = class extends GkmError {
+	stage;
+	to;
+	constructor(stage, to) {
+		super(`The ${to} store already holds different secrets for stage "${stage}". Pass --force to replace them with the ones being copied.`);
+		this.stage = stage;
+		this.to = to;
+		this.name = "MigrateTargetHoldsStage";
+	}
+};
+/** The copy read back from the target is not what was copied. */
+var MigratedSecretsDiffer = class extends GkmError {
+	stage;
+	to;
+	keys;
+	constructor(stage, to, keys) {
+		super(`The secrets for stage "${stage}" read back from ${to} differ from the ones copied` + (keys.length ? ` (${keys.join(", ")})` : "") + ". The source is untouched and secrets.store still names it; run the migration again, or with --force if something else is writing to the target.");
+		this.stage = stage;
+		this.to = to;
+		this.keys = keys;
+		this.name = "MigratedSecretsDiffer";
+	}
+};
+/** The region the configured store is in, where it is an AWS one. */
+function configuredRegion(configured, state) {
+	if (typeof configured !== "object") return void 0;
+	if (configured.provider === "s3") return s3SecretsLocation(configured, state).region;
+	return "region" in configured ? configured.region : void 0;
+}
+/** The store a `--to` name and region describe. */
+function targetConfig(to, region, configured, state) {
+	if (!SECRETS_STORE_PROVIDERS.includes(to)) throw new UnknownSecretsStoreProvider(to);
+	const provider = to;
+	if (provider === "file") return "file";
+	const fallback = configuredRegion(configured, state);
+	if (provider === "s3") {
+		const inherits = typeof state === "object" && state !== null && state.provider === "s3";
+		const resolved = region ?? (inherits ? void 0 : fallback);
+		if (!resolved && !inherits) throw new MigrateTargetNeedsRegion(provider);
+		return {
+			provider,
+			...resolved ? { region: resolved } : {}
+		};
+	}
+	const resolved = region ?? fallback;
+	if (!resolved) throw new MigrateTargetNeedsRegion(provider);
+	return {
+		provider,
+		region: resolved
+	};
+}
+/** Whether two configs name the same place. */
+function samePlace(a, b, state) {
+	if (typeof a === "string" || typeof b === "string") return a === b;
+	if (a.provider !== b.provider) return false;
+	if (a.provider === "s3" && b.provider === "s3") return isDeepStrictEqual(s3SecretsLocation(a, state), s3SecretsLocation(b, state));
+	return "region" in a && "region" in b && a.region === b.region;
+}
+/** The `secrets.store` value to write in gkm.config.ts. */
+function configLine(target) {
+	if (typeof target === "string") return `'${target}'`;
+	const region = "region" in target && target.region ? `, region: '${target.region}'` : "";
+	return `{ provider: '${String(target.provider)}'${region} }`;
+}
+/** The keys whose values differ between two documents, as `section.KEY`. */
+function differingKeys(a, b) {
+	const keys = [];
+	for (const section of [
+		"custom",
+		"urls",
+		"services"
+	]) {
+		const left = a[section];
+		const right = b?.[section] ?? {};
+		for (const key of /* @__PURE__ */ new Set([...Object.keys(left), ...Object.keys(right)])) if (!isDeepStrictEqual(left[key], right[key])) keys.push(`${section}.${key}`);
+	}
+	return keys.sort();
+}
+/**
+* The command that deletes the stage's copy in the source store, for the
+* person to run once deploys read from the target — gkm never runs it.
+*/
+function deleteSourceCommand(workspace, configured, source, stage, profile) {
+	const as = profile ? ` --profile ${profile}` : "";
+	if (configured === "file") return `rm .gkm/secrets/${stage}.json`;
+	switch (configured.provider) {
+		case "ssm": return `aws ssm delete-parameter --name ${secretsParameterName(workspace.name, stage)} --region ${configured.region}${as}`;
+		case "secrets-manager": return `aws secretsmanager delete-secret --secret-id ${secretsManagerSecretName(workspace.name, stage)} --region ${configured.region}${as}`;
+		case "s3": {
+			const location = source.location?.(stage);
+			if (!location) return null;
+			return `aws s3 rm ${location}${as}`;
+		}
+		default: return null;
+	}
+}
+async function secretsMigrateCommand(options) {
+	const { stage, to } = options;
+	const workspace = await loadWorkspaceSettings();
+	assertDeployedStage(workspace.stages, stage);
+	const configured = workspace.secrets.store ?? "file";
+	const target = targetConfig(to, options.region, configured, workspace.state);
+	if (samePlace(configured, target, workspace.state)) throw new MigrateTargetIsSource(stage, to);
+	const storeOptions = options.profile ? { profile: options.profile } : {};
+	const source = await secretsStoreFor(workspace, stage, storeOptions);
+	const destination = await storeFromConfig(workspace, target, storeOptions);
+	const secrets = await source.read(stage);
+	if (!secrets) throw new NoSecretsToMigrate(stage, source.name);
+	const held = await destination.read(stage);
+	const already = held !== null && isDeepStrictEqual(held, secrets);
+	if (held && !already && !options.force) throw new MigrateTargetHoldsStage(stage, destination.name);
+	if (!already) await destination.write(stage, secrets);
+	const copied = await (await storeFromConfig(workspace, target, storeOptions)).read(stage);
+	if (!isDeepStrictEqual(copied, secrets)) throw new MigratedSecretsDiffer(stage, destination.name, differingKeys(secrets, copied));
+	const count = Object.keys(secrets.custom).length + Object.keys(secrets.urls).length + Object.keys(secrets.services).length;
+	logger.log(already ? `\n✓ ${destination.name} already holds the same secrets for stage "${stage}" as ${source.name}; nothing copied` : `\n✓ Copied the secrets for stage "${stage}" from ${source.name} to ${destination.name}`);
+	logger.log(`  Verified: ${count} keys read back from ${destination.name}, equal.`);
+	logger.log(`\n  Next: set secrets.store to ${configLine(target)} in gkm.config.ts, so commands and deploys read from ${destination.name}.`);
+	const remove = deleteSourceCommand(workspace, configured, source, stage, options.profile);
+	logger.log(`  The copy in ${source.name} is left as it was. Once deploys read from ${destination.name}, delete it` + (remove ? ` with:\n\n    ${remove}\n` : "."));
+}
+//#endregion
+export { secretsMigrateCommand };
+
+//# sourceMappingURL=migrate-BZ0GnSZQ.mjs.map

package/dist/migrate-BZ0GnSZQ.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate-BZ0GnSZQ.mjs","names":[],"sources":["../src/secrets/migrate.ts"],"sourcesContent":["/**\n * `gkm secrets:migrate` — copy a deployed stage's secrets from the store\n * `secrets.store` names to another one, whole: service passwords, URLs and\n * custom keys alike, so nothing is regenerated and running services keep\n * their credentials.\n *\n * It copies, reads the copy back and compares it, and nothing more. The source\n * is never deleted, and gkm.config.ts is not edited: pointing `secrets.store`\n * at the new store is the switch, and the old copy is deleted by hand — with\n * the command this prints — once deploys read from the new one. Run again, a\n * target already holding the same secrets is verified and left alone.\n */\n\nimport { isDeepStrictEqual } from 'node:util';\n\nimport { loadWorkspaceSettings } from '../config.js';\nimport { GkmError } from '../errors';\nimport { assertDeployedStage } from '../workspace/stages.js';\nimport { secretsParameterName } from './aws.js';\nimport { secretsManagerSecretName } from './secretsManager.js';\nimport {\n\tSECRETS_STORE_PROVIDERS,\n\ttype SecretsStore,\n\ttype SecretsStoreConfig,\n\ttype SecretsStoreOptions,\n\ttype SecretsStoreProvider,\n\ts3SecretsLocation,\n\tsecretsStoreFor,\n\tstoreFromConfig,\n\tUnknownSecretsStoreProvider,\n} from './store.js';\nimport type { StageSecrets } from './types.js';\n\nconst logger = console;\n\nexport interface SecretsMigrateOptions {\n\tstage: string;\n\t/** The store to copy to: `'file'`, `'s3'`, `'ssm'` or `'secrets-manager'`. */\n\tto: string;\n\t/**\n\t * The target's AWS region; defaults to the configured store's — for `s3`,\n\t * to the S3 state's first.\n\t */\n\tregion?: string;\n\t/** Overwrite a stage the target already holds different secrets for. */\n\tforce?: boolean;\n\t/** The AWS profile for the stage's account, for both stores. */\n\tprofile?: string;\n}\n\n/** An AWS store to copy to, with no region given and none configured. */\nexport class MigrateTargetNeedsRegion extends GkmError {\n\tconstructor(readonly to: string) {\n\t\tsuper(\n\t\t\t`Copying to ${to} needs a region, and secrets.store has none to reuse. ` +\n\t\t\t\t`Pass it: gkm secrets:migrate --to ${to} --region <region> --stage <stage>.`,\n\t\t);\n\t\tthis.name = 'MigrateTargetNeedsRegion';\n\t}\n}\n\n/** The target is the store the stage is already read from. */\nexport class MigrateTargetIsSource extends GkmError {\n\tconstructor(\n\t\treadonly stage: string,\n\t\treadonly to: string,\n\t) {\n\t\tsuper(\n\t\t\t`Stage \"${stage}\" is already kept in ${to}, so there is nothing to copy. ` +\n\t\t\t\t'Name a different store with --to, or a different region with --region.',\n\t\t);\n\t\tthis.name = 'MigrateTargetIsSource';\n\t}\n}\n\n/** The configured store holds nothing for the stage. */\nexport class NoSecretsToMigrate extends GkmError {\n\tconstructor(\n\t\treadonly stage: string,\n\t\treadonly store: string,\n\t) {\n\t\tsuper(\n\t\t\t`The ${store} store holds no secrets for stage \"${stage}\", so there is nothing to copy. ` +\n\t\t\t\t`Check secrets.store in gkm.config.ts still names the store the stage is in, ` +\n\t\t\t\t`or create the stage there with gkm secrets:init --stage ${stage}.`,\n\t\t);\n\t\tthis.name = 'NoSecretsToMigrate';\n\t}\n}\n\n/**\n * The target already holds different secrets for the stage, and `--force` was\n * not given.\n */\nexport class MigrateTargetHoldsStage extends GkmError {\n\tconstructor(\n\t\treadonly stage: string,\n\t\treadonly to: string,\n\t) {\n\t\tsuper(\n\t\t\t`The ${to} store already holds different secrets for stage \"${stage}\". ` +\n\t\t\t\t'Pass --force to replace them with the ones being copied.',\n\t\t);\n\t\tthis.name = 'MigrateTargetHoldsStage';\n\t}\n}\n\n/** The copy read back from the target is not what was copied. */\nexport class MigratedSecretsDiffer extends GkmError {\n\tconstructor(\n\t\treadonly stage: string,\n\t\treadonly to: string,\n\t\t/** The keys whose values differ, or that only one side has. */\n\t\treadonly keys: readonly string[],\n\t) {\n\t\tsuper(\n\t\t\t`The secrets for stage \"${stage}\" read back from ${to} differ from the ones copied` +\n\t\t\t\t(keys.length ? ` (${keys.join(', ')})` : '') +\n\t\t\t\t'. The source is untouched and secrets.store still names it; run the migration again, ' +\n\t\t\t\t'or with --force if something else is writing to the target.',\n\t\t);\n\t\tthis.name = 'MigratedSecretsDiffer';\n\t}\n}\n\n/** The region the configured store is in, where it is an AWS one. */\nfunction configuredRegion(\n\tconfigured: SecretsStoreConfig,\n\tstate: unknown,\n): string | undefined {\n\tif (typeof configured !== 'object') return undefined;\n\tif (configured.provider === 's3') {\n\t\treturn s3SecretsLocation(configured, state).region;\n\t}\n\t// A custom store has no region to reuse.\n\treturn 'region' in configured ? configured.region : undefined;\n}\n\n/** The store a `--to` name and region describe. */\nfunction targetConfig(\n\tto: string,\n\tregion: string | undefined,\n\tconfigured: SecretsStoreConfig,\n\tstate: unknown,\n): SecretsStoreConfig {\n\tif (!(SECRETS_STORE_PROVIDERS as readonly string[]).includes(to)) {\n\t\tthrow new UnknownSecretsStoreProvider(to);\n\t}\n\tconst provider = to as SecretsStoreProvider;\n\tif (provider === 'file') return 'file';\n\n\tconst fallback = configuredRegion(configured, state);\n\n\tif (provider === 's3') {\n\t\t// The project bucket beside an S3 state is in the state's region.\n\t\tconst inherits =\n\t\t\ttypeof state === 'object' &&\n\t\t\tstate !== null &&\n\t\t\t(state as { provider?: unknown }).provider === 's3';\n\t\tconst resolved = region ?? (inherits ? undefined : fallback);\n\t\tif (!resolved && !inherits) throw new MigrateTargetNeedsRegion(provider);\n\t\treturn { provider, ...(resolved ? { region: resolved } : {}) };\n\t}\n\n\tconst resolved = region ?? fallback;\n\tif (!resolved) throw new MigrateTargetNeedsRegion(provider);\n\treturn { provider, region: resolved };\n}\n\n/** Whether two configs name the same place. */\nfunction samePlace(\n\ta: SecretsStoreConfig,\n\tb: SecretsStoreConfig,\n\tstate: unknown,\n): boolean {\n\tif (typeof a === 'string' || typeof b === 'string') return a === b;\n\tif (a.provider !== b.provider) return false;\n\tif (a.provider === 's3' && b.provider === 's3') {\n\t\treturn isDeepStrictEqual(\n\t\t\ts3SecretsLocation(a, state),\n\t\t\ts3SecretsLocation(b, state),\n\t\t);\n\t}\n\treturn 'region' in a && 'region' in b && a.region === b.region;\n}\n\n/** The `secrets.store` value to write in gkm.config.ts. */\nfunction configLine(target: SecretsStoreConfig): string {\n\tif (typeof target === 'string') return `'${target}'`;\n\tconst region =\n\t\t'region' in target && target.region ? `, region: '${target.region}'` : '';\n\treturn `{ provider: '${String(target.provider)}'${region} }`;\n}\n\n/** The keys whose values differ between two documents, as `section.KEY`. */\nexport function differingKeys(\n\ta: StageSecrets,\n\tb: StageSecrets | null,\n): string[] {\n\tconst keys: string[] = [];\n\tfor (const section of ['custom', 'urls', 'services'] as const) {\n\t\tconst left = a[section] as Record<string, unknown>;\n\t\tconst right = (b?.[section] ?? {}) as Record<string, unknown>;\n\t\tfor (const key of new Set([...Object.keys(left), ...Object.keys(right)])) {\n\t\t\tif (!isDeepStrictEqual(left[key], right[key])) {\n\t\t\t\tkeys.push(`${section}.${key}`);\n\t\t\t}\n\t\t}\n\t}\n\treturn keys.sort();\n}\n\n/**\n * The command that deletes the stage's copy in the source store, for the\n * person to run once deploys read from the target — gkm never runs it.\n */\nexport function deleteSourceCommand(\n\tworkspace: { name: string },\n\tconfigured: SecretsStoreConfig,\n\tsource: SecretsStore,\n\tstage: string,\n\tprofile: string | undefined,\n): string | null {\n\tconst as = profile ? ` --profile ${profile}` : '';\n\tif (configured === 'file') return `rm .gkm/secrets/${stage}.json`;\n\tswitch (configured.provider) {\n\t\tcase 'ssm':\n\t\t\treturn `aws ssm delete-parameter --name ${secretsParameterName(workspace.name, stage)} --region ${configured.region}${as}`;\n\t\tcase 'secrets-manager':\n\t\t\treturn `aws secretsmanager delete-secret --secret-id ${secretsManagerSecretName(workspace.name, stage)} --region ${configured.region}${as}`;\n\t\tcase 's3': {\n\t\t\tconst location = (\n\t\t\t\tsource as { location?(stage: string): string }\n\t\t\t).location?.(stage);\n\t\t\tif (!location) return null;\n\t\t\t// Every version, as the bucket keeps them: only a delete marker is added.\n\t\t\treturn `aws s3 rm ${location}${as}`;\n\t\t}\n\t\tdefault:\n\t\t\treturn null;\n\t}\n}\n\nexport async function secretsMigrateCommand(\n\toptions: SecretsMigrateOptions,\n): Promise<void> {\n\tconst { stage, to } = options;\n\tconst workspace = await loadWorkspaceSettings();\n\tassertDeployedStage(workspace.stages, stage);\n\n\tconst configured = workspace.secrets.store ?? 'file';\n\tconst target = targetConfig(to, options.region, configured, workspace.state);\n\tif (samePlace(configured, target, workspace.state)) {\n\t\tthrow new MigrateTargetIsSource(stage, to);\n\t}\n\n\tconst storeOptions: SecretsStoreOptions = options.profile\n\t\t? { profile: options.profile }\n\t\t: {};\n\tconst source = await secretsStoreFor(workspace, stage, storeOptions);\n\tconst destination = await storeFromConfig(workspace, target, storeOptions);\n\n\tconst secrets = await source.read(stage);\n\tif (!secrets) throw new NoSecretsToMigrate(stage, source.name);\n\n\tconst held = await destination.read(stage);\n\tconst already = held !== null && isDeepStrictEqual(held, secrets);\n\tif (held && !already && !options.force) {\n\t\tthrow new MigrateTargetHoldsStage(stage, destination.name);\n\t}\n\tif (!already) await destination.write(stage, secrets);\n\n\t// Read back through a store of its own, so nothing cached answers.\n\tconst copied = await (\n\t\tawait storeFromConfig(workspace, target, storeOptions)\n\t).read(stage);\n\tif (!isDeepStrictEqual(copied, secrets)) {\n\t\tthrow new MigratedSecretsDiffer(\n\t\t\tstage,\n\t\t\tdestination.name,\n\t\t\tdifferingKeys(secrets, copied),\n\t\t);\n\t}\n\n\tconst count =\n\t\tObject.keys(secrets.custom).length +\n\t\tObject.keys(secrets.urls).length +\n\t\tObject.keys(secrets.services).length;\n\tlogger.log(\n\t\talready\n\t\t\t? `\\n✓ ${destination.name} already holds the same secrets for stage \"${stage}\" as ${source.name}; nothing copied`\n\t\t\t: `\\n✓ Copied the secrets for stage \"${stage}\" from ${source.name} to ${destination.name}`,\n\t);\n\tlogger.log(\n\t\t`  Verified: ${count} keys read back from ${destination.name}, equal.`,\n\t);\n\tlogger.log(\n\t\t`\\n  Next: set secrets.store to ${configLine(target)} in gkm.config.ts, so commands and deploys read from ${destination.name}.`,\n\t);\n\tconst remove = deleteSourceCommand(\n\t\tworkspace,\n\t\tconfigured,\n\t\tsource,\n\t\tstage,\n\t\toptions.profile,\n\t);\n\tlogger.log(\n\t\t`  The copy in ${source.name} is left as it was. Once deploys read from ${destination.name}, delete it` +\n\t\t\t(remove ? ` with:\\n\\n    ${remove}\\n` : '.'),\n\t);\n}\n"],"mappings":"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"}

package/dist/migrate-CTqhWtev.cjs

@@ -0,0 +1,271 @@
+const require_errors = require("./errors-DMC4Umsb.cjs");
+const require_workspace = require("./workspace-BwqQnool.cjs");
+const require_seeds = require("./seeds-DNqRA1aQ.cjs");
+const require_discover = require("./discover-Bsr7HjqJ.cjs");
+const require_config = require("./config.cjs");
+const require_databases = require("./databases-DGALFDG3.cjs");
+const require_index = require("./index.cjs");
+let node_path = require("node:path");
+let node_fs_promises = require("node:fs/promises");
+let _geekmidas_manifest = require("@geekmidas/manifest");
+let _geekmidas_envkit = require("@geekmidas/envkit");
+let _geekmidas_services = require("@geekmidas/services");
+//#region src/migrate/index.ts
+/**
+* `gkm migrate`, `gkm seed` and `gkm migration` — applying a construct's
+* migrations, running its seeds, and writing its next migration.
+*
+* Both work on a stage this machine reconciles: its containers up, its roles
+* provisioned, its owner URLs resolved. A deployed stage is migrated by the
+* deploy that ships it, which is the one thing that can reach its database.
+*/
+const logger = console;
+/** `gkm migrate --stage` named a stage only a deploy can reach. */
+var MigrateDeployedStage = class extends require_errors.GkmError {
+	stage;
+	local;
+	constructor(stage, local) {
+		super(`'${stage}' is a deployed stage, and its database is migrated by \`gkm deploy --stage ${stage}\`, which is what can reach it. \`gkm migrate\` runs against '${local}' or '${require_workspace.TEST_STAGE}'.`);
+		this.stage = stage;
+		this.local = local;
+		this.name = "MigrateDeployedStage";
+	}
+};
+/** `gkm migration` for a Kysely database, with no name for the file. */
+var MigrationNeedsName = class extends require_errors.GkmError {
+	construct;
+	constructor(construct) {
+		super(`Name the migration: \`gkm migration ${construct} add_workouts\`. The name is what the file — and the history — calls it.`);
+		this.construct = construct;
+		this.name = "MigrationNeedsName";
+	}
+};
+/**
+* Reconcile a stage so it can be migrated: containers up, databases, schemas,
+* roles and grants in place, owner URLs resolved.
+*
+* Migrating assumes the roles exist, and this is what makes that true rather
+* than something a developer has to have run first.
+*/
+async function readyStage(cwd, stage) {
+	const { workspace } = await require_config.loadWorkspaceConfig(cwd);
+	const local = workspace.stages.local;
+	const target = stage ?? local;
+	if (target !== local && target !== "test") throw new MigrateDeployedStage(target, local);
+	const sources = {};
+	const manifest = await require_discover.discover({
+		patterns: require_seeds.constructGlobs(workspace),
+		cwd: workspace.root,
+		sources
+	});
+	return {
+		workspace,
+		manifest,
+		sources,
+		env: { ...(await require_seeds.reconcileWorkspace(workspace, {
+			stage: target,
+			manifest,
+			start: true
+		})).env },
+		stage: target
+	};
+}
+/** `gkm migrate [construct]`. */
+async function migrateCommand(options = {}) {
+	const ready = await readyStage(process.cwd(), options.stage);
+	const runs = await require_databases.migrateDatabases({
+		root: ready.workspace.root,
+		manifest: ready.manifest,
+		sources: ready.sources,
+		env: ready.env,
+		...options.construct ? { only: options.construct } : {}
+	});
+	if (runs.length === 0) {
+		logger.log("🗄️  No database constructs to migrate.");
+		return;
+	}
+	logMigrations(runs);
+}
+/**
+* `gkm seed [construct]` — migrate, then run the seeds.
+*
+* Always migrates first: a seed is written against the schema its migrations
+* build, and against an older one it fails on a table that is not there yet.
+*/
+async function seedCommand(options = {}) {
+	const ready = await readyStage(process.cwd(), options.stage);
+	const { migrations, seeds } = await require_databases.migrateAndSeed({
+		root: ready.workspace.root,
+		manifest: ready.manifest,
+		sources: ready.sources,
+		env: ready.env,
+		stage: ready.stage,
+		...options.construct ? { only: options.construct } : {}
+	});
+	if (migrations.length === 0) {
+		logger.log("🗄️  No database constructs to seed.");
+		return;
+	}
+	logMigrations(migrations);
+	logSeeds(seeds);
+}
+/** One line per construct: up to date, or what was applied. */
+function logMigrations(runs, log = logger.log) {
+	for (const { target, applied } of runs) {
+		if (applied.length === 0) {
+			log(`🗄️  ${target.migrations}: up to date`);
+			continue;
+		}
+		log(`🗄️  ${target.migrations}: applied ${applied.length}`);
+		for (const name of applied) log(`   ✓ ${name}`);
+	}
+}
+/** One line per construct that has seeds, and each seed it ran. */
+function logSeeds(runs, log = logger.log) {
+	for (const { target, seeded } of runs) {
+		if (seeded.length === 0) continue;
+		log(`🌱 ${target.seeds}: ran ${seeded.length}`);
+		for (const name of seeded) log(`   ✓ ${name}`);
+	}
+}
+/**
+* What `gkm dev` prints: one line per construct whose folder is ahead of its
+* history, and nothing when every folder is applied.
+*
+* Reported, never applied. A migration being written would otherwise run the
+* moment its file is saved, half-finished, against the database the developer
+* is working in.
+*/
+async function reportPendingMigrations(workspace, env) {
+	const sources = {};
+	const manifest = await require_discover.discover({
+		patterns: require_seeds.constructGlobs(workspace),
+		cwd: workspace.root,
+		sources
+	});
+	const pending = await require_databases.pendingMigrations({
+		root: workspace.root,
+		manifest,
+		sources,
+		env
+	});
+	for (const { target, pending: names } of pending) logger.log(`⚠️  ${target.migrations}: ${names.length} pending (${names.join(", ")}) — run gkm migrate`);
+}
+/**
+* What `gkm dev --migrate` and `gkm dev --seed` do before the apps start:
+* migrate, and with `seed`, run the seeds after — once, at startup, never on a
+* save, for the reason {@link reportPendingMigrations} gives.
+*
+* A failure here is thrown, unlike the report's: the developer asked for the
+* database to be brought up to date, and apps started against one in an
+* unknown state would fail somewhere less obvious.
+*/
+async function prepareDevDatabases(workspace, env, { seed = false } = {}) {
+	const sources = {};
+	const manifest = await require_discover.discover({
+		patterns: require_seeds.constructGlobs(workspace),
+		cwd: workspace.root,
+		sources
+	});
+	const options = {
+		root: workspace.root,
+		manifest,
+		sources,
+		env
+	};
+	if (!seed) {
+		logMigrations(await require_databases.migrateDatabases(options));
+		return;
+	}
+	const { migrations, seeds } = await require_databases.migrateAndSeed({
+		...options,
+		stage: workspace.stages.local
+	});
+	logMigrations(migrations);
+	logSeeds(seeds);
+}
+/**
+* `gkm migration <construct> [name]` — write the construct's next migration.
+*
+* For a database, an empty `up`/`down` to fill in. For an auth server, what
+* its schema is missing, computed against its tenant once every committed
+* migration has been applied — so the file is only the change, and is
+* reviewed and committed like any other.
+*/
+async function migrationCommand(options) {
+	const ready = await readyStage(process.cwd());
+	const targets = (0, _geekmidas_manifest.migrationTargets)(ready.manifest);
+	const id = (0, _geekmidas_manifest.canonicalId)(options.construct);
+	const auth = authConstruct(ready.sources, id);
+	if (auth) {
+		const target = targets.find((t) => t.id === auth.databaseId);
+		if (!target) throw new require_databases.NoSuchMigrationTarget(auth.databaseId, ids(targets));
+		return writeAuthMigration(ready, auth, target, options);
+	}
+	const target = targets.find((t) => t.id === id);
+	if (!target) throw new require_databases.NoSuchMigrationTarget(options.construct, [...ids(targets), ...authIds(ready.sources)]);
+	if (!options.name) throw new MigrationNeedsName(options.construct);
+	const file = await write(ready.workspace.root, target, `${require_index.stamp(options.now)}_${require_index.slug(options.name)}.ts`, STUB);
+	logger.log(`📝 ${file}`);
+	return file;
+}
+function authConstruct(sources, id) {
+	const construct = sources[id]?.construct;
+	return construct && typeof construct.pendingMigration === "function" && typeof construct.databaseId === "string" ? construct : void 0;
+}
+function authIds(sources) {
+	return Object.keys(sources).filter((id) => authConstruct(sources, id));
+}
+async function writeAuthMigration(ready, auth, target, options) {
+	await require_databases.migrateDatabases({
+		root: ready.workspace.root,
+		manifest: ready.manifest,
+		sources: ready.sources,
+		env: ready.env,
+		only: target.id
+	});
+	const stage = ready.workspace.stages.local;
+	const secrets = await require_seeds.loadSecretsForApp(await require_seeds.secretsStoreFor(ready.workspace, stage), stage);
+	const pending = await auth.pendingMigration({
+		envParser: new _geekmidas_envkit.EnvironmentParser({
+			...secrets,
+			...ready.env
+		}),
+		context: _geekmidas_services.serviceContext
+	});
+	if (!pending) {
+		logger.log(`✓ ${target.migrations}: ${auth.id} is up to date`);
+		return;
+	}
+	const file = await write(ready.workspace.root, target, `${require_index.stamp(options.now)}_${require_index.slug(options.name ?? "better_auth")}.sql`, `${pending.trim()}\n`);
+	logger.log(`📝 ${file}`);
+	return file;
+}
+const STUB = `import type { Kysely } from 'kysely';
+
+export async function up(db: Kysely<unknown>): Promise<void> {
+  // await db.schema.createTable('…').addColumn(…).execute();
+}
+
+export async function down(db: Kysely<unknown>): Promise<void> {
+  // await db.schema.dropTable('…').execute();
+}
+`;
+async function write(root, target, file, content) {
+	const folder = (0, node_path.join)(root, target.migrations);
+	await (0, node_fs_promises.mkdir)(folder, { recursive: true });
+	await (0, node_fs_promises.writeFile)((0, node_path.join)(folder, file), content, { flag: "wx" });
+	return `${target.migrations}/${file}`;
+}
+function ids(targets) {
+	return targets.map((target) => target.id);
+}
+//#endregion
+exports.migrateAndSeed = require_databases.migrateAndSeed;
+exports.migrateCommand = migrateCommand;
+exports.migrationCommand = migrationCommand;
+exports.prepareDevDatabases = prepareDevDatabases;
+exports.reportPendingMigrations = reportPendingMigrations;
+exports.seedCommand = seedCommand;
+
+//# sourceMappingURL=migrate-CTqhWtev.cjs.map

package/dist/migrate-CTqhWtev.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate-CTqhWtev.cjs","names":["GkmError","TEST_STAGE","loadWorkspaceConfig","discover","constructGlobs","reconcileWorkspace","migrateDatabases","migrateAndSeed","pendingMigrations","migrationTargets","canonicalId","NoSuchMigrationTarget","stamp","slug","loadSecretsForApp","secretsStoreFor","EnvironmentParser","serviceContext","join","mkdir","writeFile"],"sources":["../src/migrate/index.ts"],"sourcesContent":["/**\n * `gkm migrate`, `gkm seed` and `gkm migration` — applying a construct's\n * migrations, running its seeds, and writing its next migration.\n *\n * Both work on a stage this machine reconciles: its containers up, its roles\n * provisioned, its owner URLs resolved. A deployed stage is migrated by the\n * deploy that ships it, which is the one thing that can reach its database.\n */\n\nimport { mkdir, writeFile } from 'node:fs/promises';\nimport { join } from 'node:path';\nimport { EnvironmentParser } from '@geekmidas/envkit';\nimport {\n\ttype ConstructManifest,\n\tcanonicalId,\n\ttype MigrationTarget,\n\tmigrationTargets,\n} from '@geekmidas/manifest';\nimport {\n\ttype ServiceRegisterOptions,\n\tserviceContext,\n} from '@geekmidas/services';\nimport { loadWorkspaceConfig } from '../config';\nimport { loadSecretsForApp } from '../credentials';\nimport { GkmError } from '../errors';\nimport { type ConstructSource, discover } from '../reconcile/discover';\nimport { constructGlobs, reconcileWorkspace } from '../reconcile/workspace.js';\nimport { secretsStoreFor } from '../secrets/store.js';\nimport { TEST_STAGE } from '../workspace/stages';\nimport type { NormalizedWorkspace } from '../workspace/types.js';\nimport {\n\ttype MigrationRun,\n\tmigrateAndSeed,\n\tmigrateDatabases,\n\tNoSuchMigrationTarget,\n\tpendingMigrations,\n\ttype SeedRun,\n} from './databases';\nimport { slug, stamp } from './names';\n\nexport {\n\tKyselyNotFound,\n\tMigrationFailed,\n\ttype MigrationRun,\n\tMigrationsOutsideFolder,\n\tmigrateAndSeed,\n\tmigrateDatabases,\n\tNoOwnerCredential,\n\tNoSuchMigrationTarget,\n\ttype PendingMigrations,\n\tpendingMigrations,\n\tSeedFailed,\n\ttype SeedOptions,\n\ttype SeedRun,\n\tseedDatabases,\n\tUnknownDatabaseFolder,\n\tUnknownMigrationFolder,\n} from './databases';\nexport { slug, stamp } from './names';\nexport {\n\tDuplicateMigration,\n\tMigrationHasNoUp,\n\tSeedHasNoSeed,\n} from './provider';\n\nconst logger = console;\n\n/** `gkm migrate --stage` named a stage only a deploy can reach. */\nexport class MigrateDeployedStage extends GkmError {\n\tconstructor(\n\t\treadonly stage: string,\n\t\treadonly local: string,\n\t) {\n\t\tsuper(\n\t\t\t`'${stage}' is a deployed stage, and its database is migrated by ` +\n\t\t\t\t`\\`gkm deploy --stage ${stage}\\`, which is what can reach it. ` +\n\t\t\t\t`\\`gkm migrate\\` runs against '${local}' or '${TEST_STAGE}'.`,\n\t\t);\n\t\tthis.name = 'MigrateDeployedStage';\n\t}\n}\n\n/** `gkm migration` for a Kysely database, with no name for the file. */\nexport class MigrationNeedsName extends GkmError {\n\tconstructor(readonly construct: string) {\n\t\tsuper(\n\t\t\t`Name the migration: \\`gkm migration ${construct} add_workouts\\`. ` +\n\t\t\t\t`The name is what the file — and the history — calls it.`,\n\t\t);\n\t\tthis.name = 'MigrationNeedsName';\n\t}\n}\n\nexport interface MigrateOptions {\n\t/** The stage to migrate: the project's local one, or `test`. */\n\tstage?: string;\n\t/** One construct, by name. All of them when absent. */\n\tconstruct?: string;\n}\n\n/** A workspace's stage, reconciled and ready to migrate. */\nexport interface ReadyStage {\n\tworkspace: NormalizedWorkspace;\n\tmanifest: ConstructManifest;\n\tsources: Record<string, ConstructSource>;\n\t/** Every URL the stage resolved — the owner URLs among them. */\n\tenv: Record<string, string>;\n\t/** The stage it is: the local one, or `test`. */\n\tstage: string;\n}\n\n/**\n * Reconcile a stage so it can be migrated: containers up, databases, schemas,\n * roles and grants in place, owner URLs resolved.\n *\n * Migrating assumes the roles exist, and this is what makes that true rather\n * than something a developer has to have run first.\n */\nexport async function readyStage(\n\tcwd: string,\n\tstage?: string,\n): Promise<ReadyStage> {\n\tconst { workspace } = await loadWorkspaceConfig(cwd);\n\tconst local = workspace.stages.local;\n\tconst target = stage ?? local;\n\tif (target !== local && target !== TEST_STAGE) {\n\t\tthrow new MigrateDeployedStage(target, local);\n\t}\n\n\tconst sources: Record<string, ConstructSource> = {};\n\tconst manifest = await discover({\n\t\tpatterns: constructGlobs(workspace),\n\t\tcwd: workspace.root,\n\t\tsources,\n\t});\n\n\tconst reconciled = await reconcileWorkspace(workspace, {\n\t\tstage: target,\n\t\tmanifest,\n\t\tstart: true,\n\t});\n\n\treturn {\n\t\tworkspace,\n\t\tmanifest,\n\t\tsources,\n\t\tenv: { ...reconciled.env },\n\t\tstage: target,\n\t};\n}\n\n/** `gkm migrate [construct]`. */\nexport async function migrateCommand(\n\toptions: MigrateOptions = {},\n): Promise<void> {\n\tconst ready = await readyStage(process.cwd(), options.stage);\n\n\tconst runs = await migrateDatabases({\n\t\troot: ready.workspace.root,\n\t\tmanifest: ready.manifest,\n\t\tsources: ready.sources,\n\t\tenv: ready.env,\n\t\t...(options.construct ? { only: options.construct } : {}),\n\t});\n\n\tif (runs.length === 0) {\n\t\tlogger.log('🗄️  No database constructs to migrate.');\n\t\treturn;\n\t}\n\n\tlogMigrations(runs);\n}\n\n/**\n * `gkm seed [construct]` — migrate, then run the seeds.\n *\n * Always migrates first: a seed is written against the schema its migrations\n * build, and against an older one it fails on a table that is not there yet.\n */\nexport async function seedCommand(options: MigrateOptions = {}): Promise<void> {\n\tconst ready = await readyStage(process.cwd(), options.stage);\n\n\tconst { migrations, seeds } = await migrateAndSeed({\n\t\troot: ready.workspace.root,\n\t\tmanifest: ready.manifest,\n\t\tsources: ready.sources,\n\t\tenv: ready.env,\n\t\tstage: ready.stage,\n\t\t...(options.construct ? { only: options.construct } : {}),\n\t});\n\n\tif (migrations.length === 0) {\n\t\tlogger.log('🗄️  No database constructs to seed.');\n\t\treturn;\n\t}\n\n\tlogMigrations(migrations);\n\tlogSeeds(seeds);\n}\n\n/** One line per construct: up to date, or what was applied. */\nexport function logMigrations(\n\truns: readonly MigrationRun[],\n\tlog: (line: string) => void = logger.log,\n): void {\n\tfor (const { target, applied } of runs) {\n\t\tif (applied.length === 0) {\n\t\t\tlog(`🗄️  ${target.migrations}: up to date`);\n\t\t\tcontinue;\n\t\t}\n\t\tlog(`🗄️  ${target.migrations}: applied ${applied.length}`);\n\t\tfor (const name of applied) log(`   ✓ ${name}`);\n\t}\n}\n\n/** One line per construct that has seeds, and each seed it ran. */\nexport function logSeeds(\n\truns: readonly SeedRun[],\n\tlog: (line: string) => void = logger.log,\n): void {\n\tfor (const { target, seeded } of runs) {\n\t\tif (seeded.length === 0) continue;\n\t\tlog(`🌱 ${target.seeds}: ran ${seeded.length}`);\n\t\tfor (const name of seeded) log(`   ✓ ${name}`);\n\t}\n}\n\n/**\n * What `gkm dev` prints: one line per construct whose folder is ahead of its\n * history, and nothing when every folder is applied.\n *\n * Reported, never applied. A migration being written would otherwise run the\n * moment its file is saved, half-finished, against the database the developer\n * is working in.\n */\nexport async function reportPendingMigrations(\n\tworkspace: NormalizedWorkspace,\n\tenv: Readonly<Record<string, string>>,\n): Promise<void> {\n\tconst sources: Record<string, ConstructSource> = {};\n\tconst manifest = await discover({\n\t\tpatterns: constructGlobs(workspace),\n\t\tcwd: workspace.root,\n\t\tsources,\n\t});\n\n\tconst pending = await pendingMigrations({\n\t\troot: workspace.root,\n\t\tmanifest,\n\t\tsources,\n\t\tenv,\n\t});\n\n\tfor (const { target, pending: names } of pending) {\n\t\tlogger.log(\n\t\t\t`⚠️  ${target.migrations}: ${names.length} pending (${names.join(', ')}) — run gkm migrate`,\n\t\t);\n\t}\n}\n\n/**\n * What `gkm dev --migrate` and `gkm dev --seed` do before the apps start:\n * migrate, and with `seed`, run the seeds after — once, at startup, never on a\n * save, for the reason {@link reportPendingMigrations} gives.\n *\n * A failure here is thrown, unlike the report's: the developer asked for the\n * database to be brought up to date, and apps started against one in an\n * unknown state would fail somewhere less obvious.\n */\nexport async function prepareDevDatabases(\n\tworkspace: NormalizedWorkspace,\n\tenv: Readonly<Record<string, string>>,\n\t{ seed = false }: { seed?: boolean } = {},\n): Promise<void> {\n\tconst sources: Record<string, ConstructSource> = {};\n\tconst manifest = await discover({\n\t\tpatterns: constructGlobs(workspace),\n\t\tcwd: workspace.root,\n\t\tsources,\n\t});\n\tconst options = { root: workspace.root, manifest, sources, env };\n\n\tif (!seed) {\n\t\tlogMigrations(await migrateDatabases(options));\n\t\treturn;\n\t}\n\n\tconst { migrations, seeds } = await migrateAndSeed({\n\t\t...options,\n\t\tstage: workspace.stages.local,\n\t});\n\tlogMigrations(migrations);\n\tlogSeeds(seeds);\n}\n\nexport interface MigrationOptions {\n\t/** The construct the migration is for, by name. */\n\tconstruct: string;\n\t/** What the file is called, after its timestamp. */\n\tname?: string;\n\t/** The file's timestamp; the current time when absent. */\n\tnow?: Date;\n}\n\n/**\n * `gkm migration <construct> [name]` — write the construct's next migration.\n *\n * For a database, an empty `up`/`down` to fill in. For an auth server, what\n * its schema is missing, computed against its tenant once every committed\n * migration has been applied — so the file is only the change, and is\n * reviewed and committed like any other.\n */\nexport async function migrationCommand(\n\toptions: MigrationOptions,\n): Promise<string | undefined> {\n\tconst ready = await readyStage(process.cwd());\n\tconst targets = migrationTargets(ready.manifest);\n\tconst id = canonicalId(options.construct);\n\n\tconst auth = authConstruct(ready.sources, id);\n\tif (auth) {\n\t\tconst target = targets.find((t) => t.id === auth.databaseId);\n\t\tif (!target) {\n\t\t\tthrow new NoSuchMigrationTarget(auth.databaseId, ids(targets));\n\t\t}\n\t\treturn writeAuthMigration(ready, auth, target, options);\n\t}\n\n\tconst target = targets.find((t) => t.id === id);\n\tif (!target) {\n\t\tthrow new NoSuchMigrationTarget(options.construct, [\n\t\t\t...ids(targets),\n\t\t\t...authIds(ready.sources),\n\t\t]);\n\t}\n\tif (!options.name) throw new MigrationNeedsName(options.construct);\n\n\tconst file = await write(\n\t\tready.workspace.root,\n\t\ttarget,\n\t\t`${stamp(options.now)}_${slug(options.name)}.ts`,\n\t\tSTUB,\n\t);\n\tlogger.log(`📝 ${file}`);\n\treturn file;\n}\n\n/** What an auth construct offers `gkm migration`, duck-typed across copies. */\ninterface AuthConstruct {\n\tid: string;\n\tdatabaseId: string;\n\tpendingMigration(\n\t\toptions: ServiceRegisterOptions,\n\t): Promise<string | undefined>;\n}\n\nfunction authConstruct(\n\tsources: Readonly<Record<string, ConstructSource>>,\n\tid: string,\n): AuthConstruct | undefined {\n\tconst construct = sources[id]?.construct as\n\t\t| Partial<AuthConstruct>\n\t\t| undefined;\n\treturn construct &&\n\t\ttypeof construct.pendingMigration === 'function' &&\n\t\ttypeof construct.databaseId === 'string'\n\t\t? (construct as AuthConstruct)\n\t\t: undefined;\n}\n\nfunction authIds(sources: Readonly<Record<string, ConstructSource>>): string[] {\n\treturn Object.keys(sources).filter((id) => authConstruct(sources, id));\n}\n\nasync function writeAuthMigration(\n\tready: ReadyStage,\n\tauth: AuthConstruct,\n\ttarget: MigrationTarget,\n\toptions: MigrationOptions,\n): Promise<string | undefined> {\n\t// Against a tenant already at its committed migrations, so the comparison\n\t// finds only what the files do not yet say.\n\tawait migrateDatabases({\n\t\troot: ready.workspace.root,\n\t\tmanifest: ready.manifest,\n\t\tsources: ready.sources,\n\t\tenv: ready.env,\n\t\tonly: target.id,\n\t});\n\n\t// Its secret and URL come from the stage's secrets; the tenant's owner URL\n\t// from the reconcile above, which wins.\n\tconst stage = ready.workspace.stages.local;\n\tconst secrets = await loadSecretsForApp(\n\t\tawait secretsStoreFor(ready.workspace, stage),\n\t\tstage,\n\t);\n\tconst pending = await auth.pendingMigration({\n\t\tenvParser: new EnvironmentParser({ ...secrets, ...ready.env }),\n\t\tcontext: serviceContext,\n\t});\n\n\tif (!pending) {\n\t\tlogger.log(`✓ ${target.migrations}: ${auth.id} is up to date`);\n\t\treturn undefined;\n\t}\n\n\tconst file = await write(\n\t\tready.workspace.root,\n\t\ttarget,\n\t\t`${stamp(options.now)}_${slug(options.name ?? 'better_auth')}.sql`,\n\t\t`${pending.trim()}\\n`,\n\t);\n\tlogger.log(`📝 ${file}`);\n\treturn file;\n}\n\nconst STUB = `import type { Kysely } from 'kysely';\n\nexport async function up(db: Kysely<unknown>): Promise<void> {\n  // await db.schema.createTable('…').addColumn(…).execute();\n}\n\nexport async function down(db: Kysely<unknown>): Promise<void> {\n  // await db.schema.dropTable('…').execute();\n}\n`;\n\nasync function write(\n\troot: string,\n\ttarget: MigrationTarget,\n\tfile: string,\n\tcontent: string,\n): Promise<string> {\n\tconst folder = join(root, target.migrations);\n\tawait mkdir(folder, { recursive: true });\n\tawait writeFile(join(folder, file), content, { flag: 'wx' });\n\treturn `${target.migrations}/${file}`;\n}\n\nfunction ids(targets: readonly MigrationTarget[]): string[] {\n\treturn targets.map((target) => target.id);\n}\n"],"mappings":"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"}