@x12i/memorix-descriptors 1.6.0 → 1.7.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/README.md +1 -1
- package/dist/admin/create-admin.d.ts +5 -1
- package/dist/admin/create-admin.d.ts.map +1 -1
- package/dist/admin/create-admin.js +4 -0
- package/dist/admin/create-admin.js.map +1 -1
- package/dist/admin/execute-mutation.d.ts.map +1 -1
- package/dist/admin/execute-mutation.js +6 -0
- package/dist/admin/execute-mutation.js.map +1 -1
- package/dist/catalog/ensure-catalogs.d.ts.map +1 -1
- package/dist/catalog/ensure-catalogs.js +6 -2
- package/dist/catalog/ensure-catalogs.js.map +1 -1
- package/dist/catalog/ids.d.ts +4 -6
- package/dist/catalog/ids.d.ts.map +1 -1
- package/dist/catalog/ids.js +4 -6
- package/dist/catalog/ids.js.map +1 -1
- package/dist/catalox/client.d.ts +1 -2
- package/dist/catalox/client.d.ts.map +1 -1
- package/dist/catalox/client.js +2 -3
- package/dist/catalox/client.js.map +1 -1
- package/dist/cli/index.js +35 -1
- package/dist/cli/index.js.map +1 -1
- package/dist/index.d.ts +3 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +3 -1
- package/dist/index.js.map +1 -1
- package/dist/migration/apply.d.ts.map +1 -1
- package/dist/migration/apply.js +1 -1
- package/dist/migration/apply.js.map +1 -1
- package/dist/migration/classify.d.ts.map +1 -1
- package/dist/migration/classify.js +4 -2
- package/dist/migration/classify.js.map +1 -1
- package/dist/migration/load-snapshot.js +3 -3
- package/dist/migration/load-snapshot.js.map +1 -1
- package/dist/migration/plan.js +2 -2
- package/dist/migration/plan.js.map +1 -1
- package/dist/migration/verify.d.ts +2 -0
- package/dist/migration/verify.d.ts.map +1 -1
- package/dist/migration/verify.js +11 -1
- package/dist/migration/verify.js.map +1 -1
- package/dist/mutations/common.d.ts.map +1 -1
- package/dist/mutations/common.js +7 -0
- package/dist/mutations/common.js.map +1 -1
- package/dist/mutations/execute.d.ts.map +1 -1
- package/dist/mutations/execute.js +6 -0
- package/dist/mutations/execute.js.map +1 -1
- package/dist/mutations/item.js.map +1 -1
- package/dist/mutations/list.js.map +1 -1
- package/dist/mutations/write-descriptor.d.ts +12 -0
- package/dist/mutations/write-descriptor.d.ts.map +1 -0
- package/dist/mutations/write-descriptor.js +120 -0
- package/dist/mutations/write-descriptor.js.map +1 -0
- package/dist/seeds/default-seed-spec.d.ts.map +1 -1
- package/dist/seeds/default-seed-spec.js +13 -0
- package/dist/seeds/default-seed-spec.js.map +1 -1
- package/dist/seeds/index.d.ts.map +1 -1
- package/dist/seeds/index.js +5 -0
- package/dist/seeds/index.js.map +1 -1
- package/dist/source/graph.d.ts.map +1 -1
- package/dist/source/graph.js +4 -3
- package/dist/source/graph.js.map +1 -1
- package/dist/source/inspectable.js +2 -2
- package/dist/source/inspectable.js.map +1 -1
- package/dist/source/registry.js +2 -2
- package/dist/source/registry.js.map +1 -1
- package/dist/source/validation.d.ts.map +1 -1
- package/dist/source/validation.js +6 -5
- package/dist/source/validation.js.map +1 -1
- package/dist/store/snapshot.d.ts.map +1 -1
- package/dist/store/snapshot.js +7 -1
- package/dist/store/snapshot.js.map +1 -1
- package/dist/tests/canonical-metadata.test.js +0 -10
- package/dist/tests/canonical-metadata.test.js.map +1 -1
- package/dist/tests/fixtures.d.ts +32 -0
- package/dist/tests/fixtures.d.ts.map +1 -1
- package/dist/tests/fixtures.js +29 -0
- package/dist/tests/fixtures.js.map +1 -1
- package/dist/tests/live/catalox.live.test.js +2 -2
- package/dist/tests/live/catalox.live.test.js.map +1 -1
- package/dist/tests/seeds.test.js +1 -0
- package/dist/tests/seeds.test.js.map +1 -1
- package/dist/tests/source-aware.test.js +2 -2
- package/dist/tests/source-aware.test.js.map +1 -1
- package/dist/tests/v2-fixtures.d.ts.map +1 -1
- package/dist/tests/v2-fixtures.js +1 -0
- package/dist/tests/v2-fixtures.js.map +1 -1
- package/dist/tests/write-descriptor.test.d.ts +2 -0
- package/dist/tests/write-descriptor.test.d.ts.map +1 -0
- package/dist/tests/write-descriptor.test.js +75 -0
- package/dist/tests/write-descriptor.test.js.map +1 -0
- package/dist/types/graph-runs.d.ts +65 -0
- package/dist/types/graph-runs.d.ts.map +1 -0
- package/dist/types/graph-runs.js +3 -0
- package/dist/types/graph-runs.js.map +1 -0
- package/dist/types/index.d.ts +3 -0
- package/dist/types/index.d.ts.map +1 -1
- package/dist/types/write-descriptor.d.ts +108 -0
- package/dist/types/write-descriptor.d.ts.map +1 -0
- package/dist/types/write-descriptor.js +2 -0
- package/dist/types/write-descriptor.js.map +1 -0
- package/dist/validation/canonical-metadata-validation.d.ts +2 -4
- package/dist/validation/canonical-metadata-validation.d.ts.map +1 -1
- package/dist/validation/canonical-metadata-validation.js +3 -8
- package/dist/validation/canonical-metadata-validation.js.map +1 -1
- package/dist/validation/write-descriptor-validation.d.ts +11 -0
- package/dist/validation/write-descriptor-validation.d.ts.map +1 -0
- package/dist/validation/write-descriptor-validation.js +120 -0
- package/dist/validation/write-descriptor-validation.js.map +1 -0
- package/docs/METADATA-RELEASE-CHECKLIST.md +6 -2
- package/package.json +1 -1
|
@@ -0,0 +1,108 @@
|
|
|
1
|
+
export type MemorixContentStorageDescriptor = {
|
|
2
|
+
provider: "gcs" | "s3";
|
|
3
|
+
bucket: string;
|
|
4
|
+
prefix?: string;
|
|
5
|
+
maxBytes?: number;
|
|
6
|
+
encoding?: "utf8";
|
|
7
|
+
credentialsRef?: string;
|
|
8
|
+
};
|
|
9
|
+
export type MemorixIdempotencyDescriptor = {
|
|
10
|
+
enabled: boolean;
|
|
11
|
+
keyPath?: string;
|
|
12
|
+
storePath?: string;
|
|
13
|
+
behavior?: "deduplicate" | "failOnDifferentPayload" | "returnExisting";
|
|
14
|
+
payloadHashPath?: string;
|
|
15
|
+
};
|
|
16
|
+
export type MemorixWriteFieldDescriptor = {
|
|
17
|
+
inputPath?: string;
|
|
18
|
+
target: {
|
|
19
|
+
path: string;
|
|
20
|
+
};
|
|
21
|
+
required?: boolean;
|
|
22
|
+
writable?: boolean;
|
|
23
|
+
immutable?: boolean;
|
|
24
|
+
valueType?: "string" | "number" | "boolean" | "date" | "datetime" | "enum" | "object" | "array" | "content";
|
|
25
|
+
enumValues?: string[];
|
|
26
|
+
defaultValue?: unknown;
|
|
27
|
+
nullBehavior?: "allow" | "ignore" | "clear" | "error";
|
|
28
|
+
mergeBehavior?: "replace" | "deepMerge" | "appendArray" | "setIfMissing";
|
|
29
|
+
content?: {
|
|
30
|
+
enabled: true;
|
|
31
|
+
objectType: "memorix-content-object";
|
|
32
|
+
acceptBody?: boolean;
|
|
33
|
+
acceptPointer?: boolean;
|
|
34
|
+
format?: "markdown" | "text";
|
|
35
|
+
storage?: MemorixContentStorageDescriptor;
|
|
36
|
+
maxBytes?: number;
|
|
37
|
+
contentKeyTemplate?: string;
|
|
38
|
+
generatePreview?: boolean;
|
|
39
|
+
previewMaxChars?: number;
|
|
40
|
+
computeMetadata?: boolean;
|
|
41
|
+
};
|
|
42
|
+
metadata?: Record<string, unknown>;
|
|
43
|
+
};
|
|
44
|
+
export type MemorixWriteDescriptor = {
|
|
45
|
+
id: string;
|
|
46
|
+
entity: string;
|
|
47
|
+
title?: string;
|
|
48
|
+
description?: string;
|
|
49
|
+
target: {
|
|
50
|
+
/** Memorix database role; defaults from `identity.idField`. */
|
|
51
|
+
kind?: "entity" | "event" | "knowledge";
|
|
52
|
+
contentType: string;
|
|
53
|
+
/** Explicit Memorix collection override (recommended for canonical stores). */
|
|
54
|
+
targetCollection?: string;
|
|
55
|
+
targetCollectionCandidates?: string[];
|
|
56
|
+
};
|
|
57
|
+
identity: {
|
|
58
|
+
idField: "entityId" | "eventId" | "knowledgeId";
|
|
59
|
+
requireExistingCanonical?: boolean;
|
|
60
|
+
};
|
|
61
|
+
operations: {
|
|
62
|
+
allowed: Array<"add" | "upsert" | "patch" | "replace">;
|
|
63
|
+
default: "add" | "upsert" | "patch" | "replace";
|
|
64
|
+
};
|
|
65
|
+
conflict?: {
|
|
66
|
+
matchBy?: string[];
|
|
67
|
+
idempotency?: MemorixIdempotencyDescriptor;
|
|
68
|
+
onConflict?: "fail" | "skip" | "append" | "update" | "replace";
|
|
69
|
+
};
|
|
70
|
+
fields: Record<string, MemorixWriteFieldDescriptor>;
|
|
71
|
+
content?: {
|
|
72
|
+
allowed: boolean;
|
|
73
|
+
allowedFields?: string[];
|
|
74
|
+
generatePreview?: boolean;
|
|
75
|
+
previewMaxChars?: number;
|
|
76
|
+
computeMetadata?: boolean;
|
|
77
|
+
maxBytes?: number;
|
|
78
|
+
contentKeyTemplate?: string;
|
|
79
|
+
contentWriteFailure?: {
|
|
80
|
+
cleanupOnRecordFailure?: boolean;
|
|
81
|
+
orphanIssueSeverity?: "warning" | "error";
|
|
82
|
+
};
|
|
83
|
+
};
|
|
84
|
+
timestamps?: {
|
|
85
|
+
createdAtPath?: string;
|
|
86
|
+
updatedAtPath?: string;
|
|
87
|
+
effectiveDatePath?: string;
|
|
88
|
+
writeTimeSource?: "server" | "input";
|
|
89
|
+
};
|
|
90
|
+
audit?: {
|
|
91
|
+
enabled?: boolean;
|
|
92
|
+
path?: string;
|
|
93
|
+
includeSource?: boolean;
|
|
94
|
+
includeCorrelationId?: boolean;
|
|
95
|
+
includeActor?: boolean;
|
|
96
|
+
includeDescriptorId?: boolean;
|
|
97
|
+
};
|
|
98
|
+
validation?: {
|
|
99
|
+
rejectUnknownFields?: boolean;
|
|
100
|
+
requireAtLeastOneWritableField?: boolean;
|
|
101
|
+
allowNulls?: boolean;
|
|
102
|
+
};
|
|
103
|
+
return?: {
|
|
104
|
+
defaultMode?: "summary" | "record" | "retrievalItem";
|
|
105
|
+
itemDescriptorId?: string;
|
|
106
|
+
};
|
|
107
|
+
};
|
|
108
|
+
//# sourceMappingURL=write-descriptor.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"write-descriptor.d.ts","sourceRoot":"","sources":["../../src/types/write-descriptor.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"write-descriptor.js","sourceRoot":"","sources":["../../src/types/write-descriptor.ts"],"names":[],"mappings":""}
|
|
@@ -2,12 +2,10 @@ import type { CanonicalMemorixCatalogSnapshot, CanonicalMetadataValidationReport
|
|
|
2
2
|
export declare const FORBIDDEN_LEGACY_CATALOG_IDS: readonly ["memorix-entity-descriptors", "memorix-entities", "memorix_entity_content_types"];
|
|
3
3
|
export declare const FORBIDDEN_LEGACY_ITEM_IDS: readonly ["variabilities-groups", "variabilities-group-detail-item", "variabilities-groups-main-list", "critical-vulnerabilities-list"];
|
|
4
4
|
export type ValidateCanonicalMetadataOptions = {
|
|
5
|
-
|
|
6
|
-
allowLegacyCatalogs?: boolean;
|
|
5
|
+
appId?: string;
|
|
7
6
|
};
|
|
8
|
-
export declare function validateCanonicalMemorixCataloxMetadata(snapshot: CanonicalMemorixCatalogSnapshot,
|
|
7
|
+
export declare function validateCanonicalMemorixCataloxMetadata(snapshot: CanonicalMemorixCatalogSnapshot, _options?: ValidateCanonicalMetadataOptions): CanonicalMetadataValidationReport;
|
|
9
8
|
export declare function validateCanonicalMemorixCataloxMetadataFromCatalox(catalox: import("../catalox/client.js").CataloxBoundClient, options?: {
|
|
10
9
|
appId?: string;
|
|
11
|
-
allowLegacyCatalogs?: boolean;
|
|
12
10
|
}): Promise<CanonicalMetadataValidationReport>;
|
|
13
11
|
//# sourceMappingURL=canonical-metadata-validation.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"canonical-metadata-validation.d.ts","sourceRoot":"","sources":["../../src/validation/canonical-metadata-validation.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EACV,+BAA+B,EAE/B,iCAAiC,EAElC,MAAM,0BAA0B,CAAC;AAYlC,eAAO,MAAM,4BAA4B,6FAI/B,CAAC;AAEX,eAAO,MAAM,yBAAyB,yIAK5B,CAAC;AAiDX,MAAM,MAAM,gCAAgC,GAAG;IAC7C,
|
|
1
|
+
{"version":3,"file":"canonical-metadata-validation.d.ts","sourceRoot":"","sources":["../../src/validation/canonical-metadata-validation.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EACV,+BAA+B,EAE/B,iCAAiC,EAElC,MAAM,0BAA0B,CAAC;AAYlC,eAAO,MAAM,4BAA4B,6FAI/B,CAAC;AAEX,eAAO,MAAM,yBAAyB,yIAK5B,CAAC;AAiDX,MAAM,MAAM,gCAAgC,GAAG;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,wBAAgB,uCAAuC,CACrD,QAAQ,EAAE,+BAA+B,EACzC,QAAQ,GAAE,gCAAqC,GAC9C,iCAAiC,CAuMnC;AAED,wBAAsB,kDAAkD,CACtE,OAAO,EAAE,OAAO,sBAAsB,EAAE,kBAAkB,EAC1D,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/B,OAAO,CAAC,iCAAiC,CAAC,CAI5C"}
|
|
@@ -1,9 +1,9 @@
|
|
|
1
|
-
import { LEGACY_GLOBAL_CONTENT_TYPE_CATALOG, LEGACY_SCHEMA_INFERENCE_CATALOG,
|
|
1
|
+
import { LEGACY_GLOBAL_CONTENT_TYPE_CATALOG, LEGACY_SCHEMA_INFERENCE_CATALOG, LEGACY_V1_ENTITY_DESCRIPTORS_CATALOG, MEMORIX_COMPLETION_MAPPINGS_CATALOG, MEMORIX_INVENTORY_POLICIES_CATALOG, MEMORIX_INVENTORY_POLICY_ITEM_ID, MEMORIX_ITEM_DESCRIPTORS_CATALOG, MEMORIX_LIST_DESCRIPTORS_CATALOG, MEMORIX_OBJECT_TYPE_DESCRIPTORS_CATALOG, MEMORIX_REQUIRED_CANONICAL_CATALOG_IDS, PARALLEL_KNOWLEDGE_CATALOG, } from "../catalog/ids.js";
|
|
2
2
|
import { findContaminationInDescriptorData } from "./canonical-contamination.js";
|
|
3
3
|
import { validateMemorixCompletionMappingV2, validateMemorixInventoryPolicyV1, validateMemorixItemDescriptorV2, validateMemorixListDescriptorV2, validateMemorixObjectTypeDescriptorV2, WORKSPACE_SYNTHETIC_FIELDS, } from "./canonical-v2-validation.js";
|
|
4
4
|
import { DescriptorValidationError } from "./errors.js";
|
|
5
5
|
export const FORBIDDEN_LEGACY_CATALOG_IDS = [
|
|
6
|
-
|
|
6
|
+
LEGACY_V1_ENTITY_DESCRIPTORS_CATALOG,
|
|
7
7
|
LEGACY_SCHEMA_INFERENCE_CATALOG,
|
|
8
8
|
LEGACY_GLOBAL_CONTENT_TYPE_CATALOG,
|
|
9
9
|
];
|
|
@@ -45,13 +45,11 @@ function isDescriptorLikeUnknownCatalog(catalogId) {
|
|
|
45
45
|
}
|
|
46
46
|
return DESCRIPTOR_LIKE_PREFIXES.some((prefix) => catalogId.startsWith(prefix));
|
|
47
47
|
}
|
|
48
|
-
export function validateCanonicalMemorixCataloxMetadata(snapshot,
|
|
48
|
+
export function validateCanonicalMemorixCataloxMetadata(snapshot, _options = {}) {
|
|
49
49
|
const errors = [];
|
|
50
50
|
const warnings = [];
|
|
51
51
|
const appId = snapshot.appId || "memorix";
|
|
52
52
|
for (const catalogId of FORBIDDEN_LEGACY_CATALOG_IDS) {
|
|
53
|
-
if (options.allowLegacyCatalogs)
|
|
54
|
-
continue;
|
|
55
53
|
if (catalogItems(snapshot, catalogId).length > 0 || catalogId in snapshot.catalogs) {
|
|
56
54
|
pushError(errors, {
|
|
57
55
|
code: "LEGACY_CATALOG_PRESENT",
|
|
@@ -61,9 +59,6 @@ export function validateCanonicalMemorixCataloxMetadata(snapshot, options = {})
|
|
|
61
59
|
}
|
|
62
60
|
}
|
|
63
61
|
for (const catalogId of Object.keys(snapshot.catalogs)) {
|
|
64
|
-
if (options.allowLegacyCatalogs && FORBIDDEN_LEGACY_CATALOG_IDS.includes(catalogId)) {
|
|
65
|
-
continue;
|
|
66
|
-
}
|
|
67
62
|
if (isDescriptorLikeUnknownCatalog(catalogId)) {
|
|
68
63
|
pushError(errors, {
|
|
69
64
|
code: "UNKNOWN_DESCRIPTOR_CATALOG",
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"canonical-metadata-validation.js","sourceRoot":"","sources":["../../src/validation/canonical-metadata-validation.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kCAAkC,EAClC,+BAA+B,EAC/B,mCAAmC,EACnC,kCAAkC,EAClC,
|
|
1
|
+
{"version":3,"file":"canonical-metadata-validation.js","sourceRoot":"","sources":["../../src/validation/canonical-metadata-validation.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
import type { DescriptorSnapshot } from "../types/index.js";
|
|
2
|
+
import type { MemorixWriteDescriptor } from "../types/write-descriptor.js";
|
|
3
|
+
export declare function validateMemorixWriteDescriptorShape(raw: Record<string, unknown>): MemorixWriteDescriptor;
|
|
4
|
+
export type WriteDescriptorSnapshotValidationIssue = {
|
|
5
|
+
code: string;
|
|
6
|
+
message: string;
|
|
7
|
+
path?: string;
|
|
8
|
+
};
|
|
9
|
+
export declare function validateWriteDescriptorAgainstSnapshot(snapshot: DescriptorSnapshot, descriptor: MemorixWriteDescriptor, env?: NodeJS.ProcessEnv): WriteDescriptorSnapshotValidationIssue[];
|
|
10
|
+
export declare function validateMemorixWriteDescriptor(raw: Record<string, unknown>, snapshot: DescriptorSnapshot, env?: NodeJS.ProcessEnv): MemorixWriteDescriptor;
|
|
11
|
+
//# sourceMappingURL=write-descriptor-validation.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"write-descriptor-validation.d.ts","sourceRoot":"","sources":["../../src/validation/write-descriptor-validation.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAM3E,wBAAgB,mCAAmC,CACjD,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3B,sBAAsB,CAwDxB;AAED,MAAM,MAAM,sCAAsC,GAAG;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAWF,wBAAgB,sCAAsC,CACpD,QAAQ,EAAE,kBAAkB,EAC5B,UAAU,EAAE,sBAAsB,EAClC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,sCAAsC,EAAE,CAwF1C;AAED,wBAAgB,8BAA8B,CAC5C,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,QAAQ,EAAE,kBAAkB,EAC5B,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,sBAAsB,CAUxB"}
|
|
@@ -0,0 +1,120 @@
|
|
|
1
|
+
import { resolveMemorixCollectionName, } from "../collections/collection-name.js";
|
|
2
|
+
import { DescriptorValidationError } from "./errors.js";
|
|
3
|
+
import { validateMemorixEntityDescriptor } from "./descriptor-validation.js";
|
|
4
|
+
const CONTENT_OBJECT_TYPE = "memorix-content-object";
|
|
5
|
+
export function validateMemorixWriteDescriptorShape(raw) {
|
|
6
|
+
const descriptor = raw;
|
|
7
|
+
if (!descriptor.id?.trim()) {
|
|
8
|
+
throw new DescriptorValidationError("INVALID_WRITE_DESCRIPTOR", "write descriptor id is required");
|
|
9
|
+
}
|
|
10
|
+
if (!descriptor.entity?.trim()) {
|
|
11
|
+
throw new DescriptorValidationError("INVALID_WRITE_DESCRIPTOR", "write descriptor entity is required");
|
|
12
|
+
}
|
|
13
|
+
if (!descriptor.target?.contentType?.trim()) {
|
|
14
|
+
throw new DescriptorValidationError("INVALID_WRITE_DESCRIPTOR", "write descriptor target.contentType is required");
|
|
15
|
+
}
|
|
16
|
+
if (!descriptor.operations?.allowed?.length) {
|
|
17
|
+
throw new DescriptorValidationError("INVALID_WRITE_DESCRIPTOR", "write descriptor operations.allowed must be non-empty");
|
|
18
|
+
}
|
|
19
|
+
if (!descriptor.operations.allowed.includes(descriptor.operations.default)) {
|
|
20
|
+
throw new DescriptorValidationError("INVALID_WRITE_DESCRIPTOR", "write descriptor operations.default must be in operations.allowed");
|
|
21
|
+
}
|
|
22
|
+
if (!descriptor.fields || Object.keys(descriptor.fields).length === 0) {
|
|
23
|
+
throw new DescriptorValidationError("INVALID_WRITE_DESCRIPTOR", "write descriptor must declare at least one field");
|
|
24
|
+
}
|
|
25
|
+
for (const [fieldKey, field] of Object.entries(descriptor.fields)) {
|
|
26
|
+
if (!field.target?.path?.trim()) {
|
|
27
|
+
throw new DescriptorValidationError("INVALID_WRITE_DESCRIPTOR", `write descriptor field "${fieldKey}" requires target.path`);
|
|
28
|
+
}
|
|
29
|
+
if (field.content?.enabled && field.content.objectType !== CONTENT_OBJECT_TYPE) {
|
|
30
|
+
throw new DescriptorValidationError("INVALID_WRITE_DESCRIPTOR", `write descriptor field "${fieldKey}" content.objectType must be "${CONTENT_OBJECT_TYPE}"`);
|
|
31
|
+
}
|
|
32
|
+
}
|
|
33
|
+
return { ...descriptor, id: descriptor.id.trim(), entity: descriptor.entity.trim() };
|
|
34
|
+
}
|
|
35
|
+
function entityCollections(entity, env) {
|
|
36
|
+
return Object.keys(entity.contentTypes).map((key) => resolveMemorixCollectionName(entity, key, env));
|
|
37
|
+
}
|
|
38
|
+
export function validateWriteDescriptorAgainstSnapshot(snapshot, descriptor, env = process.env) {
|
|
39
|
+
const errors = [];
|
|
40
|
+
const entityRaw = snapshot.entityDescriptors[descriptor.entity];
|
|
41
|
+
if (!entityRaw) {
|
|
42
|
+
errors.push({
|
|
43
|
+
code: "UNKNOWN_OBJECT_TYPE",
|
|
44
|
+
message: `Write descriptor entity "${descriptor.entity}" not found in object type catalog`,
|
|
45
|
+
path: "entity",
|
|
46
|
+
});
|
|
47
|
+
return errors;
|
|
48
|
+
}
|
|
49
|
+
let entity;
|
|
50
|
+
try {
|
|
51
|
+
entity = validateMemorixEntityDescriptor(entityRaw);
|
|
52
|
+
}
|
|
53
|
+
catch (err) {
|
|
54
|
+
errors.push({
|
|
55
|
+
code: "INVALID_OBJECT_TYPE",
|
|
56
|
+
message: err instanceof Error ? err.message : String(err),
|
|
57
|
+
path: "entity",
|
|
58
|
+
});
|
|
59
|
+
return errors;
|
|
60
|
+
}
|
|
61
|
+
const entitySource = {
|
|
62
|
+
entityName: entity.entityName,
|
|
63
|
+
collectionPrefix: entity.collectionPrefix,
|
|
64
|
+
target: entity.target,
|
|
65
|
+
contentTypes: Object.fromEntries(Object.entries(entity.contentTypes).map(([key, ct]) => [
|
|
66
|
+
key,
|
|
67
|
+
{ postfix: ct.postfix, collection: ct.collection },
|
|
68
|
+
])),
|
|
69
|
+
};
|
|
70
|
+
if (!entity.contentTypes[descriptor.target.contentType]) {
|
|
71
|
+
errors.push({
|
|
72
|
+
code: "UNKNOWN_CONTENT_TYPE",
|
|
73
|
+
message: `Write descriptor target.contentType "${descriptor.target.contentType}" is not declared on object type "${descriptor.entity}"`,
|
|
74
|
+
path: "target.contentType",
|
|
75
|
+
});
|
|
76
|
+
}
|
|
77
|
+
const collections = entityCollections(entitySource, env);
|
|
78
|
+
const resolvedCollection = entity.contentTypes[descriptor.target.contentType]
|
|
79
|
+
? resolveMemorixCollectionName(entitySource, descriptor.target.contentType, env)
|
|
80
|
+
: undefined;
|
|
81
|
+
if (descriptor.target.targetCollection) {
|
|
82
|
+
if (!collections.includes(descriptor.target.targetCollection)) {
|
|
83
|
+
errors.push({
|
|
84
|
+
code: "UNKNOWN_TARGET_COLLECTION",
|
|
85
|
+
message: `targetCollection "${descriptor.target.targetCollection}" is not declared on object type "${descriptor.entity}"`,
|
|
86
|
+
path: "target.targetCollection",
|
|
87
|
+
});
|
|
88
|
+
}
|
|
89
|
+
}
|
|
90
|
+
if (descriptor.target.targetCollectionCandidates?.length) {
|
|
91
|
+
for (const candidate of descriptor.target.targetCollectionCandidates) {
|
|
92
|
+
if (!collections.includes(candidate)) {
|
|
93
|
+
errors.push({
|
|
94
|
+
code: "UNKNOWN_TARGET_COLLECTION",
|
|
95
|
+
message: `targetCollectionCandidates entry "${candidate}" is not declared on object type "${descriptor.entity}"`,
|
|
96
|
+
path: "target.targetCollectionCandidates",
|
|
97
|
+
});
|
|
98
|
+
}
|
|
99
|
+
}
|
|
100
|
+
}
|
|
101
|
+
if (resolvedCollection &&
|
|
102
|
+
descriptor.target.targetCollection &&
|
|
103
|
+
descriptor.target.targetCollection !== resolvedCollection) {
|
|
104
|
+
errors.push({
|
|
105
|
+
code: "TARGET_COLLECTION_MISMATCH",
|
|
106
|
+
message: `targetCollection "${descriptor.target.targetCollection}" does not match resolved collection "${resolvedCollection}" for content type "${descriptor.target.contentType}"`,
|
|
107
|
+
path: "target.targetCollection",
|
|
108
|
+
});
|
|
109
|
+
}
|
|
110
|
+
return errors;
|
|
111
|
+
}
|
|
112
|
+
export function validateMemorixWriteDescriptor(raw, snapshot, env = process.env) {
|
|
113
|
+
const descriptor = validateMemorixWriteDescriptorShape(raw);
|
|
114
|
+
const snapshotErrors = validateWriteDescriptorAgainstSnapshot(snapshot, descriptor, env);
|
|
115
|
+
if (snapshotErrors.length > 0) {
|
|
116
|
+
throw new DescriptorValidationError(snapshotErrors[0].code, snapshotErrors.map((e) => e.message).join("; "));
|
|
117
|
+
}
|
|
118
|
+
return descriptor;
|
|
119
|
+
}
|
|
120
|
+
//# sourceMappingURL=write-descriptor-validation.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"write-descriptor-validation.js","sourceRoot":"","sources":["../../src/validation/write-descriptor-validation.ts"],"names":[],"mappings":"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"}
|
|
@@ -18,7 +18,11 @@ After deploying `@x12i/memorix-descriptors` with v2-only runtime loading:
|
|
|
18
18
|
npx tsx scripts/memorix-metadata/apply.ts
|
|
19
19
|
```
|
|
20
20
|
|
|
21
|
-
4. **Verify** —
|
|
21
|
+
4. **Verify** — canonical `memorix-object-type-descriptors` must be populated; legacy catalogs must be absent
|
|
22
|
+
|
|
23
|
+
See also: [../../docs/MIGRATION-V2-CATALOG.md](../../docs/MIGRATION-V2-CATALOG.md)
|
|
24
|
+
|
|
25
|
+
Legacy catalog `memorix-entity-descriptors` is **not read** at runtime and must be deleted during migration.
|
|
22
26
|
```bash
|
|
23
27
|
npx tsx scripts/memorix-metadata/verify.ts
|
|
24
28
|
```
|
|
@@ -37,4 +41,4 @@ After deploying `@x12i/memorix-descriptors` with v2-only runtime loading:
|
|
|
37
41
|
|
|
38
42
|
7. **Explorer** — reload unified inventory; Catalox-first rows should match declared object types.
|
|
39
43
|
|
|
40
|
-
Legacy catalog `memorix-entity-descriptors` is **not read** at runtime. Canonical validation fails if legacy catalog items remain
|
|
44
|
+
Legacy catalog `memorix-entity-descriptors` is **not read** at runtime. Canonical validation fails if legacy catalog items remain.
|