@memberjunction/core-entities 5.49.0 → 5.50.0

package/dist/engines/artifacts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"artifacts.d.ts","sourceRoot":"","sources":["../../src/engines/artifacts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAA4B,iBAAiB,EAAa,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACpH,OAAO,EACH,oBAAoB,EACpB,gBAAgB,EAChB,uBAAuB,EAC1B,MAAM,gCAAgC,CAAC;AAOxC;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,UAAU,CAAC,sBAAsB,CAAC;IAC1E;;OAEG;IACH,WAAkB,QAAQ,IAAI,sBAAsB,CAEnD;IAED,OAAO,CAAC,cAAc,CAA8B;IACpD,OAAO,CAAC,UAAU,CAA0B;IAC5C,OAAO,CAAC,iBAAiB,CAAiC;IAE7C,MAAM,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,iBAAiB;IAwBhG,IAAW,aAAa,IAAI,oBAAoB,EAAE,CAEjD;IAED,kCAAkC;IAClC,IAAW,SAAS,IAAI,gBAAgB,EAAE,CAEzC;IAED,0CAA0C;IAC1C,IAAW,gBAAgB,IAAI,uBAAuB,EAAE,CAEvD;IAED;;OAEG;IACI,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS;IAOvE,iCAAiC;IAC1B,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAMjE,yCAAyC;IAClC,uBAAuB,CAAC,EAAE,EAAE,MAAM,GAAG,uBAAuB,GAAG,SAAS;IAM/E,gFAAgF;IACzE,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,uBAAuB,EAAE;IAQ5E,sCAAsC;IAC/B,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS;IAMzE;;;OAGG;IACI,cAAc,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO;IAIhE;;;;;;OAMG;IACI,yBAAyB,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS;IAM5G;;;;;OAKG;IACI,gCAAgC,IAAI,IAAI;IAU/C,OAAO,CAAC,SAAS;CASpB"}
+{"version":3,"file":"artifacts.d.ts","sourceRoot":"","sources":["../../src/engines/artifacts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAA4B,iBAAiB,EAAwC,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAC/I,OAAO,EACH,oBAAoB,EACpB,gBAAgB,EAChB,uBAAuB,EAC1B,MAAM,gCAAgC,CAAC;AAOxC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,qBAAa,sBAAuB,SAAQ,UAAU,CAAC,sBAAsB,CAAC;IAC1E;;OAEG;IACH,WAAkB,QAAQ,IAAI,sBAAsB,CAEnD;IAED,OAAO,CAAC,cAAc,CAA8B;IAKpD,OAAO,CAAC,cAAc,CAAuC;IAC7D,OAAO,CAAC,aAAa,CAA8C;IACnE,OAAO,CAAC,mBAAmB,CAAgD;IAE9D,MAAM,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,iBAAiB;IAYhG,IAAW,aAAa,IAAI,oBAAoB,EAAE,CAEjD;IAED;;;OAGG;IACH,IAAW,eAAe,IAAI,gBAAgB,EAAE,CAE/C;IAED;;;;OAIG;IACH,IAAW,sBAAsB,IAAI,uBAAuB,EAAE,CAE7D;IAED;;OAEG;IACI,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS;IAOvE;;;;OAIG;IACI,sBAAsB,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAKvE;;;;OAIG;IACI,6BAA6B,CAAC,EAAE,EAAE,MAAM,GAAG,uBAAuB,GAAG,SAAS;IAKrF;;;;;OAKG;IACI,4BAA4B,CAAC,UAAU,EAAE,MAAM,GAAG,uBAAuB,EAAE;IAMlF;;;;;;;;;;;OAWG;IACU,uBAAuB,CAChC,UAAU,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,QAAQ,EACtB,QAAQ,CAAC,EAAE,iBAAiB,EAC5B,YAAY,CAAC,EAAE,OAAO,GACvB,OAAO,CAAC,uBAAuB,EAAE,CAAC;IA6BrC;;;;;;;;OAQG;IACU,iBAAiB,CAC1B,SAAS,EAAE,MAAM,EACjB,WAAW,CAAC,EAAE,QAAQ,EACtB,QAAQ,CAAC,EAAE,iBAAiB,EAC5B,YAAY,CAAC,EAAE,OAAO,GACvB,OAAO,CAAC,uBAAuB,GAAG,SAAS,CAAC;IAmB/C,sCAAsC;IAC/B,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS;IAMzE;;;OAGG;IACI,cAAc,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO;IAIhE;;;;;;OAMG;IACI,yBAAyB,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS;IAM5G;;;;;OAKG;IACI,gCAAgC,IAAI,IAAI;IAU/C,OAAO,CAAC,SAAS;CASpB"}

package/dist/engines/artifacts.js

@@ -1,14 +1,49 @@
-import { BaseEngine, LogStatus } from "@memberjunction/core";
+import { BaseEngine, LogStatus, RunView } from "@memberjunction/core";
 import { ResolveArtifactTypeByMime, FindArtifactTypeConflicts, } from "./artifact-mime-resolver.js";
 /**
  * Caching of metadata for artifacts, artifact versions, and artifact types.
+ *
+ * ## Boot payload is bounded by design
+ *
+ * Only **artifact types** are eagerly loaded at `Config()` time — a small,
+ * fixed registry. Artifacts and artifact versions are NOT bulk-loaded: a
+ * version's `Content` column holds arbitrarily large payloads (base64 blobs,
+ * snapshots, etc.), so eager-loading every version made cold boot download the
+ * entire artifact corpus and — because the result dwarfed the local cache
+ * budget — wiped the whole client cache on each login. Instead, artifacts and
+ * versions are fetched **on demand** for a specific artifact via
+ * {@link LoadVersionsForArtifact} / {@link GetVersionContent}, keeping startup
+ * cost independent of how much artifact content a deployment has accumulated.
+ *
+ * The on-demand results are memoized in per-ID maps so the synchronous
+ * accessors ({@link FindCachedArtifactByID}, {@link FindCachedArtifactVersionByID},
+ * {@link GetCachedVersionsForArtifact}) serve anything already fetched this
+ * session. A cache miss is not an error — callers fall back to a direct entity
+ * load.
+ *
+ * ## Naming: `Cached*` accessors are session-scoped, NOT the full corpus
+ *
+ * The synchronous artifact/version accessors are deliberately prefixed
+ * `Cached` (`CachedArtifacts`, `CachedArtifactVersions`, `FindCachedArtifactByID`,
+ * `FindCachedArtifactVersionByID`, `GetCachedVersionsForArtifact`) to make it
+ * unmistakable that they return only what has been fetched on demand this
+ * session — never the entire system's artifacts. They replace the former
+ * unprefixed accessors (`Artifacts`, `ArtifactVersions`, `FindArtifactByID`,
+ * `FindArtifactVersionByID`, `GetVersionsForArtifact`) whose names implied a
+ * full boot-time load that no longer happens. The rename is intentional: it
+ * turns any consumer that assumed full-corpus semantics into a hard compile
+ * error rather than a silent empty-result regression.
  */
 export class ArtifactMetadataEngine extends BaseEngine {
     constructor() {
         super(...arguments);
         this._artifactTypes = [];
-        this._artifacts = [];
-        this._artifactVersions = [];
+        // On-demand caches — populated lazily by the loaders below, NOT at boot.
+        // Keyed by lowercased ID for case-insensitive lookup across SQL Server
+        // (uppercase UUIDs) and PostgreSQL (lowercase UUIDs).
+        this._artifactCache = new Map();
+        this._versionCache = new Map();
+        this._versionsByArtifact = new Map();
     }
     /**
      * 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 of it, always use this method to get the instance.
@@ -23,18 +58,6 @@ export class ArtifactMetadataEngine extends BaseEngine {
                 EntityName: 'MJ: Artifact Types',
                 PropertyName: "_artifactTypes",
                 CacheLocal: true
-            },
-            {
-                Type: 'entity',
-                EntityName: 'MJ: Artifacts',
-                PropertyName: "_artifacts",
-                CacheLocal: true
-            },
-            {
-                Type: 'entity',
-                EntityName: 'MJ: Artifact Versions',
-                PropertyName: "_artifactVersions",
-                CacheLocal: true
             }
         ];
         await this.Load(c, provider, forceRefresh, contextUser);
@@ -42,13 +65,20 @@ export class ArtifactMetadataEngine extends BaseEngine {
     get ArtifactTypes() {
         return this.GetConfigData('_artifactTypes');
     }
-    /** All artifacts in the system */
-    get Artifacts() {
-        return this.GetConfigData('_artifacts');
+    /**
+     * Artifacts fetched on demand this session (via {@link LoadVersionsForArtifact}).
+     * NOT the full system corpus — artifacts are no longer bulk-loaded at boot.
+     */
+    get CachedArtifacts() {
+        return Array.from(this._artifactCache.values());
     }
-    /** All artifact versions in the system */
-    get ArtifactVersions() {
-        return this.GetConfigData('_artifactVersions');
+    /**
+     * Artifact versions fetched on demand this session (via
+     * {@link LoadVersionsForArtifact} / {@link GetVersionContent}). NOT the full
+     * system corpus — versions are no longer bulk-loaded at boot.
+     */
+    get CachedArtifactVersions() {
+        return Array.from(this._versionCache.values());
     }
     /**
      * Finds an artifact type on a case-insensitive match of name
@@ -59,28 +89,103 @@ export class ArtifactMetadataEngine extends BaseEngine {
         }
         return this._artifactTypes.find(c => c.Name.trim().toLowerCase() === name.trim().toLowerCase());
     }
-    /** Find an artifact by its ID */
-    FindArtifactByID(id) {
+    /**
+     * Find an artifact by its ID among those fetched on demand this session.
+     * Returns undefined on a cache miss — call {@link LoadVersionsForArtifact}
+     * first, or fall back to a direct entity load.
+     */
+    FindCachedArtifactByID(id) {
         if (!id)
             return undefined;
-        const lower = id.trim().toLowerCase();
-        return this._artifacts.find(a => a.ID.trim().toLowerCase() === lower);
+        return this._artifactCache.get(id.trim().toLowerCase());
     }
-    /** Find an artifact version by its ID */
-    FindArtifactVersionByID(id) {
+    /**
+     * Find an artifact version by its ID among those fetched on demand this
+     * session. Returns undefined on a cache miss — call {@link GetVersionContent}
+     * or {@link LoadVersionsForArtifact} first, or fall back to a direct load.
+     */
+    FindCachedArtifactVersionByID(id) {
         if (!id)
             return undefined;
-        const lower = id.trim().toLowerCase();
-        return this._artifactVersions.find(v => v.ID.trim().toLowerCase() === lower);
+        return this._versionCache.get(id.trim().toLowerCase());
     }
-    /** Get all versions for a given artifact, sorted by VersionNumber descending */
-    GetVersionsForArtifact(artifactId) {
+    /**
+     * Get all versions for a given artifact that were fetched on demand this
+     * session, sorted by VersionNumber descending. Returns [] if
+     * {@link LoadVersionsForArtifact} has not been called for this artifact —
+     * this is a synchronous cache read, not a loader.
+     */
+    GetCachedVersionsForArtifact(artifactId) {
+        if (!artifactId)
+            return [];
+        const cached = this._versionsByArtifact.get(artifactId.trim().toLowerCase());
+        return cached ? [...cached] : [];
+    }
+    /**
+     * Loads all versions (including the `Content` column) for a single artifact
+     * from the database and memoizes them. This is the on-demand replacement
+     * for the former boot-time bulk load: the payload is bounded to one
+     * artifact's versions rather than the entire corpus.
+     *
+     * @param artifactId - the artifact whose versions to load
+     * @param contextUser - required server-side for correct user scoping
+     * @param provider - optional non-default provider (multi-provider clients)
+     * @param forceRefresh - re-query even if already cached this session
+     * @returns the artifact's versions, sorted by VersionNumber descending
+     */
+    async LoadVersionsForArtifact(artifactId, contextUser, provider, forceRefresh) {
         if (!artifactId)
             return [];
-        const lower = artifactId.trim().toLowerCase();
-        return this._artifactVersions
-            .filter(v => v.ArtifactID.trim().toLowerCase() === lower)
-            .sort((a, b) => (b.VersionNumber || 0) - (a.VersionNumber || 0));
+        const key = artifactId.trim().toLowerCase();
+        if (!forceRefresh && this._versionsByArtifact.has(key)) {
+            return this.GetCachedVersionsForArtifact(artifactId);
+        }
+        const rvProvider = provider ?? this.RunViewProviderToUse;
+        const rv = new RunView(rvProvider);
+        const result = await rv.RunView({
+            EntityName: 'MJ: Artifact Versions',
+            ExtraFilter: `ArtifactID='${artifactId.replace(/'/g, "''")}'`,
+            OrderBy: 'VersionNumber DESC',
+            ResultType: 'entity_object'
+        }, contextUser);
+        if (!result.Success) {
+            LogStatus(`WARN ArtifactMetadataEngine.LoadVersionsForArtifact: failed to load versions for artifact ${artifactId}: ${result.ErrorMessage}`);
+            return this.GetCachedVersionsForArtifact(artifactId);
+        }
+        const versions = result.Results || [];
+        this._versionsByArtifact.set(key, versions);
+        for (const v of versions) {
+            this._versionCache.set(v.ID.trim().toLowerCase(), v);
+        }
+        return [...versions];
+    }
+    /**
+     * Loads a single artifact version (including `Content`) by ID on demand and
+     * memoizes it. Returns undefined if the version can't be loaded.
+     *
+     * @param versionId - the artifact version to load
+     * @param contextUser - required server-side for correct user scoping
+     * @param provider - optional non-default provider (multi-provider clients)
+     * @param forceRefresh - re-load even if already cached this session
+     */
+    async GetVersionContent(versionId, contextUser, provider, forceRefresh) {
+        if (!versionId)
+            return undefined;
+        const key = versionId.trim().toLowerCase();
+        if (!forceRefresh) {
+            const existing = this._versionCache.get(key);
+            if (existing)
+                return existing;
+        }
+        const p = provider ?? this.ProviderToUse;
+        const version = await p.GetEntityObject('MJ: Artifact Versions', contextUser);
+        const loaded = await version.Load(versionId);
+        if (!loaded) {
+            LogStatus(`WARN ArtifactMetadataEngine.GetVersionContent: failed to load version ${versionId}`);
+            return undefined;
+        }
+        this._versionCache.set(key, version);
+        return version;
     }
     /** Find an artifact type by its ID */
     FindArtifactTypeByID(id) {

package/dist/engines/artifacts.js.map

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

package/dist/engines/knowledgeHubMetadata.d.ts

@@ -13,12 +13,19 @@ export declare class KnowledgeHubMetadataEngine extends BaseEngine<KnowledgeHubM
      * of it, always use this method to get the instance.
      */
     static get Instance(): KnowledgeHubMetadataEngine;
+    protected constructor();
     private _entityDocuments;
     private _vectorIndexes;
     private _contentSources;
     private _contentTypes;
     private _contentSourceTypes;
     private _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.
+     */
+    private _idIndexes;
     Config(forceRefresh?: boolean, contextUser?: UserInfo, provider?: IMetadataProvider): Promise<void>;
     /** All entity documents in the system (both active and inactive) */
     get EntityDocuments(): MJEntityDocumentEntity[];
@@ -34,12 +41,27 @@ export declare class KnowledgeHubMetadataEngine extends BaseEngine<KnowledgeHubM
     get ContentFileTypes(): MJContentFileTypeEntity[];
     /** Returns only entity documents with Status = 'Active' */
     GetActiveEntityDocuments(): MJEntityDocumentEntity[];
-    /** Find an entity document by ID (case-insensitive UUID comparison) */
-    GetEntityDocumentById(id: string): MJEntityDocumentEntity | undefined;
+    /**
+     * 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.
+     */
+    private getIDIndex;
+    /** Find an entity document by ID (case-insensitive UUID comparison). O(1) after first hit. */
+    GetEntityDocumentByID(id: string): MJEntityDocumentEntity | undefined;
+    /** Find a content source by ID (case-insensitive UUID comparison). O(1) after first hit. */
+    GetContentSourceByID(id: string): MJContentSourceEntity | undefined;
+    /** Find a content type by ID (case-insensitive UUID comparison). O(1) after first hit. */
+    GetContentTypeByID(id: string): MJContentTypeEntity | undefined;
+    /** Find a content source type by ID (case-insensitive UUID comparison). O(1) after first hit. */
+    GetContentSourceTypeByID(id: string): MJContentSourceTypeEntity | undefined;
+    /** Find a content file type by ID (case-insensitive UUID comparison). O(1) after first hit. */
+    GetContentFileTypeByID(id: string): MJContentFileTypeEntity | undefined;
     /** Find all entity documents for a given entity name (case-insensitive) */
     GetEntityDocumentsForEntity(entityName: string): MJEntityDocumentEntity[];
-    /** Find a vector index by ID (case-insensitive UUID comparison) */
-    GetVectorIndexById(id: string): MJVectorIndexEntity | undefined;
+    /** Find a vector index by ID (case-insensitive UUID comparison). O(1) after first hit. */
+    GetVectorIndexByID(id: string): MJVectorIndexEntity | undefined;
     /**
      * Returns distinct entity names that have active entity documents (for dropdowns).
      * Sorted alphabetically.

package/dist/engines/knowledgeHubMetadata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"knowledgeHubMetadata.d.ts","sourceRoot":"","sources":["../../src/engines/knowledgeHubMetadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAA4B,iBAAiB,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEzG,OAAO,EACH,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,EACnB,yBAAyB,EACzB,uBAAuB,EAC1B,MAAM,gCAAgC,CAAC;AAExC;;;;;GAKG;AACH,qBAAa,0BAA2B,SAAQ,UAAU,CAAC,0BAA0B,CAAC;IAClF;;;;OAIG;IACH,WAAkB,QAAQ,IAAI,0BAA0B,CAEvD;IAED,OAAO,CAAC,gBAAgB,CAAgC;IACxD,OAAO,CAAC,cAAc,CAA6B;IACnD,OAAO,CAAC,eAAe,CAA+B;IACtD,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,mBAAmB,CAAmC;IAC9D,OAAO,CAAC,iBAAiB,CAAiC;IAE7C,MAAM,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,iBAAiB;IA8ChG,oEAAoE;IACpE,IAAW,eAAe,IAAI,sBAAsB,EAAE,CAErD;IAED,uCAAuC;IACvC,IAAW,aAAa,IAAI,mBAAmB,EAAE,CAEhD;IAED,0BAA0B;IAC1B,IAAW,cAAc,IAAI,qBAAqB,EAAE,CAEnD;IAED,wBAAwB;IACxB,IAAW,YAAY,IAAI,mBAAmB,EAAE,CAE/C;IAED,uDAAuD;IACvD,IAAW,kBAAkB,IAAI,yBAAyB,EAAE,CAE3D;IAED,iDAAiD;IACjD,IAAW,gBAAgB,IAAI,uBAAuB,EAAE,CAEvD;IAMD,2DAA2D;IACpD,wBAAwB,IAAI,sBAAsB,EAAE;IAI3D,uEAAuE;IAChE,qBAAqB,CAAC,EAAE,EAAE,MAAM,GAAG,sBAAsB,GAAG,SAAS;IAK5E,2EAA2E;IACpE,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,sBAAsB,EAAE;IAMhF,mEAAmE;IAC5D,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS;IAKtE;;;OAGG;IACI,wBAAwB,IAAI,MAAM,EAAE;CAS9C"}
+{"version":3,"file":"knowledgeHubMetadata.d.ts","sourceRoot":"","sources":["../../src/engines/knowledgeHubMetadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAwC,iBAAiB,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAErH,OAAO,EACH,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,EACnB,yBAAyB,EACzB,uBAAuB,EAC1B,MAAM,gCAAgC,CAAC;AAExC;;;;;GAKG;AACH,qBAAa,0BAA2B,SAAQ,UAAU,CAAC,0BAA0B,CAAC;IAClF;;;;OAIG;IACH,WAAkB,QAAQ,IAAI,0BAA0B,CAEvD;IAED,SAAS;IAQT,OAAO,CAAC,gBAAgB,CAAgC;IACxD,OAAO,CAAC,cAAc,CAA6B;IACnD,OAAO,CAAC,eAAe,CAA+B;IACtD,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,mBAAmB,CAAmC;IAC9D,OAAO,CAAC,iBAAiB,CAAiC;IAE1D;;;;OAIG;IACH,OAAO,CAAC,UAAU,CAA8C;IAEnD,MAAM,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,iBAAiB;IA8ChG,oEAAoE;IACpE,IAAW,eAAe,IAAI,sBAAsB,EAAE,CAErD;IAED,uCAAuC;IACvC,IAAW,aAAa,IAAI,mBAAmB,EAAE,CAEhD;IAED,0BAA0B;IAC1B,IAAW,cAAc,IAAI,qBAAqB,EAAE,CAEnD;IAED,wBAAwB;IACxB,IAAW,YAAY,IAAI,mBAAmB,EAAE,CAE/C;IAED,uDAAuD;IACvD,IAAW,kBAAkB,IAAI,yBAAyB,EAAE,CAE3D;IAED,iDAAiD;IACjD,IAAW,gBAAgB,IAAI,uBAAuB,EAAE,CAEvD;IAMD,2DAA2D;IACpD,wBAAwB,IAAI,sBAAsB,EAAE;IAI3D;;;;;OAKG;IACH,OAAO,CAAC,UAAU;IAclB,8FAA8F;IACvF,qBAAqB,CAAC,EAAE,EAAE,MAAM,GAAG,sBAAsB,GAAG,SAAS;IAK5E,4FAA4F;IACrF,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS;IAK1E,0FAA0F;IACnF,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS;IAKtE,iGAAiG;IAC1F,wBAAwB,CAAC,EAAE,EAAE,MAAM,GAAG,yBAAyB,GAAG,SAAS;IAKlF,+FAA+F;IACxF,sBAAsB,CAAC,EAAE,EAAE,MAAM,GAAG,uBAAuB,GAAG,SAAS;IAK9E,2EAA2E;IACpE,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,sBAAsB,EAAE;IAMhF,0FAA0F;IACnF,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS;IAKtE;;;OAGG;IACI,wBAAwB,IAAI,MAAM,EAAE;CAS9C"}

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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"}