@prisma-next/cli 0.5.0-dev.4 → 0.5.0-dev.41

package/dist/quick-reference-mongo.md

@@ -4,35 +4,29 @@ Prisma Next lets you query your database in simple, easy-to-read TypeScript. Def
 
 This project is set up for MongoDB. Prisma Next also supports other databases.
 
+{{requirements}}
+
 ## Your data contract
 
 Your data contract is the heart of your application. It lives at [`{{schemaPath}}`]({{schemaPath}}) and describes your models:
 
-```prisma
-model User {
-  id    ObjectId @id @map("_id")
-  email String   @unique
-  name  String?
-  posts Post[]
-  @@map("users")
-}
-```
+{{schemaSample}}
 
 Every model you define in your contract can be queried from your app. Your editor will autocomplete the query methods and show you what type each field is:
 
 ```typescript
 import { db } from '{{dbImportPath}}';
 
-const client = await db.connect(process.env['DATABASE_URL']!, 'mydb');
-
-const user = await client.orm.User
+const user = await db.orm.users
   .where({ email: 'alice@example.com' })
   .first();
 
 // Your editor will show the type of user as
-// { id: ObjectId; email: string; name: string | null; posts: Post[] } | null
+// { _id: ObjectId; email: string; name: string | null; posts: Post[] } | null
 ```
 
+`db` connects to MongoDB lazily on the first query, so there is no manual `connect(...)` step in your application code. Call `await db.close()` if you need to release the underlying connection (typically only in tests or short-lived scripts). After `close()` the client is single-shot — any further query, `connect()`, or `runtime()` call rejects with `"Mongo client is closed"`. Construct a new `mongo({...})` if you need to use it again.
+
 Your contract has two companion files in the same directory:
 
 - **`contract.json`** — this tells your application what models exist, just like `package-lock.json` tells your package manager what dependencies your project has
@@ -91,3 +85,30 @@ You can customize how your environment variables are loaded by changing or remov
 1. Edit [`{{schemaPath}}`]({{schemaPath}}) to add or change models.
 2. Run `{{pkgRun}} contract emit` to regenerate the contract.
 3. Query your models — your IDE will autocomplete everything.
+
+## Transactions and change streams (Mongo)
+
+Multi-document transactions and change streams require MongoDB to run as a **replica set** — even single-node setups for development. A standalone `mongod` will reject `withTransaction()` at runtime. For local development you have a few options:
+
+- **Docker Compose:** start `mongo` with `--replSet rs0` and run `rs.initiate()` once.
+- **`mongodb-memory-server`:** use `MongoMemoryReplSet` instead of `MongoMemoryServer` in tests.
+- **MongoDB Atlas:** every Atlas cluster is already a replica set.
+
+The transaction API (`db.transaction(...)`) is on the roadmap and tracked under [TML-2313](https://linear.app/prisma-company/issue/TML-2313/mongo-dev-replica-set-story-is-missing-transactions-change-streams). Prisma Next's Mongo facade does not expose it yet — until that ticket lands, drive transactions yourself with a raw `MongoClient` using the escape hatch in the next section.
+
+## Escape hatches
+
+The ORM covers the common cases. For the rest, two escape hatches are designed in:
+
+- **Typed raw aggregations — `db.query`.** The facade exposes `db.query`, a typed builder for aggregation pipelines that runs through the same runtime + middleware + codec stack as `db.orm`. Reach for it when the ORM can't express a `$lookup`/`$facet`/`$graphLookup`/window-function pipeline.
+- **Direct `mongodb` driver control — `mongoClient` binding.** Construct your own `MongoClient` and pass it to `mongo({ mongoClient, dbName, contractJson })`. Your code keeps the `MongoClient` reference and uses it directly (transactions, change streams, sessions, anything Prisma Next doesn't surface yet); the same `db` object continues to give you the typed ORM.
+
+`db.runtime()` is **not** the escape hatch — it returns the internal executor (`MongoRuntime`), not a `mongodb` `MongoClient` or `Db`. Use `db.query` for raw aggregations and the `mongoClient` binding for direct driver control.
+
+## Monorepo notes (pnpm workspaces)
+
+If this project lives inside a pnpm workspace, a few things are worth knowing:
+
+- **Catalogs.** When the workspace's `pnpm-workspace.yaml` defines a `catalogs` entry for `prisma-next` or `@prisma-next/mongo`, pnpm uses the catalog version everywhere — `init` does too. If you wanted the published `latest` instead, update or remove the catalog entry, then re-run `pnpm install`.
+- **`pnpm dlx`.** `pnpm dlx prisma-next@latest init …` works in any directory. Inside a workspace, pnpm still resolves dependencies through the workspace's catalog/overrides rather than the registry; expect the installed Prisma Next packages to reflect the workspace's catalog rather than `latest`.
+- **`pnpm` → `npm` fallback.** If `pnpm` ever fails to install Prisma Next with a `workspace:*` or `catalog:` resolution error (a leak in a published artefact), `init` falls back to `npm install` and surfaces a warning. Once the offending package republishes a clean version you can switch back with `pnpm install`.

package/dist/quick-reference-postgres.md

@@ -4,19 +4,13 @@ Prisma Next lets you query your database in simple, easy-to-read TypeScript. Def
 
 This project is set up for PostgreSQL. Prisma Next also supports other databases.
 
+{{requirements}}
+
 ## Your data contract
 
 Your data contract is the heart of your application. It lives at [`{{schemaPath}}`]({{schemaPath}}) and describes your models:
 
-```prisma
-model User {
-  id        Int      @id @default(autoincrement())
-  email     String   @unique
-  name      String?
-  posts     Post[]
-  createdAt DateTime @default(now())
-}
-```
+{{schemaSample}}
 
 Every model you define in your contract can be queried from your app. Your editor will autocomplete the query methods and show you what type each model field is:
 
@@ -89,3 +83,11 @@ You can customize how your environment variables are loaded by changing or remov
 1. Edit [`{{schemaPath}}`]({{schemaPath}}) to add or change models.
 2. Run `{{pkgRun}} contract emit` to regenerate the contract.
 3. Query your models — your IDE will autocomplete everything.
+
+## Monorepo notes (pnpm workspaces)
+
+If this project lives inside a pnpm workspace, a few things are worth knowing:
+
+- **Catalogs.** When the workspace's `pnpm-workspace.yaml` defines a `catalogs` entry for `prisma-next` or `@prisma-next/postgres`, pnpm uses the catalog version everywhere — `init` does too. If you wanted the published `latest` instead, update or remove the catalog entry, then re-run `pnpm install`.
+- **`pnpm dlx`.** `pnpm dlx prisma-next@latest init …` works in any directory. Inside a workspace, pnpm still resolves dependencies through the workspace's catalog/overrides rather than the registry; expect the installed Prisma Next packages to reflect the workspace's catalog rather than `latest`.
+- **`pnpm` → `npm` fallback.** If `pnpm` ever fails to install Prisma Next with a `workspace:*` or `catalog:` resolution error (a leak in a published artefact), `init` falls back to `npm install` and surfaces a warning. Once the offending package republishes a clean version you can switch back with `pnpm install`.

package/dist/{result-handler-BJwA7ufw.mjs → result-handler-Ch6hVnOo.mjs}

@@ -1,36 +1,15 @@
-import { relative, resolve } from "pathe";
+import { a as createColorFormatter, i as formatErrorOutput, o as formatDim, r as formatErrorJson } from "./terminal-ui-u2YgKghu.mjs";
 import { ifDefined } from "@prisma-next/utils/defined";
-import { hasMigrations } from "@prisma-next/framework-components/control";
+import { relative, resolve } from "pathe";
 import { readFile } from "node:fs/promises";
-import { reconstructGraph } from "@prisma-next/migration-tools/dag";
+import { hasMigrations } from "@prisma-next/framework-components/control";
 import { readMigrationsDir } from "@prisma-next/migration-tools/io";
-import { blue, bold, cyan, dim, green, magenta, red } from "colorette";
+import { reconstructGraph } from "@prisma-next/migration-tools/migration-graph";
+import { blue, bold, cyan, dim, green, magenta } from "colorette";
 import wrapAnsi from "wrap-ansi";
 import stringWidth from "string-width";
 import stripAnsi from "strip-ansi";
 
-//#region src/utils/formatters/helpers.ts
-/**
-* Checks if verbose output is enabled at the specified level.
-*/
-function isVerbose(flags, level) {
-	return (flags.verbose ?? 0) >= level;
-}
-/**
-* Creates a color-aware formatter function.
-* Returns a function that applies the color only if colors are enabled.
-*/
-function createColorFormatter(useColor, colorFn) {
-	return useColor ? colorFn : (text) => text;
-}
-/**
-* Formats text with dim styling if colors are enabled.
-*/
-function formatDim(useColor, text) {
-	return useColor ? dim(text) : text;
-}
-
-//#endregion
 //#region src/utils/formatters/styled.ts
 /**
 * Fixed width for left column in help output.
@@ -509,6 +488,26 @@ function resolveMigrationPaths(configOption, config) {
 		refsDir: resolve(migrationsDir, "refs")
 	};
 }
+function collectDeclaredInvariants(graph) {
+	const declared = /* @__PURE__ */ new Set();
+	for (const edges of graph.forwardChain.values()) for (const edge of edges) for (const inv of edge.invariants) declared.add(inv);
+	return declared;
+}
+/**
+* Maps a `MigrationEdge` to the structural-edge shape used in the
+* `MIGRATION.NO_INVARIANT_PATH` error envelope. Shared between
+* `migration apply` and `migration status` so both commands surface
+* the same JSON wire shape when an invariant-aware route is unsatisfiable.
+*/
+function toStructuralEdge(edge) {
+	return {
+		dirName: edge.dirName,
+		migrationHash: edge.migrationHash,
+		from: edge.from,
+		to: edge.to,
+		invariants: edge.invariants
+	};
+}
 /**
 * Maps a PathDecision to the slim CLI output representation.
 */
@@ -518,12 +517,15 @@ function toPathDecisionResult(decision) {
 		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,
-			migrationId: entry.migrationId,
+			migrationHash: entry.migrationHash,
 			from: entry.from,
-			to: entry.to
+			to: entry.to,
+			invariants: entry.invariants
 		}))
 	};
 }
