prisma-next 0.10.0-dev.9 → 0.11.0

package/dist/migration-plan-BSzcWsvm.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"migration-plan-BSzcWsvm.mjs","names":[],"sources":["../src/utils/contract-space-seed-phase.ts","../src/commands/migration-plan.ts"],"sourcesContent":["import { materialiseExtensionMigrationPackageIfMissing } from '@prisma-next/migration-tools/io';\nimport type { MigrationMetadata } from '@prisma-next/migration-tools/metadata';\nimport type { MigrationOps } from '@prisma-next/migration-tools/package';\nimport {\n  emitContractSpaceArtefacts,\n  planAllSpaces,\n  readContractSpaceHeadRef,\n  type SpacePlanOutput,\n  spaceMigrationDirectory,\n} from '@prisma-next/migration-tools/spaces';\n\n/**\n * In-memory authored migration package shipped by an extension descriptor.\n * Mirrors `MigrationPackage` from `@prisma-next/migration-tools/io` (the\n * on-disk shape minus `dirPath`); redeclared structurally here so the\n * CLI helper does not couple to any family's `ExtensionMigrationPackage`\n * type — any family that ships pre-built migration packages can pass\n * them through unchanged.\n */\nexport interface DescriptorMigrationPackage {\n  readonly dirName: string;\n  readonly metadata: MigrationMetadata;\n  readonly ops: MigrationOps;\n}\n\n/**\n * Minimal descriptor view consumed by the seed phase. Mirrors the shape\n * the SQL family ships on each declared extension entry; only the fields\n * the seed phase needs are surfaced.\n */\nexport interface SeedPhaseExtensionInput {\n  readonly id: string;\n  readonly contractSpace?: {\n    readonly contractJson: unknown;\n    readonly headRef: { readonly hash: string; readonly invariants: readonly string[] };\n    readonly migrations: readonly DescriptorMigrationPackage[];\n  };\n}\n\nexport interface ContractSpaceSeedPhaseInputs {\n  readonly migrationsDir: string;\n  readonly extensionPacks: ReadonlyArray<SeedPhaseExtensionInput>;\n}\n\n/**\n * One per-space record describing what the seed phase did for an\n * extension contract space. Surfaced verbatim by the caller (typically\n * `migration plan`) so users see a single line per touched extension.\n *\n * - `action: 'updated'` — either the on-disk head pointer changed, or\n *   one or more new descriptor-shipped migration packages were\n *   materialised into `migrations/<spaceId>/<dirName>/`.\n * - `action: 'unchanged'` — the on-disk head already matched the\n *   descriptor and no new migration packages needed to be written.\n *\n * Either way, the artefacts (`contract.json`, `contract.d.ts`,\n * `refs/head.json`) are re-emitted: the framework owns those files and\n * makes the re-emit observably idempotent at the byte level.\n */\nexport interface ContractSpaceSeedPhaseRecord {\n  readonly spaceId: string;\n  readonly action: 'updated' | 'unchanged';\n  readonly priorHash: string | null;\n  readonly newHash: string;\n  readonly newMigrationDirs: readonly string[];\n}\n\nexport interface ContractSpaceSeedPhaseResult {\n  readonly seeded: readonly ContractSpaceSeedPhaseRecord[];\n}\n\n/**\n * Phase-1 of the two-phase `migration plan` pipeline (sub-spec § 4).\n *\n * For every extension that exposes a `contractSpace`:\n *\n * 1. Read the on-disk head ref (returns `null` on first emit).\n * 2. Re-emit `contract.json` / `contract.d.ts` / `refs/head.json`\n *    unconditionally via {@link emitContractSpaceArtefacts}. The\n *    framework owns these files; re-emit is the contract.\n * 3. Materialise any descriptor-shipped migration packages not yet on\n *    disk via {@link materialiseExtensionMigrationPackageIfMissing}.\n *    Existing packages are left untouched (by-existence skip).\n *\n * The return value lets the caller render a per-space status line and\n * lets the phase-2 aggregate loader run on a now-consistent disk state\n * (every loaded extension is guaranteed to have its head ref pinned\n * to the descriptor's hash and to ship every package the descriptor\n * declares).\n *\n * Output ordering is deterministic and alphabetical by spaceId (via\n * {@link planAllSpaces}, which also detects duplicate spaceIds). This\n * matches the canonical sort order used by every other aggregate\n * surface (`migrate`, `migration status`, the runner).\n */\nexport async function runContractSpaceSeedPhase(\n  inputs: ContractSpaceSeedPhaseInputs,\n): Promise<ContractSpaceSeedPhaseResult> {\n  const planInputs = inputs.extensionPacks\n    .filter(\n      (\n        pack,\n      ): pack is SeedPhaseExtensionInput & {\n        contractSpace: NonNullable<SeedPhaseExtensionInput['contractSpace']>;\n      } => pack.contractSpace !== undefined,\n    )\n    .map((pack) => ({\n      spaceId: pack.id,\n      priorContract: null,\n      newContract: pack.contractSpace.contractJson,\n      __pack: pack.contractSpace,\n    }));\n\n  // `planAllSpaces` brings deterministic alphabetical ordering and\n  // duplicate-spaceId detection. The \"planner\" callback is a no-op\n  // pass-through that simply returns the descriptor's pre-built\n  // migration packages.\n  const planned: readonly SpacePlanOutput<DescriptorMigrationPackage>[] = planAllSpaces(\n    planInputs,\n    (input) =>\n      (\n        input as typeof input & {\n          readonly __pack: NonNullable<SeedPhaseExtensionInput['contractSpace']>;\n        }\n      ).__pack.migrations,\n  );\n\n  // Reassemble a spaceId → descriptor lookup so the loop below can read\n  // the contractJson / headRef without leaking the typed-cast back into\n  // `planAllSpaces`'s output shape.\n  const descriptorBySpace = new Map<\n    string,\n    NonNullable<SeedPhaseExtensionInput['contractSpace']>\n  >();\n  for (const pack of inputs.extensionPacks) {\n    if (pack.contractSpace !== undefined) descriptorBySpace.set(pack.id, pack.contractSpace);\n  }\n\n  const seeded: ContractSpaceSeedPhaseRecord[] = [];\n  for (const space of planned) {\n    const descriptor = descriptorBySpace.get(space.spaceId);\n    if (descriptor === undefined) continue;\n\n    const onDiskHeadRef = await readContractSpaceHeadRef(inputs.migrationsDir, space.spaceId);\n    const priorHash = onDiskHeadRef?.hash ?? null;\n\n    await emitContractSpaceArtefacts(inputs.migrationsDir, space.spaceId, {\n      contract: descriptor.contractJson,\n      contractDts: buildPlaceholderContractDts(space.spaceId),\n      headRef: { hash: descriptor.headRef.hash, invariants: descriptor.headRef.invariants },\n    });\n\n    const spaceDir = spaceMigrationDirectory(inputs.migrationsDir, space.spaceId);\n    const newMigrationDirs: string[] = [];\n    for (const pkg of space.migrationPackages) {\n      const { written } = await materialiseExtensionMigrationPackageIfMissing(spaceDir, pkg);\n      if (written) newMigrationDirs.push(pkg.dirName);\n    }\n\n    const action: ContractSpaceSeedPhaseRecord['action'] =\n      priorHash !== descriptor.headRef.hash || newMigrationDirs.length > 0\n        ? 'updated'\n        : 'unchanged';\n\n    seeded.push({\n      spaceId: space.spaceId,\n      action,\n      priorHash,\n      newHash: descriptor.headRef.hash,\n      newMigrationDirs,\n    });\n  }\n\n  return { seeded };\n}\n\n/**\n * Placeholder `.d.ts` content for an extension space's on-disk mirror.\n *\n * Rendering a fully-typed `.d.ts` for an extension contract requires\n * the SQL-family renderer with the codec / typemap registry threaded\n * through; until that integration ships, the on-disk `.d.ts` is a\n * stub `export {};` module that documents how consumers should\n * validate the sibling `contract.json`. The stub typechecks on its\n * own and does not need any TypeScript suppressions.\n */\nfunction buildPlaceholderContractDts(spaceId: string): string {\n  return [\n    '/**',\n    ` * Placeholder \\`.d.ts\\` for extension space \"${spaceId}\".`,\n    ' *',\n    ' * The framework re-emits this file on every `migration plan` run',\n    ' * alongside `contract.json` and `refs/head.json`. A typed `.d.ts`',\n    ' * rendering pass for extension contracts is tracked separately;',\n    ' * until that ships, consumers should import `contract.json`',\n    ' * and pass it through the target descriptor’s `contractSerializer`.',\n    ' */',\n    'export {};',\n    '',\n  ].join('\\n');\n}\n","import { readFile } from 'node:fs/promises';\nimport type { Contract } from '@prisma-next/contract/types';\nimport { getEmittedArtifactPaths } from '@prisma-next/emitter';\nimport {\n  type ControlFamilyInstance,\n  createControlStack,\n  hasOperationPreview,\n  type MigrationPlanOperation,\n  type OperationPreview,\n} from '@prisma-next/framework-components/control';\nimport { MigrationToolsError } from '@prisma-next/migration-tools/errors';\nimport { computeMigrationHash } from '@prisma-next/migration-tools/hash';\nimport { deriveProvidedInvariants } from '@prisma-next/migration-tools/invariants';\nimport {\n  copyFilesWithRename,\n  formatMigrationDirName,\n  writeMigrationPackage,\n} from '@prisma-next/migration-tools/io';\nimport type { MigrationMetadata } from '@prisma-next/migration-tools/metadata';\nimport { findLatestMigration } from '@prisma-next/migration-tools/migration-graph';\nimport { writeMigrationTs } from '@prisma-next/migration-tools/migration-ts';\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 } from 'pathe';\nimport { loadConfig } from '../config-loader';\nimport {\n  type CliErrorConflict,\n  CliStructuredError,\n  errorContractValidationFailed,\n  errorFileNotFound,\n  errorMigrationPlanningFailed,\n  errorTargetMigrationNotSupported,\n  errorUnexpected,\n  mapMigrationToolsError,\n  mapRefResolutionError,\n} from '../utils/cli-errors';\nimport {\n  addGlobalOptions,\n  getTargetMigrations,\n  loadMigrationPackages,\n  resolveContractPath,\n  resolveMigrationPaths,\n  setCommandDescriptions,\n  setCommandExamples,\n} from '../utils/command-helpers';\nimport { buildContractSpaceAggregate } from '../utils/contract-space-aggregate-loader';\nimport { runContractSpaceSeedPhase } from '../utils/contract-space-seed-phase';\nimport { toExtensionInputs } from '../utils/extension-pack-inputs';\nimport { formatStyledHeader } from '../utils/formatters/styled';\nimport { assertFrameworkComponentsCompatible } from '../utils/framework-components';\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 MigrationPlanOptions extends CommonCommandOptions {\n  readonly config?: string;\n  readonly name?: string;\n  readonly from?: string;\n}\n\n/**\n * Load a predecessor migration's destination contract from its sibling\n * `end-contract.json` on disk and route it through the family's\n * `ContractSerializer` (via `deserializeContract`) so the in-memory shape\n * is the hydrated `Contract` every other caller sees. Bypassing this\n * seam was the root cause of TML-2536: a raw `JSON.parse(...) as Contract`\n * here let polymorphic `storage.types` entries reach the planner without\n * the `kind` discriminator the planner dispatches on.\n *\n * Throws `CliStructuredError` with:\n *   - `errorFileNotFound` when the sibling file is missing — the user\n *     has likely deleted or never authored the snapshot, and the\n *     message names the file and points them at re-emitting from the\n *     source.\n *   - `errorContractValidationFailed` when the JSON parses but the\n *     family deserializer rejects it (legacy untagged shape, structural\n *     mismatch, etc.) — the message names the predecessor's path so\n *     the operator can locate the bad snapshot.\n */\nasync function readPredecessorEndContract(\n  migrationDir: string,\n  familyInstance: ControlFamilyInstance<string, unknown>,\n): Promise<Contract> {\n  const path = join(migrationDir, 'end-contract.json');\n  let raw: string;\n  try {\n    raw = await readFile(path, 'utf-8');\n  } catch (error) {\n    if (error instanceof Error && (error as { code?: string }).code === 'ENOENT') {\n      throw errorFileNotFound(path, {\n        why: `Predecessor migration is missing its destination contract snapshot at ${path}`,\n        fix: 'Re-emit the predecessor migration (`prisma-next migration plan` from its source) so its sibling `end-contract.json` is restored, then re-run this command.',\n      });\n    }\n    throw error;\n  }\n  try {\n    return familyInstance.deserializeContract(JSON.parse(raw) as unknown);\n  } catch (error) {\n    if (CliStructuredError.is(error)) {\n      throw error;\n    }\n    throw errorContractValidationFailed(\n      `Predecessor contract at ${path} failed to deserialize: ${error instanceof Error ? error.message : String(error)}`,\n      { where: { path } },\n    );\n  }\n}\n\nexport interface MigrationPlanResult {\n  readonly ok: boolean;\n  readonly noOp: boolean;\n  readonly from: string | null;\n  readonly to: string;\n  readonly dir?: string;\n  /**\n   * Extension-space migration packages materialised onto disk during this\n   * `plan` run. Each entry names a `migrations/<spaceId>/<dirName>/`\n   * tree the framework wrote alongside the app-space migration directory.\n   * Empty when the project has no extension packs declaring a contract\n   * space, or when every extension-space package is already on disk.\n   *\n   * Surfacing these in the result (rather than only via `ui.step` log\n   * lines) makes the cross-space side effect explicit to JSON consumers\n   * and the success-summary renderer — the same multi-space side effect\n   * that `migrate` will replay.\n   */\n  readonly emittedExtensionDirs: readonly { readonly spaceId: string; readonly dirName: string }[];\n  readonly operations: readonly {\n    readonly id: string;\n    readonly label: string;\n    readonly operationClass: string;\n  }[];\n  /**\n   * Family-agnostic textual preview of the migration plan operations.\n   * Replaces the previous `sql?: readonly string[]` field; consumers should\n   * read `result.preview?.statements`.\n   */\n  readonly preview?: OperationPreview;\n  readonly summary: string;\n  /**\n   * When true, `migration.ts` was written but contains unfilled\n   * `placeholder(...)` calls. The user must edit the file and then run\n   * `node migration.ts` to self-emit `ops.json` / `migration.json`.\n   */\n  readonly pendingPlaceholders?: boolean;\n  readonly timings: {\n    readonly total: number;\n  };\n}\n\nasync function executeMigrationPlanCommand(\n  options: MigrationPlanOptions,\n  flags: GlobalFlags,\n  ui: TerminalUI,\n  startTime: number,\n): Promise<Result<MigrationPlanResult, CliStructuredError>> {\n  const config = await loadConfig(options.config);\n  const { configPath, migrationsDir, appMigrationsDir, appMigrationsRelative } =\n    resolveMigrationPaths(options.config, config);\n\n  const contractPathAbsolute = resolveContractPath(config);\n  const contractPath = relative(process.cwd(), contractPathAbsolute);\n\n  if (!flags.json && !flags.quiet) {\n    const details: Array<{ label: string; value: string }> = [\n      { label: 'config', value: configPath },\n      { label: 'contract', value: contractPath },\n      { label: 'migrations', value: appMigrationsRelative },\n    ];\n    if (options.from) {\n      details.push({ label: 'from', value: options.from });\n    }\n    if (options.name) {\n      details.push({ label: 'name', value: options.name });\n    }\n    const header = formatStyledHeader({\n      command: 'migration plan',\n      description: 'Plan a migration from contract changes',\n      url: 'https://pris.ly/migration-plan',\n      details,\n      flags,\n    });\n    ui.stderr(header);\n  }\n\n  // Load contract file (the \"to\" contract)\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  // Construct the family instance up-front so on-disk reads (the app\n  // contract here + every `readPredecessorEndContract` below) cross the\n  // serializer seam at the read site, not after the planner has already\n  // started dispatching on raw shapes. See TML-2536.\n  const stack = createControlStack(config);\n  const familyInstance = config.family.create(stack);\n\n  let toContract: Contract;\n  try {\n    toContract = familyInstance.deserializeContract(JSON.parse(contractJsonContent) as unknown);\n  } catch (error) {\n    return notOk(\n      errorContractValidationFailed(\n        `Contract at ${contractPathAbsolute} failed to deserialize: ${error instanceof Error ? error.message : String(error)}`,\n        { where: { path: contractPathAbsolute } },\n      ),\n    );\n  }\n\n  const rawStorageHash = toContract.storage?.storageHash;\n  if (typeof rawStorageHash !== 'string') {\n    return notOk(\n      errorContractValidationFailed('Contract is missing storageHash', {\n        where: { path: contractPathAbsolute },\n      }),\n    );\n  }\n  const toStorageHash = rawStorageHash;\n\n  // Read existing migrations and determine \"from\" contract\n  let fromContract: Contract | null = null;\n  let fromHash: string | null = null;\n  let fromContractSourceDir: string | null = null;\n\n  try {\n    const { bundles, graph } = await loadMigrationPackages(appMigrationsDir);\n\n    if (options.from) {\n      const refs = await readRefs(resolveMigrationPaths(options.config, config).refsDir);\n      const refResult = parseContractRef(options.from, { graph, refs });\n      if (!refResult.ok) {\n        return notOk(mapRefResolutionError(refResult.failure));\n      }\n      fromHash = refResult.value.hash;\n      const matchingBundle = bundles.find((p) => p.metadata.to === fromHash);\n      if (!matchingBundle) {\n        return notOk(\n          errorUnexpected(\n            `No migration bundle found for --from \"${options.from}\" (resolved hash: ${fromHash})`,\n            {\n              why: `The ref resolved successfully but no on-disk migration package has an end-contract hash matching ${fromHash}.`,\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      fromContractSourceDir = matchingBundle.dirPath;\n      fromContract = await readPredecessorEndContract(fromContractSourceDir, familyInstance);\n    } else {\n      const latestMigration = findLatestMigration(graph);\n      if (latestMigration) {\n        fromHash = latestMigration.to;\n        const leafPkg = bundles.find(\n          (p) => p.metadata.migrationHash === latestMigration.migrationHash,\n        );\n        if (leafPkg) {\n          fromContractSourceDir = leafPkg.dirPath;\n          fromContract = await readPredecessorEndContract(fromContractSourceDir, familyInstance);\n        }\n      }\n    }\n  } catch (error) {\n    if (MigrationToolsError.is(error)) {\n      return notOk(mapMigrationToolsError(error));\n    }\n    // `readPredecessorEndContract` raises a `CliStructuredError` directly\n    // for the missing-snapshot case so the operator gets a precise\n    // why/fix; pass it through unchanged rather than re-wrapping.\n    if (CliStructuredError.is(error)) {\n      return notOk(error);\n    }\n    // Wrap unexpected (non-MigrationToolsError) failures from the migration\n    // load phase in a structured CLI envelope. Letting them throw would\n    // bypass `handleResult()` and crash the command — see CLI structured-\n    // errors guideline (CliStructuredError + Result pattern).\n    const message = error instanceof Error ? error.message : String(error);\n    return notOk(\n      errorUnexpected(message, {\n        why: `Unexpected error while loading migrations: ${message}`,\n      }),\n    );\n  }\n\n  // Phase 1 — seed: unconditionally re-emit per-space pinned artefacts\n  // (contract.json / contract.d.ts / refs/head.json) and materialise any\n  // descriptor-shipped migration packages not yet on disk. Runs before\n  // the no-op check so that an extension bump alone (with no structural\n  // app-space change) still re-pins extension artefacts on disk.\n  const canonicalExtensionInputs = toExtensionInputs(config.extensionPacks ?? []);\n  const seedResult = await runContractSpaceSeedPhase({\n    migrationsDir,\n    extensionPacks: canonicalExtensionInputs,\n  });\n  if (!flags.json && !flags.quiet) {\n    for (const record of seedResult.seeded) {\n      if (record.action === 'updated') {\n        const pkgSuffix =\n          record.newMigrationDirs.length > 0\n            ? `; ${record.newMigrationDirs.length} new migration package(s) materialised`\n            : '';\n        ui.step(`Updated ${record.spaceId} to ${record.newHash}${pkgSuffix}`);\n      }\n    }\n  }\n  const emittedExtensionDirs = seedResult.seeded.flatMap((r) =>\n    r.newMigrationDirs.map((dirName) => ({ spaceId: r.spaceId, dirName })),\n  );\n\n  // Check for no-op (same hash means no changes)\n  if (fromHash === toStorageHash) {\n    const result: MigrationPlanResult = {\n      ok: true,\n      noOp: true,\n      from: fromHash,\n      to: toStorageHash,\n      operations: [],\n      emittedExtensionDirs,\n      summary: 'No changes detected between contracts',\n      timings: { total: Date.now() - startTime },\n    };\n    return ok(result);\n  }\n\n  // Check target supports migrations\n  const migrations = getTargetMigrations(config.target);\n  if (!migrations) {\n    return notOk(\n      errorTargetMigrationNotSupported({\n        why: `Target \"${config.target.id}\" does not support migrations`,\n      }),\n    );\n  }\n\n  // Phase 2 — load: build the aggregate against the now-consistent disk\n  // state that phase 1 just seeded. The seed phase guarantees every\n  // declared extension has its head ref pinned, so the loader's\n  // declaredButUnmigrated precheck always passes here. The app contract\n  // was already routed through `familyInstance.deserializeContract` at the\n  // read site above (see TML-2536), so it's the hydrated `Contract`\n  // here — no second validation pass needed.\n  const aggregateResult = await buildContractSpaceAggregate({\n    targetId: config.target.targetId,\n    migrationsDir,\n    appContract: toContract,\n    extensionPacks: config.extensionPacks ?? [],\n    deserializeContract: (json: unknown) => familyInstance.deserializeContract(json),\n  });\n  if (!aggregateResult.ok) {\n    return notOk(aggregateResult.failure);\n  }\n  const aggregate = aggregateResult.value;\n\n  const frameworkComponents = assertFrameworkComponentsCompatible(\n    config.family.familyId,\n    config.target.targetId,\n    [config.target, config.adapter, ...(config.extensionPacks ?? [])],\n  );\n\n  // Build manifest and write migration package\n  const timestamp = new Date();\n  const slug = options.name ?? 'migration';\n  const dirName = formatMigrationDirName(timestamp, slug);\n  const packageDir = join(appMigrationsDir, dirName);\n\n  const baseMetadata: Omit<MigrationMetadata, 'migrationHash' | 'providedInvariants'> = {\n    from: fromHash,\n    to: toStorageHash,\n    hints: {\n      used: [],\n      applied: [],\n      plannerVersion: '2.0.0',\n    },\n    labels: [],\n    createdAt: timestamp.toISOString(),\n  };\n\n  try {\n    const planner = migrations.createPlanner(familyInstance);\n    const fromSchema = migrations.contractToSchema(fromContract, frameworkComponents);\n    const plannerResult = planner.plan({\n      contract: aggregate.app.contract,\n      schema: fromSchema,\n      policy: { allowedOperationClasses: ['additive', 'widening', 'destructive', 'data'] },\n      fromContract,\n      frameworkComponents,\n      spaceId: aggregate.app.spaceId,\n    });\n    if (plannerResult.kind === 'failure') {\n      return notOk(\n        errorMigrationPlanningFailed({\n          conflicts: plannerResult.conflicts as readonly CliErrorConflict[],\n        }),\n      );\n    }\n\n    // Accessing .operations triggers toOp() on each call. If any call\n    // is a DataTransformCall with an unfilled placeholder stub, toOp()\n    // throws PN-MIG-2001. We catch that here so the migration can still\n    // be scaffolded with `ops: []`; the user fills the placeholder, then\n    // re-runs `node migration.ts` to attest with the real ops.\n    let plannedOps: readonly MigrationPlanOperation[] = [];\n    let hasPlaceholders = false;\n    try {\n      plannedOps = plannerResult.plan.operations;\n      if (plannedOps.length === 0) {\n        return notOk(\n          errorMigrationPlanningFailed({\n            conflicts: [\n              {\n                kind: 'unsupportedChange',\n                summary:\n                  'Contract changed but planner produced no operations. ' +\n                  'This indicates unsupported or ignored changes.',\n              },\n            ],\n          }),\n        );\n      }\n    } catch (e) {\n      if (CliStructuredError.is(e) && e.domain === 'MIG' && e.code === '2001') {\n        hasPlaceholders = true;\n      } else {\n        throw e;\n      }\n    }\n\n    const migrationTsContent = plannerResult.plan.renderTypeScript();\n\n    // Always-attest: compute migrationHash over (metadata, ops). When\n    // placeholders blocked lowering, ops is `[]` and the hash is computed\n    // over the empty list — re-emitting after the user fills the placeholder\n    // produces a different hash (over the real ops). This is intentional;\n    // there is no on-disk \"draft\" state.\n    const opsForWrite = hasPlaceholders ? [] : plannedOps;\n    const metadataWithInvariants: Omit<MigrationMetadata, 'migrationHash'> = {\n      ...baseMetadata,\n      providedInvariants: deriveProvidedInvariants(opsForWrite),\n    };\n    const metadata: MigrationMetadata = {\n      ...metadataWithInvariants,\n      migrationHash: computeMigrationHash(metadataWithInvariants, opsForWrite),\n    };\n\n    await writeMigrationPackage(packageDir, metadata, opsForWrite);\n    const destinationArtifacts = getEmittedArtifactPaths(contractPathAbsolute);\n    await copyFilesWithRename(packageDir, [\n      { sourcePath: destinationArtifacts.jsonPath, destName: 'end-contract.json' },\n      { sourcePath: destinationArtifacts.dtsPath, destName: 'end-contract.d.ts' },\n    ]);\n    if (fromContractSourceDir !== null) {\n      const sourceArtifacts = getEmittedArtifactPaths(\n        join(fromContractSourceDir, 'end-contract.json'),\n      );\n      await copyFilesWithRename(packageDir, [\n        { sourcePath: sourceArtifacts.jsonPath, destName: 'start-contract.json' },\n        { sourcePath: sourceArtifacts.dtsPath, destName: 'start-contract.d.ts' },\n      ]);\n    }\n    await writeMigrationTs(packageDir, migrationTsContent);\n\n    if (hasPlaceholders) {\n      const result: MigrationPlanResult = {\n        ok: true,\n        noOp: false,\n        from: fromHash,\n        to: toStorageHash,\n        dir: relative(process.cwd(), packageDir),\n        operations: [],\n        emittedExtensionDirs,\n        pendingPlaceholders: true,\n        summary:\n          'Planned migration with placeholder(s) — edit migration.ts then run `node migration.ts` to self-emit',\n        timings: { total: Date.now() - startTime },\n      };\n      return ok(result);\n    }\n\n    const preview = hasOperationPreview(familyInstance)\n      ? familyInstance.toOperationPreview(plannedOps)\n      : undefined;\n    const result: MigrationPlanResult = {\n      ok: true,\n      noOp: false,\n      from: fromHash,\n      to: toStorageHash,\n      dir: relative(process.cwd(), packageDir),\n      operations: plannedOps.map((op) => ({\n        id: op.id,\n        label: op.label,\n        operationClass: op.operationClass,\n      })),\n      emittedExtensionDirs,\n      ...(preview !== undefined ? { preview } : {}),\n      summary: buildPlanSummary(plannedOps.length, emittedExtensionDirs.length),\n      timings: { total: Date.now() - startTime },\n    };\n    return ok(result);\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    const message = error instanceof Error ? error.message : String(error);\n    return notOk(\n      errorUnexpected(message, {\n        why: `Unexpected error during migration plan: ${message}`,\n      }),\n    );\n  }\n}\n\nexport function createMigrationPlanCommand(): Command {\n  const command = new Command('plan');\n  setCommandDescriptions(\n    command,\n    'Plan a migration from contract changes',\n    'Compares the emitted contract against the latest on-disk migration state and\\n' +\n      'produces a new migration package with the required operations. No database\\n' +\n      'connection is needed — this is a fully offline operation.',\n  );\n  setCommandExamples(command, [\n    'prisma-next migration plan',\n    'prisma-next migration plan --name add-users-table',\n  ]);\n  addGlobalOptions(command)\n    .option('--config <path>', 'Path to prisma-next.config.ts')\n    .option('--name <slug>', 'Name slug for the migration directory', 'migration')\n    .option(\n      '--from <contract>',\n      'Starting contract reference (hash, prefix, ref name, migration dir name, <dir>^, or ./path)',\n    )\n    .action(async (options: MigrationPlanOptions) => {\n      const flags = parseGlobalFlags(options);\n      const startTime = Date.now();\n\n      const ui = new TerminalUI({ color: flags.color, interactive: flags.interactive });\n      const result = await executeMigrationPlanCommand(options, flags, ui, startTime);\n\n      const exitCode = handleResult(result, flags, ui, (planResult) => {\n        if (flags.json) {\n          ui.output(JSON.stringify(planResult, null, 2));\n        } else if (!flags.quiet) {\n          ui.log(formatMigrationPlanOutput(planResult, flags));\n        }\n      });\n\n      process.exit(exitCode);\n    });\n\n  return command;\n}\n\n/**\n * Compose the success-line summary so the cross-space side effect\n * (extension-space migration packages materialised on disk during\n * this `plan` run) is visible in the top line — not just in the\n * step log above it.\n *\n * Example outputs:\n *   - `Planned 3 operation(s)` (app-space-only project)\n *   - `Planned 3 operation(s); materialised 1 extension-space migration` (one extension)\n *   - `Planned 3 operation(s); materialised 2 extension-space migrations` (two extensions)\n *\n * Locks AC3 at the summary-line level: a reader of the success line\n * can tell that something happened beyond the app space.\n */\nfunction buildPlanSummary(plannedOpsCount: number, emittedExtensionDirsCount: number): string {\n  const base = `Planned ${plannedOpsCount} operation(s)`;\n  if (emittedExtensionDirsCount === 0) return base;\n  const noun =\n    emittedExtensionDirsCount === 1 ? 'extension-space migration' : 'extension-space migrations';\n  return `${base}; materialised ${emittedExtensionDirsCount} ${noun}`;\n}\n\nexport function formatMigrationPlanOutput(result: MigrationPlanResult, flags: GlobalFlags): string {\n  const lines: string[] = [];\n  const useColor = flags.color !== false;\n\n  const green_ = useColor ? (s: string) => `\\x1b[32m${s}\\x1b[0m` : (s: string) => s;\n  const yellow_ = useColor ? (s: string) => `\\x1b[33m${s}\\x1b[0m` : (s: string) => s;\n  const dim_ = useColor ? (s: string) => `\\x1b[2m${s}\\x1b[0m` : (s: string) => s;\n\n  // Renders the extension-space materialisation block + canonical apply-step\n  // hint shared by the no-op, placeholder, and full-plan branches. The app\n  // space short-circuits do not skip it: an extension-only bump emits new\n  // `migrations/<spaceId>/<dirName>/` directories on disk that the user\n  // still has to apply, so the success line must surface them.\n  function appendEmittedExtensions(): void {\n    if (result.emittedExtensionDirs.length === 0) return;\n    lines.push('');\n    lines.push(dim_('Emitted extension migrations:'));\n    for (const entry of result.emittedExtensionDirs) {\n      lines.push(dim_(`  ${entry.spaceId} → migrations/${entry.spaceId}/${entry.dirName}`));\n    }\n    lines.push('');\n    lines.push(\n      `Next: review the extension migrations above, then run ${green_('prisma-next migrate')}.`,\n    );\n  }\n\n  if (result.noOp) {\n    lines.push(`${green_('✔')} No changes detected`);\n    lines.push(dim_(`  from: ${result.from}`));\n    lines.push(dim_(`  to:   ${result.to}`));\n    appendEmittedExtensions();\n    return lines.join('\\n');\n  }\n\n  if (result.pendingPlaceholders) {\n    lines.push(`${yellow_('⚠')} ${result.summary}`);\n    lines.push('');\n    lines.push(dim_(`from: ${result.from}`));\n    lines.push(dim_(`to:   ${result.to}`));\n    if (result.dir) {\n      lines.push(dim_(`dir:  ${result.dir}`));\n    }\n    lines.push('');\n    lines.push(\n      'Open migration.ts and replace each `placeholder(...)` call with your actual query.',\n    );\n    lines.push(`Then run: ${green_(`node ${result.dir ?? '<dir>'}/migration.ts`)}`);\n    appendEmittedExtensions();\n    return lines.join('\\n');\n  }\n\n  lines.push(`${green_('✔')} ${result.summary}`);\n  lines.push('');\n\n  if (result.operations.length > 0) {\n    lines.push(dim_('│'));\n    for (let i = 0; i < result.operations.length; i++) {\n      const op = result.operations[i]!;\n      const isLast = i === result.operations.length - 1;\n      const treeChar = isLast ? '└' : '├';\n      // operationClass tag is intentionally NOT inlined per spec:\n      // a destructive footer warning still surfaces below this list.\n      const destructiveMarker =\n        op.operationClass === 'destructive' ? ` ${yellow_('(destructive)')}` : '';\n      lines.push(`${dim_(treeChar)}─ ${op.label}${destructiveMarker}`);\n    }\n\n    const hasDestructive = result.operations.some((op) => op.operationClass === 'destructive');\n    if (hasDestructive) {\n      lines.push('');\n      lines.push(\n        `${yellow_('⚠')} This migration contains destructive operations that may cause data loss.`,\n      );\n    }\n    lines.push('');\n  }\n\n  lines.push(dim_(`from:   ${result.from}`));\n  lines.push(dim_(`to:     ${result.to}`));\n  if (result.dir) {\n    lines.push(dim_(`App space → ${result.dir}`));\n  }\n  // Per-space block: surface the extension-space directories materialised\n  // alongside the app-space migration. Without this block the cross-space\n  // side effect is invisible in the success summary (e2e finding F1).\n  for (const entry of result.emittedExtensionDirs) {\n    lines.push(\n      dim_(`Extension space ${entry.spaceId} → migrations/${entry.spaceId}/${entry.dirName}`),\n    );\n  }\n\n  lines.push('');\n  // The \"Next:\" hint always points at the canonical apply path\n  // (`prisma-next migrate`) regardless of how many spaces were\n  // materialised — `db update` is a dev-time convenience, not the\n  // canonical replay step.\n  lines.push(\n    `Next: review ${green_(result.dir ?? '<dir>')} if needed, then run ${green_('prisma-next migrate')}.`,\n  );\n\n  if (result.preview && result.preview.statements.length > 0) {\n    // The non-empty length is already guaranteed by the surrounding check, so\n    // a plain `every` here is equivalent to the helper in formatters/migrations.ts.\n    const allSql = result.preview.statements.every((s) => s.language === 'sql');\n    lines.push('');\n    lines.push(dim_(allSql ? 'DDL preview' : 'Operation preview'));\n    lines.push('');\n    for (const statement of result.preview.statements) {\n      const trimmed = statement.text.trim();\n      if (!trimmed) continue;\n      const line = statement.language === 'sql' && !trimmed.endsWith(';') ? `${trimmed};` : trimmed;\n      lines.push(line);\n    }\n  }\n\n  if (flags.verbose && result.timings) {\n    lines.push('');\n    lines.push(dim_(`Total time: ${result.timings.total}ms`));\n  }\n\n  return lines.join('\\n');\n}\n\nexport type PrefixResolutionFailure =\n  | { reason: 'ambiguous'; count: number }\n  | { reason: 'not-found' };\n\n/**\n * Resolve a migration package by **target contract hash** (`metadata.to`)\n * using exact match or prefix match.\n *\n * Note: matches `metadata.to` (the contract hash this migration produces),\n * not `metadata.migrationHash` (the package's content-addressed identity).\n * Tries exact match first, then prefix match (auto-prepending `sha256:` when\n * the needle omits the scheme). Returns the matched package on success, or a\n * discriminated failure indicating whether the prefix was ambiguous or simply\n * not found.\n *\n * @internal Exported for testing only.\n */\nexport function resolveBundleByPrefix<T extends { metadata: { to: string } }>(\n  bundles: readonly T[],\n  needle: string,\n): Result<T, PrefixResolutionFailure> {\n  const exact = bundles.find((p) => p.metadata.to === needle);\n  if (exact) return ok(exact);\n\n  const prefixWithScheme = needle.startsWith('sha256:') ? needle : `sha256:${needle}`;\n  const candidates = bundles.filter((p) => p.metadata.to.startsWith(prefixWithScheme));\n\n  if (candidates.length === 1) return ok(candidates[0]!);\n  if (candidates.length > 1) return notOk({ reason: 'ambiguous', count: candidates.length });\n  return notOk({ reason: 'not-found' });\n}\n"],"mappings":"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"}

