@prisma-next/cli 0.3.0-dev.16 → 0.3.0-dev.162

package/dist/exports/control-api.mjs

@@ -0,0 +1,109 @@
+import { t as loadConfig } from "../config-loader-C4VXKl8f.mjs";
+import { i as errorContractConfigMissing, m as errorRuntime } from "../cli-errors-BDCYR5ap.mjs";
+import { t as assertFrameworkComponentsCompatible } from "../framework-components-BAsliT4V.mjs";
+import { r as enrichContract, t as createControlClient } from "../client-yYtotiSX.mjs";
+import { dirname, isAbsolute, join, resolve } from "pathe";
+import { emit } from "@prisma-next/emitter";
+import { createControlStack } from "@prisma-next/framework-components/control";
+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`;
+	const sourceContext = { composedExtensionPacks: (config.extensionPacks ?? []).map((p) => p.id) };
+	let providerResult;
+	try {
+		providerResult = await unlessAborted(contractConfig.source(sourceContext));
+	} 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(Contract) 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(Contract) 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(Contract)."
+	});
+	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(Contract).",
+		meta: {
+			diagnostics: providerResult.failure.diagnostics,
+			...ifDefined("providerMeta", providerResult.failure.meta)
+		}
+	});
+	const stack = createControlStack(config);
+	const familyInstance = config.family.create(stack);
+	const rawComponents = [
+		config.target,
+		config.adapter,
+		...config.extensionPacks ?? []
+	];
+	const frameworkComponents = assertFrameworkComponentsCompatible(config.family.familyId, config.target.targetId, rawComponents);
+	const enrichedIR = enrichContract(providerResult.value, frameworkComponents);
+	familyInstance.validateContract(enrichedIR);
+	const emitResult = await unlessAborted(emit(enrichedIR, stack, config.family.emission));
+	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, enrichContract, executeContractEmit };
+//# sourceMappingURL=control-api.mjs.map

package/dist/exports/control-api.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"control-api.mjs","names":["providerResult: Awaited<ReturnType<typeof contractConfig.source>>"],"sources":["../../src/control-api/operations/contract-emit.ts"],"sourcesContent":["import { mkdir, writeFile } from 'node:fs/promises';\nimport type { Contract } from '@prisma-next/contract/types';\nimport { emit } from '@prisma-next/emitter';\nimport { createControlStack } from '@prisma-next/framework-components/control';\nimport { abortable } from '@prisma-next/utils/abortable';\nimport { ifDefined } from '@prisma-next/utils/defined';\nimport { dirname, isAbsolute, join, resolve } from 'pathe';\nimport { loadConfig } from '../../config-loader';\nimport { errorContractConfigMissing, errorRuntime } from '../../utils/cli-errors';\nimport { assertFrameworkComponentsCompatible } from '../../utils/framework-components';\nimport { enrichContract } from '../contract-enrichment';\nimport type { ContractEmitOptions, ContractEmitResult } from '../types';\n\ninterface ProviderFailureLike {\n  readonly summary: string;\n  readonly diagnostics: readonly unknown[];\n  readonly meta?: unknown;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null;\n}\n\nfunction isAbortError(error: unknown): boolean {\n  return isRecord(error) && typeof error['name'] === 'string' && error['name'] === 'AbortError';\n}\n\nfunction isProviderFailureLike(value: unknown): value is ProviderFailureLike {\n  return (\n    isRecord(value) && typeof value['summary'] === 'string' && Array.isArray(value['diagnostics'])\n  );\n}\n\n/**\n * Executes the contract emit operation.\n *\n * This is an offline operation that:\n * 1. Loads the Prisma Next config from the specified path\n * 2. Resolves the contract source from config\n * 3. Creates a control plane stack and family instance\n * 4. Emits contract artifacts (JSON and DTS)\n * 5. Writes files to the paths specified in config\n *\n * Supports AbortSignal for cancellation, enabling \"last change wins\" behavior.\n *\n * @param options - Options including configPath and optional signal\n * @returns File paths and hashes of emitted artifacts\n * @throws If config loading fails, contract is invalid, or file I/O fails\n * @throws signal.reason if cancelled via AbortSignal (typically DOMException with name 'AbortError')\n */\nexport async function executeContractEmit(\n  options: ContractEmitOptions,\n): Promise<ContractEmitResult> {\n  const { configPath, signal = new AbortController().signal } = options;\n  const unlessAborted = abortable(signal);\n\n  // Load config using the existing config loader\n  const config = await unlessAborted(loadConfig(configPath));\n\n  // Validate contract config is present\n  if (!config.contract) {\n    throw errorContractConfigMissing({\n      why: 'Config.contract is required for emit. Define it in your config: contract: { source: ..., output: ... }',\n    });\n  }\n\n  const contractConfig = config.contract;\n\n  // Validate output path is present and ends with .json\n  if (!contractConfig.output) {\n    throw errorContractConfigMissing({\n      why: 'Contract config must have output path. This should not happen if defineConfig() was used.',\n    });\n  }\n  if (!contractConfig.output.endsWith('.json')) {\n    throw errorContractConfigMissing({\n      why: 'Contract config output path must end with .json (e.g., \"src/prisma/contract.json\")',\n    });\n  }\n\n  // Validate source exists and is callable\n  if (typeof contractConfig.source !== 'function') {\n    throw errorContractConfigMissing({\n      why: 'Contract config must include a valid source provider function',\n    });\n  }\n\n  // Normalize configPath and resolve artifact paths relative to config file directory\n  const normalizedConfigPath = resolve(configPath);\n  const configDir = dirname(normalizedConfigPath);\n  const outputJsonPath = isAbsolute(contractConfig.output)\n    ? contractConfig.output\n    : join(configDir, contractConfig.output);\n  // Colocate .d.ts with .json (contract.json → contract.d.ts)\n  const outputDtsPath = `${outputJsonPath.slice(0, -5)}.d.ts`;\n\n  const sourceContext = {\n    composedExtensionPacks: (config.extensionPacks ?? []).map((p) => p.id),\n  };\n\n  let providerResult: Awaited<ReturnType<typeof contractConfig.source>>;\n  try {\n    providerResult = await unlessAborted(contractConfig.source(sourceContext));\n  } catch (error) {\n    if (signal.aborted || isAbortError(error)) {\n      throw error;\n    }\n    throw errorRuntime('Failed to resolve contract source', {\n      why: error instanceof Error ? error.message : String(error),\n      fix: 'Ensure contract.source resolves to ok(Contract) or returns structured diagnostics.',\n    });\n  }\n\n  if (!isRecord(providerResult) || typeof providerResult.ok !== 'boolean') {\n    throw errorRuntime('Failed to resolve contract source', {\n      why: 'Contract source provider returned malformed result shape.',\n      fix: 'Ensure contract.source resolves to ok(Contract) or notOk({ summary, diagnostics }).',\n    });\n  }\n\n  if (providerResult.ok && !('value' in providerResult)) {\n    throw errorRuntime('Failed to resolve contract source', {\n      why: 'Contract source provider returned malformed success result: missing value.',\n      fix: 'Ensure contract.source success payload is ok(Contract).',\n    });\n  }\n\n  if (!providerResult.ok && !isProviderFailureLike(providerResult.failure)) {\n    throw errorRuntime('Failed to resolve contract source', {\n      why: 'Contract source provider returned malformed failure result: expected summary and diagnostics.',\n      fix: 'Ensure contract.source failure payload is notOk({ summary, diagnostics, meta? }).',\n    });\n  }\n\n  if (!providerResult.ok) {\n    throw errorRuntime('Failed to resolve contract source', {\n      why: providerResult.failure.summary,\n      fix: 'Fix contract source diagnostics and return ok(Contract).',\n      meta: {\n        diagnostics: providerResult.failure.diagnostics,\n        ...ifDefined('providerMeta', providerResult.failure.meta),\n      },\n    });\n  }\n\n  const stack = createControlStack(config);\n  const familyInstance = config.family.create(stack);\n\n  const rawComponents = [config.target, config.adapter, ...(config.extensionPacks ?? [])];\n  const frameworkComponents = assertFrameworkComponentsCompatible(\n    config.family.familyId,\n    config.target.targetId,\n    rawComponents,\n  );\n  const enrichedIR = enrichContract(providerResult.value as Contract, frameworkComponents);\n\n  familyInstance.validateContract(enrichedIR);\n  const emitResult = await unlessAborted(emit(enrichedIR, stack, config.family.emission));\n\n  // Create directory if needed and write files (both colocated)\n  await unlessAborted(mkdir(dirname(outputJsonPath), { recursive: true }));\n  await unlessAborted(writeFile(outputJsonPath, emitResult.contractJson, 'utf-8'));\n  await unlessAborted(writeFile(outputDtsPath, emitResult.contractDts, 'utf-8'));\n\n  return {\n    storageHash: emitResult.storageHash,\n    ...ifDefined('executionHash', emitResult.executionHash),\n    profileHash: emitResult.profileHash,\n    files: {\n      json: outputJsonPath,\n      dts: outputDtsPath,\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;AAmBA,SAAS,SAAS,OAAkD;AAClE,QAAO,OAAO,UAAU,YAAY,UAAU;;AAGhD,SAAS,aAAa,OAAyB;AAC7C,QAAO,SAAS,MAAM,IAAI,OAAO,MAAM,YAAY,YAAY,MAAM,YAAY;;AAGnF,SAAS,sBAAsB,OAA8C;AAC3E,QACE,SAAS,MAAM,IAAI,OAAO,MAAM,eAAe,YAAY,MAAM,QAAQ,MAAM,eAAe;;;;;;;;;;;;;;;;;;;AAqBlG,eAAsB,oBACpB,SAC6B;CAC7B,MAAM,EAAE,YAAY,SAAS,IAAI,iBAAiB,CAAC,WAAW;CAC9D,MAAM,gBAAgB,UAAU,OAAO;CAGvC,MAAM,SAAS,MAAM,cAAc,WAAW,WAAW,CAAC;AAG1D,KAAI,CAAC,OAAO,SACV,OAAM,2BAA2B,EAC/B,KAAK,0GACN,CAAC;CAGJ,MAAM,iBAAiB,OAAO;AAG9B,KAAI,CAAC,eAAe,OAClB,OAAM,2BAA2B,EAC/B,KAAK,6FACN,CAAC;AAEJ,KAAI,CAAC,eAAe,OAAO,SAAS,QAAQ,CAC1C,OAAM,2BAA2B,EAC/B,KAAK,wFACN,CAAC;AAIJ,KAAI,OAAO,eAAe,WAAW,WACnC,OAAM,2BAA2B,EAC/B,KAAK,iEACN,CAAC;CAKJ,MAAM,YAAY,QADW,QAAQ,WAAW,CACD;CAC/C,MAAM,iBAAiB,WAAW,eAAe,OAAO,GACpD,eAAe,SACf,KAAK,WAAW,eAAe,OAAO;CAE1C,MAAM,gBAAgB,GAAG,eAAe,MAAM,GAAG,GAAG,CAAC;CAErD,MAAM,gBAAgB,EACpB,yBAAyB,OAAO,kBAAkB,EAAE,EAAE,KAAK,MAAM,EAAE,GAAG,EACvE;CAED,IAAIA;AACJ,KAAI;AACF,mBAAiB,MAAM,cAAc,eAAe,OAAO,cAAc,CAAC;UACnE,OAAO;AACd,MAAI,OAAO,WAAW,aAAa,MAAM,CACvC,OAAM;AAER,QAAM,aAAa,qCAAqC;GACtD,KAAK,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;GAC3D,KAAK;GACN,CAAC;;AAGJ,KAAI,CAAC,SAAS,eAAe,IAAI,OAAO,eAAe,OAAO,UAC5D,OAAM,aAAa,qCAAqC;EACtD,KAAK;EACL,KAAK;EACN,CAAC;AAGJ,KAAI,eAAe,MAAM,EAAE,WAAW,gBACpC,OAAM,aAAa,qCAAqC;EACtD,KAAK;EACL,KAAK;EACN,CAAC;AAGJ,KAAI,CAAC,eAAe,MAAM,CAAC,sBAAsB,eAAe,QAAQ,CACtE,OAAM,aAAa,qCAAqC;EACtD,KAAK;EACL,KAAK;EACN,CAAC;AAGJ,KAAI,CAAC,eAAe,GAClB,OAAM,aAAa,qCAAqC;EACtD,KAAK,eAAe,QAAQ;EAC5B,KAAK;EACL,MAAM;GACJ,aAAa,eAAe,QAAQ;GACpC,GAAG,UAAU,gBAAgB,eAAe,QAAQ,KAAK;GAC1D;EACF,CAAC;CAGJ,MAAM,QAAQ,mBAAmB,OAAO;CACxC,MAAM,iBAAiB,OAAO,OAAO,OAAO,MAAM;CAElD,MAAM,gBAAgB;EAAC,OAAO;EAAQ,OAAO;EAAS,GAAI,OAAO,kBAAkB,EAAE;EAAE;CACvF,MAAM,sBAAsB,oCAC1B,OAAO,OAAO,UACd,OAAO,OAAO,UACd,cACD;CACD,MAAM,aAAa,eAAe,eAAe,OAAmB,oBAAoB;AAExF,gBAAe,iBAAiB,WAAW;CAC3C,MAAM,aAAa,MAAM,cAAc,KAAK,YAAY,OAAO,OAAO,OAAO,SAAS,CAAC;AAGvF,OAAM,cAAc,MAAM,QAAQ,eAAe,EAAE,EAAE,WAAW,MAAM,CAAC,CAAC;AACxE,OAAM,cAAc,UAAU,gBAAgB,WAAW,cAAc,QAAQ,CAAC;AAChF,OAAM,cAAc,UAAU,eAAe,WAAW,aAAa,QAAQ,CAAC;AAE9E,QAAO;EACL,aAAa,WAAW;EACxB,GAAG,UAAU,iBAAiB,WAAW,cAAc;EACvD,aAAa,WAAW;EACxB,OAAO;GACL,MAAM;GACN,KAAK;GACN;EACF"}

package/dist/{load-ts-contract.d.ts → exports/index.d.mts}

@@ -1,9 +1,12 @@
-import type { ContractIR } from '@prisma-next/contract/ir';
-export interface LoadTsContractOptions {
-    readonly allowlist?: ReadonlyArray<string>;
+import { createContractEmitCommand } from "../commands/contract-emit.mjs";
+import { Contract } from "@prisma-next/contract/types";
+
+//#region src/load-ts-contract.d.ts
+interface LoadTsContractOptions {
+  readonly allowlist?: ReadonlyArray<string>;
 }
 /**
- * Loads a contract from a TypeScript file and returns it as ContractIR.
+ * Loads a contract from a TypeScript file and returns it as Contract.
  *
  * **Responsibility: Parsing Only**
  * This function loads and parses a TypeScript contract file. It does NOT normalize the contract.
@@ -14,8 +17,10 @@ export interface LoadTsContractOptions {
  *
  * @param entryPath - Path to the TypeScript contract file
  * @param options - Optional configuration (import allowlist)
- * @returns The contract as ContractIR (should already be normalized)
+ * @returns The contract as Contract (should already be normalized)
  * @throws Error if the contract cannot be loaded or is not JSON-serializable
  */
-export declare function loadContractFromTs(entryPath: string, options?: LoadTsContractOptions): Promise<ContractIR>;
-//# sourceMappingURL=load-ts-contract.d.ts.map
+declare function loadContractFromTs(entryPath: string, options?: LoadTsContractOptions): Promise<Contract>;
+//#endregion
+export { type LoadTsContractOptions, createContractEmitCommand, loadContractFromTs };
+//# sourceMappingURL=index.d.mts.map

package/dist/exports/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/load-ts-contract.ts"],"sourcesContent":[],"mappings":";;;;UAQiB,qBAAA;uBACM;;AADvB;AA+GA;;;;;;;;;;;;;;iBAAsB,kBAAA,8BAEV,wBACT,QAAQ"}

package/dist/exports/index.mjs

@@ -0,0 +1,141 @@
+import "../config-loader-C4VXKl8f.mjs";
+import "../cli-errors-BDCYR5ap.mjs";
+import "../framework-components-BAsliT4V.mjs";
+import "../client-yYtotiSX.mjs";
+import "../terminal-ui-N5tR-ob5.mjs";
+import { t as createContractEmitCommand } from "../contract-emit-Bk_eEDKu.mjs";
+import { existsSync, unlinkSync, writeFileSync } from "node:fs";
+import { join } from "pathe";
+import { tmpdir } from "node:os";
+import { pathToFileURL } from "node:url";
+import { build } from "esbuild";
+
+//#region src/load-ts-contract.ts
+const DEFAULT_ALLOWLIST = ["@prisma-next/*", "node:crypto"];
+function isAllowedImport(importPath, allowlist) {
+	for (const pattern of allowlist) if (pattern.endsWith("/*")) {
+		const prefix = pattern.slice(0, -2);
+		if (importPath === prefix || importPath.startsWith(`${prefix}/`)) return true;
+	} else if (pattern.endsWith("*")) {
+		const prefix = pattern.slice(0, -1);
+		if (importPath.startsWith(prefix)) return true;
+	} else if (importPath === pattern) return true;
+	return false;
+}
+function validatePurity(value) {
+	if (typeof value !== "object" || value === null) return;
+	const path = /* @__PURE__ */ new WeakSet();
+	function check(value$1) {
+		if (value$1 === null || typeof value$1 !== "object") return;
+		if (path.has(value$1)) throw new Error("Contract export contains circular references");
+		path.add(value$1);
+		try {
+			for (const key in value$1) {
+				const descriptor = Object.getOwnPropertyDescriptor(value$1, key);
+				if (descriptor && (descriptor.get || descriptor.set)) throw new Error(`Contract export contains getter/setter at key "${key}"`);
+				if (descriptor && typeof descriptor.value === "function") throw new Error(`Contract export contains function at key "${key}"`);
+				check(value$1[key]);
+			}
+		} finally {
+			path.delete(value$1);
+		}
+	}
+	try {
+		check(value);
+		JSON.stringify(value);
+	} catch (error) {
+		if (error instanceof Error) {
+			if (error.message.includes("getter") || error.message.includes("circular")) throw error;
+			throw new Error(`Contract export is not JSON-serializable: ${error.message}`);
+		}
+		throw new Error("Contract export is not JSON-serializable");
+	}
+}
+function createImportAllowlistPlugin(allowlist, entryPath) {
+	return {
+		name: "import-allowlist",
+		setup(build$1) {
+			build$1.onResolve({ filter: /.*/ }, (args) => {
+				if (args.kind === "entry-point") return;
+				if (args.path.startsWith(".") || args.path.startsWith("/")) return;
+				if ((args.importer === entryPath || args.importer === "<stdin>") && !isAllowedImport(args.path, allowlist)) return {
+					path: args.path,
+					external: true
+				};
+			});
+		}
+	};
+}
+/**
+* Loads a contract from a TypeScript file and returns it as Contract.
+*
+* **Responsibility: Parsing Only**
+* This function loads and parses a TypeScript contract file. It does NOT normalize the contract.
+* The contract should already be normalized if it was built using the contract builder.
+*
+* Normalization must happen in the contract builder when the contract is created.
+* This function only validates that the contract is JSON-serializable and returns it as-is.
+*
+* @param entryPath - Path to the TypeScript contract file
+* @param options - Optional configuration (import allowlist)
+* @returns The contract as Contract (should already be normalized)
+* @throws Error if the contract cannot be loaded or is not JSON-serializable
+*/
+async function loadContractFromTs(entryPath, options) {
+	const allowlist = options?.allowlist ?? DEFAULT_ALLOWLIST;
+	if (!existsSync(entryPath)) throw new Error(`Contract file not found: ${entryPath}`);
+	const tempFile = join(tmpdir(), `prisma-next-contract-${Date.now()}-${Math.random().toString(36).slice(2)}.mjs`);
+	try {
+		const result = await build({
+			entryPoints: [entryPath],
+			bundle: true,
+			format: "esm",
+			platform: "node",
+			target: "es2022",
+			outfile: tempFile,
+			write: false,
+			metafile: true,
+			plugins: [createImportAllowlistPlugin(allowlist, entryPath)],
+			logLevel: "error"
+		});
+		if (result.errors.length > 0) {
+			const errorMessages = result.errors.map((e) => e.text).join("\n");
+			throw new Error(`Failed to bundle contract file: ${errorMessages}`);
+		}
+		if (!result.outputFiles || result.outputFiles.length === 0) throw new Error("No output files generated from bundling");
+		const disallowedImports = [];
+		if (result.metafile) {
+			const inputs = result.metafile.inputs;
+			for (const [, inputData] of Object.entries(inputs)) {
+				const imports = inputData.imports || [];
+				for (const imp of imports) if (imp.external && !imp.path.startsWith(".") && !imp.path.startsWith("/") && !isAllowedImport(imp.path, allowlist)) disallowedImports.push(imp.path);
+			}
+		}
+		if (disallowedImports.length > 0) throw new Error(`Disallowed imports detected. Only imports matching the allowlist are permitted:\n  Allowlist: ${allowlist.join(", ")}\n  Disallowed imports: ${disallowedImports.join(", ")}\n\nOnly @prisma-next/* packages are allowed in contract files.`);
+		const bundleContent = result.outputFiles[0]?.text;
+		if (bundleContent === void 0) throw new Error("Bundle content is undefined");
+		writeFileSync(tempFile, bundleContent, "utf-8");
+		const module = await import(
+			/* @vite-ignore */
+			pathToFileURL(tempFile).href
+);
+		unlinkSync(tempFile);
+		let contract;
+		if (module.default !== void 0) contract = module.default;
+		else if (module.contract !== void 0) contract = module.contract;
+		else throw new Error(`Contract file must export a contract as default export or named export 'contract'. Found exports: ${Object.keys(module).join(", ") || "none"}`);
+		if (typeof contract !== "object" || contract === null) throw new Error(`Contract export must be an object, got ${typeof contract}`);
+		validatePurity(contract);
+		return contract;
+	} catch (error) {
+		try {
+			if (tempFile) unlinkSync(tempFile);
+		} catch {}
+		if (error instanceof Error) throw error;
+		throw new Error(`Failed to load contract from ${entryPath}: ${String(error)}`);
+	}
+}
+
+//#endregion
+export { createContractEmitCommand, loadContractFromTs };
+//# sourceMappingURL=index.mjs.map

