@prisma-next/core-control-plane 0.3.0-dev.9 → 0.3.0-dev.90

package/dist/emission.mjs

@@ -0,0 +1,315 @@
+import { ifDefined } from "@prisma-next/utils/defined";
+import { bigintJsonReplacer } from "@prisma-next/contract/types";
+import { isArrayEqual } from "@prisma-next/utils/array-equal";
+import { type } from "arktype";
+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.d.mts

@@ -0,0 +1,232 @@
+import { h as SchemaIssue, y as VerifyDatabaseSchemaResult } from "./types-BArIWumw.mjs";
+
+//#region src/errors.d.ts
+
+/**
+ * CLI error envelope for output formatting.
+ * This is the serialized form of a CliStructuredError.
+ */
+interface CliErrorEnvelope {
+  readonly ok: false;
+  readonly code: string;
+  readonly domain: string;
+  readonly severity: 'error' | 'warn' | 'info';
+  readonly summary: string;
+  readonly why: string | undefined;
+  readonly fix: string | undefined;
+  readonly where: {
+    readonly path: string | undefined;
+    readonly line: number | undefined;
+  } | undefined;
+  readonly meta: Record<string, unknown> | undefined;
+  readonly docsUrl: string | undefined;
+}
+/**
+ * Minimal conflict data structure expected by CLI output.
+ */
+interface CliErrorConflict {
+  readonly kind: string;
+  readonly summary: string;
+  readonly why?: string;
+}
+/**
+ * Structured CLI error that contains all information needed for error envelopes.
+ * Call sites throw these errors with full context.
+ */
+declare class CliStructuredError extends Error {
+  readonly code: string;
+  readonly domain: 'CLI' | 'RUN';
+  readonly severity: 'error' | 'warn' | 'info';
+  readonly why: string | undefined;
+  readonly fix: string | undefined;
+  readonly where: {
+    readonly path: string | undefined;
+    readonly line: number | undefined;
+  } | undefined;
+  readonly meta: Record<string, unknown> | undefined;
+  readonly docsUrl: string | undefined;
+  constructor(code: string, summary: string, options?: {
+    readonly domain?: 'CLI' | 'RUN';
+    readonly severity?: 'error' | 'warn' | 'info';
+    readonly why?: string;
+    readonly fix?: string;
+    readonly where?: {
+      readonly path?: string;
+      readonly line?: number;
+    };
+    readonly meta?: Record<string, unknown>;
+    readonly docsUrl?: string;
+  });
+  /**
+   * Converts this error to a CLI error envelope for output formatting.
+   */
+  toEnvelope(): CliErrorEnvelope;
+  /**
+   * Type guard to check if an error is a CliStructuredError.
+   * Uses duck-typing to work across module boundaries where instanceof may fail.
+   */
+  static is(error: unknown): error is CliStructuredError;
+}
+/**
+ * Config file not found or missing.
+ */
+declare function errorConfigFileNotFound(configPath?: string, options?: {
+  readonly why?: string;
+}): CliStructuredError;
+/**
+ * Contract configuration missing from config.
+ */
+declare function errorContractConfigMissing(options?: {
+  readonly why?: string;
+}): CliStructuredError;
+/**
+ * Contract validation failed.
+ */
+declare function errorContractValidationFailed(reason: string, options?: {
+  readonly where?: {
+    readonly path?: string;
+    readonly line?: number;
+  };
+}): CliStructuredError;
+/**
+ * File not found.
+ */
+declare function errorFileNotFound(filePath: string, options?: {
+  readonly why?: string;
+  readonly fix?: string;
+  readonly docsUrl?: string;
+}): CliStructuredError;
+/**
+ * Database connection is required but not provided.
+ */
+declare function errorDatabaseConnectionRequired(options?: {
+  readonly why?: string;
+  readonly commandName?: string;
+  readonly retryCommand?: string;
+}): CliStructuredError;
+/**
+ * Query runner factory is required but not provided in config.
+ */
+declare function errorQueryRunnerFactoryRequired(options?: {
+  readonly why?: string;
+}): CliStructuredError;
+/**
+ * Family verify.readMarker is required but not provided.
+ */
+declare function errorFamilyReadMarkerSqlRequired(options?: {
+  readonly why?: string;
+}): CliStructuredError;
+/**
+ * JSON output format not supported.
+ */
+declare function errorJsonFormatNotSupported(options: {
+  readonly command: string;
+  readonly format: string;
+  readonly supportedFormats: readonly string[];
+}): CliStructuredError;
+/**
+ * Driver is required for DB-connected commands but not provided.
+ */
+declare function errorDriverRequired(options?: {
+  readonly why?: string;
+}): CliStructuredError;
+/**
+ * Contract requires extension packs that are not provided by config descriptors.
+ */
+declare function errorContractMissingExtensionPacks(options: {
+  readonly missingExtensionPacks: readonly string[];
+  readonly providedComponentIds: readonly string[];
+}): CliStructuredError;
+/**
+ * Migration planning failed due to conflicts.
+ */
+declare function errorMigrationPlanningFailed(options: {
+  readonly conflicts: readonly CliErrorConflict[];
+  readonly why?: string;
+}): CliStructuredError;
+/**
+ * Target does not support migrations (missing createPlanner/createRunner).
+ */
+declare function errorTargetMigrationNotSupported(options?: {
+  readonly why?: string;
+}): CliStructuredError;
+/**
+ * Config validation error (missing required fields).
+ */
+declare function errorConfigValidation(field: string, options?: {
+  readonly why?: string;
+}): CliStructuredError;
+/**
+ * Contract marker not found in database.
+ */
+declare function errorMarkerMissing(options?: {
+  readonly why?: string;
+  readonly dbUrl?: string;
+}): CliStructuredError;
+/**
+ * Contract hash does not match database marker.
+ */
+declare function errorHashMismatch(options?: {
+  readonly why?: string;
+  readonly expected?: string;
+  readonly actual?: string;
+}): CliStructuredError;
+/**
+ * Contract target does not match config target.
+ */
+declare function errorTargetMismatch(expected: string, actual: string, options?: {
+  readonly why?: string;
+}): CliStructuredError;
+/**
+ * Database marker is required but not found.
+ * Used by commands that require a pre-existing marker as a precondition.
+ */
+declare function errorMarkerRequired(options?: {
+  readonly why?: string;
+  readonly fix?: string;
+}): CliStructuredError;
+/**
+ * Schema verification found mismatches between the database and the contract.
+ * The full verification tree is preserved in `meta.verificationResult`.
+ */
+declare function errorSchemaVerificationFailed(options: {
+  readonly summary: string;
+  readonly verificationResult: VerifyDatabaseSchemaResult;
+  readonly issues?: readonly SchemaIssue[];
+}): CliStructuredError;
+/**
+ * Migration runner failed during execution.
+ */
+declare function errorRunnerFailed(summary: string, options?: {
+  readonly why?: string;
+  readonly fix?: string;
+  readonly meta?: Record<string, unknown>;
+}): CliStructuredError;
+/** Error code for destructive changes that require explicit confirmation. */
+declare const ERROR_CODE_DESTRUCTIVE_CHANGES = "3030";
+/**
+ * Destructive operations require explicit confirmation via -y/--yes.
+ */
+declare function errorDestructiveChanges(summary: string, options?: {
+  readonly why?: string;
+  readonly fix?: string;
+  readonly meta?: Record<string, unknown>;
+}): CliStructuredError;
+/**
+ * Generic runtime error.
+ */
+declare function errorRuntime(summary: string, options?: {
+  readonly why?: string;
+  readonly fix?: string;
+  readonly meta?: Record<string, unknown>;
+}): CliStructuredError;
+/**
+ * Generic unexpected error.
+ */
+declare function errorUnexpected(message: string, options?: {
+  readonly why?: string;
+  readonly fix?: string;
+}): CliStructuredError;
+//#endregion
+export { type CliErrorConflict, type CliErrorEnvelope, CliStructuredError, ERROR_CODE_DESTRUCTIVE_CHANGES, errorConfigFileNotFound, errorConfigValidation, errorContractConfigMissing, errorContractMissingExtensionPacks, errorContractValidationFailed, errorDatabaseConnectionRequired, errorDestructiveChanges, errorDriverRequired, errorFamilyReadMarkerSqlRequired, errorFileNotFound, errorHashMismatch, errorJsonFormatNotSupported, errorMarkerMissing, errorMarkerRequired, errorMigrationPlanningFailed, errorQueryRunnerFactoryRequired, errorRunnerFailed, errorRuntime, errorSchemaVerificationFailed, errorTargetMigrationNotSupported, errorTargetMismatch, errorUnexpected };
+//# sourceMappingURL=errors.d.mts.map

