@memberjunction/core-entities 5.48.0 → 5.50.0

package/dist/engines/knowledgeHubMetadata.js

@@ -1,5 +1,5 @@
 import { BaseEngine } from "@memberjunction/core";
-import { UUIDsEqual } from "@memberjunction/global";
+import { NormalizeUUID } from "@memberjunction/global";
 /**
  * Caches Knowledge Hub metadata: entity documents, vector indexes, vector databases,
  * content sources, content types, content source types, and content file types.
@@ -7,15 +7,6 @@ import { UUIDsEqual } from "@memberjunction/global";
  * caching and entity-event auto-refresh.
  */
 export class KnowledgeHubMetadataEngine extends BaseEngine {
-    constructor() {
-        super(...arguments);
-        this._entityDocuments = [];
-        this._vectorIndexes = [];
-        this._contentSources = [];
-        this._contentTypes = [];
-        this._contentSourceTypes = [];
-        this._contentFileTypes = [];
-    }
     /**
      * Returns the global instance of the class. This is a singleton class, so there
      * is only one instance of it in the application. Do not directly create new instances
@@ -24,6 +15,25 @@ export class KnowledgeHubMetadataEngine extends BaseEngine {
     static get Instance() {
         return super.getInstance();
     }
+    constructor() {
+        super();
+        this._entityDocuments = [];
+        this._vectorIndexes = [];
+        this._contentSources = [];
+        this._contentTypes = [];
+        this._contentSourceTypes = [];
+        this._contentFileTypes = [];
+        /**
+         * Lazily-built `NormalizeUUID(ID) → row` indexes, one per cached array (keyed by array name),
+         * powering the O(1) `Get…ByID` helpers. Cleared wholesale on any {@link DataChange$} emission
+         * (see the constructor) so entries never go stale as the underlying caches mutate.
+         */
+        this._idIndexes = new Map();
+        // Any data change (add/update/delete or full refresh, on any cached array) invalidates the
+        // by-id indexes wholesale — the cheapest correct strategy, since NotifyDataChange fires on
+        // every BaseEngine mutation path. Lazily rebuilt on the next lookup.
+        this.DataChange$.subscribe(() => this._idIndexes.clear());
+    }
     async Config(forceRefresh, contextUser, provider) {
         const c = [
             {
@@ -99,11 +109,55 @@ export class KnowledgeHubMetadataEngine extends BaseEngine {
     GetActiveEntityDocuments() {
         return this._entityDocuments.filter(d => d.Status === 'Active');
     }
-    /** Find an entity document by ID (case-insensitive UUID comparison) */
-    GetEntityDocumentById(id) {
+    /**
+     * Returns a cached `NormalizeUUID(ID) → row` index for one of the engine's cached arrays,
+     * building it on first use. The whole index cache is cleared on any {@link DataChange$}
+     * emission, so a returned index is always consistent with the current cache contents.
+     * O(N) to build once, then O(1) per lookup.
+     */
+    getIDIndex(key, rows, idOf) {
+        // Downcast is safe by construction: each `key` is only ever paired with one row type.
+        let index = this._idIndexes.get(key);
+        if (!index) {
+            index = new Map();
+            for (const row of rows) {
+                const id = idOf(row);
+                if (id)
+                    index.set(NormalizeUUID(id), row);
+            }
+            this._idIndexes.set(key, index);
+        }
+        return index;
+    }
+    /** Find an entity document by ID (case-insensitive UUID comparison). O(1) after first hit. */
+    GetEntityDocumentByID(id) {
+        if (!id)
+            return undefined;
+        return this.getIDIndex('entityDocuments', this._entityDocuments, d => d.ID).get(NormalizeUUID(id));
+    }
+    /** Find a content source by ID (case-insensitive UUID comparison). O(1) after first hit. */
+    GetContentSourceByID(id) {
+        if (!id)
+            return undefined;
+        return this.getIDIndex('contentSources', this._contentSources, s => s.ID).get(NormalizeUUID(id));
+    }
+    /** Find a content type by ID (case-insensitive UUID comparison). O(1) after first hit. */
+    GetContentTypeByID(id) {
+        if (!id)
+            return undefined;
+        return this.getIDIndex('contentTypes', this._contentTypes, t => t.ID).get(NormalizeUUID(id));
+    }
+    /** Find a content source type by ID (case-insensitive UUID comparison). O(1) after first hit. */
+    GetContentSourceTypeByID(id) {
+        if (!id)
+            return undefined;
+        return this.getIDIndex('contentSourceTypes', this._contentSourceTypes, t => t.ID).get(NormalizeUUID(id));
+    }
+    /** Find a content file type by ID (case-insensitive UUID comparison). O(1) after first hit. */
+    GetContentFileTypeByID(id) {
         if (!id)
             return undefined;
-        return this._entityDocuments.find(d => UUIDsEqual(d.ID, id));
+        return this.getIDIndex('contentFileTypes', this._contentFileTypes, t => t.ID).get(NormalizeUUID(id));
     }
     /** Find all entity documents for a given entity name (case-insensitive) */
     GetEntityDocumentsForEntity(entityName) {
@@ -112,11 +166,11 @@ export class KnowledgeHubMetadataEngine extends BaseEngine {
         const lower = entityName.trim().toLowerCase();
         return this._entityDocuments.filter(d => d.Entity?.trim().toLowerCase() === lower);
     }
-    /** Find a vector index by ID (case-insensitive UUID comparison) */
-    GetVectorIndexById(id) {
+    /** Find a vector index by ID (case-insensitive UUID comparison). O(1) after first hit. */
+    GetVectorIndexByID(id) {
         if (!id)
             return undefined;
-        return this._vectorIndexes.find(v => UUIDsEqual(v.ID, id));
+        return this.getIDIndex('vectorIndexes', this._vectorIndexes, v => v.ID).get(NormalizeUUID(id));
     }
     /**
      * Returns distinct entity names that have active entity documents (for dropdowns).

package/dist/engines/knowledgeHubMetadata.js.map

@@ -1 +1 @@
-{"version":3,"file":"knowledgeHubMetadata.js","sourceRoot":"","sources":["../../src/engines/knowledgeHubMetadata.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"knowledgeHubMetadata.js","sourceRoot":"","sources":["../../src/engines/knowledgeHubMetadata.ts"],"names":[],"mappings":"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"}