package/dist/exports/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["value","disallowedImports: string[]","contract: unknown"],"sources":["../../src/load-ts-contract.ts"],"sourcesContent":["import { existsSync, unlinkSync, writeFileSync } from 'node:fs';\nimport { tmpdir } from 'node:os';\nimport { pathToFileURL } from 'node:url';\nimport type { Contract } from '@prisma-next/contract/types';\nimport type { Plugin } from 'esbuild';\nimport { build } from 'esbuild';\nimport { join } from 'pathe';\n\nexport interface LoadTsContractOptions {\n  readonly allowlist?: ReadonlyArray<string>;\n}\n\nconst DEFAULT_ALLOWLIST = ['@prisma-next/*', 'node:crypto'];\n\nfunction isAllowedImport(importPath: string, allowlist: ReadonlyArray<string>): boolean {\n  for (const pattern of allowlist) {\n    if (pattern.endsWith('/*')) {\n      const prefix = pattern.slice(0, -2);\n      if (importPath === prefix || importPath.startsWith(`${prefix}/`)) {\n        return true;\n      }\n    } else if (pattern.endsWith('*')) {\n      const prefix = pattern.slice(0, -1);\n      if (importPath.startsWith(prefix)) {\n        return true;\n      }\n    } else if (importPath === pattern) {\n      return true;\n    }\n  }\n  return false;\n}\n\nfunction validatePurity(value: unknown): void {\n  if (typeof value !== 'object' || value === null) {\n    return;\n  }\n\n  const path = new WeakSet();\n\n  function check(value: unknown): void {\n    if (value === null || typeof value !== 'object') {\n      return;\n    }\n\n    if (path.has(value)) {\n      throw new Error('Contract export contains circular references');\n    }\n    path.add(value);\n\n    try {\n      for (const key in value) {\n        const descriptor = Object.getOwnPropertyDescriptor(value, key);\n        if (descriptor && (descriptor.get || descriptor.set)) {\n          throw new Error(`Contract export contains getter/setter at key \"${key}\"`);\n        }\n        if (descriptor && typeof descriptor.value === 'function') {\n          throw new Error(`Contract export contains function at key \"${key}\"`);\n        }\n        check((value as Record<string, unknown>)[key]);\n      }\n    } finally {\n      path.delete(value);\n    }\n  }\n\n  try {\n    check(value);\n    JSON.stringify(value);\n  } catch (error) {\n    if (error instanceof Error) {\n      if (error.message.includes('getter') || error.message.includes('circular')) {\n        throw error;\n      }\n      throw new Error(`Contract export is not JSON-serializable: ${error.message}`);\n    }\n    throw new Error('Contract export is not JSON-serializable');\n  }\n}\n\nfunction createImportAllowlistPlugin(allowlist: ReadonlyArray<string>, entryPath: string): Plugin {\n  return {\n    name: 'import-allowlist',\n    setup(build) {\n      build.onResolve({ filter: /.*/ }, (args) => {\n        if (args.kind === 'entry-point') {\n          return undefined;\n        }\n        if (args.path.startsWith('.') || args.path.startsWith('/')) {\n          return undefined;\n        }\n        const isFromEntryPoint = args.importer === entryPath || args.importer === '<stdin>';\n        if (isFromEntryPoint && !isAllowedImport(args.path, allowlist)) {\n          return {\n            path: args.path,\n            external: true,\n          };\n        }\n        return undefined;\n      });\n    },\n  };\n}\n\n/**\n * Loads a contract from a TypeScript file and returns it as Contract.\n *\n * **Responsibility: Parsing Only**\n * This function loads and parses a TypeScript contract file. It does NOT normalize the contract.\n * The contract should already be normalized if it was built using the contract builder.\n *\n * Normalization must happen in the contract builder when the contract is created.\n * This function only validates that the contract is JSON-serializable and returns it as-is.\n *\n * @param entryPath - Path to the TypeScript contract file\n * @param options - Optional configuration (import allowlist)\n * @returns The contract as Contract (should already be normalized)\n * @throws Error if the contract cannot be loaded or is not JSON-serializable\n */\nexport async function loadContractFromTs(\n  entryPath: string,\n  options?: LoadTsContractOptions,\n): Promise<Contract> {\n  const allowlist = options?.allowlist ?? DEFAULT_ALLOWLIST;\n\n  if (!existsSync(entryPath)) {\n    throw new Error(`Contract file not found: ${entryPath}`);\n  }\n\n  const tempFile = join(\n    tmpdir(),\n    `prisma-next-contract-${Date.now()}-${Math.random().toString(36).slice(2)}.mjs`,\n  );\n\n  try {\n    const result = await build({\n      entryPoints: [entryPath],\n      bundle: true,\n      format: 'esm',\n      platform: 'node',\n      target: 'es2022',\n      outfile: tempFile,\n      write: false,\n      metafile: true,\n      plugins: [createImportAllowlistPlugin(allowlist, entryPath)],\n      logLevel: 'error',\n    });\n\n    if (result.errors.length > 0) {\n      const errorMessages = result.errors.map((e: { text: string }) => e.text).join('\\n');\n      throw new Error(`Failed to bundle contract file: ${errorMessages}`);\n    }\n\n    if (!result.outputFiles || result.outputFiles.length === 0) {\n      throw new Error('No output files generated from bundling');\n    }\n\n    const disallowedImports: string[] = [];\n    if (result.metafile) {\n      const inputs = result.metafile.inputs;\n      for (const [, inputData] of Object.entries(inputs)) {\n        const imports =\n          (inputData as { imports?: Array<{ path: string; external?: boolean }> }).imports || [];\n        for (const imp of imports) {\n          if (\n            imp.external &&\n            !imp.path.startsWith('.') &&\n            !imp.path.startsWith('/') &&\n            !isAllowedImport(imp.path, allowlist)\n          ) {\n            disallowedImports.push(imp.path);\n          }\n        }\n      }\n    }\n\n    if (disallowedImports.length > 0) {\n      throw new Error(\n        `Disallowed imports detected. Only imports matching the allowlist are permitted:\\n  Allowlist: ${allowlist.join(', ')}\\n  Disallowed imports: ${disallowedImports.join(', ')}\\n\\nOnly @prisma-next/* packages are allowed in contract files.`,\n      );\n    }\n\n    const bundleContent = result.outputFiles[0]?.text;\n    if (bundleContent === undefined) {\n      throw new Error('Bundle content is undefined');\n    }\n    writeFileSync(tempFile, bundleContent, 'utf-8');\n\n    const module = (await import(/* @vite-ignore */ pathToFileURL(tempFile).href)) as {\n      default?: unknown;\n      contract?: unknown;\n    };\n    unlinkSync(tempFile);\n\n    let contract: unknown;\n\n    if (module.default !== undefined) {\n      contract = module.default;\n    } else if (module.contract !== undefined) {\n      contract = module.contract;\n    } else {\n      throw new Error(\n        `Contract file must export a contract as default export or named export 'contract'. Found exports: ${Object.keys(module as Record<string, unknown>).join(', ') || 'none'}`,\n      );\n    }\n\n    if (typeof contract !== 'object' || contract === null) {\n      throw new Error(`Contract export must be an object, got ${typeof contract}`);\n    }\n\n    validatePurity(contract);\n\n    return contract as Contract;\n  } catch (error) {\n    try {\n      if (tempFile) {\n        unlinkSync(tempFile);\n      }\n    } catch {\n      // Ignore cleanup errors\n    }\n\n    if (error instanceof Error) {\n      throw error;\n    }\n    throw new Error(`Failed to load contract from ${entryPath}: ${String(error)}`);\n  }\n}\n"],"mappings":"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"}