package/dist/result-handler-CG3vVoKf.mjs

@@ -1,25 +0,0 @@
-import { n as formatErrorOutput, t as formatErrorJson } from "./errors-BYAXmyRJ.mjs";
-//#region src/utils/result-handler.ts
-/**
-* Processes a CLI command result, handling both success and error cases.
-* Formats output appropriately and returns the exit code.
-* Never throws - returns exit code for commands to use with process.exit().
-*
-* Error output:
-* - JSON mode: JSON error to stdout (piped) via ui.output(), human sees nothing on stderr.
-* - Interactive: human-readable error to stderr.
-*/
-function handleResult(result, flags, ui, onSuccess) {
-	if (result.ok) {
-		if (onSuccess) onSuccess(result.value);
-		return 0;
-	}
-	const envelope = result.failure.toEnvelope();
-	if (flags.json) ui.output(formatErrorJson(envelope));
-	else ui.error(formatErrorOutput(envelope, flags));
-	return result.failure.domain === "CLI" ? 2 : 1;
-}
-//#endregion
-export { handleResult as t };
-
-//# sourceMappingURL=result-handler-CG3vVoKf.mjs.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"result-handler-CG3vVoKf.mjs","names":[],"sources":["../src/utils/result-handler.ts"],"sourcesContent":["import type { Result } from '@prisma-next/utils/result';\nimport type { CliStructuredError } from './cli-errors';\nimport { formatErrorJson, formatErrorOutput } from './formatters/errors';\nimport type { GlobalFlags } from './global-flags';\nimport type { TerminalUI } from './terminal-ui';\n\n/**\n * Processes a CLI command result, handling both success and error cases.\n * Formats output appropriately and returns the exit code.\n * Never throws - returns exit code for commands to use with process.exit().\n *\n * Error output:\n * - JSON mode: JSON error to stdout (piped) via ui.output(), human sees nothing on stderr.\n * - Interactive: human-readable error to stderr.\n */\nexport function handleResult<T>(\n  result: Result<T, CliStructuredError>,\n  flags: GlobalFlags,\n  ui: TerminalUI,\n  onSuccess?: (value: T) => void,\n): number {\n  if (result.ok) {\n    if (onSuccess) {\n      onSuccess(result.value);\n    }\n    return 0;\n  }\n\n  // Convert to CLI envelope\n  const envelope = result.failure.toEnvelope();\n\n  if (flags.json) {\n    // JSON error → stdout only\n    ui.output(formatErrorJson(envelope));\n  } else {\n    // Human-readable error → stderr\n    ui.error(formatErrorOutput(envelope, flags));\n  }\n\n  // Infer exit code from error domain: CLI errors = 2, RUN errors = 1\n  const exitCode = result.failure.domain === 'CLI' ? 2 : 1;\n  return exitCode;\n}\n"],"mappings":";;;;;;;;;;;AAeA,SAAgB,aACd,QACA,OACA,IACA,WACQ;CACR,IAAI,OAAO,IAAI;EACb,IAAI,WACF,UAAU,OAAO,MAAM;EAEzB,OAAO;;CAIT,MAAM,WAAW,OAAO,QAAQ,YAAY;CAE5C,IAAI,MAAM,MAER,GAAG,OAAO,gBAAgB,SAAS,CAAC;MAGpC,GAAG,MAAM,kBAAkB,UAAU,MAAM,CAAC;CAK9C,OADiB,OAAO,QAAQ,WAAW,QAAQ,IAAI"}

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

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