prisma-next 0.11.0-dev.9 → 0.12.0-dev.1

package/dist/commands/db-update.mjs

@@ -1,17 +1,15 @@
-import { D as mapMigrationToolsError, E as errorUnexpected, O as mapRefResolutionError, a as errorContractValidationFailed, m as errorMigrationPlanningFailed, n as ERROR_CODE_DESTRUCTIVE_CHANGES, s as errorDestructiveChanges, t as CliStructuredError, x as errorRunnerFailed } from "../cli-errors-Bw2GlweY.mjs";
-import { t as createTerminalUI } from "../terminal-ui-BiB_8KNo.mjs";
-import { a as loadMigrationPackages, d as setCommandDescriptions, f as setCommandExamples, l as resolveMigrationPaths, u as sanitizeErrorMessage, v as parseGlobalFlagsOrExit, y as handleResult } from "../command-helpers-CRfjbZRz.mjs";
-import { a as ContractValidationError } from "../client-UnIveZxZ.mjs";
-import { i as formatMigrationPlanOutput, n as formatMigrationApplyOutput, r as formatMigrationJson } from "../migrations-B7n518mT.mjs";
-import { n as prepareMigrationContext, t as addMigrationCommandOptions } from "../migration-command-scaffold-oY4P1Qto.mjs";
-import { i as readContractIR, n as computeRefAdvancementName, t as buildRefAdvancementFields } from "../ref-advancement-DRh5Nquq.mjs";
+import { A as CliStructuredError, I as errorDestructiveChanges, P as errorContractValidationFailed, U as errorMigrationPlanningFailed, Y as errorRunnerFailed, _ as createTerminalUI, c as sanitizeErrorMessage, g as parseGlobalFlagsOrExit, j as ERROR_CODE_DESTRUCTIVE_CHANGES, l as setCommandDescriptions, nt as mapMigrationToolsError, rt as mapRefResolutionError, s as resolveMigrationPaths, tt as errorUnexpected, u as setCommandExamples, y as handleResult } from "../command-helpers-Bbw1GbwL.mjs";
+import { a as ContractValidationError } from "../client-KgJorIvG.mjs";
+import { r as buildReadAggregate } from "../contract-space-aggregate-loader-DvZwdkrr.mjs";
+import { i as formatMigrationPlanOutput, n as formatMigrationApplyOutput, r as formatMigrationJson } from "../migrations-Cv2jxNNK.mjs";
+import { n as prepareMigrationContext, t as addMigrationCommandOptions } from "../migration-command-scaffold-CjvwO6at.mjs";
+import { i as readContractIR, n as computeRefAdvancementName, t as buildRefAdvancementFields } from "../ref-advancement-DUZqsue6.mjs";
 import { Command } from "commander";
 import { ifDefined } from "@prisma-next/utils/defined";
 import { notOk, ok } from "@prisma-next/utils/result";
 import { join } from "pathe";
 import { readFile } from "node:fs/promises";
 import { MigrationToolsError } from "@prisma-next/migration-tools/errors";
