@prisma-next/cli 0.14.0 → 0.15.0-dev.10

package/dist/migration-cli.mjs

@@ -1,4 +1,4 @@
-import { t as loadConfig } from "./config-loader-p9JMrekQ.mjs";
+import { loadConfig } from "@prisma-next/config-loader";
 import { CliStructuredError, errorMigrationCliInvalidConfigArg, errorMigrationCliUnknownFlag } from "@prisma-next/errors/control";
 import { dirname, join } from "pathe";
 import { createControlStack } from "@prisma-next/framework-components/control";

package/dist/migration-cli.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"migration-cli.mjs","names":[],"sources":["../src/migration-cli.ts"],"sourcesContent":["/**\n * The migration-file CLI interface: the actor invoked when the author runs\n * `node migration.ts` directly.\n *\n * Naming: this is *not* a \"migration runner\" in the apply-time sense. The\n * apply-time runner is the thing `prisma-next migrate` uses to\n * execute migration JSON ops against a database. `MigrationCLI` is the\n * tiny CLI surface owned by an authored `migration.ts` file: parse the\n * file's argv, load the project's `prisma-next.config.ts`, assemble a\n * `ControlStack`, instantiate the migration class, and serialize.\n *\n * The user authors a migration class, then calls\n * `MigrationCLI.run(import.meta.url, MigrationClass)` at module scope\n * after the class definition. When the file is invoked as a node\n * entrypoint (`node migration.ts`), the CLI:\n *\n * 1. Detects whether the file is the direct entrypoint (no-op when imported).\n * 2. Parses CLI args (`--help`, `--dry-run`, `--config <path>`) via\n *    [clipanion](https://github.com/arcanis/clipanion).\n * 3. Loads the project's `prisma-next.config.ts` via the same `loadConfig`\n *    the CLI commands use, walking up from the migration file's directory.\n * 4. Probe-instantiates the migration class without a stack so it can read\n *    `targetId` and verify it matches `config.target.targetId`\n *    (`PN-MIG-2006` on mismatch) before any stack-driven adapter\n *    construction runs.\n * 5. Assembles a `ControlStack` from the loaded config descriptors and\n *    constructs the migration with that stack.\n * 6. Reads any previously-scaffolded `migration.json`, then calls\n *    `buildMigrationArtifacts` from `@prisma-next/migration-tools` to\n *    produce in-memory `ops.json` + `migration.json` content. Persists\n *    the result to disk (or prints in dry-run mode).\n *\n * File I/O lives here, in `@prisma-next/cli`: this is the only place\n * that legitimately combines config loading, stack assembly, and\n * on-disk persistence. `@prisma-next/migration-tools` owns the pure\n * conversion from a `Migration` instance to artifact strings; `Migration`\n * stays a pure abstract class.\n *\n * Parser library: clipanion (chosen over Commander/citty/`node:util.parseArgs`\n * for its in-process testability and runtime-agnostic execution surface; see\n * `docs/architecture docs/research/commander-friction-points.md` for the\n * evaluation rubric and the durable rationale that drove the choice).\n */\n\nimport { readFileSync, realpathSync, writeFileSync } from 'node:fs';\nimport type { Writable } from 'node:stream';\nimport { fileURLToPath } from 'node:url';\nimport {\n  CliStructuredError,\n  errorMigrationCliInvalidConfigArg,\n  errorMigrationCliUnknownFlag,\n} from '@prisma-next/errors/control';\nimport { errorMigrationTargetMismatch } from '@prisma-next/errors/migration';\nimport { createControlStack } from '@prisma-next/framework-components/control';\nimport { errorInvalidJson, MigrationToolsError } from '@prisma-next/migration-tools/errors';\nimport type { MigrationMetadata } from '@prisma-next/migration-tools/metadata';\nimport { buildMigrationArtifacts, type Migration } from '@prisma-next/migration-tools/migration';\nimport { Cli, Command, Option, UsageError } from 'clipanion';\nimport { dirname, join } from 'pathe';\nimport { loadConfig } from './config-loader';\n\n/**\n * Constructor shape accepted by `MigrationCLI.run`. `Migration` subclasses\n * accept an optional `ControlStack` in their constructor (each subclass\n * narrows the stack to its own family/target generics); the CLI always\n * passes one assembled from the loaded config. We use a rest-args `any[]`\n * constructor signature so that subclass constructors with narrower\n * parameter types remain assignable - constructor type compatibility in\n * TS is contravariant in the parameter, and a wider `unknown` parameter\n * on the alias side would reject any narrower subclass signature.\n *\n * The CLI only ever passes one argument (`new MigrationClass(stack)`);\n * the rest-arity is purely a type-compatibility concession for subclass\n * constructors that declare narrower parameter types, not an extension\n * point for additional construction arguments.\n */\n// biome-ignore lint/suspicious/noExplicitAny: see JSDoc - rest args with any are the idiomatic TS pattern for accepting arbitrary subclass constructor signatures\nexport type MigrationConstructor = new (...args: any[]) => Migration;\n\n/**\n * Stream surface accepted by `MigrationCLI.run`'s `options.stdout` /\n * `options.stderr`. Aliases node's `Writable` because clipanion's\n * `BaseContext.stdout`/`stderr` are typed as `Writable`, and the CLI\n * forwards the injected streams into clipanion's context.\n *\n * `process.stdout` and `process.stderr` are `Writable`-shaped, so the\n * default-fallback path remains a no-op for existing two-argument\n * callers like `MigrationCLI.run(import.meta.url, MyMigration)`.\n *\n * Tests inject a `Writable` subclass that captures chunks for\n * assertions.\n */\nexport type MigrationCliWritable = Writable;\n\n/**\n * Flags exposed by the migration-file CLI.\n *\n * Must stay in sync with the `Option` declarations on\n * `MigrationFileCommand` below. This list is rendered in the\n * `errorMigrationCliUnknownFlag` envelope's `fix` text and `meta`,\n * so order matters for user-visible output (declaration order is the\n * order users see when they run `--help`).\n */\nconst KNOWN_FLAGS: readonly string[] = ['--help', '--dry-run', '--config'];\n\n/**\n * The clipanion command that owns the migration-file CLI's option\n * declarations. The class is internal — `MigrationCLI.run` is the\n * stable public surface. Adding a flag here automatically updates\n * `--help` rendering and the `KNOWN_FLAGS` list (the latter must be\n * updated in tandem).\n */\nclass MigrationFileCommand extends Command {\n  static override paths = [Command.Default];\n\n  static override usage = Command.Usage({\n    description: 'Self-emit ops.json and migration.json from a class-flow migration',\n    details: `\n      Loads the project's prisma-next.config.ts, assembles a ControlStack\n      from the configured target/adapter/extensions, and serializes the\n      migration's operations + metadata next to this file.\n    `,\n    examples: [\n      ['Self-emit ops.json + migration.json next to migration.ts', '$0'],\n      ['Preview without writing files', '$0 --dry-run'],\n      ['Use a non-default config path', '$0 --config ./custom.config.ts'],\n    ],\n  });\n\n  dryRun = Option.Boolean('--dry-run', false, {\n    description: 'Print operations to stdout without writing files',\n  });\n\n  config = Option.String('--config', {\n    description: 'Path to prisma-next.config.ts',\n  });\n\n  /**\n   * Unused: orchestration runs inside `MigrationCLI.run` so error\n   * routing stays under our control (clipanion's `cli.run` writes\n   * error output to `context.stdout`, but our contract requires\n   * structured errors on stderr). `cli.process` is used to parse\n   * argv into a populated `MigrationFileCommand` instance whose\n   * fields drive the orchestration directly.\n   */\n  override async execute(): Promise<number> {\n    return 0;\n  }\n}\n\n/**\n * The CLI surface invoked by an authored `migration.ts` file. Exposed as\n * a class with a static `run` method (rather than a free function) to\n * give the concept a stable identity in the ubiquitous language: this is\n * the \"migration-file CLI\", distinct from the apply-time runner that\n * executes migration JSON ops.\n *\n * Currently a single static method. Future surface (e.g. a programmatic\n * `MigrationCLI.serializeOnly(...)` for tests, or extra subcommands) can\n * land here without changing the import shape used by every authored\n * migration.\n */\n// biome-ignore lint/complexity/noStaticOnlyClass: see JSDoc - intentional class facade for the migration-file CLI surface; future methods will share state derived from argv/config.\nexport class MigrationCLI {\n  /**\n   * Orchestrates a class-flow `migration.ts` script run.\n   *\n   * The third argument is the in-process testability surface: callers\n   * (and tests) may inject `argv`, `stdout`, and `stderr` instead of\n   * relying on `process.argv` / `process.stdout` / `process.stderr`.\n   * Each option defaults to its `process` global when omitted, so\n   * existing two-argument call sites\n   * (`MigrationCLI.run(import.meta.url, MyMigration)`) continue to\n   * compile and behave identically.\n   *\n   * Returns the exit code so the caller can branch on it. Also writes\n   * the same code to `process.exitCode` so script-style callers that\n   * don't await the return value still surface a non-zero exit when\n   * something fails.\n   *\n   * Exit codes:\n   * - 0 — success, or `--help`, or imported-not-entrypoint no-op.\n   * - 1 — runtime/orchestration error (config not found, target\n   *   mismatch, etc.).\n   * - 2 — usage error (unknown flag, malformed `--config`). Aligns\n   *   with `docs/CLI Style Guide.md` § Exit Codes.\n   */\n  static async run(\n    importMetaUrl: string,\n    MigrationClass: MigrationConstructor,\n    options: {\n      readonly argv?: readonly string[];\n      readonly stdout?: MigrationCliWritable;\n      readonly stderr?: MigrationCliWritable;\n    } = {},\n  ): Promise<number> {\n    if (!importMetaUrl) {\n      return 0;\n    }\n\n    const argv = options.argv ?? process.argv;\n    const stdout = options.stdout ?? process.stdout;\n    const stderr = options.stderr ?? process.stderr;\n\n    if (!isDirectEntrypoint(importMetaUrl, argv)) {\n      return 0;\n    }\n\n    const exitCode = await orchestrate(importMetaUrl, MigrationClass, {\n      argv,\n      stdout,\n      stderr,\n    });\n    // Preserve any pre-existing non-zero `process.exitCode` set by code\n    // running alongside `MigrationCLI.run` (an unhandled rejection\n    // upstream, an explicit `process.exitCode = N` from another\n    // module). Overwriting it with our success would mask the upstream\n    // failure for script-style callers that don't await the return\n    // value. Failures we return here are still surfaced — non-zero\n    // codes always win over the prior status — but successes never\n    // clear it.\n    if (exitCode !== 0 || !process.exitCode) {\n      process.exitCode = exitCode;\n    }\n    return exitCode;\n  }\n}\n\n/**\n * Argv-aware variant of the entrypoint guard. The shared\n * `@prisma-next/migration-tools` helper of the same name reads\n * `process.argv[1]` directly, which doesn't compose with the new\n * in-process testability surface (tests inject `argv` without mutating\n * the process global). Inlined here so the migration-file CLI's check\n * follows the injected `argv[1]` consistently.\n */\nfunction isDirectEntrypoint(importMetaUrl: string, argv: readonly string[]): boolean {\n  const argv1 = argv[1];\n  if (!argv1) {\n    return false;\n  }\n  try {\n    return realpathSync(fileURLToPath(importMetaUrl)) === realpathSync(argv1);\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Argv-and-stream-driven orchestration body. Pulled out of the static\n * method so the entrypoint guard / process-default plumbing stays\n * separate from the parse + load + serialize steps.\n */\nasync function orchestrate(\n  importMetaUrl: string,\n  MigrationClass: MigrationConstructor,\n  ctx: {\n    readonly argv: readonly string[];\n    readonly stdout: MigrationCliWritable;\n    readonly stderr: MigrationCliWritable;\n  },\n): Promise<number> {\n  const cli = Cli.from([MigrationFileCommand], {\n    binaryName: 'migration.ts',\n    binaryLabel: 'Migration file CLI',\n  });\n\n  const input = ctx.argv.slice(2);\n\n  // Pre-scan for malformed `--config` (no value, or value-shaped-as-flag)\n  // before delegating to clipanion. The legacy parser surfaced both as\n  // `errorMigrationCliInvalidConfigArg` (`PN-CLI-4012`); pre-scanning\n  // here keeps that contract independent of how clipanion classifies\n  // the error internally (it variably throws `UnknownSyntaxError` or\n  // accepts the flag-shaped token as the value depending on what other\n  // options are registered).\n  const configError = detectInvalidConfig(input);\n  if (configError) {\n    writeStructuredError(ctx.stderr, configError);\n    return 2;\n  }\n\n  let parsed: MigrationFileCommand;\n  try {\n    const command = cli.process({\n      input: [...input],\n      context: { stdout: ctx.stdout, stderr: ctx.stderr },\n    });\n    if (!(command instanceof MigrationFileCommand)) {\n      // The only registered command class is `MigrationFileCommand`;\n      // any other concrete type indicates clipanion emitted its\n      // built-in `HelpCommand`. Render usage directly so we don't\n      // depend on calling `cli.run` (which routes errors to stdout —\n      // wrong stream for our contract).\n      ctx.stdout.write(cli.usage(MigrationFileCommand, { detailed: true }));\n      return 0;\n    }\n    parsed = command;\n  } catch (err) {\n    return renderParseError(err, input, ctx.stderr);\n  }\n\n  if (parsed.help) {\n    ctx.stdout.write(cli.usage(MigrationFileCommand, { detailed: true }));\n    return 0;\n  }\n\n  try {\n    await runMigration(importMetaUrl, MigrationClass, parsed, ctx);\n    return 0;\n  } catch (err) {\n    if (CliStructuredError.is(err)) {\n      writeStructuredError(ctx.stderr, err);\n    } else if (MigrationToolsError.is(err)) {\n      // Migration-tools errors (e.g. `errorInvalidJson` thrown by\n      // `readExistingMetadata` when migration.json is malformed) carry\n      // their own `code`/`why`/`fix` shape. Render them with the same\n      // visual structure as `CliStructuredError` so consumers grepping\n      // for `MIGRATION.<CODE>` see consistent output across surfaces.\n      const fix = err.fix ? `\\n${err.fix}` : '';\n      ctx.stderr.write(`${err.code}: ${err.message}\\n${err.why}${fix}\\n`);\n    } else {\n      ctx.stderr.write(`${err instanceof Error ? err.message : String(err)}\\n`);\n    }\n    return 1;\n  }\n}\n\n/**\n * Returns an `errorMigrationCliInvalidConfigArg` envelope when `input`\n * contains a malformed `--config`:\n *\n * - `--config` as the last token (no value follows).\n * - `--config <flag>` where `<flag>` starts with `-` (silently\n *   consuming the next flag would either drop the flag or serialize\n *   against the wrong project).\n * - `--config <empty>` where the value is the empty string. Shells\n *   expand `--config \"\"` (or `--config \"$UNSET_VAR\"`) into a real\n *   empty argv token; treating that as a usage error here surfaces\n *   `PN-CLI-4012` instead of a less actionable loader error on an\n *   empty path.\n * - `--config=` (the equals form with an empty value). Same shape as\n *   the empty-string case above; the user expressed intent to override\n *   the config path but the override is empty.\n *\n * `--config=<value>` and `--config <value>` with a non-empty value are\n * both valid (and the equals form's value is allowed to start with\n * `-` — the `=` makes the binding explicit).\n */\nfunction detectInvalidConfig(input: readonly string[]): CliStructuredError | null {\n  for (let i = 0; i < input.length; i++) {\n    const token = input[i];\n    if (token === '--config') {\n      const next = input[i + 1];\n      if (next === undefined || next === '') {\n        return errorMigrationCliInvalidConfigArg();\n      }\n      if (next.startsWith('-')) {\n        return errorMigrationCliInvalidConfigArg({ nextToken: next });\n      }\n      continue;\n    }\n    if (token === '--config=') {\n      return errorMigrationCliInvalidConfigArg();\n    }\n  }\n  return null;\n}\n\n/**\n * Translate clipanion's parse-time errors into the project's structured\n * error envelopes.\n *\n * - `UnknownSyntaxError` covers both unknown flags (`--frobnicate`) and\n *   the bare-trailing `--config` case (where arity-1 needs a value but\n *   none was supplied). Distinguished by inspecting the input array.\n * - `UsageError` covers schema/validator failures from typanion. None\n *   of the migration-file CLI's options have validators today, but we\n *   still translate it as a usage error (exit 2) for forward-compat.\n * - Anything else re-throws — caller's outer catch will surface it as\n *   exit 1 (runtime error).\n */\nfunction renderParseError(\n  err: unknown,\n  input: readonly string[],\n  stderr: MigrationCliWritable,\n): number {\n  if (isUnknownSyntaxError(err)) {\n    const flag = findOffendingFlag(input);\n    writeStructuredError(stderr, errorMigrationCliUnknownFlag({ flag, knownFlags: KNOWN_FLAGS }));\n    return 2;\n  }\n  if (err instanceof UsageError) {\n    // typanion validator failures and similar usage errors. None of\n    // the migration-file CLI's options have validators today, so this\n    // branch is forward-compat scaffolding — kept so that a future\n    // option declaration with a validator routes through the same PN\n    // envelope path rather than escaping as exit 1.\n    writeStructuredError(stderr, errorMigrationCliInvalidConfigArg({ nextToken: err.message }));\n    return 2;\n  }\n  throw err;\n}\n\n/**\n * Duck-type check for clipanion's `UnknownSyntaxError`: the class is\n * thrown by the parser but is not re-exported from the package's main\n * entry (only `UsageError` is — see clipanion's `advanced/index.d.ts`).\n * Identified by `name === 'UnknownSyntaxError'` and the\n * `clipanion.type === 'none'` discriminator that clipanion's\n * `ErrorWithMeta` interface guarantees.\n */\nfunction isUnknownSyntaxError(err: unknown): err is Error {\n  if (!(err instanceof Error) || err.name !== 'UnknownSyntaxError') {\n    return false;\n  }\n  // clipanion's `ErrorWithMeta` interface guarantees a `clipanion` field with\n  // a `type` discriminator on every error it throws. Read it via a structural\n  // shape rather than importing the class (it's not re-exported from the\n  // package main).\n  const meta = (err as { clipanion?: { type?: string } }).clipanion;\n  return typeof meta === 'object' && meta !== null && meta.type === 'none';\n}\n\n/**\n * Best-effort: pull the first input token that doesn't match a known\n * flag. Falls back to the first token when we can't pinpoint it. The\n * returned name is rendered into the user-visible PN-CLI-4013 envelope\n * (`Unknown flag \\`<name>\\``) and round-tripped via `meta.flag` so\n * agent consumers can render their own \"did you mean\" suggestions.\n */\nfunction findOffendingFlag(input: readonly string[]): string {\n  for (const token of input) {\n    if (!token.startsWith('-')) {\n      continue;\n    }\n    const head = token.split('=', 1)[0] ?? token;\n    if (!KNOWN_FLAGS.includes(head) && head !== '-h') {\n      return head;\n    }\n  }\n  return input[0] ?? '';\n}\n\n/**\n * Write a `CliStructuredError` envelope to the given stream. Format\n * matches the legacy hand-rolled writer (`message: why`) so the rest of\n * the project's error rendering stays consistent across surfaces. The\n * full PN code (`PN-<domain>-<code>`) is included so consumers can\n * grep for stable identifiers.\n */\nfunction writeStructuredError(stream: MigrationCliWritable, err: CliStructuredError): void {\n  const envelope = err.toEnvelope();\n  const why = envelope.why ?? envelope.summary;\n  const fix = envelope.fix ? `\\n${envelope.fix}` : '';\n  stream.write(`${envelope.code}: ${envelope.summary}\\n${why}${fix}\\n`);\n}\n\n/**\n * Read a previously-scaffolded `migration.json` from disk, returning\n * `null` when the file is missing and throwing `MIGRATION.INVALID_JSON`\n * when the file is present but cannot be parsed as JSON. The CLI feeds\n * this into `buildMigrationArtifacts` so the pure builder can preserve\n * fields owned by `migration plan` (contract bookends, `createdAt`) across\n * re-emits.\n *\n * Author-time path: this loader still does not verify the manifest hash\n * or schema — that is the apply-time loader's job. Hash mismatch is the\n * *expected* outcome of a re-author (the developer's source changes\n * invalidate the prior hash by construction), and verification here\n * would block legitimate regenerations. Syntactic JSON-parse failure,\n * however, is now surfaced rather than swallowed: a malformed\n * `migration.json` indicates either a hand-edit gone wrong or partial\n * write, and silently rebuilding from `describe()` would discard the\n * user's on-disk content (preserved bookends, `createdAt`) without any\n * indication something was wrong on disk.\n * Apply-time consumers always route through the verifying\n * `readMigrationPackage` in `@prisma-next/migration-tools/io` instead.\n */\nfunction readExistingMetadata(metadataPath: string): Partial<MigrationMetadata> | null {\n  let raw: string;\n  try {\n    raw = readFileSync(metadataPath, 'utf-8');\n  } catch {\n    return null;\n  }\n  try {\n    return JSON.parse(raw) as Partial<MigrationMetadata>;\n  } catch (e) {\n    throw errorInvalidJson(metadataPath, e instanceof Error ? e.message : String(e));\n  }\n}\n\n/**\n * Persist a migration instance's artifacts to `migrationDir`. In\n * `dryRun` mode the artifacts are printed to stdout (with the same\n * `--- migration.json --- / --- ops.json ---` framing the legacy\n * `serializeMigration` helper used) and no files are written. Otherwise\n * `ops.json` and `migration.json` are written next to `migration.ts` and\n * a confirmation line is printed.\n *\n * File I/O lives in the CLI rather than `@prisma-next/migration-tools`\n * so the migration-tools package stays focused on the pure\n * `Migration` → in-memory artifact conversion. The CLI is the only\n * legitimate site for combining config loading, stack assembly, and\n * filesystem persistence.\n */\nasync function serializeMigrationToDisk(\n  instance: Migration,\n  migrationDir: string,\n  dryRun: boolean,\n  stdout: MigrationCliWritable,\n): Promise<void> {\n  const metadataPath = join(migrationDir, 'migration.json');\n  const existing = readExistingMetadata(metadataPath);\n  const { opsJson, metadataJson } = await buildMigrationArtifacts(instance, existing);\n\n  if (dryRun) {\n    stdout.write(`--- migration.json ---\\n${metadataJson}\\n`);\n    stdout.write('--- ops.json ---\\n');\n    stdout.write(`${opsJson}\\n`);\n    return;\n  }\n\n  writeFileSync(join(migrationDir, 'ops.json'), opsJson);\n  writeFileSync(metadataPath, metadataJson);\n\n  stdout.write(`Wrote ops.json + migration.json to ${migrationDir}\\n`);\n}\n\n/**\n * Inner orchestration: load config, probe-construct the migration,\n * verify target, assemble the stack, construct with the stack, persist.\n *\n * Throws `CliStructuredError` for known failure modes (config not\n * found, target mismatch); the outer `orchestrate` translates those to\n * exit 1.\n */\nasync function runMigration(\n  importMetaUrl: string,\n  MigrationClass: MigrationConstructor,\n  parsed: MigrationFileCommand,\n  ctx: {\n    readonly stdout: MigrationCliWritable;\n    readonly stderr: MigrationCliWritable;\n  },\n): Promise<void> {\n  const migrationFile = fileURLToPath(importMetaUrl);\n  const migrationDir = dirname(migrationFile);\n\n  const config = await loadConfig(parsed.config);\n\n  // Probe-instantiate without a stack so we can read `targetId` before\n  // any target-specific constructor side effects (e.g.\n  // `PostgresMigration`'s `stack.adapter.create(stack)`) run. Concrete\n  // subclasses are required to accept the no-arg form; the abstract\n  // `Migration` constructor declares `stack?` and target subclasses\n  // (Postgres, Mongo) propagate that optionality. This makes the\n  // target-mismatch guard fail fast with `PN-MIG-2006` before any\n  // stack-driven adapter construction begins, even if the wrong-target\n  // adapter's `create` would otherwise succeed and silently misshapen\n  // the stored adapter cast.\n  const probe = new MigrationClass();\n\n  if (probe.targetId !== config.target.targetId) {\n    throw errorMigrationTargetMismatch({\n      migrationTargetId: probe.targetId,\n      configTargetId: config.target.targetId,\n    });\n  }\n\n  const stack = createControlStack(config);\n  const instance = new MigrationClass(stack);\n\n  await serializeMigrationToDisk(instance, migrationDir, parsed.dryRun, ctx.stdout);\n  void ctx.stderr;\n}\n"],"mappings":"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"}
+{"version":3,"file":"migration-cli.mjs","names":[],"sources":["../src/migration-cli.ts"],"sourcesContent":["/**\n * The migration-file CLI interface: the actor invoked when the author runs\n * `node migration.ts` directly.\n *\n * Naming: this is *not* a \"migration runner\" in the apply-time sense. The\n * apply-time runner is the thing `prisma-next migrate` uses to\n * execute migration JSON ops against a database. `MigrationCLI` is the\n * tiny CLI surface owned by an authored `migration.ts` file: parse the\n * file's argv, load the project's `prisma-next.config.ts`, assemble a\n * `ControlStack`, instantiate the migration class, and serialize.\n *\n * The user authors a migration class, then calls\n * `MigrationCLI.run(import.meta.url, MigrationClass)` at module scope\n * after the class definition. When the file is invoked as a node\n * entrypoint (`node migration.ts`), the CLI:\n *\n * 1. Detects whether the file is the direct entrypoint (no-op when imported).\n * 2. Parses CLI args (`--help`, `--dry-run`, `--config <path>`) via\n *    [clipanion](https://github.com/arcanis/clipanion).\n * 3. Loads the project's `prisma-next.config.ts` via the same `loadConfig`\n *    the CLI commands use, walking up from the migration file's directory.\n * 4. Probe-instantiates the migration class without a stack so it can read\n *    `targetId` and verify it matches `config.target.targetId`\n *    (`PN-MIG-2006` on mismatch) before any stack-driven adapter\n *    construction runs.\n * 5. Assembles a `ControlStack` from the loaded config descriptors and\n *    constructs the migration with that stack.\n * 6. Reads any previously-scaffolded `migration.json`, then calls\n *    `buildMigrationArtifacts` from `@prisma-next/migration-tools` to\n *    produce in-memory `ops.json` + `migration.json` content. Persists\n *    the result to disk (or prints in dry-run mode).\n *\n * File I/O lives here, in `@prisma-next/cli`: this is the only place\n * that legitimately combines config loading, stack assembly, and\n * on-disk persistence. `@prisma-next/migration-tools` owns the pure\n * conversion from a `Migration` instance to artifact strings; `Migration`\n * stays a pure abstract class.\n *\n * Parser library: clipanion (chosen over Commander/citty/`node:util.parseArgs`\n * for its in-process testability and runtime-agnostic execution surface; see\n * `docs/architecture docs/research/commander-friction-points.md` for the\n * evaluation rubric and the durable rationale that drove the choice).\n */\n\nimport { readFileSync, realpathSync, writeFileSync } from 'node:fs';\nimport type { Writable } from 'node:stream';\nimport { fileURLToPath } from 'node:url';\nimport { loadConfig } from '@prisma-next/config-loader';\nimport {\n  CliStructuredError,\n  errorMigrationCliInvalidConfigArg,\n  errorMigrationCliUnknownFlag,\n} from '@prisma-next/errors/control';\nimport { errorMigrationTargetMismatch } from '@prisma-next/errors/migration';\nimport { createControlStack } from '@prisma-next/framework-components/control';\nimport { errorInvalidJson, MigrationToolsError } from '@prisma-next/migration-tools/errors';\nimport type { MigrationMetadata } from '@prisma-next/migration-tools/metadata';\nimport { buildMigrationArtifacts, type Migration } from '@prisma-next/migration-tools/migration';\nimport { Cli, Command, Option, UsageError } from 'clipanion';\nimport { dirname, join } from 'pathe';\n\n/**\n * Constructor shape accepted by `MigrationCLI.run`. `Migration` subclasses\n * accept an optional `ControlStack` in their constructor (each subclass\n * narrows the stack to its own family/target generics); the CLI always\n * passes one assembled from the loaded config. We use a rest-args `any[]`\n * constructor signature so that subclass constructors with narrower\n * parameter types remain assignable - constructor type compatibility in\n * TS is contravariant in the parameter, and a wider `unknown` parameter\n * on the alias side would reject any narrower subclass signature.\n *\n * The CLI only ever passes one argument (`new MigrationClass(stack)`);\n * the rest-arity is purely a type-compatibility concession for subclass\n * constructors that declare narrower parameter types, not an extension\n * point for additional construction arguments.\n */\n// biome-ignore lint/suspicious/noExplicitAny: see JSDoc - rest args with any are the idiomatic TS pattern for accepting arbitrary subclass constructor signatures\nexport type MigrationConstructor = new (...args: any[]) => Migration;\n\n/**\n * Stream surface accepted by `MigrationCLI.run`'s `options.stdout` /\n * `options.stderr`. Aliases node's `Writable` because clipanion's\n * `BaseContext.stdout`/`stderr` are typed as `Writable`, and the CLI\n * forwards the injected streams into clipanion's context.\n *\n * `process.stdout` and `process.stderr` are `Writable`-shaped, so the\n * default-fallback path remains a no-op for existing two-argument\n * callers like `MigrationCLI.run(import.meta.url, MyMigration)`.\n *\n * Tests inject a `Writable` subclass that captures chunks for\n * assertions.\n */\nexport type MigrationCliWritable = Writable;\n\n/**\n * Flags exposed by the migration-file CLI.\n *\n * Must stay in sync with the `Option` declarations on\n * `MigrationFileCommand` below. This list is rendered in the\n * `errorMigrationCliUnknownFlag` envelope's `fix` text and `meta`,\n * so order matters for user-visible output (declaration order is the\n * order users see when they run `--help`).\n */\nconst KNOWN_FLAGS: readonly string[] = ['--help', '--dry-run', '--config'];\n\n/**\n * The clipanion command that owns the migration-file CLI's option\n * declarations. The class is internal — `MigrationCLI.run` is the\n * stable public surface. Adding a flag here automatically updates\n * `--help` rendering and the `KNOWN_FLAGS` list (the latter must be\n * updated in tandem).\n */\nclass MigrationFileCommand extends Command {\n  static override paths = [Command.Default];\n\n  static override usage = Command.Usage({\n    description: 'Self-emit ops.json and migration.json from a class-flow migration',\n    details: `\n      Loads the project's prisma-next.config.ts, assembles a ControlStack\n      from the configured target/adapter/extensions, and serializes the\n      migration's operations + metadata next to this file.\n    `,\n    examples: [\n      ['Self-emit ops.json + migration.json next to migration.ts', '$0'],\n      ['Preview without writing files', '$0 --dry-run'],\n      ['Use a non-default config path', '$0 --config ./custom.config.ts'],\n    ],\n  });\n\n  dryRun = Option.Boolean('--dry-run', false, {\n    description: 'Print operations to stdout without writing files',\n  });\n\n  config = Option.String('--config', {\n    description: 'Path to prisma-next.config.ts',\n  });\n\n  /**\n   * Unused: orchestration runs inside `MigrationCLI.run` so error\n   * routing stays under our control (clipanion's `cli.run` writes\n   * error output to `context.stdout`, but our contract requires\n   * structured errors on stderr). `cli.process` is used to parse\n   * argv into a populated `MigrationFileCommand` instance whose\n   * fields drive the orchestration directly.\n   */\n  override async execute(): Promise<number> {\n    return 0;\n  }\n}\n\n/**\n * The CLI surface invoked by an authored `migration.ts` file. Exposed as\n * a class with a static `run` method (rather than a free function) to\n * give the concept a stable identity in the ubiquitous language: this is\n * the \"migration-file CLI\", distinct from the apply-time runner that\n * executes migration JSON ops.\n *\n * Currently a single static method. Future surface (e.g. a programmatic\n * `MigrationCLI.serializeOnly(...)` for tests, or extra subcommands) can\n * land here without changing the import shape used by every authored\n * migration.\n */\n// biome-ignore lint/complexity/noStaticOnlyClass: see JSDoc - intentional class facade for the migration-file CLI surface; future methods will share state derived from argv/config.\nexport class MigrationCLI {\n  /**\n   * Orchestrates a class-flow `migration.ts` script run.\n   *\n   * The third argument is the in-process testability surface: callers\n   * (and tests) may inject `argv`, `stdout`, and `stderr` instead of\n   * relying on `process.argv` / `process.stdout` / `process.stderr`.\n   * Each option defaults to its `process` global when omitted, so\n   * existing two-argument call sites\n   * (`MigrationCLI.run(import.meta.url, MyMigration)`) continue to\n   * compile and behave identically.\n   *\n   * Returns the exit code so the caller can branch on it. Also writes\n   * the same code to `process.exitCode` so script-style callers that\n   * don't await the return value still surface a non-zero exit when\n   * something fails.\n   *\n   * Exit codes:\n   * - 0 — success, or `--help`, or imported-not-entrypoint no-op.\n   * - 1 — runtime/orchestration error (config not found, target\n   *   mismatch, etc.).\n   * - 2 — usage error (unknown flag, malformed `--config`). Aligns\n   *   with `docs/CLI Style Guide.md` § Exit Codes.\n   */\n  static async run(\n    importMetaUrl: string,\n    MigrationClass: MigrationConstructor,\n    options: {\n      readonly argv?: readonly string[];\n      readonly stdout?: MigrationCliWritable;\n      readonly stderr?: MigrationCliWritable;\n    } = {},\n  ): Promise<number> {\n    if (!importMetaUrl) {\n      return 0;\n    }\n\n    const argv = options.argv ?? process.argv;\n    const stdout = options.stdout ?? process.stdout;\n    const stderr = options.stderr ?? process.stderr;\n\n    if (!isDirectEntrypoint(importMetaUrl, argv)) {\n      return 0;\n    }\n\n    const exitCode = await orchestrate(importMetaUrl, MigrationClass, {\n      argv,\n      stdout,\n      stderr,\n    });\n    // Preserve any pre-existing non-zero `process.exitCode` set by code\n    // running alongside `MigrationCLI.run` (an unhandled rejection\n    // upstream, an explicit `process.exitCode = N` from another\n    // module). Overwriting it with our success would mask the upstream\n    // failure for script-style callers that don't await the return\n    // value. Failures we return here are still surfaced — non-zero\n    // codes always win over the prior status — but successes never\n    // clear it.\n    if (exitCode !== 0 || !process.exitCode) {\n      process.exitCode = exitCode;\n    }\n    return exitCode;\n  }\n}\n\n/**\n * Argv-aware variant of the entrypoint guard. The shared\n * `@prisma-next/migration-tools` helper of the same name reads\n * `process.argv[1]` directly, which doesn't compose with the new\n * in-process testability surface (tests inject `argv` without mutating\n * the process global). Inlined here so the migration-file CLI's check\n * follows the injected `argv[1]` consistently.\n */\nfunction isDirectEntrypoint(importMetaUrl: string, argv: readonly string[]): boolean {\n  const argv1 = argv[1];\n  if (!argv1) {\n    return false;\n  }\n  try {\n    return realpathSync(fileURLToPath(importMetaUrl)) === realpathSync(argv1);\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Argv-and-stream-driven orchestration body. Pulled out of the static\n * method so the entrypoint guard / process-default plumbing stays\n * separate from the parse + load + serialize steps.\n */\nasync function orchestrate(\n  importMetaUrl: string,\n  MigrationClass: MigrationConstructor,\n  ctx: {\n    readonly argv: readonly string[];\n    readonly stdout: MigrationCliWritable;\n    readonly stderr: MigrationCliWritable;\n  },\n): Promise<number> {\n  const cli = Cli.from([MigrationFileCommand], {\n    binaryName: 'migration.ts',\n    binaryLabel: 'Migration file CLI',\n  });\n\n  const input = ctx.argv.slice(2);\n\n  // Pre-scan for malformed `--config` (no value, or value-shaped-as-flag)\n  // before delegating to clipanion. The legacy parser surfaced both as\n  // `errorMigrationCliInvalidConfigArg` (`PN-CLI-4012`); pre-scanning\n  // here keeps that contract independent of how clipanion classifies\n  // the error internally (it variably throws `UnknownSyntaxError` or\n  // accepts the flag-shaped token as the value depending on what other\n  // options are registered).\n  const configError = detectInvalidConfig(input);\n  if (configError) {\n    writeStructuredError(ctx.stderr, configError);\n    return 2;\n  }\n\n  let parsed: MigrationFileCommand;\n  try {\n    const command = cli.process({\n      input: [...input],\n      context: { stdout: ctx.stdout, stderr: ctx.stderr },\n    });\n    if (!(command instanceof MigrationFileCommand)) {\n      // The only registered command class is `MigrationFileCommand`;\n      // any other concrete type indicates clipanion emitted its\n      // built-in `HelpCommand`. Render usage directly so we don't\n      // depend on calling `cli.run` (which routes errors to stdout —\n      // wrong stream for our contract).\n      ctx.stdout.write(cli.usage(MigrationFileCommand, { detailed: true }));\n      return 0;\n    }\n    parsed = command;\n  } catch (err) {\n    return renderParseError(err, input, ctx.stderr);\n  }\n\n  if (parsed.help) {\n    ctx.stdout.write(cli.usage(MigrationFileCommand, { detailed: true }));\n    return 0;\n  }\n\n  try {\n    await runMigration(importMetaUrl, MigrationClass, parsed, ctx);\n    return 0;\n  } catch (err) {\n    if (CliStructuredError.is(err)) {\n      writeStructuredError(ctx.stderr, err);\n    } else if (MigrationToolsError.is(err)) {\n      // Migration-tools errors (e.g. `errorInvalidJson` thrown by\n      // `readExistingMetadata` when migration.json is malformed) carry\n      // their own `code`/`why`/`fix` shape. Render them with the same\n      // visual structure as `CliStructuredError` so consumers grepping\n      // for `MIGRATION.<CODE>` see consistent output across surfaces.\n      const fix = err.fix ? `\\n${err.fix}` : '';\n      ctx.stderr.write(`${err.code}: ${err.message}\\n${err.why}${fix}\\n`);\n    } else {\n      ctx.stderr.write(`${err instanceof Error ? err.message : String(err)}\\n`);\n    }\n    return 1;\n  }\n}\n\n/**\n * Returns an `errorMigrationCliInvalidConfigArg` envelope when `input`\n * contains a malformed `--config`:\n *\n * - `--config` as the last token (no value follows).\n * - `--config <flag>` where `<flag>` starts with `-` (silently\n *   consuming the next flag would either drop the flag or serialize\n *   against the wrong project).\n * - `--config <empty>` where the value is the empty string. Shells\n *   expand `--config \"\"` (or `--config \"$UNSET_VAR\"`) into a real\n *   empty argv token; treating that as a usage error here surfaces\n *   `PN-CLI-4012` instead of a less actionable loader error on an\n *   empty path.\n * - `--config=` (the equals form with an empty value). Same shape as\n *   the empty-string case above; the user expressed intent to override\n *   the config path but the override is empty.\n *\n * `--config=<value>` and `--config <value>` with a non-empty value are\n * both valid (and the equals form's value is allowed to start with\n * `-` — the `=` makes the binding explicit).\n */\nfunction detectInvalidConfig(input: readonly string[]): CliStructuredError | null {\n  for (let i = 0; i < input.length; i++) {\n    const token = input[i];\n    if (token === '--config') {\n      const next = input[i + 1];\n      if (next === undefined || next === '') {\n        return errorMigrationCliInvalidConfigArg();\n      }\n      if (next.startsWith('-')) {\n        return errorMigrationCliInvalidConfigArg({ nextToken: next });\n      }\n      continue;\n    }\n    if (token === '--config=') {\n      return errorMigrationCliInvalidConfigArg();\n    }\n  }\n  return null;\n}\n\n/**\n * Translate clipanion's parse-time errors into the project's structured\n * error envelopes.\n *\n * - `UnknownSyntaxError` covers both unknown flags (`--frobnicate`) and\n *   the bare-trailing `--config` case (where arity-1 needs a value but\n *   none was supplied). Distinguished by inspecting the input array.\n * - `UsageError` covers schema/validator failures from typanion. None\n *   of the migration-file CLI's options have validators today, but we\n *   still translate it as a usage error (exit 2) for forward-compat.\n * - Anything else re-throws — caller's outer catch will surface it as\n *   exit 1 (runtime error).\n */\nfunction renderParseError(\n  err: unknown,\n  input: readonly string[],\n  stderr: MigrationCliWritable,\n): number {\n  if (isUnknownSyntaxError(err)) {\n    const flag = findOffendingFlag(input);\n    writeStructuredError(stderr, errorMigrationCliUnknownFlag({ flag, knownFlags: KNOWN_FLAGS }));\n    return 2;\n  }\n  if (err instanceof UsageError) {\n    // typanion validator failures and similar usage errors. None of\n    // the migration-file CLI's options have validators today, so this\n    // branch is forward-compat scaffolding — kept so that a future\n    // option declaration with a validator routes through the same PN\n    // envelope path rather than escaping as exit 1.\n    writeStructuredError(stderr, errorMigrationCliInvalidConfigArg({ nextToken: err.message }));\n    return 2;\n  }\n  throw err;\n}\n\n/**\n * Duck-type check for clipanion's `UnknownSyntaxError`: the class is\n * thrown by the parser but is not re-exported from the package's main\n * entry (only `UsageError` is — see clipanion's `advanced/index.d.ts`).\n * Identified by `name === 'UnknownSyntaxError'` and the\n * `clipanion.type === 'none'` discriminator that clipanion's\n * `ErrorWithMeta` interface guarantees.\n */\nfunction isUnknownSyntaxError(err: unknown): err is Error {\n  if (!(err instanceof Error) || err.name !== 'UnknownSyntaxError') {\n    return false;\n  }\n  // clipanion's `ErrorWithMeta` interface guarantees a `clipanion` field with\n  // a `type` discriminator on every error it throws. Read it via a structural\n  // shape rather than importing the class (it's not re-exported from the\n  // package main).\n  const meta = (err as { clipanion?: { type?: string } }).clipanion;\n  return typeof meta === 'object' && meta !== null && meta.type === 'none';\n}\n\n/**\n * Best-effort: pull the first input token that doesn't match a known\n * flag. Falls back to the first token when we can't pinpoint it. The\n * returned name is rendered into the user-visible PN-CLI-4013 envelope\n * (`Unknown flag \\`<name>\\``) and round-tripped via `meta.flag` so\n * agent consumers can render their own \"did you mean\" suggestions.\n */\nfunction findOffendingFlag(input: readonly string[]): string {\n  for (const token of input) {\n    if (!token.startsWith('-')) {\n      continue;\n    }\n    const head = token.split('=', 1)[0] ?? token;\n    if (!KNOWN_FLAGS.includes(head) && head !== '-h') {\n      return head;\n    }\n  }\n  return input[0] ?? '';\n}\n\n/**\n * Write a `CliStructuredError` envelope to the given stream. Format\n * matches the legacy hand-rolled writer (`message: why`) so the rest of\n * the project's error rendering stays consistent across surfaces. The\n * full PN code (`PN-<domain>-<code>`) is included so consumers can\n * grep for stable identifiers.\n */\nfunction writeStructuredError(stream: MigrationCliWritable, err: CliStructuredError): void {\n  const envelope = err.toEnvelope();\n  const why = envelope.why ?? envelope.summary;\n  const fix = envelope.fix ? `\\n${envelope.fix}` : '';\n  stream.write(`${envelope.code}: ${envelope.summary}\\n${why}${fix}\\n`);\n}\n\n/**\n * Read a previously-scaffolded `migration.json` from disk, returning\n * `null` when the file is missing and throwing `MIGRATION.INVALID_JSON`\n * when the file is present but cannot be parsed as JSON. The CLI feeds\n * this into `buildMigrationArtifacts` so the pure builder can preserve\n * fields owned by `migration plan` (contract bookends, `createdAt`) across\n * re-emits.\n *\n * Author-time path: this loader still does not verify the manifest hash\n * or schema — that is the apply-time loader's job. Hash mismatch is the\n * *expected* outcome of a re-author (the developer's source changes\n * invalidate the prior hash by construction), and verification here\n * would block legitimate regenerations. Syntactic JSON-parse failure,\n * however, is now surfaced rather than swallowed: a malformed\n * `migration.json` indicates either a hand-edit gone wrong or partial\n * write, and silently rebuilding from `describe()` would discard the\n * user's on-disk content (preserved bookends, `createdAt`) without any\n * indication something was wrong on disk.\n * Apply-time consumers always route through the verifying\n * `readMigrationPackage` in `@prisma-next/migration-tools/io` instead.\n */\nfunction readExistingMetadata(metadataPath: string): Partial<MigrationMetadata> | null {\n  let raw: string;\n  try {\n    raw = readFileSync(metadataPath, 'utf-8');\n  } catch {\n    return null;\n  }\n  try {\n    return JSON.parse(raw) as Partial<MigrationMetadata>;\n  } catch (e) {\n    throw errorInvalidJson(metadataPath, e instanceof Error ? e.message : String(e));\n  }\n}\n\n/**\n * Persist a migration instance's artifacts to `migrationDir`. In\n * `dryRun` mode the artifacts are printed to stdout (with the same\n * `--- migration.json --- / --- ops.json ---` framing the legacy\n * `serializeMigration` helper used) and no files are written. Otherwise\n * `ops.json` and `migration.json` are written next to `migration.ts` and\n * a confirmation line is printed.\n *\n * File I/O lives in the CLI rather than `@prisma-next/migration-tools`\n * so the migration-tools package stays focused on the pure\n * `Migration` → in-memory artifact conversion. The CLI is the only\n * legitimate site for combining config loading, stack assembly, and\n * filesystem persistence.\n */\nasync function serializeMigrationToDisk(\n  instance: Migration,\n  migrationDir: string,\n  dryRun: boolean,\n  stdout: MigrationCliWritable,\n): Promise<void> {\n  const metadataPath = join(migrationDir, 'migration.json');\n  const existing = readExistingMetadata(metadataPath);\n  const { opsJson, metadataJson } = await buildMigrationArtifacts(instance, existing);\n\n  if (dryRun) {\n    stdout.write(`--- migration.json ---\\n${metadataJson}\\n`);\n    stdout.write('--- ops.json ---\\n');\n    stdout.write(`${opsJson}\\n`);\n    return;\n  }\n\n  writeFileSync(join(migrationDir, 'ops.json'), opsJson);\n  writeFileSync(metadataPath, metadataJson);\n\n  stdout.write(`Wrote ops.json + migration.json to ${migrationDir}\\n`);\n}\n\n/**\n * Inner orchestration: load config, probe-construct the migration,\n * verify target, assemble the stack, construct with the stack, persist.\n *\n * Throws `CliStructuredError` for known failure modes (config not\n * found, target mismatch); the outer `orchestrate` translates those to\n * exit 1.\n */\nasync function runMigration(\n  importMetaUrl: string,\n  MigrationClass: MigrationConstructor,\n  parsed: MigrationFileCommand,\n  ctx: {\n    readonly stdout: MigrationCliWritable;\n    readonly stderr: MigrationCliWritable;\n  },\n): Promise<void> {\n  const migrationFile = fileURLToPath(importMetaUrl);\n  const migrationDir = dirname(migrationFile);\n\n  const config = await loadConfig(parsed.config);\n\n  // Probe-instantiate without a stack so we can read `targetId` before\n  // any target-specific constructor side effects (e.g.\n  // `PostgresMigration`'s `stack.adapter.create(stack)`) run. Concrete\n  // subclasses are required to accept the no-arg form; the abstract\n  // `Migration` constructor declares `stack?` and target subclasses\n  // (Postgres, Mongo) propagate that optionality. This makes the\n  // target-mismatch guard fail fast with `PN-MIG-2006` before any\n  // stack-driven adapter construction begins, even if the wrong-target\n  // adapter's `create` would otherwise succeed and silently misshapen\n  // the stored adapter cast.\n  const probe = new MigrationClass();\n\n  if (probe.targetId !== config.target.targetId) {\n    throw errorMigrationTargetMismatch({\n      migrationTargetId: probe.targetId,\n      configTargetId: config.target.targetId,\n    });\n  }\n\n  const stack = createControlStack(config);\n  const instance = new MigrationClass(stack);\n\n  await serializeMigrationToDisk(instance, migrationDir, parsed.dryRun, ctx.stdout);\n  void ctx.stderr;\n}\n"],"mappings":"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"}