package/dist/extract-operation-statements-BVlb3jxp.mjs

@@ -0,0 +1,13 @@
+import { t as extractSqlDdl } from "./extract-sql-ddl-6EVSOThm.mjs";
+
+//#region src/control-api/operations/extract-operation-statements.ts
+function extractOperationStatements(familyId, operations) {
+	switch (familyId) {
+		case "sql": return extractSqlDdl(operations);
+		default: return;
+	}
+}
+
+//#endregion
+export { extractOperationStatements as t };
+//# sourceMappingURL=extract-operation-statements-BVlb3jxp.mjs.map

package/dist/extract-operation-statements-BVlb3jxp.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-operation-statements-BVlb3jxp.mjs","names":[],"sources":["../src/control-api/operations/extract-operation-statements.ts"],"sourcesContent":["import type { MigrationPlanOperation } from '@prisma-next/framework-components/control';\nimport { extractSqlDdl } from './extract-sql-ddl';\n\nexport function extractOperationStatements(\n  familyId: string,\n  operations: readonly MigrationPlanOperation[],\n): string[] | undefined {\n  switch (familyId) {\n    case 'sql':\n      return extractSqlDdl(operations);\n    default:\n      return undefined;\n  }\n}\n"],"mappings":";;;AAGA,SAAgB,2BACd,UACA,YACsB;AACtB,SAAQ,UAAR;EACE,KAAK,MACH,QAAO,cAAc,WAAW;EAClC,QACE"}

