@prisma-next/contract 0.11.0-dev.49 → 0.11.0-dev.50

package/dist/canonicalization-j__G4o7F.d.mts

@@ -0,0 +1,69 @@
+import { t as Contract } from "./contract-types-OSHtK6P5.mjs";
+import { JsonObject } from "@prisma-next/utils/json";
+
+//#region src/canonicalization.d.ts
+/**
+ * Per-target contract serializer hook. The framework canonicalizer uses
+ * this to convert an in-memory contract (which may carry class-instance
+ * IR nodes whose runtime-only fields must not appear in the on-disk
+ * envelope) into a plain JsonObject before applying the family-agnostic
+ * canonical-key ordering / default-omission / sort steps. Targets whose
+ * contract is JSON-clean by construction return the contract unchanged.
+ */
+type SerializeContract = (contract: Contract) => JsonObject;
+/**
+ * Family-contributed predicate for the default-omission walk. Called when
+ * a value at `path` is a default (empty object/array or `false`); if this
+ * returns `true` the value is kept rather than stripped.
+ *
+ * The framework only calls the predicate inside the `isDefaultValue` branch,
+ * so there is no need to guard against non-default values.
+ */
+type PreserveEmptyPredicate = (path: readonly string[]) => boolean;
+/**
+ * Family-contributed storage sort. Applied to the serialized `storage`
+ * subtree after the default-omission walk; the result replaces the
+ * `storage` field before the final key sort. Use to establish a
+ * deterministic order for storage arrays (indexes, uniques) that the
+ * family-agnostic `sortObjectKeys` pass cannot handle.
+ */
+type StorageSort = (storage: unknown) => unknown;
+interface CanonicalizeContractOptions {
+  readonly schemaVersion?: string;
+  /**
+   * Per-target hook that converts the in-memory contract (which may
+   * carry class-instance IR nodes) into a plain JsonObject before the
+   * family-agnostic canonicalization steps run.
+   *
+   * Routing through the hook is what lets each target decide which
+   * fields appear in the on-disk envelope; runtime-only class API
+   * fields stay invisible to the canonicalization walk by virtue of
+   * the per-target serializer not putting them in the JSON shape.
+   */
+  readonly serializeContract: SerializeContract;
+  /**
+   * Family-contributed preserve-empty predicate. When the walk encounters a
+   * default value (empty object/array or `false`) at `path`, calling this
+   * with the full path allows the family to veto the omission. If absent,
+   * only the framework's family-agnostic required-slot rules apply.
+   */
+  readonly shouldPreserveEmpty?: PreserveEmptyPredicate;
+  /**
+   * Family-contributed storage sort. Applied to the serialized `storage`
+   * subtree after the default-omission walk, before the final key sort.
+   * SQL family uses this to impose a deterministic order on `indexes` and
+   * `uniques` arrays within each namespace table. Families that require no
+   * special storage ordering omit this hook.
+   */
+  readonly sortStorage?: StorageSort;
+}
+/**
+ * Object-form variant of {@link canonicalizeContract}. Exported because the
+ * emitter writes the canonical contract through a separate JSON-stringify
+ * pass and consumes the structured object directly.
+ */
+declare function canonicalizeContractToObject(contract: Contract, options: CanonicalizeContractOptions): Record<string, unknown>;
+declare function canonicalizeContract(contract: Contract, options: CanonicalizeContractOptions): string;
+//#endregion
+export { canonicalizeContract as a, StorageSort as i, PreserveEmptyPredicate as n, canonicalizeContractToObject as o, SerializeContract as r, CanonicalizeContractOptions as t };
+//# sourceMappingURL=canonicalization-j__G4o7F.d.mts.map

package/dist/canonicalization-j__G4o7F.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonicalization-j__G4o7F.d.mts","names":[],"sources":["../src/canonicalization.ts"],"mappings":";;;;;;AAcA;;;;;;KAAY,iBAAA,IAAqB,QAAA,EAAU,QAAA,KAAa,UAAU;;AAAA;AAUlE;;;;AAA6D;AAS7D;KATY,sBAAA,IAA0B,IAAuB;;;AASlB;AA2J3C;;;;KA3JY,WAAA,IAAe,OAAgB;AAAA,UA2J1B,2BAAA;EAAA,SACN,aAAA;EAAA;;;;;;;;AA0ByB;AAQpC;EAlCW,SAWA,iBAAA,EAAmB,iBAAA;;;;;;;WAOnB,mBAAA,GAAsB,sBAAA;EAiB/B;;;;;AAEO;AA4BT;EA9BE,SATS,WAAA,GAAc,WAAA;AAAA;;;;;;iBAQT,4BAAA,CACd,QAAA,EAAU,QAAA,EACV,OAAA,EAAS,2BAAA,GACR,MAAA;AAAA,iBA4Ba,oBAAA,CACd,QAAA,EAAU,QAAA,EACV,OAAA,EAAS,2BAA2B"}

package/dist/{hashing-BqnADuDo.mjs → hashing-C25nwocN.mjs}

@@ -25,9 +25,9 @@ function isDefaultValue(value) {
 	if (typeof value === "object" && value !== null) return Object.keys(value).length === 0;
 	return false;
 }
