prisma-next 0.10.0 → 0.11.0-dev.10

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

@@ -1 +1 @@
-{"version":3,"file":"db-sign.mjs","names":[],"sources":["../../src/commands/db-sign.ts"],"sourcesContent":["import { readFile } from 'node:fs/promises';\nimport type {\n  SignDatabaseResult,\n  VerifyDatabaseSchemaResult,\n} from '@prisma-next/framework-components/control';\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 { notOk, ok, type Result } from '@prisma-next/utils/result';\nimport { Command } from 'commander';\nimport { join, relative, resolve } from 'pathe';\nimport { loadConfig } from '../config-loader';\nimport { createControlClient } from '../control-api/client';\nimport { ContractValidationError } from '../control-api/errors';\nimport {\n  CliStructuredError,\n  errorContractValidationFailed,\n  errorDatabaseConnectionRequired,\n  errorDriverRequired,\n  errorFileNotFound,\n  errorRuntime,\n  errorUnexpected,\n  mapMigrationToolsError,\n  mapRefResolutionError,\n} from '../utils/cli-errors';\nimport {\n  addGlobalOptions,\n  loadMigrationPackages,\n  maskConnectionUrl,\n  resolveContractPath,\n  resolveMigrationPaths,\n  setCommandDescriptions,\n  setCommandExamples,\n} from '../utils/command-helpers';\nimport { formatStyledHeader } from '../utils/formatters/styled';\nimport {\n  formatSchemaVerifyJson,\n  formatSchemaVerifyOutput,\n  formatSignJson,\n  formatSignOutput,\n} from '../utils/formatters/verify';\nimport type { CommonCommandOptions } from '../utils/global-flags';\nimport { type GlobalFlags, parseGlobalFlags } from '../utils/global-flags';\nimport { createProgressAdapter } from '../utils/progress-adapter';\nimport { handleResult } from '../utils/result-handler';\nimport { TerminalUI } from '../utils/terminal-ui';\n\ninterface DbSignOptions extends CommonCommandOptions {\n  readonly db?: string;\n  readonly config?: string;\n  readonly contract?: string;\n}\n\n/**\n * Failure type for db sign command.\n * Either an infrastructure error (CliStructuredError) or a logical failure (schema verification failed).\n */\ntype DbSignFailure = CliStructuredError | VerifyDatabaseSchemaResult;\n\n/**\n * Executes the db sign command and returns a structured Result.\n * Success: SignDatabaseResult (sign happened)\n * Failure: CliStructuredError (infra error) or VerifyDatabaseSchemaResult (schema mismatch)\n */\nasync function executeDbSignCommand(\n  contractArg: string | undefined,\n  options: DbSignOptions,\n  flags: GlobalFlags,\n  ui: TerminalUI,\n): Promise<Result<SignDatabaseResult, DbSignFailure>> {\n  const config = await loadConfig(options.config);\n  const configPath = options.config\n    ? relative(process.cwd(), resolve(options.config))\n    : 'prisma-next.config.ts';\n  const contractPathAbsolute = resolveContractPath(config);\n  const contractPath = relative(process.cwd(), contractPathAbsolute);\n\n  const effectiveContractArg = contractArg ?? options.contract;\n\n  if (!flags.json && !flags.quiet) {\n    const details: Array<{ label: string; value: string }> = [\n      { label: 'config', value: configPath },\n      { label: 'contract', value: effectiveContractArg ?? contractPath },\n    ];\n    if (options.db) {\n      details.push({ label: 'database', value: maskConnectionUrl(options.db) });\n    }\n    const header = formatStyledHeader({\n      command: 'db sign',\n      description: 'Sign the database with your contract so you can safely run queries',\n      url: 'https://pris.ly/db-sign',\n      details,\n      flags,\n    });\n    ui.stderr(header);\n  }\n\n  let contractJson: Record<string, unknown>;\n\n  if (effectiveContractArg) {\n    try {\n      const { appMigrationsDir, refsDir } = resolveMigrationPaths(options.config, config);\n      const { bundles, graph } = await loadMigrationPackages(appMigrationsDir);\n      const refs = await readRefs(refsDir);\n      const refResult = parseContractRef(effectiveContractArg, { 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        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      } else {\n        const defaultRaw = await readFile(contractPathAbsolute, 'utf-8');\n        const defaultContract = JSON.parse(defaultRaw) as Record<string, unknown>;\n        const storageHash = (defaultContract['storage'] as Record<string, unknown> | undefined)?.[\n          'storageHash'\n        ];\n        if (storageHash === targetHash) {\n          contractJson = defaultContract;\n        } else {\n          return notOk(\n            errorRuntime(`No contract file found for hash \"${targetHash}\"`, {\n              why: `Resolved contract reference \"${effectiveContractArg}\" to hash \"${targetHash}\" but no migration produces that hash and the emitted contract does not match.`,\n              fix: 'Ensure the target contract exists on disk — either as a migration endpoint or as the emitted contract.json.',\n            }),\n          );\n        }\n      }\n    } catch (error) {\n      if (MigrationToolsError.is(error)) return notOk(mapMigrationToolsError(error));\n      if (error instanceof CliStructuredError) return notOk(error);\n      return notOk(\n        errorUnexpected(error instanceof Error ? error.message : String(error), {\n          why: `Failed to resolve contract reference: ${error instanceof Error ? error.message : String(error)}`,\n        }),\n      );\n    }\n  } else {\n    let contractJsonContent: string;\n    try {\n      contractJsonContent = 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 ${contractPath}, or update \\`config.contract.output\\` in ${configPath}`,\n          }),\n        );\n      }\n      return notOk(\n        errorUnexpected(error instanceof Error ? error.message : String(error), {\n          why: `Failed to read contract file: ${error instanceof Error ? error.message : String(error)}`,\n        }),\n      );\n    }\n\n    try {\n      contractJson = JSON.parse(contractJsonContent) as Record<string, unknown>;\n    } catch (error) {\n      return notOk(\n        errorContractValidationFailed(\n          `Contract JSON is invalid: ${error instanceof Error ? error.message : String(error)}`,\n          { where: { path: contractPathAbsolute } },\n        ),\n      );\n    }\n  }\n\n  // Resolve database connection (--db flag or config.db.connection)\n  const dbConnection = options.db ?? config.db?.connection;\n  if (!dbConnection) {\n    return notOk(\n      errorDatabaseConnectionRequired({\n        why: `Database connection is required for db sign (set db.connection in ${configPath}, or pass --db <url>)`,\n        commandName: 'db sign',\n      }),\n    );\n  }\n\n  // Check for driver\n  if (!config.driver) {\n    return notOk(errorDriverRequired({ why: 'Config.driver is required for db sign' }));\n  }\n\n  // Create control client\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  // Create progress adapter\n  const onProgress = createProgressAdapter({ ui, flags });\n\n  try {\n    // Step 1: Schema verification - connect here\n    const schemaVerifyResult = await client.schemaVerify({\n      contract: contractJson,\n      strict: false,\n      connection: dbConnection,\n      onProgress,\n    });\n\n    // If schema verification failed, return as failure\n    if (!schemaVerifyResult.ok) {\n      return notOk(schemaVerifyResult);\n    }\n\n    // Step 2: Sign (already connected from schemaVerify)\n    const signResult = await client.sign({\n      contract: contractJson,\n      contractPath,\n      configPath,\n      onProgress,\n    });\n\n    return ok(signResult);\n  } catch (error) {\n    // Driver already throws CliStructuredError for connection failures\n    if (error instanceof CliStructuredError) {\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    // Wrap unexpected errors\n    return notOk(\n      errorUnexpected(error instanceof Error ? error.message : String(error), {\n        why: `Unexpected error during db sign: ${error instanceof Error ? error.message : String(error)}`,\n      }),\n    );\n  } finally {\n    await client.close();\n  }\n}\n\nexport function createDbSignCommand(): Command {\n  const command = new Command('sign');\n  setCommandDescriptions(\n    command,\n    'Sign the database with your contract so you can safely run queries',\n    'Verifies that your database schema satisfies the emitted contract, and if so, writes or\\n' +\n      'updates the database signature. This command is idempotent and safe to run\\n' +\n      'in CI/deployment pipelines. The signature records that this database instance is aligned\\n' +\n      'with a specific contract version.',\n  );\n  setCommandExamples(command, [\n    'prisma-next db sign --db $DATABASE_URL',\n    'prisma-next db sign production --db $DATABASE_URL',\n    'prisma-next db sign --contract production --db $DATABASE_URL',\n  ]);\n  addGlobalOptions(command)\n    .argument('[contract]', 'Contract reference (hash, prefix, ref name, or migration dir name)')\n    .option('--db <url>', 'Database connection string')\n    .option('--config <path>', 'Path to prisma-next.config.ts')\n    .option(\n      '--contract <contract>',\n      'Contract reference (hash, prefix, ref name, migration dir name, <dir>^, or ./path)',\n    )\n    .action(async (positionalContract: string | undefined, options: DbSignOptions) => {\n      const flags = parseGlobalFlags(options);\n\n      if (positionalContract && options.contract) {\n        process.stderr.write(\n          'Cannot specify both a positional contract argument and --contract flag.\\n',\n        );\n        process.exit(2);\n        return;\n      }\n\n      const ui = new TerminalUI({ color: flags.color, interactive: flags.interactive });\n\n      const result = await executeDbSignCommand(positionalContract, options, flags, ui);\n\n      if (result.ok) {\n        // Success - format sign output\n        if (flags.json) {\n          ui.output(formatSignJson(result.value));\n        } else {\n          const output = formatSignOutput(result.value, flags);\n          if (output) {\n            ui.log(output);\n          }\n        }\n        process.exit(0);\n      }\n\n      // Failure - determine type and handle appropriately\n      const failure = result.failure;\n\n      if (failure instanceof CliStructuredError) {\n        // Infrastructure error - use standard handler\n        const exitCode = handleResult(result as Result<never, CliStructuredError>, flags, ui);\n        process.exit(exitCode);\n      }\n\n      // Schema verification failed - format and print schema verification output\n      if (flags.json) {\n        ui.output(formatSchemaVerifyJson(failure));\n      } else {\n        const output = formatSchemaVerifyOutput(failure, flags);\n        if (output) {\n          ui.log(output);\n        }\n      }\n      process.exit(1);\n    });\n\n  return command;\n}\n"],"mappings":"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"}
+{"version":3,"file":"db-sign.mjs","names":[],"sources":["../../src/commands/db-sign.ts"],"sourcesContent":["import { readFile } from 'node:fs/promises';\nimport type {\n  SignDatabaseResult,\n  VerifyDatabaseSchemaResult,\n} from '@prisma-next/framework-components/control';\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 { notOk, ok, type Result } from '@prisma-next/utils/result';\nimport { Command } from 'commander';\nimport { join, relative, resolve } from 'pathe';\nimport { loadConfig } from '../config-loader';\nimport { createControlClient } from '../control-api/client';\nimport { ContractValidationError } from '../control-api/errors';\nimport {\n  CliStructuredError,\n  errorContractValidationFailed,\n  errorDatabaseConnectionRequired,\n  errorDriverRequired,\n  errorFileNotFound,\n  errorRuntime,\n  errorUnexpected,\n  mapMigrationToolsError,\n  mapRefResolutionError,\n} from '../utils/cli-errors';\nimport {\n  addGlobalOptions,\n  loadMigrationPackages,\n  maskConnectionUrl,\n  resolveContractPath,\n  resolveMigrationPaths,\n  setCommandDescriptions,\n  setCommandExamples,\n} from '../utils/command-helpers';\nimport { formatStyledHeader } from '../utils/formatters/styled';\nimport {\n  formatSchemaVerifyJson,\n  formatSchemaVerifyOutput,\n  formatSignJson,\n  formatSignOutput,\n} from '../utils/formatters/verify';\nimport type { CommonCommandOptions } from '../utils/global-flags';\nimport { type GlobalFlags, parseGlobalFlagsOrExit } from '../utils/global-flags';\nimport { createProgressAdapter } from '../utils/progress-adapter';\nimport { handleResult } from '../utils/result-handler';\nimport { createTerminalUI, type TerminalUI } from '../utils/terminal-ui';\n\ninterface DbSignOptions extends CommonCommandOptions {\n  readonly db?: string;\n  readonly config?: string;\n  readonly contract?: string;\n}\n\n/**\n * Failure type for db sign command.\n * Either an infrastructure error (CliStructuredError) or a logical failure (schema verification failed).\n */\ntype DbSignFailure = CliStructuredError | VerifyDatabaseSchemaResult;\n\n/**\n * Executes the db sign command and returns a structured Result.\n * Success: SignDatabaseResult (sign happened)\n * Failure: CliStructuredError (infra error) or VerifyDatabaseSchemaResult (schema mismatch)\n */\nasync function executeDbSignCommand(\n  contractArg: string | undefined,\n  options: DbSignOptions,\n  flags: GlobalFlags,\n  ui: TerminalUI,\n): Promise<Result<SignDatabaseResult, DbSignFailure>> {\n  const config = await loadConfig(options.config);\n  const configPath = options.config\n    ? relative(process.cwd(), resolve(options.config))\n    : 'prisma-next.config.ts';\n  const contractPathAbsolute = resolveContractPath(config);\n  const contractPath = relative(process.cwd(), contractPathAbsolute);\n\n  const effectiveContractArg = contractArg ?? options.contract;\n\n  if (!flags.json && !flags.quiet) {\n    const details: Array<{ label: string; value: string }> = [\n      { label: 'config', value: configPath },\n      { label: 'contract', value: effectiveContractArg ?? contractPath },\n    ];\n    if (options.db) {\n      details.push({ label: 'database', value: maskConnectionUrl(options.db) });\n    }\n    const header = formatStyledHeader({\n      command: 'db sign',\n      description: 'Sign the database with your contract so you can safely run queries',\n      url: 'https://pris.ly/db-sign',\n      details,\n      flags,\n    });\n    ui.stderr(header);\n  }\n\n  let contractJson: Record<string, unknown>;\n\n  if (effectiveContractArg) {\n    try {\n      const { appMigrationsDir, refsDir } = resolveMigrationPaths(options.config, config);\n      const { bundles, graph } = await loadMigrationPackages(appMigrationsDir);\n      const refs = await readRefs(refsDir);\n      const refResult = parseContractRef(effectiveContractArg, { 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        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      } else {\n        const defaultRaw = await readFile(contractPathAbsolute, 'utf-8');\n        const defaultContract = JSON.parse(defaultRaw) as Record<string, unknown>;\n        const storageHash = (defaultContract['storage'] as Record<string, unknown> | undefined)?.[\n          'storageHash'\n        ];\n        if (storageHash === targetHash) {\n          contractJson = defaultContract;\n        } else {\n          return notOk(\n            errorRuntime(`No contract file found for hash \"${targetHash}\"`, {\n              why: `Resolved contract reference \"${effectiveContractArg}\" to hash \"${targetHash}\" but no migration produces that hash and the emitted contract does not match.`,\n              fix: 'Ensure the target contract exists on disk — either as a migration endpoint or as the emitted contract.json.',\n            }),\n          );\n        }\n      }\n    } catch (error) {\n      if (MigrationToolsError.is(error)) return notOk(mapMigrationToolsError(error));\n      if (error instanceof CliStructuredError) return notOk(error);\n      return notOk(\n        errorUnexpected(error instanceof Error ? error.message : String(error), {\n          why: `Failed to resolve contract reference: ${error instanceof Error ? error.message : String(error)}`,\n        }),\n      );\n    }\n  } else {\n    let contractJsonContent: string;\n    try {\n      contractJsonContent = 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 ${contractPath}, or update \\`config.contract.output\\` in ${configPath}`,\n          }),\n        );\n      }\n      return notOk(\n        errorUnexpected(error instanceof Error ? error.message : String(error), {\n          why: `Failed to read contract file: ${error instanceof Error ? error.message : String(error)}`,\n        }),\n      );\n    }\n\n    try {\n      contractJson = JSON.parse(contractJsonContent) as Record<string, unknown>;\n    } catch (error) {\n      return notOk(\n        errorContractValidationFailed(\n          `Contract JSON is invalid: ${error instanceof Error ? error.message : String(error)}`,\n          { where: { path: contractPathAbsolute } },\n        ),\n      );\n    }\n  }\n\n  // Resolve database connection (--db flag or config.db.connection)\n  const dbConnection = options.db ?? config.db?.connection;\n  if (!dbConnection) {\n    return notOk(\n      errorDatabaseConnectionRequired({\n        why: `Database connection is required for db sign (set db.connection in ${configPath}, or pass --db <url>)`,\n        commandName: 'db sign',\n      }),\n    );\n  }\n\n  // Check for driver\n  if (!config.driver) {\n    return notOk(errorDriverRequired({ why: 'Config.driver is required for db sign' }));\n  }\n\n  // Create control client\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  // Create progress adapter\n  const onProgress = createProgressAdapter({ ui, flags });\n\n  try {\n    // Step 1: Schema verification - connect here\n    const schemaVerifyResult = await client.schemaVerify({\n      contract: contractJson,\n      strict: false,\n      connection: dbConnection,\n      onProgress,\n    });\n\n    // If schema verification failed, return as failure\n    if (!schemaVerifyResult.ok) {\n      return notOk(schemaVerifyResult);\n    }\n\n    // Step 2: Sign (already connected from schemaVerify)\n    const signResult = await client.sign({\n      contract: contractJson,\n      contractPath,\n      configPath,\n      onProgress,\n    });\n\n    return ok(signResult);\n  } catch (error) {\n    // Driver already throws CliStructuredError for connection failures\n    if (error instanceof CliStructuredError) {\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    // Wrap unexpected errors\n    return notOk(\n      errorUnexpected(error instanceof Error ? error.message : String(error), {\n        why: `Unexpected error during db sign: ${error instanceof Error ? error.message : String(error)}`,\n      }),\n    );\n  } finally {\n    await client.close();\n  }\n}\n\nexport function createDbSignCommand(): Command {\n  const command = new Command('sign');\n  setCommandDescriptions(\n    command,\n    'Sign the database with your contract so you can safely run queries',\n    'Verifies that your database schema satisfies the emitted contract, and if so, writes or\\n' +\n      'updates the database signature. This command is idempotent and safe to run\\n' +\n      'in CI/deployment pipelines. The signature records that this database instance is aligned\\n' +\n      'with a specific contract version.',\n  );\n  setCommandExamples(command, [\n    'prisma-next db sign --db $DATABASE_URL',\n    'prisma-next db sign production --db $DATABASE_URL',\n    'prisma-next db sign --contract production --db $DATABASE_URL',\n  ]);\n  addGlobalOptions(command)\n    .argument('[contract]', 'Contract reference (hash, prefix, ref name, or migration dir name)')\n    .option('--db <url>', 'Database connection string')\n    .option('--config <path>', 'Path to prisma-next.config.ts')\n    .option(\n      '--contract <contract>',\n      'Contract reference (hash, prefix, ref name, migration dir name, <dir>^, or ./path)',\n    )\n    .action(async (positionalContract: string | undefined, options: DbSignOptions) => {\n      const flags = parseGlobalFlagsOrExit(options);\n\n      if (positionalContract && options.contract) {\n        process.stderr.write(\n          'Cannot specify both a positional contract argument and --contract flag.\\n',\n        );\n        process.exit(2);\n        return;\n      }\n\n      const ui = createTerminalUI(flags);\n\n      const result = await executeDbSignCommand(positionalContract, options, flags, ui);\n\n      if (result.ok) {\n        // Success - format sign output\n        if (flags.json) {\n          ui.output(formatSignJson(result.value));\n        } else {\n          const output = formatSignOutput(result.value, flags);\n          if (output) {\n            ui.log(output);\n          }\n        }\n        process.exit(0);\n      }\n\n      // Failure - determine type and handle appropriately\n      const failure = result.failure;\n\n      if (failure instanceof CliStructuredError) {\n        // Infrastructure error - use standard handler\n        const exitCode = handleResult(result as Result<never, CliStructuredError>, flags, ui);\n        process.exit(exitCode);\n      }\n\n      // Schema verification failed - format and print schema verification output\n      if (flags.json) {\n        ui.output(formatSchemaVerifyJson(failure));\n      } else {\n        const output = formatSchemaVerifyOutput(failure, flags);\n        if (output) {\n          ui.log(output);\n        }\n      }\n      process.exit(1);\n    });\n\n  return command;\n}\n"],"mappings":"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"}

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

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

