@prisma-next/errors - npm Package Compare versions

Comparing version 0.5.0-dev.4 to 0.5.0-dev.5

dist/control-Bzl70Ny9.d.mts.map

@@ -1,1 +0,1 @@
-{"version":3,"file":"control-Bzl70Ny9.d.mts","names":[],"sources":["../src/control.ts"],"sourcesContent":[],"mappings":";;AAIA;AAqBA;AAIC;AAoBW,UA7CK,gBAAA,CA6CoB;EAMxB,SAAA,EAAA,EAAA,KAAA;EAEM,SAAA,IAAA,EAAA,MAAA;EAUF,SAAA,MAAA,EAAA,MAAA;EAOO,SAAA,QAAA,EAAA,OAAA,GAAA,MAAA,GAAA,MAAA;EAKF,SAAA,OAAA,EAAA,MAAA;EAwBN,SAAA,GAAA,EAAA,MAAA,GAAA,SAAA;EAmBsB,SAAA,GAAA,EAAA,MAAA,GAAA,SAAA;EAnEE,SAAA,KAAA,EAAA;IAAK,SAAA,IAAA,EAAA,MAAA,GAAA,SAAA;IA8F7B,SAAA,IAAA,EAAA,MAAA,GAAuB,SAKpC;EAaa,CAAA,GAAA,SAAA;EAcA,SAAA,IAAA,EAnKC,MAmKD,CAAA,MAAA,EAAA,OAA6B,CAAA,GAAA,SAK1C;EAaa,SAAA,OAAA,EAAA,MAAiB,GAAA,SAO9B;AAaH;AAoBA;AAcA;AAcA;AAoBgB,UAtQC,gBAAA,CAsQkB;EAYnB,SAAA,IAAA,EAAA,MAAA;EAuBA,SAAA,OAAA,EAAA,MAAA;EA2BA,SAAA,GAAA,CAAA,EAAA,MAAA;AAkBhB;AAkBA;AAqBA;;;;;;;;;;;;;;;cAvWM;KAEM,cAAA,WAAyB;;;;;cAMxB,kBAAA,SAA2B,KAAA;;mBAErB;;;;;;;;iBAUF;;;sBAOO;;;;;;;;oBAKF;;;;;;gBAwBN;;;;;sCAmBsB;;;;;iBA2BtB,uBAAA;;IAKb;;;;iBAaa,0BAAA;;IAEZ;;;;iBAYY,6BAAA;;;;;IAKb;;;;iBAaa,iBAAA;;;;IAOb;;;;iBAaa,+BAAA;;;;IAIZ;;;;iBAgBY,+BAAA;;IAEZ;;;;iBAYY,gCAAA;;IAEZ;;;;iBAYY,2BAAA;;;;IAIZ;;;;iBAgBY,mBAAA;;IAA0D;;;;iBAY1D,kCAAA;;;IAGZ;;;;iBAoBY,4BAAA;+BACe;;IAE3B;;;;iBAwBY,gCAAA;;IAEZ;;;;;;;;iBAgBY,iCAAA;;IAEZ;;;;iBAgBY,qBAAA;;IAKb;;;;iBAgBa,eAAA;;;IAMb"}
+{"version":3,"file":"control-Bzl70Ny9.d.mts","names":[],"sources":["../src/control.ts"],"sourcesContent":[],"mappings":";;AAIA;AAqBA;AAIC;AAoBW,UA7CK,gBAAA,CA6CoB;EAMxB,SAAA,EAAA,EAAA,KAAA;EAEM,SAAA,IAAA,EAAA,MAAA;EAUF,SAAA,MAAA,EAAA,MAAA;EAOO,SAAA,QAAA,EAAA,OAAA,GAAA,MAAA,GAAA,MAAA;EAKF,SAAA,OAAA,EAAA,MAAA;EAwBN,SAAA,GAAA,EAAA,MAAA,GAAA,SAAA;EAmBsB,SAAA,GAAA,EAAA,MAAA,GAAA,SAAA;EAnEE,SAAA,KAAA,EAAA;IAAK,SAAA,IAAA,EAAA,MAAA,GAAA,SAAA;IAgH7B,SAAA,IAAA,EAAA,MAAA,GAAuB,SAKpC;EAaa,CAAA,GAAA,SAAA;EAcA,SAAA,IAAA,EArLC,MAqLD,CAAA,MAAA,EAAA,OAA6B,CAAA,GAAA,SAK1C;EAaa,SAAA,OAAA,EAAA,MAAiB,GAAA,SAO9B;AAaH;AAoBA;AAcA;AAcA;AAoBgB,UAxRC,gBAAA,CAwRkB;EAYnB,SAAA,IAAA,EAAA,MAAA;EAuBA,SAAA,OAAA,EAAA,MAAA;EA2BA,SAAA,GAAA,CAAA,EAAA,MAAA;AAkBhB;AAkBA;AAqBA;;;;;;;;;;;;;;;cAzXM;KAEM,cAAA,WAAyB;;;;;cAMxB,kBAAA,SAA2B,KAAA;;mBAErB;;;;;;;;iBAUF;;;sBAOO;;;;;;;;oBAKF;;;;;;gBAwBN;;;;;sCAmBsB;;;;;iBA6CtB,uBAAA;;IAKb;;;;iBAaa,0BAAA;;IAEZ;;;;iBAYY,6BAAA;;;;;IAKb;;;;iBAaa,iBAAA;;;;IAOb;;;;iBAaa,+BAAA;;;;IAIZ;;;;iBAgBY,+BAAA;;IAEZ;;;;iBAYY,gCAAA;;IAEZ;;;;iBAYY,2BAAA;;;;IAIZ;;;;iBAgBY,mBAAA;;IAA0D;;;;iBAY1D,kCAAA;;;IAGZ;;;;iBAoBY,4BAAA;+BACe;;IAE3B;;;;iBAwBY,gCAAA;;IAEZ;;;;;;;;iBAgBY,iCAAA;;IAEZ;;;;iBAgBY,qBAAA;;IAKb;;;;iBAgBa,eAAA;;;IAMb"}

