@prisma-next/cli 0.12.0 → 0.13.0-dev.10

package/dist/{command-helpers-Bbw1GbwL.mjs → command-helpers-DGMvGBeX.mjs}

@@ -4,6 +4,7 @@ import { notOk } from "@prisma-next/utils/result";
 import { relative, resolve } from "pathe";
 import { readFile } from "node:fs/promises";
 import { hasMigrations } from "@prisma-next/framework-components/control";
+import { blindCast } from "@prisma-next/utils/casts";
 import { ERROR_CODE_DESTRUCTIVE_CHANGES, errorDestructiveChanges, errorHashMismatch, errorMarkerMissing, errorRunnerFailed, errorRuntime, errorRuntime as errorRuntime$1, errorTargetMismatch } from "@prisma-next/errors/execution";
 import "@prisma-next/errors/migration";
 import { APP_SPACE_ID as APP_SPACE_ID$1, spaceMigrationDirectory } from "@prisma-next/migration-tools/spaces";
@@ -39,6 +40,20 @@ function errorRefSetEmptySentinel(hash) {
 	});
 }
 /**
+* `--legend` was combined with a machine-readable or silent output flag.
+* The legend is human-only decoration on stderr.
+*/
+function errorLegendHumanOnly(conflictingFlag) {
+	return errorRuntime("`--legend` is only available for human-readable output", {
+		why: `\`--legend\` prints a glyph key to stderr and cannot be combined with ${conflictingFlag}.`,
+		fix: `Omit ${conflictingFlag} to print the legend alongside the tree, or omit --legend when using ${conflictingFlag}.`,
+		meta: {
+			code: "MIGRATION.LEGEND_HUMAN_ONLY",
+			conflictingFlag
+		}
+	});
+}
+/**
 * `--space <id>` was given a value that doesn't satisfy the contract-space
 * naming rule (`[a-z][a-z0-9_-]{0,63}` per `isValidSpaceId`). Fires before
 * any fs work — the input is syntactically rejected the same way an on-disk
@@ -189,9 +204,43 @@ function mapMigrationToolsError(error) {
 	});
 }
 /**
+* Shared "needs a live database" precondition for read verbs that consult the
+* marker/ledger (`migration log`, `migration status`). A command needs both a
+* connection string and a control-plane driver; either missing yields the same
+* `PN-CLI-4005` envelope with `meta.missingFlags` (canonical long-form flags
+* per CLI Style Guide §Errors) so callers can react programmatically. Returns
+* `null` when both are present.
+*/
+function requireLiveDatabase(args) {
+	if (args.dbConnection && args.hasDriver) return null;
+	const missingFlags = args.dbConnection ? [] : ["--db"];
+	return errorDatabaseConnectionRequired({
+		why: args.why,
+		missingFlags,
+		...ifDefined("commandName", args.commandName),
+		...ifDefined("retryCommand", args.retryCommand)
+	});
+}
+/**
 * Maps a `RefResolutionError` from the contract/migration reference
 * resolver into a CLI structured error envelope.
 */