package/dist/commands/db-update.mjs

@@ -1,29 +1,32 @@
-import { _ as errorUnexpected, a as errorContractValidationFailed, f as errorMigrationPlanningFailed, n as ERROR_CODE_DESTRUCTIVE_CHANGES, p as errorRunnerFailed, s as errorDestructiveChanges, t as CliStructuredError, v as mapMigrationToolsError, y as mapRefResolutionError } from "../cli-errors-CF60g2cG.mjs";
-import { _ as parseGlobalFlags, a as loadMigrationPackages, d as setCommandDescriptions, f as setCommandExamples, l as resolveMigrationPaths, u as sanitizeErrorMessage } from "../command-helpers-D3vL5yi8.mjs";
-import { t as handleResult } from "../result-handler-Bm_6dDYg.mjs";
-import { t as TerminalUI } from "../terminal-ui-XtOQsqe9.mjs";
-import { a as ContractValidationError } from "../client-Brv4qlfB.mjs";
-import { i as formatMigrationPlanOutput, n as formatMigrationApplyOutput, r as formatMigrationJson } from "../migrations-DyUf5lTt.mjs";
-import { n as prepareMigrationContext, t as addMigrationCommandOptions } from "../migration-command-scaffold-CmXXC1UZ.mjs";
+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 { 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 { parseContractRef } from "@prisma-next/migration-tools/ref-resolution";
 import { readRefs } from "@prisma-next/migration-tools/refs";
+import { parseContractRef } from "@prisma-next/migration-tools/ref-resolution";
 //#region src/commands/db-update.ts
 /**
 * Maps a DbUpdateFailure to a CliStructuredError for consistent error handling.
 */
 function mapDbUpdateFailure(failure) {
 	if (failure.code === "PLANNING_FAILED") return errorMigrationPlanningFailed({ conflicts: failure.conflicts ?? [] });
-	if (failure.code === "RUNNER_FAILED") return errorRunnerFailed(failure.summary, {
-		why: failure.why ?? "Migration runner failed",
-		fix: "Inspect the reported conflict, reconcile schema drift if needed, then re-run `prisma-next db update`",
-		...ifDefined("meta", failure.meta)
-	});
+	if (failure.code === "RUNNER_FAILED") {
+		const fix = (typeof failure.meta?.["runnerErrorCode"] === "string" ? failure.meta["runnerErrorCode"] : void 0) === "LEGACY_MARKER_SHAPE" ? "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." : "Inspect the reported conflict, reconcile schema drift if needed, then re-run `prisma-next db update`";
+		return errorRunnerFailed(failure.summary, {
+			why: failure.why ?? "Migration runner failed",
+			fix,
+			...ifDefined("meta", failure.meta)
+		});
+	}
 	if (failure.code === "DESTRUCTIVE_CHANGES") return errorDestructiveChanges(failure.summary, {
 		...ifDefined("why", failure.why),
 		fix: "Re-run with `-y` to apply destructive changes, or use `--dry-run` to preview first",
@@ -44,6 +47,7 @@ async function executeDbUpdateCommand(options, flags, ui, startTime) {
 	if (!ctxResult.ok) return ctxResult;
 	const { client, config, dbConnection, onProgress, contractPathAbsolute } = ctxResult.value;
 	let { contractJson } = ctxResult.value;
+	let contractJsonPathForSnapshot = contractPathAbsolute;
 	const { migrationsDir, appMigrationsDir, refsDir } = resolveMigrationPaths(options.config, config);
 	if (options.to) try {
 		const { bundles, graph } = await loadMigrationPackages(appMigrationsDir);
@@ -59,8 +63,10 @@ async function executeDbUpdateCommand(options, flags, ui, startTime) {
 			why: `The ref resolved successfully but no on-disk migration package has an end-contract hash matching ${targetHash}.`,
 			fix: "Provide a ref or hash that corresponds to an existing migration package, or run `migration list` to see available migrations."
 		}));
-		const raw = await readFile(join(matchingBundle.dirPath, "end-contract.json"), "utf-8");
+		const endContractPath = join(matchingBundle.dirPath, "end-contract.json");
+		const raw = await readFile(endContractPath, "utf-8");
 		contractJson = JSON.parse(raw);
+		contractJsonPathForSnapshot = endContractPath;
 	} catch (error) {
 		if (MigrationToolsError.is(error)) return notOk(mapMigrationToolsError(error));
 		if (CliStructuredError.is(error)) return notOk(error);
@@ -76,6 +82,28 @@ async function executeDbUpdateCommand(options, flags, ui, startTime) {
 			onProgress
 		});
 		if (!result.ok) return notOk(mapDbUpdateFailure(result.failure));
+		const advancementHash = result.value.mode === "apply" ? result.value.marker?.storageHash ?? result.value.destination.storageHash : result.value.destination.storageHash;
+		let refAdvancementFields = {
+			advancedRef: null,
+			plannedAdvanceRef: null
+		};
+		if (computeRefAdvancementName({
+			...ifDefined("advanceRef", options.advanceRef),
+			...ifDefined("db", options.db)
+		}) !== null) try {
+			const contractIR = await readContractIR(contractJson, contractJsonPathForSnapshot);
+			refAdvancementFields = await buildRefAdvancementFields({
+				...ifDefined("advanceRef", options.advanceRef),
+				...ifDefined("db", options.db),
+				refsDir,
+				contractIR,
+				mode: result.value.mode,
+				hash: advancementHash
+			});
+		} catch (error) {
+			if (MigrationToolsError.is(error)) return notOk(mapMigrationToolsError(error));
+			throw error;
+		}
 		return ok({
 			ok: true,
 			mode: result.value.mode,
@@ -101,6 +129,8 @@ async function executeDbUpdateCommand(options, flags, ui, startTime) {
 				...ifDefined("profileHash", result.value.marker.profileHash)
 			} : void 0),
 			...ifDefined("perSpace", result.value.perSpace),
+			advancedRef: refAdvancementFields.advancedRef,
+			plannedAdvanceRef: refAdvancementFields.plannedAdvanceRef,
 			summary: result.value.summary,
 			timings: { total: Date.now() - startTime }
 		});
@@ -119,13 +149,11 @@ function createDbUpdateCommand() {
 	setCommandExamples(command, ["prisma-next db update --db $DATABASE_URL", "prisma-next db update --db $DATABASE_URL --dry-run"]);
 	addMigrationCommandOptions(command);
 	command.option("--to <contract>", "Target contract reference (hash, prefix, ref name, migration dir name, <dir>^, or ./path)");
+	command.option("--advance-ref <name>", "Ref to advance to the post-command contract hash");
 	command.action(async (options) => {
-		const flags = parseGlobalFlags(options);
+		const flags = parseGlobalFlagsOrExit(options);
 		const startTime = Date.now();
-		const ui = new TerminalUI({
-			color: flags.color,
-			interactive: flags.interactive
-		});
+		const ui = createTerminalUI(flags);
 		let result = await executeDbUpdateCommand(options, flags, ui, startTime);
 		if (!result.ok && result.failure.code === ERROR_CODE_DESTRUCTIVE_CHANGES && flags.interactive && !flags.json && !flags.yes) {
 			const destructiveOps = result.failure.meta?.destructiveOperations ?? [];

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, parseGlobalFlags } from '../utils/global-flags';\nimport {\n  addMigrationCommandOptions,\n  prepareMigrationContext,\n} from '../utils/migration-command-scaffold';\nimport { handleResult } from '../utils/result-handler';\nimport { TerminalUI } from '../utils/terminal-ui';\n\ninterface DbUpdateOptions extends MigrationCommandOptions {\n  readonly to?: 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    return errorRunnerFailed(failure.summary, {\n      why: failure.why ?? 'Migration runner failed',\n      fix: 'Inspect the reported conflict, reconcile schema drift if needed, then re-run `prisma-next db update`',\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  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    } 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    // 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      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.action(async (options: DbUpdateOptions) => {\n    const flags = parseGlobalFlags(options);\n    const startTime = Date.now();\n\n    const ui = new TerminalUI({ color: flags.color, interactive: flags.interactive });\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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"}
+{"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":"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"}

package/dist/commands/db-verify.mjs

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

package/dist/commands/migrate.d.mts

@@ -1,4 +1,4 @@
-import { T as MigrationApplyPathDecision, t as AggregatePerSpaceExecutionEntry } from "../types-0aS865QN.mjs";
+import { T as MigrationApplyPathDecision, t as AggregatePerSpaceExecutionEntry } from "../types-UWB2-rrw.mjs";
 import { Command } from "commander";
 
 //#region src/commands/migrate.d.ts
@@ -21,6 +21,10 @@ interface MigrateResult {
   readonly timings: {
     readonly total: number;
   };
+  readonly advancedRef?: {
+    readonly name: string;
+    readonly hash: string;
+  } | null;
 }
 declare function createMigrateCommand(): Command;
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"migrate.d.mts","names":[],"sources":["../../src/commands/migrate.ts"],"mappings":";;;;UAuDiB,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;AAAA;AAAA,iBAkOG,oBAAA,CAAA,GAAwB,OAAA"}
+{"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"}

package/dist/commands/migrate.mjs

@@ -1,20 +1,23 @@
 import { t as loadConfig } from "../config-loader-B6sJjXTv.mjs";
-import { _ as errorUnexpected, a as errorContractValidationFailed, c as errorDriverRequired, h as errorTargetMigrationNotSupported, l as errorFileNotFound, m as errorRuntime, o as errorDatabaseConnectionRequired, t as CliStructuredError, v as mapMigrationToolsError, y as mapRefResolutionError } from "../cli-errors-CF60g2cG.mjs";
-import { _ as parseGlobalFlags, a as loadMigrationPackages, b as formatStyledHeader, c as resolveContractPath, d as setCommandDescriptions, f as setCommandExamples, l as resolveMigrationPaths, m as targetSupportsMigrations, n as collectDeclaredInvariants, o as maskConnectionUrl, t as addGlobalOptions } from "../command-helpers-D3vL5yi8.mjs";
-import { t as handleResult } from "../result-handler-Bm_6dDYg.mjs";
-import { t as TerminalUI } from "../terminal-ui-XtOQsqe9.mjs";
-import { t as createControlClient } from "../client-Brv4qlfB.mjs";
-import { t as formatMigrationApplyCommandOutput } from "../migrations-DyUf5lTt.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 { 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 { parseContractRef } from "@prisma-next/migration-tools/ref-resolution";
 import { readRefs } from "@prisma-next/migration-tools/refs";
+import { parseContractRef } from "@prisma-next/migration-tools/ref-resolution";
 //#region src/commands/migrate.ts
 function mapApplyFailure(failure) {
+	if (failure.code === "MIGRATION_PATH_NOT_FOUND") return errorPathUnreachable(failure);
 	return errorRuntime(failure.summary, {
 		why: failure.why ?? "Migration runner failed",
 		fix: "Fix the issue and re-run `prisma-next migrate --to <contract>` — previously applied migrations are preserved.",
@@ -112,8 +115,10 @@ 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 (refEntry && refEntry.invariants.length > 0) {
-			const appMarker = (await client.readAllMarkers()).get("app") ?? null;
 			const declared = collectDeclaredInvariants(appPackages.graph);
 			const known = new Set(declared);
 			for (const id of appMarker?.invariants ?? []) known.add(id);
@@ -135,6 +140,35 @@ 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;
+			}
+		}
 		return ok({
 			ok: true,
 			migrationsApplied: value.migrationsApplied,
@@ -144,7 +178,8 @@ async function executeMigrateCommand(options, flags, ui, startTime) {
 			summary: value.summary,
 			perSpace: value.perSpace,
 			...ifDefined("pathDecision", value.pathDecision),
-			timings: { total: Date.now() - startTime }
+			timings: { total: Date.now() - startTime },
+			advancedRef
 		});
 	} catch (error) {
 		if (CliStructuredError.is(error)) return notOk(error);
@@ -162,13 +197,10 @@ function createMigrateCommand() {
 		"prisma-next migrate --to production --db $DATABASE_URL",
 		"prisma-next migrate --to sha256:abc123 --db $DATABASE_URL"
 	]);
-	addGlobalOptions(command).option("--db <url>", "Database connection string").option("--config <path>", "Path to prisma-next.config.ts").option("--to <contract>", "Target contract reference (hash, prefix, ref name, migration dir name, <dir>^, or ./path)").action(async (options) => {
-		const flags = parseGlobalFlags(options);
+	addGlobalOptions(command).option("--db <url>", "Database connection string").option("--config <path>", "Path to prisma-next.config.ts").option("--to <contract>", "Target contract reference (hash, prefix, ref name, migration dir name, <dir>^, or ./path)").option("--advance-ref <name>", "Advance the named ref to the post-apply marker after success").action(async (options) => {
+		const flags = parseGlobalFlagsOrExit(options);
 		const startTime = Date.now();
-		const ui = new TerminalUI({
-			color: flags.color,
-			interactive: flags.interactive
-		});
+		const ui = createTerminalUI(flags);
 		const exitCode = handleResult(await executeMigrateCommand(options, flags, ui, startTime), flags, ui, (migrateResult) => {
 			if (flags.json) ui.output(JSON.stringify(migrateResult, null, 2));
 			else if (!flags.quiet) ui.log(formatMigrationApplyCommandOutput(migrateResult, flags));

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 { 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';\n\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  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, parseGlobalFlags } from '../utils/global-flags';\nimport { handleResult } from '../utils/result-handler';\nimport { TerminalUI } from '../utils/terminal-ui';\n\ninterface MigrateCommandOptions extends CommonCommandOptions {\n  readonly db?: string;\n  readonly config?: string;\n  readonly to?: 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}\n\nfunction mapApplyFailure(failure: MigrationApplyFailure): CliStructuredErrorType {\n  return errorRuntime(failure.summary, {\n    why: failure.why ?? 'Migration runner failed',\n    fix: 'Fix the issue and re-run `prisma-next 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    if (refEntry && refEntry.invariants.length > 0) {\n      const allMarkers = await client.readAllMarkers();\n      const appMarker = allMarkers.get('app') ?? null;\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    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    });\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    .action(async (options: MigrateCommandOptions) => {\n      const flags = parseGlobalFlags(options);\n      const startTime = Date.now();\n\n      const ui = new TerminalUI({\n        color: flags.color,\n        interactive: flags.interactive,\n      });\n\n      const result = await 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 { 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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"}

package/dist/commands/migration-check.mjs

@@ -1,12 +1,12 @@
 import { t as loadConfig } from "../config-loader-B6sJjXTv.mjs";
-import { _ as parseGlobalFlags, a as loadMigrationPackages, b as formatStyledHeader, d as setCommandDescriptions, f as setCommandExamples, l as resolveMigrationPaths, p as setCommandSeeAlso, t as addGlobalOptions } from "../command-helpers-D3vL5yi8.mjs";
-import { t as TerminalUI } from "../terminal-ui-XtOQsqe9.mjs";
+import { t as createTerminalUI } from "../terminal-ui-BiB_8KNo.mjs";
+import { S as formatStyledHeader, a as loadMigrationPackages, d as setCommandDescriptions, f as setCommandExamples, l as resolveMigrationPaths, p as setCommandSeeAlso, t as addGlobalOptions, v as parseGlobalFlagsOrExit } from "../command-helpers-CRfjbZRz.mjs";
 import { Command } from "commander";
 import { join, relative } from "pathe";
 import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
 import { MigrationToolsError } from "@prisma-next/migration-tools/errors";
-import { parseMigrationRef } from "@prisma-next/migration-tools/ref-resolution";
 import { readRefs } from "@prisma-next/migration-tools/refs";
+import { parseMigrationRef } from "@prisma-next/migration-tools/ref-resolution";
 import { verifyMigrationHash } from "@prisma-next/migration-tools/hash";
 //#region src/commands/migration-check.ts
 /**
@@ -248,11 +248,8 @@ function createMigrationCheckCommand() {
 	]);
 	command.exitOverride();
 	addGlobalOptions(command).argument("[migration]", "Migration reference (directory name or hash) to check").option("--config <path>", "Path to prisma-next.config.ts").action(async (target, options) => {
-		const flags = parseGlobalFlags(options);
-		const ui = new TerminalUI({
-			color: flags.color,
-			interactive: flags.interactive
-		});
+		const flags = parseGlobalFlagsOrExit(options);
+		const ui = createTerminalUI(flags);
 		let result;
 		let exitCode;
 		try {