-import { readRefs } from "@prisma-next/migration-tools/refs";
 import { parseContractRef } from "@prisma-next/migration-tools/ref-resolution";
 //#region src/commands/db-update.ts
 /**
@@ -48,10 +46,13 @@ async function executeDbUpdateCommand(options, flags, ui, startTime) {
 	const { client, config, dbConnection, onProgress, contractPathAbsolute } = ctxResult.value;
 	let { contractJson } = ctxResult.value;
 	let contractJsonPathForSnapshot = contractPathAbsolute;
-	const { migrationsDir, appMigrationsDir, refsDir } = resolveMigrationPaths(options.config, config);
+	const { migrationsDir, refsDir } = resolveMigrationPaths(options.config, config);
 	if (options.to) try {
-		const { bundles, graph } = await loadMigrationPackages(appMigrationsDir);
-		const refs = await readRefs(refsDir);
+		const loaded = await buildReadAggregate(config, { migrationsDir });
+		if (!loaded.ok) return notOk(loaded.failure);
+		const graph = loaded.value.aggregate.app.graph();
+		const bundles = loaded.value.aggregate.app.packages;
+		const refs = loaded.value.aggregate.app.refs;
 		const refResult = parseContractRef(options.to, {
 			graph,
 			refs

package/dist/commands/db-update.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"db-update.mjs","names":[],"sources":["../../src/commands/db-update.ts"],"sourcesContent":["import { readFile } from 'node:fs/promises';\nimport { MigrationToolsError } from '@prisma-next/migration-tools/errors';\nimport { parseContractRef } from '@prisma-next/migration-tools/ref-resolution';\nimport { readRefs } from '@prisma-next/migration-tools/refs';\nimport { ifDefined } from '@prisma-next/utils/defined';\nimport { notOk, ok, type Result } from '@prisma-next/utils/result';\nimport { Command } from 'commander';\nimport { join } from 'pathe';\nimport { ContractValidationError } from '../control-api/errors';\nimport type { DbUpdateFailure } from '../control-api/types';\nimport {\n  CliStructuredError,\n  ERROR_CODE_DESTRUCTIVE_CHANGES,\n  errorContractValidationFailed,\n  errorDestructiveChanges,\n  errorMigrationPlanningFailed,\n  errorRunnerFailed,\n  errorUnexpected,\n  mapMigrationToolsError,\n  mapRefResolutionError,\n} from '../utils/cli-errors';\nimport type { MigrationCommandOptions } from '../utils/command-helpers';\nimport {\n  loadMigrationPackages,\n  resolveMigrationPaths,\n  sanitizeErrorMessage,\n  setCommandDescriptions,\n  setCommandExamples,\n} from '../utils/command-helpers';\nimport {\n  formatMigrationApplyOutput,\n  formatMigrationJson,\n  formatMigrationPlanOutput,\n  type MigrationCommandResult,\n} from '../utils/formatters/migrations';\nimport { type GlobalFlags, parseGlobalFlagsOrExit } from '../utils/global-flags';\nimport {\n  addMigrationCommandOptions,\n  prepareMigrationContext,\n} from '../utils/migration-command-scaffold';\nimport {\n  buildRefAdvancementFields,\n  computeRefAdvancementName,\n  type RefAdvancementFields,\n  readContractIR,\n} from '../utils/ref-advancement';\nimport { handleResult } from '../utils/result-handler';\nimport { createTerminalUI, type TerminalUI } from '../utils/terminal-ui';\n\ninterface DbUpdateOptions extends MigrationCommandOptions {\n  readonly to?: string;\n  readonly advanceRef?: string;\n}\n\n/**\n * Maps a DbUpdateFailure to a CliStructuredError for consistent error handling.\n */\nfunction mapDbUpdateFailure(failure: DbUpdateFailure): CliStructuredError {\n  if (failure.code === 'PLANNING_FAILED') {\n    return errorMigrationPlanningFailed({ conflicts: failure.conflicts ?? [] });\n  }\n\n  if (failure.code === 'RUNNER_FAILED') {\n    const runnerCode =\n      typeof failure.meta?.['runnerErrorCode'] === 'string'\n        ? failure.meta['runnerErrorCode']\n        : undefined;\n    const fix =\n      runnerCode === 'LEGACY_MARKER_SHAPE'\n        ? 'Legacy marker-table shape detected. Drop `prisma_contract.marker` (Postgres) or `_prisma_marker` (SQLite) and re-run `prisma-next db init` to recreate it with the current per-space schema.'\n        : 'Inspect the reported conflict, reconcile schema drift if needed, then re-run `prisma-next db update`';\n    return errorRunnerFailed(failure.summary, {\n      why: failure.why ?? 'Migration runner failed',\n      fix,\n      ...ifDefined('meta', failure.meta),\n    });\n  }\n\n  if (failure.code === 'DESTRUCTIVE_CHANGES') {\n    return errorDestructiveChanges(failure.summary, {\n      ...ifDefined('why', failure.why),\n      fix: 'Re-run with `-y` to apply destructive changes, or use `--dry-run` to preview first',\n      ...ifDefined('meta', failure.meta),\n    });\n  }\n\n  const exhaustive: never = failure.code;\n  throw new Error(`Unhandled DbUpdateFailure code: ${exhaustive}`);\n}\n\n/**\n * Executes the db update command and returns a structured Result.\n */\nasync function executeDbUpdateCommand(\n  options: DbUpdateOptions,\n  flags: GlobalFlags,\n  ui: TerminalUI,\n  startTime: number,\n): Promise<Result<MigrationCommandResult, CliStructuredError>> {\n  // Prepare shared migration context (config, contract, connection, client)\n  const ctxResult = await prepareMigrationContext(options, flags, ui, {\n    commandName: 'db update',\n    description: 'Update your database schema to match your contract',\n    url: 'https://pris.ly/db-update',\n  });\n  if (!ctxResult.ok) {\n    return ctxResult;\n  }\n  const { client, config, dbConnection, onProgress, contractPathAbsolute } = ctxResult.value;\n  let { contractJson } = ctxResult.value;\n  let contractJsonPathForSnapshot = contractPathAbsolute;\n  const { migrationsDir, appMigrationsDir, refsDir } = resolveMigrationPaths(\n    options.config,\n    config,\n  );\n\n  if (options.to) {\n    try {\n      const { bundles, graph } = await loadMigrationPackages(appMigrationsDir);\n      const refs = await readRefs(refsDir);\n      const refResult = parseContractRef(options.to, { graph, refs });\n      if (!refResult.ok) {\n        return notOk(mapRefResolutionError(refResult.failure));\n      }\n      const targetHash = refResult.value.hash;\n      const matchingBundle = bundles.find((p) => p.metadata.to === targetHash);\n      if (!matchingBundle) {\n        return notOk(\n          errorUnexpected(\n            `No migration bundle found for --to \"${options.to}\" (resolved hash: ${targetHash})`,\n            {\n              why: `The ref resolved successfully but no on-disk migration package has an end-contract hash matching ${targetHash}.`,\n              fix: 'Provide a ref or hash that corresponds to an existing migration package, or run `migration list` to see available migrations.',\n            },\n          ),\n        );\n      }\n      const endContractPath = join(matchingBundle.dirPath, 'end-contract.json');\n      const raw = await readFile(endContractPath, 'utf-8');\n      contractJson = JSON.parse(raw) as Record<string, unknown>;\n      contractJsonPathForSnapshot = endContractPath;\n    } catch (error) {\n      if (MigrationToolsError.is(error)) {\n        return notOk(mapMigrationToolsError(error));\n      }\n      if (CliStructuredError.is(error)) {\n        return notOk(error);\n      }\n      throw error;\n    }\n  }\n\n  try {\n    await client.connect(dbConnection);\n\n    const result = await client.dbUpdate({\n      contract: contractJson,\n      mode: options.dryRun ? 'plan' : 'apply',\n      migrationsDir,\n      ...(flags.yes ? { acceptDataLoss: true } : {}),\n      onProgress,\n    });\n\n    // Handle failures by mapping to CLI structured error\n    if (!result.ok) {\n      return notOk(mapDbUpdateFailure(result.failure));\n    }\n\n    const advancementHash =\n      result.value.mode === 'apply'\n        ? (result.value.marker?.storageHash ?? result.value.destination.storageHash)\n        : result.value.destination.storageHash;\n\n    let refAdvancementFields: RefAdvancementFields = {\n      advancedRef: null,\n      plannedAdvanceRef: null,\n    };\n    if (\n      computeRefAdvancementName({\n        ...ifDefined('advanceRef', options.advanceRef),\n        ...ifDefined('db', options.db),\n      }) !== null\n    ) {\n      try {\n        const contractIR = await readContractIR(contractJson, contractJsonPathForSnapshot);\n        refAdvancementFields = await buildRefAdvancementFields({\n          ...ifDefined('advanceRef', options.advanceRef),\n          ...ifDefined('db', options.db),\n          refsDir,\n          contractIR,\n          mode: result.value.mode,\n          hash: advancementHash,\n        });\n      } catch (error) {\n        if (MigrationToolsError.is(error)) {\n          return notOk(mapMigrationToolsError(error));\n        }\n        throw error;\n      }\n    }\n\n    // Convert success result to CLI output format\n    const dbUpdateResult: MigrationCommandResult = {\n      ok: true,\n      mode: result.value.mode,\n      plan: {\n        targetId: ctxResult.value.config.target.targetId,\n        destination: {\n          storageHash: result.value.destination.storageHash,\n          ...ifDefined('profileHash', result.value.destination.profileHash),\n        },\n        operations: result.value.plan.operations.map((op) => ({\n          id: op.id,\n          label: op.label,\n          operationClass: op.operationClass,\n        })),\n        ...ifDefined('preview', result.value.plan.preview),\n      },\n      ...ifDefined(\n        'execution',\n        result.value.execution\n          ? {\n              operationsPlanned: result.value.execution.operationsPlanned,\n              operationsExecuted: result.value.execution.operationsExecuted,\n            }\n          : undefined,\n      ),\n      ...ifDefined(\n        'marker',\n        result.value.marker\n          ? {\n              storageHash: result.value.marker.storageHash,\n              ...ifDefined('profileHash', result.value.marker.profileHash),\n            }\n          : undefined,\n      ),\n      ...ifDefined('perSpace', result.value.perSpace),\n      advancedRef: refAdvancementFields.advancedRef,\n      plannedAdvanceRef: refAdvancementFields.plannedAdvanceRef,\n      summary: result.value.summary,\n      timings: { total: Date.now() - startTime },\n    };\n\n    return ok(dbUpdateResult);\n  } catch (error) {\n    if (CliStructuredError.is(error)) {\n      return notOk(error);\n    }\n\n    if (error instanceof ContractValidationError) {\n      return notOk(\n        errorContractValidationFailed(`Contract validation failed: ${error.message}`, {\n          where: { path: contractPathAbsolute },\n        }),\n      );\n    }\n\n    const rawMessage = error instanceof Error ? error.message : String(error);\n    const safeMessage = sanitizeErrorMessage(\n      rawMessage,\n      typeof dbConnection === 'string' ? dbConnection : undefined,\n    );\n    return notOk(\n      errorUnexpected(safeMessage, {\n        why: `Unexpected error during db update: ${safeMessage}`,\n      }),\n    );\n  } finally {\n    await client.close();\n  }\n}\n\nexport function createDbUpdateCommand(): Command {\n  const command = new Command('update');\n  setCommandDescriptions(\n    command,\n    'Update your database schema to match your contract',\n    'Compares your database schema to the emitted contract and applies the necessary\\n' +\n      'changes. Works on any database, whether or not it has been initialized with `db init`.\\n' +\n      'Destructive operations prompt for confirmation in interactive mode. Use -y to\\n' +\n      'auto-accept or --dry-run to preview first.',\n  );\n  setCommandExamples(command, [\n    'prisma-next db update --db $DATABASE_URL',\n    'prisma-next db update --db $DATABASE_URL --dry-run',\n  ]);\n  addMigrationCommandOptions(command);\n  command.option(\n    '--to <contract>',\n    'Target contract reference (hash, prefix, ref name, migration dir name, <dir>^, or ./path)',\n  );\n  command.option('--advance-ref <name>', 'Ref to advance to the post-command contract hash');\n  command.action(async (options: DbUpdateOptions) => {\n    const flags = parseGlobalFlagsOrExit(options);\n    const startTime = Date.now();\n\n    const ui = createTerminalUI(flags);\n\n    let result = await executeDbUpdateCommand(options, flags, ui, startTime);\n\n    // Interactive confirmation for destructive operations:\n    // When the control API rejects destructive changes, prompt the user instead of failing.\n    // In non-interactive mode (CI, piped, --no-interactive, --json), the error is returned as-is.\n    if (\n      !result.ok &&\n      result.failure.code === ERROR_CODE_DESTRUCTIVE_CHANGES &&\n      flags.interactive &&\n      !flags.json &&\n      !flags.yes\n    ) {\n      const meta = result.failure.meta as\n        | { destructiveOperations?: readonly { id: string; label: string }[] }\n        | undefined;\n      const destructiveOps = meta?.destructiveOperations ?? [];\n\n      if (destructiveOps.length > 0) {\n        ui.warn(\n          `${destructiveOps.length} destructive operation(s) that may cause data loss:\\n${destructiveOps.map((op) => `  ${ui.yellow('▸')} ${op.label}`).join('\\n')}`,\n        );\n      }\n\n      const confirmed = await ui.confirm('Apply destructive changes? This cannot be undone.');\n\n      if (confirmed) {\n        result = await executeDbUpdateCommand(options, { ...flags, yes: true }, ui, Date.now());\n      }\n    }\n\n    const exitCode = handleResult(result, flags, ui, (dbUpdateResult) => {\n      if (flags.json) {\n        ui.output(formatMigrationJson(dbUpdateResult));\n      } else {\n        const output =\n          dbUpdateResult.mode === 'plan'\n            ? formatMigrationPlanOutput(dbUpdateResult, flags)\n            : formatMigrationApplyOutput(dbUpdateResult, flags);\n        if (output) {\n          ui.log(output);\n        }\n      }\n    });\n    process.exit(exitCode);\n  });\n\n  return command;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAyDA,SAAS,mBAAmB,SAA8C;CACxE,IAAI,QAAQ,SAAS,mBACnB,OAAO,6BAA6B,EAAE,WAAW,QAAQ,aAAa,EAAE,EAAE,CAAC;CAG7E,IAAI,QAAQ,SAAS,iBAAiB;EAKpC,MAAM,OAHJ,OAAO,QAAQ,OAAO,uBAAuB,WACzC,QAAQ,KAAK,qBACb,KAAA,OAEW,wBACX,iMACA;EACN,OAAO,kBAAkB,QAAQ,SAAS;GACxC,KAAK,QAAQ,OAAO;GACpB;GACA,GAAG,UAAU,QAAQ,QAAQ,KAAK;GACnC,CAAC;;CAGJ,IAAI,QAAQ,SAAS,uBACnB,OAAO,wBAAwB,QAAQ,SAAS;EAC9C,GAAG,UAAU,OAAO,QAAQ,IAAI;EAChC,KAAK;EACL,GAAG,UAAU,QAAQ,QAAQ,KAAK;EACnC,CAAC;CAGJ,MAAM,aAAoB,QAAQ;CAClC,MAAM,IAAI,MAAM,mCAAmC,aAAa;;;;;AAMlE,eAAe,uBACb,SACA,OACA,IACA,WAC6D;CAE7D,MAAM,YAAY,MAAM,wBAAwB,SAAS,OAAO,IAAI;EAClE,aAAa;EACb,aAAa;EACb,KAAK;EACN,CAAC;CACF,IAAI,CAAC,UAAU,IACb,OAAO;CAET,MAAM,EAAE,QAAQ,QAAQ,cAAc,YAAY,yBAAyB,UAAU;CACrF,IAAI,EAAE,iBAAiB,UAAU;CACjC,IAAI,8BAA8B;CAClC,MAAM,EAAE,eAAe,kBAAkB,YAAY,sBACnD,QAAQ,QACR,OACD;CAED,IAAI,QAAQ,IACV,IAAI;EACF,MAAM,EAAE,SAAS,UAAU,MAAM,sBAAsB,iBAAiB;EACxE,MAAM,OAAO,MAAM,SAAS,QAAQ;EACpC,MAAM,YAAY,iBAAiB,QAAQ,IAAI;GAAE;GAAO;GAAM,CAAC;EAC/D,IAAI,CAAC,UAAU,IACb,OAAO,MAAM,sBAAsB,UAAU,QAAQ,CAAC;EAExD,MAAM,aAAa,UAAU,MAAM;EACnC,MAAM,iBAAiB,QAAQ,MAAM,MAAM,EAAE,SAAS,OAAO,WAAW;EACxE,IAAI,CAAC,gBACH,OAAO,MACL,gBACE,uCAAuC,QAAQ,GAAG,oBAAoB,WAAW,IACjF;GACE,KAAK,oGAAoG,WAAW;GACpH,KAAK;GACN,CACF,CACF;EAEH,MAAM,kBAAkB,KAAK,eAAe,SAAS,oBAAoB;EACzE,MAAM,MAAM,MAAM,SAAS,iBAAiB,QAAQ;EACpD,eAAe,KAAK,MAAM,IAAI;EAC9B,8BAA8B;UACvB,OAAO;EACd,IAAI,oBAAoB,GAAG,MAAM,EAC/B,OAAO,MAAM,uBAAuB,MAAM,CAAC;EAE7C,IAAI,mBAAmB,GAAG,MAAM,EAC9B,OAAO,MAAM,MAAM;EAErB,MAAM;;CAIV,IAAI;EACF,MAAM,OAAO,QAAQ,aAAa;EAElC,MAAM,SAAS,MAAM,OAAO,SAAS;GACnC,UAAU;GACV,MAAM,QAAQ,SAAS,SAAS;GAChC;GACA,GAAI,MAAM,MAAM,EAAE,gBAAgB,MAAM,GAAG,EAAE;GAC7C;GACD,CAAC;EAGF,IAAI,CAAC,OAAO,IACV,OAAO,MAAM,mBAAmB,OAAO,QAAQ,CAAC;EAGlD,MAAM,kBACJ,OAAO,MAAM,SAAS,UACjB,OAAO,MAAM,QAAQ,eAAe,OAAO,MAAM,YAAY,cAC9D,OAAO,MAAM,YAAY;EAE/B,IAAI,uBAA6C;GAC/C,aAAa;GACb,mBAAmB;GACpB;EACD,IACE,0BAA0B;GACxB,GAAG,UAAU,cAAc,QAAQ,WAAW;GAC9C,GAAG,UAAU,MAAM,QAAQ,GAAG;GAC/B,CAAC,KAAK,MAEP,IAAI;GACF,MAAM,aAAa,MAAM,eAAe,cAAc,4BAA4B;GAClF,uBAAuB,MAAM,0BAA0B;IACrD,GAAG,UAAU,cAAc,QAAQ,WAAW;IAC9C,GAAG,UAAU,MAAM,QAAQ,GAAG;IAC9B;IACA;IACA,MAAM,OAAO,MAAM;IACnB,MAAM;IACP,CAAC;WACK,OAAO;GACd,IAAI,oBAAoB,GAAG,MAAM,EAC/B,OAAO,MAAM,uBAAuB,MAAM,CAAC;GAE7C,MAAM;;EA8CV,OAAO,GAAG;GAxCR,IAAI;GACJ,MAAM,OAAO,MAAM;GACnB,MAAM;IACJ,UAAU,UAAU,MAAM,OAAO,OAAO;IACxC,aAAa;KACX,aAAa,OAAO,MAAM,YAAY;KACtC,GAAG,UAAU,eAAe,OAAO,MAAM,YAAY,YAAY;KAClE;IACD,YAAY,OAAO,MAAM,KAAK,WAAW,KAAK,QAAQ;KACpD,IAAI,GAAG;KACP,OAAO,GAAG;KACV,gBAAgB,GAAG;KACpB,EAAE;IACH,GAAG,UAAU,WAAW,OAAO,MAAM,KAAK,QAAQ;IACnD;GACD,GAAG,UACD,aACA,OAAO,MAAM,YACT;IACE,mBAAmB,OAAO,MAAM,UAAU;IAC1C,oBAAoB,OAAO,MAAM,UAAU;IAC5C,GACD,KAAA,EACL;GACD,GAAG,UACD,UACA,OAAO,MAAM,SACT;IACE,aAAa,OAAO,MAAM,OAAO;IACjC,GAAG,UAAU,eAAe,OAAO,MAAM,OAAO,YAAY;IAC7D,GACD,KAAA,EACL;GACD,GAAG,UAAU,YAAY,OAAO,MAAM,SAAS;GAC/C,aAAa,qBAAqB;GAClC,mBAAmB,qBAAqB;GACxC,SAAS,OAAO,MAAM;GACtB,SAAS,EAAE,OAAO,KAAK,KAAK,GAAG,WAAW;GAGpB,CAAC;UAClB,OAAO;EACd,IAAI,mBAAmB,GAAG,MAAM,EAC9B,OAAO,MAAM,MAAM;EAGrB,IAAI,iBAAiB,yBACnB,OAAO,MACL,8BAA8B,+BAA+B,MAAM,WAAW,EAC5E,OAAO,EAAE,MAAM,sBAAsB,EACtC,CAAC,CACH;EAIH,MAAM,cAAc,qBADD,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,EAGvE,OAAO,iBAAiB,WAAW,eAAe,KAAA,EACnD;EACD,OAAO,MACL,gBAAgB,aAAa,EAC3B,KAAK,sCAAsC,eAC5C,CAAC,CACH;WACO;EACR,MAAM,OAAO,OAAO;;;AAIxB,SAAgB,wBAAiC;CAC/C,MAAM,UAAU,IAAI,QAAQ,SAAS;CACrC,uBACE,SACA,sDACA,qSAID;CACD,mBAAmB,SAAS,CAC1B,4CACA,qDACD,CAAC;CACF,2BAA2B,QAAQ;CACnC,QAAQ,OACN,mBACA,4FACD;CACD,QAAQ,OAAO,wBAAwB,mDAAmD;CAC1F,QAAQ,OAAO,OAAO,YAA6B;EACjD,MAAM,QAAQ,uBAAuB,QAAQ;EAC7C,MAAM,YAAY,KAAK,KAAK;EAE5B,MAAM,KAAK,iBAAiB,MAAM;EAElC,IAAI,SAAS,MAAM,uBAAuB,SAAS,OAAO,IAAI,UAAU;EAKxE,IACE,CAAC,OAAO,MACR,OAAO,QAAQ,SAAS,kCACxB,MAAM,eACN,CAAC,MAAM,QACP,CAAC,MAAM,KACP;GAIA,MAAM,iBAHO,OAAO,QAAQ,MAGC,yBAAyB,EAAE;GAExD,IAAI,eAAe,SAAS,GAC1B,GAAG,KACD,GAAG,eAAe,OAAO,uDAAuD,eAAe,KAAK,OAAO,KAAK,GAAG,OAAO,IAAI,CAAC,GAAG,GAAG,QAAQ,CAAC,KAAK,KAAK,GACzJ;GAKH,IAAI,MAFoB,GAAG,QAAQ,oDAAoD,EAGrF,SAAS,MAAM,uBAAuB,SAAS;IAAE,GAAG;IAAO,KAAK;IAAM,EAAE,IAAI,KAAK,KAAK,CAAC;;EAI3F,MAAM,WAAW,aAAa,QAAQ,OAAO,KAAK,mBAAmB;GACnE,IAAI,MAAM,MACR,GAAG,OAAO,oBAAoB,eAAe,CAAC;QACzC;IACL,MAAM,SACJ,eAAe,SAAS,SACpB,0BAA0B,gBAAgB,MAAM,GAChD,2BAA2B,gBAAgB,MAAM;IACvD,IAAI,QACF,GAAG,IAAI,OAAO;;IAGlB;EACF,QAAQ,KAAK,SAAS;GACtB;CAEF,OAAO"}
+{"version":3,"file":"db-update.mjs","names":[],"sources":["../../src/commands/db-update.ts"],"sourcesContent":["import { readFile } from 'node:fs/promises';\nimport { MigrationToolsError } from '@prisma-next/migration-tools/errors';\nimport { parseContractRef } from '@prisma-next/migration-tools/ref-resolution';\nimport { ifDefined } from '@prisma-next/utils/defined';\nimport { notOk, ok, type Result } from '@prisma-next/utils/result';\nimport { Command } from 'commander';\nimport { join } from 'pathe';\nimport { ContractValidationError } from '../control-api/errors';\nimport type { DbUpdateFailure } from '../control-api/types';\nimport {\n  CliStructuredError,\n  ERROR_CODE_DESTRUCTIVE_CHANGES,\n  errorContractValidationFailed,\n  errorDestructiveChanges,\n  errorMigrationPlanningFailed,\n  errorRunnerFailed,\n  errorUnexpected,\n  mapMigrationToolsError,\n  mapRefResolutionError,\n} from '../utils/cli-errors';\nimport type { MigrationCommandOptions } from '../utils/command-helpers';\nimport {\n  resolveMigrationPaths,\n  sanitizeErrorMessage,\n  setCommandDescriptions,\n  setCommandExamples,\n} from '../utils/command-helpers';\nimport { buildReadAggregate } from '../utils/contract-space-aggregate-loader';\nimport {\n  formatMigrationApplyOutput,\n  formatMigrationJson,\n  formatMigrationPlanOutput,\n  type MigrationCommandResult,\n} from '../utils/formatters/migrations';\nimport { type GlobalFlags, parseGlobalFlagsOrExit } from '../utils/global-flags';\nimport {\n  addMigrationCommandOptions,\n  prepareMigrationContext,\n} from '../utils/migration-command-scaffold';\nimport {\n  buildRefAdvancementFields,\n  computeRefAdvancementName,\n  type RefAdvancementFields,\n  readContractIR,\n} from '../utils/ref-advancement';\nimport { handleResult } from '../utils/result-handler';\nimport { createTerminalUI, type TerminalUI } from '../utils/terminal-ui';\n\ninterface DbUpdateOptions extends MigrationCommandOptions {\n  readonly to?: string;\n  readonly advanceRef?: string;\n}\n\n/**\n * Maps a DbUpdateFailure to a CliStructuredError for consistent error handling.\n */\nfunction mapDbUpdateFailure(failure: DbUpdateFailure): CliStructuredError {\n  if (failure.code === 'PLANNING_FAILED') {\n    return errorMigrationPlanningFailed({ conflicts: failure.conflicts ?? [] });\n  }\n\n  if (failure.code === 'RUNNER_FAILED') {\n    const runnerCode =\n      typeof failure.meta?.['runnerErrorCode'] === 'string'\n        ? failure.meta['runnerErrorCode']\n        : undefined;\n    const fix =\n      runnerCode === 'LEGACY_MARKER_SHAPE'\n        ? 'Legacy marker-table shape detected. Drop `prisma_contract.marker` (Postgres) or `_prisma_marker` (SQLite) and re-run `prisma-next db init` to recreate it with the current per-space schema.'\n        : 'Inspect the reported conflict, reconcile schema drift if needed, then re-run `prisma-next db update`';\n    return errorRunnerFailed(failure.summary, {\n      why: failure.why ?? 'Migration runner failed',\n      fix,\n      ...ifDefined('meta', failure.meta),\n    });\n  }\n\n  if (failure.code === 'DESTRUCTIVE_CHANGES') {\n    return errorDestructiveChanges(failure.summary, {\n      ...ifDefined('why', failure.why),\n      fix: 'Re-run with `-y` to apply destructive changes, or use `--dry-run` to preview first',\n      ...ifDefined('meta', failure.meta),\n    });\n  }\n\n  const exhaustive: never = failure.code;\n  throw new Error(`Unhandled DbUpdateFailure code: ${exhaustive}`);\n}\n\n/**\n * Executes the db update command and returns a structured Result.\n */\nasync function executeDbUpdateCommand(\n  options: DbUpdateOptions,\n  flags: GlobalFlags,\n  ui: TerminalUI,\n  startTime: number,\n): Promise<Result<MigrationCommandResult, CliStructuredError>> {\n  // Prepare shared migration context (config, contract, connection, client)\n  const ctxResult = await prepareMigrationContext(options, flags, ui, {\n    commandName: 'db update',\n    description: 'Update your database schema to match your contract',\n    url: 'https://pris.ly/db-update',\n  });\n  if (!ctxResult.ok) {\n    return ctxResult;\n  }\n  const { client, config, dbConnection, onProgress, contractPathAbsolute } = ctxResult.value;\n  let { contractJson } = ctxResult.value;\n  let contractJsonPathForSnapshot = contractPathAbsolute;\n  const { migrationsDir, refsDir } = resolveMigrationPaths(options.config, config);\n\n  if (options.to) {\n    try {\n      const loaded = await buildReadAggregate(config, { migrationsDir });\n      if (!loaded.ok) {\n        return notOk(loaded.failure);\n      }\n      const graph = loaded.value.aggregate.app.graph();\n      const bundles = loaded.value.aggregate.app.packages;\n      const refs = loaded.value.aggregate.app.refs;\n      const refResult = parseContractRef(options.to, { graph, refs });\n      if (!refResult.ok) {\n        return notOk(mapRefResolutionError(refResult.failure));\n      }\n      const targetHash = refResult.value.hash;\n      const matchingBundle = bundles.find((p) => p.metadata.to === targetHash);\n      if (!matchingBundle) {\n        return notOk(\n          errorUnexpected(\n            `No migration bundle found for --to \"${options.to}\" (resolved hash: ${targetHash})`,\n            {\n              why: `The ref resolved successfully but no on-disk migration package has an end-contract hash matching ${targetHash}.`,\n              fix: 'Provide a ref or hash that corresponds to an existing migration package, or run `migration list` to see available migrations.',\n            },\n          ),\n        );\n      }\n      const endContractPath = join(matchingBundle.dirPath, 'end-contract.json');\n      const raw = await readFile(endContractPath, 'utf-8');\n      contractJson = JSON.parse(raw) as Record<string, unknown>;\n      contractJsonPathForSnapshot = endContractPath;\n    } catch (error) {\n      if (MigrationToolsError.is(error)) {\n        return notOk(mapMigrationToolsError(error));\n      }\n      if (CliStructuredError.is(error)) {\n        return notOk(error);\n      }\n      throw error;\n    }\n  }\n\n  try {\n    await client.connect(dbConnection);\n\n    const result = await client.dbUpdate({\n      contract: contractJson,\n      mode: options.dryRun ? 'plan' : 'apply',\n      migrationsDir,\n      ...(flags.yes ? { acceptDataLoss: true } : {}),\n      onProgress,\n    });\n\n    // Handle failures by mapping to CLI structured error\n    if (!result.ok) {\n      return notOk(mapDbUpdateFailure(result.failure));\n    }\n\n    const advancementHash =\n      result.value.mode === 'apply'\n        ? (result.value.marker?.storageHash ?? result.value.destination.storageHash)\n        : result.value.destination.storageHash;\n\n    let refAdvancementFields: RefAdvancementFields = {\n      advancedRef: null,\n      plannedAdvanceRef: null,\n    };\n    if (\n      computeRefAdvancementName({\n        ...ifDefined('advanceRef', options.advanceRef),\n        ...ifDefined('db', options.db),\n      }) !== null\n    ) {\n      try {\n        const contractIR = await readContractIR(contractJson, contractJsonPathForSnapshot);\n        refAdvancementFields = await buildRefAdvancementFields({\n          ...ifDefined('advanceRef', options.advanceRef),\n          ...ifDefined('db', options.db),\n          refsDir,\n          contractIR,\n          mode: result.value.mode,\n          hash: advancementHash,\n        });\n      } catch (error) {\n        if (MigrationToolsError.is(error)) {\n          return notOk(mapMigrationToolsError(error));\n        }\n        throw error;\n      }\n    }\n\n    // Convert success result to CLI output format\n    const dbUpdateResult: MigrationCommandResult = {\n      ok: true,\n      mode: result.value.mode,\n      plan: {\n        targetId: ctxResult.value.config.target.targetId,\n        destination: {\n          storageHash: result.value.destination.storageHash,\n          ...ifDefined('profileHash', result.value.destination.profileHash),\n        },\n        operations: result.value.plan.operations.map((op) => ({\n          id: op.id,\n          label: op.label,\n          operationClass: op.operationClass,\n        })),\n        ...ifDefined('preview', result.value.plan.preview),\n      },\n      ...ifDefined(\n        'execution',\n        result.value.execution\n          ? {\n              operationsPlanned: result.value.execution.operationsPlanned,\n              operationsExecuted: result.value.execution.operationsExecuted,\n            }\n          : undefined,\n      ),\n      ...ifDefined(\n        'marker',\n        result.value.marker\n          ? {\n              storageHash: result.value.marker.storageHash,\n              ...ifDefined('profileHash', result.value.marker.profileHash),\n            }\n          : undefined,\n      ),\n      ...ifDefined('perSpace', result.value.perSpace),\n      advancedRef: refAdvancementFields.advancedRef,\n      plannedAdvanceRef: refAdvancementFields.plannedAdvanceRef,\n      summary: result.value.summary,\n      timings: { total: Date.now() - startTime },\n    };\n\n    return ok(dbUpdateResult);\n  } catch (error) {\n    if (CliStructuredError.is(error)) {\n      return notOk(error);\n    }\n\n    if (error instanceof ContractValidationError) {\n      return notOk(\n        errorContractValidationFailed(`Contract validation failed: ${error.message}`, {\n          where: { path: contractPathAbsolute },\n        }),\n      );\n    }\n\n    const rawMessage = error instanceof Error ? error.message : String(error);\n    const safeMessage = sanitizeErrorMessage(\n      rawMessage,\n      typeof dbConnection === 'string' ? dbConnection : undefined,\n    );\n    return notOk(\n      errorUnexpected(safeMessage, {\n        why: `Unexpected error during db update: ${safeMessage}`,\n      }),\n    );\n  } finally {\n    await client.close();\n  }\n}\n\nexport function createDbUpdateCommand(): Command {\n  const command = new Command('update');\n  setCommandDescriptions(\n    command,\n    'Update your database schema to match your contract',\n    'Compares your database schema to the emitted contract and applies the necessary\\n' +\n      'changes. Works on any database, whether or not it has been initialized with `db init`.\\n' +\n      'Destructive operations prompt for confirmation in interactive mode. Use -y to\\n' +\n      'auto-accept or --dry-run to preview first.',\n  );\n  setCommandExamples(command, [\n    'prisma-next db update --db $DATABASE_URL',\n    'prisma-next db update --db $DATABASE_URL --dry-run',\n  ]);\n  addMigrationCommandOptions(command);\n  command.option(\n    '--to <contract>',\n    'Target contract reference (hash, prefix, ref name, migration dir name, <dir>^, or ./path)',\n  );\n  command.option('--advance-ref <name>', 'Ref to advance to the post-command contract hash');\n  command.action(async (options: DbUpdateOptions) => {\n    const flags = parseGlobalFlagsOrExit(options);\n    const startTime = Date.now();\n\n    const ui = createTerminalUI(flags);\n\n    let result = await executeDbUpdateCommand(options, flags, ui, startTime);\n\n    // Interactive confirmation for destructive operations:\n    // When the control API rejects destructive changes, prompt the user instead of failing.\n    // In non-interactive mode (CI, piped, --no-interactive, --json), the error is returned as-is.\n    if (\n      !result.ok &&\n      result.failure.code === ERROR_CODE_DESTRUCTIVE_CHANGES &&\n      flags.interactive &&\n      !flags.json &&\n      !flags.yes\n    ) {\n      const meta = result.failure.meta as\n        | { destructiveOperations?: readonly { id: string; label: string }[] }\n        | undefined;\n      const destructiveOps = meta?.destructiveOperations ?? [];\n\n      if (destructiveOps.length > 0) {\n        ui.warn(\n          `${destructiveOps.length} destructive operation(s) that may cause data loss:\\n${destructiveOps.map((op) => `  ${ui.yellow('▸')} ${op.label}`).join('\\n')}`,\n        );\n      }\n\n      const confirmed = await ui.confirm('Apply destructive changes? This cannot be undone.');\n\n      if (confirmed) {\n        result = await executeDbUpdateCommand(options, { ...flags, yes: true }, ui, Date.now());\n      }\n    }\n\n    const exitCode = handleResult(result, flags, ui, (dbUpdateResult) => {\n      if (flags.json) {\n        ui.output(formatMigrationJson(dbUpdateResult));\n      } else {\n        const output =\n          dbUpdateResult.mode === 'plan'\n            ? formatMigrationPlanOutput(dbUpdateResult, flags)\n            : formatMigrationApplyOutput(dbUpdateResult, flags);\n        if (output) {\n          ui.log(output);\n        }\n      }\n    });\n    process.exit(exitCode);\n  });\n\n  return command;\n}\n"],"mappings":"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"}

package/dist/commands/db-verify.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"db-verify.d.mts","names":[],"sources":["../../src/commands/db-verify.ts"],"mappings":";;;iBAmfgB,qBAAA,CAAA,GAAyB,OAAA"}
+{"version":3,"file":"db-verify.d.mts","names":[],"sources":["../../src/commands/db-verify.ts"],"mappings":";;;iBAmfgB,qBAAA,CAAA,GAAyB,OAAO"}