dist/control-Ly06UGvt.mjs.map

@@ -1,1 +0,1 @@
-{"version":3,"file":"control-Ly06UGvt.mjs","names":["CLI_ERROR_DOMAIN_SET: ReadonlySet<CliErrorDomain>"],"sources":["../src/control.ts"],"sourcesContent":["/**\n * CLI error envelope for output formatting.\n * This is the serialized form of a CliStructuredError.\n */\nexport interface CliErrorEnvelope {\n  readonly ok: false;\n  readonly code: string;\n  readonly domain: string;\n  readonly severity: 'error' | 'warn' | 'info';\n  readonly summary: string;\n  readonly why: string | undefined;\n  readonly fix: string | undefined;\n  readonly where:\n    | {\n        readonly path: string | undefined;\n        readonly line: number | undefined;\n      }\n    | undefined;\n  readonly meta: Record<string, unknown> | undefined;\n  readonly docsUrl: string | undefined;\n}\n\n/**\n * Minimal conflict data structure expected by CLI output.\n */\nexport interface CliErrorConflict {\n  readonly kind: string;\n  readonly summary: string;\n  readonly why?: string;\n}\n\n/**\n * Domain prefix for structured CLI error codes.\n *\n * The full envelope code is rendered as `PN-<domain>-<code>` (see\n * `CliStructuredError.toEnvelope`). The supported domains follow the\n * taxonomy documented in `docs/CLI Style Guide.md`:\n *\n * - `CLI`    — CLI command processing (config, validation, planning)\n * - `MIG`    — Migration subsystem (authoring, planning conflicts, runner)\n * - `RUN`    — Application runtime (query execution, streaming)\n * - `CON`    — Contract subsystem (validation, normalization)\n * - `SCHEMA` — Schema subsystem\n *\n * Sub-clustering within a domain is conveyed by the numeric code range; see\n * the per-domain source files for reserved ranges.\n */\nconst CLI_ERROR_DOMAINS = ['CLI', 'RUN', 'MIG', 'CON', 'SCHEMA'] as const;\n\nexport type CliErrorDomain = (typeof CLI_ERROR_DOMAINS)[number];\n\n/**\n * Structured CLI error that contains all information needed for error envelopes.\n * Call sites throw these errors with full context.\n */\nexport class CliStructuredError extends Error {\n  readonly code: string;\n  readonly domain: CliErrorDomain;\n  readonly severity: 'error' | 'warn' | 'info';\n  readonly why: string | undefined;\n  readonly fix: string | undefined;\n  readonly where:\n    | {\n        readonly path: string | undefined;\n        readonly line: number | undefined;\n      }\n    | undefined;\n  readonly meta: Record<string, unknown> | undefined;\n  readonly docsUrl: string | undefined;\n\n  constructor(\n    code: string,\n    summary: string,\n    options?: {\n      readonly domain?: CliErrorDomain;\n      readonly severity?: 'error' | 'warn' | 'info';\n      readonly why?: string;\n      readonly fix?: string;\n      readonly where?: { readonly path?: string; readonly line?: number };\n      readonly meta?: Record<string, unknown>;\n      readonly docsUrl?: string;\n    },\n  ) {\n    super(summary);\n    this.name = 'CliStructuredError';\n    this.code = code;\n    this.domain = options?.domain ?? 'CLI';\n    this.severity = options?.severity ?? 'error';\n    this.why = options?.why;\n    this.fix = options?.fix === options?.why ? undefined : options?.fix;\n    this.where = options?.where\n      ? {\n          path: options.where.path,\n          line: options.where.line,\n        }\n      : undefined;\n    this.meta = options?.meta;\n    this.docsUrl = options?.docsUrl;\n  }\n\n  /**\n   * Converts this error to a CLI error envelope for output formatting.\n   */\n  toEnvelope(): CliErrorEnvelope {\n    return {\n      ok: false as const,\n      code: `PN-${this.domain}-${this.code}`,\n      domain: this.domain,\n      severity: this.severity,\n      summary: this.message,\n      why: this.why,\n      fix: this.fix,\n      where: this.where,\n      meta: this.meta,\n      docsUrl: this.docsUrl,\n    };\n  }\n\n  /**\n   * Type guard to check if an error is a CliStructuredError.\n   * Uses duck-typing to work across module boundaries where instanceof may fail.\n   */\n  static is(error: unknown): error is CliStructuredError {\n    if (!(error instanceof Error)) {\n      return false;\n    }\n    const candidate = error as CliStructuredError;\n    return (\n      candidate.name === 'CliStructuredError' &&\n      typeof candidate.code === 'string' &&\n      isCliErrorDomain(candidate.domain) &&\n      typeof candidate.toEnvelope === 'function'\n    );\n  }\n}\n\nconst CLI_ERROR_DOMAIN_SET: ReadonlySet<CliErrorDomain> = new Set(CLI_ERROR_DOMAINS);\n\nfunction isCliErrorDomain(value: unknown): value is CliErrorDomain {\n  return typeof value === 'string' && CLI_ERROR_DOMAIN_SET.has(value as CliErrorDomain);\n}\n\n// ============================================================================\n// Config Errors (PN-CLI-4001-4007)\n// ============================================================================\n\n/**\n * Config file not found or missing.\n */\nexport function errorConfigFileNotFound(\n  configPath?: string,\n  options?: {\n    readonly why?: string;\n  },\n): CliStructuredError {\n  return new CliStructuredError('4001', 'Config file not found', {\n    domain: 'CLI',\n    ...(options?.why ? { why: options.why } : { why: 'Config file not found' }),\n    fix: \"Run 'prisma-next init' to create a config file\",\n    docsUrl: 'https://prisma-next.dev/docs/cli/config',\n    ...(configPath ? { where: { path: configPath } } : {}),\n  });\n}\n\n/**\n * Contract configuration missing from config.\n */\nexport function errorContractConfigMissing(options?: {\n  readonly why?: string;\n}): CliStructuredError {\n  return new CliStructuredError('4002', 'Contract configuration missing', {\n    domain: 'CLI',\n    why: options?.why ?? 'The contract configuration is required for emit',\n    fix: 'Add contract configuration to your prisma-next.config.ts',\n    docsUrl: 'https://prisma-next.dev/docs/cli/contract-emit',\n  });\n}\n\n/**\n * Contract validation failed.\n */\nexport function errorContractValidationFailed(\n  reason: string,\n  options?: {\n    readonly where?: { readonly path?: string; readonly line?: number };\n  },\n): CliStructuredError {\n  return new CliStructuredError('4003', 'Contract validation failed', {\n    domain: 'CLI',\n    why: reason,\n    fix: 'Re-run `prisma-next contract emit`, or fix the contract file and try again',\n    docsUrl: 'https://prisma-next.dev/docs/contracts',\n    ...(options?.where ? { where: options.where } : {}),\n  });\n}\n\n/**\n * File not found.\n */\nexport function errorFileNotFound(\n  filePath: string,\n  options?: {\n    readonly why?: string;\n    readonly fix?: string;\n    readonly docsUrl?: string;\n  },\n): CliStructuredError {\n  return new CliStructuredError('4004', 'File not found', {\n    domain: 'CLI',\n    why: options?.why ?? `File not found: ${filePath}`,\n    fix: options?.fix ?? 'Check that the file path is correct',\n    where: { path: filePath },\n    ...(options?.docsUrl ? { docsUrl: options.docsUrl } : {}),\n  });\n}\n\n/**\n * Database connection is required but not provided.\n */\nexport function errorDatabaseConnectionRequired(options?: {\n  readonly why?: string;\n  readonly commandName?: string;\n  readonly retryCommand?: string;\n}): CliStructuredError {\n  const runHint = options?.retryCommand\n    ? `Run \\`${options.retryCommand}\\``\n    : options?.commandName\n      ? `Run \\`prisma-next ${options.commandName} --db <url>\\``\n      : 'Provide `--db <url>`';\n  return new CliStructuredError('4005', 'Database connection is required', {\n    domain: 'CLI',\n    why: options?.why ?? 'Database connection is required for this command',\n    fix: `${runHint}, or set \\`db: { connection: \"postgres://…\" }\\` in prisma-next.config.ts`,\n  });\n}\n\n/**\n * Query runner factory is required but not provided in config.\n */\nexport function errorQueryRunnerFactoryRequired(options?: {\n  readonly why?: string;\n}): CliStructuredError {\n  return new CliStructuredError('4006', 'Query runner factory is required', {\n    domain: 'CLI',\n    why: options?.why ?? 'Config.db.queryRunnerFactory is required for db verify',\n    fix: 'Add db.queryRunnerFactory to prisma-next.config.ts',\n    docsUrl: 'https://prisma-next.dev/docs/cli/db-verify',\n  });\n}\n\n/**\n * Family verify.readMarker is required but not provided.\n */\nexport function errorFamilyReadMarkerSqlRequired(options?: {\n  readonly why?: string;\n}): CliStructuredError {\n  return new CliStructuredError('4007', 'Family readMarker() is required', {\n    domain: 'CLI',\n    why: options?.why ?? 'Family verify.readMarker is required for db verify',\n    fix: 'Ensure family.verify.readMarker() is exported by your family package',\n    docsUrl: 'https://prisma-next.dev/docs/cli/db-verify',\n  });\n}\n\n/**\n * JSON output format not supported.\n */\nexport function errorJsonFormatNotSupported(options: {\n  readonly command: string;\n  readonly format: string;\n  readonly supportedFormats: readonly string[];\n}): CliStructuredError {\n  return new CliStructuredError('4008', 'Unsupported JSON format', {\n    domain: 'CLI',\n    why: `The ${options.command} command does not support --json ${options.format}`,\n    fix: `Use --json ${options.supportedFormats.join(' or ')}, or omit --json for human output`,\n    meta: {\n      command: options.command,\n      format: options.format,\n      supportedFormats: options.supportedFormats,\n    },\n  });\n}\n\n/**\n * Driver is required for DB-connected commands but not provided.\n */\nexport function errorDriverRequired(options?: { readonly why?: string }): CliStructuredError {\n  return new CliStructuredError('4010', 'Driver is required for DB-connected commands', {\n    domain: 'CLI',\n    why: options?.why ?? 'Config.driver is required for DB-connected commands',\n    fix: 'Add a control-plane driver to prisma-next.config.ts (e.g. import a driver descriptor and set `driver: postgresDriver`)',\n    docsUrl: 'https://prisma-next.dev/docs/cli/config',\n  });\n}\n\n/**\n * Contract requires extension packs that are not provided by config descriptors.\n */\nexport function errorContractMissingExtensionPacks(options: {\n  readonly missingExtensionPacks: readonly string[];\n  readonly providedComponentIds: readonly string[];\n}): CliStructuredError {\n  const missing = [...options.missingExtensionPacks].sort();\n  return new CliStructuredError('4011', 'Missing extension packs in config', {\n    domain: 'CLI',\n    why:\n      missing.length === 1\n        ? `Contract requires extension pack '${missing[0]}', but CLI config does not provide a matching descriptor.`\n        : `Contract requires extension packs ${missing.map((p) => `'${p}'`).join(', ')}, but CLI config does not provide matching descriptors.`,\n    fix: 'Add the missing extension descriptors to `extensions` in prisma-next.config.ts',\n    docsUrl: 'https://prisma-next.dev/docs/cli/config',\n    meta: {\n      missingExtensionPacks: missing,\n      providedComponentIds: [...options.providedComponentIds].sort(),\n    },\n  });\n}\n\n/**\n * Migration planning failed due to conflicts.\n */\nexport function errorMigrationPlanningFailed(options: {\n  readonly conflicts: readonly CliErrorConflict[];\n  readonly why?: string;\n}): CliStructuredError {\n  const conflictSummaries = options.conflicts.map((c) => c.summary);\n  const computedWhy = options.why ?? conflictSummaries.join('\\n');\n\n  const conflictFixes = options.conflicts\n    .map((c) => c.why)\n    .filter((why): why is string => typeof why === 'string');\n  const computedFix =\n    conflictFixes.length > 0\n      ? conflictFixes.join('\\n')\n      : 'Use `db verify --schema-only` to inspect conflicts, or ensure the database is empty';\n\n  return new CliStructuredError('4020', 'Migration planning failed', {\n    domain: 'CLI',\n    why: computedWhy,\n    fix: computedFix,\n    meta: { conflicts: options.conflicts },\n    docsUrl: 'https://prisma-next.dev/docs/cli/db-init',\n  });\n}\n\n/**\n * Target does not support migrations (missing createPlanner/createRunner).\n */\nexport function errorTargetMigrationNotSupported(options?: {\n  readonly why?: string;\n}): CliStructuredError {\n  return new CliStructuredError('4021', 'Target does not support migrations', {\n    domain: 'CLI',\n    why: options?.why ?? 'The configured target does not provide migration planner/runner',\n    fix: 'Select a target that provides migrations (it must export `target.migrations` for db init)',\n    docsUrl: 'https://prisma-next.dev/docs/cli/db-init',\n  });\n}\n\n/**\n * The migration-file CLI received `--config` without a path argument (either\n * a bare trailing `--config`, or `--config` followed by another flag like\n * `--config --dry-run`). Surfacing this as a structured error fails fast\n * rather than silently consuming the next flag as the config path or\n * falling back to default discovery against the wrong project.\n */\nexport function errorMigrationCliInvalidConfigArg(options?: {\n  readonly nextToken?: string;\n}): CliStructuredError {\n  const why =\n    options?.nextToken !== undefined\n      ? `\\`--config\\` was followed by another flag (\\`${options.nextToken}\\`) instead of a path argument.`\n      : '`--config` was passed without a following path argument.';\n  return new CliStructuredError('4012', '--config flag requires a path argument', {\n    domain: 'CLI',\n    why,\n    fix: 'Pass a config path: `--config <path>` or `--config=<path>`.',\n    meta: options?.nextToken !== undefined ? { nextToken: options.nextToken } : {},\n  });\n}\n\n/**\n * Config validation error (missing required fields).\n */\nexport function errorConfigValidation(\n  field: string,\n  options?: {\n    readonly why?: string;\n  },\n): CliStructuredError {\n  return new CliStructuredError('4009', 'Config validation error', {\n    domain: 'CLI',\n    why: options?.why ?? `Config must have a \"${field}\" field`,\n    fix: 'Check your prisma-next.config.ts and ensure all required fields are provided',\n    docsUrl: 'https://prisma-next.dev/docs/cli/config',\n  });\n}\n\n// ============================================================================\n// Generic Error\n// ============================================================================\n\n/**\n * Generic unexpected error.\n */\nexport function errorUnexpected(\n  message: string,\n  options?: {\n    readonly why?: string;\n    readonly fix?: string;\n  },\n): CliStructuredError {\n  return new CliStructuredError('4999', 'Unexpected error', {\n    domain: 'CLI',\n    why: options?.why ?? message,\n    fix: options?.fix ?? 'Check the error message and try again',\n  });\n}\n"],"mappings":"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"}
+{"version":3,"file":"control-Ly06UGvt.mjs","names":["CLI_ERROR_DOMAIN_SET: ReadonlySet<CliErrorDomain>"],"sources":["../src/control.ts"],"sourcesContent":["/**\n * CLI error envelope for output formatting.\n * This is the serialized form of a CliStructuredError.\n */\nexport interface CliErrorEnvelope {\n  readonly ok: false;\n  readonly code: string;\n  readonly domain: string;\n  readonly severity: 'error' | 'warn' | 'info';\n  readonly summary: string;\n  readonly why: string | undefined;\n  readonly fix: string | undefined;\n  readonly where:\n    | {\n        readonly path: string | undefined;\n        readonly line: number | undefined;\n      }\n    | undefined;\n  readonly meta: Record<string, unknown> | undefined;\n  readonly docsUrl: string | undefined;\n}\n\n/**\n * Minimal conflict data structure expected by CLI output.\n */\nexport interface CliErrorConflict {\n  readonly kind: string;\n  readonly summary: string;\n  readonly why?: string;\n}\n\n/**\n * Domain prefix for structured CLI error codes.\n *\n * The full envelope code is rendered as `PN-<domain>-<code>` (see\n * `CliStructuredError.toEnvelope`). The supported domains follow the\n * taxonomy documented in `docs/CLI Style Guide.md`:\n *\n * - `CLI`    — CLI command processing (config, validation, planning)\n * - `MIG`    — Migration subsystem (authoring, planning conflicts, runner)\n * - `RUN`    — Application runtime (query execution, streaming)\n * - `CON`    — Contract subsystem (validation, normalization)\n * - `SCHEMA` — Schema subsystem\n *\n * Sub-clustering within a domain is conveyed by the numeric code range; see\n * the per-domain source files for reserved ranges.\n */\nconst CLI_ERROR_DOMAINS = ['CLI', 'RUN', 'MIG', 'CON', 'SCHEMA'] as const;\n\nexport type CliErrorDomain = (typeof CLI_ERROR_DOMAINS)[number];\n\n/**\n * Structured CLI error that contains all information needed for error envelopes.\n * Call sites throw these errors with full context.\n */\nexport class CliStructuredError extends Error {\n  readonly code: string;\n  readonly domain: CliErrorDomain;\n  readonly severity: 'error' | 'warn' | 'info';\n  readonly why: string | undefined;\n  readonly fix: string | undefined;\n  readonly where:\n    | {\n        readonly path: string | undefined;\n        readonly line: number | undefined;\n      }\n    | undefined;\n  readonly meta: Record<string, unknown> | undefined;\n  readonly docsUrl: string | undefined;\n\n  constructor(\n    code: string,\n    summary: string,\n    options?: {\n      readonly domain?: CliErrorDomain;\n      readonly severity?: 'error' | 'warn' | 'info';\n      readonly why?: string;\n      readonly fix?: string;\n      readonly where?: { readonly path?: string; readonly line?: number };\n      readonly meta?: Record<string, unknown>;\n      readonly docsUrl?: string;\n    },\n  ) {\n    super(summary);\n    this.name = 'CliStructuredError';\n    this.code = code;\n    this.domain = options?.domain ?? 'CLI';\n    this.severity = options?.severity ?? 'error';\n    this.why = options?.why;\n    this.fix = options?.fix === options?.why ? undefined : options?.fix;\n    this.where = options?.where\n      ? {\n          path: options.where.path,\n          line: options.where.line,\n        }\n      : undefined;\n    this.meta = options?.meta;\n    this.docsUrl = options?.docsUrl;\n  }\n\n  /**\n   * Converts this error to a CLI error envelope for output formatting.\n   */\n  toEnvelope(): CliErrorEnvelope {\n    return {\n      ok: false as const,\n      code: `PN-${this.domain}-${this.code}`,\n      domain: this.domain,\n      severity: this.severity,\n      summary: this.message,\n      why: this.why,\n      fix: this.fix,\n      where: this.where,\n      meta: this.meta,\n      docsUrl: this.docsUrl,\n    };\n  }\n\n  /**\n   * Type guard to check if an error is a CliStructuredError.\n   * Uses duck-typing to work across module boundaries where instanceof may fail.\n   */\n  static is(error: unknown): error is CliStructuredError {\n    if (!(error instanceof Error)) {\n      return false;\n    }\n    const candidate = error as CliStructuredError;\n    return (\n      candidate.name === 'CliStructuredError' &&\n      typeof candidate.code === 'string' &&\n      isCliErrorDomain(candidate.domain) &&\n      typeof candidate.toEnvelope === 'function'\n    );\n  }\n}\n\nconst CLI_ERROR_DOMAIN_SET: ReadonlySet<CliErrorDomain> = new Set(CLI_ERROR_DOMAINS);\n\nfunction isCliErrorDomain(value: unknown): value is CliErrorDomain {\n  return typeof value === 'string' && CLI_ERROR_DOMAIN_SET.has(value as CliErrorDomain);\n}\n\n// ============================================================================\n// Numeric range conventions for `PN-CLI-NNNN`\n// ============================================================================\n//\n// Sub-clustering inside the `CLI` domain uses the numeric prefix:\n//\n// - `4xxx` — generic / cross-command CLI errors authored here (config\n//   missing, file not found, contract validation, etc.).\n// - `5xxx` — command-specific CLI errors authored alongside the command\n//   itself (e.g. `init` errors live in\n//   `packages/1-framework/3-tooling/cli/src/commands/init/errors.ts`).\n//   The 5xxx range avoids collisions with the shared 4xxx pool while\n//   still belonging to the `CLI` domain — consumers branch on the full\n//   `PN-CLI-5007` form, so the prefix is purely an authoring guide.\n//\n// See [`docs/CLI Style Guide.md` § Errors](../../../../../docs/CLI%20Style%20Guide.md#errors)\n// and the per-command error file for the live reservation list.\n\n// ============================================================================\n// Config Errors (PN-CLI-4001-4007)\n// ============================================================================\n\n/**\n * Config file not found or missing.\n */\nexport function errorConfigFileNotFound(\n  configPath?: string,\n  options?: {\n    readonly why?: string;\n  },\n): CliStructuredError {\n  return new CliStructuredError('4001', 'Config file not found', {\n    domain: 'CLI',\n    ...(options?.why ? { why: options.why } : { why: 'Config file not found' }),\n    fix: \"Run 'prisma-next init' to create a config file\",\n    docsUrl: 'https://prisma-next.dev/docs/cli/config',\n    ...(configPath ? { where: { path: configPath } } : {}),\n  });\n}\n\n/**\n * Contract configuration missing from config.\n */\nexport function errorContractConfigMissing(options?: {\n  readonly why?: string;\n}): CliStructuredError {\n  return new CliStructuredError('4002', 'Contract configuration missing', {\n    domain: 'CLI',\n    why: options?.why ?? 'The contract configuration is required for emit',\n    fix: 'Add contract configuration to your prisma-next.config.ts',\n    docsUrl: 'https://prisma-next.dev/docs/cli/contract-emit',\n  });\n}\n\n/**\n * Contract validation failed.\n */\nexport function errorContractValidationFailed(\n  reason: string,\n  options?: {\n    readonly where?: { readonly path?: string; readonly line?: number };\n  },\n): CliStructuredError {\n  return new CliStructuredError('4003', 'Contract validation failed', {\n    domain: 'CLI',\n    why: reason,\n    fix: 'Re-run `prisma-next contract emit`, or fix the contract file and try again',\n    docsUrl: 'https://prisma-next.dev/docs/contracts',\n    ...(options?.where ? { where: options.where } : {}),\n  });\n}\n\n/**\n * File not found.\n */\nexport function errorFileNotFound(\n  filePath: string,\n  options?: {\n    readonly why?: string;\n    readonly fix?: string;\n    readonly docsUrl?: string;\n  },\n): CliStructuredError {\n  return new CliStructuredError('4004', 'File not found', {\n    domain: 'CLI',\n    why: options?.why ?? `File not found: ${filePath}`,\n    fix: options?.fix ?? 'Check that the file path is correct',\n    where: { path: filePath },\n    ...(options?.docsUrl ? { docsUrl: options.docsUrl } : {}),\n  });\n}\n\n/**\n * Database connection is required but not provided.\n */\nexport function errorDatabaseConnectionRequired(options?: {\n  readonly why?: string;\n  readonly commandName?: string;\n  readonly retryCommand?: string;\n}): CliStructuredError {\n  const runHint = options?.retryCommand\n    ? `Run \\`${options.retryCommand}\\``\n    : options?.commandName\n      ? `Run \\`prisma-next ${options.commandName} --db <url>\\``\n      : 'Provide `--db <url>`';\n  return new CliStructuredError('4005', 'Database connection is required', {\n    domain: 'CLI',\n    why: options?.why ?? 'Database connection is required for this command',\n    fix: `${runHint}, or set \\`db: { connection: \"postgres://…\" }\\` in prisma-next.config.ts`,\n  });\n}\n\n/**\n * Query runner factory is required but not provided in config.\n */\nexport function errorQueryRunnerFactoryRequired(options?: {\n  readonly why?: string;\n}): CliStructuredError {\n  return new CliStructuredError('4006', 'Query runner factory is required', {\n    domain: 'CLI',\n    why: options?.why ?? 'Config.db.queryRunnerFactory is required for db verify',\n    fix: 'Add db.queryRunnerFactory to prisma-next.config.ts',\n    docsUrl: 'https://prisma-next.dev/docs/cli/db-verify',\n  });\n}\n\n/**\n * Family verify.readMarker is required but not provided.\n */\nexport function errorFamilyReadMarkerSqlRequired(options?: {\n  readonly why?: string;\n}): CliStructuredError {\n  return new CliStructuredError('4007', 'Family readMarker() is required', {\n    domain: 'CLI',\n    why: options?.why ?? 'Family verify.readMarker is required for db verify',\n    fix: 'Ensure family.verify.readMarker() is exported by your family package',\n    docsUrl: 'https://prisma-next.dev/docs/cli/db-verify',\n  });\n}\n\n/**\n * JSON output format not supported.\n */\nexport function errorJsonFormatNotSupported(options: {\n  readonly command: string;\n  readonly format: string;\n  readonly supportedFormats: readonly string[];\n}): CliStructuredError {\n  return new CliStructuredError('4008', 'Unsupported JSON format', {\n    domain: 'CLI',\n    why: `The ${options.command} command does not support --json ${options.format}`,\n    fix: `Use --json ${options.supportedFormats.join(' or ')}, or omit --json for human output`,\n    meta: {\n      command: options.command,\n      format: options.format,\n      supportedFormats: options.supportedFormats,\n    },\n  });\n}\n\n/**\n * Driver is required for DB-connected commands but not provided.\n */\nexport function errorDriverRequired(options?: { readonly why?: string }): CliStructuredError {\n  return new CliStructuredError('4010', 'Driver is required for DB-connected commands', {\n    domain: 'CLI',\n    why: options?.why ?? 'Config.driver is required for DB-connected commands',\n    fix: 'Add a control-plane driver to prisma-next.config.ts (e.g. import a driver descriptor and set `driver: postgresDriver`)',\n    docsUrl: 'https://prisma-next.dev/docs/cli/config',\n  });\n}\n\n/**\n * Contract requires extension packs that are not provided by config descriptors.\n */\nexport function errorContractMissingExtensionPacks(options: {\n  readonly missingExtensionPacks: readonly string[];\n  readonly providedComponentIds: readonly string[];\n}): CliStructuredError {\n  const missing = [...options.missingExtensionPacks].sort();\n  return new CliStructuredError('4011', 'Missing extension packs in config', {\n    domain: 'CLI',\n    why:\n      missing.length === 1\n        ? `Contract requires extension pack '${missing[0]}', but CLI config does not provide a matching descriptor.`\n        : `Contract requires extension packs ${missing.map((p) => `'${p}'`).join(', ')}, but CLI config does not provide matching descriptors.`,\n    fix: 'Add the missing extension descriptors to `extensions` in prisma-next.config.ts',\n    docsUrl: 'https://prisma-next.dev/docs/cli/config',\n    meta: {\n      missingExtensionPacks: missing,\n      providedComponentIds: [...options.providedComponentIds].sort(),\n    },\n  });\n}\n\n/**\n * Migration planning failed due to conflicts.\n */\nexport function errorMigrationPlanningFailed(options: {\n  readonly conflicts: readonly CliErrorConflict[];\n  readonly why?: string;\n}): CliStructuredError {\n  const conflictSummaries = options.conflicts.map((c) => c.summary);\n  const computedWhy = options.why ?? conflictSummaries.join('\\n');\n\n  const conflictFixes = options.conflicts\n    .map((c) => c.why)\n    .filter((why): why is string => typeof why === 'string');\n  const computedFix =\n    conflictFixes.length > 0\n      ? conflictFixes.join('\\n')\n      : 'Use `db verify --schema-only` to inspect conflicts, or ensure the database is empty';\n\n  return new CliStructuredError('4020', 'Migration planning failed', {\n    domain: 'CLI',\n    why: computedWhy,\n    fix: computedFix,\n    meta: { conflicts: options.conflicts },\n    docsUrl: 'https://prisma-next.dev/docs/cli/db-init',\n  });\n}\n\n/**\n * Target does not support migrations (missing createPlanner/createRunner).\n */\nexport function errorTargetMigrationNotSupported(options?: {\n  readonly why?: string;\n}): CliStructuredError {\n  return new CliStructuredError('4021', 'Target does not support migrations', {\n    domain: 'CLI',\n    why: options?.why ?? 'The configured target does not provide migration planner/runner',\n    fix: 'Select a target that provides migrations (it must export `target.migrations` for db init)',\n    docsUrl: 'https://prisma-next.dev/docs/cli/db-init',\n  });\n}\n\n/**\n * The migration-file CLI received `--config` without a path argument (either\n * a bare trailing `--config`, or `--config` followed by another flag like\n * `--config --dry-run`). Surfacing this as a structured error fails fast\n * rather than silently consuming the next flag as the config path or\n * falling back to default discovery against the wrong project.\n */\nexport function errorMigrationCliInvalidConfigArg(options?: {\n  readonly nextToken?: string;\n}): CliStructuredError {\n  const why =\n    options?.nextToken !== undefined\n      ? `\\`--config\\` was followed by another flag (\\`${options.nextToken}\\`) instead of a path argument.`\n      : '`--config` was passed without a following path argument.';\n  return new CliStructuredError('4012', '--config flag requires a path argument', {\n    domain: 'CLI',\n    why,\n    fix: 'Pass a config path: `--config <path>` or `--config=<path>`.',\n    meta: options?.nextToken !== undefined ? { nextToken: options.nextToken } : {},\n  });\n}\n\n/**\n * Config validation error (missing required fields).\n */\nexport function errorConfigValidation(\n  field: string,\n  options?: {\n    readonly why?: string;\n  },\n): CliStructuredError {\n  return new CliStructuredError('4009', 'Config validation error', {\n    domain: 'CLI',\n    why: options?.why ?? `Config must have a \"${field}\" field`,\n    fix: 'Check your prisma-next.config.ts and ensure all required fields are provided',\n    docsUrl: 'https://prisma-next.dev/docs/cli/config',\n  });\n}\n\n// ============================================================================\n// Generic Error\n// ============================================================================\n\n/**\n * Generic unexpected error.\n */\nexport function errorUnexpected(\n  message: string,\n  options?: {\n    readonly why?: string;\n    readonly fix?: string;\n  },\n): CliStructuredError {\n  return new CliStructuredError('4999', 'Unexpected error', {\n    domain: 'CLI',\n    why: options?.why ?? message,\n    fix: options?.fix ?? 'Check the error message and try again',\n  });\n}\n"],"mappings":"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"}

