@prisma-next/sql-contract 0.3.0-dev.7 → 0.3.0-dev.70

package/dist/types-T6o5-ZB3.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-T6o5-ZB3.d.mts","names":[],"sources":["../src/types.ts"],"sourcesContent":[],"mappings":";;;;;;AAgBA;AAsBA;AAKA;AAKA;AAKA;AAKY,KA1CA,aAAA,GA0CiB;EAEjB,SAAA,UAAA,EAAiB,MAAA;EAMjB,SAAA,OAAU,EAAA,MAAA;EAEC,SAAA,QAAA,EAAA,OAAA;EAED;;;AAQtB;;EACoB,SAAA,UAAA,CAAA,EAtDI,MAsDJ,CAAA,MAAA,EAAA,OAAA,CAAA;EACI;;;;EAEJ,SAAA,OAAA,CAAA,EAAA,MAAA;EACkB;;;AAatC;EAMY,SAAA,OAAU,CAAA,EAnED,aAmEC;CACY;AAAf,KAjEP,UAAA,GAiEO;EAKe,SAAA,OAAA,EAAA,SAAA,MAAA,EAAA;EAAf,SAAA,IAAA,CAAA,EAAA,MAAA;CAAM;AAGb,KApEA,gBAAA,GAoEU;EAIV,SAAA,OAAY,EAAA,SAAA,MAAA,EAAA;EAIZ,SAAA,IAAA,CAAA,EAAA,MAAe;CACP;AACc,KAzEtB,KAAA,GAyEsB;EAAf,SAAA,OAAA,EAAA,SAAA,MAAA,EAAA;EACG,SAAA,IAAA,CAAA,EAAA,MAAA;CAAM;AAGhB,KAxEA,oBAAA,GAwEW;EACG,SAAA,KAAA,EAAA,MAAA;EACA,SAAA,OAAA,EAAA,SAAA,MAAA,EAAA;CACgB;AAAf,KAtEf,iBAAA,GAsEe,UAAA,GAAA,UAAA,GAAA,SAAA,GAAA,SAAA,GAAA,YAAA;AACe,KArE9B,iBAAA,GAqE8B;EAAf,SAAA,IAAA,CAAA,EAAA,MAAA;EACJ,SAAA,QAAA,CAAA,EApED,iBAoEC;EACmB,SAAA,QAAA,CAAA,EApEpB,iBAoEoB;CAAf;AAAM,KAjErB,UAAA,GAiEqB;EAGpB,SAAA,OAAA,EAAA,SAAqB,MAAA,EAAA;EACrB,SAAA,UAAgB,EAnEN,oBAmEM;EAMb,SAAA,IAAA,CAAA,EAAA,MAAe;EAUnB,SAAA,QAAW,CAAA,EAjFD,iBAiFC;EACX,SAAA,QAAA,CAAA,EAjFU,iBAiFV;EAAa;EACb,SAAA,UAAA,EAAA,OAAA;EAA0B;EAC1B,SAAA,KAAA,EAAA,OAAA;CAA0B;AACxB,KA7EF,YAAA,GA6EE;EAAc,SAAA,OAAA,EA5ER,MA4EQ,CAAA,MAAA,EA5EO,aA4EP,CAAA;EACL,SAAA,UAAA,CAAA,EA5EC,UA4ED;EAA0B,SAAA,OAAA,EA3E7B,aA2E6B,CA3Ef,gBA2Ee,CAAA;EACxB,SAAA,OAAA,EA3EL,aA2EK,CA3ES,KA2ET,CAAA;EAA4B,SAAA,WAAA,EA1E7B,aA0E6B,CA1Ef,UA0Ee,CAAA;CAC9B;;;;;;;;;;;AAOgB,KArE3B,mBAAA,GAqE2B;EAG3B,SAAA,OAAA,EAAA,MAAiB;EAA+B,SAAA,UAAA,EAAA,MAAA;EAAZ,SAAA,UAAA,EArEzB,MAqEyB,CAAA,MAAA,EAAA,OAAA,CAAA;CAC9C;AAAS,KAnEC,UAAA,GAmED;EAEC,SAAA,MAAA,EApEO,MAoEP,CAAqB,MAAA,EApEC,YAoED,CAAA;EAA+B;;;;mBA/D7C,eAAe;;KAGtB,UAAA;;;KAIA,YAAA;;;KAIA,eAAA;oBACQ;mBACD,eAAe;sBACZ;;KAGV,WAAA;0BACc;0BACA;2BACC,eAAe;2BACf,eAAe;uBACnB;;;2BACI,eAAe;;cAG7B,qBAAA;cACA,gBAAA;;;;;iBAMG,eAAA;;;;;;;;;;KAUJ,sBACA,aAAa,sBACb,0BAA0B,mCAC1B,0BAA0B,qCACxB,cAAc,kCACL,0BAA0B,gDACxB,4BAA4B,gDAC9B,0BAA0B,2BAC7C,aAAa,cAAc,gBAAgB;;oBAE3B;mBACD;sBACG;qBACD;uBACE;;KAGX,oCAAoC,YAAY,eAC1D;KAEU,wCAAwC,YAAY,eAC9D"}

package/dist/types-kacOgEya.mjs

@@ -0,0 +1,17 @@
+//#region src/types.ts
+const DEFAULT_FK_CONSTRAINT = true;
+const DEFAULT_FK_INDEX = true;
+/**
+* Resolves foreign key `constraint` and `index` fields to their effective boolean values,
+* falling back through optional override defaults, then to the global defaults.
+*/
+function applyFkDefaults(fk, overrideDefaults) {
+	return {
+		constraint: fk.constraint ?? overrideDefaults?.constraint ?? DEFAULT_FK_CONSTRAINT,
+		index: fk.index ?? overrideDefaults?.index ?? DEFAULT_FK_INDEX
+	};
+}
+
+//#endregion
+export { DEFAULT_FK_INDEX as n, applyFkDefaults as r, DEFAULT_FK_CONSTRAINT as t };
+//# sourceMappingURL=types-kacOgEya.mjs.map

