@x12i/memorix-descriptors 1.4.5 → 1.5.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 (110) hide show
  1. package/dist/admin/create-admin.d.ts +5 -0
  2. package/dist/admin/create-admin.d.ts.map +1 -1
  3. package/dist/admin/create-admin.js +11 -2
  4. package/dist/admin/create-admin.js.map +1 -1
  5. package/dist/catalog/ids.d.ts +7 -0
  6. package/dist/catalog/ids.d.ts.map +1 -1
  7. package/dist/catalog/ids.js +13 -0
  8. package/dist/catalog/ids.js.map +1 -1
  9. package/dist/catalox/client.d.ts.map +1 -1
  10. package/dist/catalox/client.js +26 -1
  11. package/dist/catalox/client.js.map +1 -1
  12. package/dist/cli/index.js +7 -0
  13. package/dist/cli/index.js.map +1 -1
  14. package/dist/env/load-env-file.d.ts +7 -0
  15. package/dist/env/load-env-file.d.ts.map +1 -0
  16. package/dist/env/load-env-file.js +74 -0
  17. package/dist/env/load-env-file.js.map +1 -0
  18. package/dist/index.d.ts +6 -1
  19. package/dist/index.d.ts.map +1 -1
  20. package/dist/index.js +4 -1
  21. package/dist/index.js.map +1 -1
  22. package/dist/migration/apply.d.ts +21 -0
  23. package/dist/migration/apply.d.ts.map +1 -0
  24. package/dist/migration/apply.js +102 -0
  25. package/dist/migration/apply.js.map +1 -0
  26. package/dist/migration/backup.d.ts +8 -0
  27. package/dist/migration/backup.d.ts.map +1 -0
  28. package/dist/migration/backup.js +27 -0
  29. package/dist/migration/backup.js.map +1 -0
  30. package/dist/migration/classify.d.ts +6 -0
  31. package/dist/migration/classify.d.ts.map +1 -0
  32. package/dist/migration/classify.js +67 -0
  33. package/dist/migration/classify.js.map +1 -0
  34. package/dist/migration/ensure-canonical-catalogs.d.ts +4 -0
  35. package/dist/migration/ensure-canonical-catalogs.d.ts.map +1 -0
  36. package/dist/migration/ensure-canonical-catalogs.js +101 -0
  37. package/dist/migration/ensure-canonical-catalogs.js.map +1 -0
  38. package/dist/migration/generate-descriptors.d.ts +22 -0
  39. package/dist/migration/generate-descriptors.d.ts.map +1 -0
  40. package/dist/migration/generate-descriptors.js +234 -0
  41. package/dist/migration/generate-descriptors.js.map +1 -0
  42. package/dist/migration/index.d.ts +13 -0
  43. package/dist/migration/index.d.ts.map +1 -0
  44. package/dist/migration/index.js +12 -0
  45. package/dist/migration/index.js.map +1 -0
  46. package/dist/migration/inspect.d.ts +9 -0
  47. package/dist/migration/inspect.d.ts.map +1 -0
  48. package/dist/migration/inspect.js +57 -0
  49. package/dist/migration/inspect.js.map +1 -0
  50. package/dist/migration/load-snapshot.d.ts +15 -0
  51. package/dist/migration/load-snapshot.d.ts.map +1 -0
  52. package/dist/migration/load-snapshot.js +83 -0
  53. package/dist/migration/load-snapshot.js.map +1 -0
  54. package/dist/migration/mongo-inventory.d.ts +20 -0
  55. package/dist/migration/mongo-inventory.d.ts.map +1 -0
  56. package/dist/migration/mongo-inventory.js +95 -0
  57. package/dist/migration/mongo-inventory.js.map +1 -0
  58. package/dist/migration/object-type-specs.d.ts +17 -0
  59. package/dist/migration/object-type-specs.d.ts.map +1 -0
  60. package/dist/migration/object-type-specs.js +58 -0
  61. package/dist/migration/object-type-specs.js.map +1 -0
  62. package/dist/migration/plan.d.ts +4 -0
  63. package/dist/migration/plan.d.ts.map +1 -0
  64. package/dist/migration/plan.js +136 -0
  65. package/dist/migration/plan.js.map +1 -0
  66. package/dist/migration/reset.d.ts +17 -0
  67. package/dist/migration/reset.d.ts.map +1 -0
  68. package/dist/migration/reset.js +73 -0
  69. package/dist/migration/reset.js.map +1 -0
  70. package/dist/migration/types.d.ts +76 -0
  71. package/dist/migration/types.d.ts.map +1 -0
  72. package/dist/migration/types.js +17 -0
  73. package/dist/migration/types.js.map +1 -0
  74. package/dist/migration/validate-plan.d.ts +15 -0
  75. package/dist/migration/validate-plan.d.ts.map +1 -0
  76. package/dist/migration/validate-plan.js +112 -0
  77. package/dist/migration/validate-plan.js.map +1 -0
  78. package/dist/migration/verify.d.ts +15 -0
  79. package/dist/migration/verify.d.ts.map +1 -0
  80. package/dist/migration/verify.js +27 -0
  81. package/dist/migration/verify.js.map +1 -0
  82. package/dist/source/envelope.js +2 -2
  83. package/dist/source/envelope.js.map +1 -1
  84. package/dist/source/registry.d.ts +1 -3
  85. package/dist/source/registry.d.ts.map +1 -1
  86. package/dist/source/registry.js +13 -6
  87. package/dist/source/registry.js.map +1 -1
  88. package/dist/tests/canonical-metadata.test.d.ts +2 -0
  89. package/dist/tests/canonical-metadata.test.d.ts.map +1 -0
  90. package/dist/tests/canonical-metadata.test.js +198 -0
  91. package/dist/tests/canonical-metadata.test.js.map +1 -0
  92. package/dist/tests/source-aware.test.js +10 -5
  93. package/dist/tests/source-aware.test.js.map +1 -1
  94. package/dist/types/canonical-v2.d.ts +164 -0
  95. package/dist/types/canonical-v2.d.ts.map +1 -0
  96. package/dist/types/canonical-v2.js +6 -0
  97. package/dist/types/canonical-v2.js.map +1 -0
  98. package/dist/validation/canonical-contamination.d.ts +6 -0
  99. package/dist/validation/canonical-contamination.d.ts.map +1 -0
  100. package/dist/validation/canonical-contamination.js +71 -0
  101. package/dist/validation/canonical-contamination.js.map +1 -0
  102. package/dist/validation/canonical-metadata-validation.d.ts +13 -0
  103. package/dist/validation/canonical-metadata-validation.d.ts.map +1 -0
  104. package/dist/validation/canonical-metadata-validation.js +248 -0
  105. package/dist/validation/canonical-metadata-validation.js.map +1 -0
  106. package/dist/validation/canonical-v2-validation.d.ts +8 -0
  107. package/dist/validation/canonical-v2-validation.d.ts.map +1 -0
  108. package/dist/validation/canonical-v2-validation.js +273 -0
  109. package/dist/validation/canonical-v2-validation.js.map +1 -0
  110. package/package.json +9 -1
