@prisma-next/core-control-plane 0.3.0-dev.5 → 0.3.0-dev.51

package/dist/emission.mjs

@@ -0,0 +1,315 @@
+import { type } from "arktype";
+import { bigintJsonReplacer } from "@prisma-next/contract/types";
+import { isArrayEqual } from "@prisma-next/utils/array-equal";
+import { ifDefined } from "@prisma-next/utils/defined";
+import { format } from "prettier";
+import { createHash } from "node:crypto";
+
+//#region src/emission/canonicalization.ts
+const TOP_LEVEL_ORDER = [
+	"schemaVersion",
+	"canonicalVersion",
+	"targetFamily",
+	"target",
+	"storageHash",
+	"executionHash",
+	"profileHash",
+	"models",
+	"relations",
+	"storage",
+	"execution",
+	"capabilities",
+	"extensionPacks",
+	"meta"
+];
+function isDefaultValue(value) {
+	if (value === false) return true;
+	if (value === null) return false;
+	if (value instanceof Date) return false;
+	if (Array.isArray(value) && value.length === 0) return true;
+	if (typeof value === "object" && value !== null) return Object.keys(value).length === 0;
+	return false;
+}
+function omitDefaults(obj, path) {
+	if (obj === null || typeof obj !== "object") return obj;
+	if (obj instanceof Date) return obj;
+	if (Array.isArray(obj)) return obj.map((item) => omitDefaults(item, path));
+	const result = {};
+	for (const [key, value] of Object.entries(obj)) {
+		const currentPath = [...path, key];
+		if (key === "_generated") continue;
+		if (key === "nullable" && value === false) continue;
+		if (key === "generated" && value === false) continue;
+		if ((key === "onDelete" || key === "onUpdate") && value === "noAction") continue;
+		if (isDefaultValue(value)) {
+			const isRequiredModels = isArrayEqual(currentPath, ["models"]);
+			const isRequiredTables = isArrayEqual(currentPath, ["storage", "tables"]);
+			const isRequiredRelations = isArrayEqual(currentPath, ["relations"]);
+			const isRequiredExtensionPacks = isArrayEqual(currentPath, ["extensionPacks"]);
+			const isRequiredCapabilities = isArrayEqual(currentPath, ["capabilities"]);
+			const isRequiredMeta = isArrayEqual(currentPath, ["meta"]);
+			const isRequiredExecutionDefaults = isArrayEqual(currentPath, [
+				"execution",
+				"mutations",
+				"defaults"
+			]);
+			const isExtensionNamespace = currentPath.length === 2 && currentPath[0] === "extensionPacks";
+			const isModelRelations = currentPath.length === 3 && isArrayEqual([currentPath[0], currentPath[2]], ["models", "relations"]);
+			const isTableUniques = currentPath.length === 4 && isArrayEqual([
+				currentPath[0],
+				currentPath[1],
+				currentPath[3]
+			], [
+				"storage",
+				"tables",
+				"uniques"
+			]);
+			const isTableIndexes = currentPath.length === 4 && isArrayEqual([
+				currentPath[0],
+				currentPath[1],
+				currentPath[3]
+			], [
+				"storage",
+				"tables",
+				"indexes"
+			]);
+			const isTableForeignKeys = currentPath.length === 4 && isArrayEqual([
+				currentPath[0],
+				currentPath[1],
+				currentPath[3]
+			], [
+				"storage",
+				"tables",
+				"foreignKeys"
+			]);
+			const isFkBooleanField = currentPath.length === 5 && currentPath[0] === "storage" && currentPath[1] === "tables" && currentPath[3] === "foreignKeys" && (key === "constraint" || key === "index");
+			if (!isRequiredModels && !isRequiredTables && !isRequiredRelations && !isRequiredExtensionPacks && !isRequiredCapabilities && !isRequiredMeta && !isRequiredExecutionDefaults && !isExtensionNamespace && !isModelRelations && !isTableUniques && !isTableIndexes && !isTableForeignKeys && !isFkBooleanField) continue;
+		}
+		result[key] = omitDefaults(value, currentPath);
+	}
+	return result;
+}
+function sortObjectKeys(obj) {
+	if (obj === null || typeof obj !== "object") return obj;
+	if (obj instanceof Date) return obj;
+	if (Array.isArray(obj)) return obj.map((item) => sortObjectKeys(item));
+	const sorted = {};
+	const keys = Object.keys(obj).sort();
+	for (const key of keys) sorted[key] = sortObjectKeys(obj[key]);
+	return sorted;
+}
+function sortIndexesAndUniques(storage) {
+	if (!storage || typeof storage !== "object") return storage;
+	const storageObj = storage;
+	if (!storageObj.tables || typeof storageObj.tables !== "object") return storage;
+	const tables = storageObj.tables;
+	const result = { ...storageObj };
+	result.tables = {};
+	const sortedTableNames = Object.keys(tables).sort();
+	for (const tableName of sortedTableNames) {
+		const table = tables[tableName];
+		if (!table || typeof table !== "object") {
+			result.tables[tableName] = table;
+			continue;
+		}
+		const tableObj = table;
+		const sortedTable = { ...tableObj };
+		if (Array.isArray(tableObj.indexes)) sortedTable.indexes = [...tableObj.indexes].sort((a, b) => {
+			const nameA = a?.name || "";
+			const nameB = b?.name || "";
+			return nameA.localeCompare(nameB);
+		});
+		if (Array.isArray(tableObj.uniques)) sortedTable.uniques = [...tableObj.uniques].sort((a, b) => {
+			const nameA = a?.name || "";
+			const nameB = b?.name || "";
+			return nameA.localeCompare(nameB);
+		});
+		result.tables[tableName] = sortedTable;
+	}
+	return result;
+}
+function orderTopLevel(obj) {
+	const ordered = {};
+	const remaining = new Set(Object.keys(obj));
+	for (const key of TOP_LEVEL_ORDER) if (remaining.has(key)) {
+		ordered[key] = obj[key];
+		remaining.delete(key);
+	}
+	for (const key of Array.from(remaining).sort()) ordered[key] = obj[key];
+	return ordered;
+}
+function canonicalizeContract(ir) {
+	const normalized = {
+		schemaVersion: ir.schemaVersion,
+		targetFamily: ir.targetFamily,
+		target: ir.target,
+		models: ir.models,
+		relations: ir.relations,
+		storage: ir.storage,
+		...ifDefined("execution", ir.execution),
+		extensionPacks: ir.extensionPacks,
+		capabilities: ir.capabilities,
+		meta: ir.meta
+	};
+	Object.assign(normalized, ifDefined("storageHash", ir.storageHash), ifDefined("executionHash", ir.executionHash), ifDefined("profileHash", ir.profileHash));
+	const withDefaultsOmitted = omitDefaults(normalized, []);
+	const withSortedIndexes = sortIndexesAndUniques(withDefaultsOmitted.storage);
+	const withOrderedTopLevel = orderTopLevel(sortObjectKeys({
+		...withDefaultsOmitted,
+		storage: withSortedIndexes
+	}));
+	return JSON.stringify(withOrderedTopLevel, bigintJsonReplacer, 2);
+}
+
+//#endregion
+//#region src/emission/hashing.ts
+function computeHash(content) {
+	const hash = createHash("sha256");
+	hash.update(content);
+	return `sha256:${hash.digest("hex")}`;
+}
+function computeStorageHash(contract) {
+	return computeHash(canonicalizeContract({
+		schemaVersion: contract.schemaVersion,
+		targetFamily: contract.targetFamily,
+		target: contract.target,
+		storage: contract.storage,
+		models: {},
+		relations: {},
+		extensionPacks: {},
+		capabilities: {},
+		meta: {}
+	}));
+}
+function computeProfileHash(contract) {
+	return computeHash(canonicalizeContract({
+		schemaVersion: contract.schemaVersion,
+		targetFamily: contract.targetFamily,
+		target: contract.target,
+		models: {},
+		relations: {},
+		storage: {},
+		extensionPacks: {},
+		capabilities: contract.capabilities,
+		meta: {}
+	}));
+}
+function computeExecutionHash(contract) {
+	return computeHash(canonicalizeContract({
+		schemaVersion: contract.schemaVersion,
+		targetFamily: contract.targetFamily,
+		target: contract.target,
+		models: {},
+		relations: {},
+		storage: {},
+		extensionPacks: {},
+		capabilities: {},
+		meta: {},
+		...ifDefined("execution", contract.execution)
+	}));
+}
+
+//#endregion
+//#region src/emission/emit.ts
+const CanonicalMetaSchema = type({ "[string]": "unknown" });
+const CanonicalContractSchema = type({
+	"+": "reject",
+	schemaVersion: "string",
+	targetFamily: "string",
+	target: "string",
+	models: type({ "[string]": "unknown" }),
+	relations: type({ "[string]": "unknown" }),
+	storage: type({ "[string]": "unknown" }),
+	"execution?": type({ "[string]": "unknown" }),
+	extensionPacks: type({ "[string]": "unknown" }),
+	capabilities: type({ "[string]": type({ "[string]": "boolean" }) }),
+	meta: CanonicalMetaSchema
+});
+function assertCanonicalArtifactShape(value) {
+	const result = CanonicalContractSchema(value);
+	if (result instanceof type.errors) {
+		const issues = result.map((error) => {
+			return `${error.path?.toString() ?? "<root>"}: ${error.message}`;
+		}).join("; ");
+		throw new Error(`ContractIR canonical artifact validation failed: ${issues}`);
+	}
+}
+function validateCoreStructure(ir) {
+	if (!ir.targetFamily) throw new Error("ContractIR must have targetFamily");
+	if (!ir.target) throw new Error("ContractIR must have target");
+	if (!ir.schemaVersion) throw new Error("ContractIR must have schemaVersion");
+	if (!ir.models || typeof ir.models !== "object") throw new Error("ContractIR must have models");
+	if (!ir.storage || typeof ir.storage !== "object") throw new Error("ContractIR must have storage");
+	if (!ir.relations || typeof ir.relations !== "object") throw new Error("ContractIR must have relations");
+	if (!ir.extensionPacks || typeof ir.extensionPacks !== "object") throw new Error("ContractIR must have extensionPacks");
+	if (!ir.capabilities || typeof ir.capabilities !== "object") throw new Error("ContractIR must have capabilities");
+	if (!ir.meta || typeof ir.meta !== "object") throw new Error("ContractIR must have meta");
+}
+async function emit(ir, options, targetFamily) {
+	const { operationRegistry, codecTypeImports, operationTypeImports, extensionIds, parameterizedRenderers, parameterizedTypeImports } = options;
+	validateCoreStructure(ir);
+	const ctx = {
+		...ifDefined("operationRegistry", operationRegistry),
+		...ifDefined("codecTypeImports", codecTypeImports),
+		...ifDefined("operationTypeImports", operationTypeImports),
+		...ifDefined("extensionIds", extensionIds)
+	};
+	targetFamily.validateTypes(ir, ctx);
+	targetFamily.validateStructure(ir);
+	const canonicalContract = {
+		schemaVersion: ir.schemaVersion,
+		targetFamily: ir.targetFamily,
+		target: ir.target,
+		models: ir.models,
+		relations: ir.relations,
+		storage: ir.storage,
+		...ifDefined("execution", ir.execution),
+		extensionPacks: ir.extensionPacks,
+		capabilities: ir.capabilities,
+		meta: ir.meta
+	};
+	assertCanonicalArtifactShape(canonicalContract);
+	const storageHash = computeStorageHash(canonicalContract);
+	const executionHash = canonicalContract.execution ? computeExecutionHash(canonicalContract) : void 0;
+	const profileHash = computeProfileHash(canonicalContract);
+	const contractWithHashes = {
+		...canonicalContract,
+		storageHash,
+		...ifDefined("executionHash", executionHash),
+		profileHash
+	};
+	const contractJsonWithMeta = {
+		...JSON.parse(canonicalizeContract(contractWithHashes)),
+		_generated: {
+			warning: "⚠️  GENERATED FILE - DO NOT EDIT",
+			message: "This file is automatically generated by \"prisma-next contract emit\".",
+			regenerate: "To regenerate, run: prisma-next contract emit"
+		}
+	};
+	const contractJsonString = JSON.stringify(contractJsonWithMeta, null, 2);
+	const generateOptions = parameterizedRenderers || parameterizedTypeImports ? {
+		...ifDefined("parameterizedRenderers", parameterizedRenderers),
+		...ifDefined("parameterizedTypeImports", parameterizedTypeImports)
+	} : void 0;
+	const contractTypeHashes = {
+		storageHash,
+		...ifDefined("executionHash", executionHash),
+		profileHash
+	};
+	return {
+		contractJson: contractJsonString,
+		contractDts: await format(targetFamily.generateContractTypes(ir, codecTypeImports ?? [], operationTypeImports ?? [], contractTypeHashes, generateOptions), {
+			parser: "typescript",
+			singleQuote: true,
+			semi: true,
+			printWidth: 100
+		}),
+		storageHash,
+		...ifDefined("executionHash", executionHash),
+		profileHash
+	};
+}
+
+//#endregion
+export { canonicalizeContract, computeExecutionHash, computeProfileHash, computeStorageHash, emit };
+//# sourceMappingURL=emission.mjs.map