package/dist/extract-sql-ddl-6EVSOThm.mjs

@@ -0,0 +1,26 @@
+//#region src/control-api/operations/extract-sql-ddl.ts
+function isDdlStatement(sqlStatement) {
+	const trimmed = sqlStatement.trim().toLowerCase();
+	return trimmed.startsWith("create ") || trimmed.startsWith("alter ") || trimmed.startsWith("drop ");
+}
+function hasExecuteSteps(operation) {
+	const candidate = operation;
+	if (!("execute" in candidate) || !Array.isArray(candidate["execute"])) return false;
+	return candidate["execute"].every((step) => typeof step === "object" && step !== null && "sql" in step);
+}
+/**
+* Extracts a best-effort SQL DDL preview for CLI plan output.
+* This helper is presentation-only and is never used to decide migration correctness.
+*/
+function extractSqlDdl(operations) {
+	const statements = [];
+	for (const operation of operations) {
+		if (!hasExecuteSteps(operation)) continue;
+		for (const step of operation.execute) if (typeof step.sql === "string" && isDdlStatement(step.sql)) statements.push(step.sql.trim());
+	}
+	return statements;
+}
+
+//#endregion
+export { extractSqlDdl as t };
+//# sourceMappingURL=extract-sql-ddl-6EVSOThm.mjs.map