package/dist/types-kacOgEya.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-kacOgEya.mjs","names":[],"sources":["../src/types.ts"],"sourcesContent":["import type {\n  ColumnDefault,\n  ContractBase,\n  ExecutionHashBase,\n  ExecutionSection,\n  ProfileHashBase,\n  StorageHashBase,\n} from '@prisma-next/contract/types';\n\n/**\n * A column definition in storage.\n *\n * `typeParams` is optional because most columns use non-parameterized types.\n * Columns with parameterized types can either inline `typeParams` or reference\n * a named {@link StorageTypeInstance} via `typeRef`.\n */\nexport type StorageColumn = {\n  readonly nativeType: string;\n  readonly codecId: string;\n  readonly nullable: boolean;\n  /**\n   * Opaque, codec-owned JS/type parameters.\n   * The codec that owns `codecId` defines the shape and semantics.\n   * Mutually exclusive with `typeRef`.\n   */\n  readonly typeParams?: Record<string, unknown>;\n  /**\n   * Reference to a named type instance in `storage.types`.\n   * Mutually exclusive with `typeParams`.\n   */\n  readonly typeRef?: string;\n  /**\n   * Default value for the column.\n   * Can be a literal value or database function.\n   */\n  readonly default?: ColumnDefault;\n};\n\nexport type PrimaryKey = {\n  readonly columns: readonly string[];\n  readonly name?: string;\n};\n\nexport type UniqueConstraint = {\n  readonly columns: readonly string[];\n  readonly name?: string;\n};\n\nexport type Index = {\n  readonly columns: readonly string[];\n  readonly name?: string;\n};\n\nexport type ForeignKeyReferences = {\n  readonly table: string;\n  readonly columns: readonly string[];\n};\n\nexport type ReferentialAction = 'noAction' | 'restrict' | 'cascade' | 'setNull' | 'setDefault';\n\nexport type ForeignKeyOptions = {\n  readonly name?: string;\n  readonly onDelete?: ReferentialAction;\n  readonly onUpdate?: ReferentialAction;\n};\n\nexport type ForeignKey = {\n  readonly columns: readonly string[];\n  readonly references: ForeignKeyReferences;\n  readonly name?: string;\n  readonly onDelete?: ReferentialAction;\n  readonly onUpdate?: ReferentialAction;\n  /** Whether to emit FK constraint DDL (ALTER TABLE … ADD CONSTRAINT … FOREIGN KEY). */\n  readonly constraint: boolean;\n  /** Whether to emit a backing index for the FK columns. */\n  readonly index: boolean;\n};\n\nexport type StorageTable = {\n  readonly columns: Record<string, StorageColumn>;\n  readonly primaryKey?: PrimaryKey;\n  readonly uniques: ReadonlyArray<UniqueConstraint>;\n  readonly indexes: ReadonlyArray<Index>;\n  readonly foreignKeys: ReadonlyArray<ForeignKey>;\n};\n\n/**\n * A named, parameterized type instance.\n * These are registered in `storage.types` for reuse across columns\n * and to enable ergonomic schema surfaces like `schema.types.MyType`.\n *\n * Unlike {@link StorageColumn}, `typeParams` is required here because\n * `StorageTypeInstance` exists specifically to define reusable parameterized types.\n * A type instance without parameters would be redundant—columns can reference\n * the codec directly via `codecId`.\n */\nexport type StorageTypeInstance = {\n  readonly codecId: string;\n  readonly nativeType: string;\n  readonly typeParams: Record<string, unknown>;\n};\n\nexport type SqlStorage = {\n  readonly tables: Record<string, StorageTable>;\n  /**\n   * Named type instances for parameterized/custom types.\n   * Columns can reference these via `typeRef`.\n   */\n  readonly types?: Record<string, StorageTypeInstance>;\n};\n\nexport type ModelField = {\n  readonly column: string;\n};\n\nexport type ModelStorage = {\n  readonly table: string;\n};\n\nexport type ModelDefinition = {\n  readonly storage: ModelStorage;\n  readonly fields: Record<string, ModelField>;\n  readonly relations: Record<string, unknown>;\n};\n\nexport type SqlMappings = {\n  readonly modelToTable?: Record<string, string>;\n  readonly tableToModel?: Record<string, string>;\n  readonly fieldToColumn?: Record<string, Record<string, string>>;\n  readonly columnToField?: Record<string, Record<string, string>>;\n  readonly codecTypes: Record<string, { readonly output: unknown }>;\n  readonly operationTypes: Record<string, Record<string, unknown>>;\n};\n\nexport const DEFAULT_FK_CONSTRAINT = true;\nexport const DEFAULT_FK_INDEX = true;\n\n/**\n * Resolves foreign key `constraint` and `index` fields to their effective boolean values,\n * falling back through optional override defaults, then to the global defaults.\n */\nexport function applyFkDefaults(\n  fk: { constraint?: boolean | undefined; index?: boolean | undefined },\n  overrideDefaults?: { constraint?: boolean | undefined; index?: boolean | undefined },\n): { constraint: boolean; index: boolean } {\n  return {\n    constraint: fk.constraint ?? overrideDefaults?.constraint ?? DEFAULT_FK_CONSTRAINT,\n    index: fk.index ?? overrideDefaults?.index ?? DEFAULT_FK_INDEX,\n  };\n}\n\nexport type SqlContract<\n  S extends SqlStorage = SqlStorage,\n  M extends Record<string, unknown> = Record<string, unknown>,\n  R extends Record<string, unknown> = Record<string, unknown>,\n  Map extends SqlMappings = SqlMappings,\n  TStorageHash extends StorageHashBase<string> = StorageHashBase<string>,\n  TExecutionHash extends ExecutionHashBase<string> = ExecutionHashBase<string>,\n  TProfileHash extends ProfileHashBase<string> = ProfileHashBase<string>,\n> = ContractBase<TStorageHash, TExecutionHash, TProfileHash> & {\n  readonly targetFamily: string;\n  readonly storage: S;\n  readonly models: M;\n  readonly relations: R;\n  readonly mappings: Map;\n  readonly execution?: ExecutionSection;\n};\n\nexport type ExtractCodecTypes<TContract extends SqlContract<SqlStorage>> =\n  TContract['mappings']['codecTypes'];\n\nexport type ExtractOperationTypes<TContract extends SqlContract<SqlStorage>> =\n  TContract['mappings']['operationTypes'];\n"],"mappings":";AAsIA,MAAa,wBAAwB;AACrC,MAAa,mBAAmB;;;;;AAMhC,SAAgB,gBACd,IACA,kBACyC;AACzC,QAAO;EACL,YAAY,GAAG,cAAc,kBAAkB,cAAc;EAC7D,OAAO,GAAG,SAAS,kBAAkB,SAAS;EAC/C"}

package/dist/types.d.mts

@@ -0,0 +1,2 @@
+import { _ as StorageColumn, a as ForeignKey, b as UniqueConstraint, c as Index, d as ModelStorage, f as PrimaryKey, g as SqlStorage, h as SqlMappings, i as ExtractOperationTypes, l as ModelDefinition, m as SqlContract, n as DEFAULT_FK_INDEX, o as ForeignKeyOptions, p as ReferentialAction, r as ExtractCodecTypes, s as ForeignKeyReferences, t as DEFAULT_FK_CONSTRAINT, u as ModelField, v as StorageTable, x as applyFkDefaults, y as StorageTypeInstance } from "./types-T6o5-ZB3.mjs";
+export { DEFAULT_FK_CONSTRAINT, DEFAULT_FK_INDEX, type ExtractCodecTypes, type ExtractOperationTypes, type ForeignKey, type ForeignKeyOptions, type ForeignKeyReferences, type Index, type ModelDefinition, type ModelField, type ModelStorage, type PrimaryKey, type ReferentialAction, type SqlContract, type SqlMappings, type SqlStorage, type StorageColumn, type StorageTable, type StorageTypeInstance, type UniqueConstraint, applyFkDefaults };

package/dist/types.mjs

@@ -0,0 +1,3 @@
+import { n as DEFAULT_FK_INDEX, r as applyFkDefaults, t as DEFAULT_FK_CONSTRAINT } from "./types-kacOgEya.mjs";
+
+export { DEFAULT_FK_CONSTRAINT, DEFAULT_FK_INDEX, applyFkDefaults };

package/dist/validate.d.mts

@@ -0,0 +1,11 @@
+import { _ as StorageColumn, g as SqlStorage, m as SqlContract } from "./types-T6o5-ZB3.mjs";
+import "@prisma-next/contract/types";
+
+//#region src/validate.d.ts
+declare function isBigIntColumn(column: StorageColumn): boolean;
+declare function decodeContractDefaults<T extends SqlContract<SqlStorage>>(contract: T): T;
+declare function normalizeContract(contract: unknown): SqlContract<SqlStorage>;
+declare function validateContract<TContract extends SqlContract<SqlStorage>>(value: unknown): TContract;
+//#endregion
+export { decodeContractDefaults, isBigIntColumn, normalizeContract, validateContract };
+//# sourceMappingURL=validate.d.mts.map

package/dist/validate.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.mts","names":[],"sources":["../src/validate.ts"],"sourcesContent":[],"mappings":";;;;iBA6PgB,cAAA,SAAuB;AAAvB,iBAkCA,sBAlCuB,CAAa,UAkCH,WAlCG,CAkCS,UAlCT,CAAA,CAAA,CAAA,QAAA,EAkCgC,CAlChC,CAAA,EAkCoC,CAlCpC;AAkCpC,iBAqDA,iBAAA,CArDsB,QAAA,EAAA,OAAA,CAAA,EAqDgB,WArDhB,CAqD4B,UArD5B,CAAA;AAAuB,iBAwI7C,gBAxI6C,CAAA,kBAwIV,WAxIU,CAwIE,UAxIF,CAAA,CAAA,CAAA,KAAA,EAAA,OAAA,CAAA,EA0I1D,SA1I0D"}

package/dist/validate.mjs

