@prisma-next/core-control-plane 0.3.0-dev.55 → 0.3.0-dev.57

package/dist/errors-CvuQhtGp.mjs

@@ -1,310 +0,0 @@
-//#region src/errors.ts
-/**
-* Structured CLI error that contains all information needed for error envelopes.
-* Call sites throw these errors with full context.
-*/
-var CliStructuredError = class extends Error {
-	code;
-	domain;
-	severity;
-	why;
-	fix;
-	where;
-	meta;
-	docsUrl;
-	constructor(code, summary, options) {
-		super(summary);
-		this.name = "CliStructuredError";
-		this.code = code;
-		this.domain = options?.domain ?? "CLI";
-		this.severity = options?.severity ?? "error";
-		this.why = options?.why;
-		this.fix = options?.fix === options?.why ? void 0 : options?.fix;
-		this.where = options?.where ? {
-			path: options.where.path,
-			line: options.where.line
-		} : void 0;
-		this.meta = options?.meta;
-		this.docsUrl = options?.docsUrl;
-	}
-	/**
-	* Converts this error to a CLI error envelope for output formatting.
-	*/
-	toEnvelope() {
-		return {
-			ok: false,
-			code: `${this.domain === "CLI" ? "PN-CLI-" : "PN-RTM-"}${this.code}`,
-			domain: this.domain,
-			severity: this.severity,
-			summary: this.message,
-			why: this.why,
-			fix: this.fix,
-			where: this.where,
-			meta: this.meta,
-			docsUrl: this.docsUrl
-		};
-	}
-	/**
-	* Type guard to check if an error is a CliStructuredError.
-	* Uses duck-typing to work across module boundaries where instanceof may fail.
-	*/
-	static is(error) {
-		if (!(error instanceof Error)) return false;
-		const candidate = error;
-		return candidate.name === "CliStructuredError" && typeof candidate.code === "string" && (candidate.domain === "CLI" || candidate.domain === "RTM") && typeof candidate.toEnvelope === "function";
-	}
-};
-/**
-* Config file not found or missing.
-*/
-function errorConfigFileNotFound(configPath, options) {
-	return new CliStructuredError("4001", "Config file not found", {
-		domain: "CLI",
-		...options?.why ? { why: options.why } : { why: "Config file not found" },
-		fix: "Run 'prisma-next init' to create a config file",
-		docsUrl: "https://prisma-next.dev/docs/cli/config",
-		...configPath ? { where: { path: configPath } } : {}
-	});
-}
-/**
-* Contract configuration missing from config.
-*/
-function errorContractConfigMissing(options) {
-	return new CliStructuredError("4002", "Contract configuration missing", {
-		domain: "CLI",
-		why: options?.why ?? "The contract configuration is required for emit",
-		fix: "Add contract configuration to your prisma-next.config.ts",
-		docsUrl: "https://prisma-next.dev/docs/cli/contract-emit"
-	});
-}
-/**
-* Contract validation failed.
-*/
-function errorContractValidationFailed(reason, options) {
-	return new CliStructuredError("4003", "Contract validation failed", {
-		domain: "CLI",
-		why: reason,
-		fix: "Re-run `prisma-next contract emit`, or fix the contract file and try again",
-		docsUrl: "https://prisma-next.dev/docs/contracts",
-		...options?.where ? { where: options.where } : {}
-	});
-}
-/**
-* File not found.
-*/
-function errorFileNotFound(filePath, options) {
-	return new CliStructuredError("4004", "File not found", {
-		domain: "CLI",
-		why: options?.why ?? `File not found: ${filePath}`,
-		fix: options?.fix ?? "Check that the file path is correct",
-		where: { path: filePath },
-		...options?.docsUrl ? { docsUrl: options.docsUrl } : {}
-	});
-}
-/**
-* Database connection is required but not provided.
-*/
-function errorDatabaseConnectionRequired(options) {
-	return new CliStructuredError("4005", "Database connection is required", {
-		domain: "CLI",
-		why: options?.why ?? "Database connection is required for this command",
-		fix: "Provide `--db <url>` or set `db: { connection: \"postgres://…\" }` in prisma-next.config.ts"
-	});
-}
-/**
-* Query runner factory is required but not provided in config.
-*/
-function errorQueryRunnerFactoryRequired(options) {
-	return new CliStructuredError("4006", "Query runner factory is required", {
-		domain: "CLI",
-		why: options?.why ?? "Config.db.queryRunnerFactory is required for db verify",
-		fix: "Add db.queryRunnerFactory to prisma-next.config.ts",
-		docsUrl: "https://prisma-next.dev/docs/cli/db-verify"
-	});
-}
-/**
-* Family verify.readMarker is required but not provided.
-*/
-function errorFamilyReadMarkerSqlRequired(options) {
-	return new CliStructuredError("4007", "Family readMarker() is required", {
-		domain: "CLI",
-		why: options?.why ?? "Family verify.readMarker is required for db verify",
-		fix: "Ensure family.verify.readMarker() is exported by your family package",
-		docsUrl: "https://prisma-next.dev/docs/cli/db-verify"
-	});
-}
-/**
-* JSON output format not supported.
-*/
-function errorJsonFormatNotSupported(options) {
-	return new CliStructuredError("4008", "Unsupported JSON format", {
-		domain: "CLI",
-		why: `The ${options.command} command does not support --json ${options.format}`,
-		fix: `Use --json ${options.supportedFormats.join(" or ")}, or omit --json for human output`,
-		meta: {
-			command: options.command,
-			format: options.format,
-			supportedFormats: options.supportedFormats
-		}
-	});
-}
-/**
-* Driver is required for DB-connected commands but not provided.
-*/
-function errorDriverRequired(options) {
-	return new CliStructuredError("4010", "Driver is required for DB-connected commands", {
-		domain: "CLI",
-		why: options?.why ?? "Config.driver is required for DB-connected commands",
-		fix: "Add a control-plane driver to prisma-next.config.ts (e.g. import a driver descriptor and set `driver: postgresDriver`)",
-		docsUrl: "https://prisma-next.dev/docs/cli/config"
-	});
-}
-/**
-* Contract requires extension packs that are not provided by config descriptors.
-*/
-function errorContractMissingExtensionPacks(options) {
-	const missing = [...options.missingExtensionPacks].sort();
-	return new CliStructuredError("4011", "Missing extension packs in config", {
-		domain: "CLI",
-		why: missing.length === 1 ? `Contract requires extension pack '${missing[0]}', but CLI config does not provide a matching descriptor.` : `Contract requires extension packs ${missing.map((p) => `'${p}'`).join(", ")}, but CLI config does not provide matching descriptors.`,
-		fix: "Add the missing extension descriptors to `extensions` in prisma-next.config.ts",
-		docsUrl: "https://prisma-next.dev/docs/cli/config",
-		meta: {
-			missingExtensionPacks: missing,
-			providedComponentIds: [...options.providedComponentIds].sort()
-		}
-	});
-}
-/**
-* Migration planning failed due to conflicts.
-*/
-function errorMigrationPlanningFailed(options) {
-	const conflictSummaries = options.conflicts.map((c) => c.summary);
-	const computedWhy = options.why ?? conflictSummaries.join("\n");
-	const conflictFixes = options.conflicts.map((c) => c.why).filter((why) => typeof why === "string");
-	return new CliStructuredError("4020", "Migration planning failed", {
-		domain: "CLI",
-		why: computedWhy,
-		fix: conflictFixes.length > 0 ? conflictFixes.join("\n") : "Use `db schema-verify` to inspect conflicts, or ensure the database is empty",
-		meta: { conflicts: options.conflicts },
-		docsUrl: "https://prisma-next.dev/docs/cli/db-init"
-	});
-}
-/**
-* Target does not support migrations (missing createPlanner/createRunner).
-*/
-function errorTargetMigrationNotSupported(options) {
-	return new CliStructuredError("4021", "Target does not support migrations", {
-		domain: "CLI",
-		why: options?.why ?? "The configured target does not provide migration planner/runner",
-		fix: "Select a target that provides migrations (it must export `target.migrations` for db init)",
-		docsUrl: "https://prisma-next.dev/docs/cli/db-init"
-	});
-}
-/**
-* Config validation error (missing required fields).
-*/
-function errorConfigValidation(field, options) {
-	return new CliStructuredError("4009", "Config validation error", {
-		domain: "CLI",
-		why: options?.why ?? `Config must have a "${field}" field`,
-		fix: "Check your prisma-next.config.ts and ensure all required fields are provided",
-		docsUrl: "https://prisma-next.dev/docs/cli/config"
-	});
-}
-/**
-* Contract marker not found in database.
-*/
-function errorMarkerMissing(options) {
-	return new CliStructuredError("3001", "Database not signed", {
-		domain: "RTM",
-		why: options?.why ?? "No database signature (marker) found",
-		fix: "Run `prisma-next db sign --db <url>` to sign the database"
-	});
-}
-/**
-* Contract hash does not match database marker.
-*/
-function errorHashMismatch(options) {
-	return new CliStructuredError("3002", "Hash mismatch", {
-		domain: "RTM",
-		why: options?.why ?? "Contract hash does not match database marker",
-		fix: "Migrate database or re-sign if intentional",
-		...options?.expected || options?.actual ? { meta: {
-			...options.expected ? { expected: options.expected } : {},
-			...options.actual ? { actual: options.actual } : {}
-		} } : {}
-	});
-}
-/**
-* Contract target does not match config target.
-*/
-function errorTargetMismatch(expected, actual, options) {
-	return new CliStructuredError("3003", "Target mismatch", {
-		domain: "RTM",
-		why: options?.why ?? `Contract target does not match config target (expected: ${expected}, actual: ${actual})`,
-		fix: "Align contract target and config target",
-		meta: {
-			expected,
-			actual
-		}
-	});
-}
-/**
-* Database marker is required but not found.
-* Used by commands that require a pre-existing marker as a precondition.
-*/
-function errorMarkerRequired(options) {
-	return new CliStructuredError("3010", "Database must be signed first", {
-		domain: "RTM",
-		why: options?.why ?? "No database signature (marker) found",
-		fix: options?.fix ?? "Run `prisma-next db init` first to sign the database"
-	});
-}
-/**
-* Migration runner failed during execution.
-*/
-function errorRunnerFailed(summary, options) {
-	return new CliStructuredError("3020", summary, {
-		domain: "RTM",
-		why: options?.why ?? "Migration runner failed",
-		fix: options?.fix ?? "Inspect the reported conflict and reconcile schema drift",
-		...options?.meta ? { meta: options.meta } : {}
-	});
-}
-/**
-* Destructive operations require explicit confirmation via --accept-data-loss.
-*/
-function errorDestructiveChanges(summary, options) {
-	return new CliStructuredError("3030", summary, {
-		domain: "RTM",
-		why: options?.why ?? "Planned operations include destructive changes that require confirmation",
-		fix: options?.fix ?? "Use `--plan` to preview, then re-run with `--accept-data-loss`",
-		...options?.meta ? { meta: options.meta } : {}
-	});
-}
-/**
-* Generic runtime error.
-*/
-function errorRuntime(summary, options) {
-	return new CliStructuredError("3000", summary, {
-		domain: "RTM",
-		...options?.why ? { why: options.why } : { why: "Verification failed" },
-		...options?.fix ? { fix: options.fix } : { fix: "Check contract and database state" },
-		...options?.meta ? { meta: options.meta } : {}
-	});
-}
-/**
-* Generic unexpected error.
-*/
-function errorUnexpected(message, options) {
-	return new CliStructuredError("4999", "Unexpected error", {
-		domain: "CLI",
-		why: options?.why ?? message,
-		fix: options?.fix ?? "Check the error message and try again"
-	});
-}
-
-//#endregion
-export { errorUnexpected as S, errorQueryRunnerFactoryRequired as _, errorContractMissingExtensionPacks as a, errorTargetMigrationNotSupported as b, errorDestructiveChanges as c, errorFileNotFound as d, errorHashMismatch as f, errorMigrationPlanningFailed as g, errorMarkerRequired as h, errorContractConfigMissing as i, errorDriverRequired as l, errorMarkerMissing as m, errorConfigFileNotFound as n, errorContractValidationFailed as o, errorJsonFormatNotSupported as p, errorConfigValidation as r, errorDatabaseConnectionRequired as s, CliStructuredError as t, errorFamilyReadMarkerSqlRequired as u, errorRunnerFailed as v, errorTargetMismatch as x, errorRuntime as y };
-//# sourceMappingURL=errors-CvuQhtGp.mjs.map

