@prisma-next/cli 0.3.0-dev.12 → 0.3.0-dev.122

package/dist/commands/migration-apply.mjs

@@ -0,0 +1,241 @@
+import { t as loadConfig } from "../config-loader-d_KF19Tw.mjs";
+import { _ as errorUnexpected, c as errorDriverRequired, h as errorTargetMigrationNotSupported, m as errorRuntime, o as errorDatabaseConnectionRequired, t as CliStructuredError } from "../cli-errors-ByGuoqNj.mjs";
+import "../framework-components-M2j-qPfr.mjs";
+import { t as createControlClient } from "../client-612RJJD_.mjs";
+import { c as readContractEnvelope, f as setCommandDescriptions, g as parseGlobalFlags, h as toPathDecisionResult, i as addGlobalOptions, m as targetSupportsMigrations, o as loadMigrationBundles, p as setCommandExamples, r as handleResult, s as maskConnectionUrl, t as TerminalUI, u as resolveMigrationPaths, y as formatStyledHeader } from "../terminal-ui-DAcMBRKf.mjs";
+import { t as formatMigrationApplyCommandOutput } from "../migrations-Db_ea9eE.mjs";
+import { Command } from "commander";
+import { notOk, ok } from "@prisma-next/utils/result";
+import { EMPTY_CONTRACT_HASH } from "@prisma-next/core-control-plane/constants";
+import { findPathWithDecision } from "@prisma-next/migration-tools/dag";
+import { MigrationToolsError } from "@prisma-next/migration-tools/types";
+import { readRefs, resolveRef } from "@prisma-next/migration-tools/refs";
+
+//#region src/commands/migration-apply.ts
+function mapMigrationToolsError(error) {
+	if (MigrationToolsError.is(error)) return errorRuntime(error.message, {
+		why: error.why,
+		fix: error.fix,
+		meta: {
+			code: error.code,
+			...error.details ?? {}
+		}
+	});
+	return errorUnexpected(error instanceof Error ? error.message : String(error), { why: `Unexpected error during migration apply: ${error instanceof Error ? error.message : String(error)}` });
+}
+function mapApplyFailure(failure) {
+	return errorRuntime(failure.summary, {
+		why: failure.why ?? "Migration runner failed",
+		fix: "Fix the issue and re-run `prisma-next migration apply` — previously applied migrations are preserved.",
+		meta: failure.meta ?? {}
+	});
+}
+function packageToStep(pkg) {
+	return {
+		dirName: pkg.dirName,
+		from: pkg.manifest.from,
+		to: pkg.manifest.to,
+		toContract: pkg.manifest.toContract,
+		operations: pkg.ops
+	};
+}
+async function executeMigrationApplyCommand(options, flags, ui, startTime) {
+	const config = await loadConfig(options.config);
+	const { configPath, migrationsDir, migrationsRelative, refsPath } = resolveMigrationPaths(options.config, config);
+	const dbConnection = options.db ?? config.db?.connection;
+	if (!dbConnection) return notOk(errorDatabaseConnectionRequired({
+		why: `Database connection is required for migration apply (set db.connection in ${configPath}, or pass --db <url>)`,
+		commandName: "migration apply"
+	}));
+	if (!config.driver) return notOk(errorDriverRequired({ why: "Config.driver is required for migration apply" }));
+	if (!targetSupportsMigrations(config.target)) return notOk(errorTargetMigrationNotSupported({ why: `Target "${config.target.id}" does not support migrations` }));
+	let destinationHash;
+	let refName;
+	if (options.ref) {
+		refName = options.ref;
+		try {
+			destinationHash = resolveRef(await readRefs(refsPath), refName);
+		} catch (error) {
+			if (MigrationToolsError.is(error)) return notOk(mapMigrationToolsError(error));
+			throw error;
+		}
+	} else try {
+		destinationHash = (await readContractEnvelope(config)).storageHash;
+	} catch (error) {
+		return notOk(errorRuntime("Current contract is unavailable", {
+			why: `Failed to read contract: ${error instanceof Error ? error.message : String(error)}`,
+			fix: "Run `prisma-next contract emit` to generate a valid contract.json, then retry apply."
+		}));
+	}
+	if (!flags.json && !flags.quiet) {
+		const details = [{
+			label: "config",
+			value: configPath
+		}, {
+			label: "migrations",
+			value: migrationsRelative
+		}];
+		if (typeof dbConnection === "string") details.push({
+			label: "database",
+			value: maskConnectionUrl(dbConnection)
+		});
+		if (refName) details.push({
+			label: "ref",
+			value: refName
+		});
+		const header = formatStyledHeader({
+			command: "migration apply",
+			description: "Apply planned migrations to the database",
+			url: "https://pris.ly/migration-apply",
+			details,
+			flags
+		});
+		ui.stderr(header);
+	}
+	let bundles;
+	let graph;
+	try {
+		({bundles, graph} = await loadMigrationBundles(migrationsDir));
+	} catch (error) {
+		if (MigrationToolsError.is(error)) return notOk(mapMigrationToolsError(error));
+		throw error;
+	}
+	const client = createControlClient({
+		family: config.family,
+		target: config.target,
+		adapter: config.adapter,
+		driver: config.driver,
+		extensionPacks: config.extensionPacks ?? []
+	});
+	try {
+		await client.connect(dbConnection);
+		const marker = await client.readMarker();
+		if (bundles.length === 0) {
+			if (marker?.storageHash) return notOk(errorRuntime("Database has state but no migrations exist", {
+				why: `The database marker hash "${marker.storageHash}" exists but no attested migrations were found in ${migrationsRelative}`,
+				fix: "Ensure the migrations directory is correct. If the database was managed with `db init` or `db update`, run `prisma-next db sign` to update the marker.",
+				meta: {
+					markerHash: marker.storageHash,
+					migrationsDir: migrationsRelative
+				}
+			}));
+			if (destinationHash !== EMPTY_CONTRACT_HASH) return notOk(errorRuntime("Current contract has no planned migrations", {
+				why: `No attested migrations were found in ${migrationsRelative}, but current contract hash is "${destinationHash}"`,
+				fix: "Run `prisma-next migration plan` to create an attested migration for the current contract.",
+				meta: {
+					destinationHash,
+					migrationsDir: migrationsRelative
+				}
+			}));
+			return ok({
+				ok: true,
+				migrationsApplied: 0,
+				migrationsTotal: 0,
+				markerHash: EMPTY_CONTRACT_HASH,
+				applied: [],
+				summary: "No attested migrations found",
+				timings: { total: Date.now() - startTime }
+			});
+		}
+		if (marker?.storageHash === EMPTY_CONTRACT_HASH) return notOk(errorRuntime("Database marker contains the empty sentinel hash", {
+			why: `The marker row exists but contains the empty sentinel value "${EMPTY_CONTRACT_HASH}". This should never happen — the marker should contain the hash of the last applied contract.`,
+			fix: "The marker is corrupted. Run `prisma-next db sign` to overwrite it with the correct contract hash, or drop and recreate the database.",
+			meta: { markerHash: EMPTY_CONTRACT_HASH }
+		}));
+		const markerHash = marker?.storageHash;
+		if (markerHash !== void 0 && !graph.nodes.has(markerHash)) return notOk(errorRuntime("Database marker does not match any known migration", {
+			why: `The database marker hash "${markerHash}" is not found in the migration history at ${migrationsRelative}`,
+			fix: "Ensure the migrations directory matches this database. If the database was managed with `db init` or `db update`, run `prisma-next db sign` to update the marker.",
+			meta: {
+				markerHash,
+				knownNodes: [...graph.nodes]
+			}
+		}));
+		if (!graph.nodes.has(destinationHash)) return notOk(errorRuntime("Current contract has no planned migration path", {
+			why: `Current contract hash "${destinationHash}" is not present in the migration history at ${migrationsRelative}`,
+			fix: "Run `prisma-next migration plan` to create a migration for the current contract, then re-run apply.",
+			meta: {
+				destinationHash,
+				knownNodes: [...graph.nodes]
+			}
+		}));
+		const originHash = markerHash ?? EMPTY_CONTRACT_HASH;
+		const decision = findPathWithDecision(graph, originHash, destinationHash, refName);
+		if (!decision) return notOk(errorRuntime("No migration path from current state to target", {
+			why: `Cannot find a path from "${originHash}" to target "${destinationHash}"`,
+			fix: "Check the migration history for gaps or inconsistencies.",
+			meta: {
+				markerHash: originHash,
+				destinationHash
+			}
+		}));
+		const pendingPath = decision.selectedPath;
+		const pathDecision = toPathDecisionResult(decision);
+		if (pendingPath.length === 0) return ok({
+			ok: true,
+			migrationsApplied: 0,
+			migrationsTotal: 0,
+			markerHash: originHash,
+			applied: [],
+			summary: "Already up to date",
+			pathDecision,
+			timings: { total: Date.now() - startTime }
+		});
+		const bundleByDir = new Map(bundles.map((b) => [b.dirName, b]));
+		const pendingMigrations = [];
+		for (const migration of pendingPath) {
+			const pkg = bundleByDir.get(migration.dirName);
+			if (!pkg) return notOk(errorRuntime(`Migration package not found: ${migration.dirName}`, {
+				why: `The migration directory for path segment ${migration.from} → ${migration.to} was not found`,
+				fix: "Ensure all migration directories are present and intact."
+			}));
+			pendingMigrations.push(packageToStep(pkg));
+		}
+		if (!flags.quiet && !flags.json) for (const migration of pendingMigrations) ui.step(`Pending ${migration.dirName}`);
+		const applyResult = await client.migrationApply({
+			originHash,
+			destinationHash,
+			pendingMigrations
+		});
+		if (!applyResult.ok) return notOk(mapApplyFailure(applyResult.failure));
+		const { value } = applyResult;
+		return ok({
+			ok: true,
+			migrationsApplied: value.migrationsApplied,
+			migrationsTotal: pendingPath.length,
+			markerHash: value.markerHash,
+			applied: value.applied,
+			summary: value.summary,
+			pathDecision,
+			timings: { total: Date.now() - startTime }
+		});
+	} catch (error) {
+		if (CliStructuredError.is(error)) return notOk(error);
+		return notOk(errorUnexpected(error instanceof Error ? error.message : String(error), { why: `Unexpected error during migration apply: ${error instanceof Error ? error.message : String(error)}` }));
+	} finally {
+		await client.close();
+	}
+}
+function createMigrationApplyCommand() {
+	const command = new Command("apply");
+	setCommandDescriptions(command, "Apply planned migrations to the database", "Applies previously planned migrations (created by `migration plan`) to a live database.\nCompares the database marker against the migration history to determine which\nmigrations are pending, then executes them sequentially. Each migration runs\nin its own transaction. Does not plan new migrations — run `migration plan` first.");
+	setCommandExamples(command, ["prisma-next migration apply --db $DATABASE_URL"]);
+	addGlobalOptions(command).option("--db <url>", "Database connection string").option("--config <path>", "Path to prisma-next.config.ts").option("--ref <name>", "Target ref name from migrations/refs.json").action(async (options) => {
+		const flags = parseGlobalFlags(options);
+		const startTime = Date.now();
+		const ui = new TerminalUI({
+			color: flags.color,
+			interactive: flags.interactive
+		});
+		const exitCode = handleResult(await executeMigrationApplyCommand(options, flags, ui, startTime), flags, ui, (applyResult) => {
+			if (flags.json) ui.output(JSON.stringify(applyResult, null, 2));
+			else if (!flags.quiet) ui.log(formatMigrationApplyCommandOutput(applyResult, flags));
+		});
+		process.exit(exitCode);
+	});
+	return command;
+}
+
+//#endregion
+export { createMigrationApplyCommand };
+//# sourceMappingURL=migration-apply.mjs.map