+/**
+* A migration ref (dirName or hash-prefix) resolves in more than one contract
+* space. The user must qualify with `--space <id>` to disambiguate.
+*/
+function errorAmbiguousMigrationRef(ref, spaceIds) {
+	const spaceList = spaceIds.join(", ");
+	return errorRuntime(`Ambiguous migration reference: "${ref}" resolves in multiple spaces — qualify with --space <id>`, {
+		why: `"${ref}" matches migrations in spaces: ${spaceList}.`,
+		fix: `Qualify with --space <id> to select one space. Available matching spaces: ${spaceList}.`,
+		meta: {
+			code: "MIGRATION.AMBIGUOUS_MIGRATION_REF",
+			ref,
+			spaceIds: [...spaceIds]
+		}
+	});
+}
 function mapRefResolutionError(error) {
 	switch (error.kind) {
 		case "not-found": return errorRuntime(`Not a known ${error.grammar} reference: "${error.input}"`, {
@@ -450,8 +499,7 @@ function formatReadMoreLine(options) {
 function formatMultilineDescription(options) {
 	const lines = [];
 	const formatGreen = (text) => options.useColor ? green(text) : text;
-	const rightColumnWidth = calculateRightColumnWidth();
-	const wrapWidth = 2 + LEFT_COLUMN_WIDTH + 2 + rightColumnWidth - 2;
+	const wrapWidth = 24 + calculateRightColumnWidth() - 2;
 	for (const descLine of options.descriptionLines) {
 		const wrappedLines = wrapTextAnsi(descLine.replace(/Prisma Next/g, (match) => formatGreen(match)), wrapWidth);
 		for (const wrappedLine of wrappedLines) lines.push(`${options.formatDimText("│")} ${wrappedLine}`);
@@ -670,6 +718,237 @@ function isCI$1() {
 	return isCI;
 }
 //#endregion
+//#region src/utils/formatters/migrations.ts
+/**
+* Render a single statement of an `OperationPreview` for the human-readable
+* preview block. SQL statements get a trailing `;` if missing so the rendered
+* preview is byte-identical to the legacy `string[]`-based renderer for SQL
+* targets. Other languages (`'mongodb-shell'`) render verbatim.
+*/
+function renderPreviewStatement(text, language) {
+	const trimmed = text.trim();
+	if (!trimmed) return void 0;
+	if (language === "sql") return trimmed.endsWith(";") ? trimmed : `${trimmed};`;
+	return trimmed;
+}
+/**
+* Choose the header label for a preview block. SQL-only previews keep the
+* legacy `DDL preview` label so the rendered output is byte-identical to the
+* pre-aggregate SQL CLI; previews from any other family — or a mix that
+* includes any non-SQL language — use the family-agnostic `Operation preview`
+* label.
+*
+* An empty `statements` array deliberately renders as `Operation preview`
+* rather than `DDL preview`: `Array.prototype.every` is vacuously true for
+* empty arrays, but we have no evidence the preview is SQL-only when no
+* statements are present, so the family-agnostic label is the safer default.
+*/
+function previewBlockHeader(preview) {
+	return preview.statements.length > 0 && preview.statements.every((s) => s.language === "sql") ? "DDL preview" : "Operation preview";
+}
+function formatPlannerWarningsBlock(warnings, useColor) {
+	const formatDimText = (text) => formatDim(useColor, text);
+	const lines = ["", "Warnings:"];
+	for (const warning of warnings) lines.push(`  ${formatDimText(`- ${warning.summary}`)}`);
+	return lines;
+}
+/**
+* Render the shared per-space execution block consumed by the `db init`
+* / `db update` / `migrate` summaries. Always shows: space
+* label (`Extension space: <id>` or `App space`) → per-op lines under
+* each space → per-space marker hash (when known).
+*
+* `mode` controls the marker label phrasing — `'apply'` shows
+* `marker → <hash>` (post-apply), `'plan'` omits the marker line
+* entirely (no marker has been written yet).
+*/
+function formatPerSpaceBlock(perSpace, mode, useColor) {
+	const formatYellow = createColorFormatter(useColor, yellow);
+	const formatCyan = createColorFormatter(useColor, cyan);
+	const formatDimText = (text) => formatDim(useColor, text);
+	const lines = [];
+	for (let s = 0; s < perSpace.length; s++) {
+		const space = perSpace[s];
+		if (s > 0) lines.push("");
+		const header = space.kind === "app" ? formatCyan("App space") : formatCyan(`Extension space: ${space.spaceId}`);
+		lines.push(header);
+		if (space.operations.length === 0) lines.push(`  ${formatDimText("(no operations)")}`);
+		else for (let i = 0; i < space.operations.length; i++) {
+			const op = space.operations[i];
+			const treeChar = i === space.operations.length - 1 ? "└" : "├";
+			const destructiveMarker = op.operationClass === "destructive" ? ` ${formatYellow("(destructive)")}` : "";
+			lines.push(`  ${formatDimText(treeChar)}─ ${op.label}${destructiveMarker}`);
+		}
+		if (mode === "apply" && space.marker) lines.push(`  ${formatDimText(`marker: ${space.marker.storageHash}`)}`);
+	}
+	return lines;
+}
+/**
+* Formats human-readable output for migration commands (db init, db update) in plan mode.
+*/
+function formatMigrationPlanOutput(result, flags) {
+	if (flags.quiet) return "";
+	const lines = [];
+	const useColor = flags.color !== false;
+	const formatGreen = createColorFormatter(useColor, green);
+	const formatDimText = (text) => formatDim(useColor, text);
+	const operationCount = result.plan?.operations.length ?? 0;
+	const spaceCount = result.perSpace?.length ?? 0;
+	if (spaceCount > 0) lines.push(`${formatGreen("✔")} Planned ${operationCount} operation(s) across ${spaceCount} contract space${spaceCount === 1 ? "" : "s"}`);
+	else lines.push(`${formatGreen("✔")} Planned ${operationCount} operation(s)`);
+	if (result.warnings && result.warnings.length > 0) lines.push(...formatPlannerWarningsBlock(result.warnings, useColor));
+	const formatYellow = createColorFormatter(useColor, yellow);
+	if (result.perSpace && result.perSpace.length > 0) {
+		lines.push("");
+		lines.push(...formatPerSpaceBlock(result.perSpace, "plan", useColor));
+		if (result.perSpace.some((s) => s.operations.some((op) => op.operationClass === "destructive"))) {
+			lines.push("");
+			lines.push(`${formatYellow("⚠")} This migration contains destructive operations that may cause data loss.`);
+		}
+	} else if (result.plan?.operations && result.plan.operations.length > 0) {
+		lines.push(`${formatDimText("│")}`);
+		for (let i = 0; i < result.plan.operations.length; i++) {
+			const op = result.plan.operations[i];
+			if (!op) continue;
+			const treeChar = i === result.plan.operations.length - 1 ? "└" : "├";
+			const destructiveMarker = op.operationClass === "destructive" ? ` ${formatYellow("(destructive)")}` : "";
+			lines.push(`${formatDimText(treeChar)}─ ${op.label}${destructiveMarker}`);
+		}
+		if (result.plan.operations.some((op) => op.operationClass === "destructive")) {
+			lines.push("");
+			lines.push(`${formatYellow("⚠")} This migration contains destructive operations that may cause data loss.`);
+		}
+	}
+	if (result.plan?.destination) {
+		lines.push("");
+		lines.push(`${formatDimText(`Destination hash: ${result.plan.destination.storageHash}`)}`);
+	}
+	if (result.plannedAdvanceRef) {
+		lines.push("");
+		lines.push(formatDimText(`Would advance ref "${result.plannedAdvanceRef.name}" → ${result.plannedAdvanceRef.hash}`));
+	}
+	const preview = result.plan?.preview;
+	if (preview) {
+		lines.push("");
+		lines.push(`${formatDimText(previewBlockHeader(preview))}`);
+		if (preview.statements.length === 0) lines.push(`${formatDimText("No operations.")}`);
+		else {
+			lines.push("");
+			for (const statement of preview.statements) {
+				const rendered = renderPreviewStatement(statement.text, statement.language);
+				if (rendered) lines.push(rendered);
+			}
+		}
+	}
+	if (isVerbose(flags, 1)) lines.push(`${formatDimText(`Total time: ${result.timings.total}ms`)}`);
+	lines.push("");
+	lines.push(`${formatDimText("This is a dry run. No changes were applied.")}`);
+	lines.push(`${formatDimText("Run without --dry-run to apply changes.")}`);
+	return lines.join("\n");
+}
+function formatMigrationApplyCommandOutput(result, flags) {
+	if (flags.quiet) return "";
+	const lines = [];
+	const useColor = flags.color !== false;
+	const formatGreen = createColorFormatter(useColor, green);
+	const formatDimText = (text) => formatDim(useColor, text);
+	lines.push(`${formatGreen("✔")} ${result.summary}`);
+	if (result.perSpace.length > 0) {
+		lines.push("");
+		for (const line of formatPerSpaceBlock(result.perSpace, "apply", useColor)) lines.push(line);
+	}
+	if (result.advancedRef) {
+		lines.push("");
+		lines.push(formatDimText(`Advanced ref "${result.advancedRef.name}" → ${result.advancedRef.hash}`));
+	}
+	lines.push("");
+	lines.push(formatDimText("Next: prisma-next migration status"));
+	if (isVerbose(flags, 1) && result.timings) {
+		lines.push("");
+		lines.push(formatDimText(`Total time: ${result.timings.total}ms`));
+	}
+	return lines.join("\n");
+}
+function formatSpaceShowBlock(space, useColor) {
+	const formatGreen = createColorFormatter(useColor, green);
+	const formatYellow = createColorFormatter(useColor, yellow);
+	const formatDimText = (text) => formatDim(useColor, text);
+	const lines = [];
+	lines.push(`${formatGreen("✔")} ${space.name}`);
+	lines.push(`${formatDimText(`  from: ${space.fromContract ?? "(baseline)"}`)}`);
+	lines.push(`${formatDimText(`  to:   ${space.toContract}`)}`);
+	lines.push(`${formatDimText(`  hash: ${space.hash}`)}`);
+	lines.push(`${formatDimText(`  created: ${space.createdAt}`)}`);
+	lines.push("");
+	lines.push(`${space.operations.length} operation(s)`);
+	if (space.operations.length > 0) {
+		lines.push(`${formatDimText("│")}`);
+		for (let i = 0; i < space.operations.length; i++) {
+			const op = space.operations[i];
+			const treeChar = i === space.operations.length - 1 ? "└" : "├";
+			const destructiveMarker = op.operationClass === "destructive" ? ` ${formatYellow("(destructive)")}` : "";
+			lines.push(`${formatDimText(treeChar)}─ ${op.label}${destructiveMarker}`);
+		}
+		if (space.operations.some((op) => op.operationClass === "destructive")) {
+			lines.push("");
+			lines.push(`${formatYellow("⚠")} This migration contains destructive operations that may cause data loss.`);
+		}
+	}
+	if (space.preview.statements.length > 0) {
+		lines.push("");
+		lines.push(`${formatDimText(previewBlockHeader(space.preview))}`);
+		lines.push("");
+		for (const statement of space.preview.statements) {
+			const rendered = renderPreviewStatement(statement.text, statement.language);
+			if (rendered) lines.push(rendered);
+		}
+	}
+	return lines;
+}
+function formatMigrationShowOutput(result, flags) {
+	if (flags.quiet) return "";
+	const useColor = flags.color !== false;
+	return formatSpaceShowBlock(result.migration, useColor).join("\n");
+}
+/**
+* Formats human-readable output for migration commands (db init, db update) in apply mode.
+*/
+function formatMigrationApplyOutput(result, flags) {
+	if (flags.quiet) return "";
+	const lines = [];
+	const useColor = flags.color !== false;
+	const formatGreen = createColorFormatter(useColor, green);
+	const formatDimText = (text) => formatDim(useColor, text);
+	if (result.ok) {
+		const executed = result.execution?.operationsExecuted ?? 0;
+		const spaceCount = result.perSpace?.length ?? 0;
+		if (executed === 0) {
+			const acrossClause = spaceCount > 0 ? ` across ${spaceCount} contract space${spaceCount === 1 ? "" : "s"}` : "";
+			lines.push(`${formatGreen("✔")} Database already matches contract${acrossClause}`);
+		} else if (spaceCount > 0) lines.push(`${formatGreen("✔")} Applied ${executed} operation(s) across ${spaceCount} contract space${spaceCount === 1 ? "" : "s"}`);
+		else lines.push(`${formatGreen("✔")} Applied ${executed} operation(s)`);
+		if (result.warnings && result.warnings.length > 0) lines.push(...formatPlannerWarningsBlock(result.warnings, useColor));
+		if (result.perSpace && result.perSpace.length > 0) {
+			lines.push("");
+			lines.push(...formatPerSpaceBlock(result.perSpace, "apply", useColor));
+			lines.push("");
+			lines.push(formatDimText(`Run 'prisma-next migration status' to confirm ${spaceCount === 1 ? "the space is" : "all spaces are"} up to date.`));
+		} else if (result.marker) {
+			lines.push(`${formatDimText(`  App-space marker: ${result.marker.storageHash}`)}`);
+			if (result.marker.profileHash) lines.push(`${formatDimText(`  Profile hash: ${result.marker.profileHash}`)}`);
+		}
+		if (isVerbose(flags, 1)) lines.push(`${formatDimText(`  Total time: ${result.timings.total}ms`)}`);
+		if (result.advancedRef) lines.push(formatDimText(`Advanced ref "${result.advancedRef.name}" → ${result.advancedRef.hash}`));
+	}
+	return lines.join("\n");
+}
+/**
+* Formats JSON output for migration commands (db init, db update).
+*/
+function formatMigrationJson(result) {
+	return JSON.stringify(result, null, 2);
+}
+//#endregion
 //#region src/utils/formatters/errors.ts
 /**
 * Formats error output for human-readable display.
@@ -711,6 +990,11 @@ function formatErrorOutput(error, flags) {
 		}
 	}
 	if (error.docsUrl && isVerbose(flags, 1)) lines.push(formatDimText(error.docsUrl));
+	const plannerWarnings = error.meta?.["plannerWarnings"];
+	if (Array.isArray(plannerWarnings) && plannerWarnings.length > 0) {
+		const typedWarnings = blindCast(plannerWarnings);
+		lines.push(...formatPlannerWarningsBlock(typedWarnings, useColor));
+	}
 	if (isVerbose(flags, 2) && error.meta) lines.push(`${formatDimText(`  Meta: ${JSON.stringify(error.meta, null, 2)}`)}`);
 	return lines.join("\n");
 }
@@ -1163,6 +1447,36 @@ function parseGlobalFlags(options) {
 	if (options.yes || options.y) flags.yes = true;
 	return flags;
 }
+/**
+* Bridges the two TTY checks (stdout via `flags`, stdin via
+* `process.stdin.isTTY`) into the `canPrompt` boolean the interactive
+* `init` flow consumes.
+*
+* Per the [Style Guide § Interactivity](../../../../../../../docs/CLI%20Style%20Guide.md#interactivity):
+*
+* - `flags.interactive` governs *decoration* (TerminalUI, intro/outro,
+*   spinners) and is derived from stdout-TTY by `parseGlobalFlags`,
+*   honouring `--interactive` / `--no-interactive`.
+* - Prompting additionally requires a stdin TTY — closing stdin is a
+*   common signal in CI / agent environments even when stdout stays
+*   attached.
+* - `--interactive` is the explicit override: when the user passes it,
+*   we honour it (e.g. testing flows where stdin is stubbed).
+*
+* Single source of truth for the interactive-prompt decision: both the
+* `init` action handler and the preAction telemetry bridge derive
+* prompt-eligibility from this helper so they cannot drift. Lives in
+* `global-flags` (alongside `parseGlobalFlags`) to keep
+* `utils/telemetry` and `commands/init/index` free of an import cycle.
+*
+* Exported so callers and tests can derive the same value without
+* touching `process` globals.
+*/
+function deriveCanPrompt(opts) {
+	if (opts.optionInteractive === true) return true;
+	if (opts.flagsInteractive === false) return false;
+	return opts.stdinIsTTY;
+}
 //#endregion
 //#region src/utils/command-helpers.ts
 const longDescriptions = /* @__PURE__ */ new WeakMap();
@@ -1269,27 +1583,6 @@ function toStructuralEdge(edge) {
 		invariants: edge.invariants
 	};
 }
-/**
-* Maps a PathDecision to the slim CLI output representation.
-*/
-function toPathDecisionResult(decision) {
-	return {
-		fromHash: decision.fromHash,
-		toHash: decision.toHash,
-		alternativeCount: decision.alternativeCount,
-		tieBreakReasons: decision.tieBreakReasons,
-		requiredInvariants: decision.requiredInvariants ?? [],
-		satisfiedInvariants: decision.satisfiedInvariants ?? [],
-		...ifDefined("refName", decision.refName),
-		selectedPath: decision.selectedPath.map((entry) => ({
-			dirName: entry.dirName,
-			migrationHash: entry.migrationHash,
-			from: entry.from,
-			to: entry.to,
-			invariants: entry.invariants
-		}))
-	};
-}
 function targetSupportsMigrations(target) {
 	return hasMigrations(target);
 }
@@ -1370,6 +1663,6 @@ function addGlobalOptions(command) {
 	} }).option("--format <pretty|json>", "Output format (default: pretty, or json when stdout is not a TTY)").option("--json", "Output as JSON (alias for --format json)").option("-q, --quiet", "Quiet mode: errors only").option("-v, --verbose", "Verbose output: debug info, timings").option("--trace", "Trace output: deep internals, stack traces").option("--color", "Force color output").option("--no-color", "Disable color output").option("--interactive", "Force interactive mode").option("--no-interactive", "Disable interactive prompts").option("-y, --yes", "Auto-accept prompts");
 }
 //#endregion
-export { errorTargetMigrationNotSupported as $, CliStructuredError$1 as A, errorInvalidSpaceId as B, formatCommandHelp as C, createColorFormatter as D, formatSuccessMessage as E, errorDatabaseConnectionRequired as F, errorPlanForgotTheFlag as G, errorMarkerMissing as H, errorDestructiveChanges as I, errorRefSetHashNotInGraph as J, errorRefSetBundleNotFound as K, errorDriverRequired as L, errorConfigValidation$1 as M, errorContractConfigMissing$1 as N, formatDim as O, errorContractValidationFailed as P, errorSpaceNotFound as Q, errorFileNotFound as R, isCI$1 as S, formatStyledHeader as T, errorMigrationPlanningFailed as U, errorMarkerMismatch as V, errorPathUnreachable as W, errorRuntime$1 as X, errorRunnerFailed as Y, errorSnapshotMissing as Z, createTerminalUI as _, readContractEnvelope as a, formatErrorJson as b, sanitizeErrorMessage as c, setCommandSeeAlso as d, errorTargetMismatch as et, targetSupportsMigrations as f, parseGlobalFlagsOrExit as g, parseGlobalFlags as h, maskConnectionUrl as i, ERROR_CODE_DESTRUCTIVE_CHANGES as j, isVerbose as k, setCommandDescriptions as l, toStructuralEdge as m, collectDeclaredInvariants as n, mapMigrationToolsError as nt, resolveContractPath as o, toPathDecisionResult as p, errorRefSetEmptySentinel as q, getTargetMigrations as r, mapRefResolutionError as rt, resolveMigrationPaths as s, addGlobalOptions as t, errorUnexpected$1 as tt, setCommandExamples as u, installShutdownHandlers as v, formatRootHelp as w, formatErrorOutput as x, handleResult as y, errorHashMismatch as z };
+export { errorRefSetBundleNotFound as $, formatStyledHeader as A, errorContractValidationFailed as B, formatMigrationApplyOutput as C, isCI$1 as D, formatMigrationShowOutput as E, CliStructuredError$1 as F, errorHashMismatch as G, errorDestructiveChanges as H, ERROR_CODE_DESTRUCTIVE_CHANGES as I, errorMarkerMismatch as J, errorInvalidSpaceId as K, errorAmbiguousMigrationRef as L, createColorFormatter as M, formatDim as N, formatCommandHelp as O, isVerbose as P, errorPlanForgotTheFlag as Q, errorConfigValidation$1 as R, formatMigrationApplyCommandOutput as S, formatMigrationPlanOutput as T, errorDriverRequired as U, errorDatabaseConnectionRequired as V, errorFileNotFound as W, errorMigrationPlanningFailed as X, errorMarkerMissing as Y, errorPathUnreachable as Z, createTerminalUI as _, readContractEnvelope as a, errorSpaceNotFound as at, formatErrorJson as b, sanitizeErrorMessage as c, errorUnexpected$1 as ct, setCommandSeeAlso as d, requireLiveDatabase as dt, errorRefSetEmptySentinel as et, targetSupportsMigrations as f, parseGlobalFlagsOrExit as g, parseGlobalFlags as h, maskConnectionUrl as i, errorSnapshotMissing as it, formatSuccessMessage as j, formatRootHelp as k, setCommandDescriptions as l, mapMigrationToolsError as lt, deriveCanPrompt as m, collectDeclaredInvariants as n, errorRunnerFailed as nt, resolveContractPath as o, errorTargetMigrationNotSupported as ot, toStructuralEdge as p, errorLegendHumanOnly as q, getTargetMigrations as r, errorRuntime$1 as rt, resolveMigrationPaths as s, errorTargetMismatch as st, addGlobalOptions as t, errorRefSetHashNotInGraph as tt, setCommandExamples as u, mapRefResolutionError as ut, installShutdownHandlers as v, formatMigrationJson as w, formatErrorOutput as x, handleResult as y, errorContractConfigMissing$1 as z };
 
-//# sourceMappingURL=command-helpers-Bbw1GbwL.mjs.map
+//# sourceMappingURL=command-helpers-DGMvGBeX.mjs.map