@prisma-next/core-control-plane 0.3.0-pr.94.3 → 0.3.0-pr.95.2

package/dist/chunk-YT6YGR3N.js

@@ -0,0 +1,240 @@
+// src/errors.ts
+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;
+    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() {
+    const codePrefix = this.domain === "CLI" ? "PN-CLI-" : "PN-RTM-";
+    return {
+      code: `${codePrefix}${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";
+  }
+};
+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 } } : {}
+  });
+}
+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"
+  });
+}
+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 } : {}
+  });
+}
+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 } : {}
+  });
+}
+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://\u2026" }` in prisma-next.config.ts'
+  });
+}
+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"
+  });
+}
+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"
+  });
+}
+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
+    }
+  });
+}
+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"
+  });
+}
+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()
+    }
+  });
+}
+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");
+  const computedFix = conflictFixes.length > 0 ? conflictFixes.join("\n") : "Use `db schema-verify` to inspect conflicts, or ensure the database is empty";
+  return new CliStructuredError("4020", "Migration planning failed", {
+    domain: "CLI",
+    why: computedWhy,
+    fix: computedFix,
+    meta: { conflicts: options.conflicts },
+    docsUrl: "https://prisma-next.dev/docs/cli/db-init"
+  });
+}
+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"
+  });
+}
+function errorConfigValidation(field, options) {
+  return new CliStructuredError("4001", "Config file not found", {
+    domain: "CLI",
+    why: options?.why ?? `Config must have a "${field}" field`,
+    fix: "Run 'prisma-next init' to create a config file",
+    docsUrl: "https://prisma-next.dev/docs/cli/config"
+  });
+}
+function errorMarkerMissing(options) {
+  return new CliStructuredError("3001", "Marker missing", {
+    domain: "RTM",
+    why: options?.why ?? "Contract marker not found in database",
+    fix: "Run `prisma-next db sign --db <url>` to create 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 } : {}
+      }
+    } : {}
+  });
+}
+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 }
+  });
+}
+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 } : {}
+  });
+}
+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"
+  });
+}
+
+export {
+  CliStructuredError,
+  errorConfigFileNotFound,
+  errorContractConfigMissing,
+  errorContractValidationFailed,
+  errorFileNotFound,
+  errorDatabaseConnectionRequired,
+  errorQueryRunnerFactoryRequired,
+  errorFamilyReadMarkerSqlRequired,
+  errorJsonFormatNotSupported,
+  errorDriverRequired,
+  errorContractMissingExtensionPacks,
+  errorMigrationPlanningFailed,
+  errorTargetMigrationNotSupported,
+  errorConfigValidation,
+  errorMarkerMissing,
+  errorHashMismatch,
+  errorTargetMismatch,
+  errorRuntime,
+  errorUnexpected
+};
+//# sourceMappingURL=chunk-YT6YGR3N.js.map

package/dist/chunk-YT6YGR3N.js.map

@@ -0,0 +1 @@
+{"version":3,"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 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;\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      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('4001', 'Config file not found', {\n    domain: 'CLI',\n    why: options?.why ?? `Config must have a \"${field}\" field`,\n    fix: \"Run 'prisma-next init' to create a config file\",\n    docsUrl: 'https://prisma-next.dev/docs/cli/config',\n  });\n}\n\n// ============================================================================\n// Runtime Errors (PN-RTM-3000-3003)\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', 'Marker missing', {\n    domain: 'RTM',\n    why: options?.why ?? 'Contract marker not found in database',\n    fix: 'Run `prisma-next db sign --db <url>` to create marker',\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 * 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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","names":[]}

package/dist/config-types.d.ts

