prisma-next 0.5.0-dev.8 → 0.5.0-dev.81

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

@@ -1,19 +1,42 @@
+import { t as GlobalFlags } from "../global-flags-Icqpxk23.mjs";
 import { Command } from "commander";
 import { Result } from "@prisma-next/utils/result";
+import { OperationPreview } from "@prisma-next/framework-components/control";
 
 //#region src/commands/migration-plan.d.ts
 interface MigrationPlanResult {
   readonly ok: boolean;
   readonly noOp: boolean;
-  readonly from: string;
+  readonly from: string | null;
   readonly to: string;
   readonly dir?: string;
+  /**
+   * Extension-space migration packages materialised onto disk during this
+   * `plan` run. Each entry names a `migrations/<spaceId>/<dirName>/`
+   * tree the framework wrote alongside the app-space migration directory.
+   * Empty when the project has no extension packs declaring a contract
+   * space, or when every extension-space package is already on disk.
+   *
+   * Surfacing these in the result (rather than only via `ui.step` log
+   * lines) makes the cross-space side effect explicit to JSON consumers
+   * and the success-summary renderer — the same multi-space side effect
+   * that `migration apply` will replay.
+   */
+  readonly emittedExtensionDirs: readonly {
+    readonly spaceId: string;
+    readonly dirName: string;
+  }[];
   readonly operations: readonly {
     readonly id: string;
     readonly label: string;
     readonly operationClass: string;
   }[];
-  readonly sql?: readonly string[];
+  /**
+   * Family-agnostic textual preview of the migration plan operations.
+   * Replaces the previous `sql?: readonly string[]` field; consumers should
+   * read `result.preview?.statements`.
+   */
+  readonly preview?: OperationPreview;
   readonly summary: string;
   /**
    * When true, `migration.ts` was written but contains unfilled
@@ -26,6 +49,7 @@ interface MigrationPlanResult {
   };
 }
 declare function createMigrationPlanCommand(): Command;
+declare function formatMigrationPlanOutput(result: MigrationPlanResult, flags: GlobalFlags): string;
 type PrefixResolutionFailure = {
   reason: 'ambiguous';
   count: number;
@@ -33,20 +57,23 @@ type PrefixResolutionFailure = {
   reason: 'not-found';
 };
 /**
- * Resolve a migration bundle by exact hash or prefix match.
+ * Resolve a migration package by **target contract hash** (`metadata.to`)
+ * using exact match or prefix match.
  *
+ * Note: matches `metadata.to` (the contract hash this migration produces),
+ * not `metadata.migrationHash` (the package's content-addressed identity).
  * Tries exact match first, then prefix match (auto-prepending `sha256:` when
- * the needle omits the scheme). Returns the matched bundle on success, or a
+ * the needle omits the scheme). Returns the matched package 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: {
+  metadata: {
     to: string;
   };
 }>(bundles: readonly T[], needle: string): Result<T, PrefixResolutionFailure>;
 //#endregion
-export { MigrationPlanResult, PrefixResolutionFailure, createMigrationPlanCommand, resolveBundleByPrefix };
+export { MigrationPlanResult, PrefixResolutionFailure, createMigrationPlanCommand, formatMigrationPlanOutput, resolveBundleByPrefix };
 //# sourceMappingURL=migration-plan.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"migration-plan.d.mts","names":[],"sources":["../../src/commands/migration-plan.ts"],"sourcesContent":[],"mappings":";;;;UAsDiB,mBAAA;;EAAA,SAAA,IAAA,EAAA,OAAmB;EA8UpB,SAAA,IAAA,EAAA,MAAA;EA8HJ,SAAA,EAAA,EAAA,MAAA;EAcI,SAAA,GAAA,CAAA,EAAA,MAAA;EACI,SAAA,UAAA,EAAA,SAAA;IAEV,SAAA,EAAA,EAAA,MAAA;IAAG,SAAA,KAAA,EAAA,MAAA;IAAV,SAAA,cAAA,EAAA,MAAA;EAAM,CAAA,EAAA;;;;;;;;;;;;;iBA/IO,0BAAA,CAAA,GAA8B;KA8HlC,uBAAA;;;;;;;;;;;;;;;;iBAcI;;;;qBACI,sBAEjB,OAAO,GAAG"}
+{"version":3,"file":"migration-plan.d.mts","names":[],"sources":["../../src/commands/migration-plan.ts"],"mappings":";;;;;;UAoEiB,mBAAA;EAAA,SACN,EAAA;EAAA,SACA,IAAA;EAAA,SACA,IAAA;EAAA,SACA,EAAA;EAAA,SACA,GAAA;EAJA;;;;;;;;;;;;EAAA,SAiBA,oBAAA;IAAA,SAA0C,OAAA;IAAA,SAA0B,OAAA;EAAA;EAAA,SACpE,UAAA;IAAA,SACE,EAAA;IAAA,SACA,KAAA;IAAA,SACA,cAAA;EAAA;EA0X6B;;;;AA4D1C;EA5D0C,SAnX/B,OAAA,GAAU,gBAAA;EAAA,SACV,OAAA;EA8a8E;;;;;EAAA,SAxa9E,mBAAA;EAAA,SACA,OAAA;IAAA,SACE,KAAA;EAAA;AAAA;AAAA,iBA0WG,0BAAA,CAAA,GAA8B,OAAA;AAAA,iBA4D9B,yBAAA,CAA0B,MAAA,EAAQ,mBAAA,EAAqB,KAAA,EAAO,WAAA;AAAA,KA2HlE,uBAAA;EACN,MAAA;EAAqB,KAAA;AAAA;EACrB,MAAA;AAAA;;;;;;;;;;;;;;iBAeU,qBAAA;EAAkC,QAAA;IAAY,EAAA;EAAA;AAAA,EAAA,CAC5D,OAAA,WAAkB,CAAA,IAClB,MAAA,WACC,MAAA,CAAO,CAAA,EAAG,uBAAA"}

package/dist/commands/migration-plan.mjs

@@ -1,348 +1,2 @@
-import { t as loadConfig } from "../config-loader-C25b63rJ.mjs";
-import { _ as errorUnexpected, a as errorContractValidationFailed, f as errorMigrationPlanningFailed, h as errorTargetMigrationNotSupported, l as errorFileNotFound, m as errorRuntime, t as CliStructuredError } from "../cli-errors-Cd79vmTH.mjs";
-import { t as assertFrameworkComponentsCompatible } from "../framework-components-Cr--XBKy.mjs";
-import { t as extractSqlDdl } from "../extract-sql-ddl-D9UbZDyz.mjs";
-import { t as TerminalUI } from "../terminal-ui-C3ZLwQxK.mjs";
-import { _ as formatStyledHeader, c as resolveMigrationPaths, d as setCommandExamples, i as loadAllBundles, m as parseGlobalFlags, n as addGlobalOptions, r as getTargetMigrations, s as resolveContractPath, t as handleResult, u as setCommandDescriptions } from "../result-handler-Ba3zWQsI.mjs";
-import { Command } from "commander";
-import { getEmittedArtifactPaths } from "@prisma-next/emitter";
-import { notOk, ok } from "@prisma-next/utils/result";
-import { join, relative } from "pathe";
-import { createControlStack } from "@prisma-next/framework-components/control";
-import { EMPTY_CONTRACT_HASH } from "@prisma-next/migration-tools/constants";
-import { readFile } from "node:fs/promises";
-import { findLatestMigration } from "@prisma-next/migration-tools/dag";
-import { copyFilesWithRename, formatMigrationDirName, writeMigrationPackage } from "@prisma-next/migration-tools/io";
-import { computeMigrationId } from "@prisma-next/migration-tools/attestation";
-import { MigrationToolsError } from "@prisma-next/migration-tools/types";
-import { writeMigrationTs } from "@prisma-next/migration-tools/migration-ts";
-
-//#region src/commands/migration-plan.ts
-function mapMigrationToolsError(error) {
-	if (CliStructuredError.is(error)) return 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 rawStorageHash = toContractJson.storage?.storageHash;
-	if (typeof rawStorageHash !== "string") return notOk(errorContractValidationFailed("Contract is missing storageHash", { where: { path: contractPathAbsolute } }));
-	const toStorageHash = rawStorageHash;
-	let fromContract = null;
-	let fromHash = EMPTY_CONTRACT_HASH;
-	let fromContractSourceDir = null;
-	try {
-		const { bundles, graph } = await loadAllBundles(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;
-			fromContractSourceDir = resolved.value.dirPath;
-		} 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;
-					fromContractSourceDir = leafPkg.dirPath;
-				}
-			}
-		}
-	} 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 frameworkComponents = assertFrameworkComponentsCompatible(config.family.familyId, config.target.targetId, [
-		config.target,
-		config.adapter,
-		...config.extensionPacks ?? []
-	]);
-	const timestamp = /* @__PURE__ */ new Date();
-	const packageDir = join(migrationsDir, formatMigrationDirName(timestamp, options.name ?? "migration"));
-	const baseManifest = {
-		from: fromHash,
-		to: toStorageHash,
-		kind: "regular",
-		fromContract,
-		toContract: toContractJson,
-		hints: {
-			used: [],
-			applied: [],
-			plannerVersion: "2.0.0"
-		},
-		labels: [],
-		createdAt: timestamp.toISOString()
-	};
-	try {
-		const stack = createControlStack(config);
-		const familyInstance = config.family.create(stack);
-		const planner = migrations.createPlanner(familyInstance);
-		const fromSchema = migrations.contractToSchema(fromContract, frameworkComponents);
-		const plannerResult = planner.plan({
-			contract: toContractJson,
-			schema: fromSchema,
-			policy: { allowedOperationClasses: [
-				"additive",
-				"widening",
-				"destructive",
-				"data"
-			] },
-			fromHash,
-			fromContract,
-			frameworkComponents
-		});
-		if (plannerResult.kind === "failure") return notOk(errorMigrationPlanningFailed({ conflicts: plannerResult.conflicts }));
-		let plannedOps = [];
-		let hasPlaceholders = false;
-		try {
-			plannedOps = plannerResult.plan.operations;
-			if (plannedOps.length === 0) return notOk(errorMigrationPlanningFailed({ conflicts: [{
-				kind: "unsupportedChange",
-				summary: "Contract changed but planner produced no operations. This indicates unsupported or ignored changes."
-			}] }));
-		} catch (e) {
-			if (CliStructuredError.is(e) && e.domain === "MIG" && e.code === "2001") hasPlaceholders = true;
-			else throw e;
-		}
-		const migrationTsContent = plannerResult.plan.renderTypeScript();
-		const opsForWrite = hasPlaceholders ? [] : plannedOps;
-		await writeMigrationPackage(packageDir, {
-			...baseManifest,
-			migrationId: computeMigrationId(baseManifest, opsForWrite)
-		}, opsForWrite);
-		const destinationArtifacts = getEmittedArtifactPaths(contractPathAbsolute);
-		await copyFilesWithRename(packageDir, [{
-			sourcePath: destinationArtifacts.jsonPath,
-			destName: "end-contract.json"
-		}, {
-			sourcePath: destinationArtifacts.dtsPath,
-			destName: "end-contract.d.ts"
-		}]);
-		if (fromContractSourceDir !== null) {
-			const sourceArtifacts = getEmittedArtifactPaths(join(fromContractSourceDir, "end-contract.json"));
-			await copyFilesWithRename(packageDir, [{
-				sourcePath: sourceArtifacts.jsonPath,
-				destName: "start-contract.json"
-			}, {
-				sourcePath: sourceArtifacts.dtsPath,
-				destName: "start-contract.d.ts"
-			}]);
-		}
-		await writeMigrationTs(packageDir, migrationTsContent);
-		if (hasPlaceholders) return ok({
-			ok: true,
-			noOp: false,
-			from: fromHash,
-			to: toStorageHash,
-			dir: relative(process.cwd(), packageDir),
-			operations: [],
-			pendingPlaceholders: true,
-			summary: "Planned migration with placeholder(s) — edit migration.ts then run `node migration.ts` to self-emit",
-			timings: { total: Date.now() - startTime }
-		});
-		const sql = extractSqlDdl(plannedOps);
-		return ok({
-			ok: true,
-			noOp: false,
-			from: fromHash,
-			to: toStorageHash,
-			dir: relative(process.cwd(), packageDir),
-			operations: plannedOps.map((op) => ({
-				id: op.id,
-				label: op.label,
-				operationClass: op.operationClass
-			})),
-			sql,
-			summary: `Planned ${plannedOps.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");
-	}
-	if (result.pendingPlaceholders) {
-		lines.push(`${yellow_("⚠")} ${result.summary}`);
-		lines.push("");
-		lines.push(dim_(`from: ${result.from}`));
-		lines.push(dim_(`to:   ${result.to}`));
-		if (result.dir) lines.push(dim_(`dir:  ${result.dir}`));
-		lines.push("");
-		lines.push("Open migration.ts and replace each `placeholder(...)` call with your actual query.");
-		lines.push(`Then run: ${green_(`node ${result.dir ?? "<dir>"}/migration.ts`)}`);
-		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.dir) lines.push(dim_(`dir:    ${result.dir}`));
-	lines.push("");
-	lines.push(`Next: ${green_(`node ${result.dir ?? "<dir>"}/migration.ts`)} to emit ops.json and attest migrationId before running ${green_("prisma-next migration apply")}.`);
-	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
+import { n as formatMigrationPlanOutput, r as resolveBundleByPrefix, t as createMigrationPlanCommand } from "../migration-plan-C6lVaHsO.mjs";
+export { createMigrationPlanCommand, formatMigrationPlanOutput, resolveBundleByPrefix };

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

@@ -1,4 +1,4 @@
-import { t as CliStructuredError } from "../cli-errors-BFYgBH3L.mjs";
+import { t as CliStructuredError } from "../cli-errors-B9OBbled.mjs";
 import { Command } from "commander";
 import { Result } from "@prisma-next/utils/result";
 import { RefEntry } from "@prisma-next/migration-tools/refs";

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

@@ -1 +1 @@
-{"version":3,"file":"migration-ref.d.mts","names":[],"sources":["../../src/commands/migration-ref.ts"],"sourcesContent":[],"mappings":";;;;;;UAwBU,YAAA;;EAAA,SAAA,GAAA,EAAA,MAAY;EAOZ,SAAA,IAAA,EAAY,MAAA;EAOZ,SAAA,UAAe,EAAA,SAAA,MAAA,EAAA;AAAA;AAQF,UAfb,YAAA,CA6BD;EAOA,SAAA,EAAA,EAAA,IAAA;EAOM,SAAA,GAAA,EAAA,MAAA;EAIG,SAAA,IAAA,EAAA,MAAA;EAAc,SAAA,UAAA,EAAA,SAAA,MAAA,EAAA;;UAxCtB,eAAA,CAwCP;EAAO,SAAA,EAAA,EAAA,IAAA;EAoBK,SAAA,GAAA,EAAA,MAAA;EAGG,SAAA,OAAA,EAAA,IAAA;;UAzDR,aAAA,CAyDC;EAAR,SAAA,EAAA,EAAA,IAAA;EAAO,SAAA,IAAA,EAvDO,MAuDP,CAAA,MAAA,EAvDsB,QAuDtB,CAAA;AAAA;iBAzCD,sBAAA,CAwDS,IAAA,EAAA,MAAA,CAAA,EAxD6B,kBAwD7B;iBAjDT,uBAAA,CAiD0B,IAAA,EAAA,MAAA,CAAA,EAjDa,kBAiDb;iBA1CpB,oBAAA,CA0CJ,IAAA,EAAA,MAAA,EAAA,IAAA,EAAA,MAAA,EAAA,OAAA,EAAA;EAAR,MAAA,CAAA,EAAA,MAAA;CAAO,CAAA,EAtCP,OAsCO,CAtCC,MAsCD,CAtCQ,YAsCR,EAtCsB,kBAsCtB,CAAA,CAAA;AAAA,iBAlBK,oBAAA,CA8BqB,IAAA,EAAA,MAAA,EAAA,OAAA,EAAA;EAEjB,MAAA,CAAA,EAAA,MAAA;CAAe,CAAA,EA7B/B,OA6B+B,CA7BvB,MA6BuB,CA7BhB,YA6BgB,EA7BF,kBA6BE,CAAA,CAAA;iBAjBnB,uBAAA,CAiBH,IAAA,EAAA,MAAA,EAAA,OAAA,EAAA;EAAR,MAAA,CAAA,EAAA,MAAA;CAAO,CAAA,EAdR,OAcQ,CAdA,MAcA,CAdO,eAcP,EAdwB,kBAcxB,CAAA,CAAA;AA8IX,iBAhJe,qBAAA,CAgJ0B,OAAI,EAAA;;IA9IzC,QAAQ,OAAO,eAAe;iBA8IlB,yBAAA,CAAA,GAA6B"}
+{"version":3,"file":"migration-ref.d.mts","names":[],"sources":["../../src/commands/migration-ref.ts"],"mappings":";;;;;;UA6BU,YAAA;EAAA,SACC,EAAA;EAAA,SACA,GAAA;EAAA,SACA,IAAA;EAAA,SACA,UAAA;AAAA;AAAA,UAGD,YAAA;EAAA,SACC,EAAA;EAAA,SACA,GAAA;EAAA,SACA,IAAA;EAAA,SACA,UAAA;AAAA;AAAA,UAGD,eAAA;EAAA,SACC,EAAA;EAAA,SACA,GAAA;EAAA,SACA,OAAA;AAAA;AAAA,UAGD,aAAA;EAAA,SACC,EAAA;EAAA,SACA,IAAA,EAAM,MAAA,SAAe,QAAA;AAAA;AAAA,iBAUvB,sBAAA,CAAuB,IAAA,WAAe,kBAAA;AAAA,iBAOtC,uBAAA,CAAwB,IAAA,WAAe,kBAAA;AAAA,iBAOjC,oBAAA,CACb,IAAA,UACA,IAAA,UACA,OAAA;EAAW,MAAA;AAAA,IACV,OAAA,CAAQ,MAAA,CAAO,YAAA,EAAc,kBAAA;AAAA,iBAoBjB,oBAAA,CACb,IAAA,UACA,OAAA;EAAW,MAAA;AAAA,IACV,OAAA,CAAQ,MAAA,CAAO,YAAA,EAAc,kBAAA;AAAA,iBAYjB,uBAAA,CACb,IAAA,UACA,OAAA;EAAW,MAAA;AAAA,IACV,OAAA,CAAQ,MAAA,CAAO,eAAA,EAAiB,kBAAA;AAAA,iBAYpB,qBAAA,CAAsB,OAAA;EACnC,MAAA;AAAA,IACE,OAAA,CAAQ,MAAA,CAAO,aAAA,EAAe,kBAAA;AAAA,iBA8IlB,yBAAA,CAAA,GAA6B,OAAA"}

package/dist/commands/migration-ref.mjs

@@ -1,19 +1,15 @@
-import { t as loadConfig } from "../config-loader-C25b63rJ.mjs";
-import { _ as errorUnexpected, m as errorRuntime, t as CliStructuredError } from "../cli-errors-Cd79vmTH.mjs";
-import { t as TerminalUI } from "../terminal-ui-C3ZLwQxK.mjs";
-import { c as resolveMigrationPaths, h as formatCommandHelp, m as parseGlobalFlags, n as addGlobalOptions, t as handleResult, u as setCommandDescriptions } from "../result-handler-Ba3zWQsI.mjs";
+import { t as loadConfig } from "../config-loader-B6sJjXTv.mjs";
+import { _ as errorUnexpected, m as errorRuntime, t as CliStructuredError, v as mapMigrationToolsError } from "../cli-errors-D3_sMh2K.mjs";
+import { _ as formatCommandHelp, d as setCommandDescriptions, g as parseGlobalFlags, l as resolveMigrationPaths, t as addGlobalOptions } from "../command-helpers-BeZHkxV8.mjs";
+import { t as TerminalUI } from "../terminal-ui-C_hFNbAn.mjs";
+import { t as handleResult } from "../result-handler-rmPVKIP2.mjs";
 import { Command } from "commander";
 import { notOk, ok } from "@prisma-next/utils/result";
+import { MigrationToolsError } from "@prisma-next/migration-tools/errors";
 import { deleteRef, readRef, readRefs, validateRefName, validateRefValue, writeRef } from "@prisma-next/migration-tools/refs";
-import { MigrationToolsError } from "@prisma-next/migration-tools/types";
-
 //#region src/commands/migration-ref.ts
 function mapError(error) {
-	if (MigrationToolsError.is(error)) return errorRuntime(error.message, {
-		why: error.why,
-		fix: error.fix,
-		meta: { code: error.code }
-	});
+	if (MigrationToolsError.is(error)) return mapMigrationToolsError(error);
 	return errorUnexpected(error instanceof Error ? error.message : String(error));
 }
 function cliErrorInvalidRefName(name) {
@@ -184,7 +180,7 @@ function createMigrationRefCommand() {
 	command.addCommand(createRefListCommand());
 	return command;
 }
-
 //#endregion
 export { cliErrorInvalidRefName, cliErrorInvalidRefValue, createMigrationRefCommand, executeRefDeleteCommand, executeRefGetCommand, executeRefListCommand, executeRefSetCommand };
+
 //# sourceMappingURL=migration-ref.mjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"migration-ref.mjs","names":[],"sources":["../../src/commands/migration-ref.ts"],"sourcesContent":["import type { RefEntry } from '@prisma-next/migration-tools/refs';\nimport {\n  deleteRef,\n  readRef,\n  readRefs,\n  validateRefName,\n  validateRefValue,\n  writeRef,\n} from '@prisma-next/migration-tools/refs';\nimport { MigrationToolsError } from '@prisma-next/migration-tools/types';\nimport { notOk, ok, type Result } from '@prisma-next/utils/result';\nimport { Command } from 'commander';\nimport { loadConfig } from '../config-loader';\nimport { CliStructuredError, errorRuntime, errorUnexpected } from '../utils/cli-errors';\nimport {\n  addGlobalOptions,\n  resolveMigrationPaths,\n  setCommandDescriptions,\n} from '../utils/command-helpers';\nimport { formatCommandHelp } from '../utils/formatters/help';\nimport { parseGlobalFlags } from '../utils/global-flags';\nimport { handleResult } from '../utils/result-handler';\nimport { TerminalUI } from '../utils/terminal-ui';\n\ninterface RefSetResult {\n  readonly ok: true;\n  readonly ref: string;\n  readonly hash: string;\n  readonly invariants: readonly string[];\n}\n\ninterface RefGetResult {\n  readonly ok: true;\n  readonly ref: string;\n  readonly hash: string;\n  readonly invariants: readonly string[];\n}\n\ninterface RefDeleteResult {\n  readonly ok: true;\n  readonly ref: string;\n  readonly deleted: true;\n}\n\ninterface RefListResult {\n  readonly ok: true;\n  readonly refs: Record<string, RefEntry>;\n}\n\nfunction mapError(error: unknown): CliStructuredError {\n  if (MigrationToolsError.is(error)) {\n    return errorRuntime(error.message, {\n      why: error.why,\n      fix: error.fix,\n      meta: { code: error.code },\n    });\n  }\n  return errorUnexpected(error instanceof Error ? error.message : String(error));\n}\n\nfunction cliErrorInvalidRefName(name: string): CliStructuredError {\n  return errorRuntime(`Invalid ref name \"${name}\"`, {\n    why: `Ref name \"${name}\" does not match the required format`,\n    fix: 'Ref names must be lowercase alphanumeric with hyphens or forward slashes, no `.` or `..` segments',\n  });\n}\n\nfunction cliErrorInvalidRefValue(hash: string): CliStructuredError {\n  return errorRuntime(`Invalid contract hash \"${hash}\"`, {\n    why: `\"${hash}\" is not a valid contract hash`,\n    fix: 'Contract hashes must match the format \"sha256:<64 hex chars>\". Copy the hash from `prisma-next contract emit` or `migration status --json`.',\n  });\n}\n\nasync function executeRefSetCommand(\n  name: string,\n  hash: string,\n  options: { config?: string },\n): Promise<Result<RefSetResult, CliStructuredError>> {\n  if (!validateRefName(name)) {\n    return notOk(cliErrorInvalidRefName(name));\n  }\n  if (!validateRefValue(hash)) {\n    return notOk(cliErrorInvalidRefValue(hash));\n  }\n\n  try {\n    const config = await loadConfig(options.config);\n    const { refsDir } = resolveMigrationPaths(options.config, config);\n    const entry: RefEntry = { hash, invariants: [] };\n    await writeRef(refsDir, name, entry);\n    return ok({ ok: true as const, ref: name, hash, invariants: [] });\n  } catch (error) {\n    if (error instanceof CliStructuredError) return notOk(error);\n    return notOk(mapError(error));\n  }\n}\n\nasync function executeRefGetCommand(\n  name: string,\n  options: { config?: string },\n): Promise<Result<RefGetResult, CliStructuredError>> {\n  try {\n    const config = await loadConfig(options.config);\n    const { refsDir } = resolveMigrationPaths(options.config, config);\n    const entry = await readRef(refsDir, name);\n    return ok({ ok: true as const, ref: name, hash: entry.hash, invariants: entry.invariants });\n  } catch (error) {\n    if (error instanceof CliStructuredError) return notOk(error);\n    return notOk(mapError(error));\n  }\n}\n\nasync function executeRefDeleteCommand(\n  name: string,\n  options: { config?: string },\n): Promise<Result<RefDeleteResult, CliStructuredError>> {\n  try {\n    const config = await loadConfig(options.config);\n    const { refsDir } = resolveMigrationPaths(options.config, config);\n    await deleteRef(refsDir, name);\n    return ok({ ok: true as const, ref: name, deleted: true as const });\n  } catch (error) {\n    if (error instanceof CliStructuredError) return notOk(error);\n    return notOk(mapError(error));\n  }\n}\n\nasync function executeRefListCommand(options: {\n  config?: string;\n}): Promise<Result<RefListResult, CliStructuredError>> {\n  try {\n    const config = await loadConfig(options.config);\n    const { refsDir } = resolveMigrationPaths(options.config, config);\n    const refs = await readRefs(refsDir);\n    return ok({ ok: true as const, refs });\n  } catch (error) {\n    if (error instanceof CliStructuredError) return notOk(error);\n    return notOk(mapError(error));\n  }\n}\n\nfunction createRefSetCommand(): Command {\n  const command = new Command('set');\n  setCommandDescriptions(\n    command,\n    'Set a ref to a contract hash',\n    'Sets a named ref to point to a contract hash in migrations/refs/.',\n  );\n  addGlobalOptions(command)\n    .argument('<name>', 'Ref name (e.g., staging, production)')\n    .argument('<hash>', 'Contract hash to point to')\n    .option('--config <path>', 'Path to prisma-next.config.ts')\n    .action(\n      async (\n        name: string,\n        hash: string,\n        options: { config?: string; json?: string | boolean; quiet?: boolean },\n      ) => {\n        const flags = parseGlobalFlags(options);\n        const ui = new TerminalUI({ color: flags.color, interactive: flags.interactive });\n        const result = await executeRefSetCommand(name, hash, options);\n        const exitCode = handleResult(result, flags, ui, (value) => {\n          if (flags.json) {\n            ui.output(JSON.stringify(value));\n          } else if (!flags.quiet) {\n            ui.output(`Set ref \"${value.ref}\" → ${value.hash}`);\n          }\n        });\n        process.exit(exitCode);\n      },\n    );\n  return command;\n}\n\nfunction createRefGetCommand(): Command {\n  const command = new Command('get');\n  setCommandDescriptions(\n    command,\n    'Get the hash for a ref',\n    'Reads a named ref from migrations/refs/ and prints its contract hash.',\n  );\n  addGlobalOptions(command)\n    .argument('<name>', 'Ref name to look up')\n    .option('--config <path>', 'Path to prisma-next.config.ts')\n    .action(\n      async (\n        name: string,\n        options: { config?: string; json?: string | boolean; quiet?: boolean },\n      ) => {\n        const flags = parseGlobalFlags(options);\n        const ui = new TerminalUI({ color: flags.color, interactive: flags.interactive });\n        const result = await executeRefGetCommand(name, options);\n        const exitCode = handleResult(result, flags, ui, (value) => {\n          if (flags.json) {\n            ui.output(JSON.stringify(value));\n          } else {\n            ui.output(value.hash);\n          }\n        });\n        process.exit(exitCode);\n      },\n    );\n  return command;\n}\n\nfunction createRefDeleteCommand(): Command {\n  const command = new Command('delete');\n  setCommandDescriptions(command, 'Delete a ref', 'Removes a named ref from migrations/refs/.');\n  addGlobalOptions(command)\n    .argument('<name>', 'Ref name to delete')\n    .option('--config <path>', 'Path to prisma-next.config.ts')\n    .action(\n      async (\n        name: string,\n        options: { config?: string; json?: string | boolean; quiet?: boolean },\n      ) => {\n        const flags = parseGlobalFlags(options);\n        const ui = new TerminalUI({ color: flags.color, interactive: flags.interactive });\n        const result = await executeRefDeleteCommand(name, options);\n        const exitCode = handleResult(result, flags, ui, (value) => {\n          if (flags.json) {\n            ui.output(JSON.stringify(value));\n          } else if (!flags.quiet) {\n            ui.output(`Deleted ref \"${value.ref}\"`);\n          }\n        });\n        process.exit(exitCode);\n      },\n    );\n  return command;\n}\n\nfunction createRefListCommand(): Command {\n  const command = new Command('list');\n  setCommandDescriptions(command, 'List all refs', 'Lists all named refs from migrations/refs/.');\n  addGlobalOptions(command)\n    .option('--config <path>', 'Path to prisma-next.config.ts')\n    .action(async (options: { config?: string; json?: string | boolean; quiet?: boolean }) => {\n      const flags = parseGlobalFlags(options);\n      const ui = new TerminalUI({ color: flags.color, interactive: flags.interactive });\n      const result = await executeRefListCommand(options);\n      const exitCode = handleResult(result, flags, ui, (value) => {\n        if (flags.json) {\n          ui.output(JSON.stringify(value));\n        } else if (!flags.quiet) {\n          const entries = Object.entries(value.refs);\n          if (entries.length === 0) {\n            ui.output('No refs defined');\n          } else {\n            for (const [refName, entry] of entries) {\n              const invariantsSuffix =\n                entry.invariants.length > 0 ? ` [invariants: ${entry.invariants.join(', ')}]` : '';\n              ui.output(`${refName} → ${entry.hash}${invariantsSuffix}`);\n            }\n          }\n        }\n      });\n      process.exit(exitCode);\n    });\n  return command;\n}\n\nexport {\n  executeRefSetCommand,\n  executeRefGetCommand,\n  executeRefDeleteCommand,\n  executeRefListCommand,\n  cliErrorInvalidRefName,\n  cliErrorInvalidRefValue,\n};\n\nexport function createMigrationRefCommand(): Command {\n  const command = new Command('ref');\n  setCommandDescriptions(\n    command,\n    'Manage migration refs',\n    'Manage named refs in migrations/refs/. Refs map logical environment\\n' +\n      'names (e.g., staging, production) to contract hashes.',\n  );\n  addGlobalOptions(command).configureHelp({\n    formatHelp: (cmd) => formatCommandHelp({ command: cmd, flags: parseGlobalFlags({}) }),\n    subcommandDescription: () => '',\n  });\n  command.addCommand(createRefSetCommand());\n  command.addCommand(createRefGetCommand());\n  command.addCommand(createRefDeleteCommand());\n  command.addCommand(createRefListCommand());\n  return command;\n}\n"],"mappings":"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"}
+{"version":3,"file":"migration-ref.mjs","names":[],"sources":["../../src/commands/migration-ref.ts"],"sourcesContent":["import { MigrationToolsError } from '@prisma-next/migration-tools/errors';\nimport type { RefEntry } from '@prisma-next/migration-tools/refs';\nimport {\n  deleteRef,\n  readRef,\n  readRefs,\n  validateRefName,\n  validateRefValue,\n  writeRef,\n} from '@prisma-next/migration-tools/refs';\nimport { notOk, ok, type Result } from '@prisma-next/utils/result';\nimport { Command } from 'commander';\nimport { loadConfig } from '../config-loader';\nimport {\n  CliStructuredError,\n  errorRuntime,\n  errorUnexpected,\n  mapMigrationToolsError,\n} from '../utils/cli-errors';\nimport {\n  addGlobalOptions,\n  resolveMigrationPaths,\n  setCommandDescriptions,\n} from '../utils/command-helpers';\nimport { formatCommandHelp } from '../utils/formatters/help';\nimport { parseGlobalFlags } from '../utils/global-flags';\nimport { handleResult } from '../utils/result-handler';\nimport { TerminalUI } from '../utils/terminal-ui';\n\ninterface RefSetResult {\n  readonly ok: true;\n  readonly ref: string;\n  readonly hash: string;\n  readonly invariants: readonly string[];\n}\n\ninterface RefGetResult {\n  readonly ok: true;\n  readonly ref: string;\n  readonly hash: string;\n  readonly invariants: readonly string[];\n}\n\ninterface RefDeleteResult {\n  readonly ok: true;\n  readonly ref: string;\n  readonly deleted: true;\n}\n\ninterface RefListResult {\n  readonly ok: true;\n  readonly refs: Record<string, RefEntry>;\n}\n\nfunction mapError(error: unknown): CliStructuredError {\n  if (MigrationToolsError.is(error)) {\n    return mapMigrationToolsError(error);\n  }\n  return errorUnexpected(error instanceof Error ? error.message : String(error));\n}\n\nfunction cliErrorInvalidRefName(name: string): CliStructuredError {\n  return errorRuntime(`Invalid ref name \"${name}\"`, {\n    why: `Ref name \"${name}\" does not match the required format`,\n    fix: 'Ref names must be lowercase alphanumeric with hyphens or forward slashes, no `.` or `..` segments',\n  });\n}\n\nfunction cliErrorInvalidRefValue(hash: string): CliStructuredError {\n  return errorRuntime(`Invalid contract hash \"${hash}\"`, {\n    why: `\"${hash}\" is not a valid contract hash`,\n    fix: 'Contract hashes must match the format \"sha256:<64 hex chars>\". Copy the hash from `prisma-next contract emit` or `migration status --json`.',\n  });\n}\n\nasync function executeRefSetCommand(\n  name: string,\n  hash: string,\n  options: { config?: string },\n): Promise<Result<RefSetResult, CliStructuredError>> {\n  if (!validateRefName(name)) {\n    return notOk(cliErrorInvalidRefName(name));\n  }\n  if (!validateRefValue(hash)) {\n    return notOk(cliErrorInvalidRefValue(hash));\n  }\n\n  try {\n    const config = await loadConfig(options.config);\n    const { refsDir } = resolveMigrationPaths(options.config, config);\n    const entry: RefEntry = { hash, invariants: [] };\n    await writeRef(refsDir, name, entry);\n    return ok({ ok: true as const, ref: name, hash, invariants: [] });\n  } catch (error) {\n    if (error instanceof CliStructuredError) return notOk(error);\n    return notOk(mapError(error));\n  }\n}\n\nasync function executeRefGetCommand(\n  name: string,\n  options: { config?: string },\n): Promise<Result<RefGetResult, CliStructuredError>> {\n  try {\n    const config = await loadConfig(options.config);\n    const { refsDir } = resolveMigrationPaths(options.config, config);\n    const entry = await readRef(refsDir, name);\n    return ok({ ok: true as const, ref: name, hash: entry.hash, invariants: entry.invariants });\n  } catch (error) {\n    if (error instanceof CliStructuredError) return notOk(error);\n    return notOk(mapError(error));\n  }\n}\n\nasync function executeRefDeleteCommand(\n  name: string,\n  options: { config?: string },\n): Promise<Result<RefDeleteResult, CliStructuredError>> {\n  try {\n    const config = await loadConfig(options.config);\n    const { refsDir } = resolveMigrationPaths(options.config, config);\n    await deleteRef(refsDir, name);\n    return ok({ ok: true as const, ref: name, deleted: true as const });\n  } catch (error) {\n    if (error instanceof CliStructuredError) return notOk(error);\n    return notOk(mapError(error));\n  }\n}\n\nasync function executeRefListCommand(options: {\n  config?: string;\n}): Promise<Result<RefListResult, CliStructuredError>> {\n  try {\n    const config = await loadConfig(options.config);\n    const { refsDir } = resolveMigrationPaths(options.config, config);\n    const refs = await readRefs(refsDir);\n    return ok({ ok: true as const, refs });\n  } catch (error) {\n    if (error instanceof CliStructuredError) return notOk(error);\n    return notOk(mapError(error));\n  }\n}\n\nfunction createRefSetCommand(): Command {\n  const command = new Command('set');\n  setCommandDescriptions(\n    command,\n    'Set a ref to a contract hash',\n    'Sets a named ref to point to a contract hash in migrations/refs/.',\n  );\n  addGlobalOptions(command)\n    .argument('<name>', 'Ref name (e.g., staging, production)')\n    .argument('<hash>', 'Contract hash to point to')\n    .option('--config <path>', 'Path to prisma-next.config.ts')\n    .action(\n      async (\n        name: string,\n        hash: string,\n        options: { config?: string; json?: string | boolean; quiet?: boolean },\n      ) => {\n        const flags = parseGlobalFlags(options);\n        const ui = new TerminalUI({ color: flags.color, interactive: flags.interactive });\n        const result = await executeRefSetCommand(name, hash, options);\n        const exitCode = handleResult(result, flags, ui, (value) => {\n          if (flags.json) {\n            ui.output(JSON.stringify(value));\n          } else if (!flags.quiet) {\n            ui.output(`Set ref \"${value.ref}\" → ${value.hash}`);\n          }\n        });\n        process.exit(exitCode);\n      },\n    );\n  return command;\n}\n\nfunction createRefGetCommand(): Command {\n  const command = new Command('get');\n  setCommandDescriptions(\n    command,\n    'Get the hash for a ref',\n    'Reads a named ref from migrations/refs/ and prints its contract hash.',\n  );\n  addGlobalOptions(command)\n    .argument('<name>', 'Ref name to look up')\n    .option('--config <path>', 'Path to prisma-next.config.ts')\n    .action(\n      async (\n        name: string,\n        options: { config?: string; json?: string | boolean; quiet?: boolean },\n      ) => {\n        const flags = parseGlobalFlags(options);\n        const ui = new TerminalUI({ color: flags.color, interactive: flags.interactive });\n        const result = await executeRefGetCommand(name, options);\n        const exitCode = handleResult(result, flags, ui, (value) => {\n          if (flags.json) {\n            ui.output(JSON.stringify(value));\n          } else {\n            ui.output(value.hash);\n          }\n        });\n        process.exit(exitCode);\n      },\n    );\n  return command;\n}\n\nfunction createRefDeleteCommand(): Command {\n  const command = new Command('delete');\n  setCommandDescriptions(command, 'Delete a ref', 'Removes a named ref from migrations/refs/.');\n  addGlobalOptions(command)\n    .argument('<name>', 'Ref name to delete')\n    .option('--config <path>', 'Path to prisma-next.config.ts')\n    .action(\n      async (\n        name: string,\n        options: { config?: string; json?: string | boolean; quiet?: boolean },\n      ) => {\n        const flags = parseGlobalFlags(options);\n        const ui = new TerminalUI({ color: flags.color, interactive: flags.interactive });\n        const result = await executeRefDeleteCommand(name, options);\n        const exitCode = handleResult(result, flags, ui, (value) => {\n          if (flags.json) {\n            ui.output(JSON.stringify(value));\n          } else if (!flags.quiet) {\n            ui.output(`Deleted ref \"${value.ref}\"`);\n          }\n        });\n        process.exit(exitCode);\n      },\n    );\n  return command;\n}\n\nfunction createRefListCommand(): Command {\n  const command = new Command('list');\n  setCommandDescriptions(command, 'List all refs', 'Lists all named refs from migrations/refs/.');\n  addGlobalOptions(command)\n    .option('--config <path>', 'Path to prisma-next.config.ts')\n    .action(async (options: { config?: string; json?: string | boolean; quiet?: boolean }) => {\n      const flags = parseGlobalFlags(options);\n      const ui = new TerminalUI({ color: flags.color, interactive: flags.interactive });\n      const result = await executeRefListCommand(options);\n      const exitCode = handleResult(result, flags, ui, (value) => {\n        if (flags.json) {\n          ui.output(JSON.stringify(value));\n        } else if (!flags.quiet) {\n          const entries = Object.entries(value.refs);\n          if (entries.length === 0) {\n            ui.output('No refs defined');\n          } else {\n            for (const [refName, entry] of entries) {\n              const invariantsSuffix =\n                entry.invariants.length > 0 ? ` [invariants: ${entry.invariants.join(', ')}]` : '';\n              ui.output(`${refName} → ${entry.hash}${invariantsSuffix}`);\n            }\n          }\n        }\n      });\n      process.exit(exitCode);\n    });\n  return command;\n}\n\nexport {\n  executeRefSetCommand,\n  executeRefGetCommand,\n  executeRefDeleteCommand,\n  executeRefListCommand,\n  cliErrorInvalidRefName,\n  cliErrorInvalidRefValue,\n};\n\nexport function createMigrationRefCommand(): Command {\n  const command = new Command('ref');\n  setCommandDescriptions(\n    command,\n    'Manage migration refs',\n    'Manage named refs in migrations/refs/. Refs map logical environment\\n' +\n      'names (e.g., staging, production) to contract hashes.',\n  );\n  addGlobalOptions(command).configureHelp({\n    formatHelp: (cmd) => formatCommandHelp({ command: cmd, flags: parseGlobalFlags({}) }),\n    subcommandDescription: () => '',\n  });\n  command.addCommand(createRefSetCommand());\n  command.addCommand(createRefGetCommand());\n  command.addCommand(createRefDeleteCommand());\n  command.addCommand(createRefListCommand());\n  return command;\n}\n"],"mappings":";;;;;;;;;;AAsDA,SAAS,SAAS,OAAoC;CACpD,IAAI,oBAAoB,GAAG,MAAM,EAC/B,OAAO,uBAAuB,MAAM;CAEtC,OAAO,gBAAgB,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,CAAC;;AAGhF,SAAS,uBAAuB,MAAkC;CAChE,OAAO,aAAa,qBAAqB,KAAK,IAAI;EAChD,KAAK,aAAa,KAAK;EACvB,KAAK;EACN,CAAC;;AAGJ,SAAS,wBAAwB,MAAkC;CACjE,OAAO,aAAa,0BAA0B,KAAK,IAAI;EACrD,KAAK,IAAI,KAAK;EACd,KAAK;EACN,CAAC;;AAGJ,eAAe,qBACb,MACA,MACA,SACmD;CACnD,IAAI,CAAC,gBAAgB,KAAK,EACxB,OAAO,MAAM,uBAAuB,KAAK,CAAC;CAE5C,IAAI,CAAC,iBAAiB,KAAK,EACzB,OAAO,MAAM,wBAAwB,KAAK,CAAC;CAG7C,IAAI;EACF,MAAM,SAAS,MAAM,WAAW,QAAQ,OAAO;EAC/C,MAAM,EAAE,YAAY,sBAAsB,QAAQ,QAAQ,OAAO;EAEjE,MAAM,SAAS,SAAS,MAAM;GADJ;GAAM,YAAY,EAAE;GACX,CAAC;EACpC,OAAO,GAAG;GAAE,IAAI;GAAe,KAAK;GAAM;GAAM,YAAY,EAAE;GAAE,CAAC;UAC1D,OAAO;EACd,IAAI,iBAAiB,oBAAoB,OAAO,MAAM,MAAM;EAC5D,OAAO,MAAM,SAAS,MAAM,CAAC;;;AAIjC,eAAe,qBACb,MACA,SACmD;CACnD,IAAI;EACF,MAAM,SAAS,MAAM,WAAW,QAAQ,OAAO;EAC/C,MAAM,EAAE,YAAY,sBAAsB,QAAQ,QAAQ,OAAO;EACjE,MAAM,QAAQ,MAAM,QAAQ,SAAS,KAAK;EAC1C,OAAO,GAAG;GAAE,IAAI;GAAe,KAAK;GAAM,MAAM,MAAM;GAAM,YAAY,MAAM;GAAY,CAAC;UACpF,OAAO;EACd,IAAI,iBAAiB,oBAAoB,OAAO,MAAM,MAAM;EAC5D,OAAO,MAAM,SAAS,MAAM,CAAC;;;AAIjC,eAAe,wBACb,MACA,SACsD;CACtD,IAAI;EACF,MAAM,SAAS,MAAM,WAAW,QAAQ,OAAO;EAC/C,MAAM,EAAE,YAAY,sBAAsB,QAAQ,QAAQ,OAAO;EACjE,MAAM,UAAU,SAAS,KAAK;EAC9B,OAAO,GAAG;GAAE,IAAI;GAAe,KAAK;GAAM,SAAS;GAAe,CAAC;UAC5D,OAAO;EACd,IAAI,iBAAiB,oBAAoB,OAAO,MAAM,MAAM;EAC5D,OAAO,MAAM,SAAS,MAAM,CAAC;;;AAIjC,eAAe,sBAAsB,SAEkB;CACrD,IAAI;EACF,MAAM,SAAS,MAAM,WAAW,QAAQ,OAAO;EAC/C,MAAM,EAAE,YAAY,sBAAsB,QAAQ,QAAQ,OAAO;EAEjE,OAAO,GAAG;GAAE,IAAI;GAAe,MAAA,MADZ,SAAS,QAAQ;GACC,CAAC;UAC/B,OAAO;EACd,IAAI,iBAAiB,oBAAoB,OAAO,MAAM,MAAM;EAC5D,OAAO,MAAM,SAAS,MAAM,CAAC;;;AAIjC,SAAS,sBAA+B;CACtC,MAAM,UAAU,IAAI,QAAQ,MAAM;CAClC,uBACE,SACA,gCACA,oEACD;CACD,iBAAiB,QAAQ,CACtB,SAAS,UAAU,uCAAuC,CAC1D,SAAS,UAAU,4BAA4B,CAC/C,OAAO,mBAAmB,gCAAgC,CAC1D,OACC,OACE,MACA,MACA,YACG;EACH,MAAM,QAAQ,iBAAiB,QAAQ;EACvC,MAAM,KAAK,IAAI,WAAW;GAAE,OAAO,MAAM;GAAO,aAAa,MAAM;GAAa,CAAC;EAEjF,MAAM,WAAW,aAAa,MADT,qBAAqB,MAAM,MAAM,QAAQ,EACxB,OAAO,KAAK,UAAU;GAC1D,IAAI,MAAM,MACR,GAAG,OAAO,KAAK,UAAU,MAAM,CAAC;QAC3B,IAAI,CAAC,MAAM,OAChB,GAAG,OAAO,YAAY,MAAM,IAAI,MAAM,MAAM,OAAO;IAErD;EACF,QAAQ,KAAK,SAAS;GAEzB;CACH,OAAO;;AAGT,SAAS,sBAA+B;CACtC,MAAM,UAAU,IAAI,QAAQ,MAAM;CAClC,uBACE,SACA,0BACA,wEACD;CACD,iBAAiB,QAAQ,CACtB,SAAS,UAAU,sBAAsB,CACzC,OAAO,mBAAmB,gCAAgC,CAC1D,OACC,OACE,MACA,YACG;EACH,MAAM,QAAQ,iBAAiB,QAAQ;EACvC,MAAM,KAAK,IAAI,WAAW;GAAE,OAAO,MAAM;GAAO,aAAa,MAAM;GAAa,CAAC;EAEjF,MAAM,WAAW,aAAa,MADT,qBAAqB,MAAM,QAAQ,EAClB,OAAO,KAAK,UAAU;GAC1D,IAAI,MAAM,MACR,GAAG,OAAO,KAAK,UAAU,MAAM,CAAC;QAEhC,GAAG,OAAO,MAAM,KAAK;IAEvB;EACF,QAAQ,KAAK,SAAS;GAEzB;CACH,OAAO;;AAGT,SAAS,yBAAkC;CACzC,MAAM,UAAU,IAAI,QAAQ,SAAS;CACrC,uBAAuB,SAAS,gBAAgB,6CAA6C;CAC7F,iBAAiB,QAAQ,CACtB,SAAS,UAAU,qBAAqB,CACxC,OAAO,mBAAmB,gCAAgC,CAC1D,OACC,OACE,MACA,YACG;EACH,MAAM,QAAQ,iBAAiB,QAAQ;EACvC,MAAM,KAAK,IAAI,WAAW;GAAE,OAAO,MAAM;GAAO,aAAa,MAAM;GAAa,CAAC;EAEjF,MAAM,WAAW,aAAa,MADT,wBAAwB,MAAM,QAAQ,EACrB,OAAO,KAAK,UAAU;GAC1D,IAAI,MAAM,MACR,GAAG,OAAO,KAAK,UAAU,MAAM,CAAC;QAC3B,IAAI,CAAC,MAAM,OAChB,GAAG,OAAO,gBAAgB,MAAM,IAAI,GAAG;IAEzC;EACF,QAAQ,KAAK,SAAS;GAEzB;CACH,OAAO;;AAGT,SAAS,uBAAgC;CACvC,MAAM,UAAU,IAAI,QAAQ,OAAO;CACnC,uBAAuB,SAAS,iBAAiB,8CAA8C;CAC/F,iBAAiB,QAAQ,CACtB,OAAO,mBAAmB,gCAAgC,CAC1D,OAAO,OAAO,YAA2E;EACxF,MAAM,QAAQ,iBAAiB,QAAQ;EACvC,MAAM,KAAK,IAAI,WAAW;GAAE,OAAO,MAAM;GAAO,aAAa,MAAM;GAAa,CAAC;EAEjF,MAAM,WAAW,aAAa,MADT,sBAAsB,QAAQ,EACb,OAAO,KAAK,UAAU;GAC1D,IAAI,MAAM,MACR,GAAG,OAAO,KAAK,UAAU,MAAM,CAAC;QAC3B,IAAI,CAAC,MAAM,OAAO;IACvB,MAAM,UAAU,OAAO,QAAQ,MAAM,KAAK;IAC1C,IAAI,QAAQ,WAAW,GACrB,GAAG,OAAO,kBAAkB;SAE5B,KAAK,MAAM,CAAC,SAAS,UAAU,SAAS;KACtC,MAAM,mBACJ,MAAM,WAAW,SAAS,IAAI,iBAAiB,MAAM,WAAW,KAAK,KAAK,CAAC,KAAK;KAClF,GAAG,OAAO,GAAG,QAAQ,KAAK,MAAM,OAAO,mBAAmB;;;IAIhE;EACF,QAAQ,KAAK,SAAS;GACtB;CACJ,OAAO;;AAYT,SAAgB,4BAAqC;CACnD,MAAM,UAAU,IAAI,QAAQ,MAAM;CAClC,uBACE,SACA,yBACA,6HAED;CACD,iBAAiB,QAAQ,CAAC,cAAc;EACtC,aAAa,QAAQ,kBAAkB;GAAE,SAAS;GAAK,OAAO,iBAAiB,EAAE,CAAC;GAAE,CAAC;EACrF,6BAA6B;EAC9B,CAAC;CACF,QAAQ,WAAW,qBAAqB,CAAC;CACzC,QAAQ,WAAW,qBAAqB,CAAC;CACzC,QAAQ,WAAW,wBAAwB,CAAC;CAC5C,QAAQ,WAAW,sBAAsB,CAAC;CAC1C,OAAO"}

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

@@ -1,27 +1,33 @@
-import { t as CliStructuredError } from "../cli-errors-BFYgBH3L.mjs";
+import { t as CliStructuredError } from "../cli-errors-B9OBbled.mjs";
 import { Command } from "commander";
 import { Result } from "@prisma-next/utils/result";
-import { MigrationBundle } from "@prisma-next/migration-tools/types";
+import { OperationPreview } from "@prisma-next/framework-components/control";
+import { OnDiskMigrationPackage } from "@prisma-next/migration-tools/package";
 
 //#region src/commands/migration-show.d.ts
 interface MigrationShowResult {
   readonly ok: true;
   readonly dirName: string;
   readonly dirPath: string;
-  readonly from: string;
+  readonly from: string | null;
   readonly to: string;
-  readonly migrationId: string;
-  readonly kind: string;
+  readonly migrationHash: string;
   readonly createdAt: string;
   readonly operations: readonly {
     readonly id: string;
     readonly label: string;
     readonly operationClass: string;
   }[];
-  readonly sql: readonly string[];
+  /**
+   * Family-agnostic textual preview of the migration's operations. Replaces
+   * the previous string-array DDL field. Always defined; statements is empty
+   * for a no-op migration or a family that does not implement the
+   * `OperationPreviewCapable` capability.
+   */
+  readonly preview: OperationPreview;
   readonly summary: string;
 }
-declare function resolveByHashPrefix(packages: readonly MigrationBundle[], prefix: string): Result<MigrationBundle, CliStructuredError>;
+declare function resolveByHashPrefix(packages: readonly OnDiskMigrationPackage[], prefix: string): Result<OnDiskMigrationPackage, CliStructuredError>;
 declare function createMigrationShowCommand(): Command;
 //#endregion
 export { MigrationShowResult, createMigrationShowCommand, resolveByHashPrefix };

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

@@ -1 +1 @@
-{"version":3,"file":"migration-show.d.mts","names":[],"sources":["../../src/commands/migration-show.ts"],"sourcesContent":[],"mappings":";;;;;;UA2BiB,mBAAA;;EAAA,SAAA,OAAA,EAAA,MAAmB;EAsBpB,SAAA,OAAA,EAAA,MAAmB;EACd,SAAA,IAAA,EAAA,MAAA;EAEX,SAAA,EAAA,EAAA,MAAA;EAAiB,SAAA,WAAA,EAAA,MAAA;EAAxB,SAAA,IAAA,EAAA,MAAA;EAAM,SAAA,SAAA,EAAA,MAAA;EAiJO,SAAA,UAAA,EAAA,SAA0B;;;;;;;;iBApJ1B,mBAAA,oBACK,oCAElB,OAAO,iBAAiB;iBAiJX,0BAAA,CAAA,GAA8B"}
+{"version":3,"file":"migration-show.d.mts","names":[],"sources":["../../src/commands/migration-show.ts"],"mappings":";;;;;;;UAuCiB,mBAAA;EAAA,SACN,EAAA;EAAA,SACA,OAAA;EAAA,SACA,OAAA;EAAA,SACA,IAAA;EAAA,SACA,EAAA;EAAA,SACA,aAAA;EAAA,SACA,SAAA;EAAA,SACA,UAAA;IAAA,SACE,EAAA;IAAA,SACA,KAAA;IAAA,SACA,cAAA;EAAA;EAHF;;;;;;EAAA,SAWA,OAAA,EAAS,gBAAA;EAAA,SACT,OAAA;AAAA;AAAA,iBAOK,mBAAA,CACd,QAAA,WAAmB,sBAAA,IACnB,MAAA,WACC,MAAA,CAAO,sBAAA,EAAwB,kBAAA;AAAA,iBAsJlB,0BAAA,CAAA,GAA8B,OAAA"}