package/dist/commands/db-verify.mjs

@@ -1,2 +1,2 @@
-import { t as createDbVerifyCommand } from "../db-verify-1d8tDoFN.mjs";
+import { t as createDbVerifyCommand } from "../db-verify-v_vUKXTU.mjs";
 export { createDbVerifyCommand };

package/dist/commands/migrate.d.mts

@@ -1,4 +1,4 @@
-import { T as MigrationApplyPathDecision, t as AggregatePerSpaceExecutionEntry } from "../types-UWB2-rrw.mjs";
+import { E as PerSpaceExecutionEntry, w as MigrationApplyPathDecision } from "../types-Dt_SfqFm.mjs";
 import { Command } from "commander";
 
 //#region src/commands/migrate.d.ts
@@ -16,7 +16,7 @@ interface MigrateResult {
     readonly operationsExecuted: number;
   }[];
   readonly summary: string;
-  readonly perSpace: readonly AggregatePerSpaceExecutionEntry[];
+  readonly perSpace: readonly PerSpaceExecutionEntry[];
   readonly pathDecision?: MigrationApplyPathDecision;
   readonly timings: {
     readonly total: number;

package/dist/commands/migrate.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"migrate.d.mts","names":[],"sources":["../../src/commands/migrate.ts"],"mappings":";;;;UA4DiB,aAAA;EAAA,SACN,EAAA;EAAA,SACA,iBAAA;EAAA,SACA,eAAA;EAAA,SACA,UAAA;EAAA,SACA,OAAA;IAAA,SACE,OAAA;IAAA,SACA,OAAA;IAAA,SACA,aAAA;IAAA,SACA,IAAA;IAAA,SACA,EAAA;IAAA,SACA,kBAAA;EAAA;EAAA,SAEF,OAAA;EAAA,SACA,QAAA,WAAmB,+BAAA;EAAA,SACnB,YAAA,GAAe,0BAAA;EAAA,SACf,OAAA;IAAA,SACE,KAAA;EAAA;EAAA,SAEF,WAAA;IAAA,SAAyB,IAAA;IAAA,SAAuB,IAAA;EAAA;AAAA;AAAA,iBAgS3C,oBAAA,CAAA,GAAwB,OAAA"}
+{"version":3,"file":"migrate.d.mts","names":[],"sources":["../../src/commands/migrate.ts"],"mappings":";;;;UA+DiB,aAAA;EAAA,SACN,EAAA;EAAA,SACA,iBAAA;EAAA,SACA,eAAA;EAAA,SACA,UAAA;EAAA,SACA,OAAA;IAAA,SACE,OAAA;IAAA,SACA,OAAA;IAAA,SACA,aAAA;IAAA,SACA,IAAA;IAAA,SACA,EAAA;IAAA,SACA,kBAAA;EAAA;EAAA,SAEF,OAAA;EAAA,SACA,QAAA,WAAmB,sBAAA;EAAA,SACnB,YAAA,GAAe,0BAA0B;EAAA,SACzC,OAAA;IAAA,SACE,KAAA;EAAA;EAAA,SAEF,WAAA;IAAA,SAAyB,IAAA;IAAA,SAAuB,IAAA;EAAA;AAAA;AAAA,iBAwS3C,oBAAA,CAAA,GAAwB,OAAO"}