@@ -0,0 +1,21 @@
1
+ import { type CataloxBoundClient } from "../catalox/client.js";
2
+ import type { MemorixCataloxMetadataFixPlan } from "./types.js";
3
+ export type ApplyPlanOptions = {
4
+ confirmBreakingReset?: boolean;
5
+ backupDir?: string;
6
+ };
7
+ export type ApplyPlanResult = {
8
+ ok: boolean;
9
+ backupDir?: string;
10
+ errors: string[];
11
+ upserted: number;
12
+ };
13
+ export declare function applyMemorixCataloxMetadataFixPlan(catalox: CataloxBoundClient, plan: MemorixCataloxMetadataFixPlan, options?: ApplyPlanOptions): Promise<ApplyPlanResult>;
14
+ export declare function cleanupLegacyMemorixCataloxMetadata(catalox: CataloxBoundClient, plan: MemorixCataloxMetadataFixPlan, options?: {
15
+ confirmDeleteLegacy?: boolean;
16
+ }): Promise<{
17
+ ok: boolean;
18
+ deleted: number;
19
+ errors: string[];
20
+ }>;
21
+ //# sourceMappingURL=apply.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"apply.d.ts","sourceRoot":"","sources":["../../src/migration/apply.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,kBAAkB,EACxB,MAAM,sBAAsB,CAAC;AAQ9B,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,YAAY,CAAC;AAgBhE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,OAAO,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,wBAAsB,kCAAkC,CACtD,OAAO,EAAE,kBAAkB,EAC3B,IAAI,EAAE,6BAA6B,EACnC,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,eAAe,CAAC,CAgE1B;AAED,wBAAsB,mCAAmC,CACvD,OAAO,EAAE,kBAAkB,EAC3B,IAAI,EAAE,6BAA6B,EACnC,OAAO,GAAE;IAAE,mBAAmB,CAAC,EAAE,OAAO,CAAA;CAAO,GAC9C,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAgC7D"}
@@ -0,0 +1,102 @@
1
+ import { deleteCatalogItem, upsertCatalogItem, } from "../catalox/client.js";
2
+ import { MEMORIX_REQUIRED_CANONICAL_CATALOG_IDS, } from "../catalog/ids.js";
3
+ import { validateCanonicalMemorixCataloxMetadata } from "../validation/canonical-metadata-validation.js";
4
+ import { exportMemorixMetadataBackup } from "./backup.js";
5
+ import { ensureCanonicalMigrationCatalogs } from "./ensure-canonical-catalogs.js";
6
+ import { loadCanonicalMemorixCatalogSnapshot } from "./load-snapshot.js";
7
+ import { snapshotFromPlanUpserts } from "./types.js";
8
+ import { validateMemorixCataloxMetadataFixPlan } from "./validate-plan.js";
9
+ const FORBIDDEN_UPSERT_KEYS = ["entity", "entityName", "entityType", "targetEntity"];
10
+ function stripForbiddenLegacyUpsertFields(data) {
11
+ const cleaned = { ...data };
12
+ for (const key of FORBIDDEN_UPSERT_KEYS) {
13
+ delete cleaned[key];
14
+ }
15
+ return cleaned;
16
+ }
17
+ export async function applyMemorixCataloxMetadataFixPlan(catalox, plan, options = {}) {
18
+ if (!options.confirmBreakingReset) {
19
+ return {
20
+ ok: false,
21
+ errors: ["Missing required flag --confirm-breaking-reset"],
22
+ upserted: 0,
23
+ };
24
+ }
25
+ const validation = await validateMemorixCataloxMetadataFixPlan(plan);
26
+ if (!validation.ok) {
27
+ return {
28
+ ok: false,
29
+ errors: validation.errors.map((error) => `${error.code}: ${error.message}`),
30
+ upserted: 0,
31
+ };
32
+ }
33
+ if (plan.blockedQuestions.some((question) => question.required)) {
34
+ return {
35
+ ok: false,
36
+ errors: ["Plan has unresolved blockedQuestions"],
37
+ upserted: 0,
38
+ };
39
+ }
40
+ const backupDir = await exportMemorixMetadataBackup(catalox, {
41
+ backupDir: options.backupDir,
42
+ appId: plan.appId,
43
+ plan,
44
+ });
45
+ await ensureCanonicalMigrationCatalogs(catalox, plan);
46
+ let upserted = 0;
47
+ for (const item of plan.upsertItems) {
48
+ const data = stripForbiddenLegacyUpsertFields({ ...item.data, id: item.itemId });
49
+ await deleteCatalogItem(catalox, item.catalogId, item.itemId);
50
+ await upsertCatalogItem(catalox, item.catalogId, data);
51
+ upserted += 1;
52
+ }
53
+ const projected = snapshotFromPlanUpserts(plan.appId, plan);
54
+ for (const catalogId of MEMORIX_REQUIRED_CANONICAL_CATALOG_IDS) {
55
+ if (!(catalogId in projected.catalogs)) {
56
+ projected.catalogs[catalogId] = [];
57
+ }
58
+ }
59
+ const postWriteValidation = validateCanonicalMemorixCataloxMetadata(projected);
60
+ if (!postWriteValidation.ok) {
61
+ return {
62
+ ok: false,
63
+ backupDir,
64
+ errors: postWriteValidation.errors.map((error) => `${error.code}: ${error.message}`),
65
+ upserted,
66
+ };
67
+ }
68
+ return {
69
+ ok: true,
70
+ backupDir,
71
+ errors: [],
72
+ upserted,
73
+ };
74
+ }
75
+ export async function cleanupLegacyMemorixCataloxMetadata(catalox, plan, options = {}) {
76
+ if (!options.confirmDeleteLegacy) {
77
+ return {
78
+ ok: false,
79
+ deleted: 0,
80
+ errors: ["Missing required flag --confirm-delete-legacy"],
81
+ };
82
+ }
83
+ let deleted = 0;
84
+ for (const item of plan.deleteItems) {
85
+ await deleteCatalogItem(catalox, item.catalogId, item.itemId);
86
+ deleted += 1;
87
+ }
88
+ const validation = validateCanonicalMemorixCataloxMetadata(await loadCanonicalMemorixCatalogSnapshot(catalox, {
89
+ appId: plan.appId,
90
+ includeLegacy: false,
91
+ includeParallel: true,
92
+ }), { allowLegacyCatalogs: true });
93
+ if (!validation.ok) {
94
+ return {
95
+ ok: false,
96
+ deleted,
97
+ errors: validation.errors.map((error) => `${error.code}: ${error.message}`),
98
+ };
99
+ }
100
+ return { ok: true, deleted, errors: [] };
101
+ }
102
+ //# sourceMappingURL=apply.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"apply.js","sourceRoot":"","sources":["../../src/migration/apply.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,8 @@
1
+ import type { CataloxBoundClient } from "../catalox/client.js";
2
+ import type { MemorixCataloxMetadataFixPlan } from "./types.js";
3
+ export declare function exportMemorixMetadataBackup(catalox: CataloxBoundClient, options?: {
4
+ backupDir?: string;
5
+ appId?: string;
6
+ plan?: MemorixCataloxMetadataFixPlan;
7
+ }): Promise<string>;
8
+ //# sourceMappingURL=backup.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"backup.d.ts","sourceRoot":"","sources":["../../src/migration/backup.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAG/D,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,YAAY,CAAC;AAEhE,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,kBAAkB,EAC3B,OAAO,GAAE;IACP,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,6BAA6B,CAAC;CACjC,GACL,OAAO,CAAC,MAAM,CAAC,CA4BjB"}
@@ -0,0 +1,27 @@
1
+ import { mkdir, writeFile } from "node:fs/promises";
2
+ import { join } from "node:path";
3
+ import { inspectMemorixCataloxMetadata } from "./inspect.js";
4
+ import { loadAllMemorixCatalogItems } from "./load-snapshot.js";
5
+ export async function exportMemorixMetadataBackup(catalox, options = {}) {
6
+ const timestamp = new Date().toISOString().replace(/[:.]/g, "-");
7
+ const backupRoot = options.backupDir ?? join(process.cwd(), "backups");
8
+ const dir = join(backupRoot, `memorix-catalox-before-reset-${timestamp}`);
9
+ await mkdir(dir, { recursive: true });
10
+ const snapshot = await loadAllMemorixCatalogItems(catalox, { appId: options.appId });
11
+ const inspection = await inspectMemorixCataloxMetadata(catalox, { appId: options.appId });
12
+ await writeFile(join(dir, "catalog-registry.json"), JSON.stringify(Object.keys(snapshot.catalogs), null, 2));
13
+ await writeFile(join(dir, "environment-summary.json"), JSON.stringify(inspection.environmentSummary, null, 2));
14
+ await writeFile(join(dir, "memorix-metadata-inspection.json"), JSON.stringify(inspection, null, 2));
15
+ if (options.plan) {
16
+ await writeFile(join(dir, "memorix-catalox-metadata-fix.plan.json"), JSON.stringify(options.plan, null, 2));
17
+ }
18
+ for (const [catalogId, items] of Object.entries(snapshot.catalogs)) {
19
+ const catalogDir = join(dir, "catalogs", catalogId);
20
+ await mkdir(catalogDir, { recursive: true });
21
+ for (const item of items) {
22
+ await writeFile(join(catalogDir, `${item.id}.json`), JSON.stringify(item.data, null, 2));
23
+ }
24
+ }
25
+ return dir;
26
+ }
27
+ //# sourceMappingURL=backup.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"backup.js","sourceRoot":"","sources":["../../src/migration/backup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAGhE,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,OAA2B,EAC3B,UAII,EAAE;IAEN,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACjE,MAAM,UAAU,GAAG,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,CAAC;IACvE,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,EAAE,gCAAgC,SAAS,EAAE,CAAC,CAAC;IAC1E,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEtC,MAAM,QAAQ,GAAG,MAAM,0BAA0B,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IACrF,MAAM,UAAU,GAAG,MAAM,6BAA6B,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IAE1F,MAAM,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,uBAAuB,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7G,MAAM,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,0BAA0B,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,kBAAkB,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC/G,MAAM,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,kCAAkC,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACpG,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,MAAM,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,wCAAwC,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC9G,CAAC;IAED,KAAK,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACnE,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;QACpD,MAAM,KAAK,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,SAAS,CACb,IAAI,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,EAAE,OAAO,CAAC,EACnC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CACnC,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}
@@ -0,0 +1,6 @@
1
+ import type { MemorixMetadataCatalogClassification } from "./types.js";
2
+ export declare function classifyMemorixCatalog(catalogId: string): MemorixMetadataCatalogClassification;
3
+ export declare function detectLegacyFields(data: Record<string, unknown>): string[];
4
+ export declare function detectNamingConflicts(itemIds: string[]): string[];
5
+ export declare function countContamination(data: Record<string, unknown>): number;
6
+ //# sourceMappingURL=classify.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"classify.d.ts","sourceRoot":"","sources":["../../src/migration/classify.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,oCAAoC,EAAE,MAAM,YAAY,CAAC;AAiBvE,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,GAChB,oCAAoC,CAYtC;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CAI1E;AAmBD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CASjE;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAExE"}
@@ -0,0 +1,67 @@
1
+ import { LEGACY_GLOBAL_CONTENT_TYPE_CATALOG, LEGACY_SCHEMA_INFERENCE_CATALOG, MEMORIX_COMPLETION_MAPPINGS_CATALOG, MEMORIX_ENTITY_DESCRIPTORS_CATALOG, MEMORIX_INVENTORY_POLICIES_CATALOG, 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
+ import { findContaminationInDescriptorData } from "../validation/canonical-contamination.js";
3
+ const LEGACY_CATALOGS = new Set([
4
+ MEMORIX_ENTITY_DESCRIPTORS_CATALOG,
5
+ LEGACY_SCHEMA_INFERENCE_CATALOG,
6
+ LEGACY_GLOBAL_CONTENT_TYPE_CATALOG,
7
+ ]);
8
+ const CURRENT_CATALOGS = new Set([
9
+ MEMORIX_LIST_DESCRIPTORS_CATALOG,
10
+ MEMORIX_ITEM_DESCRIPTORS_CATALOG,
11
+ MEMORIX_COMPLETION_MAPPINGS_CATALOG,
12
+ MEMORIX_INVENTORY_POLICIES_CATALOG,
13
+ ]);
14
+ const LEGACY_FIELD_KEYS = ["entityName", "entityType", "targetEntity", "entity"];
15
+ export function classifyMemorixCatalog(catalogId) {
16
+ if (catalogId === MEMORIX_OBJECT_TYPE_DESCRIPTORS_CATALOG)
17
+ return "canonical";
18
+ if (LEGACY_CATALOGS.has(catalogId))
19
+ return "legacy";
20
+ if (CURRENT_CATALOGS.has(catalogId))
21
+ return "current";
22
+ if (catalogId === PARALLEL_KNOWLEDGE_CATALOG)
23
+ return "parallel";
24
+ if (MEMORIX_REQUIRED_CANONICAL_CATALOG_IDS.includes(catalogId)) {
25
+ return "canonical";
26
+ }
27
+ if (catalogId.startsWith("memorix-") || catalogId.startsWith("memorix_")) {
28
+ return "unknown";
29
+ }
30
+ return "unknown";
31
+ }
32
+ export function detectLegacyFields(data) {
33
+ const hits = [];
34
+ scanLegacyFields(data, "", hits);
35
+ return hits;
36
+ }
37
+ function scanLegacyFields(value, path, hits) {
38
+ if (!value || typeof value !== "object")
39
+ return;
40
+ if (Array.isArray(value)) {
41
+ value.forEach((entry, index) => {
42
+ scanLegacyFields(entry, path ? `${path}[${index}]` : `[${index}]`, hits);
43
+ });
44
+ return;
45
+ }
46
+ for (const [key, child] of Object.entries(value)) {
47
+ const childPath = path ? `${path}.${key}` : key;
48
+ if (LEGACY_FIELD_KEYS.includes(key)) {
49
+ hits.push(childPath);
50
+ }
51
+ scanLegacyFields(child, childPath, hits);
52
+ }
53
+ }
54
+ export function detectNamingConflicts(itemIds) {
55
+ const conflicts = [];
56
+ if (itemIds.includes("variabilities-groups")) {
57
+ conflicts.push("variabilities-groups");
58
+ }
59
+ if (itemIds.includes("critical-vulnerabilities-list")) {
60
+ conflicts.push("critical-vulnerabilities-list");
61
+ }
62
+ return conflicts;
63
+ }
64
+ export function countContamination(data) {
65
+ return findContaminationInDescriptorData(data).length;
66
+ }
67
+ //# sourceMappingURL=classify.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"classify.js","sourceRoot":"","sources":["../../src/migration/classify.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kCAAkC,EAClC,+BAA+B,EAC/B,mCAAmC,EACnC,kCAAkC,EAClC,kCAAkC,EAClC,gCAAgC,EAChC,gCAAgC,EAChC,uCAAuC,EACvC,sCAAsC,EACtC,0BAA0B,GAC3B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,iCAAiC,EAAE,MAAM,0CAA0C,CAAC;AAG7F,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC;IAC9B,kCAAkC;IAClC,+BAA+B;IAC/B,kCAAkC;CACnC,CAAC,CAAC;AAEH,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC;IAC/B,gCAAgC;IAChC,gCAAgC;IAChC,mCAAmC;IACnC,kCAAkC;CACnC,CAAC,CAAC;AAEH,MAAM,iBAAiB,GAAG,CAAC,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,QAAQ,CAAC,CAAC;AAEjF,MAAM,UAAU,sBAAsB,CACpC,SAAiB;IAEjB,IAAI,SAAS,KAAK,uCAAuC;QAAE,OAAO,WAAW,CAAC;IAC9E,IAAI,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC;QAAE,OAAO,QAAQ,CAAC;IACpD,IAAI,gBAAgB,CAAC,GAAG,CAAC,SAAS,CAAC;QAAE,OAAO,SAAS,CAAC;IACtD,IAAI,SAAS,KAAK,0BAA0B;QAAE,OAAO,UAAU,CAAC;IAChE,IAAI,sCAAsC,CAAC,QAAQ,CAAC,SAAkB,CAAC,EAAE,CAAC;QACxE,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,IAAI,SAAS,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,SAAS,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACzE,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAA6B;IAC9D,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,gBAAgB,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;IACjC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc,EAAE,IAAY,EAAE,IAAc;IACpE,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO;IAChD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;YAC7B,gBAAgB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,EAAE,IAAI,CAAC,CAAC;QAC3E,CAAC,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IACD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,EAAE,CAAC;QAC5E,MAAM,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;QAChD,IAAI,iBAAiB,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACpC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACvB,CAAC;QACD,gBAAgB,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IAC3C,CAAC;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,OAAiB;IACrD,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,IAAI,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAC,EAAE,CAAC;QAC7C,SAAS,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IACzC,CAAC;IACD,IAAI,OAAO,CAAC,QAAQ,CAAC,+BAA+B,CAAC,EAAE,CAAC;QACtD,SAAS,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAA6B;IAC9D,OAAO,iCAAiC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;AACxD,CAAC"}
@@ -0,0 +1,4 @@
1
+ import type { CataloxBoundClient } from "../catalox/client.js";
2
+ import type { MemorixCataloxMetadataFixPlan } from "./types.js";
3
+ export declare function ensureCanonicalMigrationCatalogs(catalox: CataloxBoundClient, plan: MemorixCataloxMetadataFixPlan): Promise<void>;
4
+ //# sourceMappingURL=ensure-canonical-catalogs.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ensure-canonical-catalogs.d.ts","sourceRoot":"","sources":["../../src/migration/ensure-canonical-catalogs.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,YAAY,CAAC;AAyEhE,wBAAsB,gCAAgC,CACpD,OAAO,EAAE,kBAAkB,EAC3B,IAAI,EAAE,6BAA6B,GAClC,OAAO,CAAC,IAAI,CAAC,CAuCf"}
@@ -0,0 +1,101 @@
1
+ import { MEMORIX_COMPLETION_MAPPINGS_CATALOG, MEMORIX_INVENTORY_POLICIES_CATALOG, MEMORIX_OBJECT_TYPE_DESCRIPTORS_CATALOG, } from "../catalog/ids.js";
2
+ const CATALOG_DESCRIPTOR_SEEDS = {
3
+ [MEMORIX_OBJECT_TYPE_DESCRIPTORS_CATALOG]: {
4
+ itemIdField: "id",
5
+ titleField: "objectType",
6
+ queryableFields: [
7
+ { key: "id", label: "Id" },
8
+ { key: "objectType", label: "Object type" },
9
+ { key: "target", label: "Target" },
10
+ ],
11
+ },
12
+ [MEMORIX_COMPLETION_MAPPINGS_CATALOG]: {
13
+ itemIdField: "id",
14
+ titleField: "name",
15
+ queryableFields: [
16
+ { key: "id", label: "Id" },
17
+ { key: "name", label: "Name" },
18
+ { key: "objectType", label: "Object type" },
19
+ ],
20
+ },
21
+ [MEMORIX_INVENTORY_POLICIES_CATALOG]: {
22
+ itemIdField: "id",
23
+ titleField: "id",
24
+ queryableFields: [{ key: "id", label: "Id" }],
25
+ },
26
+ };
27
+ function buildCatalogDescriptor(catalogId, label, seed) {
28
+ return {
29
+ descriptorVersion: "1",
30
+ mode: "replace",
31
+ descriptor: {
32
+ catalogId,
33
+ label,
34
+ sourceMode: "native",
35
+ status: "active",
36
+ capabilities: {
37
+ canList: true,
38
+ canGet: true,
39
+ canCreate: true,
40
+ canEdit: true,
41
+ canDelete: true,
42
+ canImport: true,
43
+ canExport: true,
44
+ canSync: false,
45
+ canValidate: true,
46
+ canViewReferences: true,
47
+ },
48
+ queryableFields: seed.queryableFields.map((field) => ({
49
+ key: field.key,
50
+ label: field.label,
51
+ type: "string",
52
+ indexed: true,
53
+ filterable: true,
54
+ listVisible: true,
55
+ detailVisible: true,
56
+ })),
57
+ identity: {
58
+ itemIdStrategy: "natural",
59
+ itemIdField: seed.itemIdField,
60
+ titleField: seed.titleField,
61
+ },
62
+ },
63
+ };
64
+ }
65
+ export async function ensureCanonicalMigrationCatalogs(catalox, plan) {
66
+ for (const catalog of plan.createCatalogs) {
67
+ const catalogId = catalog.catalogId;
68
+ const existing = await catalox.getCatalog(catalogId);
69
+ if (!existing) {
70
+ if (catalogId === MEMORIX_OBJECT_TYPE_DESCRIPTORS_CATALOG) {
71
+ await catalox.createCatalog({
72
+ catalogId,
73
+ name: catalog.name,
74
+ catalogType: "memorix",
75
+ sourceMode: "native",
76
+ native: { type: "native" },
77
+ });
78
+ }
79
+ else {
80
+ await catalox.ensureCatalog({
81
+ catalogId,
82
+ name: catalog.name,
83
+ status: "active",
84
+ });
85
+ }
86
+ }
87
+ const seed = CATALOG_DESCRIPTOR_SEEDS[catalogId];
88
+ if (seed) {
89
+ const current = await catalox.getCatalogDescriptor(catalogId);
90
+ if (!current) {
91
+ await catalox.upsertCatalogDescriptor(catalogId, buildCatalogDescriptor(catalogId, catalog.name, seed));
92
+ }
93
+ }
94
+ await catalox.ensureBinding({
95
+ appId: plan.appId,
96
+ catalogId,
97
+ access: { canRead: true, canWrite: true, canAdmin: true },
98
+ });
99
+ }
100
+ }
101
+ //# sourceMappingURL=ensure-canonical-catalogs.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ensure-canonical-catalogs.js","sourceRoot":"","sources":["../../src/migration/ensure-canonical-catalogs.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,22 @@
1
+ import type { MemorixTarget } from "../types/index.js";
2
+ import { type CanonicalObjectTypeSpec } from "./object-type-specs.js";
3
+ export type GenerateDescriptorsOptions = {
4
+ identityFieldByObjectType?: Record<string, string>;
5
+ preserveCompletionMappings?: Array<Record<string, unknown>>;
6
+ };
7
+ export declare function buildObjectTypeDescriptor(spec: CanonicalObjectTypeSpec, identityField?: string): Record<string, unknown>;
8
+ export declare function buildObjectListDescriptor(spec: CanonicalObjectTypeSpec): Record<string, unknown>;
9
+ export declare function buildWorkspaceListDescriptor(objectTypes: string[]): Record<string, unknown>;
10
+ export declare function buildCriticalVulnerabilitiesSlice(): Record<string, unknown>;
11
+ export declare function buildItemDescriptor(spec: CanonicalObjectTypeSpec): Record<string, unknown>;
12
+ export declare function buildDefaultInventoryPolicy(): Record<string, unknown>;
13
+ export declare function migrateCompletionMappingToV2(raw: Record<string, unknown>): Record<string, unknown> | null;
14
+ export declare function buildCanonicalDescriptorSet(options?: GenerateDescriptorsOptions): {
15
+ objectTypes: Record<string, Record<string, unknown>>;
16
+ lists: Record<string, Record<string, unknown>>;
17
+ items: Record<string, Record<string, unknown>>;
18
+ inventoryPolicy: Record<string, unknown>;
19
+ completionMappings: Record<string, Record<string, unknown>>;
20
+ };
21
+ export declare function expectedCollectionsForSpecs(specs?: CanonicalObjectTypeSpec[]): Map<MemorixTarget, Set<string>>;
22
+ //# sourceMappingURL=generate-descriptors.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"generate-descriptors.d.ts","sourceRoot":"","sources":["../../src/migration/generate-descriptors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAQvD,OAAO,EASL,KAAK,uBAAuB,EAC7B,MAAM,wBAAwB,CAAC;AAEhC,MAAM,MAAM,0BAA0B,GAAG;IACvC,yBAAyB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnD,0BAA0B,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC7D,CAAC;AAoBF,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,uBAAuB,EAC7B,aAAa,SAAa,GACzB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA0CzB;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,uBAAuB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAmBhG;AAED,wBAAgB,4BAA4B,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAsB3F;AAED,wBAAgB,iCAAiC,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA4B3E;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,uBAAuB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiC1F;AAED,wBAAgB,2BAA2B,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAMrE;AAED,wBAAgB,4BAA4B,CAC1C,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAqBhC;AAED,wBAAgB,2BAA2B,CACzC,OAAO,GAAE,0BAA+B,GACvC;IACD,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACrD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC/C,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC/C,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC7D,CA8BA;AAED,wBAAgB,2BAA2B,CACzC,KAAK,GAAE,uBAAuB,EAAgC,GAC7D,GAAG,CAAC,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAUjC"}
@@ -0,0 +1,234 @@
1
+ import { COMPLETION_MAPPING_SCHEMA_V2, INVENTORY_POLICY_SCHEMA_V1, ITEM_DESCRIPTOR_SCHEMA_V2, LIST_DESCRIPTOR_SCHEMA_V2, OBJECT_TYPE_DESCRIPTOR_SCHEMA_V2, } from "../types/canonical-v2.js";
2
+ import { allowedIdFieldsForTarget, CANONICAL_OBJECT_TYPE_IDS, CANONICAL_OBJECT_TYPE_SPECS, collectionNameFor, defaultIdFieldForTarget, defaultItemDescriptorIdFor, defaultListDescriptorIdFor, titleCaseFromKebab, } from "./object-type-specs.js";
3
+ function minimalRecordIdProperty(identityPath, contentType) {
4
+ return {
5
+ recordId: {
6
+ label: "Record ID",
7
+ source: {
8
+ contentType,
9
+ path: identityPath,
10
+ },
11
+ humanReadable: true,
12
+ sortable: true,
13
+ filterable: true,
14
+ list: true,
15
+ item: true,
16
+ valueType: "string",
17
+ },
18
+ };
19
+ }
20
+ export function buildObjectTypeDescriptor(spec, identityField = "recordId") {
21
+ const canonicalContentType = "snapshots";
22
+ const contentTypes = {};
23
+ for (const contentType of spec.contentTypes) {
24
+ contentTypes[contentType] = {
25
+ postfix: contentType,
26
+ collection: collectionNameFor(spec.objectType, contentType),
27
+ dataRoot: "data",
28
+ isCanonical: contentType === canonicalContentType,
29
+ };
30
+ }
31
+ const identityPath = identityField === "recordId"
32
+ ? "recordId"
33
+ : identityField === "_id"
34
+ ? "_id"
35
+ : identityField;
36
+ return {
37
+ schemaVersion: OBJECT_TYPE_DESCRIPTOR_SCHEMA_V2,
38
+ id: spec.objectType,
39
+ objectType: spec.objectType,
40
+ target: spec.target,
41
+ collectionPrefix: spec.objectType,
42
+ defaultListDescriptorId: defaultListDescriptorIdFor(spec.objectType),
43
+ defaultItemDescriptorId: defaultItemDescriptorIdFor(spec.objectType),
44
+ identity: {
45
+ allowedIdFields: allowedIdFieldsForTarget(spec.target),
46
+ requiredExactlyOne: false,
47
+ defaultIdField: defaultIdFieldForTarget(spec.target),
48
+ },
49
+ defaults: {
50
+ canonicalContentType,
51
+ dataRoot: "data",
52
+ effectiveDatePath: "capturedAt",
53
+ fallbackEffectiveDatePaths: ["modifiedAt", "createdAt"],
54
+ },
55
+ contentTypes,
56
+ properties: minimalRecordIdProperty(identityPath, canonicalContentType),
57
+ relations: {},
58
+ };
59
+ }
60
+ export function buildObjectListDescriptor(spec) {
61
+ return {
62
+ schemaVersion: LIST_DESCRIPTOR_SCHEMA_V2,
63
+ id: defaultListDescriptorIdFor(spec.objectType),
64
+ kind: "object-list",
65
+ title: titleCaseFromKebab(spec.objectType),
66
+ objectType: spec.objectType,
67
+ leadingContentType: "snapshots",
68
+ fields: ["recordId"],
69
+ pagination: {
70
+ enabled: true,
71
+ defaultLimit: 50,
72
+ maxLimit: 200,
73
+ },
74
+ defaultSort: {
75
+ property: "recordId",
76
+ direction: "asc",
77
+ },
78
+ };
79
+ }
80
+ export function buildWorkspaceListDescriptor(objectTypes) {
81
+ return {
82
+ schemaVersion: LIST_DESCRIPTOR_SCHEMA_V2,
83
+ id: "memorix-workspace-records-list",
84
+ kind: "workspace",
85
+ title: "Workspace records",
86
+ objectTypes,
87
+ fields: [
88
+ "objectType",
89
+ "recordTitle",
90
+ "recordId",
91
+ "target",
92
+ "source",
93
+ "lastUpdated",
94
+ "status",
95
+ ],
96
+ pagination: {
97
+ enabled: true,
98
+ defaultLimit: 50,
99
+ maxLimit: 200,
100
+ },
101
+ };
102
+ }
103
+ export function buildCriticalVulnerabilitiesSlice() {
104
+ return {
105
+ schemaVersion: LIST_DESCRIPTOR_SCHEMA_V2,
106
+ id: "critical-vulnerabilities-slice",
107
+ kind: "slice",
108
+ title: "Critical vulnerabilities",
109
+ objectType: "vulnerabilities",
110
+ target: "event",
111
+ contentType: "snapshots",
112
+ fields: ["recordId"],
113
+ filter: {
114
+ mode: "basic",
115
+ combinator: "and",
116
+ rules: [],
117
+ },
118
+ sort: [
119
+ {
120
+ path: "capturedAt",
121
+ direction: "desc",
122
+ },
123
+ ],
124
+ defaultItemDescriptorId: "vulnerability-detail-item",
125
+ pagination: {
126
+ enabled: true,
127
+ defaultLimit: 50,
128
+ maxLimit: 200,
129
+ },
130
+ };
131
+ }
132
+ export function buildItemDescriptor(spec) {
133
+ return {
134
+ schemaVersion: ITEM_DESCRIPTOR_SCHEMA_V2,
135
+ id: defaultItemDescriptorIdFor(spec.objectType),
136
+ title: `${titleCaseFromKebab(spec.objectType)} detail`,
137
+ objectType: spec.objectType,
138
+ identity: {
139
+ idField: defaultIdFieldForTarget(spec.target),
140
+ },
141
+ contentTypes: [
142
+ {
143
+ contentType: "snapshots",
144
+ required: true,
145
+ multiMatch: {
146
+ strategy: "last",
147
+ effectiveDatePath: "capturedAt",
148
+ },
149
+ },
150
+ ],
151
+ sections: [
152
+ {
153
+ id: "summary",
154
+ title: "Summary",
155
+ fields: ["recordId"],
156
+ },
157
+ {
158
+ id: "raw",
159
+ title: "Raw data",
160
+ fields: [],
161
+ },
162
+ ],
163
+ includeRelations: [],
164
+ };
165
+ }
166
+ export function buildDefaultInventoryPolicy() {
167
+ return {
168
+ schemaVersion: INVENTORY_POLICY_SCHEMA_V1,
169
+ id: "default",
170
+ ignoredCollections: [],
171
+ };
172
+ }
173
+ export function migrateCompletionMappingToV2(raw) {
174
+ if (raw.schemaVersion === COMPLETION_MAPPING_SCHEMA_V2 && raw.objectType) {
175
+ return raw;
176
+ }
177
+ const objectType = String(raw.objectType ?? raw.entityType ?? "");
178
+ if (!objectType)
179
+ return null;
180
+ return {
181
+ schemaVersion: COMPLETION_MAPPING_SCHEMA_V2,
182
+ id: raw.id,
183
+ name: raw.name,
184
+ objectType,
185
+ target: raw.target,
186
+ targetCollection: raw.targetCollection,
187
+ targetSelector: raw.targetSelector,
188
+ source: raw.source,
189
+ match: raw.match,
190
+ writeRoot: raw.writeRoot ?? "data",
191
+ fields: raw.fields ?? [],
192
+ onlyFillMissing: raw.onlyFillMissing,
193
+ overwriteExisting: raw.overwriteExisting,
194
+ };
195
+ }
196
+ export function buildCanonicalDescriptorSet(options = {}) {
197
+ const objectTypes = {};
198
+ const lists = {};
199
+ const items = {};
200
+ for (const spec of CANONICAL_OBJECT_TYPE_SPECS) {
201
+ const identityField = options.identityFieldByObjectType?.[spec.objectType] ?? "recordId";
202
+ objectTypes[spec.objectType] = buildObjectTypeDescriptor(spec, identityField);
203
+ lists[defaultListDescriptorIdFor(spec.objectType)] = buildObjectListDescriptor(spec);
204
+ items[defaultItemDescriptorIdFor(spec.objectType)] = buildItemDescriptor(spec);
205
+ }
206
+ lists["memorix-workspace-records-list"] = buildWorkspaceListDescriptor(CANONICAL_OBJECT_TYPE_IDS);
207
+ lists["critical-vulnerabilities-slice"] = buildCriticalVulnerabilitiesSlice();
208
+ const completionMappings = {};
209
+ for (const raw of options.preserveCompletionMappings ?? []) {
210
+ const migrated = migrateCompletionMappingToV2(raw);
211
+ if (migrated?.id) {
212
+ completionMappings[String(migrated.id)] = migrated;
213
+ }
214
+ }
215
+ return {
216
+ objectTypes,
217
+ lists,
218
+ items,
219
+ inventoryPolicy: buildDefaultInventoryPolicy(),
220
+ completionMappings,
221
+ };
222
+ }
223
+ export function expectedCollectionsForSpecs(specs = CANONICAL_OBJECT_TYPE_SPECS) {
224
+ const byTarget = new Map();
225
+ for (const spec of specs) {
226
+ const set = byTarget.get(spec.target) ?? new Set();
227
+ for (const contentType of spec.contentTypes) {
228
+ set.add(collectionNameFor(spec.objectType, contentType));
229
+ }
230
+ byTarget.set(spec.target, set);
231
+ }
232
+ return byTarget;
233
+ }
234
+ //# sourceMappingURL=generate-descriptors.js.map