@@ -0,0 +1,79 @@
+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. Can be a value or a function that returns a value (sync or async).
+     * If a function, it will be called to resolve the contract.
+     */
+    readonly source: unknown | (() => unknown | Promise<unknown>);
+    /**
+     * Path to contract.json artifact. Defaults to 'src/prisma/contract.json'.
+     * This is the canonical location where other CLI commands can find the contract JSON.
+     */
+    readonly output?: string;
+    /**
+     * Path to contract.d.ts artifact. Defaults to output with .d.ts extension.
+     * If output ends with .json, replaces .json with .d.ts.
+     * Otherwise, appends .d.ts to the directory containing output.
+     */
+    readonly types?: 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;
+}
+/**
+ * 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
+ * - contract.types defaults to output with .d.ts extension if missing
+ *
+ * @param config - Raw config input from user
+ * @returns Normalized config IR with defaults applied
+ * @throws Error if config structure is invalid
+ */
+export declare function defineConfig<TFamilyId extends string = string, TTargetId extends string = string>(config: PrismaNextConfig<TFamilyId, TTargetId>): PrismaNextConfig<TFamilyId, TTargetId>;
+//# sourceMappingURL=config-types.d.ts.map

package/dist/config-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-types.d.ts","sourceRoot":"","sources":["../src/config-types.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,wBAAwB,EACxB,uBAAuB,EACvB,qBAAqB,EACrB,0BAA0B,EAC1B,uBAAuB,EACvB,uBAAuB,EACxB,MAAM,SAAS,CAAC;AAEjB;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,qBAAqB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;IAC9D;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB,CAC/B,SAAS,SAAS,MAAM,GAAG,MAAM,EACjC,SAAS,SAAS,MAAM,GAAG,MAAM,EACjC,WAAW,GAAG,OAAO;IAErB,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC,SAAS,CAAC,CAAC;IACpD,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAC/D,QAAQ,CAAC,OAAO,EAAE,wBAAwB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IACjE,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,0BAA0B,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE,CAAC;IACtF;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,uBAAuB,CACvC,SAAS,EACT,SAAS,EACT,qBAAqB,CAAC,SAAS,EAAE,SAAS,CAAC,EAC3C,WAAW,CACZ,CAAC;IACF;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,EAAE;QACZ;;;;WAIG;QACH,QAAQ,CAAC,UAAU,CAAC,EAAE,WAAW,CAAC;KACnC,CAAC;IACF;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,cAAc,CAAC;CACpC;AA0BD;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,SAAS,SAAS,MAAM,GAAG,MAAM,EAAE,SAAS,SAAS,MAAM,GAAG,MAAM,EAC/F,MAAM,EAAE,gBAAgB,CAAC,SAAS,EAAE,SAAS,CAAC,GAC7C,gBAAgB,CAAC,SAAS,EAAE,SAAS,CAAC,CAgDxC"}

package/dist/config-validation.d.ts

@@ -0,0 +1,10 @@
+import type { PrismaNextConfig } from './config-types';
+/**
+ * Validates that the config has the required structure.
+ * This is pure validation logic with no file I/O or CLI awareness.
+ *
+ * @param config - Config object to validate
+ * @throws CliStructuredError if config structure is invalid
+ */
+export declare function validateConfig(config: unknown): asserts config is PrismaNextConfig;
+//# sourceMappingURL=config-validation.d.ts.map

package/dist/config-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-validation.d.ts","sourceRoot":"","sources":["../src/config-validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGvD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,IAAI,gBAAgB,CAmQlF"}

package/dist/emission/canonicalization.d.ts

@@ -0,0 +1,6 @@
+import type { ContractIR } from '@prisma-next/contract/ir';
+export declare function canonicalizeContract(ir: ContractIR & {
+    coreHash?: string;
+    profileHash?: string;
+}): string;
+//# sourceMappingURL=canonicalization.d.ts.map

package/dist/emission/canonicalization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonicalization.d.ts","sourceRoot":"","sources":["../../src/emission/canonicalization.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AA6N3D,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,UAAU,GAAG;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3D,MAAM,CA6BR"}

package/dist/emission/emit.d.ts

@@ -0,0 +1,5 @@
+import type { ContractIR } from '@prisma-next/contract/ir';
+import type { TargetFamilyHook } from '@prisma-next/contract/types';
+import type { EmitOptions, EmitResult } from './types';
+export declare function emit(ir: ContractIR, options: EmitOptions, targetFamily: TargetFamilyHook): Promise<EmitResult>;
+//# sourceMappingURL=emit.d.ts.map

package/dist/emission/emit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit.d.ts","sourceRoot":"","sources":["../../src/emission/emit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAqB,MAAM,6BAA6B,CAAC;AAIvF,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAmCvD,wBAAsB,IAAI,CACxB,EAAE,EAAE,UAAU,EACd,OAAO,EAAE,WAAW,EACpB,YAAY,EAAE,gBAAgB,GAC7B,OAAO,CAAC,UAAU,CAAC,CAgFrB"}