package/dist/commands/migrate.mjs

@@ -1,19 +1,18 @@
 import { t as loadConfig } from "../config-loader-B6sJjXTv.mjs";
-import { D as mapMigrationToolsError, E as errorUnexpected, O as mapRefResolutionError, S as errorRuntime, a as errorContractValidationFailed, c as errorDriverRequired, f as errorMarkerMismatch, g as errorPathUnreachable, l as errorFileNotFound, o as errorDatabaseConnectionRequired, t as CliStructuredError, w as errorTargetMigrationNotSupported } from "../cli-errors-Bw2GlweY.mjs";
-import { t as createTerminalUI } from "../terminal-ui-BiB_8KNo.mjs";
-import { S as formatStyledHeader, a as loadMigrationPackages, c as resolveContractPath, d as setCommandDescriptions, f as setCommandExamples, l as resolveMigrationPaths, m as targetSupportsMigrations, n as collectDeclaredInvariants, o as maskConnectionUrl, t as addGlobalOptions, v as parseGlobalFlagsOrExit, y as handleResult } from "../command-helpers-CRfjbZRz.mjs";
-import { t as createControlClient } from "../client-UnIveZxZ.mjs";
-import { t as formatMigrationApplyCommandOutput } from "../migrations-B7n518mT.mjs";
-import { i as readContractIR, r as executeRefAdvancement } from "../ref-advancement-DRh5Nquq.mjs";
+import { $ as errorTargetMigrationNotSupported, A as CliStructuredError, F as errorDatabaseConnectionRequired, L as errorDriverRequired, P as errorContractValidationFailed, R as errorFileNotFound, T as formatStyledHeader, V as errorMarkerMismatch, W as errorPathUnreachable, X as errorRuntime, _ as createTerminalUI, f as targetSupportsMigrations, g as parseGlobalFlagsOrExit, i as maskConnectionUrl, l as setCommandDescriptions, n as collectDeclaredInvariants, nt as mapMigrationToolsError, o as resolveContractPath, rt as mapRefResolutionError, s as resolveMigrationPaths, t as addGlobalOptions, tt as errorUnexpected, u as setCommandExamples, y as handleResult } from "../command-helpers-Bbw1GbwL.mjs";
+import { t as createControlClient } from "../client-KgJorIvG.mjs";
+import { t as toDeclaredExtensionsFromRaw } from "../extension-pack-inputs-IDvjRCi3.mjs";
+import { a as loadContractSpaceAggregateForCli, o as refuseContractSpaceIntegrity } from "../contract-space-aggregate-loader-DvZwdkrr.mjs";
+import { t as formatMigrationApplyCommandOutput } from "../migrations-Cv2jxNNK.mjs";
+import { i as readContractIR, r as executeRefAdvancement } from "../ref-advancement-DUZqsue6.mjs";
+import { t as mapContractAtError } from "../contract-at-errors-BxP-TOMl.mjs";
 import { Command } from "commander";
 import { ifDefined } from "@prisma-next/utils/defined";
 import { notOk, ok } from "@prisma-next/utils/result";