package/dist/extract-sql-ddl-6EVSOThm.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-sql-ddl-6EVSOThm.mjs","names":["statements: string[]"],"sources":["../src/control-api/operations/extract-sql-ddl.ts"],"sourcesContent":["import type { MigrationPlanOperation } from '@prisma-next/framework-components/control';\n\n/**\n * Shape of an SQL execute step on SqlMigrationPlanOperation.\n * Used for runtime type narrowing without importing the concrete SQL type.\n */\ninterface SqlExecuteStep {\n  readonly sql: string;\n}\n\nfunction isDdlStatement(sqlStatement: string): boolean {\n  const trimmed = sqlStatement.trim().toLowerCase();\n  return (\n    trimmed.startsWith('create ') || trimmed.startsWith('alter ') || trimmed.startsWith('drop ')\n  );\n}\n\nfunction hasExecuteSteps(\n  operation: MigrationPlanOperation,\n): operation is MigrationPlanOperation & { readonly execute: readonly SqlExecuteStep[] } {\n  const candidate = operation as unknown as Record<string, unknown>;\n  if (!('execute' in candidate) || !Array.isArray(candidate['execute'])) {\n    return false;\n  }\n  return candidate['execute'].every(\n    (step: unknown) => typeof step === 'object' && step !== null && 'sql' in step,\n  );\n}\n\n/**\n * Extracts a best-effort SQL DDL preview for CLI plan output.\n * This helper is presentation-only and is never used to decide migration correctness.\n */\nexport function extractSqlDdl(operations: readonly MigrationPlanOperation[]): string[] {\n  const statements: string[] = [];\n  for (const operation of operations) {\n    if (!hasExecuteSteps(operation)) {\n      continue;\n    }\n    for (const step of operation.execute) {\n      if (typeof step.sql === 'string' && isDdlStatement(step.sql)) {\n        statements.push(step.sql.trim());\n      }\n    }\n  }\n  return statements;\n}\n"],"mappings":";AAUA,SAAS,eAAe,cAA+B;CACrD,MAAM,UAAU,aAAa,MAAM,CAAC,aAAa;AACjD,QACE,QAAQ,WAAW,UAAU,IAAI,QAAQ,WAAW,SAAS,IAAI,QAAQ,WAAW,QAAQ;;AAIhG,SAAS,gBACP,WACuF;CACvF,MAAM,YAAY;AAClB,KAAI,EAAE,aAAa,cAAc,CAAC,MAAM,QAAQ,UAAU,WAAW,CACnE,QAAO;AAET,QAAO,UAAU,WAAW,OACzB,SAAkB,OAAO,SAAS,YAAY,SAAS,QAAQ,SAAS,KAC1E;;;;;;AAOH,SAAgB,cAAc,YAAyD;CACrF,MAAMA,aAAuB,EAAE;AAC/B,MAAK,MAAM,aAAa,YAAY;AAClC,MAAI,CAAC,gBAAgB,UAAU,CAC7B;AAEF,OAAK,MAAM,QAAQ,UAAU,QAC3B,KAAI,OAAO,KAAK,QAAQ,YAAY,eAAe,KAAK,IAAI,CAC1D,YAAW,KAAK,KAAK,IAAI,MAAM,CAAC;;AAItC,QAAO"}

package/dist/framework-components-BAsliT4V.mjs

@@ -0,0 +1,59 @@
+import { r as errorConfigValidation } from "./cli-errors-BDCYR5ap.mjs";
+import "@prisma-next/framework-components/components";
+
+//#region src/utils/framework-components.ts
+/**
+* Asserts that all framework components are compatible with the expected family and target.
+*
+* This function validates that each component in the framework components array:
+* - Has kind 'target', 'adapter', 'extension', or 'driver'
+* - Has familyId matching expectedFamilyId
+* - Has targetId matching expectedTargetId
+*
+* This validation happens at the CLI composition boundary, before passing components
+* to typed planner/runner instances. It fills the gap between runtime validation
+* (via `validateConfig()`) and compile-time type enforcement.
+*
+* @param expectedFamilyId - The expected family ID (e.g., 'sql')
+* @param expectedTargetId - The expected target ID (e.g., 'postgres')
+* @param frameworkComponents - Array of framework components to validate
+* @returns The same array typed as TargetBoundComponentDescriptor
+* @throws CliStructuredError if any component is incompatible
+*
+* @example
+* ```ts
+* const config = await loadConfig();
+* const frameworkComponents = [config.target, config.adapter, ...(config.extensionPacks ?? [])];
+*
+* // Validate and type-narrow components before passing to planner
+* const typedComponents = assertFrameworkComponentsCompatible(
+*   config.family.familyId,
+*   config.target.targetId,
+*   frameworkComponents
+* );
+*
+* const planner = target.migrations.createPlanner(familyInstance);
+* planner.plan({ contract, schema, policy, frameworkComponents: typedComponents });
+* ```
+*/
+function assertFrameworkComponentsCompatible(expectedFamilyId, expectedTargetId, frameworkComponents) {
+	for (let i = 0; i < frameworkComponents.length; i++) {
+		const component = frameworkComponents[i];
+		if (typeof component !== "object" || component === null) throw errorConfigValidation("frameworkComponents[]", { why: `Framework component at index ${i} must be an object` });
+		const record = component;
+		if (!Object.hasOwn(record, "kind")) throw errorConfigValidation("frameworkComponents[].kind", { why: `Framework component at index ${i} must have 'kind' property` });
+		const kind = record["kind"];
+		if (kind !== "target" && kind !== "adapter" && kind !== "extension" && kind !== "driver") throw errorConfigValidation("frameworkComponents[].kind", { why: `Framework component at index ${i} has invalid kind '${String(kind)}' (must be 'target', 'adapter', 'extension', or 'driver')` });
+		if (!Object.hasOwn(record, "familyId")) throw errorConfigValidation("frameworkComponents[].familyId", { why: `Framework component at index ${i} (kind: ${String(kind)}) must have 'familyId' property` });
+		const familyId = record["familyId"];
+		if (familyId !== expectedFamilyId) throw errorConfigValidation("frameworkComponents[].familyId", { why: `Framework component at index ${i} (kind: ${String(kind)}) has familyId '${String(familyId)}' but expected '${expectedFamilyId}'` });
+		if (!Object.hasOwn(record, "targetId")) throw errorConfigValidation("frameworkComponents[].targetId", { why: `Framework component at index ${i} (kind: ${String(kind)}) must have 'targetId' property` });
+		const targetId = record["targetId"];
+		if (targetId !== expectedTargetId) throw errorConfigValidation("frameworkComponents[].targetId", { why: `Framework component at index ${i} (kind: ${String(kind)}) has targetId '${String(targetId)}' but expected '${expectedTargetId}'` });
+	}
+	return frameworkComponents;
+}
+
+//#endregion
+export { assertFrameworkComponentsCompatible as t };
+//# sourceMappingURL=framework-components-BAsliT4V.mjs.map