package.json

 {
   "name": "@prisma-next/errors",
-  "version": "0.5.0-dev.4",
+  "version": "0.5.0-dev.5",
   "type": "module",
@@ -8,4 +8,4 @@ "sideEffects": false,
   "dependencies": {
-    "@prisma-next/framework-components": "0.5.0-dev.4",
-    "@prisma-next/utils": "0.5.0-dev.4"
+    "@prisma-next/framework-components": "0.5.0-dev.5",
+    "@prisma-next/utils": "0.5.0-dev.5"
   },
@@ -12,0 +12,0 @@ "devDependencies": {

src/control.ts

@@ -144,2 +144,20 @@ /**
 // ============================================================================
+// Numeric range conventions for `PN-CLI-NNNN`
+// ============================================================================
+//
+// Sub-clustering inside the `CLI` domain uses the numeric prefix:
+//
+// - `4xxx` — generic / cross-command CLI errors authored here (config
+//   missing, file not found, contract validation, etc.).
+// - `5xxx` — command-specific CLI errors authored alongside the command
+//   itself (e.g. `init` errors live in
+//   `packages/1-framework/3-tooling/cli/src/commands/init/errors.ts`).
+//   The 5xxx range avoids collisions with the shared 4xxx pool while
+//   still belonging to the `CLI` domain — consumers branch on the full
+//   `PN-CLI-5007` form, so the prefix is purely an authoring guide.
+//
+// See [`docs/CLI Style Guide.md` § Errors](../../../../../docs/CLI%20Style%20Guide.md#errors)
+// and the per-command error file for the live reservation list.
+
+// ============================================================================
 // Config Errors (PN-CLI-4001-4007)
@@ -146,0 +164,0 @@ // ============================================================================

No alert changes

Improved metrics

Total package byte prevSize

116217

1.73%

Lines of code

1244

1.39%

Dependency changes

• + Added

  @prisma-next/contract@0.5.0-dev.5
  (transitive)

• + Added

  @prisma-next/framework-components@0.5.0-dev.5
  (transitive)

• + Added

  @prisma-next/operations@0.5.0-dev.5
  (transitive)

• + Added

  @prisma-next/utils@0.5.0-dev.5
  (transitive)

• - Removed

  @prisma-next/contract@0.5.0-dev.4
  (transitive)

• - Removed

  @prisma-next/framework-components@0.5.0-dev.4
  (transitive)

• - Removed

  @prisma-next/operations@0.5.0-dev.4
  (transitive)

• - Removed

  @prisma-next/utils@0.5.0-dev.4
  (transitive)

• Updated

  @prisma-next/framework-components@0.5.0-dev.5

• Updated

  @prisma-next/utils@0.5.0-dev.5