@prisma-next/cli 0.3.0-dev.5 → 0.3.0-dev.53

package/dist/commands/db-verify.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-verify.mjs","names":["details: Array<{ label: string; value: string }>","contractJsonContent: string","contractJson: Record<string, unknown>","exitCode"],"sources":["../../src/commands/db-verify.ts"],"sourcesContent":["import { readFile } from 'node:fs/promises';\nimport { relative, resolve } from 'node:path';\nimport type { VerifyDatabaseResult } from '@prisma-next/core-control-plane/types';\nimport { ifDefined } from '@prisma-next/utils/defined';\nimport { notOk, ok, type Result } from '@prisma-next/utils/result';\nimport { Command } from 'commander';\nimport { loadConfig } from '../config-loader';\nimport { createControlClient } from '../control-api/client';\nimport {\n  CliStructuredError,\n  errorContractValidationFailed,\n  errorDatabaseConnectionRequired,\n  errorDriverRequired,\n  errorFileNotFound,\n  errorHashMismatch,\n  errorJsonFormatNotSupported,\n  errorMarkerMissing,\n  errorRuntime,\n  errorTargetMismatch,\n  errorUnexpected,\n} from '../utils/cli-errors';\nimport { setCommandDescriptions } from '../utils/command-helpers';\nimport { type GlobalFlags, parseGlobalFlags } from '../utils/global-flags';\nimport {\n  formatCommandHelp,\n  formatStyledHeader,\n  formatVerifyJson,\n  formatVerifyOutput,\n} from '../utils/output';\nimport { createProgressAdapter } from '../utils/progress-adapter';\nimport { handleResult } from '../utils/result-handler';\n\ninterface DbVerifyOptions {\n  readonly db?: string;\n  readonly config?: string;\n  readonly json?: string | boolean;\n  readonly quiet?: boolean;\n  readonly q?: boolean;\n  readonly verbose?: boolean;\n  readonly v?: boolean;\n  readonly vv?: boolean;\n  readonly trace?: boolean;\n  readonly timestamps?: boolean;\n  readonly color?: boolean;\n  readonly 'no-color'?: boolean;\n}\n\n/**\n * Maps a VerifyDatabaseResult failure to a CliStructuredError.\n */\nfunction mapVerifyFailure(verifyResult: VerifyDatabaseResult): CliStructuredError {\n  if (!verifyResult.ok && verifyResult.code) {\n    if (verifyResult.code === 'PN-RTM-3001') {\n      return errorMarkerMissing();\n    }\n    if (verifyResult.code === 'PN-RTM-3002') {\n      return errorHashMismatch({\n        expected: verifyResult.contract.storageHash,\n        ...ifDefined('actual', verifyResult.marker?.storageHash),\n      });\n    }\n    if (verifyResult.code === 'PN-RTM-3003') {\n      return errorTargetMismatch(\n        verifyResult.target.expected,\n        verifyResult.target.actual ?? 'unknown',\n      );\n    }\n    // Unknown code - fall through to runtime error\n  }\n  return errorRuntime(verifyResult.summary);\n}\n\n/**\n * Executes the db verify command and returns a structured Result.\n */\nasync function executeDbVerifyCommand(\n  options: DbVerifyOptions,\n  flags: GlobalFlags,\n): Promise<Result<VerifyDatabaseResult, CliStructuredError>> {\n  // Load config\n  const config = await loadConfig(options.config);\n  const configPath = options.config\n    ? relative(process.cwd(), resolve(options.config))\n    : 'prisma-next.config.ts';\n  const contractPathAbsolute = config.contract?.output\n    ? resolve(config.contract.output)\n    : resolve('src/prisma/contract.json');\n  const contractPath = relative(process.cwd(), contractPathAbsolute);\n\n  // Output header\n  if (flags.json !== 'object' && !flags.quiet) {\n    const details: Array<{ label: string; value: string }> = [\n      { label: 'config', value: configPath },\n      { label: 'contract', value: contractPath },\n    ];\n    if (options.db) {\n      details.push({ label: 'database', value: options.db });\n    }\n    const header = formatStyledHeader({\n      command: 'db verify',\n      description: 'Check whether the database has been signed with your contract',\n      url: 'https://pris.ly/db-verify',\n      details,\n      flags,\n    });\n    console.log(header);\n  }\n\n  // Load contract file\n  let contractJsonContent: string;\n  try {\n    contractJsonContent = await readFile(contractPathAbsolute, 'utf-8');\n  } catch (error) {\n    if (error instanceof Error && (error as { code?: string }).code === 'ENOENT') {\n      return notOk(\n        errorFileNotFound(contractPathAbsolute, {\n          why: `Contract file not found at ${contractPathAbsolute}`,\n          fix: `Run \\`prisma-next contract emit\\` to generate ${contractPath}, or update \\`config.contract.output\\` in ${configPath}`,\n        }),\n      );\n    }\n    return notOk(\n      errorUnexpected(error instanceof Error ? error.message : String(error), {\n        why: `Failed to read contract file: ${error instanceof Error ? error.message : String(error)}`,\n      }),\n    );\n  }\n\n  let contractJson: Record<string, unknown>;\n  try {\n    contractJson = JSON.parse(contractJsonContent) as Record<string, unknown>;\n  } catch (error) {\n    return notOk(\n      errorContractValidationFailed(\n        `Contract JSON is invalid: ${error instanceof Error ? error.message : String(error)}`,\n        { where: { path: contractPathAbsolute } },\n      ),\n    );\n  }\n\n  // Resolve database connection (--db flag or config.db.connection)\n  const dbConnection = options.db ?? config.db?.connection;\n  if (!dbConnection) {\n    return notOk(\n      errorDatabaseConnectionRequired({\n        why: `Database connection is required for db verify (set db.connection in ${configPath}, or pass --db <url>)`,\n      }),\n    );\n  }\n\n  // Check for driver\n  if (!config.driver) {\n    return notOk(errorDriverRequired({ why: 'Config.driver is required for db verify' }));\n  }\n\n  // Create control client\n  const client = createControlClient({\n    family: config.family,\n    target: config.target,\n    adapter: config.adapter,\n    driver: config.driver,\n    extensionPacks: config.extensionPacks ?? [],\n  });\n\n  // Create progress adapter\n  const onProgress = createProgressAdapter({ flags });\n\n  try {\n    const verifyResult = await client.verify({\n      contractIR: contractJson,\n      connection: dbConnection,\n      onProgress,\n    });\n\n    // Add blank line after all async operations if spinners were shown\n    if (!flags.quiet && flags.json !== 'object' && process.stdout.isTTY) {\n      console.log('');\n    }\n\n    // If verification failed, map to CLI structured error\n    if (!verifyResult.ok) {\n      return notOk(mapVerifyFailure(verifyResult));\n    }\n\n    return ok(verifyResult);\n  } catch (error) {\n    // Driver already throws CliStructuredError for connection failures\n    if (error instanceof CliStructuredError) {\n      return notOk(error);\n    }\n\n    // Wrap unexpected errors\n    return notOk(\n      errorUnexpected(error instanceof Error ? error.message : String(error), {\n        why: `Unexpected error during db verify: ${error instanceof Error ? error.message : String(error)}`,\n      }),\n    );\n  } finally {\n    await client.close();\n  }\n}\n\nexport function createDbVerifyCommand(): Command {\n  const command = new Command('verify');\n  setCommandDescriptions(\n    command,\n    'Check whether the database has been signed with your contract',\n    'Verifies that your database schema matches the emitted contract. Checks table structures,\\n' +\n      'column types, constraints, and codec coverage. Reports any mismatches or missing codecs.',\n  );\n  command\n    .configureHelp({\n      formatHelp: (cmd) => {\n        const flags = parseGlobalFlags({});\n        return formatCommandHelp({ command: cmd, flags });\n      },\n    })\n    .option('--db <url>', 'Database connection string')\n    .option('--config <path>', 'Path to prisma-next.config.ts')\n    .option('--json [format]', 'Output as JSON (object)', false)\n    .option('-q, --quiet', 'Quiet mode: errors only')\n    .option('-v, --verbose', 'Verbose output: debug info, timings')\n    .option('-vv, --trace', 'Trace output: deep internals, stack traces')\n    .option('--timestamps', 'Add timestamps to output')\n    .option('--color', 'Force color output')\n    .option('--no-color', 'Disable color output')\n    .action(async (options: DbVerifyOptions) => {\n      const flags = parseGlobalFlags(options);\n\n      // Validate JSON format option\n      if (flags.json === 'ndjson') {\n        const result = notOk(\n          errorJsonFormatNotSupported({\n            command: 'db verify',\n            format: 'ndjson',\n            supportedFormats: ['object'],\n          }),\n        );\n        const exitCode = handleResult(result, flags);\n        process.exit(exitCode);\n      }\n\n      const result = await executeDbVerifyCommand(options, flags);\n\n      const exitCode = handleResult(result, flags, (verifyResult) => {\n        if (flags.json === 'object') {\n          console.log(formatVerifyJson(verifyResult));\n        } else {\n          const output = formatVerifyOutput(verifyResult, flags);\n          if (output) {\n            console.log(output);\n          }\n        }\n      });\n      process.exit(exitCode);\n    });\n\n  return command;\n}\n"],"mappings":"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"}

package/dist/config-loader-BJ8HsEdA.mjs

@@ -0,0 +1,42 @@
+import { errorConfigFileNotFound, errorUnexpected } from "@prisma-next/core-control-plane/errors";
+import { dirname, resolve } from "node:path";
+import { validateConfig } from "@prisma-next/core-control-plane/config-validation";
+import { loadConfig } from "c12";
+
+//#region src/config-loader.ts
+/**
+* Loads the Prisma Next config from a TypeScript file.
+* Supports both default export and named export.
+* Uses c12 to automatically handle TypeScript compilation and config file discovery.
+*
+* @param configPath - Optional path to config file. Defaults to `./prisma-next.config.ts` in current directory.
+* @returns The loaded config object.
+* @throws Error if config file doesn't exist or is invalid.
+*/
+async function loadConfig$1(configPath) {
+	try {
+		const cwd = process.cwd();
+		const resolvedConfigPath = configPath ? resolve(cwd, configPath) : void 0;
+		const configCwd = resolvedConfigPath ? dirname(resolvedConfigPath) : cwd;
+		const result = await loadConfig({
+			name: "prisma-next",
+			...resolvedConfigPath ? { configFile: resolvedConfigPath } : {},
+			cwd: configCwd
+		});
+		if (resolvedConfigPath && result.configFile !== resolvedConfigPath) throw errorConfigFileNotFound(resolvedConfigPath);
+		if (!result.config || Object.keys(result.config).length === 0) throw errorConfigFileNotFound(result.configFile || resolvedConfigPath || configPath);
+		validateConfig(result.config);
+		return result.config;
+	} catch (error) {
+		if (error instanceof Error && "code" in error && typeof error.code === "string") throw error;
+		if (error instanceof Error) {
+			if (error.message.includes("not found") || error.message.includes("Cannot find") || error.message.includes("ENOENT")) throw errorConfigFileNotFound(configPath ? resolve(process.cwd(), configPath) : void 0, { why: error.message });
+			throw errorUnexpected(error.message, { why: `Failed to load config: ${error.message}` });
+		}
+		throw errorUnexpected(String(error));
+	}
+}
+
+//#endregion
+export { loadConfig$1 as t };
+//# sourceMappingURL=config-loader-BJ8HsEdA.mjs.map

package/dist/config-loader-BJ8HsEdA.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-loader-BJ8HsEdA.mjs","names":["loadConfig","loadConfigC12"],"sources":["../src/config-loader.ts"],"sourcesContent":["import { dirname, resolve } from 'node:path';\nimport type { PrismaNextConfig } from '@prisma-next/core-control-plane/config-types';\nimport { validateConfig } from '@prisma-next/core-control-plane/config-validation';\nimport { errorConfigFileNotFound, errorUnexpected } from '@prisma-next/core-control-plane/errors';\nimport { loadConfig as loadConfigC12 } from 'c12';\n\n/**\n * Loads the Prisma Next config from a TypeScript file.\n * Supports both default export and named export.\n * Uses c12 to automatically handle TypeScript compilation and config file discovery.\n *\n * @param configPath - Optional path to config file. Defaults to `./prisma-next.config.ts` in current directory.\n * @returns The loaded config object.\n * @throws Error if config file doesn't exist or is invalid.\n */\nexport async function loadConfig(configPath?: string): Promise<PrismaNextConfig> {\n  try {\n    const cwd = process.cwd();\n    // Resolve config path to absolute path and set cwd to config directory when path is provided\n    const resolvedConfigPath = configPath ? resolve(cwd, configPath) : undefined;\n    const configCwd = resolvedConfigPath ? dirname(resolvedConfigPath) : cwd;\n\n    const result = await loadConfigC12<PrismaNextConfig>({\n      name: 'prisma-next',\n      ...(resolvedConfigPath ? { configFile: resolvedConfigPath } : {}),\n      cwd: configCwd,\n    });\n\n    // When a specific config file was requested, verify it was actually loaded\n    // (c12 falls back to searching by name if the specified file doesn't exist)\n    if (resolvedConfigPath && result.configFile !== resolvedConfigPath) {\n      throw errorConfigFileNotFound(resolvedConfigPath);\n    }\n\n    // Check if config is missing or empty (c12 may return empty object when file doesn't exist)\n    if (!result.config || Object.keys(result.config).length === 0) {\n      // Use c12's configFile if available, otherwise use explicit configPath, otherwise omit path\n      const displayPath = result.configFile || resolvedConfigPath || configPath;\n      throw errorConfigFileNotFound(displayPath);\n    }\n\n    // Validate config structure\n    validateConfig(result.config);\n\n    return result.config;\n  } catch (error) {\n    // Re-throw structured errors as-is\n    if (\n      error instanceof Error &&\n      'code' in error &&\n      typeof (error as { code: string }).code === 'string'\n    ) {\n      throw error;\n    }\n\n    if (error instanceof Error) {\n      // Check for file not found errors\n      if (\n        error.message.includes('not found') ||\n        error.message.includes('Cannot find') ||\n        error.message.includes('ENOENT')\n      ) {\n        // Use resolved path if available, otherwise use original configPath\n        const displayPath = configPath ? resolve(process.cwd(), configPath) : undefined;\n        throw errorConfigFileNotFound(displayPath, {\n          why: error.message,\n        });\n      }\n      // For other errors, wrap in unexpected error\n      throw errorUnexpected(error.message, {\n        why: `Failed to load config: ${error.message}`,\n      });\n    }\n    throw errorUnexpected(String(error));\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;AAeA,eAAsBA,aAAW,YAAgD;AAC/E,KAAI;EACF,MAAM,MAAM,QAAQ,KAAK;EAEzB,MAAM,qBAAqB,aAAa,QAAQ,KAAK,WAAW,GAAG;EACnE,MAAM,YAAY,qBAAqB,QAAQ,mBAAmB,GAAG;EAErE,MAAM,SAAS,MAAMC,WAAgC;GACnD,MAAM;GACN,GAAI,qBAAqB,EAAE,YAAY,oBAAoB,GAAG,EAAE;GAChE,KAAK;GACN,CAAC;AAIF,MAAI,sBAAsB,OAAO,eAAe,mBAC9C,OAAM,wBAAwB,mBAAmB;AAInD,MAAI,CAAC,OAAO,UAAU,OAAO,KAAK,OAAO,OAAO,CAAC,WAAW,EAG1D,OAAM,wBADc,OAAO,cAAc,sBAAsB,WACrB;AAI5C,iBAAe,OAAO,OAAO;AAE7B,SAAO,OAAO;UACP,OAAO;AAEd,MACE,iBAAiB,SACjB,UAAU,SACV,OAAQ,MAA2B,SAAS,SAE5C,OAAM;AAGR,MAAI,iBAAiB,OAAO;AAE1B,OACE,MAAM,QAAQ,SAAS,YAAY,IACnC,MAAM,QAAQ,SAAS,cAAc,IACrC,MAAM,QAAQ,SAAS,SAAS,CAIhC,OAAM,wBADc,aAAa,QAAQ,QAAQ,KAAK,EAAE,WAAW,GAAG,QAC3B,EACzC,KAAK,MAAM,SACZ,CAAC;AAGJ,SAAM,gBAAgB,MAAM,SAAS,EACnC,KAAK,0BAA0B,MAAM,WACtC,CAAC;;AAEJ,QAAM,gBAAgB,OAAO,MAAM,CAAC"}

package/dist/{config-loader.d.ts → config-loader.d.mts}

@@ -1,4 +1,7 @@
-import type { PrismaNextConfig } from '@prisma-next/core-control-plane/config-types';
+import { PrismaNextConfig } from "@prisma-next/core-control-plane/config-types";
+
+//#region src/config-loader.d.ts
+
 /**
  * Loads the Prisma Next config from a TypeScript file.
  * Supports both default export and named export.
@@ -8,5 +11,7 @@ import type { PrismaNextConfig } from '@prisma-next/core-control-plane/config-ty
  * @returns The loaded config object.
  * @throws Error if config file doesn't exist or is invalid.
  */
-export declare function loadConfig(configPath?: string): Promise<PrismaNextConfig>;
-//# sourceMappingURL=config-loader.d.ts.map
+declare function loadConfig(configPath?: string): Promise<PrismaNextConfig>;
+//#endregion
+export { loadConfig };
+//# sourceMappingURL=config-loader.d.mts.map

package/dist/config-loader.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-loader.d.mts","names":[],"sources":["../src/config-loader.ts"],"sourcesContent":[],"mappings":";;;;;;AAeA;;;;;;;iBAAsB,UAAA,uBAAiC,QAAQ"}

package/dist/config-loader.mjs

@@ -0,0 +1,3 @@
+import { t as loadConfig } from "./config-loader-BJ8HsEdA.mjs";
+
+export { loadConfig };

package/dist/exports/config-types.d.mts

@@ -0,0 +1,2 @@
+import { ContractConfig, PrismaNextConfig, defineConfig } from "@prisma-next/core-control-plane/config-types";
+export { type ContractConfig, type PrismaNextConfig, defineConfig };

package/dist/exports/config-types.mjs

@@ -0,0 +1,3 @@
+import { defineConfig } from "@prisma-next/core-control-plane/config-types";
+
+export { defineConfig };

package/dist/exports/control-api.d.mts

@@ -0,0 +1,433 @@
+import { Result } from "@prisma-next/utils/result";
+import { ContractSourceDiagnostics, ContractSourceProvider } from "@prisma-next/core-control-plane/config-types";
+import { ControlAdapterDescriptor, ControlDriverDescriptor, ControlExtensionDescriptor, ControlFamilyDescriptor, ControlPlaneStack, ControlTargetDescriptor, MigrationPlannerConflict, SignDatabaseResult, SignDatabaseResult as SignDatabaseResult$1, VerifyDatabaseResult, VerifyDatabaseResult as VerifyDatabaseResult$1, VerifyDatabaseSchemaResult, VerifyDatabaseSchemaResult as VerifyDatabaseSchemaResult$1 } from "@prisma-next/core-control-plane/types";
+import { CoreSchemaView } from "@prisma-next/core-control-plane/schema-view";
+
+//#region src/control-api/types.d.ts
+
+/**
+ * Options for creating a control client.
+ *
+ * Note: This is NOT the same as CLI config. There's no `contract` field,
+ * no file paths. The client is config-agnostic.
+ *
+ * The descriptor types use permissive `any` because family-specific descriptors
+ * (e.g., SqlFamilyDescriptor) have more specific `create` method signatures that
+ * are not compatible with the base ControlFamilyDescriptor type due to TypeScript
+ * variance rules. The client implementation casts these internally.
+ */
+interface ControlClientOptions {
+  readonly family: ControlFamilyDescriptor<any, any>;
+  readonly target: ControlTargetDescriptor<any, any, any, any>;
+  readonly adapter: ControlAdapterDescriptor<any, any, any>;
+  /** Optional - control client can be created without driver for offline operations */
+  readonly driver?: ControlDriverDescriptor<any, any, any, any>;
+  readonly extensionPacks?: ReadonlyArray<ControlExtensionDescriptor<any, any, any>>;
+  /**
+   * Optional default connection for auto-connect.
+   * When provided, operations will auto-connect if not already connected.
+   * The type is driver-specific (e.g., string URL for Postgres).
+   */
+  readonly connection?: unknown;
+}
+/**
+ * Action names for control-api operations that can emit progress events.
+ */
+type ControlActionName = 'dbInit' | 'verify' | 'schemaVerify' | 'sign' | 'introspect' | 'emit';
+/**
+ * Progress event emitted during control-api operation execution.
+ *
+ * Events model operation progress using a span-based model:
+ * - `spanStart`: Begin a timed segment (supports nesting via parentSpanId)
+ * - `spanEnd`: Complete a timed segment
+ *
+ * All operation-specific progress (e.g., per-migration-operation) is modeled
+ * as nested spans rather than special event types.
+ *
+ * Events are delivered via an optional `onProgress` callback to avoid polluting
+ * return types. If the callback is absent, operations emit no events (zero overhead).
+ */
+type ControlProgressEvent = {
+  readonly action: ControlActionName;
+  readonly kind: 'spanStart';
+  readonly spanId: string;
+  readonly parentSpanId?: string;
+  readonly label: string;
+} | {
+  readonly action: ControlActionName;
+  readonly kind: 'spanEnd';
+  readonly spanId: string;
+  readonly outcome: 'ok' | 'skipped' | 'error';
+};
+/**
+ * Callback function for receiving progress events during control-api operations.
+ *
+ * @param event - The progress event emitted by the operation
+ */
+type OnControlProgress = (event: ControlProgressEvent) => void;
+/**
+ * Options for the verify operation.
+ */
+interface VerifyOptions {
+  /** Contract IR or unvalidated JSON - validated at runtime via familyInstance.validateContractIR() */
+  readonly contractIR: unknown;
+  /**
+   * Database connection. If provided, verify will connect before executing.
+   * If omitted, the client must already be connected.
+   * The type is driver-specific (e.g., string URL for Postgres).
+   */
+  readonly connection?: unknown;
+  /** Optional progress callback for observing operation progress */
+  readonly onProgress?: OnControlProgress;
+}
+/**
+ * Options for the schemaVerify operation.
+ */
+interface SchemaVerifyOptions {
+  /** Contract IR or unvalidated JSON - validated at runtime via familyInstance.validateContractIR() */
+  readonly contractIR: unknown;
+  /**
+   * Whether to use strict mode for schema verification.
+   * In strict mode, extra tables/columns are reported as issues.
+   * Default: false (tolerant mode - allows superset)
+   */
+  readonly strict?: boolean;
+  /**
+   * Database connection. If provided, schemaVerify will connect before executing.
+   * If omitted, the client must already be connected.
+   * The type is driver-specific (e.g., string URL for Postgres).
+   */
+  readonly connection?: unknown;
+  /** Optional progress callback for observing operation progress */
+  readonly onProgress?: OnControlProgress;
+}
+/**
+ * Options for the sign operation.
+ */
+interface SignOptions {
+  /** Contract IR or unvalidated JSON - validated at runtime via familyInstance.validateContractIR() */
+  readonly contractIR: unknown;
+  /**
+   * Path to the contract file (for metadata in the result).
+   */
+  readonly contractPath?: string;
+  /**
+   * Path to the config file (for metadata in the result).
+   */
+  readonly configPath?: string;
+  /**
+   * Database connection. If provided, sign will connect before executing.
+   * If omitted, the client must already be connected.
+   * The type is driver-specific (e.g., string URL for Postgres).
+   */
+  readonly connection?: unknown;
+  /** Optional progress callback for observing operation progress */
+  readonly onProgress?: OnControlProgress;
+}
+/**
+ * Options for the dbInit operation.
+ */
+interface DbInitOptions {
+  /** Contract IR or unvalidated JSON - validated at runtime via familyInstance.validateContractIR() */
+  readonly contractIR: unknown;
+  /**
+   * Mode for the dbInit operation.
+   * - 'plan': Returns planned operations without applying
+   * - 'apply': Applies operations and writes marker
+   */
+  readonly mode: 'plan' | 'apply';
+  /**
+   * Database connection. If provided, dbInit will connect before executing.
+   * If omitted, the client must already be connected.
+   * The type is driver-specific (e.g., string URL for Postgres).
+   */
+  readonly connection?: unknown;
+  /** Optional progress callback for observing operation progress */
+  readonly onProgress?: OnControlProgress;
+}
+/**
+ * Options for the introspect operation.
+ */
+interface IntrospectOptions {
+  /**
+   * Optional schema name to introspect.
+   */
+  readonly schema?: string;
+  /**
+   * Database connection. If provided, introspect will connect before executing.
+   * If omitted, the client must already be connected.
+   * The type is driver-specific (e.g., string URL for Postgres).
+   */
+  readonly connection?: unknown;
+  /** Optional progress callback for observing operation progress */
+  readonly onProgress?: OnControlProgress;
+}
+/**
+ * Contract configuration for emit operation.
+ */
+interface EmitContractConfig {
+  /**
+   * Contract source provider.
+   */
+  readonly sourceProvider: ContractSourceProvider;
+  /**
+   * Output path for contract.json.
+   * The .d.ts types file will be colocated (e.g., contract.json → contract.d.ts).
+   */
+  readonly output: string;
+}
+/**
+ * Options for the emit operation.
+ */
+interface EmitOptions {
+  /**
+   * Contract configuration containing source, output, and types paths.
+   */
+  readonly contractConfig: EmitContractConfig;
+  /** Optional progress callback for observing operation progress */
+  readonly onProgress?: OnControlProgress;
+}
+/**
+ * Successful dbInit result.
+ */
+interface DbInitSuccess {
+  readonly mode: 'plan' | 'apply';
+  readonly plan: {
+    readonly operations: ReadonlyArray<{
+      readonly id: string;
+      readonly label: string;
+      readonly operationClass: string;
+    }>;
+  };
+  readonly execution?: {
+    readonly operationsPlanned: number;
+    readonly operationsExecuted: number;
+  };
+  readonly marker?: {
+    readonly storageHash: string;
+    readonly profileHash?: string;
+  };
+  readonly summary: string;
+}
+/**
+ * Failure codes for dbInit operation.
+ */
+type DbInitFailureCode = 'PLANNING_FAILED' | 'MARKER_ORIGIN_MISMATCH' | 'RUNNER_FAILED';
+/**
+ * Failure details for dbInit operation.
+ */
+interface DbInitFailure {
+  readonly code: DbInitFailureCode;
+  readonly summary: string;
+  readonly why: string | undefined;
+  readonly conflicts: ReadonlyArray<MigrationPlannerConflict> | undefined;
+  readonly meta: Record<string, unknown> | undefined;
+  readonly marker?: {
+    readonly storageHash?: string;
+    readonly profileHash?: string;
+  };
+  readonly destination?: {
+    readonly storageHash: string;
+    readonly profileHash?: string | undefined;
+  };
+}
+/**
+ * Result type for dbInit operation.
+ * Uses Result pattern: success returns DbInitSuccess, failure returns DbInitFailure.
+ */
+type DbInitResult = Result<DbInitSuccess, DbInitFailure>;
+/**
+ * Successful emit result.
+ * Contains the hashes and paths of emitted files.
+ */
+interface EmitSuccess {
+  /** Storage hash of the emitted contract */
+  readonly storageHash: string;
+  /** Execution hash of the emitted contract (if execution section exists) */
+  readonly executionHash?: string;
+  /** Profile hash of the emitted contract (target-specific) */
+  readonly profileHash: string;
+  /** The emitted contract as JSON string */
+  readonly contractJson: string;
+  /** The emitted contract TypeScript declarations */
+  readonly contractDts: string;
+}
+/**
+ * Failure codes for emit operation.
+ */
+type EmitFailureCode = 'CONTRACT_SOURCE_INVALID' | 'EMIT_FAILED';
+/**
+ * Failure details for emit operation.
+ */
+interface EmitFailure {
+  readonly code: EmitFailureCode;
+  readonly summary: string;
+  readonly why: string | undefined;
+  readonly meta: Record<string, unknown> | undefined;
+  readonly diagnostics?: ContractSourceDiagnostics;
+}
+/**
+ * Result type for emit operation.
+ * Uses Result pattern: success returns EmitSuccess, failure returns EmitFailure.
+ */
+type EmitResult = Result<EmitSuccess, EmitFailure>;
+/**
+ * Options for the standalone executeContractEmit function.
+ * Used by tooling (e.g., Vite plugin) that needs to emit contracts
+ * without the full ControlClient infrastructure.
+ */
+interface ContractEmitOptions {
+  /** Path to the prisma-next.config.ts file */
+  readonly configPath: string;
+  /** Optional AbortSignal for cancellation support */
+  readonly signal?: AbortSignal;
+}
+/**
+ * Result from the standalone executeContractEmit function.
+ */
+interface ContractEmitResult {
+  /** Hash of the storage contract (schema-level) */
+  readonly storageHash: string;
+  /** Hash of the execution contract (if execution section exists) */
+  readonly executionHash?: string;
+  /** Hash of the profile (target+extensions) */
+  readonly profileHash: string;
+  /** Paths to the emitted files */
+  readonly files: {
+    /** Path to the emitted contract.json file */
+    readonly json: string;
+    /** Path to the emitted contract.d.ts file */
+    readonly dts: string;
+  };
+}
+/**
+ * Programmatic control client for Prisma Next operations.
+ *
+ * Lifecycle: `connect(connection)` before operations, `close()` when done.
+ * Both `init()` and `connect()` are auto-called by operations if needed,
+ * but `connect()` requires a connection so must be called explicitly first
+ * unless a default connection was provided in options.
+ *
+ * @see README.md "Programmatic Control API" section for usage examples
+ */
+interface ControlClient {
+  /**
+   * Initializes the client by creating the control plane stack,
+   * family instance, and validating framework components.
+   *
+   * Idempotent (safe to call multiple times).
+   * Called automatically by `connect()` if not already initialized.
+   */
+  init(): void;
+  /**
+   * Establishes a database connection.
+   * Auto-calls `init()` if not already initialized.
+   * Must be called before any database operations unless a default connection
+   * was provided in options.
+   *
+   * @param connection - Driver-specific connection input (e.g., URL string for Postgres).
+   *   If omitted, uses the default connection from options (if provided).
+   * @throws If connection fails, already connected, driver is not configured,
+   *   or no connection provided and no default connection in options.
+   */
+  connect(connection?: unknown): Promise<void>;
+  /**
+   * Closes the database connection.
+   * Idempotent (safe to call multiple times).
+   * After close(), can call `connect()` again with same or different URL.
+   */
+  close(): Promise<void>;
+  /**
+   * Verifies database marker matches the contract.
+   * Compares storageHash and profileHash.
+   *
+   * @returns Structured result (ok: false for mismatch, not throwing)
+   * @throws If not connected or infrastructure failure
+   */
+  verify(options: VerifyOptions): Promise<VerifyDatabaseResult$1>;
+  /**
+   * Verifies database schema satisfies the contract requirements.
+   *
+   * @param options.strict - If true, extra tables/columns are issues. Default: false
+   * @returns Structured result with schema issues
+   * @throws If not connected or infrastructure failure
+   */
+  schemaVerify(options: SchemaVerifyOptions): Promise<VerifyDatabaseSchemaResult$1>;
+  /**
+   * Signs the database with a contract marker.
+   * Writes or updates the contract marker if schema verification passes.
+   * Idempotent (no-op if marker already matches).
+   *
+   * @returns Structured result
+   * @throws If not connected or infrastructure failure
+   */
+  sign(options: SignOptions): Promise<SignDatabaseResult$1>;
+  /**
+   * Initializes database schema from contract.
+   * Uses additive-only policy (no destructive changes).
+   *
+   * @param options.mode - 'plan' to preview, 'apply' to execute
+   * @returns Result pattern: Ok with planned/executed operations, NotOk with failure details
+   * @throws If not connected, target doesn't support migrations, or infrastructure failure
+   */
+  dbInit(options: DbInitOptions): Promise<DbInitResult>;
+  /**
+   * Introspects the database schema.
+   *
+   * @returns Raw schema IR
+   * @throws If not connected or infrastructure failure
+   */
+  introspect(options?: IntrospectOptions): Promise<unknown>;
+  /**
+   * Converts a schema IR to a schema view for CLI tree rendering.
+   * Delegates to the family instance's toSchemaView method.
+   *
+   * @param schemaIR - The schema IR from introspect()
+   * @returns CoreSchemaView if the family supports it, undefined otherwise
+   */
+  toSchemaView(schemaIR: unknown): CoreSchemaView | undefined;
+  /**
+   * Emits the contract to JSON and TypeScript declarations.
+   * This is an offline operation that does NOT require a database connection.
+   * Uses `init()` to create the stack but does NOT call `connect()`.
+   *
+   * @returns Result pattern: Ok with emit details, NotOk with failure details
+   */
+  emit(options: EmitOptions): Promise<EmitResult>;
+}
+//#endregion
+//#region src/control-api/client.d.ts
+/**
+ * Creates a programmatic control client for Prisma Next operations.
+ *
+ * The client accepts framework component descriptors at creation time,
+ * manages driver lifecycle via connect()/close(), and exposes domain
+ * operations that delegate to the existing family instance methods.
+ *
+ * @see {@link ControlClient} for the client interface
+ * @see README.md "Programmatic Control API" section for usage examples
+ */
+declare function createControlClient(options: ControlClientOptions): ControlClient;
+//#endregion
+//#region src/control-api/operations/contract-emit.d.ts
+/**
+ * Executes the contract emit operation.
+ *
+ * This is an offline operation that:
+ * 1. Loads the Prisma Next config from the specified path
+ * 2. Resolves the contract source from config
+ * 3. Creates a control plane stack and family instance
+ * 4. Emits contract artifacts (JSON and DTS)
+ * 5. Writes files to the paths specified in config
+ *
+ * Supports AbortSignal for cancellation, enabling "last change wins" behavior.
+ *
+ * @param options - Options including configPath and optional signal
+ * @returns File paths and hashes of emitted artifacts
+ * @throws If config loading fails, contract is invalid, or file I/O fails
+ * @throws signal.reason if cancelled via AbortSignal (typically DOMException with name 'AbortError')
+ */
+declare function executeContractEmit(options: ContractEmitOptions): Promise<ContractEmitResult>;
+//#endregion
+export { type ContractEmitOptions, type ContractEmitResult, type ControlActionName, type ControlClient, type ControlClientOptions, type ControlPlaneStack, type ControlProgressEvent, type DbInitFailure, type DbInitFailureCode, type DbInitOptions, type DbInitResult, type DbInitSuccess, type EmitContractConfig, type EmitFailure, type EmitFailureCode, type EmitOptions, type EmitResult, type EmitSuccess, type IntrospectOptions, type OnControlProgress, type SchemaVerifyOptions, type SignDatabaseResult, type SignOptions, type VerifyDatabaseResult, type VerifyDatabaseSchemaResult, type VerifyOptions, createControlClient, executeContractEmit };
+//# sourceMappingURL=control-api.d.mts.map

package/dist/exports/control-api.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"control-api.d.mts","names":[],"sources":["../../src/control-api/types.ts","../../src/control-api/client.ts","../../src/control-api/operations/contract-emit.ts"],"sourcesContent":[],"mappings":";;;;;;;;;AAiCA;;;;;;;;AA2BA;AAqBY,UAhDK,oBAAA,CAgDe;EAoBpB,SAAA,MAAA,EAlEO,uBAkEqB,CAAA,GAAA,EAAA,GAAA,CAAA;EASvB,SAAA,MAAA,EAzEE,uBAmFK,CAAA,GAAA,EAAiB,GAAA,EAAA,GAAA,EAAA,GAAA,CAAA;EAMxB,SAAA,OAAA,EAvFG,wBAuGI,CAAA,GAAA,EAAA,GAAA,EAAiB,GAAA,CAAA;EAMxB;EAwBA,SAAA,MAAA,CAAa,EAlIV,uBAkJI,CAAA,GAAA,EAAiB,GAAA,EAAA,GAAA,EAAA,GAAA,CAAA;EAMxB,SAAA,cAAiB,CAAA,EAtJN,aAkKJ,CAlKkB,0BAkKD,CAAA,GAAA,EAAA,GAAA,EAAA,GAAA,CAAA,CAAA;EAMxB;AAejB;AAgBA;AAuBA;AAKA;EACiB,SAAA,UAAA,CAAA,EAAA,OAAA;;;;;AAmBL,KAvOA,iBAAA,GAuOY,QAAA,GAAA,QAAA,GAAA,cAAA,GAAA,MAAA,GAAA,YAAA,GAAA,MAAA;;;;;AAMxB;AAgBA;AAKA;;;;;AAYA;;AAA6C,KAzPjC,oBAAA,GAyPiC;EAApB,SAAA,MAAA,EAvPF,iBAuPE;EAAM,SAAA,IAAA,EAAA,WAAA;EAWd,SAAA,MAAA,EAAA,MAAmB;EAUnB,SAAA,YAAkB,CAAA,EAAA,MAAA;EA8BlB,SAAA,KAAA,EAAa,MAAA;CAqBG,GAAA;EAOtB,SAAA,MAAA,EA/TY,iBA+TZ;EASO,SAAA,IAAA,EAAA,SAAA;EAAwB,SAAA,MAAA,EAAA,MAAA;EAAR,SAAA,OAAA,EAAA,IAAA,GAAA,SAAA,GAAA,OAAA;CASV;;;;;;AAoBN,KA1VN,iBAAA,GA0VM,CAAA,KAAA,EA1VsB,oBA0VtB,EAAA,GAAA,IAAA;;;;AAQyB,UAzV1B,aAAA,CAyV0B;EASR;EASnB,SAAA,UAAA,EAAA,OAAA;EAAsB;;;;;;ECnbtB;wBDkFQ;;;AE1ExB;;AAEW,UF8EM,mBAAA,CE9EN;EAAR;EAAO,SAAA,UAAA,EAAA,OAAA;;;;;;;;;;;;;;wBF8Fc;;;;;UAMP,WAAA;;;;;;;;;;;;;;;;;;wBAkBO;;;;;UAMP,aAAA;;;;;;;;;;;;;;;;wBAgBO;;;;;UAMP,iBAAA;;;;;;;;;;;;wBAYO;;;;;UAMP,kBAAA;;;;2BAIU;;;;;;;;;;UAWV,WAAA;;;;2BAIU;;wBAEH;;;;;UAUP,aAAA;;;yBAGQ;;;;;;;;;;;;;;;;;;;KAoBb,iBAAA;;;;UAKK,aAAA;iBACA;;;sBAGK,cAAc;iBACnB;;;;;;;;;;;;;;KAeL,YAAA,GAAe,OAAO,eAAe;;;;;UAMhC,WAAA;;;;;;;;;;;;;;;KAgBL,eAAA;;;;UAKK,WAAA;iBACA;;;iBAGA;yBACQ;;;;;;KAOb,UAAA,GAAa,OAAO,aAAa;;;;;;UAW5B,mBAAA;;;;oBAIG;;;;;UAMH,kBAAA;;;;;;;;;;;;;;;;;;;;;;;;;UA8BA,aAAA;;;;;;;;;;;;;;;;;;;;iCAqBgB;;;;;;WAOtB;;;;;;;;kBASO,gBAAgB,QAAQ;;;;;;;;wBASlB,sBAAsB,QAAQ;;;;;;;;;gBAUtC,cAAc,QAAQ;;;;;;;;;kBAUpB,gBAAgB,QAAQ;;;;;;;uBAQnB,oBAAoB;;;;;;;;mCASR;;;;;;;;gBASnB,cAAc,QAAQ;;;;;;;;;AAxbtC;;;;;AAW0C,iBCN1B,mBAAA,CDM0B,OAAA,ECNG,oBDMH,CAAA,ECN0B,aDM1B;;;;;;;;AAX1C;;;;;;;;AA2BA;AAqBA;AAoBA;AASA;AAgBiB,iBEhFK,mBAAA,CFgGE,OAAA,EE/Fb,mBF+F8B,CAAA,EE9FtC,OF8FsC,CE9F9B,kBF8F8B,CAAA"}

package/dist/exports/control-api.mjs

@@ -0,0 +1,96 @@
+import { t as loadConfig } from "../config-loader-BJ8HsEdA.mjs";
+import { f as errorRuntime, r as errorContractConfigMissing, t as createControlClient } from "../client-BSZKpZTF.mjs";
+import { dirname, isAbsolute, join, resolve } from "pathe";
+import { createControlPlaneStack } from "@prisma-next/core-control-plane/stack";
+import { ifDefined } from "@prisma-next/utils/defined";
+import { mkdir, writeFile } from "node:fs/promises";
+import { abortable } from "@prisma-next/utils/abortable";
+
+//#region src/control-api/operations/contract-emit.ts
+function isRecord(value) {
+	return typeof value === "object" && value !== null;
+}
+function isAbortError(error) {
+	return isRecord(error) && typeof error["name"] === "string" && error["name"] === "AbortError";
+}
+function isProviderFailureLike(value) {
+	return isRecord(value) && typeof value["summary"] === "string" && Array.isArray(value["diagnostics"]);
+}
+/**
+* Executes the contract emit operation.
+*
+* This is an offline operation that:
+* 1. Loads the Prisma Next config from the specified path
+* 2. Resolves the contract source from config
+* 3. Creates a control plane stack and family instance
+* 4. Emits contract artifacts (JSON and DTS)
+* 5. Writes files to the paths specified in config
+*
+* Supports AbortSignal for cancellation, enabling "last change wins" behavior.
+*
+* @param options - Options including configPath and optional signal
+* @returns File paths and hashes of emitted artifacts
+* @throws If config loading fails, contract is invalid, or file I/O fails
+* @throws signal.reason if cancelled via AbortSignal (typically DOMException with name 'AbortError')
+*/
+async function executeContractEmit(options) {
+	const { configPath, signal = new AbortController().signal } = options;
+	const unlessAborted = abortable(signal);
+	const config = await unlessAborted(loadConfig(configPath));
+	if (!config.contract) throw errorContractConfigMissing({ why: "Config.contract is required for emit. Define it in your config: contract: { source: ..., output: ... }" });
+	const contractConfig = config.contract;
+	if (!contractConfig.output) throw errorContractConfigMissing({ why: "Contract config must have output path. This should not happen if defineConfig() was used." });
+	if (!contractConfig.output.endsWith(".json")) throw errorContractConfigMissing({ why: "Contract config output path must end with .json (e.g., \"src/prisma/contract.json\")" });
+	if (typeof contractConfig.source !== "function") throw errorContractConfigMissing({ why: "Contract config must include a valid source provider function" });
+	const configDir = dirname(resolve(configPath));
+	const outputJsonPath = isAbsolute(contractConfig.output) ? contractConfig.output : join(configDir, contractConfig.output);
+	const outputDtsPath = `${outputJsonPath.slice(0, -5)}.d.ts`;
+	let providerResult;
+	try {
+		providerResult = await unlessAborted(contractConfig.source());
+	} catch (error) {
+		if (signal.aborted || isAbortError(error)) throw error;
+		throw errorRuntime("Failed to resolve contract source", {
+			why: error instanceof Error ? error.message : String(error),
+			fix: "Ensure contract.source resolves to ok(contractIR) or returns structured diagnostics."
+		});
+	}
+	if (!isRecord(providerResult) || typeof providerResult.ok !== "boolean") throw errorRuntime("Failed to resolve contract source", {
+		why: "Contract source provider returned malformed result shape.",
+		fix: "Ensure contract.source resolves to ok(contractIR) or notOk({ summary, diagnostics })."
+	});
+	if (providerResult.ok && !("value" in providerResult)) throw errorRuntime("Failed to resolve contract source", {
+		why: "Contract source provider returned malformed success result: missing value.",
+		fix: "Ensure contract.source success payload is ok(contractIR)."
+	});
+	if (!providerResult.ok && !isProviderFailureLike(providerResult.failure)) throw errorRuntime("Failed to resolve contract source", {
+		why: "Contract source provider returned malformed failure result: expected summary and diagnostics.",
+		fix: "Ensure contract.source failure payload is notOk({ summary, diagnostics, meta? })."
+	});
+	if (!providerResult.ok) throw errorRuntime("Failed to resolve contract source", {
+		why: providerResult.failure.summary,
+		fix: "Fix contract source diagnostics and return ok(contractIR).",
+		meta: {
+			diagnostics: providerResult.failure.diagnostics,
+			...ifDefined("providerMeta", providerResult.failure.meta)
+		}
+	});
+	const stack = createControlPlaneStack(config);
+	const emitResult = await unlessAborted(config.family.create(stack).emitContract({ contractIR: providerResult.value }));
+	await unlessAborted(mkdir(dirname(outputJsonPath), { recursive: true }));
+	await unlessAborted(writeFile(outputJsonPath, emitResult.contractJson, "utf-8"));
+	await unlessAborted(writeFile(outputDtsPath, emitResult.contractDts, "utf-8"));
+	return {
+		storageHash: emitResult.storageHash,
+		...ifDefined("executionHash", emitResult.executionHash),
+		profileHash: emitResult.profileHash,
+		files: {
+			json: outputJsonPath,
+			dts: outputDtsPath
+		}
+	};
+}
+
+//#endregion
+export { createControlClient, executeContractEmit };
+//# sourceMappingURL=control-api.mjs.map