-import { join } from "pathe";
 import { readFile } from "node:fs/promises";
 import { createControlStack } from "@prisma-next/framework-components/control";
-import { findLatestMigration, isGraphNode } from "@prisma-next/migration-tools/migration-graph";
 import { MigrationToolsError, errorUnknownInvariant } from "@prisma-next/migration-tools/errors";
-import { readRefs } from "@prisma-next/migration-tools/refs";
+import { findLatestMigration, isGraphNode } from "@prisma-next/migration-tools/migration-graph";
 import { parseContractRef } from "@prisma-next/migration-tools/ref-resolution";
 //#region src/commands/migrate.ts
 function mapApplyFailure(failure) {
@@ -26,7 +25,7 @@ function mapApplyFailure(failure) {
 }
 async function executeMigrateCommand(options, flags, ui, startTime) {
 	const config = await loadConfig(options.config);
-	const { configPath, migrationsDir, appMigrationsDir, appMigrationsRelative, refsDir } = resolveMigrationPaths(options.config, config);
+	const { configPath, migrationsDir, appMigrationsRelative, refsDir } = resolveMigrationPaths(options.config, config);
 	const dbConnection = options.db ?? config.db?.connection;
 	if (!dbConnection) return notOk(errorDatabaseConnectionRequired({
 		why: `Database connection is required for migrate (set db.connection in ${configPath}, or pass --db <url>)`,
@@ -34,27 +33,7 @@ async function executeMigrateCommand(options, flags, ui, startTime) {
 	}));
 	if (!config.driver) return notOk(errorDriverRequired({ why: "Config.driver is required for migrate" }));
 	if (!targetSupportsMigrations(config.target)) return notOk(errorTargetMigrationNotSupported({ why: `Target "${config.target.id}" does not support migrations` }));
-	let refEntry;
 	const toArg = options.to;
-	if (toArg) try {
-		const refs = await readRefs(refsDir);
-		const { graph } = await loadMigrationPackages(appMigrationsDir);
-		const refResult = parseContractRef(toArg, {
-			graph,
-			refs
-		});
-		if (!refResult.ok) return notOk(mapRefResolutionError(refResult.failure));
-		if (refResult.value.provenance.kind === "ref") {
-			const resolved = refs[refResult.value.provenance.refName];
-			if (resolved) refEntry = resolved;
-		} else refEntry = {
-			hash: refResult.value.hash,
-			invariants: []
-		};
-	} catch (error) {
-		if (MigrationToolsError.is(error)) return notOk(mapMigrationToolsError(error));
-		throw error;
-	}
 	const stack = createControlStack(config);
 	const familyInstance = config.family.create(stack);
 	const contractPathAbsolute = resolveContractPath(config);
@@ -74,6 +53,38 @@ async function executeMigrateCommand(options, flags, ui, startTime) {
 	} catch (error) {
 		return notOk(errorContractValidationFailed(`Contract at ${contractPathAbsolute} failed to deserialize: ${error instanceof Error ? error.message : String(error)}`, { where: { path: contractPathAbsolute } }));
 	}
+	const loadedAggregate = await loadContractSpaceAggregateForCli({
+		targetId: config.target.targetId,
+		migrationsDir,
+		appContract: contractRaw,
+		extensionPacks: config.extensionPacks ?? [],
+		deserializeContract: (json) => familyInstance.deserializeContract(json)
+	});
+	if (!loadedAggregate.ok) return notOk(loadedAggregate.failure);
+	const aggregate = loadedAggregate.value;
+	const integrityFailure = refuseContractSpaceIntegrity(aggregate, {
+		declaredExtensions: toDeclaredExtensionsFromRaw(config.extensionPacks ?? []),
+		checkContracts: true
+	});
+	if (integrityFailure) return notOk(integrityFailure);
+	let refEntry;
+	let refName;
+	if (toArg) {
+		const refs = aggregate.app.refs;
+		const refResult = parseContractRef(toArg, {
+			graph: aggregate.app.graph(),
+			refs
+		});
+		if (!refResult.ok) return notOk(mapRefResolutionError(refResult.failure));
+		if (refResult.value.provenance.kind === "ref") {
+			refName = refResult.value.provenance.refName;
+			const resolved = refs[refName];
+			if (resolved) refEntry = resolved;
+		} else refEntry = {
+			hash: refResult.value.hash,
+			invariants: []
+		};
+	}
 	if (!flags.json && !flags.quiet) {
 		const details = [{
 			label: "config",
@@ -99,13 +110,7 @@ async function executeMigrateCommand(options, flags, ui, startTime) {
 		});
 		ui.stderr(header);
 	}
-	let appPackages;
-	try {
-		appPackages = await loadMigrationPackages(appMigrationsDir);
-	} catch (error) {
-		if (MigrationToolsError.is(error)) return notOk(mapMigrationToolsError(error));
-		throw error;
-	}
+	const appGraph = aggregate.app.graph();
 	const client = createControlClient({
 		family: config.family,
 		target: config.target,
@@ -116,10 +121,9 @@ async function executeMigrateCommand(options, flags, ui, startTime) {
 	try {
 		await client.connect(dbConnection);
 		const appMarker = (await client.readAllMarkers()).get("app") ?? null;
-		const { graph } = appPackages;
-		if (appMarker !== null && !isGraphNode(appMarker.storageHash, graph)) return notOk(errorMarkerMismatch(appMarker.storageHash, [...graph.nodes].sort(), findLatestMigration(graph)?.to ?? null));
+		if (appMarker !== null && !isGraphNode(appMarker.storageHash, appGraph)) return notOk(errorMarkerMismatch(appMarker.storageHash, [...appGraph.nodes].sort(), findLatestMigration(appGraph)?.to ?? null));
 		if (refEntry && refEntry.invariants.length > 0) {
-			const declared = collectDeclaredInvariants(appPackages.graph);
+			const declared = collectDeclaredInvariants(appGraph);
 			const known = new Set(declared);
 			for (const id of appMarker?.invariants ?? []) known.add(id);
 			const unknown = refEntry.invariants.filter((id) => !known.has(id));
@@ -130,10 +134,23 @@ async function executeMigrateCommand(options, flags, ui, startTime) {
 			})));
 		}
 		if (!flags.quiet && !flags.json) ui.step("Loading contract spaces…");
+		let applyContract = contractRaw;
+		let snapshotContractJson = JSON.parse(contractContent);
+		let snapshotContractDts;
+		if (toArg && refEntry) {
+			const targetHash = refEntry.hash;
+			if (aggregate.app.packages.find((p) => p.metadata.to === targetHash)) try {
+				const at = await aggregate.app.contractAt(targetHash, refName !== void 0 ? { refName } : void 0);
+				applyContract = at.contract;
+				snapshotContractJson = at.contractJson;
+				snapshotContractDts = at.contractDts;
+			} catch (error) {
+				return mapContractAtError(error, { artifactRole: "to" });
+			}
+		}
 		const applyResult = await client.migrationApply({
-			contract: contractRaw,
+			contract: applyContract,
 			migrationsDir,
-			appMigrationPackages: appPackages.bundles,
 			...ifDefined("refHash", refEntry?.hash),
 			...refEntry?.invariants ? { refInvariants: refEntry.invariants } : {},
 			...refEntry !== void 0 ? ifDefined("refName", toArg) : {}
@@ -141,33 +158,15 @@ async function executeMigrateCommand(options, flags, ui, startTime) {
 		if (!applyResult.ok) return notOk(mapApplyFailure(applyResult.failure));
 		const { value } = applyResult;
 		let advancedRef = null;
-		if (options.advanceRef !== void 0) {
-			let contractJsonPathForSnapshot = contractPathAbsolute;
-			let contractJsonForSnapshot = JSON.parse(contractContent);
-			if (toArg && refEntry) {
-				const matchingBundle = appPackages.bundles.find((p) => p.metadata.to === refEntry.hash);
-				if (matchingBundle) {
-					const endContractPath = join(matchingBundle.dirPath, "end-contract.json");
-					contractJsonPathForSnapshot = endContractPath;
-					try {
-						const raw = await readFile(endContractPath, "utf-8");
-						contractJsonForSnapshot = JSON.parse(raw);
-					} catch (error) {
-						if (error instanceof Error && error.code === "ENOENT") return notOk(errorFileNotFound(endContractPath, {
-							why: `Bundle end-contract not found at ${endContractPath}`,
-							fix: "Re-emit the migration bundle or pick a different --to target."
-						}));
-						throw error;
-					}
-				}
-			}
-			try {
-				const contractIR = await readContractIR(contractJsonForSnapshot, contractJsonPathForSnapshot);
-				advancedRef = await executeRefAdvancement(refsDir, options.advanceRef, value.markerHash, contractIR);
-			} catch (error) {
-				if (MigrationToolsError.is(error)) return notOk(mapMigrationToolsError(error));
-				throw error;
-			}
+		if (options.advanceRef !== void 0) try {
+			const contractIR = snapshotContractDts !== void 0 ? {
+				contract: snapshotContractJson,
+				contractDts: snapshotContractDts
+			} : await readContractIR(snapshotContractJson, contractPathAbsolute);
+			advancedRef = await executeRefAdvancement(refsDir, options.advanceRef, value.markerHash, contractIR);
+		} catch (error) {
+			if (MigrationToolsError.is(error)) return notOk(mapMigrationToolsError(error));
+			throw error;
 		}
 		return ok({
 			ok: true,

package/dist/commands/migrate.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"migrate.mjs","names":[],"sources":["../../src/commands/migrate.ts"],"sourcesContent":["import { readFile } from 'node:fs/promises';\nimport type { Contract } from '@prisma-next/contract/types';\nimport { createControlStack } from '@prisma-next/framework-components/control';\nimport { errorUnknownInvariant, MigrationToolsError } from '@prisma-next/migration-tools/errors';\nimport { findLatestMigration, isGraphNode } from '@prisma-next/migration-tools/migration-graph';\nimport { parseContractRef } from '@prisma-next/migration-tools/ref-resolution';\nimport type { RefEntry } from '@prisma-next/migration-tools/refs';\nimport { readRefs } from '@prisma-next/migration-tools/refs';\nimport { ifDefined } from '@prisma-next/utils/defined';\nimport { notOk, ok, type Result } from '@prisma-next/utils/result';\nimport { Command } from 'commander';\nimport { join } from 'pathe';\nimport { loadConfig } from '../config-loader';\nimport { createControlClient } from '../control-api/client';\nimport type {\n  AggregatePerSpaceExecutionEntry,\n  MigrationApplyFailure,\n  MigrationApplyPathDecision,\n} from '../control-api/types';\nimport {\n  CliStructuredError,\n  type CliStructuredError as CliStructuredErrorType,\n  errorContractValidationFailed,\n  errorDatabaseConnectionRequired,\n  errorDriverRequired,\n  errorFileNotFound,\n  errorMarkerMismatch,\n  errorPathUnreachable,\n  errorRuntime,\n  errorTargetMigrationNotSupported,\n  errorUnexpected,\n  mapMigrationToolsError,\n  mapRefResolutionError,\n} from '../utils/cli-errors';\nimport {\n  addGlobalOptions,\n  collectDeclaredInvariants,\n  loadMigrationPackages,\n  maskConnectionUrl,\n  resolveContractPath,\n  resolveMigrationPaths,\n  setCommandDescriptions,\n  setCommandExamples,\n  targetSupportsMigrations,\n} from '../utils/command-helpers';\nimport { formatMigrationApplyCommandOutput } from '../utils/formatters/migrations';\nimport { formatStyledHeader } from '../utils/formatters/styled';\nimport type { CommonCommandOptions } from '../utils/global-flags';\nimport { type GlobalFlags, parseGlobalFlagsOrExit } from '../utils/global-flags';\nimport { executeRefAdvancement, readContractIR } from '../utils/ref-advancement';\nimport { handleResult } from '../utils/result-handler';\nimport { createTerminalUI, type TerminalUI } from '../utils/terminal-ui';\n\ninterface MigrateCommandOptions extends CommonCommandOptions {\n  readonly db?: string;\n  readonly config?: string;\n  readonly to?: string;\n  readonly advanceRef?: string;\n}\n\nexport interface MigrateResult {\n  readonly ok: boolean;\n  readonly migrationsApplied: number;\n  readonly migrationsTotal: number;\n  readonly markerHash: string;\n  readonly applied: readonly {\n    readonly spaceId: string;\n    readonly dirName: string;\n    readonly migrationHash: string;\n    readonly from: string;\n    readonly to: string;\n    readonly operationsExecuted: number;\n  }[];\n  readonly summary: string;\n  readonly perSpace: readonly AggregatePerSpaceExecutionEntry[];\n  readonly pathDecision?: MigrationApplyPathDecision;\n  readonly timings: {\n    readonly total: number;\n  };\n  readonly advancedRef?: { readonly name: string; readonly hash: string } | null;\n}\n\nfunction mapApplyFailure(failure: MigrationApplyFailure): CliStructuredErrorType {\n  if (failure.code === 'MIGRATION_PATH_NOT_FOUND') {\n    return errorPathUnreachable(failure);\n  }\n  return errorRuntime(failure.summary, {\n    why: failure.why ?? 'Migration runner failed',\n    fix: 'Fix the issue and re-run `prisma-next migrate --to <contract>` — previously applied migrations are preserved.',\n    meta: failure.meta ?? {},\n  });\n}\n\nasync function executeMigrateCommand(\n  options: MigrateCommandOptions,\n  flags: GlobalFlags,\n  ui: TerminalUI,\n  startTime: number,\n): Promise<Result<MigrateResult, CliStructuredErrorType>> {\n  const config = await loadConfig(options.config);\n  const { configPath, migrationsDir, appMigrationsDir, appMigrationsRelative, refsDir } =\n    resolveMigrationPaths(options.config, config);\n\n  const dbConnection = options.db ?? config.db?.connection;\n  if (!dbConnection) {\n    return notOk(\n      errorDatabaseConnectionRequired({\n        why: `Database connection is required for migrate (set db.connection in ${configPath}, or pass --db <url>)`,\n        commandName: 'migrate',\n      }),\n    );\n  }\n\n  if (!config.driver) {\n    return notOk(\n      errorDriverRequired({\n        why: 'Config.driver is required for migrate',\n      }),\n    );\n  }\n\n  if (!targetSupportsMigrations(config.target)) {\n    return notOk(\n      errorTargetMigrationNotSupported({\n        why: `Target \"${config.target.id}\" does not support migrations`,\n      }),\n    );\n  }\n\n  let refEntry: RefEntry | undefined;\n  const toArg = options.to;\n\n  if (toArg) {\n    try {\n      const refs = await readRefs(refsDir);\n      const { graph } = await loadMigrationPackages(appMigrationsDir);\n      const refResult = parseContractRef(toArg, { graph, refs });\n      if (!refResult.ok) {\n        return notOk(mapRefResolutionError(refResult.failure));\n      }\n      if (refResult.value.provenance.kind === 'ref') {\n        const resolved = refs[refResult.value.provenance.refName];\n        if (resolved) refEntry = resolved;\n      } else {\n        refEntry = { hash: refResult.value.hash, invariants: [] };\n      }\n    } catch (error) {\n      if (MigrationToolsError.is(error)) {\n        return notOk(mapMigrationToolsError(error));\n      }\n      throw error;\n    }\n  }\n\n  // Construct the family instance up-front so the on-disk contract read\n  // crosses the serializer seam (`familyInstance.deserializeContract`) at\n  // the read site. The downstream `client.migrationApply({ contract })`\n  // re-validates internally (no harm — validation is idempotent), but\n  // closing the gap at the read site is what makes the cast-pattern\n  // lint enforceable and matches the other CLI commands. See TML-2536.\n  const stack = createControlStack(config);\n  const familyInstance = config.family.create(stack);\n\n  const contractPathAbsolute = resolveContractPath(config);\n  let contractRaw: Contract;\n  let contractContent: string;\n  try {\n    contractContent = await readFile(contractPathAbsolute, 'utf-8');\n  } catch (error) {\n    if (error instanceof Error && (error as { code?: string }).code === 'ENOENT') {\n      return notOk(\n        errorFileNotFound(contractPathAbsolute, {\n          why: `Contract file not found at ${contractPathAbsolute}`,\n          fix: 'Run `prisma-next contract emit` to generate a valid contract.json, then retry.',\n        }),\n      );\n    }\n    return notOk(\n      errorContractValidationFailed(\n        `Failed to read contract file: ${error instanceof Error ? error.message : String(error)}`,\n        { where: { path: contractPathAbsolute } },\n      ),\n    );\n  }\n  try {\n    contractRaw = familyInstance.deserializeContract(JSON.parse(contractContent) as unknown);\n  } catch (error) {\n    return notOk(\n      errorContractValidationFailed(\n        `Contract at ${contractPathAbsolute} failed to deserialize: ${error instanceof Error ? error.message : String(error)}`,\n        { where: { path: contractPathAbsolute } },\n      ),\n    );\n  }\n\n  if (!flags.json && !flags.quiet) {\n    const details: Array<{ label: string; value: string }> = [\n      { label: 'config', value: configPath },\n      { label: 'migrations', value: appMigrationsRelative },\n    ];\n    if (typeof dbConnection === 'string') {\n      details.push({\n        label: 'database',\n        value: maskConnectionUrl(dbConnection),\n      });\n    }\n    if (toArg) {\n      details.push({ label: 'to', value: toArg });\n    }\n    const header = formatStyledHeader({\n      command: 'migrate',\n      description: 'Apply planned migrations to advance the database',\n      url: 'https://pris.ly/migrate',\n      details,\n      flags,\n    });\n    ui.stderr(header);\n  }\n\n  let appPackages: Awaited<ReturnType<typeof loadMigrationPackages>>;\n  try {\n    appPackages = await loadMigrationPackages(appMigrationsDir);\n  } catch (error) {\n    if (MigrationToolsError.is(error)) {\n      return notOk(mapMigrationToolsError(error));\n    }\n    throw error;\n  }\n\n  const client = createControlClient({\n    family: config.family,\n    target: config.target,\n    adapter: config.adapter,\n    driver: config.driver,\n    extensionPacks: config.extensionPacks ?? [],\n  });\n\n  try {\n    await client.connect(dbConnection);\n\n    const allMarkers = await client.readAllMarkers();\n    const appMarker = allMarkers.get('app') ?? null;\n    const { graph } = appPackages;\n\n    if (appMarker !== null && !isGraphNode(appMarker.storageHash, graph)) {\n      return notOk(\n        errorMarkerMismatch(\n          appMarker.storageHash,\n          [...graph.nodes].sort(),\n          findLatestMigration(graph)?.to ?? null,\n        ),\n      );\n    }\n\n    if (refEntry && refEntry.invariants.length > 0) {\n      const declared = collectDeclaredInvariants(appPackages.graph);\n      const known = new Set<string>(declared);\n      for (const id of appMarker?.invariants ?? []) known.add(id);\n      const unknown = refEntry.invariants.filter((id) => !known.has(id));\n      if (unknown.length > 0) {\n        return notOk(\n          mapMigrationToolsError(\n            errorUnknownInvariant({\n              ...ifDefined('refName', toArg),\n              unknown,\n              declared: [...declared].sort(),\n            }),\n          ),\n        );\n      }\n    }\n\n    if (!flags.quiet && !flags.json) {\n      ui.step('Loading contract spaces…');\n    }\n\n    const applyResult = await client.migrationApply({\n      contract: contractRaw,\n      migrationsDir,\n      appMigrationPackages: appPackages.bundles,\n      ...ifDefined('refHash', refEntry?.hash),\n      ...(refEntry?.invariants ? { refInvariants: refEntry.invariants } : {}),\n      ...(refEntry !== undefined ? ifDefined('refName', toArg) : {}),\n    });\n\n    if (!applyResult.ok) {\n      return notOk(mapApplyFailure(applyResult.failure));\n    }\n\n    const { value } = applyResult;\n\n    let advancedRef: { name: string; hash: string } | null = null;\n    if (options.advanceRef !== undefined) {\n      let contractJsonPathForSnapshot = contractPathAbsolute;\n      let contractJsonForSnapshot: Record<string, unknown> = JSON.parse(contractContent) as Record<\n        string,\n        unknown\n      >;\n      if (toArg && refEntry) {\n        const matchingBundle = appPackages.bundles.find((p) => p.metadata.to === refEntry.hash);\n        if (matchingBundle) {\n          const endContractPath = join(matchingBundle.dirPath, 'end-contract.json');\n          contractJsonPathForSnapshot = endContractPath;\n          try {\n            const raw = await readFile(endContractPath, 'utf-8');\n            contractJsonForSnapshot = JSON.parse(raw) as Record<string, unknown>;\n          } catch (error) {\n            if (error instanceof Error && (error as { code?: string }).code === 'ENOENT') {\n              return notOk(\n                errorFileNotFound(endContractPath, {\n                  why: `Bundle end-contract not found at ${endContractPath}`,\n                  fix: 'Re-emit the migration bundle or pick a different --to target.',\n                }),\n              );\n            }\n            throw error;\n          }\n        }\n      }\n      try {\n        const contractIR = await readContractIR(\n          contractJsonForSnapshot,\n          contractJsonPathForSnapshot,\n        );\n        advancedRef = await executeRefAdvancement(\n          refsDir,\n          options.advanceRef,\n          value.markerHash,\n          contractIR,\n        );\n      } catch (error) {\n        if (MigrationToolsError.is(error)) {\n          return notOk(mapMigrationToolsError(error));\n        }\n        throw error;\n      }\n    }\n\n    return ok({\n      ok: true,\n      migrationsApplied: value.migrationsApplied,\n      migrationsTotal: value.perSpace.length,\n      markerHash: value.markerHash,\n      applied: value.applied,\n      summary: value.summary,\n      perSpace: value.perSpace,\n      ...ifDefined('pathDecision', value.pathDecision),\n      timings: { total: Date.now() - startTime },\n      advancedRef,\n    });\n  } catch (error) {\n    if (CliStructuredError.is(error)) {\n      return notOk(error);\n    }\n    if (MigrationToolsError.is(error)) {\n      return notOk(mapMigrationToolsError(error));\n    }\n    return notOk(\n      errorUnexpected(error instanceof Error ? error.message : String(error), {\n        why: `Unexpected error during migrate: ${error instanceof Error ? error.message : String(error)}`,\n      }),\n    );\n  } finally {\n    await client.close();\n  }\n}\n\nexport function createMigrateCommand(): Command {\n  const command = new Command('migrate');\n  setCommandDescriptions(\n    command,\n    'Apply planned migrations to advance the database',\n    'Walks every contract space (app + extensions) and applies pending\\n' +\n      'on-disk migrations in canonical order (extensions alphabetically,\\n' +\n      'then app). Graph-walks the on-disk migration graph for every space.\\n' +\n      'Use --to to target a specific contract (hash, ref name, migration dir).',\n  );\n  setCommandExamples(command, [\n    'prisma-next migrate --db $DATABASE_URL',\n    'prisma-next migrate --to production --db $DATABASE_URL',\n    'prisma-next migrate --to sha256:abc123 --db $DATABASE_URL',\n  ]);\n  addGlobalOptions(command)\n    .option('--db <url>', 'Database connection string')\n    .option('--config <path>', 'Path to prisma-next.config.ts')\n    .option(\n      '--to <contract>',\n      'Target contract reference (hash, prefix, ref name, migration dir name, <dir>^, or ./path)',\n    )\n    .option('--advance-ref <name>', 'Advance the named ref to the post-apply marker after success')\n    .action(async (options: MigrateCommandOptions) => {\n      const flags = parseGlobalFlagsOrExit(options);\n      const startTime = Date.now();\n\n      const ui = createTerminalUI(flags);\n\n      const result = await executeMigrateCommand(options, flags, ui, startTime);\n\n      const exitCode = handleResult(result, flags, ui, (migrateResult) => {\n        if (flags.json) {\n          ui.output(JSON.stringify(migrateResult, null, 2));\n        } else if (!flags.quiet) {\n          ui.log(formatMigrationApplyCommandOutput(migrateResult, flags));\n        }\n      });\n\n      process.exit(exitCode);\n    });\n\n  return command;\n}\n"],"mappings":"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"}
+{"version":3,"file":"migrate.mjs","names":[],"sources":["../../src/commands/migrate.ts"],"sourcesContent":["import { readFile } from 'node:fs/promises';\nimport type { Contract } from '@prisma-next/contract/types';\nimport { createControlStack } from '@prisma-next/framework-components/control';\nimport { errorUnknownInvariant, MigrationToolsError } from '@prisma-next/migration-tools/errors';\nimport { findLatestMigration, isGraphNode } from '@prisma-next/migration-tools/migration-graph';\nimport { parseContractRef } from '@prisma-next/migration-tools/ref-resolution';\nimport type { RefEntry } from '@prisma-next/migration-tools/refs';\nimport { ifDefined } from '@prisma-next/utils/defined';\nimport { notOk, ok, type Result } from '@prisma-next/utils/result';\nimport { Command } from 'commander';\nimport { loadConfig } from '../config-loader';\nimport { createControlClient } from '../control-api/client';\nimport type {\n  MigrationApplyFailure,\n  MigrationApplyPathDecision,\n  PerSpaceExecutionEntry,\n} from '../control-api/types';\nimport {\n  CliStructuredError,\n  type CliStructuredError as CliStructuredErrorType,\n  errorContractValidationFailed,\n  errorDatabaseConnectionRequired,\n  errorDriverRequired,\n  errorFileNotFound,\n  errorMarkerMismatch,\n  errorPathUnreachable,\n  errorRuntime,\n  errorTargetMigrationNotSupported,\n  errorUnexpected,\n  mapMigrationToolsError,\n  mapRefResolutionError,\n} from '../utils/cli-errors';\nimport {\n  addGlobalOptions,\n  collectDeclaredInvariants,\n  maskConnectionUrl,\n  resolveContractPath,\n  resolveMigrationPaths,\n  setCommandDescriptions,\n  setCommandExamples,\n  targetSupportsMigrations,\n} from '../utils/command-helpers';\nimport { mapContractAtError } from '../utils/contract-at-errors';\nimport {\n  loadContractSpaceAggregateForCli,\n  refuseContractSpaceIntegrity,\n} from '../utils/contract-space-aggregate-loader';\nimport { toDeclaredExtensionsFromRaw } from '../utils/extension-pack-inputs';\nimport { formatMigrationApplyCommandOutput } from '../utils/formatters/migrations';\nimport { formatStyledHeader } from '../utils/formatters/styled';\nimport type { CommonCommandOptions } from '../utils/global-flags';\nimport { type GlobalFlags, parseGlobalFlagsOrExit } from '../utils/global-flags';\nimport { executeRefAdvancement, readContractIR } from '../utils/ref-advancement';\nimport { handleResult } from '../utils/result-handler';\nimport { createTerminalUI, type TerminalUI } from '../utils/terminal-ui';\n\ninterface MigrateCommandOptions extends CommonCommandOptions {\n  readonly db?: string;\n  readonly config?: string;\n  readonly to?: string;\n  readonly advanceRef?: string;\n}\n\nexport interface MigrateResult {\n  readonly ok: boolean;\n  readonly migrationsApplied: number;\n  readonly migrationsTotal: number;\n  readonly markerHash: string;\n  readonly applied: readonly {\n    readonly spaceId: string;\n    readonly dirName: string;\n    readonly migrationHash: string;\n    readonly from: string;\n    readonly to: string;\n    readonly operationsExecuted: number;\n  }[];\n  readonly summary: string;\n  readonly perSpace: readonly PerSpaceExecutionEntry[];\n  readonly pathDecision?: MigrationApplyPathDecision;\n  readonly timings: {\n    readonly total: number;\n  };\n  readonly advancedRef?: { readonly name: string; readonly hash: string } | null;\n}\n\nfunction mapApplyFailure(failure: MigrationApplyFailure): CliStructuredErrorType {\n  if (failure.code === 'MIGRATION_PATH_NOT_FOUND') {\n    return errorPathUnreachable(failure);\n  }\n  return errorRuntime(failure.summary, {\n    why: failure.why ?? 'Migration runner failed',\n    fix: 'Fix the issue and re-run `prisma-next migrate --to <contract>` — previously applied migrations are preserved.',\n    meta: failure.meta ?? {},\n  });\n}\n\nasync function executeMigrateCommand(\n  options: MigrateCommandOptions,\n  flags: GlobalFlags,\n  ui: TerminalUI,\n  startTime: number,\n): Promise<Result<MigrateResult, CliStructuredErrorType>> {\n  const config = await loadConfig(options.config);\n  const { configPath, migrationsDir, appMigrationsRelative, refsDir } = resolveMigrationPaths(\n    options.config,\n    config,\n  );\n\n  const dbConnection = options.db ?? config.db?.connection;\n  if (!dbConnection) {\n    return notOk(\n      errorDatabaseConnectionRequired({\n        why: `Database connection is required for migrate (set db.connection in ${configPath}, or pass --db <url>)`,\n        commandName: 'migrate',\n      }),\n    );\n  }\n\n  if (!config.driver) {\n    return notOk(\n      errorDriverRequired({\n        why: 'Config.driver is required for migrate',\n      }),\n    );\n  }\n\n  if (!targetSupportsMigrations(config.target)) {\n    return notOk(\n      errorTargetMigrationNotSupported({\n        why: `Target \"${config.target.id}\" does not support migrations`,\n      }),\n    );\n  }\n\n  const toArg = options.to;\n\n  // Construct the family instance up-front so the on-disk contract read\n  // crosses the serializer seam (`familyInstance.deserializeContract`) at\n  // the read site. The downstream `client.migrationApply({ contract })`\n  // re-validates internally (no harm — validation is idempotent), but\n  // closing the gap at the read site is what makes the cast-pattern\n  // lint enforceable and matches the other CLI commands. See TML-2536.\n  const stack = createControlStack(config);\n  const familyInstance = config.family.create(stack);\n\n  const contractPathAbsolute = resolveContractPath(config);\n  let contractRaw: Contract;\n  let contractContent: string;\n  try {\n    contractContent = await readFile(contractPathAbsolute, 'utf-8');\n  } catch (error) {\n    if (error instanceof Error && (error as { code?: string }).code === 'ENOENT') {\n      return notOk(\n        errorFileNotFound(contractPathAbsolute, {\n          why: `Contract file not found at ${contractPathAbsolute}`,\n          fix: 'Run `prisma-next contract emit` to generate a valid contract.json, then retry.',\n        }),\n      );\n    }\n    return notOk(\n      errorContractValidationFailed(\n        `Failed to read contract file: ${error instanceof Error ? error.message : String(error)}`,\n        { where: { path: contractPathAbsolute } },\n      ),\n    );\n  }\n  try {\n    contractRaw = familyInstance.deserializeContract(JSON.parse(contractContent) as unknown);\n  } catch (error) {\n    return notOk(\n      errorContractValidationFailed(\n        `Contract at ${contractPathAbsolute} failed to deserialize: ${error instanceof Error ? error.message : String(error)}`,\n        { where: { path: contractPathAbsolute } },\n      ),\n    );\n  }\n\n  const loadedAggregate = await loadContractSpaceAggregateForCli({\n    targetId: config.target.targetId,\n    migrationsDir,\n    appContract: contractRaw,\n    extensionPacks: config.extensionPacks ?? [],\n    deserializeContract: (json) => familyInstance.deserializeContract(json),\n  });\n  if (!loadedAggregate.ok) {\n    return notOk(loadedAggregate.failure);\n  }\n  const aggregate = loadedAggregate.value;\n  const integrityFailure = refuseContractSpaceIntegrity(aggregate, {\n    declaredExtensions: toDeclaredExtensionsFromRaw(\n      (config.extensionPacks ?? []) as ReadonlyArray<unknown>,\n    ),\n    checkContracts: true,\n  });\n  if (integrityFailure) {\n    return notOk(integrityFailure);\n  }\n\n  let refEntry: RefEntry | undefined;\n  let refName: string | undefined;\n  if (toArg) {\n    const refs = aggregate.app.refs;\n    const refResult = parseContractRef(toArg, { graph: aggregate.app.graph(), refs });\n    if (!refResult.ok) {\n      return notOk(mapRefResolutionError(refResult.failure));\n    }\n    if (refResult.value.provenance.kind === 'ref') {\n      refName = refResult.value.provenance.refName;\n      const resolved = refs[refName];\n      if (resolved) refEntry = resolved;\n    } else {\n      refEntry = { hash: refResult.value.hash, invariants: [] };\n    }\n  }\n\n  if (!flags.json && !flags.quiet) {\n    const details: Array<{ label: string; value: string }> = [\n      { label: 'config', value: configPath },\n      { label: 'migrations', value: appMigrationsRelative },\n    ];\n    if (typeof dbConnection === 'string') {\n      details.push({\n        label: 'database',\n        value: maskConnectionUrl(dbConnection),\n      });\n    }\n    if (toArg) {\n      details.push({ label: 'to', value: toArg });\n    }\n    const header = formatStyledHeader({\n      command: 'migrate',\n      description: 'Apply planned migrations to advance the database',\n      url: 'https://pris.ly/migrate',\n      details,\n      flags,\n    });\n    ui.stderr(header);\n  }\n\n  const appGraph = aggregate.app.graph();\n\n  const client = createControlClient({\n    family: config.family,\n    target: config.target,\n    adapter: config.adapter,\n    driver: config.driver,\n    extensionPacks: config.extensionPacks ?? [],\n  });\n\n  try {\n    await client.connect(dbConnection);\n\n    const allMarkers = await client.readAllMarkers();\n    const appMarker = allMarkers.get('app') ?? null;\n\n    if (appMarker !== null && !isGraphNode(appMarker.storageHash, appGraph)) {\n      return notOk(\n        errorMarkerMismatch(\n          appMarker.storageHash,\n          [...appGraph.nodes].sort(),\n          findLatestMigration(appGraph)?.to ?? null,\n        ),\n      );\n    }\n\n    if (refEntry && refEntry.invariants.length > 0) {\n      const declared = collectDeclaredInvariants(appGraph);\n      const known = new Set<string>(declared);\n      for (const id of appMarker?.invariants ?? []) known.add(id);\n      const unknown = refEntry.invariants.filter((id) => !known.has(id));\n      if (unknown.length > 0) {\n        return notOk(\n          mapMigrationToolsError(\n            errorUnknownInvariant({\n              ...ifDefined('refName', toArg),\n              unknown,\n              declared: [...declared].sort(),\n            }),\n          ),\n        );\n      }\n    }\n\n    if (!flags.quiet && !flags.json) {\n      ui.step('Loading contract spaces…');\n    }\n\n    // When `--to` resolves to an on-disk graph node with a matching bundle,\n    // verify and apply against THAT bundle's destination contract via\n    // `contractAt` — not the emitted `contract.json`. With `--to` omitted,\n    // or a target with no matching bundle, the emitted contract stays the\n    // apply contract (the only migrate-specific default). The same\n    // `contractAt` artifacts feed the optional ref-advancement snapshot.\n    let applyContract: Contract = contractRaw;\n    let snapshotContractJson: Record<string, unknown> = JSON.parse(contractContent);\n    let snapshotContractDts: string | undefined;\n    if (toArg && refEntry) {\n      const targetHash = refEntry.hash;\n      const matchingBundle = aggregate.app.packages.find((p) => p.metadata.to === targetHash);\n      if (matchingBundle) {\n        try {\n          const at = await aggregate.app.contractAt(\n            targetHash,\n            refName !== undefined ? { refName } : undefined,\n          );\n          applyContract = at.contract;\n          snapshotContractJson = at.contractJson as Record<string, unknown>;\n          snapshotContractDts = at.contractDts;\n        } catch (error) {\n          return mapContractAtError(error, { artifactRole: 'to' });\n        }\n      }\n    }\n\n    const applyResult = await client.migrationApply({\n      contract: applyContract,\n      migrationsDir,\n      ...ifDefined('refHash', refEntry?.hash),\n      ...(refEntry?.invariants ? { refInvariants: refEntry.invariants } : {}),\n      ...(refEntry !== undefined ? ifDefined('refName', toArg) : {}),\n    });\n\n    if (!applyResult.ok) {\n      return notOk(mapApplyFailure(applyResult.failure));\n    }\n\n    const { value } = applyResult;\n\n    let advancedRef: { name: string; hash: string } | null = null;\n    if (options.advanceRef !== undefined) {\n      try {\n        const contractIR =\n          snapshotContractDts !== undefined\n            ? { contract: snapshotContractJson, contractDts: snapshotContractDts }\n            : await readContractIR(snapshotContractJson, contractPathAbsolute);\n        advancedRef = await executeRefAdvancement(\n          refsDir,\n          options.advanceRef,\n          value.markerHash,\n          contractIR,\n        );\n      } catch (error) {\n        if (MigrationToolsError.is(error)) {\n          return notOk(mapMigrationToolsError(error));\n        }\n        throw error;\n      }\n    }\n\n    return ok({\n      ok: true,\n      migrationsApplied: value.migrationsApplied,\n      migrationsTotal: value.perSpace.length,\n      markerHash: value.markerHash,\n      applied: value.applied,\n      summary: value.summary,\n      perSpace: value.perSpace,\n      ...ifDefined('pathDecision', value.pathDecision),\n      timings: { total: Date.now() - startTime },\n      advancedRef,\n    });\n  } catch (error) {\n    if (CliStructuredError.is(error)) {\n      return notOk(error);\n    }\n    if (MigrationToolsError.is(error)) {\n      return notOk(mapMigrationToolsError(error));\n    }\n    return notOk(\n      errorUnexpected(error instanceof Error ? error.message : String(error), {\n        why: `Unexpected error during migrate: ${error instanceof Error ? error.message : String(error)}`,\n      }),\n    );\n  } finally {\n    await client.close();\n  }\n}\n\nexport function createMigrateCommand(): Command {\n  const command = new Command('migrate');\n  setCommandDescriptions(\n    command,\n    'Apply planned migrations to advance the database',\n    'Walks every contract space (app + extensions) and applies pending\\n' +\n      'on-disk migrations in canonical order (extensions alphabetically,\\n' +\n      'then app). Graph-walks the on-disk migration graph for every space.\\n' +\n      'Use --to to target a specific contract (hash, ref name, migration dir).',\n  );\n  setCommandExamples(command, [\n    'prisma-next migrate --db $DATABASE_URL',\n    'prisma-next migrate --to production --db $DATABASE_URL',\n    'prisma-next migrate --to sha256:abc123 --db $DATABASE_URL',\n  ]);\n  addGlobalOptions(command)\n    .option('--db <url>', 'Database connection string')\n    .option('--config <path>', 'Path to prisma-next.config.ts')\n    .option(\n      '--to <contract>',\n      'Target contract reference (hash, prefix, ref name, migration dir name, <dir>^, or ./path)',\n    )\n    .option('--advance-ref <name>', 'Advance the named ref to the post-apply marker after success')\n    .action(async (options: MigrateCommandOptions) => {\n      const flags = parseGlobalFlagsOrExit(options);\n      const startTime = Date.now();\n\n      const ui = createTerminalUI(flags);\n\n      const result = await executeMigrateCommand(options, flags, ui, startTime);\n\n      const exitCode = handleResult(result, flags, ui, (migrateResult) => {\n        if (flags.json) {\n          ui.output(JSON.stringify(migrateResult, null, 2));\n        } else if (!flags.quiet) {\n          ui.log(formatMigrationApplyCommandOutput(migrateResult, flags));\n        }\n      });\n\n      process.exit(exitCode);\n    });\n\n  return command;\n}\n"],"mappings":"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"}

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

@@ -1,12 +1,13 @@
 import { Command } from "commander";
-
-//#region src/commands/migration-check.d.ts
+//#region src/utils/integrity-violation-to-check-failure.d.ts
 interface CheckFailure {
   readonly pnCode: string;
   readonly where: string;
   readonly why: string;
   readonly fix: string;
 }
+//#endregion
+//#region src/commands/migration-check.d.ts
 interface MigrationCheckResult {
   readonly ok: boolean;
   readonly failures: readonly CheckFailure[];
@@ -14,5 +15,5 @@ interface MigrationCheckResult {
 }
 declare function createMigrationCheckCommand(): Command;
 //#endregion
-export { CheckFailure, MigrationCheckResult, createMigrationCheckCommand };
+export { type CheckFailure, MigrationCheckResult, createMigrationCheckCommand };
 //# sourceMappingURL=migration-check.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"migration-check.d.mts","names":[],"sources":["../../src/commands/migration-check.ts"],"mappings":";;;UA2BiB,YAAA;EAAA,SACN,MAAA;EAAA,SACA,KAAA;EAAA,SACA,GAAA;EAAA,SACA,GAAA;AAAA;AAAA,UAGM,oBAAA;EAAA,SACN,EAAA;EAAA,SACA,QAAA,WAAmB,YAAA;EAAA,SACnB,OAAA;AAAA;AAAA,iBAmRK,2BAAA,CAAA,GAA+B,OAAA"}
+{"version":3,"file":"migration-check.d.mts","names":[],"sources":["../../src/utils/integrity-violation-to-check-failure.ts","../../src/commands/migration-check.ts"],"mappings":";;UAGiB,YAAA;EAAA,SACN,MAAA;EAAA,SACA,KAAA;EAAA,SACA,GAAA;EAAA,SACA,GAAA;AAAA;;;UCgCM,oBAAA;EAAA,SACN,EAAA;EAAA,SACA,QAAA,WAAmB,YAAY;EAAA,SAC/B,OAAA;AAAA;AAAA,iBAsOK,2BAAA,CAAA,GAA+B,OAAO"}