package/dist/framework-components-BAsliT4V.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework-components-BAsliT4V.mjs","names":[],"sources":["../src/utils/framework-components.ts"],"sourcesContent":["import type { Contract } from '@prisma-next/contract/types';\nimport {\n  checkContractComponentRequirements,\n  type TargetBoundComponentDescriptor,\n} from '@prisma-next/framework-components/components';\nimport type { ControlStack } from '@prisma-next/framework-components/control';\nimport { errorConfigValidation, errorContractMissingExtensionPacks } from './cli-errors';\n\n/**\n * Asserts that all framework components are compatible with the expected family and target.\n *\n * This function validates that each component in the framework components array:\n * - Has kind 'target', 'adapter', 'extension', or 'driver'\n * - Has familyId matching expectedFamilyId\n * - Has targetId matching expectedTargetId\n *\n * This validation happens at the CLI composition boundary, before passing components\n * to typed planner/runner instances. It fills the gap between runtime validation\n * (via `validateConfig()`) and compile-time type enforcement.\n *\n * @param expectedFamilyId - The expected family ID (e.g., 'sql')\n * @param expectedTargetId - The expected target ID (e.g., 'postgres')\n * @param frameworkComponents - Array of framework components to validate\n * @returns The same array typed as TargetBoundComponentDescriptor\n * @throws CliStructuredError if any component is incompatible\n *\n * @example\n * ```ts\n * const config = await loadConfig();\n * const frameworkComponents = [config.target, config.adapter, ...(config.extensionPacks ?? [])];\n *\n * // Validate and type-narrow components before passing to planner\n * const typedComponents = assertFrameworkComponentsCompatible(\n *   config.family.familyId,\n *   config.target.targetId,\n *   frameworkComponents\n * );\n *\n * const planner = target.migrations.createPlanner(familyInstance);\n * planner.plan({ contract, schema, policy, frameworkComponents: typedComponents });\n * ```\n */\nexport function assertFrameworkComponentsCompatible<\n  TFamilyId extends string,\n  TTargetId extends string,\n>(\n  expectedFamilyId: TFamilyId,\n  expectedTargetId: TTargetId,\n  frameworkComponents: ReadonlyArray<unknown>,\n): ReadonlyArray<TargetBoundComponentDescriptor<TFamilyId, TTargetId>> {\n  for (let i = 0; i < frameworkComponents.length; i++) {\n    const component = frameworkComponents[i];\n\n    // Check that component is an object\n    if (typeof component !== 'object' || component === null) {\n      throw errorConfigValidation('frameworkComponents[]', {\n        why: `Framework component at index ${i} must be an object`,\n      });\n    }\n\n    const record = component as Record<string, unknown>;\n\n    // Check kind\n    if (!Object.hasOwn(record, 'kind')) {\n      throw errorConfigValidation('frameworkComponents[].kind', {\n        why: `Framework component at index ${i} must have 'kind' property`,\n      });\n    }\n\n    const kind = record['kind'];\n    if (kind !== 'target' && kind !== 'adapter' && kind !== 'extension' && kind !== 'driver') {\n      throw errorConfigValidation('frameworkComponents[].kind', {\n        why: `Framework component at index ${i} has invalid kind '${String(kind)}' (must be 'target', 'adapter', 'extension', or 'driver')`,\n      });\n    }\n\n    // Check familyId\n    if (!Object.hasOwn(record, 'familyId')) {\n      throw errorConfigValidation('frameworkComponents[].familyId', {\n        why: `Framework component at index ${i} (kind: ${String(kind)}) must have 'familyId' property`,\n      });\n    }\n\n    const familyId = record['familyId'];\n    if (familyId !== expectedFamilyId) {\n      throw errorConfigValidation('frameworkComponents[].familyId', {\n        why: `Framework component at index ${i} (kind: ${String(kind)}) has familyId '${String(familyId)}' but expected '${expectedFamilyId}'`,\n      });\n    }\n\n    // Check targetId\n    if (!Object.hasOwn(record, 'targetId')) {\n      throw errorConfigValidation('frameworkComponents[].targetId', {\n        why: `Framework component at index ${i} (kind: ${String(kind)}) must have 'targetId' property`,\n      });\n    }\n\n    const targetId = record['targetId'];\n    if (targetId !== expectedTargetId) {\n      throw errorConfigValidation('frameworkComponents[].targetId', {\n        why: `Framework component at index ${i} (kind: ${String(kind)}) has targetId '${String(targetId)}' but expected '${expectedTargetId}'`,\n      });\n    }\n  }\n\n  // Type assertion is safe because we've validated all components above\n  return frameworkComponents as ReadonlyArray<TargetBoundComponentDescriptor<TFamilyId, TTargetId>>;\n}\n\n/**\n * Validates that a contract is compatible with the configured target, adapter,\n * and extension packs. Throws on family/target mismatches or missing extension packs.\n *\n * This check ensures the emitted contract matches the CLI config before running\n * commands that depend on the contract (e.g., db verify, db sign).\n *\n * @param contract - The contract to validate (must include targetFamily, target, extensionPacks).\n * @param stack - The control plane stack (target, adapter, driver, extensionPacks).\n *\n * @throws {CliStructuredError} errorConfigValidation when contract.targetFamily or contract.target\n *   doesn't match the configured family/target.\n * @throws {CliStructuredError} errorContractMissingExtensionPacks when the contract requires\n *   extension packs that are not provided in the config (includes all missing packs in error.meta).\n *\n * @example\n * ```ts\n * import { assertContractRequirementsSatisfied } from './framework-components';\n *\n * const config = await loadConfig();\n * const contract = await loadContractJson(config.contract.output);\n * const stack = createControlStack({ family: config.family, target: config.target, adapter: config.adapter, ... });\n *\n * // Throws if contract is incompatible with config\n * assertContractRequirementsSatisfied({ contract, stack });\n * ```\n */\nexport function assertContractRequirementsSatisfied<\n  TFamilyId extends string,\n  TTargetId extends string,\n>({\n  contract,\n  stack,\n}: {\n  readonly contract: Pick<Contract, 'targetFamily' | 'target' | 'extensionPacks'>;\n  readonly stack: ControlStack<TFamilyId, TTargetId>;\n}): void {\n  const providedComponentIds = new Set<string>([\n    stack.target.id,\n    ...(stack.adapter ? [stack.adapter.id] : []),\n  ]);\n  for (const extension of stack.extensionPacks) {\n    providedComponentIds.add(extension.id);\n  }\n\n  const result = checkContractComponentRequirements({\n    contract,\n    expectedTargetFamily: stack.target.familyId,\n    expectedTargetId: stack.target.targetId,\n    providedComponentIds,\n  });\n\n  if (result.familyMismatch) {\n    throw errorConfigValidation('contract.targetFamily', {\n      why: `Contract was emitted for family '${result.familyMismatch.actual}' but CLI config is wired to '${result.familyMismatch.expected}'.`,\n    });\n  }\n\n  if (result.targetMismatch) {\n    throw errorConfigValidation('contract.target', {\n      why: `Contract target '${result.targetMismatch.actual}' does not match CLI target '${result.targetMismatch.expected}'.`,\n    });\n  }\n\n  if (result.missingExtensionPackIds.length > 0) {\n    throw errorContractMissingExtensionPacks({\n      missingExtensionPacks: result.missingExtensionPackIds,\n      providedComponentIds: [...providedComponentIds],\n    });\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0CA,SAAgB,oCAId,kBACA,kBACA,qBACqE;AACrE,MAAK,IAAI,IAAI,GAAG,IAAI,oBAAoB,QAAQ,KAAK;EACnD,MAAM,YAAY,oBAAoB;AAGtC,MAAI,OAAO,cAAc,YAAY,cAAc,KACjD,OAAM,sBAAsB,yBAAyB,EACnD,KAAK,gCAAgC,EAAE,qBACxC,CAAC;EAGJ,MAAM,SAAS;AAGf,MAAI,CAAC,OAAO,OAAO,QAAQ,OAAO,CAChC,OAAM,sBAAsB,8BAA8B,EACxD,KAAK,gCAAgC,EAAE,6BACxC,CAAC;EAGJ,MAAM,OAAO,OAAO;AACpB,MAAI,SAAS,YAAY,SAAS,aAAa,SAAS,eAAe,SAAS,SAC9E,OAAM,sBAAsB,8BAA8B,EACxD,KAAK,gCAAgC,EAAE,qBAAqB,OAAO,KAAK,CAAC,4DAC1E,CAAC;AAIJ,MAAI,CAAC,OAAO,OAAO,QAAQ,WAAW,CACpC,OAAM,sBAAsB,kCAAkC,EAC5D,KAAK,gCAAgC,EAAE,UAAU,OAAO,KAAK,CAAC,kCAC/D,CAAC;EAGJ,MAAM,WAAW,OAAO;AACxB,MAAI,aAAa,iBACf,OAAM,sBAAsB,kCAAkC,EAC5D,KAAK,gCAAgC,EAAE,UAAU,OAAO,KAAK,CAAC,kBAAkB,OAAO,SAAS,CAAC,kBAAkB,iBAAiB,IACrI,CAAC;AAIJ,MAAI,CAAC,OAAO,OAAO,QAAQ,WAAW,CACpC,OAAM,sBAAsB,kCAAkC,EAC5D,KAAK,gCAAgC,EAAE,UAAU,OAAO,KAAK,CAAC,kCAC/D,CAAC;EAGJ,MAAM,WAAW,OAAO;AACxB,MAAI,aAAa,iBACf,OAAM,sBAAsB,kCAAkC,EAC5D,KAAK,gCAAgC,EAAE,UAAU,OAAO,KAAK,CAAC,kBAAkB,OAAO,SAAS,CAAC,kBAAkB,iBAAiB,IACrI,CAAC;;AAKN,QAAO"}

package/dist/inspect-live-schema-HMutsJYh.mjs

@@ -0,0 +1,91 @@
+import { t as loadConfig } from "./config-loader-C4VXKl8f.mjs";
+import { _ as errorUnexpected, c as errorDriverRequired, o as errorDatabaseConnectionRequired, t as CliStructuredError } from "./cli-errors-BDCYR5ap.mjs";
+import { t as createControlClient } from "./client-yYtotiSX.mjs";
+import { d as sanitizeErrorMessage, s as maskConnectionUrl, y as formatStyledHeader } from "./terminal-ui-N5tR-ob5.mjs";
+import { t as createProgressAdapter } from "./progress-adapter-D4x8SbJa.mjs";
+import { notOk, ok } from "@prisma-next/utils/result";
+import { relative, resolve } from "pathe";
+import { validatePrintableSqlSchemaIR } from "@prisma-next/psl-printer";
+
+//#region src/commands/inspect-live-schema.ts
+async function inspectLiveSchema(options, flags, ui, startTime, context) {
+	let config;
+	try {
+		config = await loadConfig(options.config);
+	} catch (error) {
+		if (CliStructuredError.is(error)) return notOk(error);
+		return notOk(errorUnexpected(error instanceof Error ? error.message : String(error), { why: "Failed to load config" }));
+	}
+	const configPath = options.config ? relative(process.cwd(), resolve(options.config)) : "prisma-next.config.ts";
+	if (!flags.json && !flags.quiet) {
+		const details = [{
+			label: "config",
+			value: configPath
+		}];
+		if (options.db) details.push({
+			label: "database",
+			value: maskConnectionUrl(options.db)
+		});
+		else if (config.db?.connection && typeof config.db.connection === "string") details.push({
+			label: "database",
+			value: maskConnectionUrl(config.db.connection)
+		});
+		ui.stderr(formatStyledHeader({
+			command: context.commandName,
+			description: context.description,
+			url: context.url,
+			details,
+			flags
+		}));
+	}
+	const dbConnection = options.db ?? config.db?.connection;
+	if (!dbConnection) return notOk(errorDatabaseConnectionRequired({
+		why: `Database connection is required for ${context.commandName} (set db.connection in ${configPath}, or pass --db <url>)`,
+		commandName: context.commandName
+	}));
+	if (!config.driver) return notOk(errorDriverRequired({ why: `Config.driver is required for ${context.commandName}` }));
+	const client = createControlClient({
+		family: config.family,
+		target: config.target,
+		adapter: config.adapter,
+		driver: config.driver,
+		extensionPacks: config.extensionPacks ?? []
+	});
+	const onProgress = createProgressAdapter({
+		ui,
+		flags
+	});
+	try {
+		const schemaIR = await client.introspect({
+			connection: dbConnection,
+			onProgress
+		});
+		const schema = config.family.familyId === "sql" ? validatePrintableSqlSchemaIR(schemaIR) : schemaIR;
+		const schemaView = client.toSchemaView(schema);
+		const dbUrl = typeof dbConnection === "string" ? maskConnectionUrl(dbConnection) : void 0;
+		return ok({
+			config,
+			schema,
+			schemaView,
+			target: {
+				familyId: config.family.familyId,
+				id: config.target.targetId
+			},
+			meta: {
+				configPath,
+				...dbUrl ? { dbUrl } : {}
+			},
+			timings: { total: Date.now() - startTime }
+		});
+	} catch (error) {
+		if (CliStructuredError.is(error)) return notOk(error);
+		const safeMessage = sanitizeErrorMessage(error instanceof Error ? error.message : String(error), typeof dbConnection === "string" ? dbConnection : void 0);
+		return notOk(errorUnexpected(safeMessage, { why: `Unexpected error during ${context.commandName}: ${safeMessage}` }));
+	} finally {
+		await client.close();
+	}
+}
+
+//#endregion
+export { inspectLiveSchema as t };
+//# sourceMappingURL=inspect-live-schema-HMutsJYh.mjs.map

package/dist/inspect-live-schema-HMutsJYh.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect-live-schema-HMutsJYh.mjs","names":["config: LoadedCliConfig","details: Array<{ label: string; value: string }>"],"sources":["../src/commands/inspect-live-schema.ts"],"sourcesContent":["import type { CoreSchemaView } from '@prisma-next/framework-components/control';\nimport { validatePrintableSqlSchemaIR } from '@prisma-next/psl-printer';\nimport { notOk, ok, type Result } from '@prisma-next/utils/result';\nimport { relative, resolve } from 'pathe';\nimport { loadConfig } from '../config-loader';\nimport { createControlClient } from '../control-api/client';\nimport {\n  CliStructuredError,\n  errorDatabaseConnectionRequired,\n  errorDriverRequired,\n  errorUnexpected,\n} from '../utils/cli-errors';\nimport { maskConnectionUrl, sanitizeErrorMessage } from '../utils/command-helpers';\nimport { formatStyledHeader } from '../utils/formatters/styled';\nimport type { CommonCommandOptions, GlobalFlags } from '../utils/global-flags';\nimport { createProgressAdapter } from '../utils/progress-adapter';\nimport type { TerminalUI } from '../utils/terminal-ui';\n\nexport interface InspectLiveSchemaOptions extends CommonCommandOptions {\n  readonly db?: string;\n  readonly config?: string;\n}\n\ninterface InspectLiveSchemaContext {\n  readonly commandName: string;\n  readonly description: string;\n  readonly url: string;\n}\n\ntype LoadedCliConfig = Awaited<ReturnType<typeof loadConfig>>;\n\nexport interface InspectLiveSchemaResult {\n  readonly config: LoadedCliConfig;\n  readonly schema: unknown;\n  readonly schemaView: CoreSchemaView | undefined;\n  readonly target: {\n    readonly familyId: string;\n    readonly id: string;\n  };\n  readonly meta: {\n    readonly configPath?: string;\n    readonly dbUrl?: string;\n  };\n  readonly timings: {\n    readonly total: number;\n  };\n}\n\nexport async function inspectLiveSchema(\n  options: InspectLiveSchemaOptions,\n  flags: GlobalFlags,\n  ui: TerminalUI,\n  startTime: number,\n  context: InspectLiveSchemaContext,\n): Promise<Result<InspectLiveSchemaResult, CliStructuredError>> {\n  let config: LoadedCliConfig;\n  try {\n    config = await loadConfig(options.config);\n  } catch (error) {\n    if (CliStructuredError.is(error)) {\n      return notOk(error);\n    }\n\n    return notOk(\n      errorUnexpected(error instanceof Error ? error.message : String(error), {\n        why: 'Failed to load config',\n      }),\n    );\n  }\n\n  const configPath = options.config\n    ? relative(process.cwd(), resolve(options.config))\n    : 'prisma-next.config.ts';\n\n  if (!flags.json && !flags.quiet) {\n    const details: Array<{ label: string; value: string }> = [\n      { label: 'config', value: configPath },\n    ];\n\n    if (options.db) {\n      details.push({ label: 'database', value: maskConnectionUrl(options.db) });\n    } else if (config.db?.connection && typeof config.db.connection === 'string') {\n      details.push({ label: 'database', value: maskConnectionUrl(config.db.connection) });\n    }\n\n    ui.stderr(\n      formatStyledHeader({\n        command: context.commandName,\n        description: context.description,\n        url: context.url,\n        details,\n        flags,\n      }),\n    );\n  }\n\n  const dbConnection = options.db ?? config.db?.connection;\n  if (!dbConnection) {\n    return notOk(\n      errorDatabaseConnectionRequired({\n        why: `Database connection is required for ${context.commandName} (set db.connection in ${configPath}, or pass --db <url>)`,\n        commandName: context.commandName,\n      }),\n    );\n  }\n\n  if (!config.driver) {\n    return notOk(\n      errorDriverRequired({\n        why: `Config.driver is required for ${context.commandName}`,\n      }),\n    );\n  }\n\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  const onProgress = createProgressAdapter({ ui, flags });\n\n  try {\n    const schemaIR = await client.introspect({\n      connection: dbConnection,\n      onProgress,\n    });\n    // TODO(TML-2251): Remove SQL-specific branching — SQL should use the same family-agnostic path as Mongo.\n    const schema =\n      config.family.familyId === 'sql' ? validatePrintableSqlSchemaIR(schemaIR) : schemaIR;\n    const schemaView = client.toSchemaView(schema);\n\n    const dbUrl = typeof dbConnection === 'string' ? maskConnectionUrl(dbConnection) : undefined;\n\n    return ok({\n      config,\n      schema,\n      schemaView,\n      target: {\n        familyId: config.family.familyId,\n        id: config.target.targetId,\n      },\n      meta: {\n        configPath,\n        ...(dbUrl ? { dbUrl } : {}),\n      },\n      timings: {\n        total: Date.now() - startTime,\n      },\n    });\n  } catch (error) {\n    if (CliStructuredError.is(error)) {\n      return notOk(error);\n    }\n\n    const rawMessage = error instanceof Error ? error.message : String(error);\n    const safeMessage = sanitizeErrorMessage(\n      rawMessage,\n      typeof dbConnection === 'string' ? dbConnection : undefined,\n    );\n    return notOk(\n      errorUnexpected(safeMessage, {\n        why: `Unexpected error during ${context.commandName}: ${safeMessage}`,\n      }),\n    );\n  } finally {\n    await client.close();\n  }\n}\n"],"mappings":";;;;;;;;;;AAgDA,eAAsB,kBACpB,SACA,OACA,IACA,WACA,SAC8D;CAC9D,IAAIA;AACJ,KAAI;AACF,WAAS,MAAM,WAAW,QAAQ,OAAO;UAClC,OAAO;AACd,MAAI,mBAAmB,GAAG,MAAM,CAC9B,QAAO,MAAM,MAAM;AAGrB,SAAO,MACL,gBAAgB,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,EAAE,EACtE,KAAK,yBACN,CAAC,CACH;;CAGH,MAAM,aAAa,QAAQ,SACvB,SAAS,QAAQ,KAAK,EAAE,QAAQ,QAAQ,OAAO,CAAC,GAChD;AAEJ,KAAI,CAAC,MAAM,QAAQ,CAAC,MAAM,OAAO;EAC/B,MAAMC,UAAmD,CACvD;GAAE,OAAO;GAAU,OAAO;GAAY,CACvC;AAED,MAAI,QAAQ,GACV,SAAQ,KAAK;GAAE,OAAO;GAAY,OAAO,kBAAkB,QAAQ,GAAG;GAAE,CAAC;WAChE,OAAO,IAAI,cAAc,OAAO,OAAO,GAAG,eAAe,SAClE,SAAQ,KAAK;GAAE,OAAO;GAAY,OAAO,kBAAkB,OAAO,GAAG,WAAW;GAAE,CAAC;AAGrF,KAAG,OACD,mBAAmB;GACjB,SAAS,QAAQ;GACjB,aAAa,QAAQ;GACrB,KAAK,QAAQ;GACb;GACA;GACD,CAAC,CACH;;CAGH,MAAM,eAAe,QAAQ,MAAM,OAAO,IAAI;AAC9C,KAAI,CAAC,aACH,QAAO,MACL,gCAAgC;EAC9B,KAAK,uCAAuC,QAAQ,YAAY,yBAAyB,WAAW;EACpG,aAAa,QAAQ;EACtB,CAAC,CACH;AAGH,KAAI,CAAC,OAAO,OACV,QAAO,MACL,oBAAoB,EAClB,KAAK,iCAAiC,QAAQ,eAC/C,CAAC,CACH;CAGH,MAAM,SAAS,oBAAoB;EACjC,QAAQ,OAAO;EACf,QAAQ,OAAO;EACf,SAAS,OAAO;EAChB,QAAQ,OAAO;EACf,gBAAgB,OAAO,kBAAkB,EAAE;EAC5C,CAAC;CACF,MAAM,aAAa,sBAAsB;EAAE;EAAI;EAAO,CAAC;AAEvD,KAAI;EACF,MAAM,WAAW,MAAM,OAAO,WAAW;GACvC,YAAY;GACZ;GACD,CAAC;EAEF,MAAM,SACJ,OAAO,OAAO,aAAa,QAAQ,6BAA6B,SAAS,GAAG;EAC9E,MAAM,aAAa,OAAO,aAAa,OAAO;EAE9C,MAAM,QAAQ,OAAO,iBAAiB,WAAW,kBAAkB,aAAa,GAAG;AAEnF,SAAO,GAAG;GACR;GACA;GACA;GACA,QAAQ;IACN,UAAU,OAAO,OAAO;IACxB,IAAI,OAAO,OAAO;IACnB;GACD,MAAM;IACJ;IACA,GAAI,QAAQ,EAAE,OAAO,GAAG,EAAE;IAC3B;GACD,SAAS,EACP,OAAO,KAAK,KAAK,GAAG,WACrB;GACF,CAAC;UACK,OAAO;AACd,MAAI,mBAAmB,GAAG,MAAM,CAC9B,QAAO,MAAM,MAAM;EAIrB,MAAM,cAAc,qBADD,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,EAGvE,OAAO,iBAAiB,WAAW,eAAe,OACnD;AACD,SAAO,MACL,gBAAgB,aAAa,EAC3B,KAAK,2BAA2B,QAAQ,YAAY,IAAI,eACzD,CAAC,CACH;WACO;AACR,QAAM,OAAO,OAAO"}