@prisma-next/cli 0.3.0-dev.6 → 0.3.0-dev.64

package/dist/exports/control-api.mjs

@@ -0,0 +1,98 @@
+import { t as loadConfig } from "../config-loader-PPf4CtDj.mjs";
+import { m as errorRuntime, r as errorContractConfigMissing } from "../cli-errors-JlPTsazx.mjs";
+import "../framework-components-CjV_jD8f.mjs";
+import { t as createControlClient } from "../client-PimzSD1f.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

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 { createControlPlaneStack } from '@prisma-next/core-control-plane/stack';\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 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  let providerResult: Awaited<ReturnType<typeof contractConfig.source>>;\n  try {\n    providerResult = await unlessAborted(contractConfig.source());\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(contractIR) 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(contractIR) 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(contractIR).',\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(contractIR).',\n      meta: {\n        diagnostics: providerResult.failure.diagnostics,\n        ...ifDefined('providerMeta', providerResult.failure.meta),\n      },\n    });\n  }\n\n  // Create control plane stack from config\n  const stack = createControlPlaneStack(config);\n  const familyInstance = config.family.create(stack);\n\n  // Emit contract via family instance\n  const emitResult = await unlessAborted(\n    familyInstance.emitContract({ contractIR: providerResult.value }),\n  );\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":";;;;;;;;;;;AAeA,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,IAAIA;AACJ,KAAI;AACF,mBAAiB,MAAM,cAAc,eAAe,QAAQ,CAAC;UACtD,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;CAIJ,MAAM,QAAQ,wBAAwB,OAAO;CAI7C,MAAM,aAAa,MAAM,cAHF,OAAO,OAAO,OAAO,MAAM,CAIjC,aAAa,EAAE,YAAY,eAAe,OAAO,CAAC,CAClE;AAGD,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,6 +1,9 @@
-import type { ContractIR } from '@prisma-next/contract/ir';
-export interface LoadTsContractOptions {
-    readonly allowlist?: ReadonlyArray<string>;
+import { createContractEmitCommand } from "../commands/contract-emit.mjs";
+import { ContractIR } from "@prisma-next/contract/ir";
+
+//#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.
@@ -17,5 +20,7 @@ export interface LoadTsContractOptions {
  * @returns The contract as ContractIR (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<ContractIR>;
+//#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":";;;;UAOiB,qBAAA;uBACM;;AADvB;AA0GA;;;;;;;;;;;;;;iBAAsB,kBAAA,8BAEV,wBACT,QAAQ"}

package/dist/exports/index.mjs

@@ -0,0 +1,135 @@
+import "../config-loader-PPf4CtDj.mjs";
+import "../cli-errors-JlPTsazx.mjs";
+import "../framework-components-CjV_jD8f.mjs";
+import "../client-PimzSD1f.mjs";
+import "../result-handler-iA9JtUC7.mjs";
+import "../progress-adapter-DENrzF6I.mjs";
+import { createContractEmitCommand } from "../commands/contract-emit.mjs";
+import { existsSync, unlinkSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { build } from "esbuild";
+
+//#region src/load-ts-contract.ts
+const DEFAULT_ALLOWLIST = ["@prisma-next/*"];
+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 (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 ContractIR.
+*
+* **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 ContractIR (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(`file://${tempFile}`);
+		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 { join } from 'node:path';\nimport type { ContractIR } from '@prisma-next/contract/ir';\nimport type { Plugin } from 'esbuild';\nimport { build } from 'esbuild';\n\nexport interface LoadTsContractOptions {\n  readonly allowlist?: ReadonlyArray<string>;\n}\n\nconst DEFAULT_ALLOWLIST = ['@prisma-next/*'];\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 (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 ContractIR.\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 ContractIR (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<ContractIR> {\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(`file://${tempFile}`)) 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 ContractIR;\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-sql-ddl-BmlKvk4o.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-BmlKvk4o.mjs.map

package/dist/extract-sql-ddl-BmlKvk4o.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-sql-ddl-BmlKvk4o.mjs","names":["statements: string[]"],"sources":["../src/control-api/operations/extract-sql-ddl.ts"],"sourcesContent":["import type { MigrationPlanOperation } from '@prisma-next/core-control-plane/types';\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-CjV_jD8f.mjs

@@ -0,0 +1,59 @@
+import { n as errorConfigValidation } from "./cli-errors-JlPTsazx.mjs";
+import "@prisma-next/contract/framework-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-CjV_jD8f.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"framework-components-CjV_jD8f.mjs","names":[],"sources":["../src/utils/framework-components.ts"],"sourcesContent":["import {\n  checkContractComponentRequirements,\n  type TargetBoundComponentDescriptor,\n} from '@prisma-next/contract/framework-components';\nimport type { ContractIR } from '@prisma-next/contract/ir';\nimport type { ControlPlaneStack } from '@prisma-next/core-control-plane/types';\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 IR 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 contractIR = await loadContractJson(config.contract.output);\n * const stack = createControlPlaneStack({ target: config.target, adapter: config.adapter, ... });\n *\n * // Throws if contract is incompatible with config\n * assertContractRequirementsSatisfied({ contract: contractIR, stack });\n * ```\n */\nexport function assertContractRequirementsSatisfied<\n  TFamilyId extends string,\n  TTargetId extends string,\n>({\n  contract,\n  stack,\n}: {\n  readonly contract: Pick<ContractIR, 'targetFamily' | 'target' | 'extensionPacks'>;\n  readonly stack: ControlPlaneStack<TFamilyId, TTargetId>;\n}): void {\n  const providedComponentIds = new Set<string>([stack.target.id, stack.adapter.id]);\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/migration-command-scaffold-DfY_F3ev.mjs

@@ -0,0 +1,97 @@
+import { t as loadConfig } from "./config-loader-PPf4CtDj.mjs";
+import { _ as errorUnexpected, a as errorDatabaseConnectionRequired, c as errorFileNotFound, h as errorTargetMigrationNotSupported, i as errorContractValidationFailed, s as errorDriverRequired } from "./cli-errors-JlPTsazx.mjs";
+import { t as createControlClient } from "./client-PimzSD1f.mjs";
+import { T as resolveContractPath, w as maskConnectionUrl, y as formatStyledHeader } from "./result-handler-iA9JtUC7.mjs";
+import { t as createProgressAdapter } from "./progress-adapter-DENrzF6I.mjs";
+import { notOk, ok } from "@prisma-next/utils/result";
+import { relative, resolve } from "node:path";
+import { readFile } from "node:fs/promises";
+
+//#region src/utils/migration-command-scaffold.ts
+/**
+* Prepares the shared context for migration commands (db init, db update).
+*
+* Handles: config loading, contract file reading, JSON parsing, connection resolution,
+* driver/migration-support validation, client creation, and header output.
+*
+* Returns a Result with either the resolved context or a structured error.
+*/
+async function prepareMigrationContext(options, flags, descriptor) {
+	const config = await loadConfig(options.config);
+	const configPath = options.config ? relative(process.cwd(), resolve(options.config)) : "prisma-next.config.ts";
+	const contractPathAbsolute = resolveContractPath(config);
+	const contractPath = relative(process.cwd(), contractPathAbsolute);
+	if (flags.json !== "object" && !flags.quiet) {
+		const details = [{
+			label: "config",
+			value: configPath
+		}, {
+			label: "contract",
+			value: contractPath
+		}];
+		if (options.db) details.push({
+			label: "database",
+			value: maskConnectionUrl(options.db)
+		});
+		if (options.plan) details.push({
+			label: "mode",
+			value: "plan (dry run)"
+		});
+		const header = formatStyledHeader({
+			command: descriptor.commandName,
+			description: descriptor.description,
+			url: descriptor.url,
+			details,
+			flags
+		});
+		console.log(header);
+	}
+	let contractJsonContent;
+	try {
+		contractJsonContent = await readFile(contractPathAbsolute, "utf-8");
+	} catch (error) {
+		if (error instanceof Error && error.code === "ENOENT") return notOk(errorFileNotFound(contractPathAbsolute, {
+			why: `Contract file not found at ${contractPathAbsolute}`,
+			fix: `Run \`prisma-next contract emit\` to generate ${contractPath}, or update \`config.contract.output\` in ${configPath}`
+		}));
+		return notOk(errorUnexpected(error instanceof Error ? error.message : String(error), { why: `Failed to read contract file: ${error instanceof Error ? error.message : String(error)}` }));
+	}
+	let contractJson;
+	try {
+		contractJson = JSON.parse(contractJsonContent);
+	} catch (error) {
+		return notOk(errorContractValidationFailed(`Contract JSON is invalid: ${error instanceof Error ? error.message : String(error)}`, { where: { path: contractPathAbsolute } }));
+	}
+	const dbConnection = options.db ?? config.db?.connection;
+	if (!dbConnection) return notOk(errorDatabaseConnectionRequired({ why: `Database connection is required for ${descriptor.commandName} (set db.connection in ${configPath}, or pass --db <url>)` }));
+	if (!config.driver) return notOk(errorDriverRequired({ why: `Config.driver is required for ${descriptor.commandName}` }));
+	if (!config.target.migrations) return notOk(errorTargetMigrationNotSupported({ why: `Target "${config.target.id}" does not support migrations` }));
+	const client = createControlClient({
+		family: config.family,
+		target: config.target,
+		adapter: config.adapter,
+		driver: config.driver,
+		extensionPacks: config.extensionPacks ?? []
+	});
+	const onProgress = createProgressAdapter({ flags });
+	return ok({
+		client,
+		contractJson,
+		dbConnection,
+		onProgress,
+		configPath,
+		contractPath,
+		contractPathAbsolute,
+		config
+	});
+}
+/**
+* Registers the shared CLI options for migration commands (db init, db update).
+*/
+function addMigrationCommandOptions(command) {
+	return command.option("--db <url>", "Database connection string").option("--config <path>", "Path to prisma-next.config.ts").option("--plan", "Preview planned operations without applying", false).option("--json [format]", "Output as JSON (object)", false).option("-q, --quiet", "Quiet mode: errors only").option("-v, --verbose", "Verbose output: debug info, timings").option("-vv, --trace", "Trace output: deep internals, stack traces").option("--timestamps", "Add timestamps to output").option("--color", "Force color output").option("--no-color", "Disable color output");
+}
+
+//#endregion
+export { prepareMigrationContext as n, addMigrationCommandOptions as t };
+//# sourceMappingURL=migration-command-scaffold-DfY_F3ev.mjs.map

package/dist/migration-command-scaffold-DfY_F3ev.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-command-scaffold-DfY_F3ev.mjs","names":["details: Array<{ label: string; value: string }>","contractJsonContent: string","contractJson: Record<string, unknown>"],"sources":["../src/utils/migration-command-scaffold.ts"],"sourcesContent":["import { readFile } from 'node:fs/promises';\nimport { relative, resolve } from 'node:path';\nimport { notOk, ok, type Result } from '@prisma-next/utils/result';\nimport type { Command } from 'commander';\nimport { loadConfig } from '../config-loader';\nimport { createControlClient } from '../control-api/client';\nimport type { ControlClient } from '../control-api/types';\nimport {\n  type CliStructuredError,\n  errorContractValidationFailed,\n  errorDatabaseConnectionRequired,\n  errorDriverRequired,\n  errorFileNotFound,\n  errorTargetMigrationNotSupported,\n  errorUnexpected,\n} from './cli-errors';\nimport { maskConnectionUrl, resolveContractPath } from './command-helpers';\nimport type { GlobalFlags } from './global-flags';\nimport { formatStyledHeader } from './output';\nimport { createProgressAdapter } from './progress-adapter';\n\n/**\n * Resolved context for a migration command.\n * Contains everything needed to invoke a control-api operation.\n */\nexport interface MigrationContext {\n  readonly client: ControlClient;\n  readonly contractJson: Record<string, unknown>;\n  readonly dbConnection: unknown;\n  readonly onProgress: ReturnType<typeof createProgressAdapter>;\n  readonly configPath: string;\n  readonly contractPath: string;\n  readonly contractPathAbsolute: string;\n  readonly config: Awaited<ReturnType<typeof loadConfig>>;\n}\n\n/**\n * Command-specific configuration for the shared scaffold.\n */\nexport interface MigrationCommandDescriptor {\n  readonly commandName: string;\n  readonly description: string;\n  readonly url: string;\n}\n\n/**\n * Prepares the shared context for migration commands (db init, db update).\n *\n * Handles: config loading, contract file reading, JSON parsing, connection resolution,\n * driver/migration-support validation, client creation, and header output.\n *\n * Returns a Result with either the resolved context or a structured error.\n */\nexport async function prepareMigrationContext(\n  options: { readonly db?: string; readonly config?: string; readonly plan?: boolean },\n  flags: GlobalFlags,\n  descriptor: MigrationCommandDescriptor,\n): Promise<Result<MigrationContext, 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 = resolveContractPath(config);\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: maskConnectionUrl(options.db) });\n    }\n    if (options.plan) {\n      details.push({ label: 'mode', value: 'plan (dry run)' });\n    }\n    const header = formatStyledHeader({\n      command: descriptor.commandName,\n      description: descriptor.description,\n      url: descriptor.url,\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  // Parse contract JSON\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 ${descriptor.commandName} (set db.connection in ${configPath}, or pass --db <url>)`,\n      }),\n    );\n  }\n\n  // Check for driver\n  if (!config.driver) {\n    return notOk(\n      errorDriverRequired({ why: `Config.driver is required for ${descriptor.commandName}` }),\n    );\n  }\n\n  // Check target supports migrations via optional descriptor capability\n  const targetWithMigrations = config.target as typeof config.target & {\n    readonly migrations?: unknown;\n  };\n  if (!targetWithMigrations.migrations) {\n    return notOk(\n      errorTargetMigrationNotSupported({\n        why: `Target \"${config.target.id}\" does not support migrations`,\n      }),\n    );\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  return ok({\n    client,\n    contractJson,\n    dbConnection,\n    onProgress,\n    configPath,\n    contractPath,\n    contractPathAbsolute,\n    config,\n  });\n}\n\n/**\n * Registers the shared CLI options for migration commands (db init, db update).\n */\nexport function addMigrationCommandOptions(command: Command): Command {\n  return command\n    .option('--db <url>', 'Database connection string')\n    .option('--config <path>', 'Path to prisma-next.config.ts')\n    .option('--plan', 'Preview planned operations without applying', false)\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}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAqDA,eAAsB,wBACpB,SACA,OACA,YACuD;CAEvD,MAAM,SAAS,MAAM,WAAW,QAAQ,OAAO;CAC/C,MAAM,aAAa,QAAQ,SACvB,SAAS,QAAQ,KAAK,EAAE,QAAQ,QAAQ,OAAO,CAAC,GAChD;CACJ,MAAM,uBAAuB,oBAAoB,OAAO;CACxD,MAAM,eAAe,SAAS,QAAQ,KAAK,EAAE,qBAAqB;AAGlE,KAAI,MAAM,SAAS,YAAY,CAAC,MAAM,OAAO;EAC3C,MAAMA,UAAmD,CACvD;GAAE,OAAO;GAAU,OAAO;GAAY,EACtC;GAAE,OAAO;GAAY,OAAO;GAAc,CAC3C;AACD,MAAI,QAAQ,GACV,SAAQ,KAAK;GAAE,OAAO;GAAY,OAAO,kBAAkB,QAAQ,GAAG;GAAE,CAAC;AAE3E,MAAI,QAAQ,KACV,SAAQ,KAAK;GAAE,OAAO;GAAQ,OAAO;GAAkB,CAAC;EAE1D,MAAM,SAAS,mBAAmB;GAChC,SAAS,WAAW;GACpB,aAAa,WAAW;GACxB,KAAK,WAAW;GAChB;GACA;GACD,CAAC;AACF,UAAQ,IAAI,OAAO;;CAIrB,IAAIC;AACJ,KAAI;AACF,wBAAsB,MAAM,SAAS,sBAAsB,QAAQ;UAC5D,OAAO;AACd,MAAI,iBAAiB,SAAU,MAA4B,SAAS,SAClE,QAAO,MACL,kBAAkB,sBAAsB;GACtC,KAAK,8BAA8B;GACnC,KAAK,iDAAiD,aAAa,4CAA4C;GAChH,CAAC,CACH;AAEH,SAAO,MACL,gBAAgB,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,EAAE,EACtE,KAAK,iCAAiC,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,IAC7F,CAAC,CACH;;CAIH,IAAIC;AACJ,KAAI;AACF,iBAAe,KAAK,MAAM,oBAAoB;UACvC,OAAO;AACd,SAAO,MACL,8BACE,6BAA6B,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,IACnF,EAAE,OAAO,EAAE,MAAM,sBAAsB,EAAE,CAC1C,CACF;;CAIH,MAAM,eAAe,QAAQ,MAAM,OAAO,IAAI;AAC9C,KAAI,CAAC,aACH,QAAO,MACL,gCAAgC,EAC9B,KAAK,uCAAuC,WAAW,YAAY,yBAAyB,WAAW,wBACxG,CAAC,CACH;AAIH,KAAI,CAAC,OAAO,OACV,QAAO,MACL,oBAAoB,EAAE,KAAK,iCAAiC,WAAW,eAAe,CAAC,CACxF;AAOH,KAAI,CAHyB,OAAO,OAGV,WACxB,QAAO,MACL,iCAAiC,EAC/B,KAAK,WAAW,OAAO,OAAO,GAAG,gCAClC,CAAC,CACH;CAIH,MAAM,SAAS,oBAAoB;EACjC,QAAQ,OAAO;EACf,QAAQ,OAAO;EACf,SAAS,OAAO;EAChB,QAAQ,OAAO;EACf,gBAAgB,OAAO,kBAAkB,EAAE;EAC5C,CAAC;CAGF,MAAM,aAAa,sBAAsB,EAAE,OAAO,CAAC;AAEnD,QAAO,GAAG;EACR;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACD,CAAC;;;;;AAMJ,SAAgB,2BAA2B,SAA2B;AACpE,QAAO,QACJ,OAAO,cAAc,6BAA6B,CAClD,OAAO,mBAAmB,gCAAgC,CAC1D,OAAO,UAAU,+CAA+C,MAAM,CACtE,OAAO,mBAAmB,2BAA2B,MAAM,CAC3D,OAAO,eAAe,0BAA0B,CAChD,OAAO,iBAAiB,sCAAsC,CAC9D,OAAO,gBAAgB,6CAA6C,CACpE,OAAO,gBAAgB,2BAA2B,CAClD,OAAO,WAAW,qBAAqB,CACvC,OAAO,cAAc,uBAAuB"}

package/dist/progress-adapter-DENrzF6I.mjs

@@ -0,0 +1,49 @@
+import ora from "ora";
+
+//#region src/utils/progress-adapter.ts
+/**
+* Creates a progress adapter that converts control-api progress events
+* into CLI spinner/progress output.
+*
+* The adapter:
+* - Starts/succeeds spinners for top-level span boundaries
+* - Prints per-operation lines for nested spans (e.g., migration operations under 'apply')
+* - Respects quiet/json/non-TTY flags (no-op in those cases)
+*
+* @param options - Progress adapter configuration
+* @returns An onProgress callback compatible with control-api operations
+*/
+function createProgressAdapter(options) {
+	const { flags } = options;
+	if (!(!flags.quiet && flags.json !== "object" && process.stdout.isTTY)) return () => {};
+	const activeSpans = /* @__PURE__ */ new Map();
+	return (event) => {
+		if (event.kind === "spanStart") {
+			if (event.parentSpanId) {
+				console.log(`  → ${event.label}...`);
+				return;
+			}
+			const spinner = ora({
+				text: event.label,
+				color: flags.color !== false ? "cyan" : false
+			}).start();
+			activeSpans.set(event.spanId, {
+				spinner,
+				startTime: Date.now()
+			});
+		} else if (event.kind === "spanEnd") {
+			const spanState = activeSpans.get(event.spanId);
+			if (spanState) {
+				const elapsed = Date.now() - spanState.startTime;
+				if (event.outcome === "error") spanState.spinner.fail(`${spanState.spinner.text} (failed)`);
+				else if (event.outcome === "skipped") spanState.spinner.info(`${spanState.spinner.text} (skipped)`);
+				else spanState.spinner.succeed(`${spanState.spinner.text} (${elapsed}ms)`);
+				activeSpans.delete(event.spanId);
+			}
+		}
+	};
+}
+
+//#endregion
+export { createProgressAdapter as t };
+//# sourceMappingURL=progress-adapter-DENrzF6I.mjs.map

package/dist/progress-adapter-DENrzF6I.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-adapter-DENrzF6I.mjs","names":[],"sources":["../src/utils/progress-adapter.ts"],"sourcesContent":["import ora from 'ora';\nimport type { ControlProgressEvent, OnControlProgress } from '../control-api/types';\nimport type { GlobalFlags } from './global-flags';\n\n/**\n * Options for creating a progress adapter.\n */\ninterface ProgressAdapterOptions {\n  /**\n   * Global flags that control progress output behavior (quiet, json, color).\n   */\n  readonly flags: GlobalFlags;\n}\n\n/**\n * State for tracking active spans in the progress adapter.\n */\ninterface SpanState {\n  readonly spinner: ReturnType<typeof ora>;\n  readonly startTime: number;\n}\n\n/**\n * Creates a progress adapter that converts control-api progress events\n * into CLI spinner/progress output.\n *\n * The adapter:\n * - Starts/succeeds spinners for top-level span boundaries\n * - Prints per-operation lines for nested spans (e.g., migration operations under 'apply')\n * - Respects quiet/json/non-TTY flags (no-op in those cases)\n *\n * @param options - Progress adapter configuration\n * @returns An onProgress callback compatible with control-api operations\n */\nexport function createProgressAdapter(options: ProgressAdapterOptions): OnControlProgress {\n  const { flags } = options;\n\n  // Skip progress if quiet, JSON output, or non-TTY\n  const shouldShowProgress = !flags.quiet && flags.json !== 'object' && process.stdout.isTTY;\n\n  if (!shouldShowProgress) {\n    // Return a no-op callback\n    return () => {\n      // No-op\n    };\n  }\n\n  // Track active spans by spanId\n  const activeSpans = new Map<string, SpanState>();\n\n  return (event: ControlProgressEvent) => {\n    if (event.kind === 'spanStart') {\n      // Nested spans (with parentSpanId) are printed as lines, not spinners\n      if (event.parentSpanId) {\n        console.log(`  → ${event.label}...`);\n        return;\n      }\n\n      // Top-level spans get a spinner\n      const spinner = ora({\n        text: event.label,\n        color: flags.color !== false ? 'cyan' : false,\n      }).start();\n\n      activeSpans.set(event.spanId, {\n        spinner,\n        startTime: Date.now(),\n      });\n    } else if (event.kind === 'spanEnd') {\n      // Complete the spinner for this span (only top-level spans have spinners)\n      const spanState = activeSpans.get(event.spanId);\n      if (spanState) {\n        const elapsed = Date.now() - spanState.startTime;\n        if (event.outcome === 'error') {\n          spanState.spinner.fail(`${spanState.spinner.text} (failed)`);\n        } else if (event.outcome === 'skipped') {\n          spanState.spinner.info(`${spanState.spinner.text} (skipped)`);\n        } else {\n          spanState.spinner.succeed(`${spanState.spinner.text} (${elapsed}ms)`);\n        }\n        activeSpans.delete(event.spanId);\n      }\n      // Nested span ends are no-ops (could log completion if needed)\n    }\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;AAkCA,SAAgB,sBAAsB,SAAoD;CACxF,MAAM,EAAE,UAAU;AAKlB,KAAI,EAFuB,CAAC,MAAM,SAAS,MAAM,SAAS,YAAY,QAAQ,OAAO,OAInF,cAAa;CAMf,MAAM,8BAAc,IAAI,KAAwB;AAEhD,SAAQ,UAAgC;AACtC,MAAI,MAAM,SAAS,aAAa;AAE9B,OAAI,MAAM,cAAc;AACtB,YAAQ,IAAI,OAAO,MAAM,MAAM,KAAK;AACpC;;GAIF,MAAM,UAAU,IAAI;IAClB,MAAM,MAAM;IACZ,OAAO,MAAM,UAAU,QAAQ,SAAS;IACzC,CAAC,CAAC,OAAO;AAEV,eAAY,IAAI,MAAM,QAAQ;IAC5B;IACA,WAAW,KAAK,KAAK;IACtB,CAAC;aACO,MAAM,SAAS,WAAW;GAEnC,MAAM,YAAY,YAAY,IAAI,MAAM,OAAO;AAC/C,OAAI,WAAW;IACb,MAAM,UAAU,KAAK,KAAK,GAAG,UAAU;AACvC,QAAI,MAAM,YAAY,QACpB,WAAU,QAAQ,KAAK,GAAG,UAAU,QAAQ,KAAK,WAAW;aACnD,MAAM,YAAY,UAC3B,WAAU,QAAQ,KAAK,GAAG,UAAU,QAAQ,KAAK,YAAY;QAE7D,WAAU,QAAQ,QAAQ,GAAG,UAAU,QAAQ,KAAK,IAAI,QAAQ,KAAK;AAEvE,gBAAY,OAAO,MAAM,OAAO"}