package/dist/errors.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.mts","names":[],"sources":["../src/errors.ts"],"sourcesContent":[],"mappings":";;;;;;AAOA;AAqBA;AAUa,UA/BI,gBAAA,CA+Be;EAYf,SAAA,EAAA,EAAA,KAAA;EAYK,SAAA,IAAA,EAAA,MAAA;EAwBN,SAAA,MAAA,EAAA,MAAA;EAoBsB,SAAA,QAAA,EAAA,OAAA,GAAA,MAAA,GAAA,MAAA;EApEE,SAAA,OAAA,EAAA,MAAA;EAAK,SAAA,GAAA,EAAA,MAAA,GAAA,SAAA;EAyF7B,SAAA,GAAA,EAAA,MAAA,GAAA,SAAuB;EAkBvB,SAAA,KAAA,EAAA;IAcA,SAAA,IAAA,EAAA,MAAA,GAAA,SAA6B;IAkB7B,SAAA,IAAA,EAAA,MAAiB,GAAA,SAO9B;EAaa,CAAA,GAAA,SAAA;EAoBA,SAAA,IAAA,EApMC,MAoMD,CAAA,MAAA,EAAA,OAA+B,CAAA,GAAA,SAE3C;EAYY,SAAA,OAAA,EAAA,MAAA,GAAA,SAAgC;AAchD;AAoBA;AAYA;AAuBA;AA6BgB,UA7SC,gBAAA,CA6SD;EAcA,SAAA,IAAA,EAAA,MAAA;EAqBA,SAAA,OAAA,EAAA,MAAkB;EAclB,SAAA,GAAA,CAAA,EAAA,MAAiB;AAuBjC;AAqBA;AAeA;;;AAII,cAnZS,kBAAA,SAA2B,KAAA,CAmZpC;EAAkB,SAAA,IAAA,EAAA,MAAA;EAeN,SAAA,MAAA,EAAA,KAAiB,GAAA,KAAA;EAiBpB,SAAA,QAAA,EAAA,OAAA,GAAA,MAA8B,GAAA,MAAA;EAK3B,SAAA,GAAA,EAAA,MAAA,GAAA,SAAuB;EAmBvB,SAAA,GAAA,EAAA,MAAY,GAAA,SAKR;EAkBJ,SAAA,KAAA,EAAA;;;;iBAtdC;;;;;;;;;;;oBAYK;;;;;;gBAwBN;;;;;sCAoBsB;;;;;iBAqBtB,uBAAA;;IAKb;;;;iBAaa,0BAAA;;IAEZ;;;;iBAYY,6BAAA;;;;;IAKb;;;;iBAaa,iBAAA;;;;IAOb;;;;iBAaa,+BAAA;;;;IAIZ;;;;iBAgBY,+BAAA;;IAEZ;;;;iBAYY,gCAAA;;IAEZ;;;;iBAYY,2BAAA;;;;IAIZ;;;;iBAgBY,mBAAA;;IAA0D;;;;iBAY1D,kCAAA;;;IAGZ;;;;iBAoBY,4BAAA;+BACe;;IAE3B;;;;iBA0BY,gCAAA;;IAEZ;;;;iBAYY,qBAAA;;IAKb;;;;iBAgBa,kBAAA;;;IAGZ;;;;iBAWY,iBAAA;;;;IAIZ;;;;iBAmBY,mBAAA;;IAMb;;;;;iBAea,mBAAA;;;IAGZ;;;;;iBAYY,6BAAA;;+BAEe;6BACF;IACzB;;;;iBAeY,iBAAA;;;kBAKI;IAEjB;;cAUU,8BAAA;;;;iBAKG,uBAAA;;;kBAKI;IAEjB;;;;iBAYa,YAAA;;;kBAKI;IAEjB;;;;iBAgBa,eAAA;;;IAMb"}