package/dist/emission.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"emission.mjs","names":["result: Record<string, unknown>","sorted: Record<string, unknown>","result: StorageObject","sortedTable: TableObject","ordered: Record<string, unknown>","normalized: NormalizedContract","ctx: ValidationContext"],"sources":["../src/emission/canonicalization.ts","../src/emission/hashing.ts","../src/emission/emit.ts"],"sourcesContent":["import { bigintJsonReplacer } from '@prisma-next/contract/types';\nimport { isArrayEqual } from '@prisma-next/utils/array-equal';\nimport { ifDefined } from '@prisma-next/utils/defined';\n\ntype NormalizedContract = {\n  schemaVersion: string;\n  targetFamily: string;\n  target: string;\n  storageHash?: string;\n  executionHash?: string;\n  profileHash?: string;\n  models: Record<string, unknown>;\n  relations: Record<string, unknown>;\n  storage: Record<string, unknown>;\n  execution?: Record<string, unknown>;\n  extensionPacks: Record<string, unknown>;\n  capabilities: Record<string, Record<string, boolean>>;\n  meta: Record<string, unknown>;\n};\n\nexport type CanonicalContractInput = {\n  schemaVersion: string;\n  targetFamily: string;\n  target: string;\n  models: Record<string, unknown>;\n  relations: Record<string, unknown>;\n  storage: Record<string, unknown>;\n  execution?: Record<string, unknown>;\n  extensionPacks: Record<string, unknown>;\n  capabilities: Record<string, Record<string, boolean>>;\n  meta: Record<string, unknown>;\n  storageHash?: string;\n  executionHash?: string;\n  profileHash?: string;\n};\n\nconst TOP_LEVEL_ORDER = [\n  'schemaVersion',\n  'canonicalVersion',\n  'targetFamily',\n  'target',\n  'storageHash',\n  'executionHash',\n  'profileHash',\n  'models',\n  'relations',\n  'storage',\n  'execution',\n  'capabilities',\n  'extensionPacks',\n  'meta',\n] as const;\n\nfunction isDefaultValue(value: unknown): boolean {\n  if (value === false) return true;\n  if (value === null) return false;\n  if (value instanceof Date) return false;\n  if (Array.isArray(value) && value.length === 0) return true;\n  if (typeof value === 'object' && value !== null) {\n    const keys = Object.keys(value);\n    return keys.length === 0;\n  }\n  return false;\n}\n\nfunction omitDefaults(obj: unknown, path: readonly string[]): unknown {\n  if (obj === null || typeof obj !== 'object') {\n    return obj;\n  }\n\n  if (obj instanceof Date) {\n    return obj;\n  }\n\n  if (Array.isArray(obj)) {\n    return obj.map((item) => omitDefaults(item, path));\n  }\n\n  const result: Record<string, unknown> = {};\n\n  for (const [key, value] of Object.entries(obj)) {\n    const currentPath = [...path, key];\n\n    // Exclude metadata fields from canonicalization\n    if (key === '_generated') {\n      continue;\n    }\n\n    if (key === 'nullable' && value === false) {\n      continue;\n    }\n\n    if (key === 'generated' && value === false) {\n      continue;\n    }\n\n    // Strip 'noAction' referential actions (the database default) for hash stability.\n    // A contract with explicit `onDelete: 'noAction'` is semantically identical to\n    // one that omits `onDelete` entirely, so they should produce the same hash.\n    if ((key === 'onDelete' || key === 'onUpdate') && value === 'noAction') {\n      continue;\n    }\n\n    if (isDefaultValue(value)) {\n      const isRequiredModels = isArrayEqual(currentPath, ['models']);\n      const isRequiredTables = isArrayEqual(currentPath, ['storage', 'tables']);\n      const isRequiredRelations = isArrayEqual(currentPath, ['relations']);\n      const isRequiredExtensionPacks = isArrayEqual(currentPath, ['extensionPacks']);\n      const isRequiredCapabilities = isArrayEqual(currentPath, ['capabilities']);\n      const isRequiredMeta = isArrayEqual(currentPath, ['meta']);\n      const isRequiredExecutionDefaults = isArrayEqual(currentPath, [\n        'execution',\n        'mutations',\n        'defaults',\n      ]);\n      const isExtensionNamespace = currentPath.length === 2 && currentPath[0] === 'extensionPacks';\n      const isModelRelations =\n        currentPath.length === 3 &&\n        isArrayEqual([currentPath[0], currentPath[2]], ['models', 'relations']);\n      const isTableUniques =\n        currentPath.length === 4 &&\n        isArrayEqual(\n          [currentPath[0], currentPath[1], currentPath[3]],\n          ['storage', 'tables', 'uniques'],\n        );\n      const isTableIndexes =\n        currentPath.length === 4 &&\n        isArrayEqual(\n          [currentPath[0], currentPath[1], currentPath[3]],\n          ['storage', 'tables', 'indexes'],\n        );\n      const isTableForeignKeys =\n        currentPath.length === 4 &&\n        isArrayEqual(\n          [currentPath[0], currentPath[1], currentPath[3]],\n          ['storage', 'tables', 'foreignKeys'],\n        );\n\n      // Preserve per-FK `constraint` and `index` booleans (even when `false`)\n      // so that hash distinguishes `false` from absent.\n      // Path: ['storage', 'tables', <tableName>, 'foreignKeys', 'constraint' | 'index']\n      const isFkBooleanField =\n        currentPath.length === 5 &&\n        currentPath[0] === 'storage' &&\n        currentPath[1] === 'tables' &&\n        currentPath[3] === 'foreignKeys' &&\n        (key === 'constraint' || key === 'index');\n\n      if (\n        !isRequiredModels &&\n        !isRequiredTables &&\n        !isRequiredRelations &&\n        !isRequiredExtensionPacks &&\n        !isRequiredCapabilities &&\n        !isRequiredMeta &&\n        !isRequiredExecutionDefaults &&\n        !isExtensionNamespace &&\n        !isModelRelations &&\n        !isTableUniques &&\n        !isTableIndexes &&\n        !isTableForeignKeys &&\n        !isFkBooleanField\n      ) {\n        continue;\n      }\n    }\n\n    result[key] = omitDefaults(value, currentPath);\n  }\n\n  return result;\n}\n\nfunction sortObjectKeys(obj: unknown): unknown {\n  if (obj === null || typeof obj !== 'object') {\n    return obj;\n  }\n\n  if (obj instanceof Date) {\n    return obj;\n  }\n\n  if (Array.isArray(obj)) {\n    return obj.map((item) => sortObjectKeys(item));\n  }\n\n  const sorted: Record<string, unknown> = {};\n  const keys = Object.keys(obj).sort();\n  for (const key of keys) {\n    sorted[key] = sortObjectKeys((obj as Record<string, unknown>)[key]);\n  }\n\n  return sorted;\n}\n\ntype StorageObject = {\n  tables?: Record<string, unknown>;\n  [key: string]: unknown;\n};\n\ntype TableObject = {\n  indexes?: unknown[];\n  uniques?: unknown[];\n  [key: string]: unknown;\n};\n\nfunction sortIndexesAndUniques(storage: unknown): unknown {\n  if (!storage || typeof storage !== 'object') {\n    return storage;\n  }\n\n  const storageObj = storage as StorageObject;\n  if (!storageObj.tables || typeof storageObj.tables !== 'object') {\n    return storage;\n  }\n\n  const tables = storageObj.tables;\n  const result: StorageObject = { ...storageObj };\n\n  result.tables = {};\n  // Sort table names to ensure deterministic ordering\n  const sortedTableNames = Object.keys(tables).sort();\n  for (const tableName of sortedTableNames) {\n    const table = tables[tableName];\n    if (!table || typeof table !== 'object') {\n      result.tables[tableName] = table;\n      continue;\n    }\n\n    const tableObj = table as TableObject;\n    const sortedTable: TableObject = { ...tableObj };\n\n    if (Array.isArray(tableObj.indexes)) {\n      sortedTable.indexes = [...tableObj.indexes].sort((a, b) => {\n        const nameA = (a as { name?: string })?.name || '';\n        const nameB = (b as { name?: string })?.name || '';\n        return nameA.localeCompare(nameB);\n      });\n    }\n\n    if (Array.isArray(tableObj.uniques)) {\n      sortedTable.uniques = [...tableObj.uniques].sort((a, b) => {\n        const nameA = (a as { name?: string })?.name || '';\n        const nameB = (b as { name?: string })?.name || '';\n        return nameA.localeCompare(nameB);\n      });\n    }\n\n    result.tables[tableName] = sortedTable;\n  }\n\n  return result;\n}\n\nfunction orderTopLevel(obj: Record<string, unknown>): Record<string, unknown> {\n  const ordered: Record<string, unknown> = {};\n  const remaining = new Set(Object.keys(obj));\n\n  for (const key of TOP_LEVEL_ORDER) {\n    if (remaining.has(key)) {\n      ordered[key] = obj[key];\n      remaining.delete(key);\n    }\n  }\n\n  for (const key of Array.from(remaining).sort()) {\n    ordered[key] = obj[key];\n  }\n\n  return ordered;\n}\n\nexport function canonicalizeContract(ir: CanonicalContractInput): string {\n  const normalized: NormalizedContract = {\n    schemaVersion: ir.schemaVersion,\n    targetFamily: ir.targetFamily,\n    target: ir.target,\n    models: ir.models,\n    relations: ir.relations,\n    storage: ir.storage,\n    ...ifDefined('execution', ir.execution),\n    extensionPacks: ir.extensionPacks,\n    capabilities: ir.capabilities,\n    meta: ir.meta,\n  };\n  Object.assign(\n    normalized,\n    ifDefined('storageHash', ir.storageHash),\n    ifDefined('executionHash', ir.executionHash),\n    ifDefined('profileHash', ir.profileHash),\n  );\n\n  const withDefaultsOmitted = omitDefaults(normalized, []) as NormalizedContract;\n  const withSortedIndexes = sortIndexesAndUniques(withDefaultsOmitted.storage);\n  const withSortedStorage = { ...withDefaultsOmitted, storage: withSortedIndexes };\n  const withSortedKeys = sortObjectKeys(withSortedStorage) as Record<string, unknown>;\n  const withOrderedTopLevel = orderTopLevel(withSortedKeys);\n\n  return JSON.stringify(withOrderedTopLevel, bigintJsonReplacer, 2);\n}\n","import { createHash } from 'node:crypto';\nimport { ifDefined } from '@prisma-next/utils/defined';\nimport type { CanonicalContractInput } from './canonicalization';\nimport { canonicalizeContract } from './canonicalization';\n\nfunction computeHash(content: string): string {\n  const hash = createHash('sha256');\n  hash.update(content);\n  return `sha256:${hash.digest('hex')}`;\n}\n\nexport function computeStorageHash(contract: CanonicalContractInput): string {\n  const storageContract = {\n    schemaVersion: contract.schemaVersion,\n    targetFamily: contract.targetFamily,\n    target: contract.target,\n    storage: contract.storage,\n    models: {},\n    relations: {},\n    extensionPacks: {},\n    capabilities: {},\n    meta: {},\n  };\n  const canonical = canonicalizeContract(storageContract);\n  return computeHash(canonical);\n}\n\nexport function computeProfileHash(contract: CanonicalContractInput): string {\n  const profileContract = {\n    schemaVersion: contract.schemaVersion,\n    targetFamily: contract.targetFamily,\n    target: contract.target,\n    models: {},\n    relations: {},\n    storage: {},\n    extensionPacks: {},\n    capabilities: contract.capabilities,\n    meta: {},\n  };\n  const canonical = canonicalizeContract(profileContract);\n  return computeHash(canonical);\n}\n\nexport function computeExecutionHash(contract: CanonicalContractInput): string {\n  const executionContract = {\n    schemaVersion: contract.schemaVersion,\n    targetFamily: contract.targetFamily,\n    target: contract.target,\n    models: {},\n    relations: {},\n    storage: {},\n    extensionPacks: {},\n    capabilities: {},\n    meta: {},\n    ...ifDefined('execution', contract.execution),\n  };\n  const canonical = canonicalizeContract(executionContract);\n  return computeHash(canonical);\n}\n","import type { ContractIR } from '@prisma-next/contract/ir';\nimport type { TargetFamilyHook, ValidationContext } from '@prisma-next/contract/types';\nimport { ifDefined } from '@prisma-next/utils/defined';\nimport { type } from 'arktype';\nimport { format } from 'prettier';\nimport { canonicalizeContract } from './canonicalization';\nimport { computeExecutionHash, computeProfileHash, computeStorageHash } from './hashing';\nimport type { EmitOptions, EmitResult } from './types';\n\nconst CanonicalMetaSchema = type({\n  '[string]': 'unknown',\n});\n\nconst CanonicalContractSchema = type({\n  '+': 'reject',\n  schemaVersion: 'string',\n  targetFamily: 'string',\n  target: 'string',\n  models: type({ '[string]': 'unknown' }),\n  relations: type({ '[string]': 'unknown' }),\n  storage: type({ '[string]': 'unknown' }),\n  'execution?': type({ '[string]': 'unknown' }),\n  extensionPacks: type({ '[string]': 'unknown' }),\n  capabilities: type({\n    '[string]': type({\n      '[string]': 'boolean',\n    }),\n  }),\n  meta: CanonicalMetaSchema,\n});\n\nfunction assertCanonicalArtifactShape(value: unknown): void {\n  const result = CanonicalContractSchema(value);\n  if (result instanceof type.errors) {\n    const issues = result\n      .map((error) => {\n        const path = error.path?.toString() ?? '<root>';\n        return `${path}: ${error.message}`;\n      })\n      .join('; ');\n    throw new Error(`ContractIR canonical artifact validation failed: ${issues}`);\n  }\n}\n\nfunction validateCoreStructure(ir: ContractIR): void {\n  if (!ir.targetFamily) {\n    throw new Error('ContractIR must have targetFamily');\n  }\n  if (!ir.target) {\n    throw new Error('ContractIR must have target');\n  }\n  if (!ir.schemaVersion) {\n    throw new Error('ContractIR must have schemaVersion');\n  }\n  if (!ir.models || typeof ir.models !== 'object') {\n    throw new Error('ContractIR must have models');\n  }\n  if (!ir.storage || typeof ir.storage !== 'object') {\n    throw new Error('ContractIR must have storage');\n  }\n  if (!ir.relations || typeof ir.relations !== 'object') {\n    throw new Error('ContractIR must have relations');\n  }\n  if (!ir.extensionPacks || typeof ir.extensionPacks !== 'object') {\n    throw new Error('ContractIR must have extensionPacks');\n  }\n  if (!ir.capabilities || typeof ir.capabilities !== 'object') {\n    throw new Error('ContractIR must have capabilities');\n  }\n  if (!ir.meta || typeof ir.meta !== 'object') {\n    throw new Error('ContractIR must have meta');\n  }\n}\n\nexport async function emit(\n  ir: ContractIR,\n  options: EmitOptions,\n  targetFamily: TargetFamilyHook,\n): Promise<EmitResult> {\n  const {\n    operationRegistry,\n    codecTypeImports,\n    operationTypeImports,\n    extensionIds,\n    parameterizedRenderers,\n    parameterizedTypeImports,\n  } = options;\n\n  validateCoreStructure(ir);\n\n  const ctx: ValidationContext = {\n    ...ifDefined('operationRegistry', operationRegistry),\n    ...ifDefined('codecTypeImports', codecTypeImports),\n    ...ifDefined('operationTypeImports', operationTypeImports),\n    ...ifDefined('extensionIds', extensionIds),\n  };\n  targetFamily.validateTypes(ir, ctx);\n\n  targetFamily.validateStructure(ir);\n\n  const canonicalContract = {\n    schemaVersion: ir.schemaVersion,\n    targetFamily: ir.targetFamily,\n    target: ir.target,\n    models: ir.models,\n    relations: ir.relations,\n    storage: ir.storage,\n    ...ifDefined('execution', ir.execution),\n    extensionPacks: ir.extensionPacks,\n    capabilities: ir.capabilities,\n    meta: ir.meta,\n  };\n  assertCanonicalArtifactShape(canonicalContract);\n\n  const storageHash = computeStorageHash(canonicalContract);\n  const executionHash = canonicalContract.execution\n    ? computeExecutionHash(canonicalContract)\n    : undefined;\n  const profileHash = computeProfileHash(canonicalContract);\n\n  const contractWithHashes = {\n    ...canonicalContract,\n    storageHash,\n    ...ifDefined('executionHash', executionHash),\n    profileHash,\n  };\n\n  // Add _generated metadata to indicate this is a generated artifact\n  // This ensures consistency between CLI emit and programmatic emit\n  // Always add/update _generated with standard content for consistency\n  const contractJsonObj = JSON.parse(canonicalizeContract(contractWithHashes)) as Record<\n    string,\n    unknown\n  >;\n  const contractJsonWithMeta = {\n    ...contractJsonObj,\n    _generated: {\n      warning: '⚠️  GENERATED FILE - DO NOT EDIT',\n      message: 'This file is automatically generated by \"prisma-next contract emit\".',\n      regenerate: 'To regenerate, run: prisma-next contract emit',\n    },\n  };\n  const contractJsonString = JSON.stringify(contractJsonWithMeta, null, 2);\n\n  const generateOptions =\n    parameterizedRenderers || parameterizedTypeImports\n      ? {\n          ...ifDefined('parameterizedRenderers', parameterizedRenderers),\n          ...ifDefined('parameterizedTypeImports', parameterizedTypeImports),\n        }\n      : undefined;\n\n  const contractTypeHashes = {\n    storageHash,\n    ...ifDefined('executionHash', executionHash),\n    profileHash,\n  };\n  const contractDtsRaw = targetFamily.generateContractTypes(\n    ir,\n    codecTypeImports ?? [],\n    operationTypeImports ?? [],\n    contractTypeHashes,\n    generateOptions,\n  );\n  const contractDts = await format(contractDtsRaw, {\n    parser: 'typescript',\n    singleQuote: true,\n    semi: true,\n    printWidth: 100,\n  });\n\n  return {\n    contractJson: contractJsonString,\n    contractDts,\n    storageHash,\n    ...ifDefined('executionHash', executionHash),\n    profileHash,\n  };\n}\n"],"mappings":"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"}

package/dist/errors-Qlh0sdcb.mjs

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