-function omitDefaults(obj, path) {
+function omitDefaults(obj, path, shouldPreserveEmpty) {
 	if (obj === null || typeof obj !== "object") return obj;
-	if (Array.isArray(obj)) return obj.map((item) => omitDefaults(item, path));
+	if (Array.isArray(obj)) return obj.map((item) => omitDefaults(item, path, shouldPreserveEmpty));
 	const result = {};
 	for (const [key, value] of Object.entries(obj)) {
 		const currentPath = [...path, key];
@@ -38,8 +38,6 @@ function omitDefaults(obj, path) {
 			const isRequiredModels = isArrayEqual(currentPath, ["models"]);
 			const isRequiredNamespaces = isArrayEqual(currentPath, ["storage", "namespaces"]);
 			const isNamespaceSlot = currentPath.length === 3 && isArrayEqual([currentPath[0], currentPath[1]], ["storage", "namespaces"]);
-			const isRequiredNamespaceTables = currentPath.length === 4 && currentPath[0] === "storage" && currentPath[1] === "namespaces" && currentPath[3] === "tables";
-			const isNamespaceTableEntry = currentPath.length === 5 && currentPath[0] === "storage" && currentPath[1] === "namespaces" && currentPath[3] === "tables";
 			const isRequiredRoots = isArrayEqual(currentPath, ["roots"]);
 			const isRequiredExtensionPacks = isArrayEqual(currentPath, ["extensionPacks"]);
 			const isRequiredCapabilities = isArrayEqual(currentPath, ["capabilities"]);
@@ -52,15 +50,12 @@ function omitDefaults(obj, path) {
 			const isExtensionNamespace = currentPath.length === 2 && currentPath[0] === "extensionPacks";
 			const isModelRelations = currentPath.length === 3 && isArrayEqual([currentPath[0], currentPath[2]], ["models", "relations"]);
 			const isModelStorage = currentPath.length === 3 && isArrayEqual([currentPath[0], currentPath[2]], ["models", "storage"]);
-			const isNamespaceTableUniques = currentPath.length === 6 && currentPath[0] === "storage" && currentPath[1] === "namespaces" && currentPath[3] === "tables" && currentPath[5] === "uniques";
-			const isNamespaceTableIndexes = currentPath.length === 6 && currentPath[0] === "storage" && currentPath[1] === "namespaces" && currentPath[3] === "tables" && currentPath[5] === "indexes";
-			const isNamespaceTableForeignKeys = currentPath.length === 6 && currentPath[0] === "storage" && currentPath[1] === "namespaces" && currentPath[3] === "tables" && currentPath[5] === "foreignKeys";
-			const isStorageTypeTypeParams = currentPath.length === 4 && currentPath[0] === "storage" && currentPath[1] === "types" && key === "typeParams";
 			const isDomainUnboundTypeParams = currentPath.length === 5 && currentPath[0] === "domain" && currentPath[2] === "types" && key === "typeParams";
-			const isFkBooleanField = currentPath.length === 7 && currentPath[0] === "storage" && currentPath[1] === "namespaces" && currentPath[3] === "tables" && currentPath[5] === "foreignKeys" && (key === "constraint" || key === "index");
-			if (!isRequiredModels && !isRequiredNamespaces && !isNamespaceSlot && !isRequiredNamespaceTables && !isNamespaceTableEntry && !isRequiredRoots && !isRequiredExtensionPacks && !isRequiredCapabilities && !isRequiredMeta && !isRequiredExecutionDefaults && !isExtensionNamespace && !isModelRelations && !isModelStorage && !isNamespaceTableUniques && !isNamespaceTableIndexes && !isNamespaceTableForeignKeys && !isFkBooleanField && !(key === "nullable") && !isStorageTypeTypeParams && !isDomainUnboundTypeParams) continue;
+			const isNullableField = key === "nullable";
+			const isFamilyPreserved = shouldPreserveEmpty?.(currentPath) ?? false;
+			if (!isRequiredModels && !isRequiredNamespaces && !isNamespaceSlot && !isRequiredRoots && !isRequiredExtensionPacks && !isRequiredCapabilities && !isRequiredMeta && !isRequiredExecutionDefaults && !isExtensionNamespace && !isModelRelations && !isModelStorage && !isNullableField && !isDomainUnboundTypeParams && !isFamilyPreserved) continue;
 		}
-		result[key] = omitDefaults(value, currentPath);
+		result[key] = omitDefaults(value, currentPath, shouldPreserveEmpty);
 	}
 	return result;
 }
@@ -72,58 +67,6 @@ function sortObjectKeys(obj) {
 	for (const key of keys) sorted[key] = sortObjectKeys(obj[key]);
 	return sorted;
 }
-function sortTableArrays(tableObj) {
-	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);
-	});
-	return sortedTable;
-}
-function sortIndexesAndUniques(storage) {
-	if (!storage || typeof storage !== "object") return storage;
-	const storageObj = storage;
-	if (!storageObj.namespaces || typeof storageObj.namespaces !== "object") return storage;
-	const namespaces = storageObj.namespaces;
-	const result = {
-		...storageObj,
-		namespaces: {}
-	};
-	const resultNamespaces = result.namespaces;
-	for (const nsId of Object.keys(namespaces)) {
-		const ns = namespaces[nsId];
-		if (!ns || typeof ns !== "object") {
-			resultNamespaces[nsId] = ns;
-			continue;
-		}
-		const nsObj = ns;
-		if (!nsObj.tables || typeof nsObj.tables !== "object") {
-			resultNamespaces[nsId] = ns;
-			continue;
-		}
-		const sortedTables = {};
-		const sortedTableNames = Object.keys(nsObj.tables).sort();
-		for (const tableName of sortedTableNames) {
-			const table = nsObj.tables[tableName];
-			if (!table || typeof table !== "object") {
-				sortedTables[tableName] = table;
-				continue;
-			}
-			sortedTables[tableName] = sortTableArrays(table);
-		}
-		resultNamespaces[nsId] = {
-			...nsObj,
-			tables: sortedTables
-		};
-	}
-	return result;
-}
 function orderTopLevel(obj) {
 	const ordered = {};
 	const remaining = new Set(Object.keys(obj));
@@ -155,12 +98,11 @@ function canonicalizeContractToObject(contract, options) {
 		extensionPacks: serialized["extensionPacks"],
 		capabilities: serialized["capabilities"],
 		meta: serialized["meta"]
-	}, []);
-	const withSortedIndexes = sortIndexesAndUniques(withDefaultsOmitted["storage"]);
-	return orderTopLevel(sortObjectKeys({
+	}, [], options.shouldPreserveEmpty);
+	return orderTopLevel(sortObjectKeys(options.sortStorage ? {
 		...withDefaultsOmitted,
-		storage: withSortedIndexes
-	}));
+		storage: options.sortStorage(withDefaultsOmitted["storage"])
+	} : withDefaultsOmitted));
 }
 function canonicalizeContract(contract, options) {
 	return JSON.stringify(canonicalizeContractToObject(contract, options), null, 2);
@@ -174,21 +116,24 @@ function sha256(content) {
 	return `sha256:${hash.digest("hex")}`;
 }
 function hashContract(section) {
+	const { shouldPreserveEmpty, sortStorage, ...sectionData } = section;
 	return canonicalizeContract({
-		targetFamily: section["targetFamily"],
-		target: section["target"],
+		targetFamily: sectionData["targetFamily"],
+		target: sectionData["target"],
 		roots: {},
 		models: {},
-		storage: section["storage"] ?? {},
-		execution: section["execution"],
+		storage: sectionData["storage"] ?? {},
+		execution: sectionData["execution"],
 		extensionPacks: {},
-		capabilities: section["capabilities"] ?? {},
+		capabilities: sectionData["capabilities"] ?? {},
 		meta: {},
 		profileHash: "",
-		...section
+		...sectionData
 	}, {
 		schemaVersion: SCHEMA_VERSION,
-		serializeContract: (c) => JSON.parse(JSON.stringify(c))
+		serializeContract: (c) => JSON.parse(JSON.stringify(c)),
+		...ifDefined("shouldPreserveEmpty", shouldPreserveEmpty),
+		...ifDefined("sortStorage", sortStorage)
 	});
 }
 function computeStorageHash(args) {
@@ -203,4 +148,4 @@ function computeProfileHash(args) {
 //#endregion
 export { canonicalizeContractToObject as a, canonicalizeContract as i, computeProfileHash as n, computeStorageHash as r, computeExecutionHash as t };
 
-//# sourceMappingURL=hashing-BqnADuDo.mjs.map
+//# sourceMappingURL=hashing-C25nwocN.mjs.map

package/dist/hashing-C25nwocN.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"hashing-C25nwocN.mjs","names":[],"sources":["../src/canonicalization.ts","../src/hashing.ts"],"sourcesContent":["import { isArrayEqual } from '@prisma-next/utils/array-equal';\nimport { ifDefined } from '@prisma-next/utils/defined';\nimport type { JsonObject } from '@prisma-next/utils/json';\n\nimport type { Contract } from './contract-types';\n\n/**\n * Per-target contract serializer hook. The framework canonicalizer uses\n * this to convert an in-memory contract (which may carry class-instance\n * IR nodes whose runtime-only fields must not appear in the on-disk\n * envelope) into a plain JsonObject before applying the family-agnostic\n * canonical-key ordering / default-omission / sort steps. Targets whose\n * contract is JSON-clean by construction return the contract unchanged.\n */\nexport type SerializeContract = (contract: Contract) => JsonObject;\n\n/**\n * Family-contributed predicate for the default-omission walk. Called when\n * a value at `path` is a default (empty object/array or `false`); if this\n * returns `true` the value is kept rather than stripped.\n *\n * The framework only calls the predicate inside the `isDefaultValue` branch,\n * so there is no need to guard against non-default values.\n */\nexport type PreserveEmptyPredicate = (path: readonly string[]) => boolean;\n\n/**\n * Family-contributed storage sort. Applied to the serialized `storage`\n * subtree after the default-omission walk; the result replaces the\n * `storage` field before the final key sort. Use to establish a\n * deterministic order for storage arrays (indexes, uniques) that the\n * family-agnostic `sortObjectKeys` pass cannot handle.\n */\nexport type StorageSort = (storage: unknown) => unknown;\n\nconst TOP_LEVEL_ORDER = [\n  'schemaVersion',\n  'canonicalVersion',\n  'targetFamily',\n  'target',\n  'profileHash',\n  'roots',\n  'models',\n  'valueObjects',\n  'domain',\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 (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(\n  obj: unknown,\n  path: readonly string[],\n  shouldPreserveEmpty: PreserveEmptyPredicate | undefined,\n): unknown {\n  if (obj === null || typeof obj !== 'object') {\n    return obj;\n  }\n\n  if (Array.isArray(obj)) {\n    return obj.map((item) => omitDefaults(item, path, shouldPreserveEmpty));\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    if (key === '_generated') {\n      continue;\n    }\n\n    if (key === 'generated' && value === false) {\n      continue;\n    }\n\n    if ((key === 'onDelete' || key === 'onUpdate') && value === 'noAction') {\n      continue;\n    }\n\n    if (isDefaultValue(value)) {\n      const isRequiredModels = isArrayEqual(currentPath, ['models']);\n      const isRequiredNamespaces = isArrayEqual(currentPath, ['storage', 'namespaces']);\n      const isNamespaceSlot =\n        currentPath.length === 3 &&\n        isArrayEqual([currentPath[0], currentPath[1]], ['storage', 'namespaces']);\n      const isRequiredRoots = isArrayEqual(currentPath, ['roots']);\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 isModelStorage =\n        currentPath.length === 3 &&\n        isArrayEqual([currentPath[0], currentPath[2]], ['models', 'storage']);\n\n      const isDomainUnboundTypeParams =\n        currentPath.length === 5 &&\n        currentPath[0] === 'domain' &&\n        currentPath[2] === 'types' &&\n        key === 'typeParams';\n\n      const isNullableField = key === 'nullable';\n\n      const isFamilyPreserved = shouldPreserveEmpty?.(currentPath) ?? false;\n\n      if (\n        !isRequiredModels &&\n        !isRequiredNamespaces &&\n        !isNamespaceSlot &&\n        !isRequiredRoots &&\n        !isRequiredExtensionPacks &&\n        !isRequiredCapabilities &&\n        !isRequiredMeta &&\n        !isRequiredExecutionDefaults &&\n        !isExtensionNamespace &&\n        !isModelRelations &&\n        !isModelStorage &&\n        !isNullableField &&\n        !isDomainUnboundTypeParams &&\n        !isFamilyPreserved\n      ) {\n        continue;\n      }\n    }\n\n    result[key] = omitDefaults(value, currentPath, shouldPreserveEmpty);\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 (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\nexport function 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 interface CanonicalizeContractOptions {\n  readonly schemaVersion?: string;\n  /**\n   * Per-target hook that converts the in-memory contract (which may\n   * carry class-instance IR nodes) into a plain JsonObject before the\n   * family-agnostic canonicalization steps run.\n   *\n   * Routing through the hook is what lets each target decide which\n   * fields appear in the on-disk envelope; runtime-only class API\n   * fields stay invisible to the canonicalization walk by virtue of\n   * the per-target serializer not putting them in the JSON shape.\n   */\n  readonly serializeContract: SerializeContract;\n  /**\n   * Family-contributed preserve-empty predicate. When the walk encounters a\n   * default value (empty object/array or `false`) at `path`, calling this\n   * with the full path allows the family to veto the omission. If absent,\n   * only the framework's family-agnostic required-slot rules apply.\n   */\n  readonly shouldPreserveEmpty?: PreserveEmptyPredicate;\n  /**\n   * Family-contributed storage sort. Applied to the serialized `storage`\n   * subtree after the default-omission walk, before the final key sort.\n   * SQL family uses this to impose a deterministic order on `indexes` and\n   * `uniques` arrays within each namespace table. Families that require no\n   * special storage ordering omit this hook.\n   */\n  readonly sortStorage?: StorageSort;\n}\n\n/**\n * Object-form variant of {@link canonicalizeContract}. Exported because the\n * emitter writes the canonical contract through a separate JSON-stringify\n * pass and consumes the structured object directly.\n */\nexport function canonicalizeContractToObject(\n  contract: Contract,\n  options: CanonicalizeContractOptions,\n): Record<string, unknown> {\n  const serialized = options.serializeContract(contract);\n  const normalized: Record<string, unknown> = {\n    ...ifDefined('schemaVersion', options.schemaVersion),\n    targetFamily: serialized['targetFamily'],\n    target: serialized['target'],\n    profileHash: serialized['profileHash'],\n    roots: serialized['roots'],\n    models: serialized['models'],\n    ...ifDefined('valueObjects', serialized['valueObjects']),\n    ...ifDefined('domain', serialized['domain']),\n    storage: serialized['storage'],\n    ...ifDefined('execution', serialized['execution']),\n    extensionPacks: serialized['extensionPacks'],\n    capabilities: serialized['capabilities'],\n    meta: serialized['meta'],\n  };\n  const withDefaultsOmitted = omitDefaults(normalized, [], options.shouldPreserveEmpty) as Record<\n    string,\n    unknown\n  >;\n  const withSortedStorage = options.sortStorage\n    ? { ...withDefaultsOmitted, storage: options.sortStorage(withDefaultsOmitted['storage']) }\n    : withDefaultsOmitted;\n  const withSortedKeys = sortObjectKeys(withSortedStorage) as Record<string, unknown>;\n  return orderTopLevel(withSortedKeys);\n}\n\nexport function canonicalizeContract(\n  contract: Contract,\n  options: CanonicalizeContractOptions,\n): string {\n  return JSON.stringify(canonicalizeContractToObject(contract, options), null, 2);\n}\n","import { createHash } from 'node:crypto';\nimport { ifDefined } from '@prisma-next/utils/defined';\nimport type { JsonObject } from '@prisma-next/utils/json';\nimport {\n  canonicalizeContract,\n  type PreserveEmptyPredicate,\n  type StorageSort,\n} from './canonicalization';\nimport type { Contract } from './contract-types';\nimport type { ExecutionHashBase, ProfileHashBase, StorageHashBase } from './types';\n\nconst SCHEMA_VERSION = '1';\n\nfunction sha256(content: string): string {\n  const hash = createHash('sha256');\n  hash.update(content);\n  return `sha256:${hash.digest('hex')}`;\n}\n\ntype HashContractSection = Record<string, unknown> & {\n  readonly shouldPreserveEmpty?: PreserveEmptyPredicate;\n  readonly sortStorage?: StorageSort;\n};\n\nfunction hashContract(section: HashContractSection): string {\n  const { shouldPreserveEmpty, sortStorage, ...sectionData } = section;\n  // Blind cast: the synthesised object is a hash-only stand-in\n  // — never returned to callers, never executed as a Contract.\n  // `canonicalizeContract` only walks the storage / execution /\n  // capabilities slices, all of which are populated above, so the\n  // missing precise Contract typing on the other slots is\n  // immaterial for the hash result.\n  const contract = {\n    targetFamily: sectionData['targetFamily'],\n    target: sectionData['target'],\n    roots: {},\n    models: {},\n    storage: sectionData['storage'] ?? {},\n    execution: sectionData['execution'],\n    extensionPacks: {},\n    capabilities: sectionData['capabilities'] ?? {},\n    meta: {},\n    profileHash: '',\n    ...sectionData,\n  } as unknown as Contract;\n  return canonicalizeContract(contract, {\n    schemaVersion: SCHEMA_VERSION,\n    serializeContract: (c) => JSON.parse(JSON.stringify(c)) as JsonObject,\n    ...ifDefined('shouldPreserveEmpty', shouldPreserveEmpty),\n    ...ifDefined('sortStorage', sortStorage),\n  });\n}\n\nexport type ComputeStorageHashArgs = {\n  target: string;\n  targetFamily: string;\n  storage: Record<string, unknown>;\n  readonly shouldPreserveEmpty?: PreserveEmptyPredicate;\n  readonly sortStorage?: StorageSort;\n};\n\nexport function computeStorageHash(args: ComputeStorageHashArgs): StorageHashBase<string> {\n  return sha256(hashContract(args)) as StorageHashBase<string>;\n}\n\nexport function computeExecutionHash(args: {\n  target: string;\n  targetFamily: string;\n  execution: Record<string, unknown>;\n}): ExecutionHashBase<string> {\n  return sha256(hashContract(args)) as ExecutionHashBase<string>;\n}\n\nexport function computeProfileHash(args: {\n  target: string;\n  targetFamily: string;\n  capabilities: Record<string, Record<string, boolean>>;\n}): ProfileHashBase<string> {\n  return sha256(hashContract(args)) as ProfileHashBase<string>;\n}\n"],"mappings":";;;;AAmCA,MAAM,kBAAkB;CACtB;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;AAEA,SAAS,eAAe,OAAyB;CAC/C,IAAI,UAAU,OAAO,OAAO;CAC5B,IAAI,UAAU,MAAM,OAAO;CAC3B,IAAI,MAAM,QAAQ,KAAK,KAAK,MAAM,WAAW,GAAG,OAAO;CACvD,IAAI,OAAO,UAAU,YAAY,UAAU,MAEzC,OADa,OAAO,KAAK,KACf,EAAE,WAAW;CAEzB,OAAO;AACT;AAEA,SAAS,aACP,KACA,MACA,qBACS;CACT,IAAI,QAAQ,QAAQ,OAAO,QAAQ,UACjC,OAAO;CAGT,IAAI,MAAM,QAAQ,GAAG,GACnB,OAAO,IAAI,KAAK,SAAS,aAAa,MAAM,MAAM,mBAAmB,CAAC;CAGxE,MAAM,SAAkC,CAAC;CAEzC,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,GAAG,GAAG;EAC9C,MAAM,cAAc,CAAC,GAAG,MAAM,GAAG;EAEjC,IAAI,QAAQ,cACV;EAGF,IAAI,QAAQ,eAAe,UAAU,OACnC;EAGF,KAAK,QAAQ,cAAc,QAAQ,eAAe,UAAU,YAC1D;EAGF,IAAI,eAAe,KAAK,GAAG;GACzB,MAAM,mBAAmB,aAAa,aAAa,CAAC,QAAQ,CAAC;GAC7D,MAAM,uBAAuB,aAAa,aAAa,CAAC,WAAW,YAAY,CAAC;GAChF,MAAM,kBACJ,YAAY,WAAW,KACvB,aAAa,CAAC,YAAY,IAAI,YAAY,EAAE,GAAG,CAAC,WAAW,YAAY,CAAC;GAC1E,MAAM,kBAAkB,aAAa,aAAa,CAAC,OAAO,CAAC;GAC3D,MAAM,2BAA2B,aAAa,aAAa,CAAC,gBAAgB,CAAC;GAC7E,MAAM,yBAAyB,aAAa,aAAa,CAAC,cAAc,CAAC;GACzE,MAAM,iBAAiB,aAAa,aAAa,CAAC,MAAM,CAAC;GACzD,MAAM,8BAA8B,aAAa,aAAa;IAC5D;IACA;IACA;GACF,CAAC;GACD,MAAM,uBAAuB,YAAY,WAAW,KAAK,YAAY,OAAO;GAC5E,MAAM,mBACJ,YAAY,WAAW,KACvB,aAAa,CAAC,YAAY,IAAI,YAAY,EAAE,GAAG,CAAC,UAAU,WAAW,CAAC;GACxE,MAAM,iBACJ,YAAY,WAAW,KACvB,aAAa,CAAC,YAAY,IAAI,YAAY,EAAE,GAAG,CAAC,UAAU,SAAS,CAAC;GAEtE,MAAM,4BACJ,YAAY,WAAW,KACvB,YAAY,OAAO,YACnB,YAAY,OAAO,WACnB,QAAQ;GAEV,MAAM,kBAAkB,QAAQ;GAEhC,MAAM,oBAAoB,sBAAsB,WAAW,KAAK;GAEhE,IACE,CAAC,oBACD,CAAC,wBACD,CAAC,mBACD,CAAC,mBACD,CAAC,4BACD,CAAC,0BACD,CAAC,kBACD,CAAC,+BACD,CAAC,wBACD,CAAC,oBACD,CAAC,kBACD,CAAC,mBACD,CAAC,6BACD,CAAC,mBAED;EAEJ;EAEA,OAAO,OAAO,aAAa,OAAO,aAAa,mBAAmB;CACpE;CAEA,OAAO;AACT;AAEA,SAAS,eAAe,KAAuB;CAC7C,IAAI,QAAQ,QAAQ,OAAO,QAAQ,UACjC,OAAO;CAGT,IAAI,MAAM,QAAQ,GAAG,GACnB,OAAO,IAAI,KAAK,SAAS,eAAe,IAAI,CAAC;CAG/C,MAAM,SAAkC,CAAC;CACzC,MAAM,OAAO,OAAO,KAAK,GAAG,EAAE,KAAK;CACnC,KAAK,MAAM,OAAO,MAChB,OAAO,OAAO,eAAgB,IAAgC,IAAI;CAGpE,OAAO;AACT;AAEA,SAAgB,cAAc,KAAuD;CACnF,MAAM,UAAmC,CAAC;CAC1C,MAAM,YAAY,IAAI,IAAI,OAAO,KAAK,GAAG,CAAC;CAE1C,KAAK,MAAM,OAAO,iBAChB,IAAI,UAAU,IAAI,GAAG,GAAG;EACtB,QAAQ,OAAO,IAAI;EACnB,UAAU,OAAO,GAAG;CACtB;CAGF,KAAK,MAAM,OAAO,MAAM,KAAK,SAAS,EAAE,KAAK,GAC3C,QAAQ,OAAO,IAAI;CAGrB,OAAO;AACT;;;;;;AAqCA,SAAgB,6BACd,UACA,SACyB;CACzB,MAAM,aAAa,QAAQ,kBAAkB,QAAQ;CAgBrD,MAAM,sBAAsB,aAAa;EAdvC,GAAG,UAAU,iBAAiB,QAAQ,aAAa;EACnD,cAAc,WAAW;EACzB,QAAQ,WAAW;EACnB,aAAa,WAAW;EACxB,OAAO,WAAW;EAClB,QAAQ,WAAW;EACnB,GAAG,UAAU,gBAAgB,WAAW,eAAe;EACvD,GAAG,UAAU,UAAU,WAAW,SAAS;EAC3C,SAAS,WAAW;EACpB,GAAG,UAAU,aAAa,WAAW,YAAY;EACjD,gBAAgB,WAAW;EAC3B,cAAc,WAAW;EACzB,MAAM,WAAW;CAE+B,GAAG,CAAC,GAAG,QAAQ,mBAAmB;CAQpF,OAAO,cADgB,eAHG,QAAQ,cAC9B;EAAE,GAAG;EAAqB,SAAS,QAAQ,YAAY,oBAAoB,UAAU;CAAE,IACvF,mBAE8B,CAAC;AACrC;AAEA,SAAgB,qBACd,UACA,SACQ;CACR,OAAO,KAAK,UAAU,6BAA6B,UAAU,OAAO,GAAG,MAAM,CAAC;AAChF;;;ACxPA,MAAM,iBAAiB;AAEvB,SAAS,OAAO,SAAyB;CACvC,MAAM,OAAO,WAAW,QAAQ;CAChC,KAAK,OAAO,OAAO;CACnB,OAAO,UAAU,KAAK,OAAO,KAAK;AACpC;AAOA,SAAS,aAAa,SAAsC;CAC1D,MAAM,EAAE,qBAAqB,aAAa,GAAG,gBAAgB;CAoB7D,OAAO,qBAAqB;EAZ1B,cAAc,YAAY;EAC1B,QAAQ,YAAY;EACpB,OAAO,CAAC;EACR,QAAQ,CAAC;EACT,SAAS,YAAY,cAAc,CAAC;EACpC,WAAW,YAAY;EACvB,gBAAgB,CAAC;EACjB,cAAc,YAAY,mBAAmB,CAAC;EAC9C,MAAM,CAAC;EACP,aAAa;EACb,GAAG;CAE8B,GAAG;EACpC,eAAe;EACf,oBAAoB,MAAM,KAAK,MAAM,KAAK,UAAU,CAAC,CAAC;EACtD,GAAG,UAAU,uBAAuB,mBAAmB;EACvD,GAAG,UAAU,eAAe,WAAW;CACzC,CAAC;AACH;AAUA,SAAgB,mBAAmB,MAAuD;CACxF,OAAO,OAAO,aAAa,IAAI,CAAC;AAClC;AAEA,SAAgB,qBAAqB,MAIP;CAC5B,OAAO,OAAO,aAAa,IAAI,CAAC;AAClC;AAEA,SAAgB,mBAAmB,MAIP;CAC1B,OAAO,OAAO,aAAa,IAAI,CAAC;AAClC"}

package/dist/hashing-utils.d.mts

@@ -0,0 +1,19 @@
+import { i as StorageSort, n as PreserveEmptyPredicate } from "./canonicalization-j__G4o7F.mjs";
+
+//#region src/canonicalization-path-match.d.ts
+type PathSegment = string | '*' | readonly string[];
+type PathPattern = readonly PathSegment[];
+declare function matchesPathPattern(path: readonly string[], pattern: PathPattern): boolean;
+declare function createPreserveEmptyPredicate(patterns: readonly PathPattern[]): PreserveEmptyPredicate;
+//#endregion
+//#region src/canonicalization-storage-sort.d.ts
+type PathSegment$1 = string | '*';
+interface NamedArraySortTarget {
+  readonly path: readonly PathSegment$1[];
+  readonly arrayKeys: readonly string[];
+}
+declare function compareByNameProperty(a: unknown, b: unknown): number;
+declare function createStorageSort(targets: readonly NamedArraySortTarget[], compare?: (a: unknown, b: unknown) => number): StorageSort;
+//#endregion
+export { type NamedArraySortTarget, type PathPattern, type PathSegment as PreserveEmptyPathSegment, type PathSegment$1 as StorageSortPathSegment, compareByNameProperty, createPreserveEmptyPredicate, createStorageSort, matchesPathPattern };
+//# sourceMappingURL=hashing-utils.d.mts.map

package/dist/hashing-utils.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hashing-utils.d.mts","names":[],"sources":["../src/canonicalization-path-match.ts","../src/canonicalization-storage-sort.ts"],"mappings":";;;KAEY,WAAA;AAAA,KAEA,WAAA,YAAuB,WAAW;AAAA,iBAE9B,kBAAA,CAAmB,IAAA,qBAAyB,OAAA,EAAS,WAAW;AAAA,iBAiChE,4BAAA,CACd,QAAA,WAAmB,WAAA,KAClB,sBAAsB;;;KCvCb,aAAA;AAAA,UAEK,oBAAA;EAAA,SACN,IAAA,WAAe,aAAW;EAAA,SAC1B,SAAA;AAAA;AAAA,iBAOK,qBAAA,CAAsB,CAAA,WAAY,CAAU;AAAA,iBA2D5C,iBAAA,CACd,OAAA,WAAkB,oBAAA,IAClB,OAAA,IAAU,CAAA,WAAY,CAAA,uBACrB,WAAW"}

package/dist/hashing-utils.mjs

@@ -0,0 +1,71 @@
+//#region src/canonicalization-path-match.ts
+function matchesPathPattern(path, pattern) {
+	if (path.length !== pattern.length) return false;
+	for (let i = 0; i < pattern.length; i++) {
+		const segment = pattern[i];
+		const value = path[i];
+		if (segment === void 0 || value === void 0) return false;
+		if (segment === "*") continue;
+		if (typeof segment === "string") {
+			if (value !== segment) return false;
+			continue;
+		}
+		if (Array.isArray(segment)) {
+			if (!segment.includes(value)) return false;
+		}
+	}
+	return true;
+}
+function createPreserveEmptyPredicate(patterns) {
+	return (path) => patterns.some((pattern) => matchesPathPattern(path, pattern));
+}
+//#endregion
+//#region src/canonicalization-storage-sort.ts
+function isPlainRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function compareByNameProperty(a, b) {
+	const nameA = isPlainRecord(a) && typeof a["name"] === "string" ? a["name"] : "";
+	const nameB = isPlainRecord(b) && typeof b["name"] === "string" ? b["name"] : "";
+	return nameA.localeCompare(nameB);
+}
+function sortArrayKeysOnRecord(record, arrayKeys, compare) {
+	const sorted = { ...record };
+	for (const key of arrayKeys) {
+		const value = record[key];
+		if (Array.isArray(value)) sorted[key] = [...value].sort(compare);
+	}
+	return sorted;
+}
+function walkAndSort(node, pathSegments, arrayKeys, compare) {
+	if (pathSegments.length === 0) {
+		if (!isPlainRecord(node)) return node;
+		return sortArrayKeysOnRecord(node, arrayKeys, compare);
+	}
+	if (!isPlainRecord(node)) return node;
+	const [head, ...rest] = pathSegments;
+	if (head === void 0) return node;
+	if (head === "*") {
+		const sorted = { ...node };
+		for (const key of Object.keys(node)) sorted[key] = walkAndSort(node[key], rest, arrayKeys, compare);
+		return sorted;
+	}
+	const child = node[head];
+	if (child === void 0) return node;
+	return {
+		...node,
+		[head]: walkAndSort(child, rest, arrayKeys, compare)
+	};
+}
+function createStorageSort(targets, compare = compareByNameProperty) {
+	return (storage) => {
+		if (!isPlainRecord(storage)) return storage;
+		let result = storage;
+		for (const target of targets) result = walkAndSort(result, target.path, target.arrayKeys, compare);
+		return result;
+	};
+}
+//#endregion
+export { compareByNameProperty, createPreserveEmptyPredicate, createStorageSort, matchesPathPattern };
+
+//# sourceMappingURL=hashing-utils.mjs.map

package/dist/hashing-utils.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"hashing-utils.mjs","names":[],"sources":["../src/canonicalization-path-match.ts","../src/canonicalization-storage-sort.ts"],"sourcesContent":["import type { PreserveEmptyPredicate } from './canonicalization';\n\nexport type PathSegment = string | '*' | readonly string[];\n\nexport type PathPattern = readonly PathSegment[];\n\nexport function matchesPathPattern(path: readonly string[], pattern: PathPattern): boolean {\n  if (path.length !== pattern.length) {\n    return false;\n  }\n\n  for (let i = 0; i < pattern.length; i++) {\n    const segment = pattern[i];\n    const value = path[i];\n    if (segment === undefined || value === undefined) {\n      return false;\n    }\n\n    if (segment === '*') {\n      continue;\n    }\n\n    if (typeof segment === 'string') {\n      if (value !== segment) {\n        return false;\n      }\n      continue;\n    }\n\n    if (Array.isArray(segment)) {\n      if (!segment.includes(value)) {\n        return false;\n      }\n    }\n  }\n\n  return true;\n}\n\nexport function createPreserveEmptyPredicate(\n  patterns: readonly PathPattern[],\n): PreserveEmptyPredicate {\n  return (path) => patterns.some((pattern) => matchesPathPattern(path, pattern));\n}\n","import type { StorageSort } from './canonicalization';\n\nexport type PathSegment = string | '*';\n\nexport interface NamedArraySortTarget {\n  readonly path: readonly PathSegment[];\n  readonly arrayKeys: readonly string[];\n}\n\nfunction isPlainRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nexport function compareByNameProperty(a: unknown, b: unknown): number {\n  const nameA = isPlainRecord(a) && typeof a['name'] === 'string' ? a['name'] : '';\n  const nameB = isPlainRecord(b) && typeof b['name'] === 'string' ? b['name'] : '';\n  return nameA.localeCompare(nameB);\n}\n\nfunction sortArrayKeysOnRecord(\n  record: Record<string, unknown>,\n  arrayKeys: readonly string[],\n  compare: (a: unknown, b: unknown) => number,\n): Record<string, unknown> {\n  const sorted: Record<string, unknown> = { ...record };\n  for (const key of arrayKeys) {\n    const value = record[key];\n    if (Array.isArray(value)) {\n      sorted[key] = [...value].sort(compare);\n    }\n  }\n  return sorted;\n}\n\nfunction walkAndSort(\n  node: unknown,\n  pathSegments: readonly PathSegment[],\n  arrayKeys: readonly string[],\n  compare: (a: unknown, b: unknown) => number,\n): unknown {\n  if (pathSegments.length === 0) {\n    if (!isPlainRecord(node)) {\n      return node;\n    }\n    return sortArrayKeysOnRecord(node, arrayKeys, compare);\n  }\n\n  if (!isPlainRecord(node)) {\n    return node;\n  }\n\n  const [head, ...rest] = pathSegments;\n  if (head === undefined) {\n    return node;\n  }\n\n  if (head === '*') {\n    const sorted: Record<string, unknown> = { ...node };\n    for (const key of Object.keys(node)) {\n      sorted[key] = walkAndSort(node[key], rest, arrayKeys, compare);\n    }\n    return sorted;\n  }\n\n  const child = node[head];\n  if (child === undefined) {\n    return node;\n  }\n\n  return { ...node, [head]: walkAndSort(child, rest, arrayKeys, compare) };\n}\n\nexport function createStorageSort(\n  targets: readonly NamedArraySortTarget[],\n  compare: (a: unknown, b: unknown) => number = compareByNameProperty,\n): StorageSort {\n  return (storage) => {\n    if (!isPlainRecord(storage)) {\n      return storage;\n    }\n\n    let result: unknown = storage;\n    for (const target of targets) {\n      result = walkAndSort(result, target.path, target.arrayKeys, compare);\n    }\n    return result;\n  };\n}\n"],"mappings":";AAMA,SAAgB,mBAAmB,MAAyB,SAA+B;CACzF,IAAI,KAAK,WAAW,QAAQ,QAC1B,OAAO;CAGT,KAAK,IAAI,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAAK;EACvC,MAAM,UAAU,QAAQ;EACxB,MAAM,QAAQ,KAAK;EACnB,IAAI,YAAY,KAAA,KAAa,UAAU,KAAA,GACrC,OAAO;EAGT,IAAI,YAAY,KACd;EAGF,IAAI,OAAO,YAAY,UAAU;GAC/B,IAAI,UAAU,SACZ,OAAO;GAET;EACF;EAEA,IAAI,MAAM,QAAQ,OAAO;OACnB,CAAC,QAAQ,SAAS,KAAK,GACzB,OAAO;EAAA;CAGb;CAEA,OAAO;AACT;AAEA,SAAgB,6BACd,UACwB;CACxB,QAAQ,SAAS,SAAS,MAAM,YAAY,mBAAmB,MAAM,OAAO,CAAC;AAC/E;;;AClCA,SAAS,cAAc,OAAkD;CACvE,OAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAC5E;AAEA,SAAgB,sBAAsB,GAAY,GAAoB;CACpE,MAAM,QAAQ,cAAc,CAAC,KAAK,OAAO,EAAE,YAAY,WAAW,EAAE,UAAU;CAC9E,MAAM,QAAQ,cAAc,CAAC,KAAK,OAAO,EAAE,YAAY,WAAW,EAAE,UAAU;CAC9E,OAAO,MAAM,cAAc,KAAK;AAClC;AAEA,SAAS,sBACP,QACA,WACA,SACyB;CACzB,MAAM,SAAkC,EAAE,GAAG,OAAO;CACpD,KAAK,MAAM,OAAO,WAAW;EAC3B,MAAM,QAAQ,OAAO;EACrB,IAAI,MAAM,QAAQ,KAAK,GACrB,OAAO,OAAO,CAAC,GAAG,KAAK,EAAE,KAAK,OAAO;CAEzC;CACA,OAAO;AACT;AAEA,SAAS,YACP,MACA,cACA,WACA,SACS;CACT,IAAI,aAAa,WAAW,GAAG;EAC7B,IAAI,CAAC,cAAc,IAAI,GACrB,OAAO;EAET,OAAO,sBAAsB,MAAM,WAAW,OAAO;CACvD;CAEA,IAAI,CAAC,cAAc,IAAI,GACrB,OAAO;CAGT,MAAM,CAAC,MAAM,GAAG,QAAQ;CACxB,IAAI,SAAS,KAAA,GACX,OAAO;CAGT,IAAI,SAAS,KAAK;EAChB,MAAM,SAAkC,EAAE,GAAG,KAAK;EAClD,KAAK,MAAM,OAAO,OAAO,KAAK,IAAI,GAChC,OAAO,OAAO,YAAY,KAAK,MAAM,MAAM,WAAW,OAAO;EAE/D,OAAO;CACT;CAEA,MAAM,QAAQ,KAAK;CACnB,IAAI,UAAU,KAAA,GACZ,OAAO;CAGT,OAAO;EAAE,GAAG;GAAO,OAAO,YAAY,OAAO,MAAM,WAAW,OAAO;CAAE;AACzE;AAEA,SAAgB,kBACd,SACA,UAA8C,uBACjC;CACb,QAAQ,YAAY;EAClB,IAAI,CAAC,cAAc,OAAO,GACxB,OAAO;EAGT,IAAI,SAAkB;EACtB,KAAK,MAAM,UAAU,SACnB,SAAS,YAAY,QAAQ,OAAO,MAAM,OAAO,WAAW,OAAO;EAErE,OAAO;CACT;AACF"}

package/dist/hashing.d.mts

@@ -1,44 +1,15 @@
-import { S as ProfileHashBase, T as StorageHashBase, d as ExecutionHashBase, t as Contract } from "./contract-types-OSHtK6P5.mjs";
-import { JsonObject } from "@prisma-next/utils/json";
+import { S as ProfileHashBase, T as StorageHashBase, d as ExecutionHashBase } from "./contract-types-OSHtK6P5.mjs";
+import { a as canonicalizeContract, i as StorageSort, n as PreserveEmptyPredicate, o as canonicalizeContractToObject, r as SerializeContract, t as CanonicalizeContractOptions } from "./canonicalization-j__G4o7F.mjs";
 
-//#region src/canonicalization.d.ts
-/**
- * Per-target contract serializer hook. The framework canonicalizer uses
- * this to convert an in-memory contract (which may carry class-instance
- * IR nodes whose runtime-only fields must not appear in the on-disk
- * envelope) into a plain JsonObject before applying the family-agnostic
- * canonical-key ordering / default-omission / sort steps. Targets whose
- * contract is JSON-clean by construction return the contract unchanged.
- */
-type SerializeContract = (contract: Contract) => JsonObject;
-interface CanonicalizeContractOptions {
-  readonly schemaVersion?: string;
-  /**
-   * Per-target hook that converts the in-memory contract (which may
-   * carry class-instance IR nodes) into a plain JsonObject before the
-   * family-agnostic canonicalization steps run.
-   *
-   * Routing through the hook is what lets each target decide which
-   * fields appear in the on-disk envelope; runtime-only class API
-   * fields stay invisible to the canonicalization walk by virtue of
-   * the per-target serializer not putting them in the JSON shape.
-   */
-  readonly serializeContract: SerializeContract;
-}
-/**
- * Object-form variant of {@link canonicalizeContract}. Exported because the
- * emitter writes the canonical contract through a separate JSON-stringify
- * pass and consumes the structured object directly.
- */
-declare function canonicalizeContractToObject(contract: Contract, options: CanonicalizeContractOptions): Record<string, unknown>;
-declare function canonicalizeContract(contract: Contract, options: CanonicalizeContractOptions): string;
-//#endregion
 //#region src/hashing.d.ts
-declare function computeStorageHash(args: {
+type ComputeStorageHashArgs = {
   target: string;
   targetFamily: string;
   storage: Record<string, unknown>;
-}): StorageHashBase<string>;
+  readonly shouldPreserveEmpty?: PreserveEmptyPredicate;
+  readonly sortStorage?: StorageSort;
+};
+declare function computeStorageHash(args: ComputeStorageHashArgs): StorageHashBase<string>;
 declare function computeExecutionHash(args: {
   target: string;
   targetFamily: string;
@@ -50,5 +21,5 @@ declare function computeProfileHash(args: {
   capabilities: Record<string, Record<string, boolean>>;
 }): ProfileHashBase<string>;
 //#endregion
-export { type CanonicalizeContractOptions, type SerializeContract, canonicalizeContract, canonicalizeContractToObject, computeExecutionHash, computeProfileHash, computeStorageHash };
+export { type CanonicalizeContractOptions, type PreserveEmptyPredicate, type SerializeContract, type StorageSort, canonicalizeContract, canonicalizeContractToObject, computeExecutionHash, computeProfileHash, computeStorageHash };
 //# sourceMappingURL=hashing.d.mts.map

package/dist/hashing.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"hashing.d.mts","names":[],"sources":["../src/canonicalization.ts","../src/hashing.ts"],"mappings":";;;;;;AAcA;;;;;;KAAY,iBAAA,IAAqB,QAAA,EAAU,QAAA,KAAa,UAAU;AAAA,UA8RjD,2BAAA;EAAA,SACN,aAAA;EADiC;;;;;;;AAYG;AAQ/C;;EApB4C,SAYjC,iBAAA,EAAmB,iBAAiB;AAAA;;;;;;iBAQ/B,4BAAA,CACd,QAAA,EAAU,QAAA,EACV,OAAA,EAAS,2BAAA,GACR,MAAA;AAAA,iBAwBa,oBAAA,CACd,QAAA,EAAU,QAAA,EACV,OAAA,EAAS,2BAA2B;;;iBCrTtB,kBAAA,CAAmB,IAAA;EACjC,MAAA;EACA,YAAA;EACA,OAAA,EAAS,MAAA;AAAA,IACP,eAAe;AAAA,iBAIH,oBAAA,CAAqB,IAAA;EACnC,MAAA;EACA,YAAA;EACA,SAAA,EAAW,MAAA;AAAA,IACT,iBAAiB;AAAA,iBAIL,kBAAA,CAAmB,IAAA;EACjC,MAAA;EACA,YAAA;EACA,YAAA,EAAc,MAAA,SAAe,MAAA;AAAA,IAC3B,eAAA"}
+{"version":3,"file":"hashing.d.mts","names":[],"sources":["../src/hashing.ts"],"mappings":";;;;KAqDY,sBAAA;EACV,MAAA;EACA,YAAA;EACA,OAAA,EAAS,MAAA;EAAA,SACA,mBAAA,GAAsB,sBAAA;EAAA,SACtB,WAAA,GAAc,WAAA;AAAA;AAAA,iBAGT,kBAAA,CAAmB,IAAA,EAAM,sBAAA,GAAyB,eAAe;AAAA,iBAIjE,oBAAA,CAAqB,IAAA;EACnC,MAAA;EACA,YAAA;EACA,SAAA,EAAW,MAAA;AAAA,IACT,iBAAiB;AAAA,iBAIL,kBAAA,CAAmB,IAAA;EACjC,MAAA;EACA,YAAA;EACA,YAAA,EAAc,MAAA,SAAe,MAAA;AAAA,IAC3B,eAAA"}

package/dist/hashing.mjs

@@ -1,2 +1,2 @@
-import { a as canonicalizeContractToObject, i as canonicalizeContract, n as computeProfileHash, r as computeStorageHash, t as computeExecutionHash } from "./hashing-BqnADuDo.mjs";
+import { a as canonicalizeContractToObject, i as canonicalizeContract, n as computeProfileHash, r as computeStorageHash, t as computeExecutionHash } from "./hashing-C25nwocN.mjs";
 export { canonicalizeContract, canonicalizeContractToObject, computeExecutionHash, computeProfileHash, computeStorageHash };

package/dist/testing.d.mts

@@ -1,5 +1,6 @@
 import { t as CrossReference } from "./cross-reference-t0TDbBTP.mjs";
 import { I as ContractModel, L as ContractModelBase, S as ProfileHashBase, T as StorageHashBase, V as ContractValueObject, W as ModelStorageBase, h as ExecutionSection, t as Contract, w as StorageBase } from "./contract-types-OSHtK6P5.mjs";
+import { i as StorageSort, n as PreserveEmptyPredicate } from "./canonicalization-j__G4o7F.mjs";
 
 //#region src/testing-factories.d.ts
 type ContractOverrides<TStorage extends StorageBase = StorageBase, TModels extends Record<string, ContractModelBase> = Record<string, ContractModel>> = {
@@ -14,6 +15,8 @@ type ContractOverrides<TStorage extends StorageBase = StorageBase, TModels exten
   execution?: Omit<ExecutionSection, 'executionHash'>;
   profileHash?: ProfileHashBase<string>;
   meta?: Record<string, unknown>;
+  shouldPreserveEmpty?: PreserveEmptyPredicate;
+  sortStorage?: StorageSort;
 };
 declare const DUMMY_HASH: StorageHashBase<"sha256:test">;
 declare function createContract<TStorage extends StorageBase = StorageBase, TModels extends Record<string, ContractModelBase> = Record<string, ContractModel>>(overrides?: ContractOverrides<TStorage, TModels>): Contract<TStorage, TModels>;

package/dist/testing.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"testing.d.mts","names":[],"sources":["../src/testing-factories.ts"],"mappings":";;;;KAaK,iBAAA,kBACc,WAAA,GAAc,WAAA,kBACf,MAAA,SAAe,iBAAA,IAAqB,MAAA,SAAe,aAAA;EAEnE,MAAA;EACA,YAAA;EACA,KAAA,GAAQ,MAAA,SAAe,cAAA;EACvB,MAAA,GAAS,OAAA;EACT,OAAA,GAAU,IAAA,CAAK,QAAA;EACf,YAAA,GAAe,MAAA,SAAe,mBAAA;EAC9B,YAAA,GAAe,MAAA,SAAe,MAAA;EAC9B,cAAA,GAAiB,MAAA;EACjB,SAAA,GAAY,IAAA,CAAK,gBAAA;EACjB,WAAA,GAAc,eAAA;EACd,IAAA,GAAO,MAAA;AAAA;AAAA,cAGH,UAAA,EAAoC,eAA1B;AAAA,iBAeA,cAAA,kBACG,WAAA,GAAc,WAAA,kBACf,MAAA,SAAe,iBAAA,IAAqB,MAAA,SAAe,aAAA,EAAA,CACnE,SAAA,GAAW,iBAAA,CAAkB,QAAA,EAAU,OAAA,IAAgB,QAAA,CAAS,QAAA,EAAU,OAAA;AAAA,KA+CvE,cAAA,GAAiB,WAAA;EAAA,SACX,UAAA,EAAY,QAAA,CACnB,MAAA;IAAA,SAA0B,EAAA;IAAA,SAAqB,MAAA,EAAQ,QAAA,CAAS,MAAA;EAAA;EAAA,SAEzD,KAAA,GAAQ,MAAA;AAAA;AAAA,KAGd,YAAA,GAAe,aAAa,CAAC,gBAAA;EAAqB,KAAA;AAAA;AAAA,iBAEvC,iBAAA,CACd,SAAA,GAAW,iBAAA,CAAkB,cAAA,EAAgB,MAAA,SAAe,YAAA,KAC3D,QAAA,CAAS,cAAA,EAAgB,MAAA,SAAe,YAAA"}
+{"version":3,"file":"testing.d.mts","names":[],"sources":["../src/testing-factories.ts"],"mappings":";;;;;KAcK,iBAAA,kBACc,WAAA,GAAc,WAAA,kBACf,MAAA,SAAe,iBAAA,IAAqB,MAAA,SAAe,aAAA;EAEnE,MAAA;EACA,YAAA;EACA,KAAA,GAAQ,MAAA,SAAe,cAAA;EACvB,MAAA,GAAS,OAAA;EACT,OAAA,GAAU,IAAA,CAAK,QAAA;EACf,YAAA,GAAe,MAAA,SAAe,mBAAA;EAC9B,YAAA,GAAe,MAAA,SAAe,MAAA;EAC9B,cAAA,GAAiB,MAAA;EACjB,SAAA,GAAY,IAAA,CAAK,gBAAA;EACjB,WAAA,GAAc,eAAA;EACd,IAAA,GAAO,MAAA;EACP,mBAAA,GAAsB,sBAAA;EACtB,WAAA,GAAc,WAAA;AAAA;AAAA,cAGV,UAAA,EAAoC,eAA1B;AAAA,iBAeA,cAAA,kBACG,WAAA,GAAc,WAAA,kBACf,MAAA,SAAe,iBAAA,IAAqB,MAAA,SAAe,aAAA,EAAA,CACnE,SAAA,GAAW,iBAAA,CAAkB,QAAA,EAAU,OAAA,IAAgB,QAAA,CAAS,QAAA,EAAU,OAAA;AAAA,KAiDvE,cAAA,GAAiB,WAAA;EAAA,SACX,UAAA,EAAY,QAAA,CACnB,MAAA;IAAA,SAA0B,EAAA;IAAA,SAAqB,MAAA,EAAQ,QAAA,CAAS,MAAA;EAAA;EAAA,SAEzD,KAAA,GAAQ,MAAA;AAAA;AAAA,KAGd,YAAA,GAAe,aAAa,CAAC,gBAAA;EAAqB,KAAA;AAAA;AAAA,iBAEvC,iBAAA,CACd,SAAA,GAAW,iBAAA,CAAkB,cAAA,EAAgB,MAAA,SAAe,YAAA,KAC3D,QAAA,CAAS,cAAA,EAAgB,MAAA,SAAe,YAAA"}

package/dist/testing.mjs

@@ -1,5 +1,5 @@
 import { t as coreHash } from "./types-CVGwkRLa.mjs";
-import { n as computeProfileHash, r as computeStorageHash, t as computeExecutionHash } from "./hashing-BqnADuDo.mjs";
+import { n as computeProfileHash, r as computeStorageHash, t as computeExecutionHash } from "./hashing-C25nwocN.mjs";
 import { ifDefined } from "@prisma-next/utils/defined";
 //#region src/testing-factories.ts
 const DUMMY_HASH = coreHash("sha256:test");
@@ -17,7 +17,9 @@ function createContract(overrides = {}) {
 	const storageHash = computeStorageHash({
 		target,
 		targetFamily,
-		storage: rawStorage
+		storage: rawStorage,
+		...ifDefined("shouldPreserveEmpty", overrides.shouldPreserveEmpty),
+		...ifDefined("sortStorage", overrides.sortStorage)
 	});
 	const storage = {
 		...rawStorage,

package/dist/testing.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"testing.mjs","names":[],"sources":["../src/testing-factories.ts"],"sourcesContent":["import { ifDefined } from '@prisma-next/utils/defined';\nimport type { Contract } from './contract-types';\nimport type { CrossReference } from './cross-reference';\nimport type {\n  ContractModel,\n  ContractModelBase,\n  ContractValueObject,\n  ModelStorageBase,\n} from './domain-types';\nimport { computeExecutionHash, computeProfileHash, computeStorageHash } from './hashing';\nimport type { ExecutionSection, ProfileHashBase, StorageBase } from './types';\nimport { coreHash } from './types';\n\ntype ContractOverrides<\n  TStorage extends StorageBase = StorageBase,\n  TModels extends Record<string, ContractModelBase> = Record<string, ContractModel>,\n> = {\n  target?: string;\n  targetFamily?: string;\n  roots?: Record<string, CrossReference>;\n  models?: TModels;\n  storage?: Omit<TStorage, 'storageHash'>;\n  valueObjects?: Record<string, ContractValueObject>;\n  capabilities?: Record<string, Record<string, boolean>>;\n  extensionPacks?: Record<string, unknown>;\n  execution?: Omit<ExecutionSection, 'executionHash'>;\n  profileHash?: ProfileHashBase<string>;\n  meta?: Record<string, unknown>;\n};\n\nconst DUMMY_HASH = coreHash('sha256:test');\n\nconst DEFAULT_FRAMEWORK_STORAGE = { namespaces: {} } as const;\n\nconst UNBOUND_NAMESPACE_ID = '__unbound__' as const;\n\nconst DEFAULT_SQL_STORAGE = {\n  namespaces: {\n    [UNBOUND_NAMESPACE_ID]: {\n      id: UNBOUND_NAMESPACE_ID,\n      tables: {},\n    },\n  },\n} as const;\n\nexport function createContract<\n  TStorage extends StorageBase = StorageBase,\n  TModels extends Record<string, ContractModelBase> = Record<string, ContractModel>,\n>(overrides: ContractOverrides<TStorage, TModels> = {}): Contract<TStorage, TModels> {\n  const target = overrides.target ?? 'postgres';\n  const targetFamily = overrides.targetFamily ?? 'sql';\n  const capabilities = overrides.capabilities ?? {};\n\n  const rawStorage = overrides.storage ?? DEFAULT_FRAMEWORK_STORAGE;\n\n  const storageHash = computeStorageHash({\n    target,\n    targetFamily,\n    storage: rawStorage as Record<string, unknown>,\n  });\n\n  const storage = {\n    ...rawStorage,\n    storageHash,\n  } as TStorage;\n\n  const computedProfileHash =\n    overrides.profileHash ?? computeProfileHash({ target, targetFamily, capabilities });\n\n  return {\n    target,\n    targetFamily,\n    roots: overrides.roots ?? {},\n    models: (overrides.models ?? {}) as TModels,\n    ...ifDefined('valueObjects', overrides.valueObjects),\n    storage,\n    capabilities,\n    extensionPacks: overrides.extensionPacks ?? {},\n    ...(overrides.execution !== undefined\n      ? {\n          execution: {\n            ...overrides.execution,\n            executionHash: computeExecutionHash({\n              target,\n              targetFamily,\n              execution: overrides.execution,\n            }),\n          },\n        }\n      : {}),\n    profileHash: computedProfileHash,\n    meta: overrides.meta ?? {},\n  };\n}\n\ntype SqlStorageLike = StorageBase & {\n  readonly namespaces: Readonly<\n    Record<string, { readonly id: string; readonly tables: Readonly<Record<string, unknown>> }>\n  >;\n  readonly types?: Record<string, unknown>;\n};\n\ntype SqlModelLike = ContractModel<ModelStorageBase & { table: string }>;\n\nexport function createSqlContract(\n  overrides: ContractOverrides<SqlStorageLike, Record<string, SqlModelLike>> = {},\n): Contract<SqlStorageLike, Record<string, SqlModelLike>> {\n  return createContract<SqlStorageLike, Record<string, SqlModelLike>>({\n    ...overrides,\n    target: overrides.target ?? 'postgres',\n    targetFamily: overrides.targetFamily ?? 'sql',\n    storage: overrides.storage ?? DEFAULT_SQL_STORAGE,\n  });\n}\n\nexport { DUMMY_HASH };\n"],"mappings":";;;;AA8BA,MAAM,aAAa,SAAS,aAAa;AAEzC,MAAM,4BAA4B,EAAE,YAAY,CAAC,EAAE;AAEnD,MAAM,uBAAuB;AAE7B,MAAM,sBAAsB,EAC1B,YAAY,GACT,uBAAuB;CACtB,IAAI;CACJ,QAAQ,CAAC;AACX,EACF,EACF;AAEA,SAAgB,eAGd,YAAkD,CAAC,GAAgC;CACnF,MAAM,SAAS,UAAU,UAAU;CACnC,MAAM,eAAe,UAAU,gBAAgB;CAC/C,MAAM,eAAe,UAAU,gBAAgB,CAAC;CAEhD,MAAM,aAAa,UAAU,WAAW;CAExC,MAAM,cAAc,mBAAmB;EACrC;EACA;EACA,SAAS;CACX,CAAC;CAED,MAAM,UAAU;EACd,GAAG;EACH;CACF;CAEA,MAAM,sBACJ,UAAU,eAAe,mBAAmB;EAAE;EAAQ;EAAc;CAAa,CAAC;CAEpF,OAAO;EACL;EACA;EACA,OAAO,UAAU,SAAS,CAAC;EAC3B,QAAS,UAAU,UAAU,CAAC;EAC9B,GAAG,UAAU,gBAAgB,UAAU,YAAY;EACnD;EACA;EACA,gBAAgB,UAAU,kBAAkB,CAAC;EAC7C,GAAI,UAAU,cAAc,KAAA,IACxB,EACE,WAAW;GACT,GAAG,UAAU;GACb,eAAe,qBAAqB;IAClC;IACA;IACA,WAAW,UAAU;GACvB,CAAC;EACH,EACF,IACA,CAAC;EACL,aAAa;EACb,MAAM,UAAU,QAAQ,CAAC;CAC3B;AACF;AAWA,SAAgB,kBACd,YAA6E,CAAC,GACtB;CACxD,OAAO,eAA6D;EAClE,GAAG;EACH,QAAQ,UAAU,UAAU;EAC5B,cAAc,UAAU,gBAAgB;EACxC,SAAS,UAAU,WAAW;CAChC,CAAC;AACH"}
+{"version":3,"file":"testing.mjs","names":[],"sources":["../src/testing-factories.ts"],"sourcesContent":["import { ifDefined } from '@prisma-next/utils/defined';\nimport type { PreserveEmptyPredicate, StorageSort } from './canonicalization';\nimport type { Contract } from './contract-types';\nimport type { CrossReference } from './cross-reference';\nimport type {\n  ContractModel,\n  ContractModelBase,\n  ContractValueObject,\n  ModelStorageBase,\n} from './domain-types';\nimport { computeExecutionHash, computeProfileHash, computeStorageHash } from './hashing';\nimport type { ExecutionSection, ProfileHashBase, StorageBase } from './types';\nimport { coreHash } from './types';\n\ntype ContractOverrides<\n  TStorage extends StorageBase = StorageBase,\n  TModels extends Record<string, ContractModelBase> = Record<string, ContractModel>,\n> = {\n  target?: string;\n  targetFamily?: string;\n  roots?: Record<string, CrossReference>;\n  models?: TModels;\n  storage?: Omit<TStorage, 'storageHash'>;\n  valueObjects?: Record<string, ContractValueObject>;\n  capabilities?: Record<string, Record<string, boolean>>;\n  extensionPacks?: Record<string, unknown>;\n  execution?: Omit<ExecutionSection, 'executionHash'>;\n  profileHash?: ProfileHashBase<string>;\n  meta?: Record<string, unknown>;\n  shouldPreserveEmpty?: PreserveEmptyPredicate;\n  sortStorage?: StorageSort;\n};\n\nconst DUMMY_HASH = coreHash('sha256:test');\n\nconst DEFAULT_FRAMEWORK_STORAGE = { namespaces: {} } as const;\n\nconst UNBOUND_NAMESPACE_ID = '__unbound__' as const;\n\nconst DEFAULT_SQL_STORAGE = {\n  namespaces: {\n    [UNBOUND_NAMESPACE_ID]: {\n      id: UNBOUND_NAMESPACE_ID,\n      tables: {},\n    },\n  },\n} as const;\n\nexport function createContract<\n  TStorage extends StorageBase = StorageBase,\n  TModels extends Record<string, ContractModelBase> = Record<string, ContractModel>,\n>(overrides: ContractOverrides<TStorage, TModels> = {}): Contract<TStorage, TModels> {\n  const target = overrides.target ?? 'postgres';\n  const targetFamily = overrides.targetFamily ?? 'sql';\n  const capabilities = overrides.capabilities ?? {};\n\n  const rawStorage = overrides.storage ?? DEFAULT_FRAMEWORK_STORAGE;\n\n  const storageHash = computeStorageHash({\n    target,\n    targetFamily,\n    storage: rawStorage as Record<string, unknown>,\n    ...ifDefined('shouldPreserveEmpty', overrides.shouldPreserveEmpty),\n    ...ifDefined('sortStorage', overrides.sortStorage),\n  });\n\n  const storage = {\n    ...rawStorage,\n    storageHash,\n  } as TStorage;\n\n  const computedProfileHash =\n    overrides.profileHash ?? computeProfileHash({ target, targetFamily, capabilities });\n\n  return {\n    target,\n    targetFamily,\n    roots: overrides.roots ?? {},\n    models: (overrides.models ?? {}) as TModels,\n    ...ifDefined('valueObjects', overrides.valueObjects),\n    storage,\n    capabilities,\n    extensionPacks: overrides.extensionPacks ?? {},\n    ...(overrides.execution !== undefined\n      ? {\n          execution: {\n            ...overrides.execution,\n            executionHash: computeExecutionHash({\n              target,\n              targetFamily,\n              execution: overrides.execution,\n            }),\n          },\n        }\n      : {}),\n    profileHash: computedProfileHash,\n    meta: overrides.meta ?? {},\n  };\n}\n\ntype SqlStorageLike = StorageBase & {\n  readonly namespaces: Readonly<\n    Record<string, { readonly id: string; readonly tables: Readonly<Record<string, unknown>> }>\n  >;\n  readonly types?: Record<string, unknown>;\n};\n\ntype SqlModelLike = ContractModel<ModelStorageBase & { table: string }>;\n\nexport function createSqlContract(\n  overrides: ContractOverrides<SqlStorageLike, Record<string, SqlModelLike>> = {},\n): Contract<SqlStorageLike, Record<string, SqlModelLike>> {\n  return createContract<SqlStorageLike, Record<string, SqlModelLike>>({\n    ...overrides,\n    target: overrides.target ?? 'postgres',\n    targetFamily: overrides.targetFamily ?? 'sql',\n    storage: overrides.storage ?? DEFAULT_SQL_STORAGE,\n  });\n}\n\nexport { DUMMY_HASH };\n"],"mappings":";;;;AAiCA,MAAM,aAAa,SAAS,aAAa;AAEzC,MAAM,4BAA4B,EAAE,YAAY,CAAC,EAAE;AAEnD,MAAM,uBAAuB;AAE7B,MAAM,sBAAsB,EAC1B,YAAY,GACT,uBAAuB;CACtB,IAAI;CACJ,QAAQ,CAAC;AACX,EACF,EACF;AAEA,SAAgB,eAGd,YAAkD,CAAC,GAAgC;CACnF,MAAM,SAAS,UAAU,UAAU;CACnC,MAAM,eAAe,UAAU,gBAAgB;CAC/C,MAAM,eAAe,UAAU,gBAAgB,CAAC;CAEhD,MAAM,aAAa,UAAU,WAAW;CAExC,MAAM,cAAc,mBAAmB;EACrC;EACA;EACA,SAAS;EACT,GAAG,UAAU,uBAAuB,UAAU,mBAAmB;EACjE,GAAG,UAAU,eAAe,UAAU,WAAW;CACnD,CAAC;CAED,MAAM,UAAU;EACd,GAAG;EACH;CACF;CAEA,MAAM,sBACJ,UAAU,eAAe,mBAAmB;EAAE;EAAQ;EAAc;CAAa,CAAC;CAEpF,OAAO;EACL;EACA;EACA,OAAO,UAAU,SAAS,CAAC;EAC3B,QAAS,UAAU,UAAU,CAAC;EAC9B,GAAG,UAAU,gBAAgB,UAAU,YAAY;EACnD;EACA;EACA,gBAAgB,UAAU,kBAAkB,CAAC;EAC7C,GAAI,UAAU,cAAc,KAAA,IACxB,EACE,WAAW;GACT,GAAG,UAAU;GACb,eAAe,qBAAqB;IAClC;IACA;IACA,WAAW,UAAU;GACvB,CAAC;EACH,EACF,IACA,CAAC;EACL,aAAa;EACb,MAAM,UAAU,QAAQ,CAAC;CAC3B;AACF;AAWA,SAAgB,kBACd,YAA6E,CAAC,GACtB;CACxD,OAAO,eAA6D;EAClE,GAAG;EACH,QAAQ,UAAU,UAAU;EAC5B,cAAc,UAAU,gBAAgB;EACxC,SAAS,UAAU,WAAW;CAChC,CAAC;AACH"}

package/package.json

@@ -1,19 +1,19 @@
 {
   "name": "@prisma-next/contract",
-  "version": "0.11.0-dev.49",
+  "version": "0.11.0-dev.50",
   "license": "Apache-2.0",
   "type": "module",
   "sideEffects": false,
   "description": "Data contract type definitions and JSON schema for Prisma Next",
   "dependencies": {
-    "@prisma-next/utils": "0.11.0-dev.49",
+    "@prisma-next/utils": "0.11.0-dev.50",
     "@standard-schema/spec": "^1.1.0",
     "arktype": "^2.2.0"
   },
   "devDependencies": {
-    "@prisma-next/test-utils": "0.11.0-dev.49",
-    "@prisma-next/tsconfig": "0.11.0-dev.49",
-    "@prisma-next/tsdown": "0.11.0-dev.49",
+    "@prisma-next/test-utils": "0.11.0-dev.50",
+    "@prisma-next/tsconfig": "0.11.0-dev.50",
+    "@prisma-next/tsdown": "0.11.0-dev.50",
     "tsdown": "0.22.0",
     "typescript": "5.9.3",
     "vitest": "4.1.6"
@@ -29,6 +29,7 @@
   "exports": {
     "./contract-validation-error": "./dist/contract-validation-error.mjs",
     "./hashing": "./dist/hashing.mjs",
+    "./hashing-utils": "./dist/hashing-utils.mjs",
     "./testing": "./dist/testing.mjs",
     "./types": "./dist/types.mjs",
     "./validate-domain": "./dist/validate-domain.mjs",

package/src/canonicalization-path-match.ts

@@ -0,0 +1,44 @@
+import type { PreserveEmptyPredicate } from './canonicalization';
+
+export type PathSegment = string | '*' | readonly string[];
+
+export type PathPattern = readonly PathSegment[];
+
+export function matchesPathPattern(path: readonly string[], pattern: PathPattern): boolean {
+  if (path.length !== pattern.length) {
+    return false;
+  }
+
+  for (let i = 0; i < pattern.length; i++) {
+    const segment = pattern[i];
+    const value = path[i];
+    if (segment === undefined || value === undefined) {
+      return false;
+    }
+
+    if (segment === '*') {
+      continue;
+    }
+
+    if (typeof segment === 'string') {
+      if (value !== segment) {
+        return false;
+      }
+      continue;
+    }
+
+    if (Array.isArray(segment)) {
+      if (!segment.includes(value)) {
+        return false;
+      }
+    }
+  }
+
+  return true;
+}
+
+export function createPreserveEmptyPredicate(
+  patterns: readonly PathPattern[],
+): PreserveEmptyPredicate {
+  return (path) => patterns.some((pattern) => matchesPathPattern(path, pattern));
+}

package/src/canonicalization-storage-sort.ts

@@ -0,0 +1,88 @@
+import type { StorageSort } from './canonicalization';
+
+export type PathSegment = string | '*';
+
+export interface NamedArraySortTarget {
+  readonly path: readonly PathSegment[];
+  readonly arrayKeys: readonly string[];
+}
+
+function isPlainRecord(value: unknown): value is Record<string, unknown> {
+  return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+
+export function compareByNameProperty(a: unknown, b: unknown): number {
+  const nameA = isPlainRecord(a) && typeof a['name'] === 'string' ? a['name'] : '';
+  const nameB = isPlainRecord(b) && typeof b['name'] === 'string' ? b['name'] : '';
+  return nameA.localeCompare(nameB);
+}
+
+function sortArrayKeysOnRecord(
+  record: Record<string, unknown>,
+  arrayKeys: readonly string[],
+  compare: (a: unknown, b: unknown) => number,
+): Record<string, unknown> {
+  const sorted: Record<string, unknown> = { ...record };
+  for (const key of arrayKeys) {
+    const value = record[key];
+    if (Array.isArray(value)) {
+      sorted[key] = [...value].sort(compare);
+    }
+  }
+  return sorted;
+}
+
+function walkAndSort(
+  node: unknown,
+  pathSegments: readonly PathSegment[],
+  arrayKeys: readonly string[],
+  compare: (a: unknown, b: unknown) => number,
+): unknown {
+  if (pathSegments.length === 0) {
+    if (!isPlainRecord(node)) {
+      return node;
+    }
+    return sortArrayKeysOnRecord(node, arrayKeys, compare);
+  }
+
+  if (!isPlainRecord(node)) {
+    return node;
+  }
+
+  const [head, ...rest] = pathSegments;
+  if (head === undefined) {
+    return node;
+  }
+
+  if (head === '*') {
+    const sorted: Record<string, unknown> = { ...node };
+    for (const key of Object.keys(node)) {
+      sorted[key] = walkAndSort(node[key], rest, arrayKeys, compare);
+    }
+    return sorted;
+  }
+
+  const child = node[head];
+  if (child === undefined) {
+    return node;
+  }
+
+  return { ...node, [head]: walkAndSort(child, rest, arrayKeys, compare) };
+}
+
+export function createStorageSort(
+  targets: readonly NamedArraySortTarget[],
+  compare: (a: unknown, b: unknown) => number = compareByNameProperty,
+): StorageSort {
+  return (storage) => {
+    if (!isPlainRecord(storage)) {
+      return storage;
+    }
+
+    let result: unknown = storage;
+    for (const target of targets) {
+      result = walkAndSort(result, target.path, target.arrayKeys, compare);
+    }
+    return result;
+  };
+}

package/src/canonicalization.ts

@@ -14,6 +14,25 @@ import type { Contract } from './contract-types';
  */
 export type SerializeContract = (contract: Contract) => JsonObject;
 
+/**
+ * Family-contributed predicate for the default-omission walk. Called when
+ * a value at `path` is a default (empty object/array or `false`); if this
+ * returns `true` the value is kept rather than stripped.
+ *
+ * The framework only calls the predicate inside the `isDefaultValue` branch,
+ * so there is no need to guard against non-default values.
+ */
+export type PreserveEmptyPredicate = (path: readonly string[]) => boolean;
+
+/**
+ * Family-contributed storage sort. Applied to the serialized `storage`
+ * subtree after the default-omission walk; the result replaces the
+ * `storage` field before the final key sort. Use to establish a
+ * deterministic order for storage arrays (indexes, uniques) that the
+ * family-agnostic `sortObjectKeys` pass cannot handle.
+ */
+export type StorageSort = (storage: unknown) => unknown;
+
 const TOP_LEVEL_ORDER = [
   'schemaVersion',
   'canonicalVersion',
@@ -42,13 +61,17 @@ function isDefaultValue(value: unknown): boolean {
   return false;
 }
 
-function omitDefaults(obj: unknown, path: readonly string[]): unknown {
+function omitDefaults(
+  obj: unknown,
+  path: readonly string[],
+  shouldPreserveEmpty: PreserveEmptyPredicate | undefined,
+): unknown {
   if (obj === null || typeof obj !== 'object') {
     return obj;
   }
 
   if (Array.isArray(obj)) {
-    return obj.map((item) => omitDefaults(item, path));
+    return obj.map((item) => omitDefaults(item, path, shouldPreserveEmpty));
   }
 
   const result: Record<string, unknown> = {};
@@ -74,20 +97,6 @@ function omitDefaults(obj: unknown, path: readonly string[]): unknown {
       const isNamespaceSlot =
         currentPath.length === 3 &&
         isArrayEqual([currentPath[0], currentPath[1]], ['storage', 'namespaces']);
-      const isRequiredNamespaceTables =
-        currentPath.length === 4 &&
-        currentPath[0] === 'storage' &&
-        currentPath[1] === 'namespaces' &&
-        currentPath[3] === 'tables';
-      // Preserve per-table payloads even when empty. SQL tables are never
-      // emitted empty; Mongo collections legitimately are (a declared
-      // collection with no schema is a valid representation), and the
-      // family-agnostic canonicalizer must not strip them.
-      const isNamespaceTableEntry =
-        currentPath.length === 5 &&
-        currentPath[0] === 'storage' &&
-        currentPath[1] === 'namespaces' &&
-        currentPath[3] === 'tables';
       const isRequiredRoots = isArrayEqual(currentPath, ['roots']);
       const isRequiredExtensionPacks = isArrayEqual(currentPath, ['extensionPacks']);
       const isRequiredCapabilities = isArrayEqual(currentPath, ['capabilities']);
@@ -104,33 +113,6 @@ function omitDefaults(obj: unknown, path: readonly string[]): unknown {
       const isModelStorage =
         currentPath.length === 3 &&
         isArrayEqual([currentPath[0], currentPath[2]], ['models', 'storage']);
-      const isNamespaceTableUniques =
-        currentPath.length === 6 &&
-        currentPath[0] === 'storage' &&
-        currentPath[1] === 'namespaces' &&
-        currentPath[3] === 'tables' &&
-        currentPath[5] === 'uniques';
-      const isNamespaceTableIndexes =
-        currentPath.length === 6 &&
-        currentPath[0] === 'storage' &&
-        currentPath[1] === 'namespaces' &&
-        currentPath[3] === 'tables' &&
-        currentPath[5] === 'indexes';
-      const isNamespaceTableForeignKeys =
-        currentPath.length === 6 &&
-        currentPath[0] === 'storage' &&
-        currentPath[1] === 'namespaces' &&
-        currentPath[3] === 'tables' &&
-        currentPath[5] === 'foreignKeys';
-
-      // `storage.types.<name>.typeParams` is part of the StorageTypeInstance
-      // shape (validators require it). Preserve it even when empty so the
-      // emitted contract.json remains structurally valid after a round-trip.
-      const isStorageTypeTypeParams =
-        currentPath.length === 4 &&
-        currentPath[0] === 'storage' &&
-        currentPath[1] === 'types' &&
-        key === 'typeParams';
 
       const isDomainUnboundTypeParams =
         currentPath.length === 5 &&
@@ -138,22 +120,14 @@ function omitDefaults(obj: unknown, path: readonly string[]): unknown {
         currentPath[2] === 'types' &&
         key === 'typeParams';
 
-      const isFkBooleanField =
-        currentPath.length === 7 &&
-        currentPath[0] === 'storage' &&
-        currentPath[1] === 'namespaces' &&
-        currentPath[3] === 'tables' &&
-        currentPath[5] === 'foreignKeys' &&
-        (key === 'constraint' || key === 'index');
-
       const isNullableField = key === 'nullable';
 
+      const isFamilyPreserved = shouldPreserveEmpty?.(currentPath) ?? false;
+
       if (
         !isRequiredModels &&
         !isRequiredNamespaces &&
         !isNamespaceSlot &&
-        !isRequiredNamespaceTables &&
-        !isNamespaceTableEntry &&
         !isRequiredRoots &&
         !isRequiredExtensionPacks &&
         !isRequiredCapabilities &&
@@ -162,19 +136,15 @@ function omitDefaults(obj: unknown, path: readonly string[]): unknown {
         !isExtensionNamespace &&
         !isModelRelations &&
         !isModelStorage &&
-        !isNamespaceTableUniques &&
-        !isNamespaceTableIndexes &&
-        !isNamespaceTableForeignKeys &&
-        !isFkBooleanField &&
         !isNullableField &&
-        !isStorageTypeTypeParams &&
-        !isDomainUnboundTypeParams
+        !isDomainUnboundTypeParams &&
+        !isFamilyPreserved
       ) {
         continue;
       }
     }
 
-    result[key] = omitDefaults(value, currentPath);
+    result[key] = omitDefaults(value, currentPath, shouldPreserveEmpty);
   }
 
   return result;
@@ -198,88 +168,6 @@ function sortObjectKeys(obj: unknown): unknown {
   return sorted;
 }
 
-type NamespaceObject = {
-  tables?: Record<string, unknown>;
-  [key: string]: unknown;
-};
-
-type StorageObject = {
-  namespaces?: Record<string, unknown>;
-  [key: string]: unknown;
-};
-
-type TableObject = {
-  indexes?: unknown[];
-  uniques?: unknown[];
-  [key: string]: unknown;
-};
-
-function sortTableArrays(tableObj: TableObject): TableObject {
-  const sortedTable: TableObject = { ...tableObj };
-
-  if (Array.isArray(tableObj.indexes)) {
-    sortedTable.indexes = [...tableObj.indexes].sort((a, b) => {
-      const nameA = (a as { name?: string })?.name || '';
-      const nameB = (b as { name?: string })?.name || '';
-      return nameA.localeCompare(nameB);
-    });
-  }
-
-  if (Array.isArray(tableObj.uniques)) {
-    sortedTable.uniques = [...tableObj.uniques].sort((a, b) => {
-      const nameA = (a as { name?: string })?.name || '';
-      const nameB = (b as { name?: string })?.name || '';
-      return nameA.localeCompare(nameB);
-    });
-  }
-
-  return sortedTable;
-}
-
-function sortIndexesAndUniques(storage: unknown): unknown {
-  if (!storage || typeof storage !== 'object') {
-    return storage;
-  }
-
-  const storageObj = storage as StorageObject;
-  if (!storageObj.namespaces || typeof storageObj.namespaces !== 'object') {
-    return storage;
-  }
-
-  const namespaces = storageObj.namespaces;
-  const result: StorageObject = { ...storageObj, namespaces: {} };
-  const resultNamespaces = result.namespaces as Record<string, unknown>;
-
-  for (const nsId of Object.keys(namespaces)) {
-    const ns = namespaces[nsId];
-    if (!ns || typeof ns !== 'object') {
-      resultNamespaces[nsId] = ns;
-      continue;
-    }
-
-    const nsObj = ns as NamespaceObject;
-    if (!nsObj.tables || typeof nsObj.tables !== 'object') {
-      resultNamespaces[nsId] = ns;
-      continue;
-    }
-
-    const sortedTables: Record<string, unknown> = {};
-    const sortedTableNames = Object.keys(nsObj.tables).sort();
-    for (const tableName of sortedTableNames) {
-      const table = nsObj.tables[tableName];
-      if (!table || typeof table !== 'object') {
-        sortedTables[tableName] = table;
-        continue;
-      }
-      sortedTables[tableName] = sortTableArrays(table as TableObject);
-    }
-
-    resultNamespaces[nsId] = { ...nsObj, tables: sortedTables };
-  }
-
-  return result;
-}
-
 export function orderTopLevel(obj: Record<string, unknown>): Record<string, unknown> {
   const ordered: Record<string, unknown> = {};
   const remaining = new Set(Object.keys(obj));
@@ -311,6 +199,21 @@ export interface CanonicalizeContractOptions {
    * the per-target serializer not putting them in the JSON shape.
    */
   readonly serializeContract: SerializeContract;
+  /**
+   * Family-contributed preserve-empty predicate. When the walk encounters a
+   * default value (empty object/array or `false`) at `path`, calling this
+   * with the full path allows the family to veto the omission. If absent,
+   * only the framework's family-agnostic required-slot rules apply.
+   */
+  readonly shouldPreserveEmpty?: PreserveEmptyPredicate;
+  /**
+   * Family-contributed storage sort. Applied to the serialized `storage`
+   * subtree after the default-omission walk, before the final key sort.
+   * SQL family uses this to impose a deterministic order on `indexes` and
+   * `uniques` arrays within each namespace table. Families that require no
+   * special storage ordering omit this hook.
+   */
+  readonly sortStorage?: StorageSort;
 }
 
 /**
@@ -338,9 +241,13 @@ export function canonicalizeContractToObject(
     capabilities: serialized['capabilities'],
     meta: serialized['meta'],
   };
-  const withDefaultsOmitted = omitDefaults(normalized, []) as Record<string, unknown>;
-  const withSortedIndexes = sortIndexesAndUniques(withDefaultsOmitted['storage']);
-  const withSortedStorage = { ...withDefaultsOmitted, storage: withSortedIndexes };
+  const withDefaultsOmitted = omitDefaults(normalized, [], options.shouldPreserveEmpty) as Record<
+    string,
+    unknown
+  >;
+  const withSortedStorage = options.sortStorage
+    ? { ...withDefaultsOmitted, storage: options.sortStorage(withDefaultsOmitted['storage']) }
+    : withDefaultsOmitted;
   const withSortedKeys = sortObjectKeys(withSortedStorage) as Record<string, unknown>;
   return orderTopLevel(withSortedKeys);
 }

package/src/exports/hashing-utils.ts

@@ -0,0 +1,12 @@
+export {
+  createPreserveEmptyPredicate,
+  matchesPathPattern,
+  type PathPattern,
+  type PathSegment as PreserveEmptyPathSegment,
+} from '../canonicalization-path-match';
+export {
+  compareByNameProperty,
+  createStorageSort,
+  type NamedArraySortTarget,
+  type PathSegment as StorageSortPathSegment,
+} from '../canonicalization-storage-sort';

package/src/exports/hashing.ts

@@ -2,6 +2,8 @@ export {
   type CanonicalizeContractOptions,
   canonicalizeContract,
   canonicalizeContractToObject,
+  type PreserveEmptyPredicate,
   type SerializeContract,
+  type StorageSort,
 } from '../canonicalization';
 export { computeExecutionHash, computeProfileHash, computeStorageHash } from '../hashing';

package/src/hashing.ts

@@ -1,6 +1,11 @@
 import { createHash } from 'node:crypto';
+import { ifDefined } from '@prisma-next/utils/defined';
 import type { JsonObject } from '@prisma-next/utils/json';
-import { canonicalizeContract } from './canonicalization';
+import {
+  canonicalizeContract,
+  type PreserveEmptyPredicate,
+  type StorageSort,
+} from './canonicalization';
 import type { Contract } from './contract-types';
 import type { ExecutionHashBase, ProfileHashBase, StorageHashBase } from './types';
 
@@ -12,7 +17,13 @@ function sha256(content: string): string {
   return `sha256:${hash.digest('hex')}`;
 }
 
-function hashContract(section: Record<string, unknown>): string {
+type HashContractSection = Record<string, unknown> & {
+  readonly shouldPreserveEmpty?: PreserveEmptyPredicate;
+  readonly sortStorage?: StorageSort;
+};
+
+function hashContract(section: HashContractSection): string {
+  const { shouldPreserveEmpty, sortStorage, ...sectionData } = section;
   // Blind cast: the synthesised object is a hash-only stand-in
   // — never returned to callers, never executed as a Contract.
   // `canonicalizeContract` only walks the storage / execution /
@@ -20,29 +31,35 @@ function hashContract(section: Record<string, unknown>): string {
   // missing precise Contract typing on the other slots is
   // immaterial for the hash result.
   const contract = {
-    targetFamily: section['targetFamily'],
-    target: section['target'],
+    targetFamily: sectionData['targetFamily'],
+    target: sectionData['target'],
     roots: {},
     models: {},
-    storage: section['storage'] ?? {},
-    execution: section['execution'],
+    storage: sectionData['storage'] ?? {},
+    execution: sectionData['execution'],
     extensionPacks: {},
-    capabilities: section['capabilities'] ?? {},
+    capabilities: sectionData['capabilities'] ?? {},
     meta: {},
     profileHash: '',
-    ...section,
+    ...sectionData,
   } as unknown as Contract;
   return canonicalizeContract(contract, {
     schemaVersion: SCHEMA_VERSION,
     serializeContract: (c) => JSON.parse(JSON.stringify(c)) as JsonObject,
+    ...ifDefined('shouldPreserveEmpty', shouldPreserveEmpty),
+    ...ifDefined('sortStorage', sortStorage),
   });
 }
 
-export function computeStorageHash(args: {
+export type ComputeStorageHashArgs = {
   target: string;
   targetFamily: string;
   storage: Record<string, unknown>;
-}): StorageHashBase<string> {
+  readonly shouldPreserveEmpty?: PreserveEmptyPredicate;
+  readonly sortStorage?: StorageSort;
+};
+
+export function computeStorageHash(args: ComputeStorageHashArgs): StorageHashBase<string> {
   return sha256(hashContract(args)) as StorageHashBase<string>;
 }
 

package/src/testing-factories.ts

@@ -1,4 +1,5 @@
 import { ifDefined } from '@prisma-next/utils/defined';
+import type { PreserveEmptyPredicate, StorageSort } from './canonicalization';
 import type { Contract } from './contract-types';
 import type { CrossReference } from './cross-reference';
 import type {
@@ -26,6 +27,8 @@ type ContractOverrides<
   execution?: Omit<ExecutionSection, 'executionHash'>;
   profileHash?: ProfileHashBase<string>;
   meta?: Record<string, unknown>;
+  shouldPreserveEmpty?: PreserveEmptyPredicate;
+  sortStorage?: StorageSort;
 };
 
 const DUMMY_HASH = coreHash('sha256:test');
@@ -57,6 +60,8 @@ export function createContract<
     target,
     targetFamily,
     storage: rawStorage as Record<string, unknown>,
+    ...ifDefined('shouldPreserveEmpty', overrides.shouldPreserveEmpty),
+    ...ifDefined('sortStorage', overrides.sortStorage),
   });
 
   const storage = {

package/dist/hashing-BqnADuDo.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"hashing-BqnADuDo.mjs","names":[],"sources":["../src/canonicalization.ts","../src/hashing.ts"],"sourcesContent":["import { isArrayEqual } from '@prisma-next/utils/array-equal';\nimport { ifDefined } from '@prisma-next/utils/defined';\nimport type { JsonObject } from '@prisma-next/utils/json';\n\nimport type { Contract } from './contract-types';\n\n/**\n * Per-target contract serializer hook. The framework canonicalizer uses\n * this to convert an in-memory contract (which may carry class-instance\n * IR nodes whose runtime-only fields must not appear in the on-disk\n * envelope) into a plain JsonObject before applying the family-agnostic\n * canonical-key ordering / default-omission / sort steps. Targets whose\n * contract is JSON-clean by construction return the contract unchanged.\n */\nexport type SerializeContract = (contract: Contract) => JsonObject;\n\nconst TOP_LEVEL_ORDER = [\n  'schemaVersion',\n  'canonicalVersion',\n  'targetFamily',\n  'target',\n  'profileHash',\n  'roots',\n  'models',\n  'valueObjects',\n  'domain',\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 (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 (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    if (key === '_generated') {\n      continue;\n    }\n\n    if (key === 'generated' && value === false) {\n      continue;\n    }\n\n    if ((key === 'onDelete' || key === 'onUpdate') && value === 'noAction') {\n      continue;\n    }\n\n    if (isDefaultValue(value)) {\n      const isRequiredModels = isArrayEqual(currentPath, ['models']);\n      const isRequiredNamespaces = isArrayEqual(currentPath, ['storage', 'namespaces']);\n      const isNamespaceSlot =\n        currentPath.length === 3 &&\n        isArrayEqual([currentPath[0], currentPath[1]], ['storage', 'namespaces']);\n      const isRequiredNamespaceTables =\n        currentPath.length === 4 &&\n        currentPath[0] === 'storage' &&\n        currentPath[1] === 'namespaces' &&\n        currentPath[3] === 'tables';\n      // Preserve per-table payloads even when empty. SQL tables are never\n      // emitted empty; Mongo collections legitimately are (a declared\n      // collection with no schema is a valid representation), and the\n      // family-agnostic canonicalizer must not strip them.\n      const isNamespaceTableEntry =\n        currentPath.length === 5 &&\n        currentPath[0] === 'storage' &&\n        currentPath[1] === 'namespaces' &&\n        currentPath[3] === 'tables';\n      const isRequiredRoots = isArrayEqual(currentPath, ['roots']);\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 isModelStorage =\n        currentPath.length === 3 &&\n        isArrayEqual([currentPath[0], currentPath[2]], ['models', 'storage']);\n      const isNamespaceTableUniques =\n        currentPath.length === 6 &&\n        currentPath[0] === 'storage' &&\n        currentPath[1] === 'namespaces' &&\n        currentPath[3] === 'tables' &&\n        currentPath[5] === 'uniques';\n      const isNamespaceTableIndexes =\n        currentPath.length === 6 &&\n        currentPath[0] === 'storage' &&\n        currentPath[1] === 'namespaces' &&\n        currentPath[3] === 'tables' &&\n        currentPath[5] === 'indexes';\n      const isNamespaceTableForeignKeys =\n        currentPath.length === 6 &&\n        currentPath[0] === 'storage' &&\n        currentPath[1] === 'namespaces' &&\n        currentPath[3] === 'tables' &&\n        currentPath[5] === 'foreignKeys';\n\n      // `storage.types.<name>.typeParams` is part of the StorageTypeInstance\n      // shape (validators require it). Preserve it even when empty so the\n      // emitted contract.json remains structurally valid after a round-trip.\n      const isStorageTypeTypeParams =\n        currentPath.length === 4 &&\n        currentPath[0] === 'storage' &&\n        currentPath[1] === 'types' &&\n        key === 'typeParams';\n\n      const isDomainUnboundTypeParams =\n        currentPath.length === 5 &&\n        currentPath[0] === 'domain' &&\n        currentPath[2] === 'types' &&\n        key === 'typeParams';\n\n      const isFkBooleanField =\n        currentPath.length === 7 &&\n        currentPath[0] === 'storage' &&\n        currentPath[1] === 'namespaces' &&\n        currentPath[3] === 'tables' &&\n        currentPath[5] === 'foreignKeys' &&\n        (key === 'constraint' || key === 'index');\n\n      const isNullableField = key === 'nullable';\n\n      if (\n        !isRequiredModels &&\n        !isRequiredNamespaces &&\n        !isNamespaceSlot &&\n        !isRequiredNamespaceTables &&\n        !isNamespaceTableEntry &&\n        !isRequiredRoots &&\n        !isRequiredExtensionPacks &&\n        !isRequiredCapabilities &&\n        !isRequiredMeta &&\n        !isRequiredExecutionDefaults &&\n        !isExtensionNamespace &&\n        !isModelRelations &&\n        !isModelStorage &&\n        !isNamespaceTableUniques &&\n        !isNamespaceTableIndexes &&\n        !isNamespaceTableForeignKeys &&\n        !isFkBooleanField &&\n        !isNullableField &&\n        !isStorageTypeTypeParams &&\n        !isDomainUnboundTypeParams\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 (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 NamespaceObject = {\n  tables?: Record<string, unknown>;\n  [key: string]: unknown;\n};\n\ntype StorageObject = {\n  namespaces?: Record<string, unknown>;\n  [key: string]: unknown;\n};\n\ntype TableObject = {\n  indexes?: unknown[];\n  uniques?: unknown[];\n  [key: string]: unknown;\n};\n\nfunction sortTableArrays(tableObj: TableObject): 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  return sortedTable;\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.namespaces || typeof storageObj.namespaces !== 'object') {\n    return storage;\n  }\n\n  const namespaces = storageObj.namespaces;\n  const result: StorageObject = { ...storageObj, namespaces: {} };\n  const resultNamespaces = result.namespaces as Record<string, unknown>;\n\n  for (const nsId of Object.keys(namespaces)) {\n    const ns = namespaces[nsId];\n    if (!ns || typeof ns !== 'object') {\n      resultNamespaces[nsId] = ns;\n      continue;\n    }\n\n    const nsObj = ns as NamespaceObject;\n    if (!nsObj.tables || typeof nsObj.tables !== 'object') {\n      resultNamespaces[nsId] = ns;\n      continue;\n    }\n\n    const sortedTables: Record<string, unknown> = {};\n    const sortedTableNames = Object.keys(nsObj.tables).sort();\n    for (const tableName of sortedTableNames) {\n      const table = nsObj.tables[tableName];\n      if (!table || typeof table !== 'object') {\n        sortedTables[tableName] = table;\n        continue;\n      }\n      sortedTables[tableName] = sortTableArrays(table as TableObject);\n    }\n\n    resultNamespaces[nsId] = { ...nsObj, tables: sortedTables };\n  }\n\n  return result;\n}\n\nexport function 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 interface CanonicalizeContractOptions {\n  readonly schemaVersion?: string;\n  /**\n   * Per-target hook that converts the in-memory contract (which may\n   * carry class-instance IR nodes) into a plain JsonObject before the\n   * family-agnostic canonicalization steps run.\n   *\n   * Routing through the hook is what lets each target decide which\n   * fields appear in the on-disk envelope; runtime-only class API\n   * fields stay invisible to the canonicalization walk by virtue of\n   * the per-target serializer not putting them in the JSON shape.\n   */\n  readonly serializeContract: SerializeContract;\n}\n\n/**\n * Object-form variant of {@link canonicalizeContract}. Exported because the\n * emitter writes the canonical contract through a separate JSON-stringify\n * pass and consumes the structured object directly.\n */\nexport function canonicalizeContractToObject(\n  contract: Contract,\n  options: CanonicalizeContractOptions,\n): Record<string, unknown> {\n  const serialized = options.serializeContract(contract);\n  const normalized: Record<string, unknown> = {\n    ...ifDefined('schemaVersion', options.schemaVersion),\n    targetFamily: serialized['targetFamily'],\n    target: serialized['target'],\n    profileHash: serialized['profileHash'],\n    roots: serialized['roots'],\n    models: serialized['models'],\n    ...ifDefined('valueObjects', serialized['valueObjects']),\n    ...ifDefined('domain', serialized['domain']),\n    storage: serialized['storage'],\n    ...ifDefined('execution', serialized['execution']),\n    extensionPacks: serialized['extensionPacks'],\n    capabilities: serialized['capabilities'],\n    meta: serialized['meta'],\n  };\n  const withDefaultsOmitted = omitDefaults(normalized, []) as Record<string, unknown>;\n  const withSortedIndexes = sortIndexesAndUniques(withDefaultsOmitted['storage']);\n  const withSortedStorage = { ...withDefaultsOmitted, storage: withSortedIndexes };\n  const withSortedKeys = sortObjectKeys(withSortedStorage) as Record<string, unknown>;\n  return orderTopLevel(withSortedKeys);\n}\n\nexport function canonicalizeContract(\n  contract: Contract,\n  options: CanonicalizeContractOptions,\n): string {\n  return JSON.stringify(canonicalizeContractToObject(contract, options), null, 2);\n}\n","import { createHash } from 'node:crypto';\nimport type { JsonObject } from '@prisma-next/utils/json';\nimport { canonicalizeContract } from './canonicalization';\nimport type { Contract } from './contract-types';\nimport type { ExecutionHashBase, ProfileHashBase, StorageHashBase } from './types';\n\nconst SCHEMA_VERSION = '1';\n\nfunction sha256(content: string): string {\n  const hash = createHash('sha256');\n  hash.update(content);\n  return `sha256:${hash.digest('hex')}`;\n}\n\nfunction hashContract(section: Record<string, unknown>): string {\n  // Blind cast: the synthesised object is a hash-only stand-in\n  // — never returned to callers, never executed as a Contract.\n  // `canonicalizeContract` only walks the storage / execution /\n  // capabilities slices, all of which are populated above, so the\n  // missing precise Contract typing on the other slots is\n  // immaterial for the hash result.\n  const contract = {\n    targetFamily: section['targetFamily'],\n    target: section['target'],\n    roots: {},\n    models: {},\n    storage: section['storage'] ?? {},\n    execution: section['execution'],\n    extensionPacks: {},\n    capabilities: section['capabilities'] ?? {},\n    meta: {},\n    profileHash: '',\n    ...section,\n  } as unknown as Contract;\n  return canonicalizeContract(contract, {\n    schemaVersion: SCHEMA_VERSION,\n    serializeContract: (c) => JSON.parse(JSON.stringify(c)) as JsonObject,\n  });\n}\n\nexport function computeStorageHash(args: {\n  target: string;\n  targetFamily: string;\n  storage: Record<string, unknown>;\n}): StorageHashBase<string> {\n  return sha256(hashContract(args)) as StorageHashBase<string>;\n}\n\nexport function computeExecutionHash(args: {\n  target: string;\n  targetFamily: string;\n  execution: Record<string, unknown>;\n}): ExecutionHashBase<string> {\n  return sha256(hashContract(args)) as ExecutionHashBase<string>;\n}\n\nexport function computeProfileHash(args: {\n  target: string;\n  targetFamily: string;\n  capabilities: Record<string, Record<string, boolean>>;\n}): ProfileHashBase<string> {\n  return sha256(hashContract(args)) as ProfileHashBase<string>;\n}\n"],"mappings":"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"}