package/dist/emission/hashing.d.ts

@@ -0,0 +1,17 @@
+type ContractInput = {
+    schemaVersion: string;
+    targetFamily: string;
+    target: string;
+    models: Record<string, unknown>;
+    relations: Record<string, unknown>;
+    storage: Record<string, unknown>;
+    extensionPacks: Record<string, unknown>;
+    sources: Record<string, unknown>;
+    capabilities: Record<string, Record<string, boolean>>;
+    meta: Record<string, unknown>;
+    [key: string]: unknown;
+};
+export declare function computeCoreHash(contract: ContractInput): string;
+export declare function computeProfileHash(contract: ContractInput): string;
+export {};
+//# sourceMappingURL=hashing.d.ts.map

package/dist/emission/hashing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hashing.d.ts","sourceRoot":"","sources":["../../src/emission/hashing.ts"],"names":[],"mappings":"AAIA,KAAK,aAAa,GAAG;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACtD,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAQF,wBAAgB,eAAe,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,CAe/D;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,CAelE"}

package/dist/emission/types.d.ts

@@ -0,0 +1,21 @@
+import type { TypeRenderEntry, TypesImportSpec } from '@prisma-next/contract/types';
+import type { OperationRegistry } from '@prisma-next/operations';
+export interface EmitOptions {
+    readonly outputDir: string;
+    readonly operationRegistry?: OperationRegistry;
+    readonly codecTypeImports?: ReadonlyArray<TypesImportSpec>;
+    readonly operationTypeImports?: ReadonlyArray<TypesImportSpec>;
+    readonly extensionIds?: ReadonlyArray<string>;
+    /**
+     * Normalized parameterized type renderers, keyed by codecId.
+     * These are extracted from descriptors and normalized during assembly.
+     */
+    readonly parameterizedRenderers?: Map<string, TypeRenderEntry>;
+}
+export interface EmitResult {
+    readonly contractJson: string;
+    readonly contractDts: string;
+    readonly coreHash: string;
+    readonly profileHash: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/emission/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/emission/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACpF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IAC/C,QAAQ,CAAC,gBAAgB,CAAC,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;IAC3D,QAAQ,CAAC,oBAAoB,CAAC,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;IAC/D,QAAQ,CAAC,YAAY,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC9C;;;OAGG;IACH,QAAQ,CAAC,sBAAsB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CAChE;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B"}

package/dist/errors.d.ts

@@ -0,0 +1,188 @@
+/**
+ * CLI error envelope for output formatting.
+ * This is the serialized form of a CliStructuredError.
+ */
+export interface CliErrorEnvelope {
+    readonly code: string;
+    readonly domain: string;
+    readonly severity: 'error' | 'warn' | 'info';
+    readonly summary: string;
+    readonly why: string | undefined;
+    readonly fix: string | undefined;
+    readonly where: {
+        readonly path: string | undefined;
+        readonly line: number | undefined;
+    } | undefined;
+    readonly meta: Record<string, unknown> | undefined;
+    readonly docsUrl: string | undefined;
+}
+/**
+ * Minimal conflict data structure expected by CLI output.
+ */
+export interface CliErrorConflict {
+    readonly kind: string;
+    readonly summary: string;
+    readonly why?: string;
+}
+/**
+ * Structured CLI error that contains all information needed for error envelopes.
+ * Call sites throw these errors with full context.
+ */
+export declare class CliStructuredError extends Error {
+    readonly code: string;
+    readonly domain: 'CLI' | 'RTM';
+    readonly severity: 'error' | 'warn' | 'info';
+    readonly why: string | undefined;
+    readonly fix: string | undefined;
+    readonly where: {
+        readonly path: string | undefined;
+        readonly line: number | undefined;
+    } | undefined;
+    readonly meta: Record<string, unknown> | undefined;
+    readonly docsUrl: string | undefined;
+    constructor(code: string, summary: string, options?: {
+        readonly domain?: 'CLI' | 'RTM';
+        readonly severity?: 'error' | 'warn' | 'info';
+        readonly why?: string;
+        readonly fix?: string;
+        readonly where?: {
+            readonly path?: string;
+            readonly line?: number;
+        };
+        readonly meta?: Record<string, unknown>;
+        readonly docsUrl?: string;
+    });
+    /**
+     * Converts this error to a CLI error envelope for output formatting.
+     */
+    toEnvelope(): CliErrorEnvelope;
+    /**
+     * 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: unknown): error is CliStructuredError;
+}
+/**
+ * Config file not found or missing.
+ */
+export declare function errorConfigFileNotFound(configPath?: string, options?: {
+    readonly why?: string;
+}): CliStructuredError;
+/**
+ * Contract configuration missing from config.
+ */
+export declare function errorContractConfigMissing(options?: {
+    readonly why?: string;
+}): CliStructuredError;
+/**
+ * Contract validation failed.
+ */
+export declare function errorContractValidationFailed(reason: string, options?: {
+    readonly where?: {
+        readonly path?: string;
+        readonly line?: number;
+    };
+}): CliStructuredError;
+/**
+ * File not found.
+ */
+export declare function errorFileNotFound(filePath: string, options?: {
+    readonly why?: string;
+    readonly fix?: string;
+    readonly docsUrl?: string;
+}): CliStructuredError;
+/**
+ * Database connection is required but not provided.
+ */
+export declare function errorDatabaseConnectionRequired(options?: {
+    readonly why?: string;
+}): CliStructuredError;
+/**
+ * Query runner factory is required but not provided in config.
+ */
+export declare function errorQueryRunnerFactoryRequired(options?: {
+    readonly why?: string;
+}): CliStructuredError;
+/**
+ * Family verify.readMarker is required but not provided.
+ */
+export declare function errorFamilyReadMarkerSqlRequired(options?: {
+    readonly why?: string;
+}): CliStructuredError;
+/**
+ * JSON output format not supported.
+ */
+export declare function errorJsonFormatNotSupported(options: {
+    readonly command: string;
+    readonly format: string;
+    readonly supportedFormats: readonly string[];
+}): CliStructuredError;
+/**
+ * Driver is required for DB-connected commands but not provided.
+ */
+export declare function errorDriverRequired(options?: {
+    readonly why?: string;
+}): CliStructuredError;
+/**
+ * Contract requires extension packs that are not provided by config descriptors.
+ */
+export declare function errorContractMissingExtensionPacks(options: {
+    readonly missingExtensionPacks: readonly string[];
+    readonly providedComponentIds: readonly string[];
+}): CliStructuredError;
+/**
+ * Migration planning failed due to conflicts.
+ */
+export declare function errorMigrationPlanningFailed(options: {
+    readonly conflicts: readonly CliErrorConflict[];
+    readonly why?: string;
+}): CliStructuredError;
+/**
+ * Target does not support migrations (missing createPlanner/createRunner).
+ */
+export declare function errorTargetMigrationNotSupported(options?: {
+    readonly why?: string;
+}): CliStructuredError;
+/**
+ * Config validation error (missing required fields).
+ */
+export declare function errorConfigValidation(field: string, options?: {
+    readonly why?: string;
+}): CliStructuredError;
+/**
+ * Contract marker not found in database.
+ */
+export declare function errorMarkerMissing(options?: {
+    readonly why?: string;
+    readonly dbUrl?: string;
+}): CliStructuredError;
+/**
+ * Contract hash does not match database marker.
+ */
+export declare function errorHashMismatch(options?: {
+    readonly why?: string;
+    readonly expected?: string;
+    readonly actual?: string;
+}): CliStructuredError;
+/**
+ * Contract target does not match config target.
+ */
+export declare function errorTargetMismatch(expected: string, actual: string, options?: {
+    readonly why?: string;
+}): CliStructuredError;
+/**
+ * Generic runtime error.
+ */
+export declare function errorRuntime(summary: string, options?: {
+    readonly why?: string;
+    readonly fix?: string;
+    readonly meta?: Record<string, unknown>;
+}): CliStructuredError;
+/**
+ * Generic unexpected error.
+ */
+export declare function errorUnexpected(message: string, options?: {
+    readonly why?: string;
+    readonly fix?: string;
+}): CliStructuredError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}