package/dist/commands/migration-apply.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-apply.mjs","names":["destinationHash: string","refName: string | undefined","details: Array<{ label: string; value: string }>","bundles: readonly AttestedMigrationBundle[]","graph: MigrationGraph","pendingMigrations: MigrationApplyStep[]"],"sources":["../../src/commands/migration-apply.ts"],"sourcesContent":["import { EMPTY_CONTRACT_HASH } from '@prisma-next/core-control-plane/constants';\nimport { findPathWithDecision } from '@prisma-next/migration-tools/dag';\nimport { readRefs, resolveRef } from '@prisma-next/migration-tools/refs';\nimport type { AttestedMigrationBundle, MigrationGraph } from '@prisma-next/migration-tools/types';\nimport { MigrationToolsError } from '@prisma-next/migration-tools/types';\nimport { notOk, ok, type Result } from '@prisma-next/utils/result';\nimport { Command } from 'commander';\n\nimport { loadConfig } from '../config-loader';\nimport { createControlClient } from '../control-api/client';\nimport type { MigrationApplyFailure, MigrationApplyStep } from '../control-api/types';\nimport {\n  CliStructuredError,\n  type CliStructuredError as CliStructuredErrorType,\n  errorDatabaseConnectionRequired,\n  errorDriverRequired,\n  errorRuntime,\n  errorTargetMigrationNotSupported,\n  errorUnexpected,\n} from '../utils/cli-errors';\nimport {\n  addGlobalOptions,\n  loadMigrationBundles,\n  maskConnectionUrl,\n  readContractEnvelope,\n  resolveMigrationPaths,\n  setCommandDescriptions,\n  setCommandExamples,\n  targetSupportsMigrations,\n  toPathDecisionResult,\n} from '../utils/command-helpers';\nimport { formatMigrationApplyCommandOutput } from '../utils/formatters/migrations';\nimport { formatStyledHeader } from '../utils/formatters/styled';\nimport type { CommonCommandOptions } from '../utils/global-flags';\nimport { type GlobalFlags, parseGlobalFlags } from '../utils/global-flags';\nimport { handleResult } from '../utils/result-handler';\nimport { TerminalUI } from '../utils/terminal-ui';\n\ninterface MigrationApplyCommandOptions extends CommonCommandOptions {\n  readonly db?: string;\n  readonly config?: string;\n  readonly ref?: string;\n}\n\nexport interface MigrationApplyResult {\n  readonly ok: boolean;\n  readonly migrationsApplied: number;\n  readonly migrationsTotal: number;\n  readonly markerHash: string;\n  readonly applied: readonly {\n    readonly dirName: string;\n    readonly from: string;\n    readonly to: string;\n    readonly operationsExecuted: number;\n  }[];\n  readonly summary: string;\n  readonly pathDecision?: {\n    readonly fromHash: string;\n    readonly toHash: string;\n    readonly alternativeCount: number;\n    readonly tieBreakReasons: readonly string[];\n    readonly refName?: string;\n    readonly selectedPath: readonly {\n      readonly dirName: string;\n      readonly migrationId: string | null;\n      readonly from: string;\n      readonly to: string;\n    }[];\n  };\n  readonly timings: {\n    readonly total: number;\n  };\n}\n\nfunction mapMigrationToolsError(error: unknown): CliStructuredErrorType {\n  if (MigrationToolsError.is(error)) {\n    return errorRuntime(error.message, {\n      why: error.why,\n      fix: error.fix,\n      meta: { code: error.code, ...(error.details ?? {}) },\n    });\n  }\n  return errorUnexpected(error instanceof Error ? error.message : String(error), {\n    why: `Unexpected error during migration apply: ${error instanceof Error ? error.message : String(error)}`,\n  });\n}\n\nfunction mapApplyFailure(failure: MigrationApplyFailure): CliStructuredErrorType {\n  return errorRuntime(failure.summary, {\n    why: failure.why ?? 'Migration runner failed',\n    fix: 'Fix the issue and re-run `prisma-next migration apply` — previously applied migrations are preserved.',\n    meta: failure.meta ?? {},\n  });\n}\n\nfunction packageToStep(pkg: AttestedMigrationBundle): MigrationApplyStep {\n  return {\n    dirName: pkg.dirName,\n    from: pkg.manifest.from,\n    to: pkg.manifest.to,\n    toContract: pkg.manifest.toContract,\n    operations: pkg.ops,\n  };\n}\n\nasync function executeMigrationApplyCommand(\n  options: MigrationApplyCommandOptions,\n  flags: GlobalFlags,\n  ui: TerminalUI,\n  startTime: number,\n): Promise<Result<MigrationApplyResult, CliStructuredErrorType>> {\n  const config = await loadConfig(options.config);\n  const { configPath, migrationsDir, migrationsRelative, refsPath } = resolveMigrationPaths(\n    options.config,\n    config,\n  );\n\n  const dbConnection = options.db ?? config.db?.connection;\n  if (!dbConnection) {\n    return notOk(\n      errorDatabaseConnectionRequired({\n        why: `Database connection is required for migration apply (set db.connection in ${configPath}, or pass --db <url>)`,\n        commandName: 'migration apply',\n      }),\n    );\n  }\n\n  if (!config.driver) {\n    return notOk(\n      errorDriverRequired({\n        why: 'Config.driver is required for migration apply',\n      }),\n    );\n  }\n\n  if (!targetSupportsMigrations(config.target)) {\n    return notOk(\n      errorTargetMigrationNotSupported({\n        why: `Target \"${config.target.id}\" does not support migrations`,\n      }),\n    );\n  }\n\n  let destinationHash: string;\n  let refName: string | undefined;\n\n  if (options.ref) {\n    refName = options.ref;\n    try {\n      const refs = await readRefs(refsPath);\n      destinationHash = resolveRef(refs, refName);\n    } catch (error) {\n      if (MigrationToolsError.is(error)) {\n        return notOk(mapMigrationToolsError(error));\n      }\n      throw error;\n    }\n  } else {\n    try {\n      const envelope = await readContractEnvelope(config);\n      destinationHash = envelope.storageHash;\n    } catch (error) {\n      return notOk(\n        errorRuntime('Current contract is unavailable', {\n          why: `Failed to read contract: ${error instanceof Error ? error.message : String(error)}`,\n          fix: 'Run `prisma-next contract emit` to generate a valid contract.json, then retry apply.',\n        }),\n      );\n    }\n  }\n\n  if (!flags.json && !flags.quiet) {\n    const details: Array<{ label: string; value: string }> = [\n      { label: 'config', value: configPath },\n      { label: 'migrations', value: migrationsRelative },\n    ];\n    if (typeof dbConnection === 'string') {\n      details.push({\n        label: 'database',\n        value: maskConnectionUrl(dbConnection),\n      });\n    }\n    if (refName) {\n      details.push({ label: 'ref', value: refName });\n    }\n    const header = formatStyledHeader({\n      command: 'migration apply',\n      description: 'Apply planned migrations to the database',\n      url: 'https://pris.ly/migration-apply',\n      details,\n      flags,\n    });\n    ui.stderr(header);\n  }\n\n  // Read migrations and build migration chain model (offline — no DB needed)\n  let bundles: readonly AttestedMigrationBundle[];\n  let graph: MigrationGraph;\n  try {\n    ({ bundles, graph } = await loadMigrationBundles(migrationsDir));\n  } catch (error) {\n    if (MigrationToolsError.is(error)) {\n      return notOk(mapMigrationToolsError(error));\n    }\n    throw error;\n  }\n\n  const client = createControlClient({\n    family: config.family,\n    target: config.target,\n    adapter: config.adapter,\n    driver: config.driver,\n    extensionPacks: config.extensionPacks ?? [],\n  });\n\n  try {\n    await client.connect(dbConnection);\n    const marker = await client.readMarker();\n\n    // --- No attested migrations on disk ---\n    if (bundles.length === 0) {\n      if (marker?.storageHash) {\n        return notOk(\n          errorRuntime('Database has state but no migrations exist', {\n            why: `The database marker hash \"${marker.storageHash}\" exists but no attested migrations were found in ${migrationsRelative}`,\n            fix: 'Ensure the migrations directory is correct. If the database was managed with `db init` or `db update`, run `prisma-next db sign` to update the marker.',\n            meta: { markerHash: marker.storageHash, migrationsDir: migrationsRelative },\n          }),\n        );\n      }\n      // Non-empty contract + no migrations = user needs to plan first.\n      if (destinationHash !== EMPTY_CONTRACT_HASH) {\n        return notOk(\n          errorRuntime('Current contract has no planned migrations', {\n            why: `No attested migrations were found in ${migrationsRelative}, but current contract hash is \"${destinationHash}\"`,\n            fix: 'Run `prisma-next migration plan` to create an attested migration for the current contract.',\n            meta: { destinationHash, migrationsDir: migrationsRelative },\n          }),\n        );\n      }\n      // Empty contract + no migrations = nothing to do.\n      return ok({\n        ok: true,\n        migrationsApplied: 0,\n        migrationsTotal: 0,\n        markerHash: EMPTY_CONTRACT_HASH,\n        applied: [],\n        summary: 'No attested migrations found',\n        timings: { total: Date.now() - startTime },\n      });\n    }\n\n    // --- Validate marker state ---\n\n    // The empty sentinel should never appear in a real marker row — if it does,\n    // the marker was corrupted and replaying all migrations would be dangerous.\n    if (marker?.storageHash === EMPTY_CONTRACT_HASH) {\n      return notOk(\n        errorRuntime('Database marker contains the empty sentinel hash', {\n          why: `The marker row exists but contains the empty sentinel value \"${EMPTY_CONTRACT_HASH}\". This should never happen — the marker should contain the hash of the last applied contract.`,\n          fix: 'The marker is corrupted. Run `prisma-next db sign` to overwrite it with the correct contract hash, or drop and recreate the database.',\n          meta: { markerHash: EMPTY_CONTRACT_HASH },\n        }),\n      );\n    }\n\n    const markerHash = marker?.storageHash;\n\n    if (markerHash !== undefined && !graph.nodes.has(markerHash)) {\n      return notOk(\n        errorRuntime('Database marker does not match any known migration', {\n          why: `The database marker hash \"${markerHash}\" is not found in the migration history at ${migrationsRelative}`,\n          fix: 'Ensure the migrations directory matches this database. If the database was managed with `db init` or `db update`, run `prisma-next db sign` to update the marker.',\n          meta: { markerHash, knownNodes: [...graph.nodes] },\n        }),\n      );\n    }\n\n    if (!graph.nodes.has(destinationHash)) {\n      return notOk(\n        errorRuntime('Current contract has no planned migration path', {\n          why: `Current contract hash \"${destinationHash}\" is not present in the migration history at ${migrationsRelative}`,\n          fix: 'Run `prisma-next migration plan` to create a migration for the current contract, then re-run apply.',\n          meta: { destinationHash, knownNodes: [...graph.nodes] },\n        }),\n      );\n    }\n\n    // --- Resolve path and apply ---\n\n    // \"No marker\" means the database is fresh — start from the empty contract hash.\n    const originHash = markerHash ?? EMPTY_CONTRACT_HASH;\n\n    const decision = findPathWithDecision(graph, originHash, destinationHash, refName);\n    if (!decision) {\n      return notOk(\n        errorRuntime('No migration path from current state to target', {\n          why: `Cannot find a path from \"${originHash}\" to target \"${destinationHash}\"`,\n          fix: 'Check the migration history for gaps or inconsistencies.',\n          meta: { markerHash: originHash, destinationHash },\n        }),\n      );\n    }\n\n    const pendingPath = decision.selectedPath;\n    const pathDecision = toPathDecisionResult(decision);\n\n    if (pendingPath.length === 0) {\n      return ok({\n        ok: true,\n        migrationsApplied: 0,\n        migrationsTotal: 0,\n        markerHash: originHash,\n        applied: [],\n        summary: 'Already up to date',\n        pathDecision,\n        timings: { total: Date.now() - startTime },\n      });\n    }\n\n    const bundleByDir = new Map(bundles.map((b) => [b.dirName, b]));\n    const pendingMigrations: MigrationApplyStep[] = [];\n    for (const migration of pendingPath) {\n      const pkg = bundleByDir.get(migration.dirName);\n      if (!pkg) {\n        return notOk(\n          errorRuntime(`Migration package not found: ${migration.dirName}`, {\n            why: `The migration directory for path segment ${migration.from} → ${migration.to} was not found`,\n            fix: 'Ensure all migration directories are present and intact.',\n          }),\n        );\n      }\n      pendingMigrations.push(packageToStep(pkg));\n    }\n\n    if (!flags.quiet && !flags.json) {\n      for (const migration of pendingMigrations) {\n        ui.step(`Pending ${migration.dirName}`);\n      }\n    }\n\n    const applyResult = await client.migrationApply({\n      originHash,\n      destinationHash,\n      pendingMigrations,\n    });\n\n    if (!applyResult.ok) {\n      return notOk(mapApplyFailure(applyResult.failure));\n    }\n\n    const { value } = applyResult;\n\n    return ok({\n      ok: true,\n      migrationsApplied: value.migrationsApplied,\n      migrationsTotal: pendingPath.length,\n      markerHash: value.markerHash,\n      applied: value.applied,\n      summary: value.summary,\n      pathDecision,\n      timings: { total: Date.now() - startTime },\n    });\n  } catch (error) {\n    if (CliStructuredError.is(error)) {\n      return notOk(error);\n    }\n    return notOk(\n      errorUnexpected(error instanceof Error ? error.message : String(error), {\n        why: `Unexpected error during migration apply: ${error instanceof Error ? error.message : String(error)}`,\n      }),\n    );\n  } finally {\n    await client.close();\n  }\n}\n\nexport function createMigrationApplyCommand(): Command {\n  const command = new Command('apply');\n  setCommandDescriptions(\n    command,\n    'Apply planned migrations to the database',\n    'Applies previously planned migrations (created by `migration plan`) to a live database.\\n' +\n      'Compares the database marker against the migration history to determine which\\n' +\n      'migrations are pending, then executes them sequentially. Each migration runs\\n' +\n      'in its own transaction. Does not plan new migrations — run `migration plan` first.',\n  );\n  setCommandExamples(command, ['prisma-next migration apply --db $DATABASE_URL']);\n  addGlobalOptions(command)\n    .option('--db <url>', 'Database connection string')\n    .option('--config <path>', 'Path to prisma-next.config.ts')\n    .option('--ref <name>', 'Target ref name from migrations/refs.json')\n    .action(async (options: MigrationApplyCommandOptions) => {\n      const flags = parseGlobalFlags(options);\n      const startTime = Date.now();\n\n      const ui = new TerminalUI({\n        color: flags.color,\n        interactive: flags.interactive,\n      });\n\n      const result = await executeMigrationApplyCommand(options, flags, ui, startTime);\n\n      const exitCode = handleResult(result, flags, ui, (applyResult) => {\n        if (flags.json) {\n          ui.output(JSON.stringify(applyResult, null, 2));\n        } else if (!flags.quiet) {\n          ui.log(formatMigrationApplyCommandOutput(applyResult, flags));\n        }\n      });\n\n      process.exit(exitCode);\n    });\n\n  return command;\n}\n"],"mappings":"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"}

package/dist/commands/migration-plan.d.mts

@@ -0,0 +1,47 @@
+import { Command } from "commander";
+import { Result } from "@prisma-next/utils/result";
+
+//#region src/commands/migration-plan.d.ts
+interface MigrationPlanResult {
+  readonly ok: boolean;
+  readonly noOp: boolean;
+  readonly from: string;
+  readonly to: string;
+  readonly migrationId?: string;
+  readonly dir?: string;
+  readonly operations: readonly {
+    readonly id: string;
+    readonly label: string;
+    readonly operationClass: string;
+  }[];
+  readonly sql?: readonly string[];
+  readonly summary: string;
+  readonly timings: {
+    readonly total: number;
+  };
+}
+declare function createMigrationPlanCommand(): Command;
+type PrefixResolutionFailure = {
+  reason: 'ambiguous';
+  count: number;
+} | {
+  reason: 'not-found';
+};
+/**
+ * Resolve a migration bundle by exact hash or prefix match.
+ *
+ * Tries exact match first, then prefix match (auto-prepending `sha256:` when
+ * the needle omits the scheme). Returns the matched bundle on success, or a
+ * discriminated failure indicating whether the prefix was ambiguous or simply
+ * not found.
+ *
+ * @internal Exported for testing only.
+ */
+declare function resolveBundleByPrefix<T extends {
+  manifest: {
+    to: string;
+  };
+}>(bundles: readonly T[], needle: string): Result<T, PrefixResolutionFailure>;
+//#endregion
+export { MigrationPlanResult, PrefixResolutionFailure, createMigrationPlanCommand, resolveBundleByPrefix };
+//# sourceMappingURL=migration-plan.d.mts.map

package/dist/commands/migration-plan.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-plan.d.mts","names":[],"sources":["../../src/commands/migration-plan.ts"],"sourcesContent":[],"mappings":";;;;UA6CiB,mBAAA;;EAAA,SAAA,IAAA,EAAA,OAAmB;EA8QpB,SAAA,IAAA,EAAA,MAAA;EA4GJ,SAAA,EAAA,EAAA,MAAA;EAcI,SAAA,WAAA,CAAA,EAAA,MAAqB;EACjB,SAAA,GAAA,CAAA,EAAA,MAAA;EAEV,SAAA,UAAA,EAAA,SAAA;IAAG,SAAA,EAAA,EAAA,MAAA;IAAV,SAAA,KAAA,EAAA,MAAA;IAAM,SAAA,cAAA,EAAA,MAAA;;;;;;;;iBA7HO,0BAAA,CAAA,GAA8B;KA4GlC,uBAAA;;;;;;;;;;;;;;;;iBAcI;;;;qBACI,sBAEjB,OAAO,GAAG"}

package/dist/commands/migration-plan.mjs

@@ -0,0 +1,288 @@
+import { t as loadConfig } from "../config-loader-d_KF19Tw.mjs";
+import { _ as errorUnexpected, a as errorContractValidationFailed, f as errorMigrationPlanningFailed, h as errorTargetMigrationNotSupported, l as errorFileNotFound, m as errorRuntime } from "../cli-errors-ByGuoqNj.mjs";
+import { t as assertFrameworkComponentsCompatible } from "../framework-components-M2j-qPfr.mjs";
+import { t as extractSqlDdl } from "../extract-sql-ddl-Jf5blEO0.mjs";
+import { a as getTargetMigrations, f as setCommandDescriptions, g as parseGlobalFlags, i as addGlobalOptions, l as resolveContractPath, o as loadMigrationBundles, p as setCommandExamples, r as handleResult, t as TerminalUI, u as resolveMigrationPaths, y as formatStyledHeader } from "../terminal-ui-DAcMBRKf.mjs";
+import { Command } from "commander";
+import { notOk, ok } from "@prisma-next/utils/result";
+import { join, relative } from "pathe";
+import { createControlPlaneStack } from "@prisma-next/core-control-plane/stack";
+import { EMPTY_CONTRACT_HASH } from "@prisma-next/core-control-plane/constants";
+import { readFile } from "node:fs/promises";
+import { findLatestMigration } from "@prisma-next/migration-tools/dag";
+import { formatMigrationDirName, writeMigrationPackage } from "@prisma-next/migration-tools/io";
+import { MigrationToolsError } from "@prisma-next/migration-tools/types";
+import { attestMigration } from "@prisma-next/migration-tools/attestation";
+
+//#region src/commands/migration-plan.ts
+function mapMigrationToolsError(error) {
+	if (MigrationToolsError.is(error)) return errorRuntime(error.message, {
+		why: error.why,
+		fix: error.fix,
+		meta: {
+			code: error.code,
+			...error.details ?? {}
+		}
+	});
+	return errorUnexpected(error instanceof Error ? error.message : String(error), { why: `Unexpected error during migration plan: ${error instanceof Error ? error.message : String(error)}` });
+}
+async function executeMigrationPlanCommand(options, flags, ui, startTime) {
+	const config = await loadConfig(options.config);
+	const { configPath, migrationsDir, migrationsRelative } = resolveMigrationPaths(options.config, config);
+	const contractPathAbsolute = resolveContractPath(config);
+	const contractPath = relative(process.cwd(), contractPathAbsolute);
+	if (!flags.json && !flags.quiet) {
+		const details = [
+			{
+				label: "config",
+				value: configPath
+			},
+			{
+				label: "contract",
+				value: contractPath
+			},
+			{
+				label: "migrations",
+				value: migrationsRelative
+			}
+		];
+		if (options.from) details.push({
+			label: "from",
+			value: options.from
+		});
+		if (options.name) details.push({
+			label: "name",
+			value: options.name
+		});
+		const header = formatStyledHeader({
+			command: "migration plan",
+			description: "Plan a migration from contract changes",
+			url: "https://pris.ly/migration-plan",
+			details,
+			flags
+		});
+		ui.stderr(header);
+	}
+	let contractJsonContent;
+	try {
+		contractJsonContent = await readFile(contractPathAbsolute, "utf-8");
+	} catch (error) {
+		if (error instanceof Error && error.code === "ENOENT") return notOk(errorFileNotFound(contractPathAbsolute, {
+			why: `Contract file not found at ${contractPathAbsolute}`,
+			fix: `Run \`prisma-next contract emit\` to generate ${contractPath}, or update \`config.contract.output\` in ${configPath}`
+		}));
+		return notOk(errorUnexpected(error instanceof Error ? error.message : String(error), { why: `Failed to read contract file: ${error instanceof Error ? error.message : String(error)}` }));
+	}
+	let toContractJson;
+	try {
+		toContractJson = JSON.parse(contractJsonContent);
+	} catch (error) {
+		return notOk(errorContractValidationFailed(`Contract JSON is invalid: ${error instanceof Error ? error.message : String(error)}`, { where: { path: contractPathAbsolute } }));
+	}
+	const toStorageHash = toContractJson["storageHash"];
+	if (!toStorageHash) return notOk(errorContractValidationFailed("Contract is missing storageHash", { where: { path: contractPathAbsolute } }));
+	let fromContract = null;
+	let fromHash = EMPTY_CONTRACT_HASH;
+	try {
+		const { bundles, graph } = await loadMigrationBundles(migrationsDir);
+		if (options.from) {
+			const resolved = resolveBundleByPrefix(bundles, options.from);
+			if (!resolved.ok) {
+				const f = resolved.failure;
+				return notOk(f.reason === "ambiguous" ? errorRuntime("Multiple matching migrations found", {
+					why: `Prefix "${options.from}" matches ${f.count} migrations in ${migrationsRelative}`,
+					fix: "Provide a longer prefix to disambiguate, or omit --from to use the latest migration target."
+				}) : errorRuntime("Starting contract not found", {
+					why: `No migration with to hash matching "${options.from}" exists in ${migrationsRelative}`,
+					fix: "Check that the --from hash matches a known migration target hash, or omit --from to use the latest migration target."
+				}));
+			}
+			fromHash = resolved.value.manifest.to;
+			fromContract = resolved.value.manifest.toContract;
+		} else {
+			const latestMigration = findLatestMigration(graph);
+			if (latestMigration) {
+				fromHash = latestMigration.to;
+				const leafPkg = bundles.find((p) => p.manifest.migrationId === latestMigration.migrationId);
+				if (leafPkg) fromContract = leafPkg.manifest.toContract;
+			}
+		}
+	} catch (error) {
+		if (MigrationToolsError.is(error)) return notOk(mapMigrationToolsError(error));
+		throw error;
+	}
+	if (fromHash === toStorageHash) return ok({
+		ok: true,
+		noOp: true,
+		from: fromHash,
+		to: toStorageHash,
+		operations: [],
+		summary: "No changes detected between contracts",
+		timings: { total: Date.now() - startTime }
+	});
+	const migrations = getTargetMigrations(config.target);
+	if (!migrations) return notOk(errorTargetMigrationNotSupported({ why: `Target "${config.target.id}" does not support migrations` }));
+	const stack = createControlPlaneStack({
+		target: config.target,
+		adapter: config.adapter,
+		extensionPacks: config.extensionPacks ?? []
+	});
+	const familyInstance = config.family.create(stack);
+	const frameworkComponents = assertFrameworkComponentsCompatible(config.family.familyId, config.target.targetId, [
+		config.target,
+		config.adapter,
+		...config.extensionPacks ?? []
+	]);
+	const planner = migrations.createPlanner(familyInstance);
+	const fromSchemaIR = migrations.contractToSchema(fromContract, frameworkComponents);
+	const plannerResult = planner.plan({
+		contract: toContractJson,
+		schema: fromSchemaIR,
+		policy: { allowedOperationClasses: [
+			"additive",
+			"widening",
+			"destructive"
+		] },
+		frameworkComponents
+	});
+	if (plannerResult.kind === "failure") return notOk(errorMigrationPlanningFailed({ conflicts: plannerResult.conflicts }));
+	if (plannerResult.plan.operations.length === 0) return notOk(errorMigrationPlanningFailed({ conflicts: [{
+		kind: "unsupportedChange",
+		summary: "Contract changed but planner produced no operations. This indicates unsupported or ignored changes (e.g. removals, type changes, or a planner/contract mismatch)."
+	}] }));
+	const timestamp = /* @__PURE__ */ new Date();
+	const packageDir = join(migrationsDir, formatMigrationDirName(timestamp, options.name ?? "migration"));
+	const manifest = {
+		from: fromHash,
+		to: toStorageHash,
+		migrationId: null,
+		kind: "regular",
+		fromContract,
+		toContract: toContractJson,
+		hints: {
+			used: [],
+			applied: [],
+			plannerVersion: "1.0.0",
+			planningStrategy: "diff"
+		},
+		labels: [],
+		createdAt: timestamp.toISOString()
+	};
+	try {
+		await writeMigrationPackage(packageDir, manifest, plannerResult.plan.operations);
+		const migrationId = await attestMigration(packageDir);
+		const sql = extractSqlDdl(plannerResult.plan.operations);
+		return ok({
+			ok: true,
+			noOp: false,
+			from: fromHash,
+			to: toStorageHash,
+			migrationId,
+			dir: relative(process.cwd(), packageDir),
+			operations: plannerResult.plan.operations.map((op) => ({
+				id: op.id,
+				label: op.label,
+				operationClass: op.operationClass
+			})),
+			sql,
+			summary: `Planned ${plannerResult.plan.operations.length} operation(s)`,
+			timings: { total: Date.now() - startTime }
+		});
+	} catch (error) {
+		return notOk(mapMigrationToolsError(error));
+	}
+}
+function createMigrationPlanCommand() {
+	const command = new Command("plan");
+	setCommandDescriptions(command, "Plan a migration from contract changes", "Compares the emitted contract against the latest on-disk migration state and\nproduces a new migration package with the required operations. No database\nconnection is needed — this is a fully offline operation.");
+	setCommandExamples(command, ["prisma-next migration plan", "prisma-next migration plan --name add-users-table"]);
+	addGlobalOptions(command).option("--config <path>", "Path to prisma-next.config.ts").option("--name <slug>", "Name slug for the migration directory", "migration").option("--from <hash>", "Explicit starting contract hash (overrides latest migration target)").action(async (options) => {
+		const flags = parseGlobalFlags(options);
+		const startTime = Date.now();
+		const ui = new TerminalUI({
+			color: flags.color,
+			interactive: flags.interactive
+		});
+		const exitCode = handleResult(await executeMigrationPlanCommand(options, flags, ui, startTime), flags, ui, (planResult) => {
+			if (flags.json) ui.output(JSON.stringify(planResult, null, 2));
+			else if (!flags.quiet) ui.log(formatMigrationPlanOutput(planResult, flags));
+		});
+		process.exit(exitCode);
+	});
+	return command;
+}
+function formatMigrationPlanOutput(result, flags) {
+	const lines = [];
+	const useColor = flags.color !== false;
+	const green_ = useColor ? (s) => `\x1b[32m${s}\x1b[0m` : (s) => s;
+	const yellow_ = useColor ? (s) => `\x1b[33m${s}\x1b[0m` : (s) => s;
+	const dim_ = useColor ? (s) => `\x1b[2m${s}\x1b[0m` : (s) => s;
+	if (result.noOp) {
+		lines.push(`${green_("✔")} No changes detected`);
+		lines.push(dim_(`  from: ${result.from}`));
+		lines.push(dim_(`  to:   ${result.to}`));
+		return lines.join("\n");
+	}
+	lines.push(`${green_("✔")} ${result.summary}`);
+	lines.push("");
+	if (result.operations.length > 0) {
+		lines.push(dim_("│"));
+		for (let i = 0; i < result.operations.length; i++) {
+			const op = result.operations[i];
+			const treeChar = i === result.operations.length - 1 ? "└" : "├";
+			const opClassLabel = op.operationClass === "destructive" ? yellow_(`[${op.operationClass}]`) : dim_(`[${op.operationClass}]`);
+			lines.push(`${dim_(treeChar)}─ ${op.label} ${opClassLabel}`);
+		}
+		if (result.operations.some((op) => op.operationClass === "destructive")) {
+			lines.push("");
+			lines.push(`${yellow_("⚠")} This migration contains destructive operations that may cause data loss.`);
+		}
+		lines.push("");
+	}
+	lines.push(dim_(`from:   ${result.from}`));
+	lines.push(dim_(`to:     ${result.to}`));
+	if (result.migrationId) lines.push(dim_(`migrationId: ${result.migrationId}`));
+	if (result.dir) lines.push(dim_(`dir:    ${result.dir}`));
+	if (result.sql && result.sql.length > 0) {
+		lines.push("");
+		lines.push(dim_("DDL preview"));
+		lines.push("");
+		for (const statement of result.sql) {
+			const trimmed = statement.trim();
+			if (!trimmed) continue;
+			const line = trimmed.endsWith(";") ? trimmed : `${trimmed};`;
+			lines.push(line);
+		}
+	}
+	if (flags.verbose && result.timings) {
+		lines.push("");
+		lines.push(dim_(`Total time: ${result.timings.total}ms`));
+	}
+	return lines.join("\n");
+}
+/**
+* Resolve a migration bundle by exact hash or prefix match.
+*
+* Tries exact match first, then prefix match (auto-prepending `sha256:` when
+* the needle omits the scheme). Returns the matched bundle on success, or a
+* discriminated failure indicating whether the prefix was ambiguous or simply
+* not found.
+*
+* @internal Exported for testing only.
+*/
+function resolveBundleByPrefix(bundles, needle) {
+	const exact = bundles.find((p) => p.manifest.to === needle);
+	if (exact) return ok(exact);
+	const prefixWithScheme = needle.startsWith("sha256:") ? needle : `sha256:${needle}`;
+	const candidates = bundles.filter((p) => p.manifest.to.startsWith(prefixWithScheme));
+	if (candidates.length === 1) return ok(candidates[0]);
+	if (candidates.length > 1) return notOk({
+		reason: "ambiguous",
+		count: candidates.length
+	});
+	return notOk({ reason: "not-found" });
+}
+
+//#endregion
+export { createMigrationPlanCommand, resolveBundleByPrefix };
+//# sourceMappingURL=migration-plan.mjs.map