@inventarch/db 0.0.0-stage → 1.0.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.
Files changed (93) hide show
  1. package/LICENSE +202 -0
  2. package/NOTICE +4 -0
  3. package/README.md +19 -2
  4. package/SPEC.md +71 -0
  5. package/dist/cache.d.ts +13 -0
  6. package/dist/cache.d.ts.map +1 -0
  7. package/dist/cache.js +49 -0
  8. package/dist/cache.js.map +1 -0
  9. package/dist/descriptors/app.d.ts +89 -0
  10. package/dist/descriptors/app.d.ts.map +1 -0
  11. package/dist/descriptors/app.js +231 -0
  12. package/dist/descriptors/app.js.map +1 -0
  13. package/dist/descriptors/codec.d.ts +102 -0
  14. package/dist/descriptors/codec.d.ts.map +1 -0
  15. package/dist/descriptors/codec.js +383 -0
  16. package/dist/descriptors/codec.js.map +1 -0
  17. package/dist/descriptors/domain.d.ts +141 -0
  18. package/dist/descriptors/domain.d.ts.map +1 -0
  19. package/dist/descriptors/domain.js +287 -0
  20. package/dist/descriptors/domain.js.map +1 -0
  21. package/dist/descriptors/envelope.d.ts +52 -0
  22. package/dist/descriptors/envelope.d.ts.map +1 -0
  23. package/dist/descriptors/envelope.js +175 -0
  24. package/dist/descriptors/envelope.js.map +1 -0
  25. package/dist/descriptors/index.d.ts +18 -0
  26. package/dist/descriptors/index.d.ts.map +1 -0
  27. package/dist/descriptors/index.js +12 -0
  28. package/dist/descriptors/index.js.map +1 -0
  29. package/dist/descriptors/registry.d.ts +37 -0
  30. package/dist/descriptors/registry.d.ts.map +1 -0
  31. package/dist/descriptors/registry.js +87 -0
  32. package/dist/descriptors/registry.js.map +1 -0
  33. package/dist/descriptors/storage.d.ts +60 -0
  34. package/dist/descriptors/storage.d.ts.map +1 -0
  35. package/dist/descriptors/storage.js +158 -0
  36. package/dist/descriptors/storage.js.map +1 -0
  37. package/dist/distribution/codec.d.ts +40 -0
  38. package/dist/distribution/codec.d.ts.map +1 -0
  39. package/dist/distribution/codec.js +181 -0
  40. package/dist/distribution/codec.js.map +1 -0
  41. package/dist/distribution/contracts.d.ts +94 -0
  42. package/dist/distribution/contracts.d.ts.map +1 -0
  43. package/dist/distribution/contracts.js +241 -0
  44. package/dist/distribution/contracts.js.map +1 -0
  45. package/dist/distribution/index.d.ts +9 -0
  46. package/dist/distribution/index.d.ts.map +1 -0
  47. package/dist/distribution/index.js +5 -0
  48. package/dist/distribution/index.js.map +1 -0
  49. package/dist/distribution/membership.d.ts +9 -0
  50. package/dist/distribution/membership.d.ts.map +1 -0
  51. package/dist/distribution/membership.js +61 -0
  52. package/dist/distribution/membership.js.map +1 -0
  53. package/dist/distribution/reader.d.ts +32 -0
  54. package/dist/distribution/reader.d.ts.map +1 -0
  55. package/dist/distribution/reader.js +226 -0
  56. package/dist/distribution/reader.js.map +1 -0
  57. package/dist/editor/index.d.ts +40 -0
  58. package/dist/editor/index.d.ts.map +1 -0
  59. package/dist/editor/index.js +173 -0
  60. package/dist/editor/index.js.map +1 -0
  61. package/dist/errors.d.ts +7 -0
  62. package/dist/errors.d.ts.map +1 -0
  63. package/dist/errors.js +22 -0
  64. package/dist/errors.js.map +1 -0
  65. package/dist/handle.d.ts +80 -0
  66. package/dist/handle.d.ts.map +1 -0
  67. package/dist/handle.js +227 -0
  68. package/dist/handle.js.map +1 -0
  69. package/dist/index.d.ts +11 -0
  70. package/dist/index.d.ts.map +1 -0
  71. package/dist/index.js +5 -0
  72. package/dist/index.js.map +1 -0
  73. package/dist/inputs.d.ts +46 -0
  74. package/dist/inputs.d.ts.map +1 -0
  75. package/dist/inputs.js +397 -0
  76. package/dist/inputs.js.map +1 -0
  77. package/dist/json.d.ts +18 -0
  78. package/dist/json.d.ts.map +1 -0
  79. package/dist/json.js +100 -0
  80. package/dist/json.js.map +1 -0
  81. package/dist/paths.d.ts +42 -0
  82. package/dist/paths.d.ts.map +1 -0
  83. package/dist/paths.js +119 -0
  84. package/dist/paths.js.map +1 -0
  85. package/dist/preview.d.ts +19 -0
  86. package/dist/preview.d.ts.map +1 -0
  87. package/dist/preview.js +70 -0
  88. package/dist/preview.js.map +1 -0
  89. package/dist/view.d.ts +22 -0
  90. package/dist/view.d.ts.map +1 -0
  91. package/dist/view.js +221 -0
  92. package/dist/view.js.map +1 -0
  93. package/package.json +147 -3