package/dist/{migration-command-scaffold-DA-Lhx6o.mjs → migration-command-scaffold-B3m-MMAx.mjs}

@@ -1,7 +1,7 @@
-import { t as loadConfig } from "./config-loader-p9JMrekQ.mjs";
-import { A as formatStyledHeader, B as errorContractValidationFailed, U as errorDriverRequired, V as errorDatabaseConnectionRequired, W as errorFileNotFound, ct as errorUnexpected, i as maskConnectionUrl, o as resolveContractPath, ot as errorTargetMigrationNotSupported, t as addGlobalOptions } from "./command-helpers-DGMvGBeX.mjs";
+import { A as formatStyledHeader, B as errorContractValidationFailed, U as errorDriverRequired, V as errorDatabaseConnectionRequired, W as errorFileNotFound, ct as errorUnexpected, i as maskConnectionUrl, o as resolveContractPath, ot as errorTargetMigrationNotSupported, t as addGlobalOptions } from "./command-helpers-CNwURRf9.mjs";
 import { t as createProgressAdapter } from "./progress-adapter-CjAeTxY_.mjs";
-import { t as createControlClient } from "./client-CJzuo5wX.mjs";
+import { t as createControlClient } from "./client-DwOyZz0a.mjs";
+import { loadConfig } from "@prisma-next/config-loader";
 import { notOk, ok } from "@prisma-next/utils/result";
 import { readFile } from "node:fs/promises";
 import { hasMigrations } from "@prisma-next/framework-components/control";
