@prisma-next/contract 0.11.0 → 0.12.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/canonicalization-DFE0HJkI.d.mts +69 -0
- package/dist/canonicalization-DFE0HJkI.d.mts.map +1 -0
- package/dist/canonicalization-path-match-b2jFuEso.mjs +25 -0
- package/dist/canonicalization-path-match-b2jFuEso.mjs.map +1 -0
- package/dist/{contract-types-Bt2uyqs3.d.mts → contract-types-xgwKtd7y.d.mts} +34 -74
- package/dist/contract-types-xgwKtd7y.d.mts.map +1 -0
- package/dist/contract-validation-error-ClZaKqMW.mjs +20 -0
- package/dist/contract-validation-error-ClZaKqMW.mjs.map +1 -0
- package/dist/contract-validation-error-T5LH4DW-.d.mts +13 -0
- package/dist/contract-validation-error-T5LH4DW-.d.mts.map +1 -0
- package/dist/contract-validation-error.d.mts +2 -10
- package/dist/contract-validation-error.mjs +2 -2
- package/dist/domain-envelope-4hyFtJ4_.d.mts +110 -0
- package/dist/domain-envelope-4hyFtJ4_.d.mts.map +1 -0
- package/dist/hashing-utils.d.mts +19 -0
- package/dist/hashing-utils.d.mts.map +1 -0
- package/dist/hashing-utils.mjs +50 -0
- package/dist/hashing-utils.mjs.map +1 -0
- package/dist/hashing.d.mts +8 -37
- package/dist/hashing.d.mts.map +1 -1
- package/dist/hashing.mjs +175 -1
- package/dist/hashing.mjs.map +1 -0
- package/dist/namespace-id-CVpkSFUK.mjs +9 -0
- package/dist/namespace-id-CVpkSFUK.mjs.map +1 -0
- package/dist/types.d.mts +4 -2
- package/dist/types.mjs +91 -2
- package/dist/types.mjs.map +1 -0
- package/dist/validate-domain.d.mts +6 -8
- package/dist/validate-domain.d.mts.map +1 -1
- package/dist/validate-domain.mjs +99 -56
- package/dist/validate-domain.mjs.map +1 -1
- package/package.json +16 -9
- package/src/canonicalization-path-match.ts +44 -0
- package/src/canonicalization-storage-sort.ts +88 -0
- package/src/canonicalization.ts +92 -161
- package/src/contract-types.ts +33 -7
- package/src/contract-validation-error.ts +7 -0
- package/src/cross-reference.ts +28 -0
- package/src/domain-envelope.ts +87 -0
- package/src/domain-types.ts +13 -15
- package/src/exports/contract-validation-error.ts +1 -0
- package/src/exports/hashing-utils.ts +12 -0
- package/src/exports/hashing.ts +2 -0
- package/src/exports/types.ts +24 -1
- package/src/hashing.ts +28 -11
- package/src/namespace-id.ts +10 -0
- package/src/types.ts +21 -0
- package/src/validate-domain.ts +162 -94
- package/dist/contract-types-Bt2uyqs3.d.mts.map +0 -1
- package/dist/contract-validation-error-Dp2vHZt5.mjs +0 -14
- package/dist/contract-validation-error-Dp2vHZt5.mjs.map +0 -1
- package/dist/contract-validation-error.d.mts.map +0 -1
- package/dist/hashing-rZiqFOlc.mjs +0 -204
- package/dist/hashing-rZiqFOlc.mjs.map +0 -1
- package/dist/testing.d.mts +0 -32
- package/dist/testing.d.mts.map +0 -1
- package/dist/testing.mjs +0 -63
- package/dist/testing.mjs.map +0 -1
- package/dist/types-CVGwkRLa.mjs +0 -46
- package/dist/types-CVGwkRLa.mjs.map +0 -1
- package/src/exports/testing.ts +0 -1
- package/src/testing-factories.ts +0 -115
package/dist/hashing.mjs
CHANGED
|
@@ -1,2 +1,176 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import { n as matchesPathPattern } from "./canonicalization-path-match-b2jFuEso.mjs";
|
|
2
|
+
import { isArrayEqual } from "@prisma-next/utils/array-equal";
|
|
3
|
+
import { ifDefined } from "@prisma-next/utils/defined";
|
|
4
|
+
import { createHash } from "node:crypto";
|
|
5
|
+
//#region src/canonicalization.ts
|
|
6
|
+
const DOMAIN_NAMESPACE_SLOT_PATTERN = [
|
|
7
|
+
"domain",
|
|
8
|
+
"namespaces",
|
|
9
|
+
"*"
|
|
10
|
+
];
|
|
11
|
+
const DOMAIN_MODELS_CONTAINER_PATTERN = [
|
|
12
|
+
"domain",
|
|
13
|
+
"namespaces",
|
|
14
|
+
"*",
|
|
15
|
+
"models"
|
|
16
|
+
];
|
|
17
|
+
const DOMAIN_MODEL_RELATIONS_PATTERN = [
|
|
18
|
+
"domain",
|
|
19
|
+
"namespaces",
|
|
20
|
+
"*",
|
|
21
|
+
"models",
|
|
22
|
+
"*",
|
|
23
|
+
"relations"
|
|
24
|
+
];
|
|
25
|
+
const DOMAIN_MODEL_STORAGE_PATTERN = [
|
|
26
|
+
"domain",
|
|
27
|
+
"namespaces",
|
|
28
|
+
"*",
|
|
29
|
+
"models",
|
|
30
|
+
"*",
|
|
31
|
+
"storage"
|
|
32
|
+
];
|
|
33
|
+
const TOP_LEVEL_ORDER = [
|
|
34
|
+
"schemaVersion",
|
|
35
|
+
"canonicalVersion",
|
|
36
|
+
"targetFamily",
|
|
37
|
+
"target",
|
|
38
|
+
"profileHash",
|
|
39
|
+
"roots",
|
|
40
|
+
"domain",
|
|
41
|
+
"storage",
|
|
42
|
+
"execution",
|
|
43
|
+
"capabilities",
|
|
44
|
+
"extensionPacks",
|
|
45
|
+
"meta"
|
|
46
|
+
];
|
|
47
|
+
function isDefaultValue(value) {
|
|
48
|
+
if (value === false) return true;
|
|
49
|
+
if (value === null) return false;
|
|
50
|
+
if (Array.isArray(value) && value.length === 0) return true;
|
|
51
|
+
if (typeof value === "object" && value !== null) return Object.keys(value).length === 0;
|
|
52
|
+
return false;
|
|
53
|
+
}
|
|
54
|
+
function omitDefaults(obj, path, shouldPreserveEmpty) {
|
|
55
|
+
if (obj === null || typeof obj !== "object") return obj;
|
|
56
|
+
if (Array.isArray(obj)) return obj.map((item) => omitDefaults(item, path, shouldPreserveEmpty));
|
|
57
|
+
const result = {};
|
|
58
|
+
for (const [key, value] of Object.entries(obj)) {
|
|
59
|
+
const currentPath = [...path, key];
|
|
60
|
+
if (key === "_generated") continue;
|
|
61
|
+
if (key === "generated" && value === false) continue;
|
|
62
|
+
if ((key === "onDelete" || key === "onUpdate") && value === "noAction") continue;
|
|
63
|
+
if (isDefaultValue(value)) {
|
|
64
|
+
const isRequiredDomainNamespaces = isArrayEqual(currentPath, ["domain", "namespaces"]);
|
|
65
|
+
const isDomainNamespaceSlot = matchesPathPattern(currentPath, DOMAIN_NAMESPACE_SLOT_PATTERN);
|
|
66
|
+
const isRequiredDomainModels = matchesPathPattern(currentPath, DOMAIN_MODELS_CONTAINER_PATTERN);
|
|
67
|
+
const isRequiredStorageNamespaces = isArrayEqual(currentPath, ["storage", "namespaces"]);
|
|
68
|
+
const isStorageNamespaceSlot = currentPath.length === 3 && isArrayEqual([currentPath[0], currentPath[1]], ["storage", "namespaces"]);
|
|
69
|
+
const isRequiredRoots = isArrayEqual(currentPath, ["roots"]);
|
|
70
|
+
const isRequiredExtensionPacks = isArrayEqual(currentPath, ["extensionPacks"]);
|
|
71
|
+
const isRequiredCapabilities = isArrayEqual(currentPath, ["capabilities"]);
|
|
72
|
+
const isRequiredMeta = isArrayEqual(currentPath, ["meta"]);
|
|
73
|
+
const isRequiredExecutionDefaults = isArrayEqual(currentPath, [
|
|
74
|
+
"execution",
|
|
75
|
+
"mutations",
|
|
76
|
+
"defaults"
|
|
77
|
+
]);
|
|
78
|
+
const isExtensionNamespace = currentPath.length === 2 && currentPath[0] === "extensionPacks";
|
|
79
|
+
const isModelRelations = matchesPathPattern(currentPath, DOMAIN_MODEL_RELATIONS_PATTERN);
|
|
80
|
+
const isModelStorage = matchesPathPattern(currentPath, DOMAIN_MODEL_STORAGE_PATTERN);
|
|
81
|
+
const isNullableField = key === "nullable";
|
|
82
|
+
const isFamilyPreserved = shouldPreserveEmpty?.(currentPath) ?? false;
|
|
83
|
+
if (!isRequiredDomainNamespaces && !isDomainNamespaceSlot && !isRequiredDomainModels && !isRequiredStorageNamespaces && !isStorageNamespaceSlot && !isRequiredRoots && !isRequiredExtensionPacks && !isRequiredCapabilities && !isRequiredMeta && !isRequiredExecutionDefaults && !isExtensionNamespace && !isModelRelations && !isModelStorage && !isNullableField && !isFamilyPreserved) continue;
|
|
84
|
+
}
|
|
85
|
+
result[key] = omitDefaults(value, currentPath, shouldPreserveEmpty);
|
|
86
|
+
}
|
|
87
|
+
return result;
|
|
88
|
+
}
|
|
89
|
+
function sortObjectKeys(obj) {
|
|
90
|
+
if (obj === null || typeof obj !== "object") return obj;
|
|
91
|
+
if (Array.isArray(obj)) return obj.map((item) => sortObjectKeys(item));
|
|
92
|
+
const sorted = {};
|
|
93
|
+
const keys = Object.keys(obj).sort();
|
|
94
|
+
for (const key of keys) sorted[key] = sortObjectKeys(obj[key]);
|
|
95
|
+
return sorted;
|
|
96
|
+
}
|
|
97
|
+
function orderTopLevel(obj) {
|
|
98
|
+
const ordered = {};
|
|
99
|
+
const remaining = new Set(Object.keys(obj));
|
|
100
|
+
for (const key of TOP_LEVEL_ORDER) if (remaining.has(key)) {
|
|
101
|
+
ordered[key] = obj[key];
|
|
102
|
+
remaining.delete(key);
|
|
103
|
+
}
|
|
104
|
+
for (const key of Array.from(remaining).sort()) ordered[key] = obj[key];
|
|
105
|
+
return ordered;
|
|
106
|
+
}
|
|
107
|
+
/**
|
|
108
|
+
* Object-form variant of {@link canonicalizeContract}. Exported because the
|
|
109
|
+
* emitter writes the canonical contract through a separate JSON-stringify
|
|
110
|
+
* pass and consumes the structured object directly.
|
|
111
|
+
*/
|
|
112
|
+
function canonicalizeContractToObject(contract, options) {
|
|
113
|
+
const serialized = options.serializeContract(contract);
|
|
114
|
+
const withDefaultsOmitted = omitDefaults({
|
|
115
|
+
...ifDefined("schemaVersion", options.schemaVersion),
|
|
116
|
+
targetFamily: serialized["targetFamily"],
|
|
117
|
+
target: serialized["target"],
|
|
118
|
+
profileHash: serialized["profileHash"],
|
|
119
|
+
roots: serialized["roots"],
|
|
120
|
+
domain: serialized["domain"],
|
|
121
|
+
storage: serialized["storage"],
|
|
122
|
+
...ifDefined("execution", serialized["execution"]),
|
|
123
|
+
extensionPacks: serialized["extensionPacks"],
|
|
124
|
+
capabilities: serialized["capabilities"],
|
|
125
|
+
meta: serialized["meta"]
|
|
126
|
+
}, [], options.shouldPreserveEmpty);
|
|
127
|
+
return orderTopLevel(sortObjectKeys(options.sortStorage ? {
|
|
128
|
+
...withDefaultsOmitted,
|
|
129
|
+
storage: options.sortStorage(withDefaultsOmitted["storage"])
|
|
130
|
+
} : withDefaultsOmitted));
|
|
131
|
+
}
|
|
132
|
+
function canonicalizeContract(contract, options) {
|
|
133
|
+
return JSON.stringify(canonicalizeContractToObject(contract, options), null, 2);
|
|
134
|
+
}
|
|
135
|
+
//#endregion
|
|
136
|
+
//#region src/hashing.ts
|
|
137
|
+
const SCHEMA_VERSION = "1";
|
|
138
|
+
function sha256(content) {
|
|
139
|
+
const hash = createHash("sha256");
|
|
140
|
+
hash.update(content);
|
|
141
|
+
return `sha256:${hash.digest("hex")}`;
|
|
142
|
+
}
|
|
143
|
+
function hashContract(section) {
|
|
144
|
+
const { shouldPreserveEmpty, sortStorage, ...sectionData } = section;
|
|
145
|
+
return canonicalizeContract({
|
|
146
|
+
targetFamily: sectionData["targetFamily"],
|
|
147
|
+
target: sectionData["target"],
|
|
148
|
+
roots: {},
|
|
149
|
+
domain: { namespaces: {} },
|
|
150
|
+
storage: sectionData["storage"] ?? {},
|
|
151
|
+
execution: sectionData["execution"],
|
|
152
|
+
extensionPacks: {},
|
|
153
|
+
capabilities: sectionData["capabilities"] ?? {},
|
|
154
|
+
meta: {},
|
|
155
|
+
profileHash: "",
|
|
156
|
+
...sectionData
|
|
157
|
+
}, {
|
|
158
|
+
schemaVersion: SCHEMA_VERSION,
|
|
159
|
+
serializeContract: (c) => JSON.parse(JSON.stringify(c)),
|
|
160
|
+
...ifDefined("shouldPreserveEmpty", shouldPreserveEmpty),
|
|
161
|
+
...ifDefined("sortStorage", sortStorage)
|
|
162
|
+
});
|
|
163
|
+
}
|
|
164
|
+
function computeStorageHash(args) {
|
|
165
|
+
return sha256(hashContract(args));
|
|
166
|
+
}
|
|
167
|
+
function computeExecutionHash(args) {
|
|
168
|
+
return sha256(hashContract(args));
|
|
169
|
+
}
|
|
170
|
+
function computeProfileHash(args) {
|
|
171
|
+
return sha256(hashContract(args));
|
|
172
|
+
}
|
|
173
|
+
//#endregion
|
|
2
174
|
export { canonicalizeContract, canonicalizeContractToObject, computeExecutionHash, computeProfileHash, computeStorageHash };
|
|
175
|
+
|
|
176
|
+
//# sourceMappingURL=hashing.mjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"hashing.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';\nimport { matchesPathPattern, type PathPattern } from './canonicalization-path-match';\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 DOMAIN_NAMESPACE_SLOT_PATTERN = ['domain', 'namespaces', '*'] as const satisfies PathPattern;\nconst DOMAIN_MODELS_CONTAINER_PATTERN = [\n 'domain',\n 'namespaces',\n '*',\n 'models',\n] as const satisfies PathPattern;\nconst DOMAIN_MODEL_RELATIONS_PATTERN = [\n 'domain',\n 'namespaces',\n '*',\n 'models',\n '*',\n 'relations',\n] as const satisfies PathPattern;\nconst DOMAIN_MODEL_STORAGE_PATTERN = [\n 'domain',\n 'namespaces',\n '*',\n 'models',\n '*',\n 'storage',\n] as const satisfies PathPattern;\n\nconst TOP_LEVEL_ORDER = [\n 'schemaVersion',\n 'canonicalVersion',\n 'targetFamily',\n 'target',\n 'profileHash',\n 'roots',\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 isRequiredDomainNamespaces = isArrayEqual(currentPath, ['domain', 'namespaces']);\n const isDomainNamespaceSlot = matchesPathPattern(currentPath, DOMAIN_NAMESPACE_SLOT_PATTERN);\n const isRequiredDomainModels = matchesPathPattern(\n currentPath,\n DOMAIN_MODELS_CONTAINER_PATTERN,\n );\n const isRequiredStorageNamespaces = isArrayEqual(currentPath, ['storage', 'namespaces']);\n const isStorageNamespaceSlot =\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 = matchesPathPattern(currentPath, DOMAIN_MODEL_RELATIONS_PATTERN);\n const isModelStorage = matchesPathPattern(currentPath, DOMAIN_MODEL_STORAGE_PATTERN);\n\n const isNullableField = key === 'nullable';\n\n const isFamilyPreserved = shouldPreserveEmpty?.(currentPath) ?? false;\n\n if (\n !isRequiredDomainNamespaces &&\n !isDomainNamespaceSlot &&\n !isRequiredDomainModels &&\n !isRequiredStorageNamespaces &&\n !isStorageNamespaceSlot &&\n !isRequiredRoots &&\n !isRequiredExtensionPacks &&\n !isRequiredCapabilities &&\n !isRequiredMeta &&\n !isRequiredExecutionDefaults &&\n !isExtensionNamespace &&\n !isModelRelations &&\n !isModelStorage &&\n !isNullableField &&\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 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 domain: { namespaces: {} },\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,gCAAgC;CAAC;CAAU;CAAc;AAAG;AAClE,MAAM,kCAAkC;CACtC;CACA;CACA;CACA;AACF;AACA,MAAM,iCAAiC;CACrC;CACA;CACA;CACA;CACA;CACA;AACF;AACA,MAAM,+BAA+B;CACnC;CACA;CACA;CACA;CACA;CACA;AACF;AAEA,MAAM,kBAAkB;CACtB;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,6BAA6B,aAAa,aAAa,CAAC,UAAU,YAAY,CAAC;GACrF,MAAM,wBAAwB,mBAAmB,aAAa,6BAA6B;GAC3F,MAAM,yBAAyB,mBAC7B,aACA,+BACF;GACA,MAAM,8BAA8B,aAAa,aAAa,CAAC,WAAW,YAAY,CAAC;GACvF,MAAM,yBACJ,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,mBAAmB,mBAAmB,aAAa,8BAA8B;GACvF,MAAM,iBAAiB,mBAAmB,aAAa,4BAA4B;GAEnF,MAAM,kBAAkB,QAAQ;GAEhC,MAAM,oBAAoB,sBAAsB,WAAW,KAAK;GAEhE,IACE,CAAC,8BACD,CAAC,yBACD,CAAC,0BACD,CAAC,+BACD,CAAC,0BACD,CAAC,mBACD,CAAC,4BACD,CAAC,0BACD,CAAC,kBACD,CAAC,+BACD,CAAC,wBACD,CAAC,oBACD,CAAC,kBACD,CAAC,mBACD,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;CAcrD,MAAM,sBAAsB,aAAa;EAZvC,GAAG,UAAU,iBAAiB,QAAQ,aAAa;EACnD,cAAc,WAAW;EACzB,QAAQ,WAAW;EACnB,aAAa,WAAW;EACxB,OAAO,WAAW;EAClB,QAAQ,WAAW;EACnB,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;;;ACxQA,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,EAAE,YAAY,CAAC,EAAE;EACzB,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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"namespace-id-CVpkSFUK.mjs","names":[],"sources":["../src/namespace-id.ts"],"sourcesContent":["import { blindCast } from '@prisma-next/utils/casts';\n\nexport type NamespaceId = string & { readonly __brand: 'NamespaceId' };\n\nexport function asNamespaceId(value: string): NamespaceId {\n return blindCast<\n NamespaceId,\n 'NamespaceId is a compile-time-only brand on string; this factory is the sole assertion site'\n >(value);\n}\n"],"mappings":";;AAIA,SAAgB,cAAc,OAA4B;CACxD,OAAO,UAGL,KAAK;AACT"}
|
package/dist/types.d.mts
CHANGED
|
@@ -1,2 +1,4 @@
|
|
|
1
|
-
import {
|
|
2
|
-
|
|
1
|
+
import { r as DomainNamespaceResolutionError } from "./contract-validation-error-T5LH4DW-.mjs";
|
|
2
|
+
import { C as UnionFieldType, D as crossRef, E as CrossReferenceSchema, O as NamespaceId, S as ScalarFieldType, T as CrossReference, _ as ContractValueObject, a as contractModels, b as ModelStorageBase, c as ContractDiscriminator, d as ContractFieldType, f as ContractModel, g as ContractRelationOn, h as ContractRelation, i as UNBOUND_DOMAIN_NAMESPACE_ID, k as asNamespaceId, l as ContractEmbedRelation, m as ContractReferenceRelation, n as ApplicationDomainNamespace, o as contractValueObjects, p as ContractModelBase, r as ContractWithDomain, s as resolveSingleDomainNamespaceId, t as ApplicationDomain, u as ContractField, v as ContractVariantEntry, w as ValueObjectFieldType, x as ReferenceRelationKeys, y as EmbedRelationKeys } from "./domain-envelope-4hyFtJ4_.mjs";
|
|
3
|
+
import { A as coreHash, C as PlanMeta, D as StorageEntitySlot, E as StorageBase, F as profileHash, M as isColumnDefault, N as isColumnDefaultLiteralInputValue, O as StorageHashBase, P as isExecutionMutationDefaultValue, S as JsonValue, T as Source, _ as ExecutionSection, a as $, b as GeneratedValueSpec, c as ColumnDefaultLiteralInputValue, d as DocCollection, f as DocIndex, g as ExecutionMutationDefaultValue, h as ExecutionMutationDefaultPhases, i as ContractValueObjectsMap, j as executionHash, k as StorageNamespace, l as ColumnDefaultLiteralValue, m as ExecutionMutationDefault, n as ContractExecutionSection, o as Brand, p as ExecutionHashBase, r as ContractModelsMap, s as ColumnDefault, t as Contract, u as ContractMarkerRecord, v as Expr, w as ProfileHashBase, x as JsonPrimitive, y as FieldType } from "./contract-types-xgwKtd7y.mjs";
|
|
4
|
+
export { type $, type ApplicationDomain, type ApplicationDomainNamespace, type Brand, type ColumnDefault, type ColumnDefaultLiteralInputValue, type ColumnDefaultLiteralValue, type Contract, type ContractDiscriminator, type ContractEmbedRelation, type ContractExecutionSection, type ContractField, type ContractFieldType, type ContractMarkerRecord, type ContractModel, type ContractModelBase, type ContractModelsMap, type ContractReferenceRelation, type ContractRelation, type ContractRelationOn, type ContractValueObject, type ContractValueObjectsMap, type ContractVariantEntry, type ContractWithDomain, type CrossReference, CrossReferenceSchema, type DocCollection, type DocIndex, DomainNamespaceResolutionError, type EmbedRelationKeys, type ExecutionHashBase, type ExecutionMutationDefault, type ExecutionMutationDefaultPhases, type ExecutionMutationDefaultValue, type ExecutionSection, type Expr, type FieldType, type GeneratedValueSpec, type JsonPrimitive, type JsonValue, type ModelStorageBase, type NamespaceId, type PlanMeta, type ProfileHashBase, type ReferenceRelationKeys, type ScalarFieldType, type Source, type StorageBase, type StorageEntitySlot, type StorageHashBase, type StorageNamespace, UNBOUND_DOMAIN_NAMESPACE_ID, type UnionFieldType, type ValueObjectFieldType, asNamespaceId, contractModels, contractValueObjects, coreHash, crossRef, executionHash, isColumnDefault, isColumnDefaultLiteralInputValue, isExecutionMutationDefaultValue, profileHash, resolveSingleDomainNamespaceId };
|
package/dist/types.mjs
CHANGED
|
@@ -1,2 +1,91 @@
|
|
|
1
|
-
import {
|
|
2
|
-
|
|
1
|
+
import { n as DomainNamespaceResolutionError } from "./contract-validation-error-ClZaKqMW.mjs";
|
|
2
|
+
import { t as asNamespaceId } from "./namespace-id-CVpkSFUK.mjs";
|
|
3
|
+
import { blindCast } from "@prisma-next/utils/casts";
|
|
4
|
+
import { type } from "arktype";
|
|
5
|
+
//#region src/cross-reference.ts
|
|
6
|
+
const CrossReferenceSchema = blindCast(type({
|
|
7
|
+
"+": "reject",
|
|
8
|
+
namespace: "string",
|
|
9
|
+
model: "string"
|
|
10
|
+
}));
|
|
11
|
+
const DEFAULT_CROSS_REF_NAMESPACE = "__unbound__";
|
|
12
|
+
function crossRef(model, namespace = DEFAULT_CROSS_REF_NAMESPACE) {
|
|
13
|
+
return {
|
|
14
|
+
namespace: asNamespaceId(namespace),
|
|
15
|
+
model
|
|
16
|
+
};
|
|
17
|
+
}
|
|
18
|
+
//#endregion
|
|
19
|
+
//#region src/domain-envelope.ts
|
|
20
|
+
const UNBOUND_DOMAIN_NAMESPACE_ID = "__unbound__";
|
|
21
|
+
function resolveSingleDomainNamespaceId(domain, namespaceId) {
|
|
22
|
+
if (namespaceId !== void 0) {
|
|
23
|
+
if (!Object.hasOwn(domain.namespaces, namespaceId)) throw new DomainNamespaceResolutionError(`domain namespace "${namespaceId}" is not present on the contract`);
|
|
24
|
+
return namespaceId;
|
|
25
|
+
}
|
|
26
|
+
const namespaceIds = Object.keys(domain.namespaces);
|
|
27
|
+
if (namespaceIds.length === 0) throw new DomainNamespaceResolutionError("domain has no namespaces");
|
|
28
|
+
if (namespaceIds.length > 1) throw new DomainNamespaceResolutionError(`expected exactly one domain namespace, found ${namespaceIds.length} (${namespaceIds.join(", ")})`);
|
|
29
|
+
const [soleNamespaceId] = namespaceIds;
|
|
30
|
+
if (soleNamespaceId === void 0) throw new DomainNamespaceResolutionError("domain has no namespaces");
|
|
31
|
+
return soleNamespaceId;
|
|
32
|
+
}
|
|
33
|
+
function contractModels(contract, namespaceId) {
|
|
34
|
+
const resolved = resolveSingleDomainNamespaceId(contract.domain, namespaceId);
|
|
35
|
+
const domainNamespace = contract.domain.namespaces[resolved];
|
|
36
|
+
if (domainNamespace === void 0) throw new DomainNamespaceResolutionError(`domain namespace "${resolved}" is not present on the contract`);
|
|
37
|
+
return domainNamespace.models;
|
|
38
|
+
}
|
|
39
|
+
function contractValueObjects(contract, namespaceId) {
|
|
40
|
+
const resolved = resolveSingleDomainNamespaceId(contract.domain, namespaceId);
|
|
41
|
+
const domainNamespace = contract.domain.namespaces[resolved];
|
|
42
|
+
if (domainNamespace === void 0) throw new DomainNamespaceResolutionError(`domain namespace "${resolved}" is not present on the contract`);
|
|
43
|
+
return domainNamespace.valueObjects;
|
|
44
|
+
}
|
|
45
|
+
//#endregion
|
|
46
|
+
//#region src/types.ts
|
|
47
|
+
function executionHash(value) {
|
|
48
|
+
return value;
|
|
49
|
+
}
|
|
50
|
+
function coreHash(value) {
|
|
51
|
+
return value;
|
|
52
|
+
}
|
|
53
|
+
function profileHash(value) {
|
|
54
|
+
return value;
|
|
55
|
+
}
|
|
56
|
+
/**
|
|
57
|
+
* Runtime predicate for `ColumnDefaultLiteralInputValue`. Authoring layers
|
|
58
|
+
* resolve template values from caller-supplied args (typed `unknown` at the
|
|
59
|
+
* boundary) and need to validate before constructing a `ColumnDefault`.
|
|
60
|
+
* Accepts JSON primitives, plain arrays/objects of JSON values, and `Date`
|
|
61
|
+
* instances. Rejects functions, class instances (other than `Date`),
|
|
62
|
+
* `undefined`, `bigint`, `symbol`, and arrays/objects containing those.
|
|
63
|
+
*/
|
|
64
|
+
function isColumnDefaultLiteralInputValue(value) {
|
|
65
|
+
if (value === null) return true;
|
|
66
|
+
const t = typeof value;
|
|
67
|
+
if (t === "string" || t === "number" || t === "boolean") return true;
|
|
68
|
+
if (value instanceof Date) return true;
|
|
69
|
+
if (Array.isArray(value)) return value.every(isColumnDefaultLiteralInputValue);
|
|
70
|
+
if (t === "object" && Object.getPrototypeOf(value) === Object.prototype) return Object.values(value).every(isColumnDefaultLiteralInputValue);
|
|
71
|
+
return false;
|
|
72
|
+
}
|
|
73
|
+
function isColumnDefault(value) {
|
|
74
|
+
if (typeof value !== "object" || value === null) return false;
|
|
75
|
+
const kind = value.kind;
|
|
76
|
+
if (kind === "literal") return "value" in value;
|
|
77
|
+
if (kind === "function") return typeof value.expression === "string";
|
|
78
|
+
return false;
|
|
79
|
+
}
|
|
80
|
+
function isExecutionMutationDefaultValue(value) {
|
|
81
|
+
if (typeof value !== "object" || value === null) return false;
|
|
82
|
+
const candidate = value;
|
|
83
|
+
if (candidate.kind !== "generator") return false;
|
|
84
|
+
if (typeof candidate.id !== "string") return false;
|
|
85
|
+
if (candidate.params !== void 0 && (typeof candidate.params !== "object" || candidate.params === null || Array.isArray(candidate.params))) return false;
|
|
86
|
+
return true;
|
|
87
|
+
}
|
|
88
|
+
//#endregion
|
|
89
|
+
export { CrossReferenceSchema, DomainNamespaceResolutionError, UNBOUND_DOMAIN_NAMESPACE_ID, asNamespaceId, contractModels, contractValueObjects, coreHash, crossRef, executionHash, isColumnDefault, isColumnDefaultLiteralInputValue, isExecutionMutationDefaultValue, profileHash, resolveSingleDomainNamespaceId };
|
|
90
|
+
|
|
91
|
+
//# sourceMappingURL=types.mjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.mjs","names":[],"sources":["../src/cross-reference.ts","../src/domain-envelope.ts","../src/types.ts"],"sourcesContent":["import { blindCast } from '@prisma-next/utils/casts';\nimport { type Type, type } from 'arktype';\nimport { asNamespaceId, type NamespaceId } from './namespace-id';\n\nexport interface CrossReference {\n readonly namespace: NamespaceId;\n readonly model: string;\n}\n\nexport const CrossReferenceSchema = blindCast<\n Type<CrossReference>,\n 'namespace is validated as string at runtime and branded to NamespaceId by asNamespaceId in crossRef(); the schema accepts plain strings but the public type reflects the branded shape'\n>(\n type({\n '+': 'reject',\n namespace: 'string',\n model: 'string',\n }),\n);\n\nconst DEFAULT_CROSS_REF_NAMESPACE = '__unbound__';\n\nexport function crossRef(\n model: string,\n namespace: string = DEFAULT_CROSS_REF_NAMESPACE,\n): CrossReference {\n return { namespace: asNamespaceId(namespace), model };\n}\n","import { DomainNamespaceResolutionError } from './contract-validation-error';\nimport type { ContractModelBase, ContractValueObject } from './domain-types';\n\nexport const UNBOUND_DOMAIN_NAMESPACE_ID = '__unbound__' as const;\n\n/**\n * One namespace's application-domain entities — models and optional value\n * objects keyed by entity name within that namespace coordinate.\n */\nexport interface ApplicationDomainNamespace<\n TModels extends Record<string, ContractModelBase> = Record<string, ContractModelBase>,\n> {\n readonly models: TModels;\n readonly valueObjects?: Record<string, ContractValueObject>;\n}\n\n/**\n * Application-domain envelope: entity content keyed by namespace id.\n * Mirrors the storage plane's `namespaces` segment (ADR 221).\n */\nexport interface ApplicationDomain<\n TModels extends Record<string, ContractModelBase> = Record<string, ContractModelBase>,\n> {\n readonly namespaces: Readonly<Record<string, ApplicationDomainNamespace<TModels>>>;\n}\n\nexport type ContractWithDomain = {\n readonly domain: ApplicationDomain;\n};\n\nexport function resolveSingleDomainNamespaceId(\n domain: ApplicationDomain,\n namespaceId?: string,\n): string {\n if (namespaceId !== undefined) {\n if (!Object.hasOwn(domain.namespaces, namespaceId)) {\n throw new DomainNamespaceResolutionError(\n `domain namespace \"${namespaceId}\" is not present on the contract`,\n );\n }\n return namespaceId;\n }\n\n const namespaceIds = Object.keys(domain.namespaces);\n if (namespaceIds.length === 0) {\n throw new DomainNamespaceResolutionError('domain has no namespaces');\n }\n if (namespaceIds.length > 1) {\n throw new DomainNamespaceResolutionError(\n `expected exactly one domain namespace, found ${namespaceIds.length} (${namespaceIds.join(', ')})`,\n );\n }\n const [soleNamespaceId] = namespaceIds;\n if (soleNamespaceId === undefined) {\n throw new DomainNamespaceResolutionError('domain has no namespaces');\n }\n return soleNamespaceId;\n}\n\n// Transitional single-namespace projection; pending runtime-qualification slice.\nexport function contractModels<TModels extends Record<string, ContractModelBase>>(\n contract: { readonly domain: ApplicationDomain<TModels> },\n namespaceId?: string,\n): TModels {\n const resolved = resolveSingleDomainNamespaceId(contract.domain, namespaceId);\n const domainNamespace = contract.domain.namespaces[resolved];\n if (domainNamespace === undefined) {\n throw new DomainNamespaceResolutionError(\n `domain namespace \"${resolved}\" is not present on the contract`,\n );\n }\n return domainNamespace.models;\n}\n\nexport function contractValueObjects<TModels extends Record<string, ContractModelBase>>(\n contract: { readonly domain: ApplicationDomain<TModels> },\n namespaceId?: string,\n): Record<string, ContractValueObject> | undefined {\n const resolved = resolveSingleDomainNamespaceId(contract.domain, namespaceId);\n const domainNamespace = contract.domain.namespaces[resolved];\n if (domainNamespace === undefined) {\n throw new DomainNamespaceResolutionError(\n `domain namespace \"${resolved}\" is not present on the contract`,\n );\n }\n return domainNamespace.valueObjects;\n}\n","/**\n * Unique symbol used as the key for branding types.\n */\nexport const $: unique symbol = Symbol('__prisma_next_brand__');\n\n/**\n * A helper type to brand a given type with a unique identifier.\n *\n * @template TKey Text used as the brand key.\n * @template TValue Optional value associated with the brand key. Defaults to `true`.\n */\nexport type Brand<TKey extends string | number | symbol, TValue = true> = {\n [$]: {\n [K in TKey]: TValue;\n };\n};\n\n/**\n * Base type for storage contract hashes.\n * Emitted contract.d.ts files use this with the hash value as a type parameter:\n * `type StorageHash = StorageHashBase<'sha256:abc123...'>`\n */\nexport type StorageHashBase<THash extends string> = THash & Brand<'StorageHash'>;\n\n/**\n * Base type for execution contract hashes.\n * Emitted contract.d.ts files use this with the hash value as a type parameter:\n * `type ExecutionHash = ExecutionHashBase<'sha256:def456...'>`\n */\nexport type ExecutionHashBase<THash extends string> = THash & Brand<'ExecutionHash'>;\n\nexport function executionHash<const T extends string>(value: T): ExecutionHashBase<T> {\n return value as ExecutionHashBase<T>;\n}\n\nexport function coreHash<const T extends string>(value: T): StorageHashBase<T> {\n return value as StorageHashBase<T>;\n}\n\n/**\n * Base type for profile contract hashes.\n * Emitted contract.d.ts files use this with the hash value as a type parameter:\n * `type ProfileHash = ProfileHashBase<'sha256:def456...'>`\n */\nexport type ProfileHashBase<THash extends string> = THash & Brand<'ProfileHash'>;\n\nexport function profileHash<const T extends string>(value: T): ProfileHashBase<T> {\n return value as ProfileHashBase<T>;\n}\n\n/**\n * One entity-kind slot in a namespace — a map of entity name to entry.\n * Values are opaque at the foundation layer; family and target concretions\n * refine them to typed IR classes.\n */\nexport type StorageEntitySlot = Readonly<Record<string, unknown>>;\n\n/**\n * Plain-data namespace entry in a storage block. Every hydrated contract\n * carries at least `id` plus zero or more entity-kind slot maps (`tables`,\n * `collections`, …). Foundation declares only this shape — no IR machinery.\n */\nexport interface StorageNamespace {\n readonly id: string;\n}\n\n/**\n * Base type for family-specific storage blocks.\n * Family storage types (SqlStorage, MongoStorage, etc.) extend this to carry the\n * storage hash alongside family-specific data (tables, collections, etc.).\n *\n * The `namespaces` map is carried by every hydrated storage block. Serialized\n * envelope shape is target-owned; this types the in-memory contract after\n * `deserializeContract`.\n */\nexport interface StorageBase<THash extends string = string> {\n readonly storageHash: StorageHashBase<THash>;\n readonly namespaces: Readonly<Record<string, StorageNamespace>>;\n}\n\nexport interface FieldType {\n readonly type: string;\n readonly nullable: boolean;\n readonly items?: FieldType;\n readonly properties?: Record<string, FieldType>;\n}\n\nexport type GeneratedValueSpec = {\n readonly id: string;\n readonly params?: Record<string, unknown>;\n};\n\nexport type JsonPrimitive = string | number | boolean | null;\n\nexport type JsonValue =\n | JsonPrimitive\n | { readonly [key: string]: JsonValue }\n | readonly JsonValue[];\n\nexport type ColumnDefaultLiteralValue = JsonValue;\n\nexport type ColumnDefaultLiteralInputValue = ColumnDefaultLiteralValue | Date;\n\n/**\n * Runtime predicate for `ColumnDefaultLiteralInputValue`. Authoring layers\n * resolve template values from caller-supplied args (typed `unknown` at the\n * boundary) and need to validate before constructing a `ColumnDefault`.\n * Accepts JSON primitives, plain arrays/objects of JSON values, and `Date`\n * instances. Rejects functions, class instances (other than `Date`),\n * `undefined`, `bigint`, `symbol`, and arrays/objects containing those.\n */\nexport function isColumnDefaultLiteralInputValue(\n value: unknown,\n): value is ColumnDefaultLiteralInputValue {\n if (value === null) return true;\n const t = typeof value;\n if (t === 'string' || t === 'number' || t === 'boolean') return true;\n if (value instanceof Date) return true;\n if (Array.isArray(value)) return value.every(isColumnDefaultLiteralInputValue);\n if (t === 'object' && Object.getPrototypeOf(value) === Object.prototype) {\n return Object.values(value as Record<string, unknown>).every(isColumnDefaultLiteralInputValue);\n }\n return false;\n}\n\nexport type ColumnDefault =\n | {\n readonly kind: 'literal';\n readonly value: ColumnDefaultLiteralInputValue;\n }\n | { readonly kind: 'function'; readonly expression: string };\n\nexport function isColumnDefault(value: unknown): value is ColumnDefault {\n if (typeof value !== 'object' || value === null) return false;\n const kind = (value as { kind?: unknown }).kind;\n if (kind === 'literal') {\n return 'value' in value;\n }\n if (kind === 'function') {\n return typeof (value as { expression?: unknown }).expression === 'string';\n }\n return false;\n}\n\nexport type ExecutionMutationDefaultValue = {\n readonly kind: 'generator';\n readonly id: GeneratedValueSpec['id'];\n readonly params?: Record<string, unknown>;\n};\n\nexport function isExecutionMutationDefaultValue(\n value: unknown,\n): value is ExecutionMutationDefaultValue {\n if (typeof value !== 'object' || value === null) return false;\n const candidate = value as {\n kind?: unknown;\n id?: unknown;\n params?: unknown;\n };\n if (candidate.kind !== 'generator') return false;\n if (typeof candidate.id !== 'string') return false;\n if (\n candidate.params !== undefined &&\n (typeof candidate.params !== 'object' ||\n candidate.params === null ||\n Array.isArray(candidate.params))\n ) {\n return false;\n }\n return true;\n}\n\nexport type ExecutionMutationDefault = {\n readonly ref: { readonly table: string; readonly column: string };\n readonly onCreate?: ExecutionMutationDefaultValue;\n readonly onUpdate?: ExecutionMutationDefaultValue;\n};\n\n/**\n * `ExecutionMutationDefault` minus its `ref` — the per-field phases value\n * authoring layers attach to a column before the column ref is known.\n */\nexport type ExecutionMutationDefaultPhases = Omit<ExecutionMutationDefault, 'ref'>;\n\nexport type ExecutionSection<THash extends string = string> = {\n readonly executionHash: ExecutionHashBase<THash>;\n readonly mutations: {\n readonly defaults: ReadonlyArray<ExecutionMutationDefault>;\n };\n};\n\nexport interface Source {\n readonly readOnly: boolean;\n readonly projection: Record<string, FieldType>;\n readonly origin?: Record<string, unknown>;\n readonly capabilities?: Record<string, boolean>;\n}\n\n// Document family types\nexport interface DocIndex {\n readonly name: string;\n readonly keys: Record<string, 'asc' | 'desc'>;\n readonly unique?: boolean;\n readonly where?: Expr;\n}\n\nexport type Expr =\n | { readonly kind: 'eq'; readonly path: ReadonlyArray<string>; readonly value: unknown }\n | { readonly kind: 'exists'; readonly path: ReadonlyArray<string> };\n\nexport interface DocCollection {\n readonly name: string;\n readonly id?: {\n readonly strategy: 'auto' | 'client' | 'uuid' | 'objectId';\n };\n readonly fields: Record<string, FieldType>;\n readonly indexes?: ReadonlyArray<DocIndex>;\n readonly readOnly?: boolean;\n}\n\nexport interface PlanMeta {\n readonly target: string;\n readonly targetFamily?: string;\n readonly storageHash: string;\n readonly profileHash?: string;\n readonly lane: string;\n readonly annotations?: {\n readonly [key: string]: unknown;\n };\n}\n\n/**\n * Contract marker record stored in the database.\n * Represents the current contract identity for a database.\n */\nexport interface ContractMarkerRecord {\n readonly storageHash: string;\n readonly profileHash: string;\n readonly contractJson: unknown | null;\n readonly canonicalVersion: number | null;\n readonly updatedAt: Date;\n readonly appTag: string | null;\n readonly meta: Record<string, unknown>;\n readonly invariants: readonly string[];\n}\n"],"mappings":";;;;;AASA,MAAa,uBAAuB,UAIlC,KAAK;CACH,KAAK;CACL,WAAW;CACX,OAAO;AACT,CAAC,CACH;AAEA,MAAM,8BAA8B;AAEpC,SAAgB,SACd,OACA,YAAoB,6BACJ;CAChB,OAAO;EAAE,WAAW,cAAc,SAAS;EAAG;CAAM;AACtD;;;ACxBA,MAAa,8BAA8B;AA2B3C,SAAgB,+BACd,QACA,aACQ;CACR,IAAI,gBAAgB,KAAA,GAAW;EAC7B,IAAI,CAAC,OAAO,OAAO,OAAO,YAAY,WAAW,GAC/C,MAAM,IAAI,+BACR,qBAAqB,YAAY,iCACnC;EAEF,OAAO;CACT;CAEA,MAAM,eAAe,OAAO,KAAK,OAAO,UAAU;CAClD,IAAI,aAAa,WAAW,GAC1B,MAAM,IAAI,+BAA+B,0BAA0B;CAErE,IAAI,aAAa,SAAS,GACxB,MAAM,IAAI,+BACR,gDAAgD,aAAa,OAAO,IAAI,aAAa,KAAK,IAAI,EAAE,EAClG;CAEF,MAAM,CAAC,mBAAmB;CAC1B,IAAI,oBAAoB,KAAA,GACtB,MAAM,IAAI,+BAA+B,0BAA0B;CAErE,OAAO;AACT;AAGA,SAAgB,eACd,UACA,aACS;CACT,MAAM,WAAW,+BAA+B,SAAS,QAAQ,WAAW;CAC5E,MAAM,kBAAkB,SAAS,OAAO,WAAW;CACnD,IAAI,oBAAoB,KAAA,GACtB,MAAM,IAAI,+BACR,qBAAqB,SAAS,iCAChC;CAEF,OAAO,gBAAgB;AACzB;AAEA,SAAgB,qBACd,UACA,aACiD;CACjD,MAAM,WAAW,+BAA+B,SAAS,QAAQ,WAAW;CAC5E,MAAM,kBAAkB,SAAS,OAAO,WAAW;CACnD,IAAI,oBAAoB,KAAA,GACtB,MAAM,IAAI,+BACR,qBAAqB,SAAS,iCAChC;CAEF,OAAO,gBAAgB;AACzB;;;ACvDA,SAAgB,cAAsC,OAAgC;CACpF,OAAO;AACT;AAEA,SAAgB,SAAiC,OAA8B;CAC7E,OAAO;AACT;AASA,SAAgB,YAAoC,OAA8B;CAChF,OAAO;AACT;;;;;;;;;AA+DA,SAAgB,iCACd,OACyC;CACzC,IAAI,UAAU,MAAM,OAAO;CAC3B,MAAM,IAAI,OAAO;CACjB,IAAI,MAAM,YAAY,MAAM,YAAY,MAAM,WAAW,OAAO;CAChE,IAAI,iBAAiB,MAAM,OAAO;CAClC,IAAI,MAAM,QAAQ,KAAK,GAAG,OAAO,MAAM,MAAM,gCAAgC;CAC7E,IAAI,MAAM,YAAY,OAAO,eAAe,KAAK,MAAM,OAAO,WAC5D,OAAO,OAAO,OAAO,KAAgC,EAAE,MAAM,gCAAgC;CAE/F,OAAO;AACT;AASA,SAAgB,gBAAgB,OAAwC;CACtE,IAAI,OAAO,UAAU,YAAY,UAAU,MAAM,OAAO;CACxD,MAAM,OAAQ,MAA6B;CAC3C,IAAI,SAAS,WACX,OAAO,WAAW;CAEpB,IAAI,SAAS,YACX,OAAO,OAAQ,MAAmC,eAAe;CAEnE,OAAO;AACT;AAQA,SAAgB,gCACd,OACwC;CACxC,IAAI,OAAO,UAAU,YAAY,UAAU,MAAM,OAAO;CACxD,MAAM,YAAY;CAKlB,IAAI,UAAU,SAAS,aAAa,OAAO;CAC3C,IAAI,OAAO,UAAU,OAAO,UAAU,OAAO;CAC7C,IACE,UAAU,WAAW,KAAA,MACpB,OAAO,UAAU,WAAW,YAC3B,UAAU,WAAW,QACrB,MAAM,QAAQ,UAAU,MAAM,IAEhC,OAAO;CAET,OAAO;AACT"}
|
|
@@ -1,22 +1,20 @@
|
|
|
1
|
+
import { T as CrossReference, r as ContractWithDomain } from "./domain-envelope-4hyFtJ4_.mjs";
|
|
2
|
+
|
|
1
3
|
//#region src/validate-domain.d.ts
|
|
2
4
|
interface DomainModelShape {
|
|
3
5
|
readonly fields: Record<string, unknown>;
|
|
4
6
|
readonly relations?: Record<string, {
|
|
5
|
-
readonly to:
|
|
7
|
+
readonly to: CrossReference;
|
|
6
8
|
}>;
|
|
7
9
|
readonly discriminator?: {
|
|
8
10
|
readonly field: string;
|
|
9
11
|
};
|
|
10
12
|
readonly variants?: Record<string, unknown>;
|
|
11
|
-
readonly base?:
|
|
13
|
+
readonly base?: CrossReference;
|
|
12
14
|
readonly owner?: string;
|
|
13
15
|
}
|
|
14
|
-
interface DomainContractShape {
|
|
15
|
-
readonly roots: Record<string,
|
|
16
|
-
readonly models: Record<string, DomainModelShape>;
|
|
17
|
-
readonly valueObjects?: Record<string, {
|
|
18
|
-
readonly fields: Record<string, unknown>;
|
|
19
|
-
}>;
|
|
16
|
+
interface DomainContractShape extends ContractWithDomain {
|
|
17
|
+
readonly roots: Record<string, CrossReference>;
|
|
20
18
|
}
|
|
21
19
|
declare function validateContractDomain(contract: DomainContractShape): void;
|
|
22
20
|
//#endregion
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"validate-domain.d.mts","names":[],"sources":["../src/validate-domain.ts"],"mappings":"
|
|
1
|
+
{"version":3,"file":"validate-domain.d.mts","names":[],"sources":["../src/validate-domain.ts"],"mappings":";;;UAKiB,gBAAA;EAAA,SACN,MAAA,EAAQ,MAAA;EAAA,SACR,SAAA,GAAY,MAAA;IAAA,SAA0B,EAAA,EAAI,cAAA;EAAA;EAAA,SAC1C,aAAA;IAAA,SAA2B,KAAA;EAAA;EAAA,SAC3B,QAAA,GAAW,MAAA;EAAA,SACX,IAAA,GAAO,cAAA;EAAA,SACP,KAAA;AAAA;AAAA,UAGM,mBAAA,SAA4B,kBAAA;EAAA,SAClC,KAAA,EAAO,MAAA,SAAe,cAAA;AAAA;AAAA,iBAuCjB,sBAAA,CAAuB,QAA6B,EAAnB,mBAAmB"}
|
package/dist/validate-domain.mjs
CHANGED
|
@@ -1,95 +1,138 @@
|
|
|
1
|
-
import { t as ContractValidationError } from "./contract-validation-error-
|
|
1
|
+
import { t as ContractValidationError } from "./contract-validation-error-ClZaKqMW.mjs";
|
|
2
|
+
import { t as asNamespaceId } from "./namespace-id-CVpkSFUK.mjs";
|
|
2
3
|
//#region src/validate-domain.ts
|
|
4
|
+
function indexDomainModels(contract) {
|
|
5
|
+
const index = /* @__PURE__ */ new Map();
|
|
6
|
+
for (const [namespaceKey, namespace] of Object.entries(contract.domain.namespaces)) {
|
|
7
|
+
const namespaceId = asNamespaceId(namespaceKey);
|
|
8
|
+
let modelsInNamespace = index.get(namespaceId);
|
|
9
|
+
if (modelsInNamespace === void 0) {
|
|
10
|
+
modelsInNamespace = /* @__PURE__ */ new Map();
|
|
11
|
+
index.set(namespaceId, modelsInNamespace);
|
|
12
|
+
}
|
|
13
|
+
for (const [name, model] of Object.entries(namespace.models)) modelsInNamespace.set(name, {
|
|
14
|
+
namespaceId,
|
|
15
|
+
name,
|
|
16
|
+
model
|
|
17
|
+
});
|
|
18
|
+
}
|
|
19
|
+
return index;
|
|
20
|
+
}
|
|
21
|
+
function lookupModel(index, ref) {
|
|
22
|
+
return index.get(ref.namespace)?.get(ref.model);
|
|
23
|
+
}
|
|
24
|
+
function* iterateIndexedModels(index) {
|
|
25
|
+
for (const modelsInNamespace of index.values()) for (const entry of modelsInNamespace.values()) yield entry;
|
|
26
|
+
}
|
|
3
27
|
function validateContractDomain(contract) {
|
|
4
28
|
const errors = [];
|
|
5
|
-
const
|
|
6
|
-
validateRoots(contract,
|
|
7
|
-
validateVariantsAndBases(
|
|
8
|
-
validateRelationTargets(
|
|
9
|
-
validateDiscriminators(
|
|
10
|
-
validateOwnership(contract,
|
|
29
|
+
const modelIndex = indexDomainModels(contract);
|
|
30
|
+
validateRoots(contract, modelIndex, errors);
|
|
31
|
+
validateVariantsAndBases(modelIndex, errors);
|
|
32
|
+
validateRelationTargets(modelIndex, errors);
|
|
33
|
+
validateDiscriminators(modelIndex, errors);
|
|
34
|
+
validateOwnership(contract, modelIndex, errors);
|
|
11
35
|
validateValueObjectReferences(contract, errors);
|
|
12
|
-
validateFieldModifiers(contract, errors);
|
|
36
|
+
validateFieldModifiers(modelIndex, contract, errors);
|
|
13
37
|
if (errors.length > 0) throw new ContractValidationError(`Contract domain validation failed:\n- ${errors.join("\n- ")}`, "domain");
|
|
14
38
|
}
|
|
15
|
-
function validateRoots(contract,
|
|
16
|
-
const
|
|
17
|
-
for (const [rootKey,
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
39
|
+
function validateRoots(contract, modelIndex, errors) {
|
|
40
|
+
const seenRootTargets = /* @__PURE__ */ new Map();
|
|
41
|
+
for (const [rootKey, crossRef] of Object.entries(contract.roots)) {
|
|
42
|
+
let modelsInNamespace = seenRootTargets.get(crossRef.namespace);
|
|
43
|
+
if (modelsInNamespace === void 0) {
|
|
44
|
+
modelsInNamespace = /* @__PURE__ */ new Set();
|
|
45
|
+
seenRootTargets.set(crossRef.namespace, modelsInNamespace);
|
|
46
|
+
}
|
|
47
|
+
if (modelsInNamespace.has(crossRef.model)) errors.push(`Duplicate root value: "${crossRef.namespace}:${crossRef.model}" is mapped by multiple root keys`);
|
|
48
|
+
modelsInNamespace.add(crossRef.model);
|
|
49
|
+
if (!lookupModel(modelIndex, crossRef)) errors.push(`Root "${rootKey}" references model "${crossRef.namespace}:${crossRef.model}" which does not exist in domain.namespaces`);
|
|
21
50
|
}
|
|
22
51
|
}
|
|
23
|
-
function validateVariantsAndBases(
|
|
24
|
-
const
|
|
25
|
-
for (const [modelName, model] of models) {
|
|
52
|
+
function validateVariantsAndBases(modelIndex, errors) {
|
|
53
|
+
for (const { namespaceId, name: modelName, model } of iterateIndexedModels(modelIndex)) {
|
|
26
54
|
if (model.variants) for (const variantName of Object.keys(model.variants)) {
|
|
27
|
-
|
|
28
|
-
|
|
55
|
+
const variantEntry = lookupModel(modelIndex, {
|
|
56
|
+
namespace: namespaceId,
|
|
57
|
+
model: variantName
|
|
58
|
+
});
|
|
59
|
+
if (!variantEntry) {
|
|
60
|
+
errors.push(`Model "${namespaceId}:${modelName}" lists variant "${variantName}" which does not exist at that namespace coordinate`);
|
|
29
61
|
continue;
|
|
30
62
|
}
|
|
31
|
-
const
|
|
32
|
-
if (
|
|
33
|
-
if (variantModel.base !== modelName) errors.push(`Variant "${variantName}" has base "${variantModel.base ?? "(none)"}" but expected "${modelName}"`);
|
|
63
|
+
const variantBase = variantEntry.model.base;
|
|
64
|
+
if (variantBase?.namespace !== namespaceId || variantBase?.model !== modelName) errors.push(`Variant "${namespaceId}:${variantName}" has base "${variantBase?.namespace ?? "?"}:${variantBase?.model ?? "(none)"}" but expected "${namespaceId}:${modelName}"`);
|
|
34
65
|
}
|
|
35
66
|
if (model.base) {
|
|
36
|
-
|
|
37
|
-
|
|
67
|
+
const baseEntry = lookupModel(modelIndex, model.base);
|
|
68
|
+
if (!baseEntry) {
|
|
69
|
+
errors.push(`Model "${namespaceId}:${modelName}" has base "${model.base.namespace}:${model.base.model}" which does not exist in domain.namespaces`);
|
|
38
70
|
continue;
|
|
39
71
|
}
|
|
40
|
-
|
|
41
|
-
if (!baseModel) continue;
|
|
42
|
-
if (!baseModel.variants || !Object.hasOwn(baseModel.variants, modelName)) errors.push(`Model "${modelName}" has base "${model.base}" which does not list it as a variant`);
|
|
72
|
+
if (!baseEntry.model.variants || !Object.hasOwn(baseEntry.model.variants, modelName)) errors.push(`Model "${namespaceId}:${modelName}" has base "${model.base.namespace}:${model.base.model}" which does not list it as a variant`);
|
|
43
73
|
}
|
|
44
74
|
}
|
|
45
75
|
}
|
|
46
|
-
function validateRelationTargets(
|
|
47
|
-
for (const
|
|
76
|
+
function validateRelationTargets(modelIndex, errors) {
|
|
77
|
+
for (const { namespaceId, name: modelName, model } of iterateIndexedModels(modelIndex)) for (const [relName, relation] of Object.entries(model.relations ?? {})) if (!lookupModel(modelIndex, relation.to)) errors.push(`Relation "${relName}" on model "${namespaceId}:${modelName}" targets "${relation.to.namespace}:${relation.to.model}" which does not exist in domain.namespaces`);
|
|
48
78
|
}
|
|
49
|
-
function validateDiscriminators(
|
|
50
|
-
for (const
|
|
79
|
+
function validateDiscriminators(modelIndex, errors) {
|
|
80
|
+
for (const { namespaceId, name: modelName, model } of iterateIndexedModels(modelIndex)) {
|
|
51
81
|
if (model.discriminator) {
|
|
52
|
-
if (!model.variants || Object.keys(model.variants).length === 0) errors.push(`Model "${modelName}" has discriminator but no variants`);
|
|
53
|
-
if (!Object.hasOwn(model.fields, model.discriminator.field)) errors.push(`Discriminator field "${model.discriminator.field}" is not a field on model "${modelName}"`);
|
|
82
|
+
if (!model.variants || Object.keys(model.variants).length === 0) errors.push(`Model "${namespaceId}:${modelName}" has discriminator but no variants`);
|
|
83
|
+
if (!Object.hasOwn(model.fields, model.discriminator.field)) errors.push(`Discriminator field "${model.discriminator.field}" is not a field on model "${namespaceId}:${modelName}"`);
|
|
54
84
|
}
|
|
55
|
-
if (model.variants && Object.keys(model.variants).length > 0 && !model.discriminator) errors.push(`Model "${modelName}" has variants but no discriminator`);
|
|
85
|
+
if (model.variants && Object.keys(model.variants).length > 0 && !model.discriminator) errors.push(`Model "${namespaceId}:${modelName}" has variants but no discriminator`);
|
|
56
86
|
if (model.base) {
|
|
57
|
-
if (model.discriminator) errors.push(`Model "${modelName}" has base and must not have discriminator`);
|
|
58
|
-
if (model.variants && Object.keys(model.variants).length > 0) errors.push(`Model "${modelName}" has base and must not have variants`);
|
|
87
|
+
if (model.discriminator) errors.push(`Model "${namespaceId}:${modelName}" has base and must not have discriminator`);
|
|
88
|
+
if (model.variants && Object.keys(model.variants).length > 0) errors.push(`Model "${namespaceId}:${modelName}" has base and must not have variants`);
|
|
59
89
|
}
|
|
60
90
|
}
|
|
61
91
|
}
|
|
62
|
-
function validateOwnership(contract,
|
|
63
|
-
for (const
|
|
92
|
+
function validateOwnership(contract, modelIndex, errors) {
|
|
93
|
+
for (const { namespaceId, name: modelName, model } of iterateIndexedModels(modelIndex)) {
|
|
64
94
|
if (!model.owner) continue;
|
|
65
|
-
if (model.owner === modelName) errors.push(`Model "${modelName}" cannot own itself`);
|
|
66
|
-
if (!
|
|
67
|
-
|
|
95
|
+
if (model.owner === modelName) errors.push(`Model "${namespaceId}:${modelName}" cannot own itself`);
|
|
96
|
+
if (!lookupModel(modelIndex, {
|
|
97
|
+
namespace: namespaceId,
|
|
98
|
+
model: model.owner
|
|
99
|
+
})) errors.push(`Model "${namespaceId}:${modelName}" has owner "${namespaceId}:${model.owner}" which does not exist in domain.namespaces`);
|
|
100
|
+
for (const [rootKey, rootRef] of Object.entries(contract.roots)) if (rootRef.namespace === namespaceId && rootRef.model === modelName) errors.push(`Owned model "${namespaceId}:${modelName}" must not appear in roots (found as root "${rootKey}")`);
|
|
68
101
|
}
|
|
69
102
|
}
|
|
70
|
-
function forEachContractField(contract, callback) {
|
|
71
|
-
for (const [modelName, model] of Object.entries(contract.models)) for (const [fieldName, field] of Object.entries(model.fields)) callback(field, `Model "${modelName}" field "${fieldName}"`);
|
|
72
|
-
for (const [voName, vo] of Object.entries(contract.valueObjects ?? {})) for (const [fieldName, field] of Object.entries(vo.fields)) callback(field, `Value object "${voName}" field "${fieldName}"`);
|
|
73
|
-
}
|
|
74
103
|
function validateValueObjectReferences(contract, errors) {
|
|
75
|
-
const
|
|
76
|
-
|
|
104
|
+
const voNamesByNamespace = /* @__PURE__ */ new Map();
|
|
105
|
+
for (const [namespaceKey, namespace] of Object.entries(contract.domain.namespaces)) {
|
|
106
|
+
const namespaceId = asNamespaceId(namespaceKey);
|
|
107
|
+
voNamesByNamespace.set(namespaceId, new Set(Object.keys(namespace.valueObjects ?? {})));
|
|
108
|
+
}
|
|
109
|
+
function checkType(type, location, namespaceId) {
|
|
77
110
|
if (!type) return;
|
|
111
|
+
const voNames = voNamesByNamespace.get(namespaceId) ?? /* @__PURE__ */ new Set();
|
|
78
112
|
if (type.kind === "valueObject" && type.name && !voNames.has(type.name)) {
|
|
79
|
-
errors.push(`${location} references value object "${type.name}" which does not exist in valueObjects`);
|
|
113
|
+
errors.push(`${location} references value object "${namespaceId}:${type.name}" which does not exist in that namespace's valueObjects`);
|
|
80
114
|
return;
|
|
81
115
|
}
|
|
82
|
-
if (type.kind === "union") for (const member of type.members ?? []) checkType(member, location);
|
|
116
|
+
if (type.kind === "union") for (const member of type.members ?? []) checkType(member, location, namespaceId);
|
|
117
|
+
}
|
|
118
|
+
for (const [namespaceKey, namespace] of Object.entries(contract.domain.namespaces)) {
|
|
119
|
+
const namespaceId = asNamespaceId(namespaceKey);
|
|
120
|
+
for (const [modelName, model] of Object.entries(namespace.models)) for (const [fieldName, field] of Object.entries(model.fields)) checkType(field?.type, `Model "${namespaceId}:${modelName}" field "${fieldName}"`, namespaceId);
|
|
121
|
+
for (const [voName, vo] of Object.entries(namespace.valueObjects ?? {})) for (const [fieldName, field] of Object.entries(vo.fields)) checkType(field?.type, `Value object "${namespaceId}:${voName}" field "${fieldName}"`, namespaceId);
|
|
83
122
|
}
|
|
84
|
-
forEachContractField(contract, (field, location) => {
|
|
85
|
-
checkType(field?.type, location);
|
|
86
|
-
});
|
|
87
123
|
}
|
|
88
|
-
function validateFieldModifiers(contract, errors) {
|
|
89
|
-
|
|
124
|
+
function validateFieldModifiers(modelIndex, contract, errors) {
|
|
125
|
+
for (const { namespaceId, name: modelName, model } of iterateIndexedModels(modelIndex)) for (const [fieldName, field] of Object.entries(model.fields)) {
|
|
90
126
|
const f = field;
|
|
91
|
-
if (f?.many && f?.dict) errors.push(
|
|
92
|
-
}
|
|
127
|
+
if (f?.many && f?.dict) errors.push(`Model "${namespaceId}:${modelName}" field "${fieldName}" cannot have both "many" and "dict" modifiers`);
|
|
128
|
+
}
|
|
129
|
+
for (const [namespaceKey, namespace] of Object.entries(contract.domain.namespaces)) {
|
|
130
|
+
const namespaceId = asNamespaceId(namespaceKey);
|
|
131
|
+
for (const [voName, vo] of Object.entries(namespace.valueObjects ?? {})) for (const [fieldName, field] of Object.entries(vo.fields)) {
|
|
132
|
+
const f = field;
|
|
133
|
+
if (f?.many && f?.dict) errors.push(`Value object "${namespaceId}:${voName}" field "${fieldName}" cannot have both "many" and "dict" modifiers`);
|
|
134
|
+
}
|
|
135
|
+
}
|
|
93
136
|
}
|
|
94
137
|
//#endregion
|
|
95
138
|
export { validateContractDomain };
|