@@ -0,0 +1,37 @@
1
+ import type { ContractRef, DescriptorResult } from './codec.js';
2
+ export type ContractKind = 'command' | 'query' | 'validator' | 'view' | 'operation' | 'port' | 'adapter' | 'migration-policy';
3
+ export type EffectClass = 'read' | 'write' | 'external';
4
+ export type TransactionBoundary = 'entity' | 'model';
5
+ /** One trusted contract: an installed implementation identified by digest. The registry never holds code. */
6
+ export interface RegisteredContract {
7
+ readonly kind: ContractKind;
8
+ readonly id: string;
9
+ readonly version: number;
10
+ /** Digest of the installed code the host joined to this contract. */
11
+ readonly implementation: string;
12
+ readonly input?: string;
13
+ readonly output?: string;
14
+ readonly error?: string;
15
+ readonly effect?: EffectClass;
16
+ readonly targets?: readonly string[];
17
+ readonly port?: string;
18
+ readonly transactions?: readonly TransactionBoundary[];
19
+ readonly isolation?: boolean;
20
+ }
21
+ export interface DescriptorRegistry {
22
+ readonly format: 1;
23
+ readonly targets: readonly string[];
24
+ readonly contracts: readonly RegisteredContract[];
25
+ /** Digest of the canonical registry data; compiled definitions record it. */
26
+ readonly digest: string;
27
+ }
28
+ /**
29
+ * Build the trusted registry from host-owned data. Only a value returned here is accepted by the compilers;
30
+ * a structurally equal copy is refused. Accessors, functions and non-data values refuse without being invoked.
31
+ */
32
+ export declare function createDescriptorRegistry(data: unknown): DescriptorResult<DescriptorRegistry>;
33
+ export declare function isTrustedRegistry(registry: unknown): registry is DescriptorRegistry;
34
+ export declare function requireRegistry(registry: unknown): DescriptorRegistry;
35
+ /** Resolve a descriptor's contract reference against the trusted registry. */
36
+ export declare function resolveContract(registry: DescriptorRegistry, ref: ContractRef, kind: ContractKind, path: string): RegisteredContract;
37
+ //# sourceMappingURL=registry.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/descriptors/registry.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEhE,MAAM,MAAM,YAAY,GACpB,SAAS,GACT,OAAO,GACP,WAAW,GACX,MAAM,GACN,WAAW,GACX,MAAM,GACN,SAAS,GACT,kBAAkB,CAAC;AACvB,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,CAAC;AACxD,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,OAAO,CAAC;AACrD,6GAA6G;AAC7G,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,qEAAqE;IACrE,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACvD,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B;AACD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IACnB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAClD,6EAA6E;IAC7E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAwBD;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAAC,kBAAkB,CAAC,CAgE5F;AACD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,OAAO,GAAG,QAAQ,IAAI,kBAAkB,CAEnF;AACD,wBAAgB,eAAe,CAAC,QAAQ,EAAE,OAAO,GAAG,kBAAkB,CAQrE;AACD,8EAA8E;AAC9E,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,kBAAkB,EAC5B,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE,YAAY,EAClB,IAAI,EAAE,MAAM,GACX,kBAAkB,CASpB"}
@@ -0,0 +1,87 @@
1
+ import { attempt, choice, contractRef, deepFreeze, digest, digestOf, flag, id, integer, list, record, refuse, refuseEnvelope, snapshot, unique, versioned, } from './codec.js';
2
+ const KINDS = [
3
+ 'command',
4
+ 'query',
5
+ 'validator',
6
+ 'view',
7
+ 'operation',
8
+ 'port',
9
+ 'adapter',
10
+ 'migration-policy',
11
+ ];
12
+ const FIELDS = {
13
+ command: ['input', 'output', 'error'],
14
+ query: ['input', 'output', 'error', 'targets'],
15
+ validator: [],
16
+ view: ['targets'],
17
+ operation: ['input', 'output', 'effect', 'targets'],
18
+ port: [],
19
+ adapter: ['port', 'transactions', 'isolation'],
20
+ 'migration-policy': [],
21
+ };
22
+ const trusted = new WeakSet();
23
+ const scope = { owner: 'registry', source: 'registry' };
24
+ /**
25
+ * Build the trusted registry from host-owned data. Only a value returned here is accepted by the compilers;
26
+ * a structurally equal copy is refused. Accessors, functions and non-data values refuse without being invoked.
27
+ */
28
+ export function createDescriptorRegistry(data) {
29
+ return attempt(scope, () => {
30
+ const row = versioned(snapshot(data, 'DESC-REGISTRY-INVALID', ''), ['format', 'targets', 'contracts'], [], false);
31
+ const targets = unique(list(row['targets'], 'targets', 1).map((entry, index) => id(entry, `targets[${index}]`)), 'targets', (name) => name, '');
32
+ const contracts = list(row['contracts'], 'contracts').map((entry, index) => {
33
+ const path = `contracts[${index}]`, base = record(entry, path, ['kind', 'id', 'version', 'implementation'], [...new Set(Object.values(FIELDS).flat())]);
34
+ const kind = choice(base['kind'], `${path}.kind`, KINDS), allowed = FIELDS[kind];
35
+ const fields = record(base, path, ['kind', 'id', 'version', 'implementation', ...allowed]);
36
+ const contract = {
37
+ kind,
38
+ id: id(fields['id'], `${path}.id`),
39
+ version: integer(fields['version'], `${path}.version`, 1, 999_999),
40
+ implementation: digest(fields['implementation'], `${path}.implementation`),
41
+ };
42
+ for (const key of ['input', 'output', 'error', 'port'])
43
+ if (allowed.includes(key))
44
+ contract[key] = contractRef(fields[key], `${path}.${key}`).text;
45
+ if (allowed.includes('effect'))
46
+ contract['effect'] = choice(fields['effect'], `${path}.effect`, ['read', 'write', 'external']);
47
+ if (allowed.includes('targets'))
48
+ contract['targets'] = unique(list(fields['targets'], `${path}.targets`, 1).map((target, at) => {
49
+ const name = id(target, `${path}.targets[${at}]`);
50
+ if (!targets.includes(name))
51
+ refuse('DESC-TARGET-UNSUPPORTED', `${path}.targets[${at}]`, 'Contract names a target profile the registry does not declare');
52
+ return name;
53
+ }), `${path}.targets`, (name) => name, '');
54
+ if (allowed.includes('transactions'))
55
+ contract['transactions'] = unique(list(fields['transactions'], `${path}.transactions`, 1).map((value, at) => choice(value, `${path}.transactions[${at}]`, ['entity', 'model'])), `${path}.transactions`, (name) => name, '');
56
+ if (allowed.includes('isolation'))
57
+ contract['isolation'] = flag(fields['isolation'], `${path}.isolation`);
58
+ return contract;
59
+ });
60
+ unique(contracts, 'contracts', (contract) => `${contract.kind}:${contract.id}@${contract.version}`, '');
61
+ const value = { format: 1, targets, contracts };
62
+ const registry = deepFreeze({ ...value, digest: digestOf(value) });
63
+ trusted.add(registry);
64
+ return registry;
65
+ });
66
+ }
67
+ export function isTrustedRegistry(registry) {
68
+ return registry !== null && typeof registry === 'object' && trusted.has(registry);
69
+ }
70
+ export function requireRegistry(registry) {
71
+ if (!isTrustedRegistry(registry))
72
+ refuseEnvelope('DESC-REGISTRY-INVALID', 'registry', 'Compile only against a registry built by createDescriptorRegistry');
73
+ return registry;
74
+ }
75
+ /** Resolve a descriptor's contract reference against the trusted registry. */
76
+ export function resolveContract(registry, ref, kind, path) {
77
+ const same = registry.contracts.filter((contract) => contract.id === ref.id);
78
+ const exact = same.find((contract) => contract.kind === kind && contract.version === ref.version);
79
+ if (exact)
80
+ return exact;
81
+ if (same.some((contract) => contract.kind === kind))
82
+ refuse('DESC-CONTRACT-VERSION', path, `Trusted ${kind} contract version is not installed`);
83
+ if (same.some((contract) => contract.version === ref.version))
84
+ refuse('DESC-CONTRACT-KIND', path, `Contract is not a ${kind}`);
85
+ refuse('DESC-CONTRACT-UNKNOWN', path, `No trusted ${kind} contract has this id`);
86
+ }
87
+ //# sourceMappingURL=registry.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/descriptors/registry.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,60 @@
1
+ import type { DescriptorResult } from './codec.js';
2
+ import type { CompiledDomainModel, DefinitionDigests } from './domain.js';
3
+ import type { DescriptorEnvelope, DisclosedResources } from './envelope.js';
4
+ import type { DescriptorRegistry, TransactionBoundary } from './registry.js';
5
+ export type StorageCodec = 'uuid' | 'text' | 'integer' | 'numeric' | 'boolean' | 'timestamp' | 'reference';
6
+ export interface FieldMapping {
7
+ readonly field: string;
8
+ readonly column: string;
9
+ readonly codec: StorageCodec;
10
+ }
11
+ export interface EntityMapping {
12
+ readonly entity: string;
13
+ readonly store: string;
14
+ readonly fields: readonly FieldMapping[];
15
+ }
16
+ export interface CompiledStorageBinding {
17
+ readonly format: 1;
18
+ readonly kind: 'storage-binding';
19
+ readonly owner: string;
20
+ readonly source: string;
21
+ readonly resource: {
22
+ readonly key: string;
23
+ readonly digest: string;
24
+ };
25
+ /** The exact model this binding was compiled against: a different version or digest is skew. */
26
+ readonly model: {
27
+ readonly id: string;
28
+ readonly version: string;
29
+ readonly digest: string;
30
+ readonly owner: string;
31
+ };
32
+ readonly port: string;
33
+ readonly adapter: string;
34
+ readonly adapterImplementation: string;
35
+ readonly schemaVersion: string;
36
+ readonly transaction: TransactionBoundary;
37
+ /** The storage column that carries the host-supplied isolation key; tenant values come from the API at each operation. */
38
+ readonly isolation: {
39
+ readonly column: string;
40
+ };
41
+ readonly entities: readonly EntityMapping[];
42
+ readonly projections: readonly {
43
+ readonly name: string;
44
+ readonly classification: 'authoritative' | 'derived' | 'cache';
45
+ }[];
46
+ readonly migrationPolicy: string;
47
+ readonly digests: DefinitionDigests;
48
+ }
49
+ export interface StorageInput {
50
+ readonly envelope: DescriptorEnvelope;
51
+ readonly resources: DisclosedResources;
52
+ readonly registry: DescriptorRegistry;
53
+ readonly model: CompiledDomainModel;
54
+ }
55
+ /**
56
+ * Pure mapping compiler. It validates the binding against the exact compiled model and the trusted port/adapter
57
+ * contracts; it opens no connection, emits or runs no DDL and proposes no migration (OS09 STORE-01/02 hosts do).
58
+ */
59
+ export declare function compileStorageBinding(input: StorageInput): DescriptorResult<CompiledStorageBinding>;
60
+ //# sourceMappingURL=storage.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/descriptors/storage.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,gBAAgB,EAAS,MAAM,YAAY,CAAC;AAE1D,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAa,MAAM,aAAa,CAAC;AAErF,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAE5E,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAE7E,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,WAAW,CAAC;AAC3G,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;CAC9B;AACD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,CAAC;CAC1C;AACD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IACnB,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACrE,gGAAgG;IAChG,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACnH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,mBAAmB,CAAC;IAC1C,0HAA0H;IAC1H,QAAQ,CAAC,SAAS,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAChD,QAAQ,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAC;IAC5C,QAAQ,CAAC,WAAW,EAAE,SAAS;QAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,cAAc,EAAE,eAAe,GAAG,SAAS,GAAG,OAAO,CAAC;KAChE,EAAE,CAAC;IACJ,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;CACrC;AACD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC;CACrC;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,YAAY,GAAG,gBAAgB,CAAC,sBAAsB,CAAC,CA0KnG"}
@@ -0,0 +1,158 @@
1
+ import { attempt, choice, contractRef, deepFreeze, digest, digestOf, exactVersion, id, list, record, refuse, storageId, unique, versioned, } from './codec.js';
2
+ import { isCompiledDomainModel } from './domain.js';
3
+ import { bindResource, readInput, resolveEnvelope, scopeOf, snapshotEnvelope, snapshotResources } from './envelope.js';
4
+ import { requireRegistry, resolveContract } from './registry.js';
5
+ /**
6
+ * Pure mapping compiler. It validates the binding against the exact compiled model and the trusted port/adapter
7
+ * contracts; it opens no connection, emits or runs no DDL and proposes no migration (OS09 STORE-01/02 hosts do).
8
+ */
9
+ export function compileStorageBinding(input) {
10
+ let scope = { owner: '', source: '' };
11
+ return attempt(() => scope, () => {
12
+ const given = readInput(input, ['envelope', 'resources', 'registry', 'model']), shot = snapshotEnvelope(given['envelope']);
13
+ scope = scopeOf(shot);
14
+ const envelope = resolveEnvelope(shot, 'storage-binding');
15
+ const registry = requireRegistry(given['registry']);
16
+ if (!isCompiledDomainModel(given['model']))
17
+ refuse('DESC-SKEW', 'storage.model', 'Compile against a model returned by compileDomainModel');
18
+ const model = given['model'], fields = envelope.fields;
19
+ if (fields['model'] !== `@domain-model ${model.model}` || fields['model-version'] !== model.version)
20
+ refuse('DESC-SKEW', 'storage.model', 'Envelope model ref or version differs from the supplied compiled model');
21
+ scope = { owner: envelope.owner, source: envelope.source, resource: envelope.resource.key };
22
+ const decoded = bindResource(envelope, snapshotResources(given['resources']));
23
+ const row = versioned(decoded.value, [
24
+ 'format',
25
+ 'model',
26
+ 'model-version',
27
+ 'model-digest',
28
+ 'port',
29
+ 'adapter',
30
+ 'schema-version',
31
+ 'transaction',
32
+ 'isolation',
33
+ 'entities',
34
+ 'projections',
35
+ 'migration-policy',
36
+ ]);
37
+ if (id(row['model'], 'model') !== model.model)
38
+ refuse('DESC-SKEW', 'model', 'Resource model differs from the compiled model');
39
+ if (exactVersion(row['model-version'], 'model-version') !== model.version)
40
+ refuse('DESC-SKEW', 'model-version', 'Resource model version differs from the compiled model');
41
+ if (digest(row['model-digest'], 'model-digest') !== model.resource.digest)
42
+ refuse('DESC-SKEW', 'model-digest', 'Binding was written for a different model resource');
43
+ const portRef = contractRef(row['port'], 'port'), adapterRef = contractRef(row['adapter'], 'adapter');
44
+ if (portRef.id !== fields['port'])
45
+ refuse('DESC-ENVELOPE-MISMATCH', 'port', 'Resource port differs from the envelope port');
46
+ if (adapterRef.id !== fields['adapter'])
47
+ refuse('DESC-ENVELOPE-MISMATCH', 'adapter', 'Resource adapter differs from the envelope adapter');
48
+ const port = resolveContract(registry, portRef, 'port', 'port'), adapter = resolveContract(registry, adapterRef, 'adapter', 'adapter');
49
+ if (adapter.port !== `${port.id}@${port.version}`)
50
+ refuse('DESC-STORAGE-UNSUPPORTED', 'adapter', 'Adapter does not implement this repository port version');
51
+ const schemaVersion = exactVersion(row['schema-version'], 'schema-version');
52
+ if (schemaVersion !== fields['schema-version'])
53
+ refuse('DESC-ENVELOPE-MISMATCH', 'storage.schema-version', 'Envelope storage schema version differs from the resource');
54
+ const transaction = choice(row['transaction'], 'transaction', ['entity', 'model']);
55
+ if (!adapter.transactions?.includes(transaction))
56
+ refuse('DESC-STORAGE-UNSUPPORTED', 'transaction', 'Adapter does not guarantee this transaction boundary');
57
+ const isolation = {
58
+ column: storageId(record(row['isolation'], 'isolation', ['column'])['column'], 'isolation.column'),
59
+ };
60
+ if (adapter.isolation !== true)
61
+ refuse('DESC-STORAGE-UNSUPPORTED', 'isolation', 'Adapter cannot enforce the required isolation key');
62
+ const entities = unique(list(row['entities'], 'entities', 1).map((entry, index) => {
63
+ const path = `entities[${index}]`, value = record(entry, path, ['entity', 'store', 'fields']), key = id(value['entity'], `${path}.entity`);
64
+ const target = model.entities.find((item) => item.key === key);
65
+ if (!target)
66
+ refuse('DESC-MAPPING', `${path}.entity`, 'Mapped entity is not defined by the model');
67
+ const mapped = unique(list(value['fields'], `${path}.fields`, 1).map((item, at) => {
68
+ const where = `${path}.fields[${at}]`, mapping = record(item, where, ['field', 'column', 'codec']), name = id(mapping['field'], `${where}.field`);
69
+ const field = target.fields.find((candidate) => candidate.name === name);
70
+ if (!field)
71
+ refuse('DESC-MAPPING', `${where}.field`, 'Mapped field is not defined by the entity');
72
+ const codec = choice(mapping['codec'], `${where}.codec`, [
73
+ 'uuid',
74
+ 'text',
75
+ 'integer',
76
+ 'numeric',
77
+ 'boolean',
78
+ 'timestamp',
79
+ 'reference',
80
+ ]);
81
+ const identifier = target.id.field === name ? target.id.codec : undefined;
82
+ if (!compatible(field.type, codec, identifier, model))
83
+ refuse('DESC-MAPPING', `${where}.codec`, 'Storage codec is incompatible with the field type');
84
+ return { field: name, column: storageId(mapping['column'], `${where}.column`), codec };
85
+ }), `${path}.fields`, (item) => item.field, 'field');
86
+ unique(mapped, `${path}.fields`, (item) => item.column, 'column');
87
+ if (mapped.some((item) => item.column === isolation.column))
88
+ refuse('DESC-MAPPING', `${path}.fields`, 'The isolation column is host-supplied and cannot map a model field');
89
+ const missing = target.fields.find((field) => field.required && !mapped.some((item) => item.field === field.name));
90
+ if (missing)
91
+ refuse('DESC-MAPPING', `${path}.fields`, `Required field ${missing.name} is not mapped`);
92
+ return { entity: key, store: storageId(value['store'], `${path}.store`), fields: mapped };
93
+ }), 'entities', (item) => item.entity, 'entity');
94
+ unique(entities, 'entities', (item) => item.store, 'store');
95
+ // STORE-01: a model entity with required fields must be stored. Every entity's identifier is required, so the
96
+ // binding maps the whole model; required same-model references therefore always point at stored entities.
97
+ const unstored = model.entities.find((item) => item.fields.some((field) => field.required) && !entities.some((mapping) => mapping.entity === item.key));
98
+ if (unstored)
99
+ refuse('DESC-MAPPING', 'entities', `Entity ${unstored.key} has required fields but no mapping`);
100
+ const projections = unique(list(row['projections'], 'projections').map((entry, index) => {
101
+ const path = `projections[${index}]`, value = record(entry, path, ['name', 'classification']);
102
+ return {
103
+ name: id(value['name'], `${path}.name`),
104
+ classification: choice(value['classification'], `${path}.classification`, [
105
+ 'authoritative',
106
+ 'derived',
107
+ 'cache',
108
+ ]),
109
+ };
110
+ }), 'projections', (item) => item.name);
111
+ const policy = resolveContract(registry, contractRef(row['migration-policy'], 'migration-policy'), 'migration-policy', 'migration-policy');
112
+ const body = {
113
+ format: 1,
114
+ kind: 'storage-binding',
115
+ owner: envelope.owner,
116
+ source: envelope.source,
117
+ resource: envelope.resource,
118
+ model: { id: model.model, version: model.version, digest: model.resource.digest, owner: model.owner },
119
+ port: portRef.text,
120
+ adapter: adapterRef.text,
121
+ adapterImplementation: adapter.implementation,
122
+ schemaVersion,
123
+ transaction,
124
+ isolation,
125
+ entities,
126
+ projections,
127
+ migrationPolicy: `${policy.id}@${policy.version}`,
128
+ };
129
+ return deepFreeze({
130
+ ...body,
131
+ digests: {
132
+ input: envelope.digest,
133
+ resource: decoded.digest,
134
+ registry: registry.digest,
135
+ definition: digestOf({ ...body, registry: registry.digest }),
136
+ },
137
+ });
138
+ });
139
+ }
140
+ function compatible(type, codec, identifier, model) {
141
+ if (identifier !== undefined)
142
+ return codec === identifier;
143
+ if ('reference' in type)
144
+ return codec === 'reference';
145
+ const scalar = 'value' in type ? model.values.find((value) => value.name === type.value)?.type : type;
146
+ if (!scalar)
147
+ return false;
148
+ const expected = {
149
+ string: ['text'],
150
+ enum: ['text'],
151
+ number: ['integer'],
152
+ decimal: ['numeric'],
153
+ boolean: ['boolean'],
154
+ timestamp: ['timestamp'],
155
+ };
156
+ return expected[scalar.scalar]?.includes(codec) ?? false;
157
+ }
158
+ //# sourceMappingURL=storage.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"storage.js","sourceRoot":"","sources":["../../src/descriptors/storage.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,40 @@
1
+ import { DbError } from '../errors.js';
2
+ export declare const DISTRIBUTION_LIMITS: Readonly<{
3
+ metadata: number;
4
+ compressed: number;
5
+ expanded: number;
6
+ files: 10000;
7
+ file: number;
8
+ bundles: 128;
9
+ assignments: 1000;
10
+ }>;
11
+ export type DistributionReason = 'contract-invalid' | 'restore-required' | 'lock-drift' | 'corrupt-state' | 'recovery-required' | 'conflict';
12
+ export declare class InstallationError extends DbError {
13
+ readonly reason: DistributionReason;
14
+ constructor(reason: DistributionReason, message: string);
15
+ }
16
+ export declare function refuse(message: string): never;
17
+ export declare const sha256: (input: string | Uint8Array) => string;
18
+ export declare const metadataDigest: (value: unknown) => string;
19
+ export declare const compare: (a: string, b: string) => number;
20
+ export declare function frozen<T>(value: T): T;
21
+ export declare function object(value: unknown, keys: readonly string[]): Record<string, unknown>;
22
+ export declare function text(value: unknown, max?: number): string;
23
+ export declare function integer(value: unknown, max?: number, min?: number): number;
24
+ export declare function array(value: unknown, max?: number): readonly unknown[];
25
+ export declare function sorted<T>(values: readonly T[], key: (v: T) => string): readonly T[];
26
+ export declare function identifier(value: unknown): string;
27
+ export declare function packageId(value: unknown): string;
28
+ export declare function hash(value: unknown): string;
29
+ export declare function identity(value: unknown): string;
30
+ export declare function version(value: unknown): string;
31
+ export declare function range(value: unknown): string;
32
+ export declare const satisfies: (v: string, r: string) => boolean;
33
+ export declare const compareVersions: (a: string, b: string) => number;
34
+ export declare function portablePath(value: unknown): string;
35
+ /** Strict JSON transport; duplicate decoded keys are rejected before object construction. */
36
+ export declare function decodeDistributionJson(input: string): unknown;
37
+ /** Bounded canonical data copy also rejects accessors, cycles and custom instances. */
38
+ export declare function data(value: unknown): unknown;
39
+ export declare function canonicalDistributionJson(value: unknown): string;
40
+ //# sourceMappingURL=codec.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"codec.d.ts","sourceRoot":"","sources":["../../src/distribution/codec.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC,eAAO,MAAM,mBAAmB;;;;;;;;EAQ9B,CAAC;AACH,MAAM,MAAM,kBAAkB,GAC1B,kBAAkB,GAClB,kBAAkB,GAClB,YAAY,GACZ,eAAe,GACf,mBAAmB,GACnB,UAAU,CAAC;AACf,qBAAa,iBAAkB,SAAQ,OAAO;IAE1C,QAAQ,CAAC,MAAM,EAAE,kBAAkB;gBAA1B,MAAM,EAAE,kBAAkB,EACnC,OAAO,EAAE,MAAM;CAKlB;AACD,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,CAE7C;AACD,eAAO,MAAM,MAAM,GAAI,OAAO,MAAM,GAAG,UAAU,KAAG,MAA0D,CAAC;AAC/G,eAAO,MAAM,cAAc,GAAI,OAAO,OAAO,KAAG,MAAwC,CAAC;AACzF,eAAO,MAAM,OAAO,GAAI,GAAG,MAAM,EAAE,GAAG,MAAM,KAAG,MAAsC,CAAC;AACtF,wBAAgB,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAMrC;AACD,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAsBvF;AACD,wBAAgB,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,SAAO,GAAG,MAAM,CAUvD;AACD,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,SAA0B,EAAE,GAAG,SAAI,GAAG,MAAM,CAItF;AACD,wBAAgB,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,GAAE,MAAkC,GAAG,SAAS,OAAO,EAAE,CASjG;AACD,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,MAAM,GAAG,SAAS,CAAC,EAAE,CAQnF;AACD,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAIjD;AACD,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAKhD;AACD,wBAAgB,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAI3C;AACD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAK/C;AACD,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAM9C;AACD,wBAAgB,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAI5C;AACD,eAAO,MAAM,SAAS,GAAI,GAAG,MAAM,EAAE,GAAG,MAAM,KAAG,OAAiD,CAAC;AACnG,eAAO,MAAM,eAAe,GAAI,GAAG,MAAM,EAAE,GAAG,MAAM,KAAG,MACG,CAAC;AAC3D,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAcnD;AACD,6FAA6F;AAC7F,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAI7D;AACD,uFAAuF;AACvF,wBAAgB,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAkC5C;AACD,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAShE"}
@@ -0,0 +1,181 @@
1
+ import { createHash } from 'node:crypto';
2
+ import { stableSerialize } from '@inventarch/graph';
3
+ import semver from 'semver';
4
+ import { DbError } from '../errors.js';
5
+ import { parseStrictJson } from '../json.js';
6
+ export const DISTRIBUTION_LIMITS = Object.freeze({
7
+ metadata: 4 * 1024 * 1024,
8
+ compressed: 64 * 1024 * 1024,
9
+ expanded: 256 * 1024 * 1024,
10
+ files: 10_000,
11
+ file: 16 * 1024 * 1024,
12
+ bundles: 128,
13
+ assignments: 1000,
14
+ });
15
+ export class InstallationError extends DbError {
16
+ reason;
17
+ constructor(reason, message) {
18
+ super('IA-DB-SOURCE-UNAVAILABLE', `Distribution ${reason}: ${message}`);
19
+ this.reason = reason;
20
+ this.name = 'InstallationError';
21
+ }
22
+ }
23
+ export function refuse(message) {
24
+ throw new InstallationError('contract-invalid', message);
25
+ }
26
+ export const sha256 = (input) => createHash('sha256').update(input).digest('hex');
27
+ export const metadataDigest = (value) => sha256(stableSerialize(value));
28
+ export const compare = (a, b) => (a < b ? -1 : a > b ? 1 : 0);
29
+ export function frozen(value) {
30
+ if (value && typeof value === 'object') {
31
+ Object.values(value).forEach(frozen);
32
+ Object.freeze(value);
33
+ }
34
+ return value;
35
+ }
36
+ export function object(value, keys) {
37
+ if (!value ||
38
+ typeof value !== 'object' ||
39
+ Array.isArray(value) ||
40
+ ![Object.prototype, null].includes(Object.getPrototypeOf(value)))
41
+ refuse('Expected a plain data object');
42
+ const descriptors = Object.getOwnPropertyDescriptors(value), names = Reflect.ownKeys(value);
43
+ if (names.length !== keys.length ||
44
+ names.some((name) => typeof name !== 'string' ||
45
+ !keys.includes(name) ||
46
+ !descriptors[name]?.enumerable ||
47
+ !Object.hasOwn(descriptors[name], 'value')))
48
+ refuse('Unknown, missing or accessor field');
49
+ return value;
50
+ }
51
+ export function text(value, max = 1024) {
52
+ if (typeof value !== 'string' ||
53
+ !value ||
54
+ Buffer.byteLength(value) > max ||
55
+ Buffer.from(value).toString('utf8') !== value ||
56
+ /[\u0000-\u001f]/.test(value))
57
+ refuse('Expected bounded Unicode text');
58
+ return value;
59
+ }
60
+ export function integer(value, max = Number.MAX_SAFE_INTEGER, min = 0) {
61
+ if (typeof value !== 'number' || !Number.isSafeInteger(value) || value < min || value > max)
62
+ refuse('Integer exceeds its bound');
63
+ return value;
64
+ }
65
+ export function array(value, max = DISTRIBUTION_LIMITS.files) {
66
+ if (!Array.isArray(value) ||
67
+ value.length > max ||
68
+ Reflect.ownKeys(value).length !== value.length + 1 ||
69
+ Object.values(Object.getOwnPropertyDescriptors(value)).some((d) => !Object.hasOwn(d, 'value')))
70
+ refuse('Expected bounded dense data array');
71
+ return value;
72
+ }
73
+ export function sorted(values, key) {
74
+ let previous;
75
+ for (const value of values) {
76
+ const current = key(value);
77
+ if (previous !== undefined && compare(previous, current) >= 0)
78
+ refuse('Rows must be sorted and unique');
79
+ previous = current;
80
+ }
81
+ return values;
82
+ }
83
+ export function identifier(value) {
84
+ const v = text(value, 64);
85
+ if (!/^[a-z][a-z0-9-]*$/.test(v))
86
+ refuse('Invalid identifier');
87
+ return v;
88
+ }
89
+ export function packageId(value) {
90
+ const v = text(value, 128);
91
+ if (!/^[a-z][a-z0-9.-]*\/[a-z][a-z0-9-]*$/.test(v) || v.includes('..'))
92
+ refuse('Expected provider/name distribution id');
93
+ return v;
94
+ }
95
+ export function hash(value) {
96
+ const v = text(value, 64);
97
+ if (!/^[a-f0-9]{64}$/.test(v))
98
+ refuse('Expected SHA-256');
99
+ return v;
100
+ }
101
+ export function identity(value) {
102
+ const v = text(value);
103
+ if (!/^[a-z][a-z0-9-]*\/[a-z][a-z0-9-]*\/[a-z][a-z0-9-]*\/[a-z][a-z0-9-]*$/.test(v))
104
+ refuse('Expected canonical native identity');
105
+ return v;
106
+ }
107
+ export function version(value) {
108
+ const v = text(value, 128), parsed = semver.parse(v);
109
+ if (!parsed || `${parsed.version}${parsed.build.length ? `+${parsed.build.join('.')}` : ''}` !== v)
110
+ refuse('Expected exact canonical SemVer');
111
+ return v;
112
+ }
113
+ export function range(value) {
114
+ const v = text(value, 256);
115
+ if (semver.validRange(v) === null)
116
+ refuse('Expected a SemVer range');
117
+ return v;
118
+ }
119
+ export const satisfies = (v, r) => semver.satisfies(version(v), range(r));
120
+ export const compareVersions = (a, b) => semver.rcompare(version(a), version(b)) || compare(a, b);
121
+ export function portablePath(value) {
122
+ const v = text(value);
123
+ if (v !== v.normalize('NFC') ||
124
+ /[\\<>:"|?*]/.test(v) ||
125
+ v
126
+ .split('/')
127
+ .some((p) => !p || p === '.' || p === '..' || /[. ]$/.test(p) || /^(con|prn|aux|nul|com[0-9]|lpt[0-9])(?:\.|$)/i.test(p)))
128
+ refuse('Unsafe portable path');
129
+ return v;
130
+ }
131
+ /** Strict JSON transport; duplicate decoded keys are rejected before object construction. */
132
+ export function decodeDistributionJson(input) {
133
+ return parseStrictJson(input, { bytes: DISTRIBUTION_LIMITS.metadata, depth: 16, nodes: 200_000 }, (_fault, message) => refuse(message));
134
+ }
135
+ /** Bounded canonical data copy also rejects accessors, cycles and custom instances. */
136
+ export function data(value) {
137
+ if (typeof value === 'string')
138
+ return decodeDistributionJson(value);
139
+ let budget = DISTRIBUTION_LIMITS.metadata, count = 0;
140
+ const seen = new Set();
141
+ const visit = (v, depth) => {
142
+ if (depth > 16 || ++count > 200_000 || (budget -= 8) < 0)
143
+ refuse('Metadata complexity limit');
144
+ if (v === null || typeof v === 'boolean' || (typeof v === 'number' && Number.isSafeInteger(v)))
145
+ return v;
146
+ if (typeof v === 'string') {
147
+ if (Buffer.from(v).toString('utf8') !== v || (budget -= Buffer.byteLength(v)) < 0)
148
+ refuse('Metadata string limit/encoding');
149
+ return v;
150
+ }
151
+ if (!v || typeof v !== 'object' || seen.has(v))
152
+ refuse('Expected acyclic metadata data');
153
+ seen.add(v);
154
+ if (Array.isArray(v)) {
155
+ const result = array(v, 200_000).map((item) => visit(item, depth + 1));
156
+ seen.delete(v);
157
+ return result;
158
+ }
159
+ const names = Reflect.ownKeys(v);
160
+ if (names.some((n) => typeof n !== 'string'))
161
+ refuse('Symbol metadata key');
162
+ const row = object(v, names), result = Object.create(null);
163
+ for (const name of names) {
164
+ budget -= Buffer.byteLength(name);
165
+ result[name] = visit(row[name], depth + 1);
166
+ }
167
+ seen.delete(v);
168
+ return result;
169
+ };
170
+ const result = visit(value, 0);
171
+ if (Buffer.byteLength(JSON.stringify(result)) > DISTRIBUTION_LIMITS.metadata)
172
+ refuse('Metadata serialized limit');
173
+ return result;
174
+ }
175
+ export function canonicalDistributionJson(value) {
176
+ const clean = data(value);
177
+ return (JSON.stringify(clean, (_key, item) => item && typeof item === 'object' && !Array.isArray(item)
178
+ ? Object.fromEntries(Object.entries(item).sort(([a], [b]) => compare(a, b)))
179
+ : item) + '\n');
180
+ }
181
+ //# sourceMappingURL=codec.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"codec.js","sourceRoot":"","sources":["../../src/distribution/codec.ts"],"names":[],"mappings":"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"}