@@ -0,0 +1,244 @@
+import { r as applyFkDefaults } from "./types-kacOgEya.mjs";
+import { c as validateSqlContract, u as validateStorageSemantics } from "./validators-Dz93b38w.mjs";
+import { isTaggedBigInt, isTaggedRaw } from "@prisma-next/contract/types";
+
+//#region src/validate.ts
+function computeDefaultMappings(models) {
+	const modelToTable = {};
+	const tableToModel = {};
+	const fieldToColumn = {};
+	const columnToField = {};
+	for (const [modelName, model] of Object.entries(models)) {
+		const tableName = model.storage.table;
+		modelToTable[modelName] = tableName;
+		tableToModel[tableName] = modelName;
+		const modelFieldToColumn = {};
+		for (const [fieldName, field] of Object.entries(model.fields)) {
+			const columnName = field.column;
+			modelFieldToColumn[fieldName] = columnName;
+			if (!columnToField[tableName]) columnToField[tableName] = {};
+			columnToField[tableName][columnName] = fieldName;
+		}
+		fieldToColumn[modelName] = modelFieldToColumn;
+	}
+	return {
+		modelToTable,
+		tableToModel,
+		fieldToColumn,
+		columnToField,
+		codecTypes: {},
+		operationTypes: {}
+	};
+}
+function assertInverseModelMappings(modelToTable, tableToModel) {
+	for (const [model, table] of Object.entries(modelToTable)) if (tableToModel[table] !== model) throw new Error(`Mappings override mismatch: modelToTable.${model}="${table}" is not mirrored in tableToModel`);
+	for (const [table, model] of Object.entries(tableToModel)) if (modelToTable[model] !== table) throw new Error(`Mappings override mismatch: tableToModel.${table}="${model}" is not mirrored in modelToTable`);
+}
+function assertInverseFieldMappings(fieldToColumn, columnToField, modelToTable, tableToModel) {
+	for (const [model, fields] of Object.entries(fieldToColumn)) {
+		const table = modelToTable[model];
+		if (!table) throw new Error(`Mappings override mismatch: fieldToColumn references unknown model "${model}"`);
+		const reverseFields = columnToField[table];
+		if (!reverseFields) throw new Error(`Mappings override mismatch: columnToField is missing table "${table}" for model "${model}"`);
+		for (const [field, column] of Object.entries(fields)) if (reverseFields[column] !== field) throw new Error(`Mappings override mismatch: fieldToColumn.${model}.${field}="${column}" is not mirrored in columnToField.${table}`);
+	}
+	for (const [table, columns] of Object.entries(columnToField)) {
+		const model = tableToModel[table];
+		if (!model) throw new Error(`Mappings override mismatch: columnToField references unknown table "${table}"`);
+		const forwardFields = fieldToColumn[model];
+		if (!forwardFields) throw new Error(`Mappings override mismatch: fieldToColumn is missing model "${model}" for table "${table}"`);
+		for (const [column, field] of Object.entries(columns)) if (forwardFields[field] !== column) throw new Error(`Mappings override mismatch: columnToField.${table}.${column}="${field}" is not mirrored in fieldToColumn.${model}`);
+	}
+}
+function mergeMappings(defaults, existingMappings) {
+	const hasModelToTable = existingMappings?.modelToTable !== void 0;
+	const hasTableToModel = existingMappings?.tableToModel !== void 0;
+	if (hasModelToTable !== hasTableToModel) throw new Error("Mappings override mismatch: modelToTable and tableToModel must be provided together");
+	const hasFieldToColumn = existingMappings?.fieldToColumn !== void 0;
+	const hasColumnToField = existingMappings?.columnToField !== void 0;
+	if (hasFieldToColumn !== hasColumnToField) throw new Error("Mappings override mismatch: fieldToColumn and columnToField must be provided together");
+	const modelToTable = hasModelToTable ? existingMappings?.modelToTable ?? {} : defaults.modelToTable;
+	const tableToModel = hasTableToModel ? existingMappings?.tableToModel ?? {} : defaults.tableToModel;
+	assertInverseModelMappings(modelToTable, tableToModel);
+	const fieldToColumn = hasFieldToColumn ? existingMappings?.fieldToColumn ?? {} : defaults.fieldToColumn;
+	const columnToField = hasColumnToField ? existingMappings?.columnToField ?? {} : defaults.columnToField;
+	assertInverseFieldMappings(fieldToColumn, columnToField, modelToTable, tableToModel);
+	return {
+		modelToTable,
+		tableToModel,
+		fieldToColumn,
+		columnToField,
+		codecTypes: {
+			...defaults.codecTypes,
+			...existingMappings?.codecTypes ?? {}
+		},
+		operationTypes: {
+			...defaults.operationTypes,
+			...existingMappings?.operationTypes ?? {}
+		}
+	};
+}
+function validateContractLogic(contract) {
+	const tableNames = new Set(Object.keys(contract.storage.tables));
+	for (const [tableName, table] of Object.entries(contract.storage.tables)) {
+		const columnNames = new Set(Object.keys(table.columns));
+		if (table.primaryKey) {
+			for (const colName of table.primaryKey.columns) if (!columnNames.has(colName)) throw new Error(`Table "${tableName}" primaryKey references non-existent column "${colName}"`);
+		}
+		for (const unique of table.uniques) for (const colName of unique.columns) if (!columnNames.has(colName)) throw new Error(`Table "${tableName}" unique constraint references non-existent column "${colName}"`);
+		for (const index of table.indexes) for (const colName of index.columns) if (!columnNames.has(colName)) throw new Error(`Table "${tableName}" index references non-existent column "${colName}"`);
+		for (const [colName, column] of Object.entries(table.columns)) if (!column.nullable && column.default?.kind === "literal" && column.default.value === null) throw new Error(`Table "${tableName}" column "${colName}" is NOT NULL but has a literal null default`);
+		for (const fk of table.foreignKeys) {
+			for (const colName of fk.columns) if (!columnNames.has(colName)) throw new Error(`Table "${tableName}" foreignKey references non-existent column "${colName}"`);
+			if (!tableNames.has(fk.references.table)) throw new Error(`Table "${tableName}" foreignKey references non-existent table "${fk.references.table}"`);
+			const referencedTable = contract.storage.tables[fk.references.table];
+			const referencedColumnNames = new Set(Object.keys(referencedTable.columns));
+			for (const colName of fk.references.columns) if (!referencedColumnNames.has(colName)) throw new Error(`Table "${tableName}" foreignKey references non-existent column "${colName}" in table "${fk.references.table}"`);
+			if (fk.columns.length !== fk.references.columns.length) throw new Error(`Table "${tableName}" foreignKey column count (${fk.columns.length}) does not match referenced column count (${fk.references.columns.length})`);
+		}
+	}
+}
+const BIGINT_NATIVE_TYPES = new Set(["bigint", "int8"]);
+function isBigIntColumn(column) {
+	const nativeType = column.nativeType?.toLowerCase() ?? "";
+	if (BIGINT_NATIVE_TYPES.has(nativeType)) return true;
+	const codecId = column.codecId?.toLowerCase() ?? "";
+	return codecId.includes("int8") || codecId.includes("bigint");
+}
+function decodeDefaultLiteralValue(value, column, tableName, columnName) {
+	if (value instanceof Date) return value;
+	if (isTaggedRaw(value)) return value.value;
+	if (isTaggedBigInt(value)) {
+		if (!isBigIntColumn(column)) return value;
+		try {
+			return BigInt(value.value);
+		} catch {
+			throw new Error(`Invalid tagged bigint for default value on "${tableName}.${columnName}": "${value.value}" is not a valid integer`);
+		}
+	}
+	return value;
+}
+function decodeContractDefaults(contract) {
+	const tables = contract.storage.tables;
+	let tablesChanged = false;
+	const decodedTables = {};
+	for (const [tableName, table] of Object.entries(tables)) {
+		let columnsChanged = false;
+		const decodedColumns = {};
+		for (const [columnName, column] of Object.entries(table.columns)) {
+			if (column.default?.kind === "literal") {
+				const decodedValue = decodeDefaultLiteralValue(column.default.value, column, tableName, columnName);
+				if (decodedValue !== column.default.value) {
+					columnsChanged = true;
+					decodedColumns[columnName] = {
+						...column,
+						default: {
+							kind: "literal",
+							value: decodedValue
+						}
+					};
+					continue;
+				}
+			}
+			decodedColumns[columnName] = column;
+		}
+		if (columnsChanged) {
+			tablesChanged = true;
+			decodedTables[tableName] = {
+				...table,
+				columns: decodedColumns
+			};
+		} else decodedTables[tableName] = table;
+	}
+	if (!tablesChanged) return contract;
+	return {
+		...contract,
+		storage: {
+			...contract.storage,
+			tables: decodedTables
+		}
+	};
+}
+function normalizeContract(contract) {
+	if (typeof contract !== "object" || contract === null) return contract;
+	const contractObj = contract;
+	let normalizedStorage = contractObj["storage"];
+	if (normalizedStorage && typeof normalizedStorage === "object" && normalizedStorage !== null) {
+		const storage = normalizedStorage;
+		const tables = storage["tables"];
+		if (tables) {
+			const normalizedTables = {};
+			for (const [tableName, table] of Object.entries(tables)) {
+				const tableObj = table;
+				const columns = tableObj["columns"];
+				if (columns) {
+					const normalizedColumns = {};
+					for (const [columnName, column] of Object.entries(columns)) {
+						const columnObj = column;
+						normalizedColumns[columnName] = {
+							...columnObj,
+							nullable: columnObj["nullable"] ?? false
+						};
+					}
+					const normalizedForeignKeys = (tableObj["foreignKeys"] ?? []).map((fk) => ({
+						...fk,
+						...applyFkDefaults({
+							constraint: typeof fk["constraint"] === "boolean" ? fk["constraint"] : void 0,
+							index: typeof fk["index"] === "boolean" ? fk["index"] : void 0
+						})
+					}));
+					normalizedTables[tableName] = {
+						...tableObj,
+						columns: normalizedColumns,
+						uniques: tableObj["uniques"] ?? [],
+						indexes: tableObj["indexes"] ?? [],
+						foreignKeys: normalizedForeignKeys
+					};
+				} else normalizedTables[tableName] = tableObj;
+			}
+			normalizedStorage = {
+				...storage,
+				tables: normalizedTables
+			};
+		}
+	}
+	let normalizedModels = contractObj["models"];
+	if (normalizedModels && typeof normalizedModels === "object" && normalizedModels !== null) {
+		const models = normalizedModels;
+		const normalizedModelsObj = {};
+		for (const [modelName, model] of Object.entries(models)) {
+			const modelObj = model;
+			normalizedModelsObj[modelName] = {
+				...modelObj,
+				relations: modelObj["relations"] ?? {}
+			};
+		}
+		normalizedModels = normalizedModelsObj;
+	}
+	return {
+		...contractObj,
+		models: normalizedModels,
+		relations: contractObj["relations"] ?? {},
+		storage: normalizedStorage,
+		extensionPacks: contractObj["extensionPacks"] ?? {},
+		capabilities: contractObj["capabilities"] ?? {},
+		meta: contractObj["meta"] ?? {},
+		sources: contractObj["sources"] ?? {}
+	};
+}
+function validateContract(value) {
+	const structurallyValid = validateSqlContract(normalizeContract(value));
+	validateContractLogic(structurallyValid);
+	const semanticErrors = validateStorageSemantics(structurallyValid.storage);
+	if (semanticErrors.length > 0) throw new Error(`Contract semantic validation failed: ${semanticErrors.join("; ")}`);
+	const existingMappings = structurallyValid.mappings;
+	const mappings = mergeMappings(computeDefaultMappings(structurallyValid.models), existingMappings);
+	return decodeContractDefaults({
+		...structurallyValid,
+		mappings
+	});
+}
+
+//#endregion
+export { decodeContractDefaults, isBigIntColumn, normalizeContract, validateContract };
+//# sourceMappingURL=validate.mjs.map