@@ -100,4 +100,4 @@ function addMigrationCommandOptions(command) {
 //#endregion
 export { prepareMigrationContext as n, addMigrationCommandOptions as t };
 
-//# sourceMappingURL=migration-command-scaffold-DA-Lhx6o.mjs.map
+//# sourceMappingURL=migration-command-scaffold-B3m-MMAx.mjs.map

package/dist/migration-command-scaffold-B3m-MMAx.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-command-scaffold-B3m-MMAx.mjs","names":[],"sources":["../src/utils/migration-command-scaffold.ts"],"sourcesContent":["import { readFile } from 'node:fs/promises';\nimport { relative, resolve } from 'node:path';\nimport { loadConfig } from '@prisma-next/config-loader';\nimport { hasMigrations } from '@prisma-next/framework-components/control';\nimport { notOk, ok, type Result } from '@prisma-next/utils/result';\nimport type { Command } from 'commander';\nimport { createControlClient } from '../control-api/client';\nimport type { ControlClient } from '../control-api/types';\nimport {\n  type CliStructuredError,\n  errorContractValidationFailed,\n  errorDatabaseConnectionRequired,\n  errorDriverRequired,\n  errorFileNotFound,\n  errorTargetMigrationNotSupported,\n  errorUnexpected,\n} from './cli-errors';\nimport { addGlobalOptions, maskConnectionUrl, resolveContractPath } from './command-helpers';\nimport { formatStyledHeader } from './formatters/styled';\nimport type { GlobalFlags } from './global-flags';\nimport { createProgressAdapter } from './progress-adapter';\nimport type { TerminalUI } from './terminal-ui';\n\n/**\n * Resolved context for a migration command.\n * Contains everything needed to invoke a control-api operation.\n */\nexport interface MigrationContext {\n  readonly client: ControlClient;\n  readonly contractJson: Record<string, unknown>;\n  readonly dbConnection: unknown;\n  readonly onProgress: ReturnType<typeof createProgressAdapter>;\n  readonly configPath: string;\n  readonly contractPath: string;\n  readonly contractPathAbsolute: string;\n  readonly config: Awaited<ReturnType<typeof loadConfig>>;\n}\n\n/**\n * Command-specific configuration for the shared scaffold.\n */\nexport interface MigrationCommandDescriptor {\n  readonly commandName: string;\n  readonly description: string;\n  readonly url: string;\n}\n\n/**\n * Prepares the shared context for migration commands (db init, db update).\n *\n * Handles: config loading, contract file reading, JSON parsing, connection resolution,\n * driver/migration-support validation, client creation, and header output.\n *\n * Returns a Result with either the resolved context or a structured error.\n */\nexport async function prepareMigrationContext(\n  options: { readonly db?: string; readonly config?: string; readonly dryRun?: boolean },\n  flags: GlobalFlags,\n  ui: TerminalUI,\n  descriptor: MigrationCommandDescriptor,\n): Promise<Result<MigrationContext, CliStructuredError>> {\n  // Load config\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  // Output header to stderr (decoration)\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    ];\n    if (options.db) {\n      details.push({ label: 'database', value: maskConnectionUrl(options.db) });\n    }\n    if (options.dryRun) {\n      details.push({ label: 'mode', value: 'dry run' });\n    }\n    const header = formatStyledHeader({\n      command: descriptor.commandName,\n      description: descriptor.description,\n      url: descriptor.url,\n      details,\n      flags,\n    });\n    ui.stderr(header);\n  }\n\n  // Load contract file\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  // Parse contract JSON\n  let contractJson: Record<string, unknown>;\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  // 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 ${descriptor.commandName} (set db.connection in ${configPath}, or pass --db <url>)`,\n        commandName: descriptor.commandName,\n      }),\n    );\n  }\n\n  // Check for driver\n  if (!config.driver) {\n    return notOk(\n      errorDriverRequired({ why: `Config.driver is required for ${descriptor.commandName}` }),\n    );\n  }\n\n  if (!hasMigrations(config.target)) {\n    return notOk(\n      errorTargetMigrationNotSupported({\n        why: `Target \"${config.target.id}\" does not support migrations`,\n      }),\n    );\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  return ok({\n    client,\n    contractJson,\n    dbConnection,\n    onProgress,\n    configPath,\n    contractPath,\n    contractPathAbsolute,\n    config,\n  });\n}\n\n/**\n * Registers the shared CLI options for migration commands (db init, db update).\n */\nexport function addMigrationCommandOptions(command: Command): Command {\n  addGlobalOptions(command);\n  return command\n    .option('--db <url>', 'Database connection string')\n    .option('--config <path>', 'Path to prisma-next.config.ts')\n    .option('--dry-run', 'Preview planned operations without applying', false);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAuDA,eAAsB,wBACpB,SACA,OACA,IACA,YACuD;CAEvD,MAAM,SAAS,MAAM,WAAW,QAAQ,MAAM;CAC9C,MAAM,aAAa,QAAQ,SACvB,SAAS,QAAQ,IAAI,GAAG,QAAQ,QAAQ,MAAM,CAAC,IAC/C;CACJ,MAAM,uBAAuB,oBAAoB,MAAM;CACvD,MAAM,eAAe,SAAS,QAAQ,IAAI,GAAG,oBAAoB;CAGjE,IAAI,CAAC,MAAM,QAAQ,CAAC,MAAM,OAAO;EAC/B,MAAM,UAAmD,CACvD;GAAE,OAAO;GAAU,OAAO;EAAW,GACrC;GAAE,OAAO;GAAY,OAAO;EAAa,CAC3C;EACA,IAAI,QAAQ,IACV,QAAQ,KAAK;GAAE,OAAO;GAAY,OAAO,kBAAkB,QAAQ,EAAE;EAAE,CAAC;EAE1E,IAAI,QAAQ,QACV,QAAQ,KAAK;GAAE,OAAO;GAAQ,OAAO;EAAU,CAAC;EAElD,MAAM,SAAS,mBAAmB;GAChC,SAAS,WAAW;GACpB,aAAa,WAAW;GACxB,KAAK,WAAW;GAChB;GACA;EACF,CAAC;EACD,GAAG,OAAO,MAAM;CAClB;CAGA,IAAI;CACJ,IAAI;EACF,sBAAsB,MAAM,SAAS,sBAAsB,OAAO;CACpE,SAAS,OAAO;EACd,IAAI,iBAAiB,SAAU,MAA4B,SAAS,UAClE,OAAO,MACL,kBAAkB,sBAAsB;GACtC,KAAK,8BAA8B;GACnC,KAAK,iDAAiD,aAAa,4CAA4C;EACjH,CAAC,CACH;EAEF,OAAO,MACL,gBAAgB,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,GAAG,EACtE,KAAK,iCAAiC,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,IAC7F,CAAC,CACH;CACF;CAGA,IAAI;CACJ,IAAI;EACF,eAAe,KAAK,MAAM,mBAAmB;CAC/C,SAAS,OAAO;EACd,OAAO,MACL,8BACE,6BAA6B,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,KAClF,EAAE,OAAO,EAAE,MAAM,qBAAqB,EAAE,CAC1C,CACF;CACF;CAGA,MAAM,eAAe,QAAQ,MAAM,OAAO,IAAI;CAC9C,IAAI,CAAC,cACH,OAAO,MACL,gCAAgC;EAC9B,KAAK,uCAAuC,WAAW,YAAY,yBAAyB,WAAW;EACvG,aAAa,WAAW;CAC1B,CAAC,CACH;CAIF,IAAI,CAAC,OAAO,QACV,OAAO,MACL,oBAAoB,EAAE,KAAK,iCAAiC,WAAW,cAAc,CAAC,CACxF;CAGF,IAAI,CAAC,cAAc,OAAO,MAAM,GAC9B,OAAO,MACL,iCAAiC,EAC/B,KAAK,WAAW,OAAO,OAAO,GAAG,+BACnC,CAAC,CACH;CAIF,MAAM,SAAS,oBAAoB;EACjC,QAAQ,OAAO;EACf,QAAQ,OAAO;EACf,SAAS,OAAO;EAChB,QAAQ,OAAO;EACf,gBAAgB,OAAO,kBAAkB,CAAC;CAC5C,CAAC;CAGD,MAAM,aAAa,sBAAsB;EAAE;EAAI;CAAM,CAAC;CAEtD,OAAO,GAAG;EACR;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF,CAAC;AACH;;;;AAKA,SAAgB,2BAA2B,SAA2B;CACpE,iBAAiB,OAAO;CACxB,OAAO,QACJ,OAAO,cAAc,4BAA4B,CAAC,CAClD,OAAO,mBAAmB,+BAA+B,CAAC,CAC1D,OAAO,aAAa,+CAA+C,KAAK;AAC7E"}

package/dist/{migration-graph-command-render-CEez7YUK.mjs → migration-graph-command-render-B83xrnNy.mjs}

@@ -488,7 +488,7 @@ function buildGrid(rowModel, opts = {}, highlight = {
 	function vertCell(line) {
 		return { lines: [{
 			line,
-			directions: new Set(["up", "down"]),
+			directions: /* @__PURE__ */ new Set(["up", "down"]),
 			plane: planeOf(line.lane, line.role)
 		}] };
 	}
@@ -553,7 +553,7 @@ function buildGrid(rowModel, opts = {}, highlight = {
 		else row[col] = { lines: [cellLine] };
 	}
 	function placeBackVerticals(row) {
-		for (const arc of activeBackArcs) composeLine(row, arc.geomLane * colsPerLane, backArcLine(arc), new Set(["up", "down"]), backArcPlane(arc));
+		for (const arc of activeBackArcs) composeLine(row, arc.geomLane * colsPerLane, backArcLine(arc), /* @__PURE__ */ new Set(["up", "down"]), backArcPlane(arc));
 		placeAdjacentOverlays(row);
 	}
 	const activeAdjacent = /* @__PURE__ */ new Set();
@@ -562,7 +562,7 @@ function buildGrid(rowModel, opts = {}, highlight = {
 			const railCol = adj.lane * colsPerLane;
 			if (row[railCol]?.node) continue;
 			const line = lineRefFor(adj.edge, adj.lane);
-			composeLine(row, railCol, line, new Set(["up", "down"]), planeOf(adj.lane, line.role));
+			composeLine(row, railCol, line, /* @__PURE__ */ new Set(["up", "down"]), planeOf(adj.lane, line.role));
 		}
 	}
 	function emitBackArcTee(row, nodeLaneNum, arc) {
@@ -570,17 +570,17 @@ function buildGrid(rowModel, opts = {}, highlight = {
 		const geomRail = arc.geomLane * colsPerLane;
 		const line = backArcLine(arc);
 		const plane = backArcPlane(arc);
-		for (let col = nodeRail + 1; col < geomRail; col++) composeLine(row, col, line, new Set(["left", "right"]), plane);
-		composeLine(row, geomRail, line, new Set(["down", "left"]), plane);
+		for (let col = nodeRail + 1; col < geomRail; col++) composeLine(row, col, line, /* @__PURE__ */ new Set(["left", "right"]), plane);
+		composeLine(row, geomRail, line, /* @__PURE__ */ new Set(["down", "left"]), plane);
 	}
 	function emitBackArcLanding(row, nodeLaneNum, arc) {
 		const nodeRail = nodeLaneNum * colsPerLane;
 		const geomRail = arc.geomLane * colsPerLane;
 		const line = backArcLine(arc);
 		const plane = backArcPlane(arc);
-		composeLine(row, nodeRail + 1, line, new Set(["left", "right"]), plane, { landingArrow: true });
-		for (let col = nodeRail + 2; col < geomRail; col++) composeLine(row, col, line, new Set(["left", "right"]), plane);
-		composeLine(row, geomRail, line, new Set(["up", "left"]), plane);
+		composeLine(row, nodeRail + 1, line, /* @__PURE__ */ new Set(["left", "right"]), plane, { landingArrow: true });
+		for (let col = nodeRail + 2; col < geomRail; col++) composeLine(row, col, line, /* @__PURE__ */ new Set(["left", "right"]), plane);
+		composeLine(row, geomRail, line, /* @__PURE__ */ new Set(["up", "left"]), plane);
 	}
 	function emitConnectorRow(trunkLane, branchEntries, connectorType, trunkEdge) {
 		const row = makeRow();
@@ -608,7 +608,7 @@ function buildGrid(rowModel, opts = {}, highlight = {
 				lines: [...existing.lines, cellLine]
 			} : { lines: [cellLine] };
 		}
-		const cornerLeftDown = connectorType === "merge" ? new Set(["left", "down"]) : new Set(["left", "up"]);
+		const cornerLeftDown = connectorType === "merge" ? /* @__PURE__ */ new Set(["left", "down"]) : /* @__PURE__ */ new Set(["left", "up"]);
 		for (let i = 0; i < sorted.length; i++) {
 			const b = sorted[i];
 			if (b.lane === continuousLane) continue;
@@ -616,16 +616,16 @@ function buildGrid(rowModel, opts = {}, highlight = {
 			const railCol = b.lane * colsPerLane;
 			addLine(railCol, branchLine, cornerLeftDown);
 			const leftBound = i === 0 ? trunkRailCol + 1 : sorted[i - 1].lane * colsPerLane + 1;
-			for (let col = leftBound; col < railCol; col++) addLine(col, branchLine, new Set(["left", "right"]));
+			for (let col = leftBound; col < railCol; col++) addLine(col, branchLine, /* @__PURE__ */ new Set(["left", "right"]));
 		}
 		const continuousLine = continuousLane === trunkLane ? trunkEdge ? lineRefFor(trunkEdge, trunkLane) : getRepLine(trunkLane) : lineRefFor(branchByLane.get(continuousLane), continuousLane);
-		if (continuousLane === trunkLane) addLine(trunkRailCol, continuousLine, new Set(["up", "down"]));
+		if (continuousLane === trunkLane) addLine(trunkRailCol, continuousLine, /* @__PURE__ */ new Set(["up", "down"]));
 		else {
-			addLine(trunkRailCol, continuousLine, connectorType === "merge" ? new Set(["up", "right"]) : new Set(["down", "right"]));
-			for (let col = trunkRailCol + 1; col < continuousRailCol; col++) addLine(col, continuousLine, new Set(["left", "right"]));
+			addLine(trunkRailCol, continuousLine, connectorType === "merge" ? /* @__PURE__ */ new Set(["up", "right"]) : /* @__PURE__ */ new Set(["down", "right"]));
+			for (let col = trunkRailCol + 1; col < continuousRailCol; col++) addLine(col, continuousLine, /* @__PURE__ */ new Set(["left", "right"]));
 			addLine(continuousRailCol, continuousLine, cornerLeftDown);
 		}
-		placeVerticals(row, new Set([trunkLane, ...sorted.map((b) => b.lane)]));
+		placeVerticals(row, /* @__PURE__ */ new Set([trunkLane, ...sorted.map((b) => b.lane)]));
 		placeBackVerticals(row);
 		return row;
 	}
@@ -671,7 +671,7 @@ function buildGrid(rowModel, opts = {}, highlight = {
 				plane: planeOf(nodeLaneNum, line.role),
 				selfLoop: true
 			}] };
-			placeVerticals(row, new Set([nodeLaneNum]));
+			placeVerticals(row, /* @__PURE__ */ new Set([nodeLaneNum]));
 			placeBackVerticals(row);
 			grid.push(row);
 		}
@@ -684,7 +684,7 @@ function buildGrid(rowModel, opts = {}, highlight = {
 				lane: nodeLaneNum,
 				role: nodeRoleOf(nodeHash)
 			});
-			placeVerticals(row, new Set([nodeLaneNum]));
+			placeVerticals(row, /* @__PURE__ */ new Set([nodeLaneNum]));
 			const landingArcs = backArcsByTarget.get(nodeHash) ?? [];
 			for (const arc of landingArcs) activeBackArcs.delete(arc);
 			for (const adj of [...activeAdjacent]) if (adj.edge.to === nodeHash) activeAdjacent.delete(adj);
@@ -720,8 +720,8 @@ function buildGrid(rowModel, opts = {}, highlight = {
 				const connCol = railCol + 1;
 				const line = backArcLine(arc);
 				const plane = backArcPlane(arc);
-				composeLine(row, railCol, line, new Set(["up", "down"]), plane);
-				composeLine(row, connCol, line, new Set(["down"]), plane);
+				composeLine(row, railCol, line, /* @__PURE__ */ new Set(["up", "down"]), plane);
+				composeLine(row, connCol, line, /* @__PURE__ */ new Set(["down"]), plane);
 				placeVerticals(row, /* @__PURE__ */ new Set());
 				placeBackVerticals(row);
 				grid.push(row);
@@ -745,8 +745,8 @@ function buildGrid(rowModel, opts = {}, highlight = {
 			const connCol = eLane * colsPerLane + 1;
 			const line = lineRefFor(edge, eLane);
 			row[railCol] = vertCell(line);
-			row[connCol] = dirCell(line, new Set(["up"]));
-			placeVerticals(row, new Set([eLane]));
+			row[connCol] = dirCell(line, /* @__PURE__ */ new Set(["up"]));
+			placeVerticals(row, /* @__PURE__ */ new Set([eLane]));
 			placeBackVerticals(row);
 			grid.push(row);
 		}
@@ -757,7 +757,7 @@ function buildGrid(rowModel, opts = {}, highlight = {
 				const connCol = nodeLaneNum * colsPerLane + 1;
 				const line = lineRefFor(adj, nodeLaneNum);
 				const plane = planeOf(nodeLaneNum, line.role);
-				composeLine(row, connCol, line, new Set(["down"]), plane);
+				composeLine(row, connCol, line, /* @__PURE__ */ new Set(["down"]), plane);
 				placeVerticals(row, /* @__PURE__ */ new Set());
 				placeBackVerticals(row);
 				grid.push(row);
@@ -841,7 +841,7 @@ function canReachForward(start, goal, candidates) {
 		if (bucket) bucket.push(edge.to);
 		else outgoing.set(edge.from, [edge.to]);
 	}
-	const visited = new Set([start]);
+	const visited = /* @__PURE__ */ new Set([start]);
 	const queue = [start];
 	while (queue.length > 0) {
 		const node = queue.shift();
@@ -1143,7 +1143,7 @@ function isForwardLeaf(node, edges) {
 	return !edges.some((e) => e.kind === "forward" && e.from === node && e.from !== e.to);
 }
 function forwardReachableFrom(start, forwardTo) {
-	const reachable = new Set([start]);
+	const reachable = /* @__PURE__ */ new Set([start]);
 	const queue = [start];
 	while (queue.length > 0) {
 		const node = queue.shift();
@@ -1957,4 +1957,4 @@ function renderMigrationGraphCommand(input) {
 //#endregion
 export { migrationListEmptySource as _, renderMigrationGraphLegend as a, renderMigrationListWithStyle as c, highlightFromEdgeAnnotations as d, indentMigrationGraphTreeBlock as f, abbreviateContractHash as g, buildGrid as h, formatOnPathMigrationRow as i, computeGlobalMaxDirNameWidth as l, buildMigrationGraphRows as m, computeMaxDirNameWidth as n, createAnsiMigrationListStyler as o, renderMigrationGraphSpaceTree as p, renderMigrationGraphCommand as r, IDENTITY_MIGRATION_LIST_STYLER as s, computeLabelColumn as t, computeGlobalMaxEdgeTreePrefixWidth as u, migrationListForwardArrow as v };
 
-//# sourceMappingURL=migration-graph-command-render-CEez7YUK.mjs.map
+//# sourceMappingURL=migration-graph-command-render-B83xrnNy.mjs.map