package/dist/errors-CvuQhtGp.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"errors-CvuQhtGp.mjs","names":[],"sources":["../src/errors.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 * 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: 'CLI' | 'RTM';\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?: 'CLI' | 'RTM';\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    const codePrefix = this.domain === 'CLI' ? 'PN-CLI-' : 'PN-RTM-';\n    return {\n      ok: false as const,\n      code: `${codePrefix}${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      (candidate.domain === 'CLI' || candidate.domain === 'RTM') &&\n      typeof candidate.toEnvelope === 'function'\n    );\n  }\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}): CliStructuredError {\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: 'Provide `--db <url>` 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  // Build \"why\" from conflict summaries - these contain the actual problem description\n  const conflictSummaries = options.conflicts.map((c) => c.summary);\n  const computedWhy = options.why ?? conflictSummaries.join('\\n');\n\n  // Build \"fix\" from conflict \"why\" fields - these contain actionable advice\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 schema-verify` 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 * 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// Runtime Errors (PN-RTM-3000-3030)\n// ============================================================================\n\n/**\n * Contract marker not found in database.\n */\nexport function errorMarkerMissing(options?: {\n  readonly why?: string;\n  readonly dbUrl?: string;\n}): CliStructuredError {\n  return new CliStructuredError('3001', 'Database not signed', {\n    domain: 'RTM',\n    why: options?.why ?? 'No database signature (marker) found',\n    fix: 'Run `prisma-next db sign --db <url>` to sign the database',\n  });\n}\n\n/**\n * Contract hash does not match database marker.\n */\nexport function errorHashMismatch(options?: {\n  readonly why?: string;\n  readonly expected?: string;\n  readonly actual?: string;\n}): CliStructuredError {\n  return new CliStructuredError('3002', 'Hash mismatch', {\n    domain: 'RTM',\n    why: options?.why ?? 'Contract hash does not match database marker',\n    fix: 'Migrate database or re-sign if intentional',\n    ...(options?.expected || options?.actual\n      ? {\n          meta: {\n            ...(options.expected ? { expected: options.expected } : {}),\n            ...(options.actual ? { actual: options.actual } : {}),\n          },\n        }\n      : {}),\n  });\n}\n\n/**\n * Contract target does not match config target.\n */\nexport function errorTargetMismatch(\n  expected: string,\n  actual: string,\n  options?: {\n    readonly why?: string;\n  },\n): CliStructuredError {\n  return new CliStructuredError('3003', 'Target mismatch', {\n    domain: 'RTM',\n    why:\n      options?.why ??\n      `Contract target does not match config target (expected: ${expected}, actual: ${actual})`,\n    fix: 'Align contract target and config target',\n    meta: { expected, actual },\n  });\n}\n\n/**\n * Database marker is required but not found.\n * Used by commands that require a pre-existing marker as a precondition.\n */\nexport function errorMarkerRequired(options?: {\n  readonly why?: string;\n  readonly fix?: string;\n}): CliStructuredError {\n  return new CliStructuredError('3010', 'Database must be signed first', {\n    domain: 'RTM',\n    why: options?.why ?? 'No database signature (marker) found',\n    fix: options?.fix ?? 'Run `prisma-next db init` first to sign the database',\n  });\n}\n\n/**\n * Migration runner failed during execution.\n */\nexport function errorRunnerFailed(\n  summary: string,\n  options?: {\n    readonly why?: string;\n    readonly fix?: string;\n    readonly meta?: Record<string, unknown>;\n  },\n): CliStructuredError {\n  return new CliStructuredError('3020', summary, {\n    domain: 'RTM',\n    why: options?.why ?? 'Migration runner failed',\n    fix: options?.fix ?? 'Inspect the reported conflict and reconcile schema drift',\n    ...(options?.meta ? { meta: options.meta } : {}),\n  });\n}\n\n/**\n * Destructive operations require explicit confirmation via --accept-data-loss.\n */\nexport function errorDestructiveChanges(\n  summary: string,\n  options?: {\n    readonly why?: string;\n    readonly fix?: string;\n    readonly meta?: Record<string, unknown>;\n  },\n): CliStructuredError {\n  return new CliStructuredError('3030', summary, {\n    domain: 'RTM',\n    why: options?.why ?? 'Planned operations include destructive changes that require confirmation',\n    fix: options?.fix ?? 'Use `--plan` to preview, then re-run with `--accept-data-loss`',\n    ...(options?.meta ? { meta: options.meta } : {}),\n  });\n}\n\n/**\n * Generic runtime error.\n */\nexport function errorRuntime(\n  summary: string,\n  options?: {\n    readonly why?: string;\n    readonly fix?: string;\n    readonly meta?: Record<string, unknown>;\n  },\n): CliStructuredError {\n  return new CliStructuredError('3000', summary, {\n    domain: 'RTM',\n    ...(options?.why ? { why: options.why } : { why: 'Verification failed' }),\n    ...(options?.fix ? { fix: options.fix } : { fix: 'Check contract and database state' }),\n    ...(options?.meta ? { meta: options.meta } : {}),\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/src/config-types.ts

@@ -1,152 +0,0 @@
-import { type } from 'arktype';
-import type { ContractSourceProvider } from './contract-source-types';
-import type {
-  ControlAdapterDescriptor,
-  ControlDriverDescriptor,
-  ControlDriverInstance,
-  ControlExtensionDescriptor,
-  ControlFamilyDescriptor,
-  ControlTargetDescriptor,
-} from './types';
-
-/**
- * Type alias for CLI driver instances.
- * Uses string for both family and target IDs for maximum flexibility.
- */
-export type CliDriver = ControlDriverInstance<string, string>;
-
-/**
- * Contract configuration specifying source and artifact locations.
- */
-export interface ContractConfig {
-  /**
-   * Contract source provider. The provider is always async and must return
-   * a Result containing either ContractIR or structured diagnostics.
-   */
-  readonly source: ContractSourceProvider;
-  /**
-   * Path to contract.json artifact. Defaults to 'src/prisma/contract.json'.
-   * The .d.ts types file will be colocated (e.g., contract.json → contract.d.ts).
-   */
-  readonly output?: string;
-}
-
-/**
- * Configuration for Prisma Next CLI.
- * Uses Control*Descriptor types for type-safe wiring with compile-time compatibility checks.
- *
- * @template TFamilyId - The family ID (e.g., 'sql', 'document')
- * @template TTargetId - The target ID (e.g., 'postgres', 'mysql')
- * @template TConnection - The driver connection input type (defaults to `unknown` for config flexibility)
- */
-export interface PrismaNextConfig<
-  TFamilyId extends string = string,
-  TTargetId extends string = string,
-  TConnection = unknown,
-> {
-  readonly family: ControlFamilyDescriptor<TFamilyId>;
-  readonly target: ControlTargetDescriptor<TFamilyId, TTargetId>;
-  readonly adapter: ControlAdapterDescriptor<TFamilyId, TTargetId>;
-  readonly extensionPacks?: readonly ControlExtensionDescriptor<TFamilyId, TTargetId>[];
-  /**
-   * Driver descriptor for DB-connected CLI commands.
-   * Required for DB-connected commands (e.g., db verify).
-   * Optional for commands that don't need database access (e.g., emit).
-   * The driver's connection type matches the TConnection config parameter.
-   */
-  readonly driver?: ControlDriverDescriptor<
-    TFamilyId,
-    TTargetId,
-    ControlDriverInstance<TFamilyId, TTargetId>,
-    TConnection
-  >;
-  /**
-   * Database connection configuration.
-   * The connection type is driver-specific (e.g., URL string for Postgres).
-   */
-  readonly db?: {
-    /**
-     * Driver-specific connection input.
-     * For Postgres: a connection string (URL).
-     * For other drivers: may be a structured object.
-     */
-    readonly connection?: TConnection;
-  };
-  /**
-   * Contract configuration. Specifies source and artifact locations.
-   * Required for emit command; optional for other commands that only read artifacts.
-   */
-  readonly contract?: ContractConfig;
-}
-
-/**
- * Arktype schema for ContractConfig validation.
- * Validates presence/shape only.
- * contract.source is validated as a provider function at runtime in defineConfig().
- */
-const ContractConfigSchema = type({
-  source: 'unknown', // Runtime check enforces provider function shape
-  'output?': 'string',
-});
-
-/**
- * Arktype schema for PrismaNextConfig validation.
- * Note: This validates structure only. Descriptor objects (family, target, adapter) are validated separately.
- */
-const PrismaNextConfigSchema = type({
-  family: 'unknown', // ControlFamilyDescriptor - validated separately
-  target: 'unknown', // ControlTargetDescriptor - validated separately
-  adapter: 'unknown', // ControlAdapterDescriptor - validated separately
-  'extensionPacks?': 'unknown[]',
-  'driver?': 'unknown', // ControlDriverDescriptor - validated separately (optional)
-  'db?': 'unknown',
-  'contract?': ContractConfigSchema,
-});
-
-/**
- * Helper function to define a Prisma Next config.
- * Validates and normalizes the config using Arktype, then returns the normalized IR.
- *
- * Normalization:
- * - contract.output defaults to 'src/prisma/contract.json' if missing
- *
- * @param config - Raw config input from user
- * @returns Normalized config IR with defaults applied
- * @throws Error if config structure is invalid
- */
-export function defineConfig<TFamilyId extends string = string, TTargetId extends string = string>(
-  config: PrismaNextConfig<TFamilyId, TTargetId>,
-): PrismaNextConfig<TFamilyId, TTargetId> {
-  // Validate structure using Arktype
-  const validated = PrismaNextConfigSchema(config);
-  if (validated instanceof type.errors) {
-    const messages = validated.map((p: { message: string }) => p.message).join('; ');
-    throw new Error(`Config validation failed: ${messages}`);
-  }
-
-  // Normalize contract config if present
-  if (config.contract) {
-    // Validate contract.source provider function shape at runtime.
-    const source = config.contract.source;
-    if (typeof source !== 'function') {
-      throw new Error('Config.contract.source must be a provider function');
-    }
-
-    // Apply defaults
-    const output = config.contract.output ?? 'src/prisma/contract.json';
-
-    const normalizedContract: ContractConfig = {
-      source: config.contract.source,
-      output,
-    };
-
-    // Return normalized config
-    return {
-      ...config,
-      contract: normalizedContract,
-    };
-  }
-
-  // Return config as-is if no contract (preserve literal types)
-  return config;
-}