package/dist/validate.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.mjs","names":["modelToTable: Record<string, string>","tableToModel: Record<string, string>","fieldToColumn: Record<string, Record<string, string>>","columnToField: Record<string, Record<string, string>>","modelFieldToColumn: Record<string, string>","decodedTables: Record<string, StorageTable>","decodedColumns: Record<string, StorageColumn>","normalizedTables: Record<string, unknown>","normalizedColumns: Record<string, unknown>","normalizedModelsObj: Record<string, unknown>"],"sources":["../src/validate.ts"],"sourcesContent":["import type { ColumnDefaultLiteralInputValue } from '@prisma-next/contract/types';\nimport { isTaggedBigInt, isTaggedRaw } from '@prisma-next/contract/types';\nimport type {\n  ModelDefinition,\n  SqlContract,\n  SqlMappings,\n  SqlStorage,\n  StorageColumn,\n  StorageTable,\n} from './types';\nimport { applyFkDefaults } from './types';\nimport { validateSqlContract, validateStorageSemantics } from './validators';\n\ntype ResolvedMappings = {\n  modelToTable: Record<string, string>;\n  tableToModel: Record<string, string>;\n  fieldToColumn: Record<string, Record<string, string>>;\n  columnToField: Record<string, Record<string, string>>;\n  codecTypes: Record<string, { readonly output: unknown }>;\n  operationTypes: Record<string, Record<string, unknown>>;\n};\n\nfunction computeDefaultMappings(models: Record<string, ModelDefinition>): ResolvedMappings {\n  const modelToTable: Record<string, string> = {};\n  const tableToModel: Record<string, string> = {};\n  const fieldToColumn: Record<string, Record<string, string>> = {};\n  const columnToField: Record<string, Record<string, string>> = {};\n\n  for (const [modelName, model] of Object.entries(models)) {\n    const tableName = model.storage.table;\n    modelToTable[modelName] = tableName;\n    tableToModel[tableName] = modelName;\n\n    const modelFieldToColumn: Record<string, string> = {};\n    for (const [fieldName, field] of Object.entries(model.fields)) {\n      const columnName = field.column;\n      modelFieldToColumn[fieldName] = columnName;\n      if (!columnToField[tableName]) {\n        columnToField[tableName] = {};\n      }\n      columnToField[tableName][columnName] = fieldName;\n    }\n\n    fieldToColumn[modelName] = modelFieldToColumn;\n  }\n\n  return {\n    modelToTable,\n    tableToModel,\n    fieldToColumn,\n    columnToField,\n    codecTypes: {},\n    operationTypes: {},\n  };\n}\n\nfunction assertInverseModelMappings(\n  modelToTable: Record<string, string>,\n  tableToModel: Record<string, string>,\n) {\n  for (const [model, table] of Object.entries(modelToTable)) {\n    if (tableToModel[table] !== model) {\n      throw new Error(\n        `Mappings override mismatch: modelToTable.${model}=\"${table}\" is not mirrored in tableToModel`,\n      );\n    }\n  }\n  for (const [table, model] of Object.entries(tableToModel)) {\n    if (modelToTable[model] !== table) {\n      throw new Error(\n        `Mappings override mismatch: tableToModel.${table}=\"${model}\" is not mirrored in modelToTable`,\n      );\n    }\n  }\n}\n\nfunction assertInverseFieldMappings(\n  fieldToColumn: Record<string, Record<string, string>>,\n  columnToField: Record<string, Record<string, string>>,\n  modelToTable: Record<string, string>,\n  tableToModel: Record<string, string>,\n) {\n  for (const [model, fields] of Object.entries(fieldToColumn)) {\n    const table = modelToTable[model];\n    if (!table) {\n      throw new Error(\n        `Mappings override mismatch: fieldToColumn references unknown model \"${model}\"`,\n      );\n    }\n    const reverseFields = columnToField[table];\n    if (!reverseFields) {\n      throw new Error(\n        `Mappings override mismatch: columnToField is missing table \"${table}\" for model \"${model}\"`,\n      );\n    }\n    for (const [field, column] of Object.entries(fields)) {\n      if (reverseFields[column] !== field) {\n        throw new Error(\n          `Mappings override mismatch: fieldToColumn.${model}.${field}=\"${column}\" is not mirrored in columnToField.${table}`,\n        );\n      }\n    }\n  }\n\n  for (const [table, columns] of Object.entries(columnToField)) {\n    const model = tableToModel[table];\n    if (!model) {\n      throw new Error(\n        `Mappings override mismatch: columnToField references unknown table \"${table}\"`,\n      );\n    }\n    const forwardFields = fieldToColumn[model];\n    if (!forwardFields) {\n      throw new Error(\n        `Mappings override mismatch: fieldToColumn is missing model \"${model}\" for table \"${table}\"`,\n      );\n    }\n    for (const [column, field] of Object.entries(columns)) {\n      if (forwardFields[field] !== column) {\n        throw new Error(\n          `Mappings override mismatch: columnToField.${table}.${column}=\"${field}\" is not mirrored in fieldToColumn.${model}`,\n        );\n      }\n    }\n  }\n}\n\nfunction mergeMappings(\n  defaults: ResolvedMappings,\n  existingMappings?: Partial<SqlMappings>,\n): ResolvedMappings {\n  const hasModelToTable = existingMappings?.modelToTable !== undefined;\n  const hasTableToModel = existingMappings?.tableToModel !== undefined;\n  if (hasModelToTable !== hasTableToModel) {\n    throw new Error(\n      'Mappings override mismatch: modelToTable and tableToModel must be provided together',\n    );\n  }\n\n  const hasFieldToColumn = existingMappings?.fieldToColumn !== undefined;\n  const hasColumnToField = existingMappings?.columnToField !== undefined;\n  if (hasFieldToColumn !== hasColumnToField) {\n    throw new Error(\n      'Mappings override mismatch: fieldToColumn and columnToField must be provided together',\n    );\n  }\n\n  const modelToTable: Record<string, string> = hasModelToTable\n    ? (existingMappings?.modelToTable ?? {})\n    : defaults.modelToTable;\n  const tableToModel: Record<string, string> = hasTableToModel\n    ? (existingMappings?.tableToModel ?? {})\n    : defaults.tableToModel;\n  assertInverseModelMappings(modelToTable, tableToModel);\n\n  const fieldToColumn: Record<string, Record<string, string>> = hasFieldToColumn\n    ? (existingMappings?.fieldToColumn ?? {})\n    : defaults.fieldToColumn;\n  const columnToField: Record<string, Record<string, string>> = hasColumnToField\n    ? (existingMappings?.columnToField ?? {})\n    : defaults.columnToField;\n  assertInverseFieldMappings(fieldToColumn, columnToField, modelToTable, tableToModel);\n\n  return {\n    modelToTable,\n    tableToModel,\n    fieldToColumn,\n    columnToField,\n    codecTypes: { ...defaults.codecTypes, ...(existingMappings?.codecTypes ?? {}) },\n    operationTypes: { ...defaults.operationTypes, ...(existingMappings?.operationTypes ?? {}) },\n  };\n}\n\nfunction validateContractLogic(contract: SqlContract<SqlStorage>): void {\n  const tableNames = new Set(Object.keys(contract.storage.tables));\n\n  for (const [tableName, table] of Object.entries(contract.storage.tables)) {\n    const columnNames = new Set(Object.keys(table.columns));\n\n    if (table.primaryKey) {\n      for (const colName of table.primaryKey.columns) {\n        if (!columnNames.has(colName)) {\n          throw new Error(\n            `Table \"${tableName}\" primaryKey references non-existent column \"${colName}\"`,\n          );\n        }\n      }\n    }\n\n    for (const unique of table.uniques) {\n      for (const colName of unique.columns) {\n        if (!columnNames.has(colName)) {\n          throw new Error(\n            `Table \"${tableName}\" unique constraint references non-existent column \"${colName}\"`,\n          );\n        }\n      }\n    }\n\n    for (const index of table.indexes) {\n      for (const colName of index.columns) {\n        if (!columnNames.has(colName)) {\n          throw new Error(`Table \"${tableName}\" index references non-existent column \"${colName}\"`);\n        }\n      }\n    }\n\n    for (const [colName, column] of Object.entries(table.columns)) {\n      if (!column.nullable && column.default?.kind === 'literal' && column.default.value === null) {\n        throw new Error(\n          `Table \"${tableName}\" column \"${colName}\" is NOT NULL but has a literal null default`,\n        );\n      }\n    }\n\n    for (const fk of table.foreignKeys) {\n      for (const colName of fk.columns) {\n        if (!columnNames.has(colName)) {\n          throw new Error(\n            `Table \"${tableName}\" foreignKey references non-existent column \"${colName}\"`,\n          );\n        }\n      }\n\n      if (!tableNames.has(fk.references.table)) {\n        throw new Error(\n          `Table \"${tableName}\" foreignKey references non-existent table \"${fk.references.table}\"`,\n        );\n      }\n\n      const referencedTable = contract.storage.tables[\n        fk.references.table\n      ] as (typeof contract.storage.tables)[string];\n      const referencedColumnNames = new Set(Object.keys(referencedTable.columns));\n      for (const colName of fk.references.columns) {\n        if (!referencedColumnNames.has(colName)) {\n          throw new Error(\n            `Table \"${tableName}\" foreignKey references non-existent column \"${colName}\" in table \"${fk.references.table}\"`,\n          );\n        }\n      }\n\n      if (fk.columns.length !== fk.references.columns.length) {\n        throw new Error(\n          `Table \"${tableName}\" foreignKey column count (${fk.columns.length}) does not match referenced column count (${fk.references.columns.length})`,\n        );\n      }\n    }\n  }\n}\n\nconst BIGINT_NATIVE_TYPES = new Set(['bigint', 'int8']);\n\nexport function isBigIntColumn(column: StorageColumn): boolean {\n  const nativeType = column.nativeType?.toLowerCase() ?? '';\n  if (BIGINT_NATIVE_TYPES.has(nativeType)) return true;\n  const codecId = column.codecId?.toLowerCase() ?? '';\n  return codecId.includes('int8') || codecId.includes('bigint');\n}\n\nexport function decodeDefaultLiteralValue(\n  value: ColumnDefaultLiteralInputValue,\n  column: StorageColumn,\n  tableName: string,\n  columnName: string,\n): ColumnDefaultLiteralInputValue {\n  if (value instanceof Date) {\n    return value;\n  }\n  if (isTaggedRaw(value)) {\n    return value.value;\n  }\n  if (isTaggedBigInt(value)) {\n    if (!isBigIntColumn(column)) {\n      return value;\n    }\n    try {\n      return BigInt(value.value);\n    } catch {\n      throw new Error(\n        `Invalid tagged bigint for default value on \"${tableName}.${columnName}\": \"${value.value}\" is not a valid integer`,\n      );\n    }\n  }\n  return value;\n}\n\nexport function decodeContractDefaults<T extends SqlContract<SqlStorage>>(contract: T): T {\n  const tables = contract.storage.tables;\n  let tablesChanged = false;\n  const decodedTables: Record<string, StorageTable> = {};\n\n  for (const [tableName, table] of Object.entries(tables)) {\n    let columnsChanged = false;\n    const decodedColumns: Record<string, StorageColumn> = {};\n\n    for (const [columnName, column] of Object.entries(table.columns)) {\n      if (column.default?.kind === 'literal') {\n        const decodedValue = decodeDefaultLiteralValue(\n          column.default.value,\n          column,\n          tableName,\n          columnName,\n        );\n        if (decodedValue !== column.default.value) {\n          columnsChanged = true;\n          decodedColumns[columnName] = {\n            ...column,\n            default: { kind: 'literal', value: decodedValue },\n          };\n          continue;\n        }\n      }\n      decodedColumns[columnName] = column;\n    }\n\n    if (columnsChanged) {\n      tablesChanged = true;\n      decodedTables[tableName] = { ...table, columns: decodedColumns };\n    } else {\n      decodedTables[tableName] = table;\n    }\n  }\n\n  if (!tablesChanged) {\n    return contract;\n  }\n\n  // The spread widens to SqlContract<SqlStorage>, but this transformation only\n  // decodes tagged bigint defaults for bigint-like columns and preserves all\n  // other properties of T.\n  return {\n    ...contract,\n    storage: {\n      ...contract.storage,\n      tables: decodedTables,\n    },\n  } as T;\n}\n\nexport function normalizeContract(contract: unknown): SqlContract<SqlStorage> {\n  if (typeof contract !== 'object' || contract === null) {\n    return contract as SqlContract<SqlStorage>;\n  }\n\n  const contractObj = contract as Record<string, unknown>;\n\n  let normalizedStorage = contractObj['storage'];\n  if (normalizedStorage && typeof normalizedStorage === 'object' && normalizedStorage !== null) {\n    const storage = normalizedStorage as Record<string, unknown>;\n    const tables = storage['tables'] as Record<string, unknown> | undefined;\n\n    if (tables) {\n      const normalizedTables: Record<string, unknown> = {};\n      for (const [tableName, table] of Object.entries(tables)) {\n        const tableObj = table as Record<string, unknown>;\n        const columns = tableObj['columns'] as Record<string, unknown> | undefined;\n\n        if (columns) {\n          const normalizedColumns: Record<string, unknown> = {};\n          for (const [columnName, column] of Object.entries(columns)) {\n            const columnObj = column as Record<string, unknown>;\n            normalizedColumns[columnName] = {\n              ...columnObj,\n              nullable: columnObj['nullable'] ?? false,\n            };\n          }\n\n          // Normalize foreign keys: add constraint/index defaults if missing\n          const rawForeignKeys = (tableObj['foreignKeys'] ?? []) as Array<Record<string, unknown>>;\n          const normalizedForeignKeys = rawForeignKeys.map((fk) => ({\n            ...fk,\n            ...applyFkDefaults({\n              constraint: typeof fk['constraint'] === 'boolean' ? fk['constraint'] : undefined,\n              index: typeof fk['index'] === 'boolean' ? fk['index'] : undefined,\n            }),\n          }));\n\n          normalizedTables[tableName] = {\n            ...tableObj,\n            columns: normalizedColumns,\n            uniques: tableObj['uniques'] ?? [],\n            indexes: tableObj['indexes'] ?? [],\n            foreignKeys: normalizedForeignKeys,\n          };\n        } else {\n          normalizedTables[tableName] = tableObj;\n        }\n      }\n\n      normalizedStorage = {\n        ...storage,\n        tables: normalizedTables,\n      };\n    }\n  }\n\n  let normalizedModels = contractObj['models'];\n  if (normalizedModels && typeof normalizedModels === 'object' && normalizedModels !== null) {\n    const models = normalizedModels as Record<string, unknown>;\n    const normalizedModelsObj: Record<string, unknown> = {};\n    for (const [modelName, model] of Object.entries(models)) {\n      const modelObj = model as Record<string, unknown>;\n      normalizedModelsObj[modelName] = {\n        ...modelObj,\n        relations: modelObj['relations'] ?? {},\n      };\n    }\n    normalizedModels = normalizedModelsObj;\n  }\n\n  return {\n    ...contractObj,\n    models: normalizedModels,\n    relations: contractObj['relations'] ?? {},\n    storage: normalizedStorage,\n    extensionPacks: contractObj['extensionPacks'] ?? {},\n    capabilities: contractObj['capabilities'] ?? {},\n    meta: contractObj['meta'] ?? {},\n    sources: contractObj['sources'] ?? {},\n  } as SqlContract<SqlStorage>;\n}\n\nexport function validateContract<TContract extends SqlContract<SqlStorage>>(\n  value: unknown,\n): TContract {\n  const normalized = normalizeContract(value);\n  const structurallyValid = validateSqlContract<SqlContract<SqlStorage>>(normalized);\n  validateContractLogic(structurallyValid);\n\n  const semanticErrors = validateStorageSemantics(structurallyValid.storage);\n  if (semanticErrors.length > 0) {\n    throw new Error(`Contract semantic validation failed: ${semanticErrors.join('; ')}`);\n  }\n\n  const existingMappings = (structurallyValid as { mappings?: Partial<SqlMappings> }).mappings;\n  const defaultMappings = computeDefaultMappings(\n    structurallyValid.models as Record<string, ModelDefinition>,\n  );\n  const mappings = mergeMappings(defaultMappings, existingMappings);\n\n  const contractWithMappings = {\n    ...structurallyValid,\n    mappings,\n  };\n\n  return decodeContractDefaults(contractWithMappings) as TContract;\n}\n"],"mappings":"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"}

package/dist/validators-Dz93b38w.mjs

@@ -0,0 +1,214 @@
+import { type } from "arktype";
+
+//#region src/validators.ts
+const literalKindSchema = type("'literal'");
+const functionKindSchema = type("'function'");
+const generatorKindSchema = type("'generator'");
+const generatorIdSchema = type("'ulid' | 'nanoid' | 'uuidv7' | 'uuidv4' | 'cuid2' | 'ksuid'");
+const ColumnDefaultLiteralSchema = type.declare().type({
+	kind: literalKindSchema,
+	value: "string | number | boolean | null | unknown[] | Record<string, unknown>"
+});
+const ColumnDefaultFunctionSchema = type.declare().type({
+	kind: functionKindSchema,
+	expression: "string"
+});
+const ColumnDefaultSchema = ColumnDefaultLiteralSchema.or(ColumnDefaultFunctionSchema);
+const ExecutionMutationDefaultValueSchema = type({
+	"+": "reject",
+	kind: generatorKindSchema,
+	id: generatorIdSchema,
+	"params?": "Record<string, unknown>"
+});
+const ExecutionMutationDefaultSchema = type({
+	"+": "reject",
+	ref: {
+		"+": "reject",
+		table: "string",
+		column: "string"
+	},
+	"onCreate?": ExecutionMutationDefaultValueSchema,
+	"onUpdate?": ExecutionMutationDefaultValueSchema
+});
+const ExecutionSchema = type({
+	"+": "reject",
+	mutations: {
+		"+": "reject",
+		defaults: ExecutionMutationDefaultSchema.array().readonly()
+	}
+});
+const StorageColumnSchema = type({
+	"+": "reject",
+	nativeType: "string",
+	codecId: "string",
+	nullable: "boolean",
+	"typeParams?": "Record<string, unknown>",
+	"typeRef?": "string",
+	"default?": ColumnDefaultSchema
+}).narrow((col, ctx) => {
+	if (col.typeParams !== void 0 && col.typeRef !== void 0) return ctx.mustBe("a column with either typeParams or typeRef, not both");
+	return true;
+});
+const StorageTypeInstanceSchema = type.declare().type({
+	codecId: "string",
+	nativeType: "string",
+	typeParams: "Record<string, unknown>"
+});
+const PrimaryKeySchema = type.declare().type({
+	columns: type.string.array().readonly(),
+	"name?": "string"
+});
+const UniqueConstraintSchema = type.declare().type({
+	columns: type.string.array().readonly(),
+	"name?": "string"
+});
+const IndexSchema = type.declare().type({
+	columns: type.string.array().readonly(),
+	"name?": "string"
+});
+const ForeignKeyReferencesSchema = type.declare().type({
+	table: "string",
+	columns: type.string.array().readonly()
+});
+const ReferentialActionSchema = type.declare().type("'noAction' | 'restrict' | 'cascade' | 'setNull' | 'setDefault'");
+const ForeignKeySchema = type.declare().type({
+	columns: type.string.array().readonly(),
+	references: ForeignKeyReferencesSchema,
+	"name?": "string",
+	"onDelete?": ReferentialActionSchema,
+	"onUpdate?": ReferentialActionSchema,
+	constraint: "boolean",
+	index: "boolean"
+});
+const StorageTableSchema = type({
+	"+": "reject",
+	columns: type({ "[string]": StorageColumnSchema }),
+	"primaryKey?": PrimaryKeySchema,
+	uniques: UniqueConstraintSchema.array().readonly(),
+	indexes: IndexSchema.array().readonly(),
+	foreignKeys: ForeignKeySchema.array().readonly()
+});
+const StorageSchema = type({
+	"+": "reject",
+	tables: type({ "[string]": StorageTableSchema }),
+	"types?": type({ "[string]": StorageTypeInstanceSchema })
+});
+const ModelFieldSchema = type.declare().type({ column: "string" });
+const ModelStorageSchema = type.declare().type({ table: "string" });
+const ModelSchema = type.declare().type({
+	storage: ModelStorageSchema,
+	fields: type({ "[string]": ModelFieldSchema }),
+	relations: type({ "[string]": "unknown" })
+});
+const MappingsSchema = type({
+	"+": "reject",
+	"modelToTable?": "null | Record<string, string>",
+	"tableToModel?": "null | Record<string, string>",
+	"fieldToColumn?": "null | Record<string, Record<string, string>>",
+	"columnToField?": "null | Record<string, Record<string, string>>",
+	"codecTypes?": "null | Record<string, unknown>",
+	"operationTypes?": "null | Record<string, Record<string, unknown>>"
+});
+const ContractMetaSchema = type({ "[string]": "unknown" });
+const SqlContractSchema = type({
+	"+": "reject",
+	"schemaVersion?": "'1'",
+	target: "string",
+	targetFamily: "'sql'",
+	"coreHash?": "string",
+	storageHash: "string",
+	"executionHash?": "string",
+	"profileHash?": "string",
+	"_generated?": "Record<string, unknown>",
+	"capabilities?": "Record<string, Record<string, boolean>>",
+	"extensionPacks?": "Record<string, unknown>",
+	"meta?": ContractMetaSchema,
+	"sources?": "Record<string, unknown>",
+	"relations?": type({ "[string]": "unknown" }),
+	"mappings?": MappingsSchema,
+	models: type({ "[string]": ModelSchema }),
+	storage: StorageSchema,
+	"execution?": ExecutionSchema
+});
+/**
+* Validates the structural shape of SqlStorage using Arktype.
+*
+* @param value - The storage value to validate
+* @returns The validated storage if structure is valid
+* @throws Error if the storage structure is invalid
+*/
+function validateStorage(value) {
+	const result = StorageSchema(value);
+	if (result instanceof type.errors) {
+		const messages = result.map((p) => p.message).join("; ");
+		throw new Error(`Storage validation failed: ${messages}`);
+	}
+	return result;
+}
+/**
+* Validates the structural shape of ModelDefinition using Arktype.
+*
+* @param value - The model value to validate
+* @returns The validated model if structure is valid
+* @throws Error if the model structure is invalid
+*/
+function validateModel(value) {
+	const result = ModelSchema(value);
+	if (result instanceof type.errors) {
+		const messages = result.map((p) => p.message).join("; ");
+		throw new Error(`Model validation failed: ${messages}`);
+	}
+	return result;
+}
+/**
+* Validates the structural shape of a SqlContract using Arktype.
+*
+* **Responsibility: Validation Only**
+* This function validates that the contract has the correct structure and types.
+* It does NOT normalize the contract - normalization must happen in the contract builder.
+*
+* The contract passed to this function must already be normalized (all required fields present).
+* If normalization is needed, it should be done by the contract builder before calling this function.
+*
+* This ensures all required fields are present and have the correct types.
+*
+* @param value - The contract value to validate (typically from a JSON import)
+* @returns The validated contract if structure is valid
+* @throws Error if the contract structure is invalid
+*/
+function validateSqlContract(value) {
+	if (typeof value !== "object" || value === null) throw new Error("Contract structural validation failed: value must be an object");
+	const rawValue = value;
+	if (rawValue.targetFamily !== void 0 && rawValue.targetFamily !== "sql") throw new Error(`Unsupported target family: ${rawValue.targetFamily}`);
+	const contractResult = SqlContractSchema(value);
+	if (contractResult instanceof type.errors) {
+		const messages = contractResult.map((p) => p.message).join("; ");
+		throw new Error(`Contract structural validation failed: ${messages}`);
+	}
+	return contractResult;
+}
+/**
+* Validates semantic constraints on SqlStorage that cannot be expressed in Arktype schemas.
+*
+* Returns an array of human-readable error strings. Empty array = valid.
+*
+* Currently checks:
+* - `setNull` referential action on a non-nullable FK column (would fail at runtime)
+* - `setDefault` referential action on a non-nullable FK column without a DEFAULT (would fail at runtime)
+*/
+function validateStorageSemantics(storage) {
+	const errors = [];
+	for (const [tableName, table] of Object.entries(storage.tables)) for (const fk of table.foreignKeys) for (const colName of fk.columns) {
+		const column = table.columns[colName];
+		if (!column) continue;
+		if (fk.onDelete === "setNull" && !column.nullable) errors.push(`Table "${tableName}": onDelete setNull on foreign key column "${colName}" which is NOT NULL`);
+		if (fk.onUpdate === "setNull" && !column.nullable) errors.push(`Table "${tableName}": onUpdate setNull on foreign key column "${colName}" which is NOT NULL`);
+		if (fk.onDelete === "setDefault" && !column.nullable && column.default === void 0) errors.push(`Table "${tableName}": onDelete setDefault on foreign key column "${colName}" which is NOT NULL and has no DEFAULT`);
+		if (fk.onUpdate === "setDefault" && !column.nullable && column.default === void 0) errors.push(`Table "${tableName}": onUpdate setDefault on foreign key column "${colName}" which is NOT NULL and has no DEFAULT`);
+	}
+	return errors;
+}
+
+//#endregion
+export { ForeignKeySchema as a, validateSqlContract as c, ForeignKeyReferencesSchema as i, validateStorage as l, ColumnDefaultLiteralSchema as n, ReferentialActionSchema as o, ColumnDefaultSchema as r, validateModel as s, ColumnDefaultFunctionSchema as t, validateStorageSemantics as u };
+//# sourceMappingURL=validators-Dz93b38w.mjs.map

package/dist/validators-Dz93b38w.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators-Dz93b38w.mjs","names":["errors: string[]"],"sources":["../src/validators.ts"],"sourcesContent":["import { type } from 'arktype';\nimport type {\n  ForeignKey,\n  ForeignKeyReferences,\n  Index,\n  ModelDefinition,\n  ModelField,\n  ModelStorage,\n  PrimaryKey,\n  ReferentialAction,\n  SqlContract,\n  SqlStorage,\n  StorageTypeInstance,\n  UniqueConstraint,\n} from './types';\n\ntype ColumnDefaultLiteral = {\n  readonly kind: 'literal';\n  readonly value: string | number | boolean | Record<string, unknown> | unknown[] | null;\n};\ntype ColumnDefaultFunction = { readonly kind: 'function'; readonly expression: string };\nconst literalKindSchema = type(\"'literal'\");\nconst functionKindSchema = type(\"'function'\");\nconst generatorKindSchema = type(\"'generator'\");\nconst generatorIdSchema = type(\"'ulid' | 'nanoid' | 'uuidv7' | 'uuidv4' | 'cuid2' | 'ksuid'\");\n\nexport const ColumnDefaultLiteralSchema = type.declare<ColumnDefaultLiteral>().type({\n  kind: literalKindSchema,\n  value: 'string | number | boolean | null | unknown[] | Record<string, unknown>',\n});\n\nexport const ColumnDefaultFunctionSchema = type.declare<ColumnDefaultFunction>().type({\n  kind: functionKindSchema,\n  expression: 'string',\n});\n\nexport const ColumnDefaultSchema = ColumnDefaultLiteralSchema.or(ColumnDefaultFunctionSchema);\n\nconst ExecutionMutationDefaultValueSchema = type({\n  '+': 'reject',\n  kind: generatorKindSchema,\n  id: generatorIdSchema,\n  'params?': 'Record<string, unknown>',\n});\n\nconst ExecutionMutationDefaultSchema = type({\n  '+': 'reject',\n  ref: {\n    '+': 'reject',\n    table: 'string',\n    column: 'string',\n  },\n  'onCreate?': ExecutionMutationDefaultValueSchema,\n  'onUpdate?': ExecutionMutationDefaultValueSchema,\n});\n\nconst ExecutionSchema = type({\n  '+': 'reject',\n  mutations: {\n    '+': 'reject',\n    defaults: ExecutionMutationDefaultSchema.array().readonly(),\n  },\n});\n\nconst StorageColumnSchema = type({\n  '+': 'reject',\n  nativeType: 'string',\n  codecId: 'string',\n  nullable: 'boolean',\n  'typeParams?': 'Record<string, unknown>',\n  'typeRef?': 'string',\n  'default?': ColumnDefaultSchema,\n}).narrow((col, ctx) => {\n  if (col.typeParams !== undefined && col.typeRef !== undefined) {\n    return ctx.mustBe('a column with either typeParams or typeRef, not both');\n  }\n  return true;\n});\n\nconst StorageTypeInstanceSchema = type.declare<StorageTypeInstance>().type({\n  codecId: 'string',\n  nativeType: 'string',\n  typeParams: 'Record<string, unknown>',\n});\n\nconst PrimaryKeySchema = type.declare<PrimaryKey>().type({\n  columns: type.string.array().readonly(),\n  'name?': 'string',\n});\n\nconst UniqueConstraintSchema = type.declare<UniqueConstraint>().type({\n  columns: type.string.array().readonly(),\n  'name?': 'string',\n});\n\nconst IndexSchema = type.declare<Index>().type({\n  columns: type.string.array().readonly(),\n  'name?': 'string',\n});\n\nexport const ForeignKeyReferencesSchema = type.declare<ForeignKeyReferences>().type({\n  table: 'string',\n  columns: type.string.array().readonly(),\n});\n\nexport const ReferentialActionSchema = type\n  .declare<ReferentialAction>()\n  .type(\"'noAction' | 'restrict' | 'cascade' | 'setNull' | 'setDefault'\");\n\nexport const ForeignKeySchema = type.declare<ForeignKey>().type({\n  columns: type.string.array().readonly(),\n  references: ForeignKeyReferencesSchema,\n  'name?': 'string',\n  'onDelete?': ReferentialActionSchema,\n  'onUpdate?': ReferentialActionSchema,\n  constraint: 'boolean',\n  index: 'boolean',\n});\n\nconst StorageTableSchema = type({\n  '+': 'reject',\n  columns: type({ '[string]': StorageColumnSchema }),\n  'primaryKey?': PrimaryKeySchema,\n  uniques: UniqueConstraintSchema.array().readonly(),\n  indexes: IndexSchema.array().readonly(),\n  foreignKeys: ForeignKeySchema.array().readonly(),\n});\n\nconst StorageSchema = type({\n  '+': 'reject',\n  tables: type({ '[string]': StorageTableSchema }),\n  'types?': type({ '[string]': StorageTypeInstanceSchema }),\n});\n\nconst ModelFieldSchema = type.declare<ModelField>().type({\n  column: 'string',\n});\n\nconst ModelStorageSchema = type.declare<ModelStorage>().type({\n  table: 'string',\n});\n\nconst ModelSchema = type.declare<ModelDefinition>().type({\n  storage: ModelStorageSchema,\n  fields: type({ '[string]': ModelFieldSchema }),\n  relations: type({ '[string]': 'unknown' }),\n});\n\nconst MappingsSchema = type({\n  '+': 'reject',\n  'modelToTable?': 'null | Record<string, string>',\n  'tableToModel?': 'null | Record<string, string>',\n  'fieldToColumn?': 'null | Record<string, Record<string, string>>',\n  'columnToField?': 'null | Record<string, Record<string, string>>',\n  'codecTypes?': 'null | Record<string, unknown>',\n  'operationTypes?': 'null | Record<string, Record<string, unknown>>',\n});\n\nconst ContractMetaSchema = type({\n  '[string]': 'unknown',\n});\n\nconst SqlContractSchema = type({\n  '+': 'reject',\n  'schemaVersion?': \"'1'\",\n  target: 'string',\n  targetFamily: \"'sql'\",\n  'coreHash?': 'string',\n  storageHash: 'string',\n  'executionHash?': 'string',\n  'profileHash?': 'string',\n  '_generated?': 'Record<string, unknown>',\n  'capabilities?': 'Record<string, Record<string, boolean>>',\n  'extensionPacks?': 'Record<string, unknown>',\n  'meta?': ContractMetaSchema,\n  'sources?': 'Record<string, unknown>',\n  'relations?': type({ '[string]': 'unknown' }),\n  'mappings?': MappingsSchema,\n  models: type({ '[string]': ModelSchema }),\n  storage: StorageSchema,\n  'execution?': ExecutionSchema,\n});\n\n// NOTE: StorageColumnSchema, StorageTableSchema, and StorageSchema use bare type()\n// instead of type.declare<T>().type() because the ColumnDefault union's value field\n// includes bigint | Date (runtime-only types after decoding) which cannot be expressed\n// in Arktype's JSON validation DSL. The `as SqlStorage` cast in validateStorage() bridges\n// the gap between the JSON-safe Arktype output and the runtime TypeScript type.\n// See decodeContractDefaults() in validate.ts for the decoding step.\n\n/**\n * Validates the structural shape of SqlStorage using Arktype.\n *\n * @param value - The storage value to validate\n * @returns The validated storage if structure is valid\n * @throws Error if the storage structure is invalid\n */\nexport function validateStorage(value: unknown): SqlStorage {\n  const result = StorageSchema(value);\n  if (result instanceof type.errors) {\n    const messages = result.map((p: { message: string }) => p.message).join('; ');\n    throw new Error(`Storage validation failed: ${messages}`);\n  }\n  return result as SqlStorage;\n}\n\n/**\n * Validates the structural shape of ModelDefinition using Arktype.\n *\n * @param value - The model value to validate\n * @returns The validated model if structure is valid\n * @throws Error if the model structure is invalid\n */\nexport function validateModel(value: unknown): ModelDefinition {\n  const result = ModelSchema(value);\n  if (result instanceof type.errors) {\n    const messages = result.map((p: { message: string }) => p.message).join('; ');\n    throw new Error(`Model validation failed: ${messages}`);\n  }\n  return result;\n}\n\n/**\n * Validates the structural shape of a SqlContract using Arktype.\n *\n * **Responsibility: Validation Only**\n * This function validates that the contract has the correct structure and types.\n * It does NOT normalize the contract - normalization must happen in the contract builder.\n *\n * The contract passed to this function must already be normalized (all required fields present).\n * If normalization is needed, it should be done by the contract builder before calling this function.\n *\n * This ensures all required fields are present and have the correct types.\n *\n * @param value - The contract value to validate (typically from a JSON import)\n * @returns The validated contract if structure is valid\n * @throws Error if the contract structure is invalid\n */\nexport function validateSqlContract<T extends SqlContract<SqlStorage>>(value: unknown): T {\n  if (typeof value !== 'object' || value === null) {\n    throw new Error('Contract structural validation failed: value must be an object');\n  }\n\n  // Check targetFamily first to provide a clear error message for unsupported target families\n  const rawValue = value as { targetFamily?: string };\n  if (rawValue.targetFamily !== undefined && rawValue.targetFamily !== 'sql') {\n    throw new Error(`Unsupported target family: ${rawValue.targetFamily}`);\n  }\n\n  const contractResult = SqlContractSchema(value);\n\n  if (contractResult instanceof type.errors) {\n    const messages = contractResult.map((p: { message: string }) => p.message).join('; ');\n    throw new Error(`Contract structural validation failed: ${messages}`);\n  }\n\n  // After validation, contractResult matches the schema and preserves the input structure\n  // TypeScript needs an assertion here due to exactOptionalPropertyTypes differences\n  // between Arktype's inferred type and the generic T, but runtime-wise they're compatible\n  return contractResult as T;\n}\n\n/**\n * Validates semantic constraints on SqlStorage that cannot be expressed in Arktype schemas.\n *\n * Returns an array of human-readable error strings. Empty array = valid.\n *\n * Currently checks:\n * - `setNull` referential action on a non-nullable FK column (would fail at runtime)\n * - `setDefault` referential action on a non-nullable FK column without a DEFAULT (would fail at runtime)\n */\nexport function validateStorageSemantics(storage: SqlStorage): string[] {\n  const errors: string[] = [];\n\n  for (const [tableName, table] of Object.entries(storage.tables)) {\n    for (const fk of table.foreignKeys) {\n      for (const colName of fk.columns) {\n        const column = table.columns[colName];\n        if (!column) continue;\n\n        if (fk.onDelete === 'setNull' && !column.nullable) {\n          errors.push(\n            `Table \"${tableName}\": onDelete setNull on foreign key column \"${colName}\" which is NOT NULL`,\n          );\n        }\n        if (fk.onUpdate === 'setNull' && !column.nullable) {\n          errors.push(\n            `Table \"${tableName}\": onUpdate setNull on foreign key column \"${colName}\" which is NOT NULL`,\n          );\n        }\n        if (fk.onDelete === 'setDefault' && !column.nullable && column.default === undefined) {\n          errors.push(\n            `Table \"${tableName}\": onDelete setDefault on foreign key column \"${colName}\" which is NOT NULL and has no DEFAULT`,\n          );\n        }\n        if (fk.onUpdate === 'setDefault' && !column.nullable && column.default === undefined) {\n          errors.push(\n            `Table \"${tableName}\": onUpdate setDefault on foreign key column \"${colName}\" which is NOT NULL and has no DEFAULT`,\n          );\n        }\n      }\n    }\n  }\n\n  return errors;\n}\n"],"mappings":";;;AAqBA,MAAM,oBAAoB,KAAK,YAAY;AAC3C,MAAM,qBAAqB,KAAK,aAAa;AAC7C,MAAM,sBAAsB,KAAK,cAAc;AAC/C,MAAM,oBAAoB,KAAK,8DAA8D;AAE7F,MAAa,6BAA6B,KAAK,SAA+B,CAAC,KAAK;CAClF,MAAM;CACN,OAAO;CACR,CAAC;AAEF,MAAa,8BAA8B,KAAK,SAAgC,CAAC,KAAK;CACpF,MAAM;CACN,YAAY;CACb,CAAC;AAEF,MAAa,sBAAsB,2BAA2B,GAAG,4BAA4B;AAE7F,MAAM,sCAAsC,KAAK;CAC/C,KAAK;CACL,MAAM;CACN,IAAI;CACJ,WAAW;CACZ,CAAC;AAEF,MAAM,iCAAiC,KAAK;CAC1C,KAAK;CACL,KAAK;EACH,KAAK;EACL,OAAO;EACP,QAAQ;EACT;CACD,aAAa;CACb,aAAa;CACd,CAAC;AAEF,MAAM,kBAAkB,KAAK;CAC3B,KAAK;CACL,WAAW;EACT,KAAK;EACL,UAAU,+BAA+B,OAAO,CAAC,UAAU;EAC5D;CACF,CAAC;AAEF,MAAM,sBAAsB,KAAK;CAC/B,KAAK;CACL,YAAY;CACZ,SAAS;CACT,UAAU;CACV,eAAe;CACf,YAAY;CACZ,YAAY;CACb,CAAC,CAAC,QAAQ,KAAK,QAAQ;AACtB,KAAI,IAAI,eAAe,UAAa,IAAI,YAAY,OAClD,QAAO,IAAI,OAAO,uDAAuD;AAE3E,QAAO;EACP;AAEF,MAAM,4BAA4B,KAAK,SAA8B,CAAC,KAAK;CACzE,SAAS;CACT,YAAY;CACZ,YAAY;CACb,CAAC;AAEF,MAAM,mBAAmB,KAAK,SAAqB,CAAC,KAAK;CACvD,SAAS,KAAK,OAAO,OAAO,CAAC,UAAU;CACvC,SAAS;CACV,CAAC;AAEF,MAAM,yBAAyB,KAAK,SAA2B,CAAC,KAAK;CACnE,SAAS,KAAK,OAAO,OAAO,CAAC,UAAU;CACvC,SAAS;CACV,CAAC;AAEF,MAAM,cAAc,KAAK,SAAgB,CAAC,KAAK;CAC7C,SAAS,KAAK,OAAO,OAAO,CAAC,UAAU;CACvC,SAAS;CACV,CAAC;AAEF,MAAa,6BAA6B,KAAK,SAA+B,CAAC,KAAK;CAClF,OAAO;CACP,SAAS,KAAK,OAAO,OAAO,CAAC,UAAU;CACxC,CAAC;AAEF,MAAa,0BAA0B,KACpC,SAA4B,CAC5B,KAAK,iEAAiE;AAEzE,MAAa,mBAAmB,KAAK,SAAqB,CAAC,KAAK;CAC9D,SAAS,KAAK,OAAO,OAAO,CAAC,UAAU;CACvC,YAAY;CACZ,SAAS;CACT,aAAa;CACb,aAAa;CACb,YAAY;CACZ,OAAO;CACR,CAAC;AAEF,MAAM,qBAAqB,KAAK;CAC9B,KAAK;CACL,SAAS,KAAK,EAAE,YAAY,qBAAqB,CAAC;CAClD,eAAe;CACf,SAAS,uBAAuB,OAAO,CAAC,UAAU;CAClD,SAAS,YAAY,OAAO,CAAC,UAAU;CACvC,aAAa,iBAAiB,OAAO,CAAC,UAAU;CACjD,CAAC;AAEF,MAAM,gBAAgB,KAAK;CACzB,KAAK;CACL,QAAQ,KAAK,EAAE,YAAY,oBAAoB,CAAC;CAChD,UAAU,KAAK,EAAE,YAAY,2BAA2B,CAAC;CAC1D,CAAC;AAEF,MAAM,mBAAmB,KAAK,SAAqB,CAAC,KAAK,EACvD,QAAQ,UACT,CAAC;AAEF,MAAM,qBAAqB,KAAK,SAAuB,CAAC,KAAK,EAC3D,OAAO,UACR,CAAC;AAEF,MAAM,cAAc,KAAK,SAA0B,CAAC,KAAK;CACvD,SAAS;CACT,QAAQ,KAAK,EAAE,YAAY,kBAAkB,CAAC;CAC9C,WAAW,KAAK,EAAE,YAAY,WAAW,CAAC;CAC3C,CAAC;AAEF,MAAM,iBAAiB,KAAK;CAC1B,KAAK;CACL,iBAAiB;CACjB,iBAAiB;CACjB,kBAAkB;CAClB,kBAAkB;CAClB,eAAe;CACf,mBAAmB;CACpB,CAAC;AAEF,MAAM,qBAAqB,KAAK,EAC9B,YAAY,WACb,CAAC;AAEF,MAAM,oBAAoB,KAAK;CAC7B,KAAK;CACL,kBAAkB;CAClB,QAAQ;CACR,cAAc;CACd,aAAa;CACb,aAAa;CACb,kBAAkB;CAClB,gBAAgB;CAChB,eAAe;CACf,iBAAiB;CACjB,mBAAmB;CACnB,SAAS;CACT,YAAY;CACZ,cAAc,KAAK,EAAE,YAAY,WAAW,CAAC;CAC7C,aAAa;CACb,QAAQ,KAAK,EAAE,YAAY,aAAa,CAAC;CACzC,SAAS;CACT,cAAc;CACf,CAAC;;;;;;;;AAgBF,SAAgB,gBAAgB,OAA4B;CAC1D,MAAM,SAAS,cAAc,MAAM;AACnC,KAAI,kBAAkB,KAAK,QAAQ;EACjC,MAAM,WAAW,OAAO,KAAK,MAA2B,EAAE,QAAQ,CAAC,KAAK,KAAK;AAC7E,QAAM,IAAI,MAAM,8BAA8B,WAAW;;AAE3D,QAAO;;;;;;;;;AAUT,SAAgB,cAAc,OAAiC;CAC7D,MAAM,SAAS,YAAY,MAAM;AACjC,KAAI,kBAAkB,KAAK,QAAQ;EACjC,MAAM,WAAW,OAAO,KAAK,MAA2B,EAAE,QAAQ,CAAC,KAAK,KAAK;AAC7E,QAAM,IAAI,MAAM,4BAA4B,WAAW;;AAEzD,QAAO;;;;;;;;;;;;;;;;;;AAmBT,SAAgB,oBAAuD,OAAmB;AACxF,KAAI,OAAO,UAAU,YAAY,UAAU,KACzC,OAAM,IAAI,MAAM,iEAAiE;CAInF,MAAM,WAAW;AACjB,KAAI,SAAS,iBAAiB,UAAa,SAAS,iBAAiB,MACnE,OAAM,IAAI,MAAM,8BAA8B,SAAS,eAAe;CAGxE,MAAM,iBAAiB,kBAAkB,MAAM;AAE/C,KAAI,0BAA0B,KAAK,QAAQ;EACzC,MAAM,WAAW,eAAe,KAAK,MAA2B,EAAE,QAAQ,CAAC,KAAK,KAAK;AACrF,QAAM,IAAI,MAAM,0CAA0C,WAAW;;AAMvE,QAAO;;;;;;;;;;;AAYT,SAAgB,yBAAyB,SAA+B;CACtE,MAAMA,SAAmB,EAAE;AAE3B,MAAK,MAAM,CAAC,WAAW,UAAU,OAAO,QAAQ,QAAQ,OAAO,CAC7D,MAAK,MAAM,MAAM,MAAM,YACrB,MAAK,MAAM,WAAW,GAAG,SAAS;EAChC,MAAM,SAAS,MAAM,QAAQ;AAC7B,MAAI,CAAC,OAAQ;AAEb,MAAI,GAAG,aAAa,aAAa,CAAC,OAAO,SACvC,QAAO,KACL,UAAU,UAAU,6CAA6C,QAAQ,qBAC1E;AAEH,MAAI,GAAG,aAAa,aAAa,CAAC,OAAO,SACvC,QAAO,KACL,UAAU,UAAU,6CAA6C,QAAQ,qBAC1E;AAEH,MAAI,GAAG,aAAa,gBAAgB,CAAC,OAAO,YAAY,OAAO,YAAY,OACzE,QAAO,KACL,UAAU,UAAU,gDAAgD,QAAQ,wCAC7E;AAEH,MAAI,GAAG,aAAa,gBAAgB,CAAC,OAAO,YAAY,OAAO,YAAY,OACzE,QAAO,KACL,UAAU,UAAU,gDAAgD,QAAQ,wCAC7E;;AAMT,QAAO"}