@@ -535,12 +537,12 @@ function getTargetMigrations(target) {
 }
 /**
 * Reads the migrations directory and builds the migration graph from all
-* bundles. Throws on I/O or graph errors — callers handle error mapping.
+* packages. Throws on I/O or graph errors — callers handle error mapping.
 *
-* Every on-disk bundle is content-addressed (`migrationId` is always a
+* Every on-disk package is content-addressed (`migrationHash` is always a
 * string); there is no draft state to filter out.
 */
-async function loadMigrationBundles(migrationsDir) {
+async function loadMigrationPackages(migrationsDir) {
 	const bundles = await readMigrationsDir(migrationsDir);
 	return {
 		bundles,
@@ -548,14 +550,6 @@ async function loadMigrationBundles(migrationsDir) {
 	};
 }
 /**
-* Alias of `loadMigrationBundles` retained for naming-clarity in commands
-* that previously needed both attested and draft splits. With the
-* collapse of the draft state, both helpers do the same thing.
-*/
-async function loadAllBundles(migrationsDir) {
-	return loadMigrationBundles(migrationsDir);
-}
-/**
 * Reads and parses contract.json, validating the framework-level envelope
 * fields (storageHash, schemaVersion, target, targetFamily).
 *
@@ -629,58 +623,6 @@ function addGlobalOptions(command) {
 	} }).option("--json", "Output as 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
-//#region src/utils/formatters/errors.ts
-/**
-* Formats error output for human-readable display.
-*/
-function formatErrorOutput(error, flags) {
-	const lines = [];
-	const useColor = flags.color !== false;
-	const formatRed = createColorFormatter(useColor, red);
-	const formatDimText = (text) => formatDim(useColor, text);
-	lines.push(`${formatRed("✖")} ${error.summary} (${error.code})`);
-	if (error.why) lines.push(`${formatDimText(`  Why: ${error.why}`)}`);
-	if (error.fix) lines.push(`${formatDimText(`  Fix: ${error.fix}`)}`);
-	if (error.where?.path) {
-		const whereLine = error.where.line ? `${error.where.path}:${error.where.line}` : error.where.path;
-		lines.push(`${formatDimText(`  Where: ${whereLine}`)}`);
-	}
-	if (error.meta?.["conflicts"]) {
-		const conflicts = error.meta["conflicts"];
-		if (conflicts.length > 0) {
-			const maxToShow = isVerbose(flags, 1) ? conflicts.length : Math.min(3, conflicts.length);
-			const header = isVerbose(flags, 1) ? "  Conflicts:" : `  Conflicts (showing ${maxToShow} of ${conflicts.length}):`;
-			lines.push(`${formatDimText(header)}`);
-			for (const conflict of conflicts.slice(0, maxToShow)) lines.push(`${formatDimText(`    - [${conflict.kind}] ${conflict.summary}`)}`);
-			if (!isVerbose(flags, 1) && conflicts.length > maxToShow) lines.push(`${formatDimText("  Re-run with -v/--verbose to see all conflicts")}`);
-		}
-	}
-	if (error.meta?.["issues"]) {
-		const issues = error.meta["issues"];
-		if (issues.length > 0) {
-			const maxToShow = isVerbose(flags, 1) ? issues.length : Math.min(3, issues.length);
-			const header = isVerbose(flags, 1) ? "  Issues:" : `  Issues (showing ${maxToShow} of ${issues.length}):`;
-			lines.push(`${formatDimText(header)}`);
-			for (const issue of issues.slice(0, maxToShow)) {
-				const kind = issue.kind ?? "issue";
-				const message = issue.message ?? "";
-				lines.push(`${formatDimText(`    - [${kind}] ${message}`)}`);
-			}
-			if (!isVerbose(flags, 1) && issues.length > maxToShow) lines.push(`${formatDimText("  Re-run with -v/--verbose to see all issues")}`);
-		}
-	}
-	if (error.docsUrl && isVerbose(flags, 1)) lines.push(formatDimText(error.docsUrl));
-	if (isVerbose(flags, 2) && error.meta) lines.push(`${formatDimText(`  Meta: ${JSON.stringify(error.meta, null, 2)}`)}`);
-	return lines.join("\n");
-}
-/**
-* Formats error output as JSON.
-*/
-function formatErrorJson(error) {
-	return JSON.stringify(error, null, 2);
-}
-
 //#endregion
 //#region src/utils/result-handler.ts
 /**
@@ -704,5 +646,5 @@ function handleResult(result, flags, ui, onSuccess) {
 }
 
 //#endregion
-export { formatStyledHeader as _, maskConnectionUrl as a, formatDim as b, resolveMigrationPaths as c, setCommandExamples as d, targetSupportsMigrations as f, formatRootHelp as g, formatCommandHelp as h, loadAllBundles as i, sanitizeErrorMessage as l, parseGlobalFlags as m, addGlobalOptions as n, readContractEnvelope as o, toPathDecisionResult as p, getTargetMigrations as r, resolveContractPath as s, handleResult as t, setCommandDescriptions as u, formatSuccessMessage as v, isVerbose as x, createColorFormatter as y };
-//# sourceMappingURL=result-handler-BJwA7ufw.mjs.map
+export { formatCommandHelp as _, loadMigrationPackages as a, formatSuccessMessage as b, resolveContractPath as c, setCommandDescriptions as d, setCommandExamples as f, parseGlobalFlags as g, toStructuralEdge as h, getTargetMigrations as i, resolveMigrationPaths as l, toPathDecisionResult as m, addGlobalOptions as n, maskConnectionUrl as o, targetSupportsMigrations as p, collectDeclaredInvariants as r, readContractEnvelope as s, handleResult as t, sanitizeErrorMessage as u, formatRootHelp as v, formatStyledHeader as y };
+//# sourceMappingURL=result-handler-Ch6hVnOo.mjs.map

package/dist/result-handler-Ch6hVnOo.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-handler-Ch6hVnOo.mjs","names":["LEFT_COLUMN_WIDTH","createPrismaNextBadge","formatHeaderLine","formatReadMoreLine","lines: string[]","lines: string[]","parts: string[]","current: Command | undefined","flags: {\n    json?: boolean;\n    quiet?: boolean;\n    verbose?: number;\n    color?: boolean;\n    interactive?: boolean;\n    yes?: boolean;\n  }"],"sources":["../src/utils/formatters/styled.ts","../src/utils/formatters/help.ts","../src/utils/global-flags.ts","../src/utils/command-helpers.ts","../src/utils/result-handler.ts"],"sourcesContent":["import { blue, bold, cyan, green } from 'colorette';\nimport type { Command } from 'commander';\nimport stringWidth from 'string-width';\nimport stripAnsi from 'strip-ansi';\n\nimport type { GlobalFlags } from '../global-flags';\nimport { createColorFormatter, formatDim } from './helpers';\n\n// ============================================================================\n// Styled Output Formatters\n// ============================================================================\n\n/**\n * Fixed width for left column in help output.\n */\nconst LEFT_COLUMN_WIDTH = 20;\n\n/**\n * Creates an arrow segment badge with green background and white text.\n * Body: green background with white \"prisma-next\" text\n * Tip: dark grey arrow pointing right (Powerline separator)\n */\nfunction createPrismaNextBadge(useColor: boolean): string {\n  if (!useColor) {\n    return 'prisma-next';\n  }\n  return bold('prisma-next');\n}\n\n/**\n * Creates a padding function.\n */\nfunction createPadFunction(): (s: string, w: number) => string {\n  return (s: string, w: number) => s + ' '.repeat(Math.max(0, w - s.length));\n}\n\n/**\n * Formats a header line: brand + operation + intent\n */\nfunction formatHeaderLine(options: {\n  readonly brand: string;\n  readonly operation: string;\n  readonly intent: string;\n}): string {\n  if (options.operation) {\n    return `${options.brand} ${options.operation} → ${options.intent}`;\n  }\n  return `${options.brand} ${options.intent}`;\n}\n\n/**\n * Formats a \"Read more\" URL line.\n * The \"Read more\" label is in default color (not cyan), and the URL is blue.\n */\nfunction formatReadMoreLine(options: {\n  readonly url: string;\n  readonly maxLabelWidth: number;\n  readonly useColor: boolean;\n  readonly formatDimText: (text: string) => string;\n}): string {\n  const pad = createPadFunction();\n  const labelPadded = pad('Read more', options.maxLabelWidth);\n  // Label is default color (not cyan)\n  const valueColored = options.useColor ? blue(options.url) : options.url;\n  return `${options.formatDimText('│')} ${labelPadded}  ${valueColored}`;\n}\n\n/**\n * Pads text to a fixed width, accounting for ANSI escape codes.\n * Uses string-width to measure the actual display width.\n */\nexport function padToFixedWidth(text: string, width: number): string {\n  const actualWidth = stringWidth(text);\n  const padding = Math.max(0, width - actualWidth);\n  return text + ' '.repeat(padding);\n}\n\n/**\n * Renders a command tree structure.\n * Handles both single-level (subcommands of a command) and multi-level (top-level commands with subcommands) trees.\n */\nexport function renderCommandTree(options: {\n  readonly commands: readonly Command[];\n  readonly useColor: boolean;\n  readonly formatDimText: (text: string) => string;\n  readonly hasItemsAfter: boolean;\n  readonly continuationPrefix?: string;\n}): string[] {\n  const { commands, useColor, formatDimText, hasItemsAfter, continuationPrefix } = options;\n  const lines: string[] = [];\n\n  if (commands.length === 0) {\n    return lines;\n  }\n\n  // Format each command\n  for (let i = 0; i < commands.length; i++) {\n    const cmd = commands[i];\n    if (!cmd) continue;\n\n    const subcommands = cmd.commands.filter((subcmd) => !subcmd.name().startsWith('_'));\n    const isLastCommand = i === commands.length - 1;\n\n    if (subcommands.length > 0) {\n      // Command with subcommands - show command name, then tree-structured subcommands\n      const treeChar = isLastCommand && !hasItemsAfter ? formatDimText('└') : formatDimText('├');\n      // For top-level command, pad name to fixed width (accounting for \"| |-- \" = 5 chars)\n      const treePrefix = `${treeChar}─ `;\n      const treePrefixWidth = stringWidth(stripAnsi(treePrefix));\n      const remainingWidth = LEFT_COLUMN_WIDTH - treePrefixWidth;\n      const commandNamePadded = padToFixedWidth(cmd.name(), remainingWidth);\n      const commandNameColored = useColor ? cyan(commandNamePadded) : commandNamePadded;\n      lines.push(`${formatDimText('│')} ${treePrefix}${commandNameColored}`);\n\n      for (let j = 0; j < subcommands.length; j++) {\n        const subcmd = subcommands[j];\n        if (!subcmd) continue;\n\n        const isLastSubcommand = j === subcommands.length - 1;\n        const shortDescription = subcmd.description() || '';\n\n        // Use tree characters: -- for last subcommand, |-- for others\n        const treeChar = isLastSubcommand ? '└' : '├';\n        const continuation =\n          continuationPrefix ??\n          (isLastCommand && isLastSubcommand && !hasItemsAfter ? ' ' : formatDimText('│'));\n        // For subcommands, account for \"| |  -- \" = 7 chars (or \"|   -- \" = 6 chars if continuation is space)\n        const continuationStr = continuation === ' ' ? ' ' : continuation;\n        const subTreePrefix = `${continuationStr}  ${formatDimText(treeChar)}─ `;\n        const subTreePrefixWidth = stringWidth(stripAnsi(subTreePrefix));\n        const subRemainingWidth = LEFT_COLUMN_WIDTH - subTreePrefixWidth;\n        const subcommandNamePadded = padToFixedWidth(subcmd.name(), subRemainingWidth);\n        const subcommandNameColored = useColor ? cyan(subcommandNamePadded) : subcommandNamePadded;\n        lines.push(\n          `${formatDimText('│')} ${subTreePrefix}${subcommandNameColored}  ${shortDescription}`,\n        );\n      }\n    } else {\n      // Standalone command - show command name and description on same line\n      const treeChar = isLastCommand && !hasItemsAfter ? formatDimText('└') : formatDimText('├');\n      const treePrefix = `${treeChar}─ `;\n      const treePrefixWidth = stringWidth(stripAnsi(treePrefix));\n      const remainingWidth = LEFT_COLUMN_WIDTH - treePrefixWidth;\n      const commandNamePadded = padToFixedWidth(cmd.name(), remainingWidth);\n      const commandNameColored = useColor ? cyan(commandNamePadded) : commandNamePadded;\n      const shortDescription = cmd.description() || '';\n      lines.push(`${formatDimText('│')} ${treePrefix}${commandNameColored}  ${shortDescription}`);\n    }\n  }\n\n  return lines;\n}\n\n/**\n * Formats the header in the new experimental visual style.\n * This header appears at the start of command output, showing the operation,\n * intent, documentation link, and parameters.\n */\nexport function formatStyledHeader(options: {\n  readonly command: string;\n  readonly description: string;\n  readonly url?: string;\n  readonly details: ReadonlyArray<{ readonly label: string; readonly value: string }>;\n  readonly flags: GlobalFlags;\n}): string {\n  const lines: string[] = [];\n  const useColor = options.flags.color !== false;\n  const formatDimText = (text: string) => formatDim(useColor, text);\n\n  // Header: arrow + operation badge + intent\n  const brand = createPrismaNextBadge(useColor);\n  // Use full command path (e.g., \"contract emit\" not just \"emit\")\n  const operation = useColor ? bold(options.command) : options.command;\n  const intent = formatDimText(options.description);\n  lines.push(formatHeaderLine({ brand, operation, intent }));\n  lines.push(formatDimText('│')); // Vertical line separator between command and params\n\n  // Format details using fixed left column width (same style as help text options)\n  for (const detail of options.details) {\n    // Add colon to label, then pad to fixed width using padToFixedWidth for ANSI-aware padding\n    const labelWithColon = `${detail.label}:`;\n    const labelPadded = padToFixedWidth(labelWithColon, LEFT_COLUMN_WIDTH);\n    const labelColored = useColor ? cyan(labelPadded) : labelPadded;\n    lines.push(`${formatDimText('│')} ${labelColored}  ${detail.value}`);\n  }\n\n  // Add \"Read more\" URL if present (same style as help text)\n  if (options.url) {\n    lines.push(formatDimText('│')); // Separator line before \"Read more\"\n    lines.push(\n      formatReadMoreLine({\n        url: options.url,\n        maxLabelWidth: LEFT_COLUMN_WIDTH,\n        useColor,\n        formatDimText,\n      }),\n    );\n  }\n\n  lines.push(formatDimText('└'));\n\n  return `${lines.join('\\n')}\\n`;\n}\n\n/**\n * Formats a success message in the styled output format.\n */\nexport function formatSuccessMessage(flags: GlobalFlags): string {\n  const useColor = flags.color !== false;\n  const formatGreen = createColorFormatter(useColor, green);\n  return `${formatGreen('✔')} Success`;\n}\n","import { blue, bold, cyan, dim, green, magenta } from 'colorette';\nimport type { Command } from 'commander';\nimport wrapAnsi from 'wrap-ansi';\n\nimport { getCommandExamples, getLongDescription } from '../command-helpers';\nimport type { GlobalFlags } from '../global-flags';\nimport { formatDim } from './helpers';\nimport { padToFixedWidth, renderCommandTree } from './styled';\n\n// ============================================================================\n// Help Output Formatters\n// ============================================================================\n\n/**\n * Fixed width for left column in help output.\n * Must match the value in styled.ts.\n */\nconst LEFT_COLUMN_WIDTH = 20;\n\n/**\n * Minimum width for right column wrapping in help output.\n */\nconst RIGHT_COLUMN_MIN_WIDTH = 40;\n\n/**\n * Maximum width for right column wrapping in help output (when terminal is wide enough).\n */\nconst RIGHT_COLUMN_MAX_WIDTH = 90;\n\n/**\n * Gets the terminal width, or returns a default if not available.\n */\nfunction getTerminalWidth(): number {\n  // Help text goes to stderr, so prefer stderr columns. Fall back to stdout, then CLI_WIDTH env.\n  const terminalWidth = process.stderr.columns || process.stdout.columns;\n  const envWidth = Number.parseInt(process.env['CLI_WIDTH'] || '', 10);\n  return terminalWidth || (Number.isFinite(envWidth) ? envWidth : 80);\n}\n\n/**\n * Calculates the available width for the right column based on terminal width.\n */\nfunction calculateRightColumnWidth(): number {\n  const terminalWidth = getTerminalWidth();\n  const availableWidth = terminalWidth - 2 - LEFT_COLUMN_WIDTH - 2;\n  return Math.max(RIGHT_COLUMN_MIN_WIDTH, Math.min(availableWidth, RIGHT_COLUMN_MAX_WIDTH));\n}\n\n/**\n * Creates the CLI brand badge.\n */\nfunction createPrismaNextBadge(useColor: boolean): string {\n  return useColor ? bold('prisma-next') : 'prisma-next';\n}\n\n/**\n * Formats a header line: brand + operation + intent\n */\nfunction formatHeaderLine(options: {\n  readonly brand: string;\n  readonly operation: string;\n  readonly intent: string;\n}): string {\n  if (options.operation) {\n    return `${options.brand} ${options.operation} → ${options.intent}`;\n  }\n  return `${options.brand} ${options.intent}`;\n}\n\n/**\n * Wraps text to fit within a specified width using wrap-ansi.\n */\nfunction wrapTextAnsi(text: string, width: number): string[] {\n  const wrapped = wrapAnsi(text, width, { hard: false, trim: true });\n  return wrapped.split('\\n');\n}\n\n/**\n * Formats a default value as \"default: <value>\" with dimming.\n */\nfunction formatDefaultValue(value: unknown, useColor: boolean): string {\n  const valueStr = String(value);\n  const defaultText = `default: ${valueStr}`;\n  return useColor ? dim(defaultText) : defaultText;\n}\n\n/**\n * Formats a \"Read more\" URL line.\n */\nfunction formatReadMoreLine(options: {\n  readonly url: string;\n  readonly maxLabelWidth: number;\n  readonly useColor: boolean;\n  readonly formatDimText: (text: string) => string;\n}): string {\n  const labelPadded = `Read more${' '.repeat(Math.max(0, options.maxLabelWidth - 'Read more'.length))}`;\n  const valueColored = options.useColor ? blue(options.url) : options.url;\n  return `${options.formatDimText('│')} ${labelPadded}  ${valueColored}`;\n}\n\n/**\n * Formats multiline description with \"Prisma Next\" in green.\n */\nfunction formatMultilineDescription(options: {\n  readonly descriptionLines: readonly string[];\n  readonly useColor: boolean;\n  readonly formatDimText: (text: string) => string;\n}): string[] {\n  const lines: string[] = [];\n  const formatGreen = (text: string) => (options.useColor ? green(text) : text);\n\n  const rightColumnWidth = calculateRightColumnWidth();\n  const totalWidth = 2 + LEFT_COLUMN_WIDTH + 2 + rightColumnWidth;\n  const wrapWidth = totalWidth - 2;\n\n  for (const descLine of options.descriptionLines) {\n    const formattedLine = descLine.replace(/Prisma Next/g, (match) => formatGreen(match));\n    const wrappedLines = wrapTextAnsi(formattedLine, wrapWidth);\n    for (const wrappedLine of wrappedLines) {\n      lines.push(`${options.formatDimText('│')} ${wrappedLine}`);\n    }\n  }\n  return lines;\n}\n\n/**\n * Maps command paths to their documentation URLs.\n */\nfunction getCommandDocsUrl(commandPath: string): string | undefined {\n  const docsMap: Record<string, string> = {\n    'contract emit': 'https://pris.ly/contract-emit',\n    'contract infer': 'https://pris.ly/contract-infer',\n    'db schema': 'https://pris.ly/db-schema',\n    'db verify': 'https://pris.ly/db-verify',\n    'db update': 'https://pris.ly/db-update',\n    'migration plan': 'https://pris.ly/migration-plan',\n    'migration apply': 'https://pris.ly/migration-apply',\n    'migration show': 'https://pris.ly/migration-show',\n    'migration status': 'https://pris.ly/migration-status',\n  };\n  return docsMap[commandPath];\n}\n\n/**\n * Builds the full command path from a command and its parents.\n */\nfunction buildCommandPath(command: Command): string {\n  const parts: string[] = [];\n  let current: Command | undefined = command;\n  while (current && current.name() !== 'prisma-next') {\n    parts.unshift(current.name());\n    current = current.parent ?? undefined;\n  }\n  return parts.join(' ');\n}\n\n/**\n * Formats help output for a command using the styled format.\n */\nexport function formatCommandHelp(options: {\n  readonly command: Command;\n  readonly flags: GlobalFlags;\n}): string {\n  const { command, flags } = options;\n  const lines: string[] = [];\n  const useColor = flags.color !== false;\n  const formatDimText = (text: string) => formatDim(useColor, text);\n\n  // Build full command path (e.g., \"db verify\")\n  const commandPath = buildCommandPath(command);\n  const shortDescription = command.description() || '';\n  const longDescription = getLongDescription(command);\n\n  // Include positional arguments in the header line\n  const argsSuffix = command.registeredArguments\n    .map((arg) => (arg.required ? `<${arg.name()}>` : `[${arg.name()}]`))\n    .join(' ');\n  const brand = createPrismaNextBadge(useColor);\n  const commandWithArgs = argsSuffix ? `${commandPath} ${argsSuffix}` : commandPath;\n  const operation = useColor ? bold(commandWithArgs) : commandWithArgs;\n  const intent = formatDimText(shortDescription);\n  lines.push(formatHeaderLine({ brand, operation, intent }));\n  lines.push(formatDimText('│'));\n\n  // Extract options and format them\n  const optionsList = command.options.map((opt) => {\n    const description = opt.description || '';\n    // Commander.js stores default value in defaultValue property\n    const defaultValue = (opt as { defaultValue?: unknown }).defaultValue;\n    return { flags: opt.flags, description, defaultValue };\n  });\n\n  // Extract subcommands if any\n  const subcommands = command.commands.filter((cmd) => !cmd.name().startsWith('_'));\n\n  // Format subcommands as a tree if present\n  if (subcommands.length > 0) {\n    const hasItemsAfter = optionsList.length > 0;\n    const treeLines = renderCommandTree({\n      commands: subcommands,\n      useColor,\n      formatDimText,\n      hasItemsAfter,\n    });\n    lines.push(...treeLines);\n  }\n\n  // Add separator between subcommands and options if both exist\n  if (subcommands.length > 0 && optionsList.length > 0) {\n    lines.push(formatDimText('│'));\n  }\n\n  // Format options with fixed width, wrapping, and default values\n  if (optionsList.length > 0) {\n    for (const opt of optionsList) {\n      // Format flag with fixed 30-char width\n      const flagsPadded = padToFixedWidth(opt.flags, LEFT_COLUMN_WIDTH);\n      let flagsColored = flagsPadded;\n      if (useColor) {\n        // Color placeholders in magenta, then wrap in cyan\n        flagsColored = flagsPadded.replace(/(<[^>]+>)/g, (match: string) => magenta(match));\n        flagsColored = cyan(flagsColored);\n      }\n\n      // Wrap description based on terminal width\n      const rightColumnWidth = calculateRightColumnWidth();\n      const wrappedDescription = wrapTextAnsi(opt.description, rightColumnWidth);\n\n      // First line: flag + first line of description\n      lines.push(`${formatDimText('│')} ${flagsColored}  ${wrappedDescription[0] || ''}`);\n\n      // Continuation lines: empty label (30 spaces) + wrapped lines\n      for (let i = 1; i < wrappedDescription.length; i++) {\n        const emptyLabel = ' '.repeat(LEFT_COLUMN_WIDTH);\n        lines.push(`${formatDimText('│')} ${emptyLabel}  ${wrappedDescription[i] || ''}`);\n      }\n\n      // Default value line (if present)\n      if (opt.defaultValue !== undefined) {\n        const emptyLabel = ' '.repeat(LEFT_COLUMN_WIDTH);\n        const defaultText = formatDefaultValue(opt.defaultValue, useColor);\n        lines.push(`${formatDimText('│')} ${emptyLabel}  ${defaultText}`);\n      }\n    }\n  }\n\n  // Add docs URL if available (with separator line before it)\n  const docsUrl = getCommandDocsUrl(commandPath);\n  if (docsUrl) {\n    lines.push(formatDimText('│')); // Separator line between params and docs\n    lines.push(\n      formatReadMoreLine({\n        url: docsUrl,\n        maxLabelWidth: LEFT_COLUMN_WIDTH,\n        useColor,\n        formatDimText,\n      }),\n    );\n  }\n\n  // Examples (copy-pastable)\n  const examples = getCommandExamples(command);\n  if (examples && examples.length > 0) {\n    lines.push(formatDimText('│'));\n    lines.push(`${formatDimText('│')} ${formatDimText('Examples:')}`);\n    for (const example of examples) {\n      lines.push(`${formatDimText('│')}   ${useColor ? dim('$') : '$'} ${example}`);\n    }\n  }\n\n  // Multi-line description (if present) - shown after all other content\n  if (longDescription) {\n    lines.push(formatDimText('│'));\n    const descriptionLines = longDescription.split('\\n').filter((line) => line.trim().length > 0);\n    lines.push(...formatMultilineDescription({ descriptionLines, useColor, formatDimText }));\n  }\n\n  lines.push(formatDimText('└'));\n\n  return `${lines.join('\\n')}\\n`;\n}\n\n/**\n * Formats help output for the root program using the styled format.\n */\nexport function formatRootHelp(options: {\n  readonly program: Command;\n  readonly flags: GlobalFlags;\n}): string {\n  const { program, flags } = options;\n  const lines: string[] = [];\n  const useColor = flags.color !== false;\n  const formatDimText = (text: string) => formatDim(useColor, text);\n\n  // Header: \"prisma-next -> Manage your data layer\"\n  const brand = createPrismaNextBadge(useColor);\n  const shortDescription = 'Manage your data layer';\n  const intent = formatDimText(shortDescription);\n  lines.push(formatHeaderLine({ brand, operation: '', intent }));\n  lines.push(formatDimText('│')); // Vertical line separator after header\n\n  // Extract top-level commands (exclude hidden commands starting with '_' and the 'help' command)\n  const topLevelCommands = program.commands.filter(\n    (cmd) => !cmd.name().startsWith('_') && cmd.name() !== 'help',\n  );\n\n  // Extract global options (needed to determine if last command)\n  const globalOptions = program.options.map((opt) => {\n    const description = opt.description || '';\n    // Commander.js stores default value in defaultValue property\n    const defaultValue = (opt as { defaultValue?: unknown }).defaultValue;\n    return { flags: opt.flags, description, defaultValue };\n  });\n\n  // Build command tree\n  if (topLevelCommands.length > 0) {\n    const hasItemsAfter = globalOptions.length > 0;\n    const treeLines = renderCommandTree({\n      commands: topLevelCommands,\n      useColor,\n      formatDimText,\n      hasItemsAfter,\n    });\n    lines.push(...treeLines);\n  }\n\n  // Add separator between commands and options if both exist\n  if (topLevelCommands.length > 0 && globalOptions.length > 0) {\n    lines.push(formatDimText('│'));\n  }\n\n  // Format global options with fixed width, wrapping, and default values\n  if (globalOptions.length > 0) {\n    for (const opt of globalOptions) {\n      // Format flag with fixed 30-char width\n      const flagsPadded = padToFixedWidth(opt.flags, LEFT_COLUMN_WIDTH);\n      let flagsColored = flagsPadded;\n      if (useColor) {\n        // Color placeholders in magenta, then wrap in cyan\n        flagsColored = flagsPadded.replace(/(<[^>]+>)/g, (match: string) => magenta(match));\n        flagsColored = cyan(flagsColored);\n      }\n\n      // Wrap description based on terminal width\n      const rightColumnWidth = calculateRightColumnWidth();\n      const wrappedDescription = wrapTextAnsi(opt.description, rightColumnWidth);\n\n      // First line: flag + first line of description\n      lines.push(`${formatDimText('│')} ${flagsColored}  ${wrappedDescription[0] || ''}`);\n\n      // Continuation lines: empty label (30 spaces) + wrapped lines\n      for (let i = 1; i < wrappedDescription.length; i++) {\n        const emptyLabel = ' '.repeat(LEFT_COLUMN_WIDTH);\n        lines.push(`${formatDimText('│')} ${emptyLabel}  ${wrappedDescription[i] || ''}`);\n      }\n\n      // Default value line (if present)\n      if (opt.defaultValue !== undefined) {\n        const emptyLabel = ' '.repeat(LEFT_COLUMN_WIDTH);\n        const defaultText = formatDefaultValue(opt.defaultValue, useColor);\n        lines.push(`${formatDimText('│')} ${emptyLabel}  ${defaultText}`);\n      }\n    }\n  }\n\n  // Multi-line description (white, not dimmed, with \"Prisma Next\" in green) - shown at bottom\n  const formatGreen = (text: string) => (useColor ? green(text) : text);\n  const descriptionLines = [\n    `Use ${formatGreen('Prisma Next')} to define your data layer as a contract. Sign your database and application with the same contract to guarantee compatibility. Plan and apply migrations to safely evolve your schema.`,\n  ];\n  if (descriptionLines.length > 0) {\n    lines.push(formatDimText('│')); // Separator line before description\n    lines.push(...formatMultilineDescription({ descriptionLines, useColor, formatDimText }));\n  }\n\n  lines.push(formatDimText('└'));\n\n  return `${lines.join('\\n')}\\n`;\n}\n","export interface GlobalFlags {\n  readonly json?: boolean;\n  readonly quiet?: boolean;\n  readonly verbose?: number; // 0, 1, or 2\n  readonly color?: boolean;\n  readonly interactive?: boolean;\n  readonly yes?: boolean;\n}\n\n/**\n * Common options parsed by Commander.js for every command.\n * Extend this for command-specific options instead of duplicating these fields.\n */\nexport interface CommonCommandOptions {\n  readonly json?: string | boolean;\n  readonly quiet?: boolean;\n  readonly q?: boolean;\n  readonly verbose?: boolean;\n  readonly v?: boolean;\n  readonly trace?: boolean;\n  readonly color?: boolean;\n  readonly 'no-color'?: boolean;\n  readonly interactive?: boolean;\n  readonly 'no-interactive'?: boolean;\n  readonly yes?: boolean;\n  readonly y?: boolean;\n}\n\n/**\n * Parses global flags from CLI options.\n * Handles verbosity flags (-v, --trace), JSON output, quiet mode, color,\n * interactivity (--interactive/--no-interactive), and auto-accept (-y/--yes).\n */\nexport function parseGlobalFlags(options: CommonCommandOptions): GlobalFlags {\n  const flags: {\n    json?: boolean;\n    quiet?: boolean;\n    verbose?: number;\n    color?: boolean;\n    interactive?: boolean;\n    yes?: boolean;\n  } = {};\n\n  // JSON output: explicit --json flag or auto-detect piped stdout (Unix convention)\n  if (options.json || !process.stdout.isTTY) {\n    flags.json = true;\n  }\n\n  // Quiet mode\n  if (options.quiet || options.q) {\n    flags.quiet = true;\n  }\n\n  // Verbosity: -v = 1, --trace = 2\n  // Env toggles: PRISMA_NEXT_TRACE=1 ≅ --trace, PRISMA_NEXT_DEBUG=1 ≅ -v\n  if (options.trace || process.env['PRISMA_NEXT_TRACE'] === '1') {\n    flags.verbose = 2;\n  } else if (options.verbose || options.v || process.env['PRISMA_NEXT_DEBUG'] === '1') {\n    flags.verbose = 1;\n  } else {\n    flags.verbose = 0;\n  }\n\n  // Color: respect NO_COLOR env var, --color/--no-color flags\n  // When JSON output is enabled, disable color to ensure clean JSON output\n  if (process.env['NO_COLOR'] || flags.json) {\n    flags.color = false;\n  } else if (options['no-color']) {\n    flags.color = false;\n  } else if (options.color !== undefined) {\n    flags.color = options.color;\n  } else {\n    // Default: enable color if TTY\n    flags.color = process.stdout.isTTY && !process.env['CI'];\n  }\n\n  // Interactivity: --interactive/--no-interactive\n  // Default: interactive when stdout is a TTY\n  if (options['no-interactive']) {\n    flags.interactive = false;\n  } else if (options.interactive !== undefined) {\n    flags.interactive = options.interactive;\n  } else {\n    flags.interactive = !!process.stdout.isTTY;\n  }\n\n  // Auto-accept prompts: -y/--yes\n  if (options.yes || options.y) {\n    flags.yes = true;\n  }\n\n  return flags as GlobalFlags;\n}\n","import { readFile } from 'node:fs/promises';\nimport type { ControlTargetDescriptor } from '@prisma-next/framework-components/control';\nimport { hasMigrations } from '@prisma-next/framework-components/control';\nimport type { NoInvariantPathStructuralEdge } from '@prisma-next/migration-tools/errors';\nimport type { MigrationEdge, MigrationGraph } from '@prisma-next/migration-tools/graph';\nimport { readMigrationsDir } from '@prisma-next/migration-tools/io';\nimport type { PathDecision } from '@prisma-next/migration-tools/migration-graph';\nimport { reconstructGraph } from '@prisma-next/migration-tools/migration-graph';\nimport type { MigrationPackage } from '@prisma-next/migration-tools/package';\nimport { ifDefined } from '@prisma-next/utils/defined';\nimport type { Command } from 'commander';\nimport { relative, resolve } from 'pathe';\nimport { formatCommandHelp } from './formatters/help';\nimport type { CommonCommandOptions } from './global-flags';\nimport { parseGlobalFlags } from './global-flags';\n\nconst longDescriptions = new WeakMap<Command, string>();\nconst commandExamples = new WeakMap<Command, readonly string[]>();\n\n/**\n * Sets both short and long descriptions for a command.\n * The short description is used in command trees and headers.\n * The long description is shown at the bottom of help output.\n */\nexport function setCommandDescriptions(\n  command: Command,\n  shortDescription: string,\n  longDescription?: string,\n): Command {\n  command.description(shortDescription);\n  if (longDescription) {\n    longDescriptions.set(command, longDescription);\n  }\n  return command;\n}\n\n/**\n * Sets copy-pastable examples for a command, shown in help text.\n */\nexport function setCommandExamples(command: Command, examples: readonly string[]): Command {\n  commandExamples.set(command, examples);\n  return command;\n}\n\n/**\n * Gets the long description from a command if it was set via setCommandDescriptions.\n */\nexport function getLongDescription(command: Command): string | undefined {\n  return longDescriptions.get(command);\n}\n\n/**\n * Gets examples from a command if set via setCommandExamples.\n */\nexport function getCommandExamples(command: Command): readonly string[] | undefined {\n  return commandExamples.get(command);\n}\n\n/**\n * Shared CLI options interface for migration commands (db init, db update).\n * These are the Commander.js parsed options common to both commands.\n */\nexport interface MigrationCommandOptions extends CommonCommandOptions {\n  readonly db?: string;\n  readonly config?: string;\n  readonly dryRun?: boolean;\n}\n\n/**\n * Resolves the absolute path to contract.json from the config.\n * Centralises the fallback logic shared by every command that reads the contract.\n */\nexport function resolveContractPath(config: { contract?: { output?: string } }): string {\n  return config.contract?.output\n    ? resolve(config.contract.output)\n    : resolve('src/prisma/contract.json');\n}\n\n/**\n * Resolves the migrations directory and config path from CLI options.\n * Shared by migration-apply, migration-plan, and migration-status.\n */\nexport function resolveMigrationPaths(\n  configOption: string | undefined,\n  config: { migrations?: { dir?: string } },\n): {\n  configPath: string;\n  migrationsDir: string;\n  migrationsRelative: string;\n  refsDir: string;\n} {\n  const configPath = configOption\n    ? relative(process.cwd(), resolve(configOption))\n    : 'prisma-next.config.ts';\n  const migrationsDir = resolve(\n    configOption ? resolve(configOption, '..') : process.cwd(),\n    config.migrations?.dir ?? 'migrations',\n  );\n  const migrationsRelative = relative(process.cwd(), migrationsDir);\n  const refsDir = resolve(migrationsDir, 'refs');\n  return { configPath, migrationsDir, migrationsRelative, refsDir };\n}\n\n/**\n * Slim representation of a PathDecision for CLI JSON output.\n * Strips internal fields (createdAt, labels) from path entries.\n */\nexport interface PathDecisionResult {\n  readonly fromHash: string;\n  readonly toHash: string;\n  readonly alternativeCount: number;\n  readonly tieBreakReasons: readonly string[];\n  readonly refName?: string;\n  readonly requiredInvariants: readonly string[];\n  readonly satisfiedInvariants: readonly string[];\n  readonly selectedPath: readonly {\n    readonly dirName: string;\n    readonly migrationHash: string;\n    readonly from: string;\n    readonly to: string;\n    readonly invariants: readonly string[];\n  }[];\n}\n\nexport function collectDeclaredInvariants(graph: MigrationGraph): ReadonlySet<string> {\n  const declared = new Set<string>();\n  for (const edges of graph.forwardChain.values()) {\n    for (const edge of edges) {\n      for (const inv of edge.invariants) {\n        declared.add(inv);\n      }\n    }\n  }\n  return declared;\n}\n\n/**\n * Maps a `MigrationEdge` to the structural-edge shape used in the\n * `MIGRATION.NO_INVARIANT_PATH` error envelope. Shared between\n * `migration apply` and `migration status` so both commands surface\n * the same JSON wire shape when an invariant-aware route is unsatisfiable.\n */\nexport function toStructuralEdge(edge: MigrationEdge): NoInvariantPathStructuralEdge {\n  return {\n    dirName: edge.dirName,\n    migrationHash: edge.migrationHash,\n    from: edge.from,\n    to: edge.to,\n    invariants: edge.invariants,\n  };\n}\n\n/**\n * Maps a PathDecision to the slim CLI output representation.\n */\nexport function toPathDecisionResult(decision: PathDecision): PathDecisionResult {\n  return {\n    fromHash: decision.fromHash,\n    toHash: decision.toHash,\n    alternativeCount: decision.alternativeCount,\n    tieBreakReasons: decision.tieBreakReasons,\n    requiredInvariants: decision.requiredInvariants ?? [],\n    satisfiedInvariants: decision.satisfiedInvariants ?? [],\n    ...ifDefined('refName', decision.refName),\n    selectedPath: decision.selectedPath.map((entry) => ({\n      dirName: entry.dirName,\n      migrationHash: entry.migrationHash,\n      from: entry.from,\n      to: entry.to,\n      invariants: entry.invariants,\n    })),\n  };\n}\n\nexport function targetSupportsMigrations(target: ControlTargetDescriptor<string, string>): boolean {\n  return hasMigrations(target);\n}\n\nexport function getTargetMigrations(target: ControlTargetDescriptor<string, string>) {\n  return hasMigrations(target) ? target.migrations : undefined;\n}\n\n/**\n * Reads the migrations directory and builds the migration graph from all\n * packages. Throws on I/O or graph errors — callers handle error mapping.\n *\n * Every on-disk package is content-addressed (`migrationHash` is always a\n * string); there is no draft state to filter out.\n */\nexport async function loadMigrationPackages(migrationsDir: string): Promise<{\n  bundles: readonly MigrationPackage[];\n  graph: MigrationGraph;\n}> {\n  const bundles = await readMigrationsDir(migrationsDir);\n  const graph = reconstructGraph(bundles);\n  return { bundles, graph };\n}\n\n/**\n * The subset of the emitted contract.json that the framework layer can\n * safely type. The emitter adds these fields on top of the family-specific\n * storage/models/relations. Other fields exist in the JSON but are opaque\n * at this layer — the index signature preserves them for downstream\n * consumers that operate at the family level (e.g., the control client).\n */\nexport interface ContractEnvelope {\n  readonly storageHash: string;\n  readonly schemaVersion: string;\n  readonly target: string;\n  readonly targetFamily: string;\n  readonly profileHash?: string;\n  readonly [key: string]: unknown;\n}\n\n/**\n * Reads and parses contract.json, validating the framework-level envelope\n * fields (storageHash, schemaVersion, target, targetFamily).\n *\n * Family-specific validation (storage structure, codec mappings, etc.)\n * happens downstream in the control client via the family instance.\n */\nexport async function readContractEnvelope(config: {\n  contract?: { output?: string };\n}): Promise<ContractEnvelope> {\n  const contractPath = resolveContractPath(config);\n  const content = await readFile(contractPath, 'utf-8');\n  const json = JSON.parse(content) as Record<string, unknown>;\n\n  const { schemaVersion, target, targetFamily, profileHash } = json;\n  const storage = json['storage'] as Record<string, unknown> | undefined;\n  const storageHash = storage?.['storageHash'];\n\n  if (typeof storageHash !== 'string') {\n    throw new Error(\n      `Contract at ${relative(process.cwd(), contractPath)} is missing a valid storage.storageHash. Run \\`prisma-next contract emit\\` to regenerate.`,\n    );\n  }\n  if (typeof schemaVersion !== 'string') {\n    throw new Error(\n      `Contract at ${relative(process.cwd(), contractPath)} is missing schemaVersion.`,\n    );\n  }\n  if (typeof target !== 'string') {\n    throw new Error(`Contract at ${relative(process.cwd(), contractPath)} is missing target.`);\n  }\n  if (typeof targetFamily !== 'string') {\n    throw new Error(\n      `Contract at ${relative(process.cwd(), contractPath)} is missing targetFamily.`,\n    );\n  }\n\n  return {\n    ...json,\n    storageHash,\n    schemaVersion,\n    target,\n    targetFamily,\n    ...(typeof profileHash === 'string' ? { profileHash } : {}),\n  };\n}\n\n/**\n * Masks credentials in a database connection URL.\n * Handles standard URLs (username + password + query params) and libpq-style key=value strings.\n */\nexport function maskConnectionUrl(url: string): string {\n  try {\n    const parsed = new URL(url);\n    if (parsed.username) {\n      parsed.username = '****';\n    }\n    if (parsed.password) {\n      parsed.password = '****';\n    }\n    // Also mask password in query parameters (e.g., ?password=secret, ?sslpassword=secret)\n    for (const key of [...parsed.searchParams.keys()]) {\n      if (/password/i.test(key)) {\n        parsed.searchParams.set(key, '****');\n      }\n    }\n    return parsed.toString();\n  } catch {\n    // Fallback for libpq-style key=value connection strings (e.g., \"host=localhost password=secret user=admin\")\n    return url\n      .replace(/password\\s*=\\s*\\S+/gi, 'password=****')\n      .replace(/user\\s*=\\s*\\S+/gi, 'user=****');\n  }\n}\n\n/**\n * Strips raw connection URL fragments from an error message to prevent credential leakage.\n * Call this before surfacing driver errors to the user.\n */\nexport function sanitizeErrorMessage(message: string, connectionUrl?: string): string {\n  if (!connectionUrl) {\n    return message;\n  }\n  try {\n    const parsed = new URL(connectionUrl);\n    // Replace the full URL (with and without trailing slash)\n    let sanitized = message;\n    sanitized = sanitized.replaceAll(connectionUrl, maskConnectionUrl(connectionUrl));\n    // Also replace the password and username individually if they appear\n    if (parsed.password) {\n      sanitized = sanitized.replaceAll(parsed.password, '****');\n    }\n    if (parsed.username) {\n      sanitized = sanitized.replaceAll(parsed.username, '****');\n    }\n    return sanitized;\n  } catch {\n    // For libpq-style strings, mask password and user values in the message\n    return message\n      .replace(/password\\s*=\\s*\\S+/gi, 'password=****')\n      .replace(/user\\s*=\\s*\\S+/gi, 'user=****');\n  }\n}\n\n/**\n * Registers the global CLI options shared by every command:\n * --json, -q/--quiet, -v/--verbose, --trace, --color, --no-color,\n * --interactive, --no-interactive, -y/--yes.\n *\n * Also sets up the styled help formatter.\n */\nexport function addGlobalOptions(command: Command): Command {\n  return command\n    .configureHelp({\n      formatHelp: (cmd) => {\n        const flags = parseGlobalFlags({});\n        return formatCommandHelp({ command: cmd, flags });\n      },\n    })\n    .option('--json', 'Output as JSON')\n    .option('-q, --quiet', 'Quiet mode: errors only')\n    .option('-v, --verbose', 'Verbose output: debug info, timings')\n    .option('--trace', 'Trace output: deep internals, stack traces')\n    .option('--color', 'Force color output')\n    .option('--no-color', 'Disable color output')\n    .option('--interactive', 'Force interactive mode')\n    .option('--no-interactive', 'Disable interactive prompts')\n    .option('-y, --yes', 'Auto-accept prompts');\n}\n","import type { Result } from '@prisma-next/utils/result';\nimport type { CliStructuredError } from './cli-errors';\nimport { formatErrorJson, formatErrorOutput } from './formatters/errors';\nimport type { GlobalFlags } from './global-flags';\nimport type { TerminalUI } from './terminal-ui';\n\n/**\n * Processes a CLI command result, handling both success and error cases.\n * Formats output appropriately and returns the exit code.\n * Never throws - returns exit code for commands to use with process.exit().\n *\n * Error output:\n * - JSON mode: JSON error to stdout (piped) via ui.output(), human sees nothing on stderr.\n * - Interactive: human-readable error to stderr.\n */\nexport function handleResult<T>(\n  result: Result<T, CliStructuredError>,\n  flags: GlobalFlags,\n  ui: TerminalUI,\n  onSuccess?: (value: T) => void,\n): number {\n  if (result.ok) {\n    if (onSuccess) {\n      onSuccess(result.value);\n    }\n    return 0;\n  }\n\n  // Convert to CLI envelope\n  const envelope = result.failure.toEnvelope();\n\n  if (flags.json) {\n    // JSON error → stdout only\n    ui.output(formatErrorJson(envelope));\n  } else {\n    // Human-readable error → stderr\n    ui.error(formatErrorOutput(envelope, flags));\n  }\n\n  // Infer exit code from error domain: CLI errors = 2, RUN errors = 1\n  const exitCode = result.failure.domain === 'CLI' ? 2 : 1;\n  return exitCode;\n}\n"],"mappings":"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"}

package/dist/{terminal-ui-C5k88MmW.mjs → terminal-ui-u2YgKghu.mjs}

@@ -1,6 +1,80 @@
 import { bold, cyan, dim, green, red, yellow } from "colorette";
 import * as clack from "@clack/prompts";
 
+//#region src/utils/formatters/helpers.ts
+/**
+* Checks if verbose output is enabled at the specified level.
+*/
+function isVerbose(flags, level) {
+	return (flags.verbose ?? 0) >= level;
+}
+/**
+* Creates a color-aware formatter function.
+* Returns a function that applies the color only if colors are enabled.
+*/
+function createColorFormatter(useColor, colorFn) {
+	return useColor ? colorFn : (text) => text;
+}
+/**
+* Formats text with dim styling if colors are enabled.
+*/
+function formatDim(useColor, text) {
+	return useColor ? dim(text) : text;
+}
+
+//#endregion
+//#region src/utils/formatters/errors.ts
+/**
+* Formats error output for human-readable display.
+*/
+function formatErrorOutput(error, flags) {
+	const lines = [];
+	const useColor = flags.color !== false;
+	const formatRed = createColorFormatter(useColor, red);
+	const formatDimText = (text) => formatDim(useColor, text);
+	lines.push(`${formatRed("✖")} ${error.summary} (${error.code})`);
+	if (error.why) lines.push(`${formatDimText(`  Why: ${error.why}`)}`);
+	if (error.fix) lines.push(`${formatDimText(`  Fix: ${error.fix}`)}`);
+	if (error.where?.path) {
+		const whereLine = error.where.line ? `${error.where.path}:${error.where.line}` : error.where.path;
+		lines.push(`${formatDimText(`  Where: ${whereLine}`)}`);
+	}
+	if (error.meta?.["conflicts"]) {
+		const conflicts = error.meta["conflicts"];
+		if (conflicts.length > 0) {
+			const maxToShow = isVerbose(flags, 1) ? conflicts.length : Math.min(3, conflicts.length);
+			const header = isVerbose(flags, 1) ? "  Conflicts:" : `  Conflicts (showing ${maxToShow} of ${conflicts.length}):`;
+			lines.push(`${formatDimText(header)}`);
+			for (const conflict of conflicts.slice(0, maxToShow)) lines.push(`${formatDimText(`    - [${conflict.kind}] ${conflict.summary}`)}`);
+			if (!isVerbose(flags, 1) && conflicts.length > maxToShow) lines.push(`${formatDimText("  Re-run with -v/--verbose to see all conflicts")}`);
+		}
+	}
+	if (error.meta?.["issues"]) {
+		const issues = error.meta["issues"];
+		if (issues.length > 0) {
+			const maxToShow = isVerbose(flags, 1) ? issues.length : Math.min(3, issues.length);
+			const header = isVerbose(flags, 1) ? "  Issues:" : `  Issues (showing ${maxToShow} of ${issues.length}):`;
+			lines.push(`${formatDimText(header)}`);
+			for (const issue of issues.slice(0, maxToShow)) {
+				const kind = issue.kind ?? "issue";
+				const message = issue.message ?? "";
+				lines.push(`${formatDimText(`    - [${kind}] ${message}`)}`);
+			}
+			if (!isVerbose(flags, 1) && issues.length > maxToShow) lines.push(`${formatDimText("  Re-run with -v/--verbose to see all issues")}`);
+		}
+	}
+	if (error.docsUrl && isVerbose(flags, 1)) lines.push(formatDimText(error.docsUrl));
+	if (isVerbose(flags, 2) && error.meta) lines.push(`${formatDimText(`  Meta: ${JSON.stringify(error.meta, null, 2)}`)}`);
+	return lines.join("\n");
+}
+/**
+* Formats error output as JSON.
+*/
+function formatErrorJson(error) {
+	return JSON.stringify(error, null, 2);
+}
+
+//#endregion
 //#region src/utils/shutdown.ts
 function createShutdownHandler(options) {
 	const exit = options?.exit ?? ((code) => process.exit(code));
@@ -270,5 +344,5 @@ var TerminalUI = class TerminalUI {
 };
 
 //#endregion
-export { installShutdownHandlers as n, TerminalUI as t };
-//# sourceMappingURL=terminal-ui-C5k88MmW.mjs.map
+export { createColorFormatter as a, formatErrorOutput as i, installShutdownHandlers as n, formatDim as o, formatErrorJson as r, isVerbose as s, TerminalUI as t };
+//# sourceMappingURL=terminal-ui-u2YgKghu.mjs.map

package/dist/terminal-ui-u2YgKghu.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-ui-u2YgKghu.mjs","names":["lines: string[]","graceTimer: ReturnType<typeof setTimeout> | undefined","shutdownSignal: AbortSignal","noop: clack.SpinnerResult","inner: clack.SpinnerResult | undefined","timer: ReturnType<typeof setTimeout> | undefined","pendingMsg: string | undefined"],"sources":["../src/utils/formatters/helpers.ts","../src/utils/formatters/errors.ts","../src/utils/shutdown.ts","../src/utils/terminal-ui.ts"],"sourcesContent":["import { dim } from 'colorette';\n\nimport type { GlobalFlags } from '../global-flags';\n\n/**\n * Checks if verbose output is enabled at the specified level.\n */\nexport function isVerbose(flags: GlobalFlags, level: 1 | 2): boolean {\n  return (flags.verbose ?? 0) >= level;\n}\n\n/**\n * Creates a color-aware formatter function.\n * Returns a function that applies the color only if colors are enabled.\n */\nexport function createColorFormatter<T extends (text: string) => string>(\n  useColor: boolean,\n  colorFn: T,\n): (text: string) => string {\n  return useColor ? colorFn : (text: string) => text;\n}\n\n/**\n * Formats text with dim styling if colors are enabled.\n */\nexport function formatDim(useColor: boolean, text: string): string {\n  return useColor ? dim(text) : text;\n}\n","import { red } from 'colorette';\n\nimport type { CliErrorConflict, CliErrorEnvelope } from '../cli-errors';\nimport type { GlobalFlags } from '../global-flags';\nimport { createColorFormatter, formatDim, isVerbose } from './helpers';\n\n/**\n * Formats error output for human-readable display.\n */\nexport function formatErrorOutput(error: CliErrorEnvelope, flags: GlobalFlags): string {\n  const lines: string[] = [];\n\n  const useColor = flags.color !== false;\n  const formatRed = createColorFormatter(useColor, red);\n  const formatDimText = (text: string) => formatDim(useColor, text);\n\n  lines.push(`${formatRed('✖')} ${error.summary} (${error.code})`);\n\n  if (error.why) {\n    lines.push(`${formatDimText(`  Why: ${error.why}`)}`);\n  }\n  if (error.fix) {\n    lines.push(`${formatDimText(`  Fix: ${error.fix}`)}`);\n  }\n  if (error.where?.path) {\n    const whereLine = error.where.line\n      ? `${error.where.path}:${error.where.line}`\n      : error.where.path;\n    lines.push(`${formatDimText(`  Where: ${whereLine}`)}`);\n  }\n  // Show conflicts list if present (always show a short list; show full list when verbose)\n  if (error.meta?.['conflicts']) {\n    const conflicts = error.meta['conflicts'] as readonly CliErrorConflict[];\n    if (conflicts.length > 0) {\n      const maxToShow = isVerbose(flags, 1) ? conflicts.length : Math.min(3, conflicts.length);\n      const header = isVerbose(flags, 1)\n        ? '  Conflicts:'\n        : `  Conflicts (showing ${maxToShow} of ${conflicts.length}):`;\n      lines.push(`${formatDimText(header)}`);\n      for (const conflict of conflicts.slice(0, maxToShow)) {\n        lines.push(`${formatDimText(`    - [${conflict.kind}] ${conflict.summary}`)}`);\n      }\n      if (!isVerbose(flags, 1) && conflicts.length > maxToShow) {\n        lines.push(`${formatDimText('  Re-run with -v/--verbose to see all conflicts')}`);\n      }\n    }\n  }\n  // Show issues list if present (always show a short list; show full list when verbose)\n  if (error.meta?.['issues']) {\n    const issues = error.meta['issues'] as readonly { kind?: string; message?: string }[];\n    if (issues.length > 0) {\n      const maxToShow = isVerbose(flags, 1) ? issues.length : Math.min(3, issues.length);\n      const header = isVerbose(flags, 1)\n        ? '  Issues:'\n        : `  Issues (showing ${maxToShow} of ${issues.length}):`;\n      lines.push(`${formatDimText(header)}`);\n      for (const issue of issues.slice(0, maxToShow)) {\n        const kind = issue.kind ?? 'issue';\n        const message = issue.message ?? '';\n        lines.push(`${formatDimText(`    - [${kind}] ${message}`)}`);\n      }\n      if (!isVerbose(flags, 1) && issues.length > maxToShow) {\n        lines.push(`${formatDimText('  Re-run with -v/--verbose to see all issues')}`);\n      }\n    }\n  }\n  if (error.docsUrl && isVerbose(flags, 1)) {\n    lines.push(formatDimText(error.docsUrl));\n  }\n  if (isVerbose(flags, 2) && error.meta) {\n    lines.push(`${formatDimText(`  Meta: ${JSON.stringify(error.meta, null, 2)}`)}`);\n  }\n\n  return lines.join('\\n');\n}\n\n/**\n * Formats error output as JSON.\n */\nexport function formatErrorJson(error: CliErrorEnvelope): string {\n  return JSON.stringify(error, null, 2);\n}\n","/**\n * Global shutdown controller for graceful SIGINT/SIGTERM handling.\n *\n * The CLI installs signal handlers once at startup. When a signal fires:\n * 1. The AbortController is aborted — in-flight async work (DB queries, emit) can check `signal.aborted`.\n * 2. A 3-second grace timer starts — gives `finally` blocks time to close connections.\n * 3. If the process hasn't exited by then, force-exit with code 130 (128 + SIGINT).\n * 4. A second signal during the grace period force-exits immediately.\n */\n\n/**\n * Creates a shutdown handler with its own AbortController.\n * Exposed for testing — production code uses the singleton below.\n */\nexport interface ShutdownHandler {\n  readonly signal: AbortSignal;\n  readonly isShuttingDown: () => boolean;\n  readonly onSignal: () => void;\n  readonly clearGraceTimer: () => void;\n}\n\nexport function createShutdownHandler(options?: {\n  readonly exit?: (code: number) => void;\n  readonly gracePeriodMs?: number;\n}): ShutdownHandler {\n  const exit = options?.exit ?? ((code: number) => process.exit(code));\n  const gracePeriodMs = options?.gracePeriodMs ?? 3000;\n\n  const controller = new AbortController();\n  let shuttingDown = false;\n  let graceTimer: ReturnType<typeof setTimeout> | undefined;\n\n  const onSignal = () => {\n    if (shuttingDown) {\n      // Second signal — force exit\n      exit(130);\n      return;\n    }\n    shuttingDown = true;\n    controller.abort();\n\n    // Give finally blocks time to clean up, then force-exit\n    graceTimer = setTimeout(() => exit(130), gracePeriodMs);\n    graceTimer.unref();\n  };\n\n  return {\n    signal: controller.signal,\n    isShuttingDown: () => shuttingDown,\n    onSignal,\n    clearGraceTimer: () => {\n      if (graceTimer !== undefined) {\n        clearTimeout(graceTimer);\n        graceTimer = undefined;\n      }\n    },\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Singleton for production use\n// ---------------------------------------------------------------------------\n\nconst globalHandler = createShutdownHandler();\n\n/**\n * The global AbortSignal. Pass this to any async operation that should\n * be cancellable on Ctrl+C (e.g., DB queries, long-running emit).\n */\nexport const shutdownSignal: AbortSignal = globalHandler.signal;\n\n/**\n * Whether a shutdown has been initiated.\n */\nexport function isShuttingDown(): boolean {\n  return globalHandler.isShuttingDown();\n}\n\n/**\n * Installs SIGINT and SIGTERM handlers. Call once at CLI startup.\n *\n * - First signal: aborts the controller, starts a 3s grace timer.\n * - Second signal: force-exits immediately.\n */\nlet installed = false;\n\nexport function installShutdownHandlers(): void {\n  if (installed) return;\n  installed = true;\n  process.on('SIGINT', globalHandler.onSignal);\n  process.on('SIGTERM', globalHandler.onSignal);\n}\n","import * as clack from '@clack/prompts';\nimport { bold, cyan, dim, green, red, yellow } from 'colorette';\nimport { shutdownSignal } from './shutdown';\n\n/**\n * Composable CLI output abstraction.\n *\n * Follows the Unix convention of separating data from decoration:\n * - **stdout** — data output only (`ui.output()`). This is what scripts and pipes capture.\n * - **stderr** — all decoration (spinners, logs, notes, intro/outro). Visible in terminal, invisible in pipes.\n *\n * Rules:\n * 1. All methods except `output()` and `error()` write to stderr only in interactive mode.\n * 2. `output(data)` always writes to stdout — if a command calls it, there is data to emit.\n * 3. `error()` always writes to stderr — errors matter even when piped.\n * 4. All other decoration is suppressed when piped — `isInteractive` gates every other decoration method.\n * 5. Never write data to stderr — decoration methods are for human context only.\n * 6. Never write decoration to stdout — it breaks pipes, `$(...)` captures, and `> file` redirects.\n */\nexport class TerminalUI {\n  /**\n   * True when stdout is a TTY (interactive terminal).\n   * False when piped (e.g., `prisma-next db verify | jq`).\n   */\n  readonly isInteractive: boolean;\n\n  /**\n   * Whether color output is enabled.\n   */\n  readonly useColor: boolean;\n\n  private static readonly stderrOpts = { output: process.stderr } as const;\n\n  constructor(options?: {\n    readonly color?: boolean | undefined;\n    readonly interactive?: boolean | undefined;\n  }) {\n    // --interactive/--no-interactive override TTY detection\n    this.isInteractive = options?.interactive ?? !!process.stdout.isTTY;\n    this.useColor = options?.color ?? this.isInteractive;\n  }\n\n  // ---------------------------------------------------------------------------\n  // Decoration → stderr (only in interactive mode)\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Log a message line to stderr. No-op when piped.\n   */\n  log(message: string): void {\n    if (!this.isInteractive) return;\n    clack.log.message(message, TerminalUI.stderrOpts);\n  }\n\n  /**\n   * Log a success message to stderr. No-op when piped.\n   */\n  success(message: string): void {\n    if (!this.isInteractive) return;\n    clack.log.success(message, TerminalUI.stderrOpts);\n  }\n\n  /**\n   * Log a warning message to stderr. No-op when piped.\n   */\n  warn(message: string): void {\n    if (!this.isInteractive) return;\n    clack.log.warn(message, TerminalUI.stderrOpts);\n  }\n\n  /**\n   * Log an error message to stderr. Always writes (errors matter even in pipes).\n   */\n  error(message: string): void {\n    clack.log.error(message, TerminalUI.stderrOpts);\n  }\n\n  /**\n   * Log an info message to stderr. No-op when piped.\n   */\n  info(message: string): void {\n    if (!this.isInteractive) return;\n    clack.log.info(message, TerminalUI.stderrOpts);\n  }\n\n  /**\n   * Log a step message to stderr. No-op when piped.\n   */\n  step(message: string): void {\n    if (!this.isInteractive) return;\n    clack.log.step(message, TerminalUI.stderrOpts);\n  }\n\n  /**\n   * Display a note box on stderr. No-op when piped.\n   */\n  note(message: string, title?: string): void {\n    if (!this.isInteractive) return;\n    clack.note(message, title, TerminalUI.stderrOpts);\n  }\n\n  /**\n   * Display intro banner on stderr. No-op when piped.\n   */\n  intro(title?: string): void {\n    if (!this.isInteractive) return;\n    clack.intro(title, TerminalUI.stderrOpts);\n  }\n\n  /**\n   * Display outro banner on stderr. No-op when piped.\n   */\n  outro(message?: string): void {\n    if (!this.isInteractive) return;\n    clack.outro(message, TerminalUI.stderrOpts);\n  }\n\n  /**\n   * Create a Clack spinner on stderr with a 100ms delay threshold.\n   * The spinner only appears if the operation takes longer than the threshold,\n   * avoiding flicker for fast operations. Returns a no-op spinner when not interactive.\n   */\n  spinner(delayMs = 100): clack.SpinnerResult {\n    const noop: clack.SpinnerResult = {\n      start: () => {},\n      stop: () => {},\n      cancel: () => {},\n      error: () => {},\n      message: () => {},\n      clear: () => {},\n      get isCancelled() {\n        return false;\n      },\n    };\n\n    if (!this.isInteractive) {\n      return noop;\n    }\n\n    // Wrap the real spinner with a delay: only show it after `delayMs`\n    let inner: clack.SpinnerResult | undefined;\n    let timer: ReturnType<typeof setTimeout> | undefined;\n    let pendingMsg: string | undefined;\n    let settled = false;\n\n    const ensureCleared = () => {\n      if (timer !== undefined) {\n        clearTimeout(timer);\n        timer = undefined;\n      }\n    };\n\n    // Cancel the spinner if a shutdown signal fires\n    const onAbort = () => {\n      if (!settled) {\n        settled = true;\n        ensureCleared();\n        if (inner) {\n          inner.cancel('Interrupted');\n        }\n      }\n    };\n    if (!shutdownSignal.aborted) {\n      shutdownSignal.addEventListener('abort', onAbort, { once: true });\n    }\n\n    return {\n      start(msg?: string) {\n        pendingMsg = msg;\n        timer = setTimeout(() => {\n          if (!settled) {\n            inner = clack.spinner(TerminalUI.stderrOpts);\n            inner.start(pendingMsg);\n          }\n        }, delayMs);\n      },\n      stop(msg?: string) {\n        settled = true;\n        ensureCleared();\n        if (inner) {\n          inner.stop(msg);\n        }\n      },\n      cancel(msg?: string) {\n        settled = true;\n        ensureCleared();\n        if (inner) {\n          inner.cancel(msg);\n        }\n      },\n      error(msg?: string) {\n        settled = true;\n        ensureCleared();\n        if (inner) {\n          inner.error(msg);\n        }\n      },\n      message(msg?: string) {\n        pendingMsg = msg;\n        if (inner) {\n          inner.message(msg);\n        }\n      },\n      clear() {\n        settled = true;\n        ensureCleared();\n        if (inner) {\n          inner.clear();\n        }\n      },\n      get isCancelled() {\n        return inner?.isCancelled ?? false;\n      },\n    };\n  }\n\n  /**\n   * Prompt for yes/no confirmation on stderr. Returns true if confirmed.\n   * In non-interactive mode or when cancelled (Ctrl-C), returns false.\n   */\n  async confirm(message: string): Promise<boolean> {\n    if (!this.isInteractive) return false;\n    const result = await clack.confirm({\n      message,\n      ...TerminalUI.stderrOpts,\n    });\n    if (clack.isCancel(result)) return false;\n    return result;\n  }\n\n  /**\n   * Write a raw line to stderr. No-op when piped.\n   * Use for decoration that doesn't fit Clack's log format (e.g. styled headers).\n   */\n  stderr(message: string): void {\n    if (!this.isInteractive) return;\n    process.stderr.write(`${message}\\n`);\n  }\n\n  // ---------------------------------------------------------------------------\n  // Data → stdout (only when piped)\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Write machine-readable data to stdout.\n   * Always writes — if a command calls output(), there is data to emit.\n   *\n   * This is what scripts and pipes capture: `prisma-next db verify --json | jq .ok`\n   */\n  output(data: string): void {\n    process.stdout.write(`${data}\\n`);\n  }\n\n  // ---------------------------------------------------------------------------\n  // Color helpers\n  // ---------------------------------------------------------------------------\n\n  green(text: string): string {\n    return this.useColor ? green(text) : text;\n  }\n  red(text: string): string {\n    return this.useColor ? red(text) : text;\n  }\n  cyan(text: string): string {\n    return this.useColor ? cyan(text) : text;\n  }\n  dim(text: string): string {\n    return this.useColor ? dim(text) : text;\n  }\n  bold(text: string): string {\n    return this.useColor ? bold(text) : text;\n  }\n  yellow(text: string): string {\n    return this.useColor ? yellow(text) : text;\n  }\n}\n"],"mappings":"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"}

package/dist/{verify-bl__PkXk.mjs → verify-BT9tgCOH.mjs}

@@ -1,4 +1,4 @@
-import { b as formatDim, x as isVerbose, y as createColorFormatter } from "./result-handler-BJwA7ufw.mjs";
+import { a as createColorFormatter, o as formatDim, s as isVerbose } from "./terminal-ui-u2YgKghu.mjs";
 import { ifDefined } from "@prisma-next/utils/defined";
 import { bold, cyan, dim, green, magenta, red, yellow } from "colorette";
 
@@ -382,4 +382,4 @@ function formatSignJson(result) {
 
 //#endregion
 export { formatSignJson as a, formatVerifyOutput as c, formatSchemaVerifyOutput as i, formatIntrospectOutput as n, formatSignOutput as o, formatSchemaVerifyJson as r, formatVerifyJson as s, formatIntrospectJson as t };
-//# sourceMappingURL=verify-bl__PkXk.mjs.map
+//# sourceMappingURL=verify-BT9tgCOH.mjs.map