@itwin/core-backend 5.1.0-dev.42 → 5.1.0-dev.43

package/lib/esm/internal/ElementLRUCache.d.ts

@@ -1,3 +1,4 @@
+import { IModelJsNative } from "@bentley/imodeljs-native";
 import { Id64String } from "@itwin/core-bentley";
 import { ElementLoadOptions, ElementLoadProps, ElementProps } from "@itwin/core-common";
 export interface CachedElement {
@@ -25,4 +26,26 @@ export declare class ElementLRUCache {
     set(el: CachedElement): this;
     get [Symbol.toStringTag](): string;
 }
+/**
+ * A LRU cache for entities. Cache contains the ElementProps and the load options used to load it.
+ * Cache can be searched by id, code or federationGuid.
+ */
+export declare class InstanceKeyLRUCache {
+    readonly capacity: number;
+    static readonly DEFAULT_CAPACITY = 2000;
+    private _argsToResultCache;
+    private _resultToArgsCache;
+    constructor(capacity?: number);
+    set(key: IModelJsNative.ResolveInstanceKeyArgs, result: IModelJsNative.ResolveInstanceKeyResult): this;
+    get(key: IModelJsNative.ResolveInstanceKeyArgs): IModelJsNative.ResolveInstanceKeyResult | undefined;
+    deleteById(id: string): boolean;
+    delete(key: IModelJsNative.ResolveInstanceKeyArgs): boolean;
+    private deleteCachedArgs;
+    private static makeCachedArgs;
+    private static combineCachedArgs;
+    private static makeCodeKey;
+    clear(): void;
+    get size(): number;
+    get [Symbol.toStringTag](): string;
+}
 //# sourceMappingURL=ElementLRUCache.d.ts.map

package/lib/esm/internal/ElementLRUCache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ElementLRUCache.d.ts","sourceRoot":"","sources":["../../../src/internal/ElementLRUCache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAa,kBAAkB,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGnG,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,kBAAkB,CAAA;IAC/B,OAAO,EAAE,YAAY,CAAC;CACvB;AAED;;;GAGG;AACH,qBAAa,eAAe;aA6BS,QAAQ;IA5B3C,gBAAuB,gBAAgB,QAAQ;IAC/C,OAAO,CAAC,aAAa,CAAwC;IAC7D,OAAO,CAAC,YAAY,CAAqC;IACzD,OAAO,CAAC,sBAAsB,CAAiC;IAE/D,OAAO,CAAC,MAAM,CAAC,WAAW;IAO1B,OAAO,CAAC,WAAW;gBAgBgB,QAAQ,SAAmC;IACvE,KAAK,IAAI,IAAI;IAKpB,IAAW,IAAI,IAAI,MAAM,CAExB;IACM,eAAe,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI;IAM1C,MAAM,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO;IAYtC,GAAG,CAAC,GAAG,EAAE,gBAAgB,GAAG,aAAa,GAAG,SAAS;IAoBrD,GAAG,CAAC,EAAE,EAAE,aAAa,GAAG,IAAI;IA6BnC,IAAW,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,MAAM,CAExC;CACF"}
+{"version":3,"file":"ElementLRUCache.d.ts","sourceRoot":"","sources":["../../../src/internal/ElementLRUCache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAQ,UAAU,EAAc,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAa,kBAAkB,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGnG,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,kBAAkB,CAAA;IAC/B,OAAO,EAAE,YAAY,CAAC;CACvB;AAED;;;GAGG;AACH,qBAAa,eAAe;aA6BS,QAAQ;IA5B3C,gBAAuB,gBAAgB,QAAQ;IAC/C,OAAO,CAAC,aAAa,CAAwC;IAC7D,OAAO,CAAC,YAAY,CAAqC;IACzD,OAAO,CAAC,sBAAsB,CAAiC;IAE/D,OAAO,CAAC,MAAM,CAAC,WAAW;IAO1B,OAAO,CAAC,WAAW;gBAgBgB,QAAQ,SAAmC;IACvE,KAAK,IAAI,IAAI;IAKpB,IAAW,IAAI,IAAI,MAAM,CAExB;IACM,eAAe,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI;IAM1C,MAAM,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO;IAYtC,GAAG,CAAC,GAAG,EAAE,gBAAgB,GAAG,aAAa,GAAG,SAAS;IAoBrD,GAAG,CAAC,EAAE,EAAE,aAAa,GAAG,IAAI;IA6BnC,IAAW,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,MAAM,CAExC;CACF;AAwED;;;GAGG;AACH,qBAAa,mBAAmB;aAKK,QAAQ;IAJ3C,gBAAuB,gBAAgB,QAAQ;IAC/C,OAAO,CAAC,kBAAkB,CAA8B;IACxD,OAAO,CAAC,kBAAkB,CAAqC;gBAE5B,QAAQ,SAAmC;IAEvE,GAAG,CAAC,GAAG,EAAE,cAAc,CAAC,sBAAsB,EAAE,MAAM,EAAE,cAAc,CAAC,wBAAwB,GAAG,IAAI;IAsBtG,GAAG,CAAC,GAAG,EAAE,cAAc,CAAC,sBAAsB,GAAG,cAAc,CAAC,wBAAwB,GAAG,SAAS;IAapG,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAS/B,MAAM,CAAC,GAAG,EAAE,cAAc,CAAC,sBAAsB,GAAG,OAAO;IAIlE,OAAO,CAAC,gBAAgB;IAUxB,OAAO,CAAC,MAAM,CAAC,cAAc;IAU7B,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAUhC,OAAO,CAAC,MAAM,CAAC,WAAW;IAOnB,KAAK,IAAI,IAAI;IAIpB,IAAW,IAAI,IAAI,MAAM,CAExB;IACD,IAAW,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,MAAM,CAExC;CACF"}

package/lib/esm/internal/ElementLRUCache.js

@@ -1,3 +1,4 @@
+import { Id64, ITwinError } from "@itwin/core-bentley";
 /**
  * A LRU cache for entities. Cache contains the ElementProps and the load options used to load it.
  * Cache can be searched by id, code or federationGuid.
@@ -30,7 +31,7 @@ export class ElementLRUCache {
                 return this._elementCache.get(id);
         }
         else {
-            throw new Error("No key provided");
+            ITwinError.throwError({ message: "No key provided", iTwinErrorId: { scope: "imodel-cache", key: "invalid-arguments" } });
         }
         return undefined;
     }
@@ -84,7 +85,7 @@ export class ElementLRUCache {
     }
     set(el) {
         if (!el.elProps.id)
-            throw new Error("Element must have an id");
+            ITwinError.throwError({ message: "Element must have an id", iTwinErrorId: { scope: "imodel-cache", key: "invalid-arguments" } });
         // do not cache this element as geom need to be rerender into geom props if any part changes
         // TODO: find a way to handle caching geometry
         if (el.loadOptions.wantGeometry) {
@@ -113,4 +114,166 @@ export class ElementLRUCache {
     }
 }
 ;
+/**
+ * A map to store instance keys based on different optional arguments like id, code, or federationGuid.
+ * This allows the cache to be searched by any combination of arguments.
+ */
+class ArgumentsToResultMap {
+    _idToResult = new Map();
+    _codeToResult = new Map();
+    _federationGuidToResult = new Map();
+    constructor() { }
+    set(args, result) {
+        if (!args.id && !args.code && !args.federationGuid)
+            ITwinError.throwError({ message: "At least one id, code, or federationGuid must be provided", iTwinErrorId: { scope: "imodel-cache", key: "invalid-arguments" } });
+        if (args.id)
+            this._idToResult.set(args.id, result);
+        else
+            this._idToResult.set(result.id, result);
+        if (args.code)
+            this._codeToResult.set(args.code, result);
+        if (args.federationGuid)
+            this._federationGuidToResult.set(args.federationGuid, result);
+    }
+    get(args) {
+        if (!args.id && !args.code && !args.federationGuid)
+            ITwinError.throwError({ message: "At least one id, code, or federationGuid must be provided", iTwinErrorId: { scope: "imodel-cache", key: "invalid-arguments" } });
+        if (args.id)
+            return this._idToResult.get(args.id);
+        else if (args.code)
+            return this._codeToResult.get(args.code);
+        else if (args.federationGuid)
+            return this._federationGuidToResult.get(args.federationGuid);
+        return undefined;
+    }
+    delete(args) {
+        if (!args.id && !args.code && !args.federationGuid)
+            ITwinError.throwError({ message: "At least one id, code, or federationGuid must be provided", iTwinErrorId: { scope: "imodel-cache", key: "invalid-arguments" } });
+        let deleted = false;
+        if (args.id)
+            deleted = this._idToResult.delete(args.id) ? true : deleted;
+        if (args.code)
+            deleted = this._codeToResult.delete(args.code) ? true : deleted;
+        if (args.federationGuid)
+            deleted = this._federationGuidToResult.delete(args.federationGuid) ? true : deleted;
+        return deleted;
+    }
+    clear() {
+        this._idToResult.clear();
+        this._codeToResult.clear();
+        this._federationGuidToResult.clear();
+    }
+    get size() {
+        return this._idToResult.size; // Id to key will always be stored even if code or federationGuid are not provided.
+    }
+    get [Symbol.toStringTag]() {
+        return `idCacheSize=${this._idToResult.size}, codeCacheSize=${this._codeToResult.size}, federationGuidCacheSize=${this._federationGuidToResult.size}`;
+    }
+}
+/**
+ * A LRU cache for entities. Cache contains the ElementProps and the load options used to load it.
+ * Cache can be searched by id, code or federationGuid.
+ */
+export class InstanceKeyLRUCache {
+    capacity;
+    static DEFAULT_CAPACITY = 2000;
+    _argsToResultCache = new ArgumentsToResultMap();
+    _resultToArgsCache = new Map();
+    constructor(capacity = ElementLRUCache.DEFAULT_CAPACITY) {
+        this.capacity = capacity;
+    }
+    set(key, result) {
+        const cacheArgs = InstanceKeyLRUCache.makeCachedArgs(key);
+        cacheArgs.id = cacheArgs.id ? cacheArgs.id : result.id;
+        const existingArgs = this._resultToArgsCache.get(result.id);
+        if (existingArgs) {
+            // Combine existing args with new args for more complete key
+            this._argsToResultCache.delete(existingArgs);
+            const combinedArgs = InstanceKeyLRUCache.combineCachedArgs(existingArgs, cacheArgs);
+            this._argsToResultCache.set(combinedArgs, result);
+            this._resultToArgsCache.set(result.id, combinedArgs);
+        }
+        else {
+            this._argsToResultCache.set(cacheArgs, result);
+            this._resultToArgsCache.set(result.id, cacheArgs);
+        }
+        if (this._resultToArgsCache.size > this.capacity) {
+            const oldestKey = this._resultToArgsCache.keys().next().value;
+            const oldestArgs = this._resultToArgsCache.get(oldestKey);
+            this.deleteCachedArgs({ id: oldestArgs?.id, code: oldestArgs?.code, federationGuid: oldestArgs?.federationGuid });
+        }
+        return this;
+    }
+    get(key) {
+        const args = InstanceKeyLRUCache.makeCachedArgs(key);
+        const cachedResult = this._argsToResultCache.get(args);
+        if (cachedResult) {
+            // Pop the cached result to the end of the cache to mark it as recently used
+            const cachedArgs = this._resultToArgsCache.get(cachedResult.id);
+            if (cachedArgs) {
+                this._resultToArgsCache.delete(cachedResult.id);
+                this._resultToArgsCache.set(cachedResult.id, cachedArgs);
+            }
+        }
+        return cachedResult;
+    }
+    deleteById(id) {
+        if (!Id64.isValidId64(id))
+            ITwinError.throwError({ message: "Invalid id provided", iTwinErrorId: { scope: "imodel-cache", key: "invalid-arguments" } });
+        const cacheArgs = {
+            id: Id64.fromString(id),
+        };
+        return this.deleteCachedArgs(cacheArgs);
+    }
+    delete(key) {
+        const cacheArgs = InstanceKeyLRUCache.makeCachedArgs(key);
+        return this.deleteCachedArgs(cacheArgs);
+    }
+    deleteCachedArgs(key) {
+        const result = this._argsToResultCache.get(key);
+        if (result) {
+            const argsToDelete = this._resultToArgsCache.get(result.id);
+            this._argsToResultCache.delete({ id: argsToDelete?.id, code: argsToDelete?.code, federationGuid: argsToDelete?.federationGuid });
+            this._resultToArgsCache.delete(result.id);
+            return true;
+        }
+        return false;
+    }
+    static makeCachedArgs(args) {
+        if (!args.partialKey && !args.code && !args.federationGuid)
+            ITwinError.throwError({ message: "ResolveInstanceKeyArgs must have a partialKey, code, or federationGuid", iTwinErrorId: { scope: "imodel-cache", key: "invalid-arguments" } });
+        return {
+            id: args.partialKey?.id,
+            code: args.code ? InstanceKeyLRUCache.makeCodeKey(args.code) : undefined,
+            federationGuid: args.federationGuid,
+        };
+    }
+    static combineCachedArgs(originalArgs, newArgs) {
+        if (!originalArgs.id && !originalArgs.code && !originalArgs.federationGuid && !newArgs.id && !newArgs.code && !newArgs.federationGuid)
+            ITwinError.throwError({ message: "ResolveInstanceKeyArgs must have a partialKey, code, or federationGuid", iTwinErrorId: { scope: "imodel-cache", key: "invalid-arguments" } });
+        return {
+            id: newArgs.id ? newArgs.id : originalArgs.id,
+            code: newArgs.code ? newArgs.code : originalArgs.code,
+            federationGuid: newArgs.federationGuid ? newArgs.federationGuid : originalArgs.federationGuid,
+        };
+    }
+    static makeCodeKey(code) {
+        const keys = [code.scope, code.spec];
+        if (code.value !== undefined) {
+            keys.push(code.value);
+        }
+        return JSON.stringify(keys);
+    }
+    clear() {
+        this._argsToResultCache.clear();
+        this._resultToArgsCache.clear();
+    }
+    get size() {
+        return this._resultToArgsCache.size;
+    }
+    get [Symbol.toStringTag]() {
+        return `InstanceKeyCache(size=${this.size}, capacity=${this.capacity})`;
+    }
+}
+;
 //# sourceMappingURL=ElementLRUCache.js.map

package/lib/esm/internal/ElementLRUCache.js.map

@@ -1 +1 @@
-{"version":3,"file":"ElementLRUCache.js","sourceRoot":"","sources":["../../../src/internal/ElementLRUCache.ts"],"names":[],"mappings":"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","sourcesContent":["import { Id64String } from \"@itwin/core-bentley\";\r\nimport { CodeProps, ElementLoadOptions, ElementLoadProps, ElementProps } from \"@itwin/core-common\";\r\n\r\n/* @internal */\r\nexport interface CachedElement {\r\n  loadOptions: ElementLoadOptions\r\n  elProps: ElementProps;\r\n}\r\n\r\n/**\r\n * A LRU cache for entities. Cache contains the ElementProps and the load options used to load it.\r\n * Cache can be searched by id, code or federationGuid.\r\n */\r\nexport class ElementLRUCache {\r\n  public static readonly DEFAULT_CAPACITY = 2000;\r\n  private _elementCache = new Map<Id64String, CachedElement>();\r\n  private _cacheByCode = new Map<Id64String, Id64String>();\r\n  private _cacheByFederationGuid = new Map<string, Id64String>();\r\n\r\n  private static makeCodeKey(code: CodeProps): string {\r\n    const keys = [code.scope, code.spec];\r\n    if (code.value !== undefined) {\r\n      keys.push(code.value);\r\n    }\r\n    return JSON.stringify(keys);\r\n  }\r\n  private findElement(key: ElementLoadProps): CachedElement | undefined {\r\n    if (key.id) {\r\n      return this._elementCache.get(key.id);\r\n    } else if (key.federationGuid) {\r\n      const id = this._cacheByFederationGuid.get(key.federationGuid);\r\n      if (id)\r\n        return this._elementCache.get(id);\r\n    } else if (key.code) {\r\n      const id = this._cacheByCode.get(ElementLRUCache.makeCodeKey(key.code));\r\n      if (id)\r\n        return this._elementCache.get(id);\r\n    } else {\r\n      throw new Error(\"No key provided\");\r\n    }\r\n    return undefined;\r\n  }\r\n  public constructor(public readonly capacity = ElementLRUCache.DEFAULT_CAPACITY) { }\r\n  public clear(): void {\r\n    this._elementCache.clear();\r\n    this._cacheByCode.clear();\r\n    this._cacheByFederationGuid.clear();\r\n  }\r\n  public get size(): number {\r\n    return this._elementCache.size;\r\n  }\r\n  public deleteWithModel(modelId: Id64String): void {\r\n    this._elementCache.forEach((cachedVal, elementId) => {\r\n      if (cachedVal.elProps.model === modelId)\r\n        this.delete({ id: elementId });\r\n    });\r\n  }\r\n  public delete(key: ElementLoadProps): boolean {\r\n    const cachedElement = this.findElement(key);\r\n    if (cachedElement) {\r\n      if (cachedElement.elProps.id)\r\n        this._elementCache.delete(cachedElement.elProps.id);\r\n      this._cacheByCode.delete(ElementLRUCache.makeCodeKey(cachedElement.elProps.code));\r\n      if (cachedElement.elProps.federationGuid)\r\n        this._cacheByFederationGuid.delete(cachedElement.elProps.federationGuid);\r\n      return true;\r\n    }\r\n    return false;\r\n  }\r\n  public get(key: ElementLoadProps): CachedElement | undefined {\r\n    const cachedElement = this.findElement(key);\r\n    if (cachedElement) {\r\n      if (cachedElement.elProps.id) {\r\n        this._elementCache.delete(cachedElement.elProps.id);\r\n        this._elementCache.set(cachedElement.elProps.id, cachedElement);\r\n      }\r\n    }\r\n\r\n    if (cachedElement) {\r\n      if (key.displayStyle !== cachedElement.loadOptions.displayStyle ||\r\n        key.onlyBaseProperties !== cachedElement.loadOptions.onlyBaseProperties ||\r\n        key.renderTimeline !== cachedElement.loadOptions.renderTimeline ||\r\n        key.wantBRepData !== cachedElement.loadOptions.wantBRepData ||\r\n        key.wantGeometry !== cachedElement.loadOptions.wantGeometry) {\r\n        return undefined\r\n      }\r\n    }\r\n    return cachedElement;\r\n  }\r\n  public set(el: CachedElement): this {\r\n    if (!el.elProps.id)\r\n      throw new Error(\"Element must have an id\");\r\n\r\n    // do not cache this element as geom need to be rerender into geom props if any part changes\r\n    // TODO: find a way to handle caching geometry\r\n    if (el.loadOptions.wantGeometry) {\r\n      return this;\r\n    }\r\n\r\n    if (this._elementCache.has(el.elProps.id)) {\r\n      this._elementCache.delete(el.elProps.id);\r\n      this._elementCache.set(el.elProps.id, el);\r\n    } else {\r\n      this._elementCache.set(el.elProps.id, el);\r\n    }\r\n\r\n    if (el.elProps.federationGuid) {\r\n      this._cacheByFederationGuid.set(el.elProps.federationGuid, el.elProps.id);\r\n    }\r\n\r\n    this._cacheByCode.set(ElementLRUCache.makeCodeKey(el.elProps.code), el.elProps.id);\r\n    if (this._elementCache.size > this.capacity) {\r\n      const oldestKey = this._elementCache.keys().next().value as Id64String;\r\n      const oldestElement = this._elementCache.get(oldestKey);\r\n      this.delete({ id: oldestKey, federationGuid: oldestElement?.elProps.federationGuid, code: oldestElement?.elProps.code });\r\n    }\r\n    return this;\r\n  }\r\n  public get [Symbol.toStringTag](): string {\r\n    return `EntityCache(this.size=${this.size}, capacity=${this.capacity})`;\r\n  }\r\n};\r\n"]}
+{"version":3,"file":"ElementLRUCache.js","sourceRoot":"","sources":["../../../src/internal/ElementLRUCache.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAc,UAAU,EAAE,MAAM,qBAAqB,CAAC;AASnE;;;GAGG;AACH,MAAM,OAAO,eAAe;IA6BS;IA5B5B,MAAM,CAAU,gBAAgB,GAAG,IAAI,CAAC;IACvC,aAAa,GAAG,IAAI,GAAG,EAA6B,CAAC;IACrD,YAAY,GAAG,IAAI,GAAG,EAA0B,CAAC;IACjD,sBAAsB,GAAG,IAAI,GAAG,EAAsB,CAAC;IAEvD,MAAM,CAAC,WAAW,CAAC,IAAe;QACxC,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC7B,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxB,CAAC;QACD,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IACO,WAAW,CAAC,GAAqB;QACvC,IAAI,GAAG,CAAC,EAAE,EAAE,CAAC;YACX,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACxC,CAAC;aAAM,IAAI,GAAG,CAAC,cAAc,EAAE,CAAC;YAC9B,MAAM,EAAE,GAAG,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;YAC/D,IAAI,EAAE;gBACJ,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACtC,CAAC;aAAM,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;YACpB,MAAM,EAAE,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,eAAe,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;YACxE,IAAI,EAAE;gBACJ,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACtC,CAAC;aAAM,CAAC;YACN,UAAU,CAAC,UAAU,CAAa,EAAE,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,GAAG,EAAE,mBAAmB,EAAE,EAAE,CAAC,CAAC;QACvI,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,YAAmC,WAAW,eAAe,CAAC,gBAAgB;QAA3C,aAAQ,GAAR,QAAQ,CAAmC;IAAI,CAAC;IAC5E,KAAK;QACV,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;QAC3B,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;QAC1B,IAAI,CAAC,sBAAsB,CAAC,KAAK,EAAE,CAAC;IACtC,CAAC;IACD,IAAW,IAAI;QACb,OAAO,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC;IACjC,CAAC;IACM,eAAe,CAAC,OAAmB;QACxC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,EAAE;YAClD,IAAI,SAAS,CAAC,OAAO,CAAC,KAAK,KAAK,OAAO;gBACrC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;IACL,CAAC;IACM,MAAM,CAAC,GAAqB;QACjC,MAAM,aAAa,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAC5C,IAAI,aAAa,EAAE,CAAC;YAClB,IAAI,aAAa,CAAC,OAAO,CAAC,EAAE;gBAC1B,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YACtD,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,eAAe,CAAC,WAAW,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;YAClF,IAAI,aAAa,CAAC,OAAO,CAAC,cAAc;gBACtC,IAAI,CAAC,sBAAsB,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;YAC3E,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACM,GAAG,CAAC,GAAqB;QAC9B,MAAM,aAAa,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAC5C,IAAI,aAAa,EAAE,CAAC;YAClB,IAAI,aAAa,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;gBAC7B,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;gBACpD,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,EAAE,aAAa,CAAC,CAAC;YAClE,CAAC;QACH,CAAC;QAED,IAAI,aAAa,EAAE,CAAC;YAClB,IAAI,GAAG,CAAC,YAAY,KAAK,aAAa,CAAC,WAAW,CAAC,YAAY;gBAC7D,GAAG,CAAC,kBAAkB,KAAK,aAAa,CAAC,WAAW,CAAC,kBAAkB;gBACvE,GAAG,CAAC,cAAc,KAAK,aAAa,CAAC,WAAW,CAAC,cAAc;gBAC/D,GAAG,CAAC,YAAY,KAAK,aAAa,CAAC,WAAW,CAAC,YAAY;gBAC3D,GAAG,CAAC,YAAY,KAAK,aAAa,CAAC,WAAW,CAAC,YAAY,EAAE,CAAC;gBAC9D,OAAO,SAAS,CAAA;YAClB,CAAC;QACH,CAAC;QACD,OAAO,aAAa,CAAC;IACvB,CAAC;IACM,GAAG,CAAC,EAAiB;QAC1B,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE;YAChB,UAAU,CAAC,UAAU,CAAa,EAAE,OAAO,EAAE,yBAAyB,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,GAAG,EAAE,mBAAmB,EAAE,EAAE,CAAC,CAAC;QAE/I,4FAA4F;QAC5F,8CAA8C;QAC9C,IAAI,EAAE,CAAC,WAAW,CAAC,YAAY,EAAE,CAAC;YAChC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;YAC1C,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YACzC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QAC5C,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QAC5C,CAAC;QAED,IAAI,EAAE,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;YAC9B,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC5E,CAAC;QAED,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,eAAe,CAAC,WAAW,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACnF,IAAI,IAAI,CAAC,aAAa,CAAC,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC5C,MAAM,SAAS,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAmB,CAAC;YACvE,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YACxD,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,aAAa,EAAE,OAAO,CAAC,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QAC3H,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAW,CAAC,MAAM,CAAC,WAAW,CAAC;QAC7B,OAAO,yBAAyB,IAAI,CAAC,IAAI,cAAc,IAAI,CAAC,QAAQ,GAAG,CAAC;IAC1E,CAAC;;AACF,CAAC;AASF;;;GAGG;AACH,MAAM,oBAAoB;IAChB,WAAW,GAAG,IAAI,GAAG,EAAuD,CAAC;IAC7E,aAAa,GAAG,IAAI,GAAG,EAAmD,CAAC;IAC3E,uBAAuB,GAAG,IAAI,GAAG,EAAuD,CAAC;IAEjG,gBAAuB,CAAC;IAEjB,GAAG,CAAC,IAAgB,EAAE,MAA+C;QAC1E,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,cAAc;YAChD,UAAU,CAAC,UAAU,CAAa,EAAE,OAAO,EAAE,2DAA2D,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,GAAG,EAAE,mBAAmB,EAAE,EAAE,CAAC,CAAC;QAEjL,IAAI,IAAI,CAAC,EAAE;YACT,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;;YAEtC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QAE1C,IAAI,IAAI,CAAC,IAAI;YACX,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC5C,IAAI,IAAI,CAAC,cAAc;YACrB,IAAI,CAAC,uBAAuB,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IAClE,CAAC;IACM,GAAG,CAAC,IAAgB;QACzB,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,cAAc;YAChD,UAAU,CAAC,UAAU,CAAa,EAAE,OAAO,EAAE,2DAA2D,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,GAAG,EAAE,mBAAmB,EAAE,EAAE,CAAC,CAAC;QAEjL,IAAI,IAAI,CAAC,EAAE;YACT,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;aAClC,IAAI,IAAI,CAAC,IAAI;YAChB,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;aACtC,IAAI,IAAI,CAAC,cAAc;YAC1B,OAAO,IAAI,CAAC,uBAAuB,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC/D,OAAO,SAAS,CAAC;IACnB,CAAC;IACM,MAAM,CAAC,IAAgB;QAC5B,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,cAAc;YAChD,UAAU,CAAC,UAAU,CAAa,EAAE,OAAO,EAAE,2DAA2D,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,GAAG,EAAE,mBAAmB,EAAE,EAAE,CAAC,CAAC;QAEjL,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,IAAI,IAAI,CAAC,EAAE;YACT,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;QAC9D,IAAI,IAAI,CAAC,IAAI;YACX,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;QAClE,IAAI,IAAI,CAAC,cAAc;YACrB,OAAO,GAAG,IAAI,CAAC,uBAAuB,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;QACtF,OAAO,OAAO,CAAC;IACjB,CAAC;IACM,KAAK;QACV,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;QAC3B,IAAI,CAAC,uBAAuB,CAAC,KAAK,EAAE,CAAC;IACvC,CAAC;IACD,IAAW,IAAI;QACb,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,mFAAmF;IACnH,CAAC;IACD,IAAW,CAAC,MAAM,CAAC,WAAW,CAAC;QAC7B,OAAO,eAAe,IAAI,CAAC,WAAW,CAAC,IAAI,mBAAmB,IAAI,CAAC,aAAa,CAAC,IAAI,6BAA6B,IAAI,CAAC,uBAAuB,CAAC,IAAI,EAAE,CAAC;IACxJ,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,mBAAmB;IAKK;IAJ5B,MAAM,CAAU,gBAAgB,GAAG,IAAI,CAAC;IACvC,kBAAkB,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAChD,kBAAkB,GAAG,IAAI,GAAG,EAA0B,CAAC;IAE/D,YAAmC,WAAW,eAAe,CAAC,gBAAgB;QAA3C,aAAQ,GAAR,QAAQ,CAAmC;IAAI,CAAC;IAE5E,GAAG,CAAC,GAA0C,EAAE,MAA+C;QACpG,MAAM,SAAS,GAAe,mBAAmB,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;QACtE,SAAS,CAAC,EAAE,GAAG,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;QACvD,MAAM,YAAY,GAAG,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC5D,IAAI,YAAY,EAAE,CAAC;YACjB,4DAA4D;YAC5D,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;YAC7C,MAAM,YAAY,GAAe,mBAAmB,CAAC,iBAAiB,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;YAChG,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;YAClD,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC;QACvD,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YAC/C,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;QACpD,CAAC;QAED,IAAI,IAAI,CAAC,kBAAkB,CAAC,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YACjD,MAAM,SAAS,GAAG,IAAI,CAAC,kBAAkB,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAmB,CAAC;YAC5E,MAAM,UAAU,GAAG,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAC1D,IAAI,CAAC,gBAAgB,CAAC,EAAC,EAAE,EAAE,UAAU,EAAE,EAAE,EAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,cAAc,EAAE,UAAU,EAAE,cAAc,EAAC,CAAC,CAAC;QACjH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACM,GAAG,CAAC,GAA0C;QACnD,MAAM,IAAI,GAAG,mBAAmB,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;QACrD,MAAM,YAAY,GAAG,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACvD,IAAI,YAAY,EAAE,CAAC;YACjB,4EAA4E;YAC5E,MAAM,UAAU,GAAG,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;YAChE,IAAI,UAAU,EAAE,CAAC;gBACf,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;gBAChD,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;YAC3D,CAAC;QACH,CAAC;QACD,OAAO,YAAY,CAAC;IACtB,CAAC;IACM,UAAU,CAAC,EAAU;QAC1B,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;YACvB,UAAU,CAAC,UAAU,CAAa,EAAE,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,GAAG,EAAE,mBAAmB,EAAE,EAAE,CAAC,CAAC;QAE3I,MAAM,SAAS,GAAG;YAChB,EAAE,EAAE,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;SACxB,CAAA;QACD,OAAO,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAC1C,CAAC;IACM,MAAM,CAAC,GAA0C;QACtD,MAAM,SAAS,GAAG,mBAAmB,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;QAC1D,OAAO,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAC1C,CAAC;IACO,gBAAgB,CAAC,GAAe;QACtC,MAAM,MAAM,GAAG,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChD,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,YAAY,GAAG,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAC5D,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,EAAC,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,YAAY,EAAE,cAAc,EAAC,CAAC,CAAC;YAC/H,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAC1C,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACO,MAAM,CAAC,cAAc,CAAC,IAA2C;QACvE,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,cAAc;YACxD,UAAU,CAAC,UAAU,CAAa,EAAE,OAAO,EAAE,wEAAwE,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,GAAG,EAAE,mBAAmB,EAAE,EAAE,CAAC,CAAC;QAE9L,OAAO;YACL,EAAE,EAAE,IAAI,CAAC,UAAU,EAAE,EAAE;YACvB,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,mBAAmB,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;YACxE,cAAc,EAAE,IAAI,CAAC,cAAc;SACpC,CAAC;IACJ,CAAC;IACO,MAAM,CAAC,iBAAiB,CAAC,YAAwB,EAAE,OAAmB;QAC5E,IAAI,CAAC,YAAY,CAAC,EAAE,IAAI,CAAC,YAAY,CAAC,IAAI,IAAI,CAAC,YAAY,CAAC,cAAc,IAAI,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,cAAc;YACnI,UAAU,CAAC,UAAU,CAAa,EAAE,OAAO,EAAE,wEAAwE,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,GAAG,EAAE,mBAAmB,EAAE,EAAE,CAAC,CAAC;QAE9L,OAAO;YACL,EAAE,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,EAAE;YAC7C,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI;YACrD,cAAc,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,YAAY,CAAC,cAAc;SAC9F,CAAC;IACJ,CAAC;IACO,MAAM,CAAC,WAAW,CAAC,IAAe;QACxC,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC7B,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxB,CAAC;QACD,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IACM,KAAK;QACV,IAAI,CAAC,kBAAkB,CAAC,KAAK,EAAE,CAAC;QAChC,IAAI,CAAC,kBAAkB,CAAC,KAAK,EAAE,CAAC;IAClC,CAAC;IACD,IAAW,IAAI;QACb,OAAO,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC;IACtC,CAAC;IACD,IAAW,CAAC,MAAM,CAAC,WAAW,CAAC;QAC7B,OAAO,yBAAyB,IAAI,CAAC,IAAI,cAAc,IAAI,CAAC,QAAQ,GAAG,CAAC;IAC1E,CAAC;;AACF,CAAC","sourcesContent":["import { IModelJsNative } from \"@bentley/imodeljs-native\";\r\nimport { Id64, Id64String, ITwinError } from \"@itwin/core-bentley\";\r\nimport { CodeProps, ElementLoadOptions, ElementLoadProps, ElementProps } from \"@itwin/core-common\";\r\n\r\n/* @internal */\r\nexport interface CachedElement {\r\n  loadOptions: ElementLoadOptions\r\n  elProps: ElementProps;\r\n}\r\n\r\n/**\r\n * A LRU cache for entities. Cache contains the ElementProps and the load options used to load it.\r\n * Cache can be searched by id, code or federationGuid.\r\n */\r\nexport class ElementLRUCache {\r\n  public static readonly DEFAULT_CAPACITY = 2000;\r\n  private _elementCache = new Map<Id64String, CachedElement>();\r\n  private _cacheByCode = new Map<Id64String, Id64String>();\r\n  private _cacheByFederationGuid = new Map<string, Id64String>();\r\n\r\n  private static makeCodeKey(code: CodeProps): string {\r\n    const keys = [code.scope, code.spec];\r\n    if (code.value !== undefined) {\r\n      keys.push(code.value);\r\n    }\r\n    return JSON.stringify(keys);\r\n  }\r\n  private findElement(key: ElementLoadProps): CachedElement | undefined {\r\n    if (key.id) {\r\n      return this._elementCache.get(key.id);\r\n    } else if (key.federationGuid) {\r\n      const id = this._cacheByFederationGuid.get(key.federationGuid);\r\n      if (id)\r\n        return this._elementCache.get(id);\r\n    } else if (key.code) {\r\n      const id = this._cacheByCode.get(ElementLRUCache.makeCodeKey(key.code));\r\n      if (id)\r\n        return this._elementCache.get(id);\r\n    } else {\r\n      ITwinError.throwError<ITwinError>({ message: \"No key provided\", iTwinErrorId: { scope: \"imodel-cache\", key: \"invalid-arguments\" } });\r\n    }\r\n    return undefined;\r\n  }\r\n  public constructor(public readonly capacity = ElementLRUCache.DEFAULT_CAPACITY) { }\r\n  public clear(): void {\r\n    this._elementCache.clear();\r\n    this._cacheByCode.clear();\r\n    this._cacheByFederationGuid.clear();\r\n  }\r\n  public get size(): number {\r\n    return this._elementCache.size;\r\n  }\r\n  public deleteWithModel(modelId: Id64String): void {\r\n    this._elementCache.forEach((cachedVal, elementId) => {\r\n      if (cachedVal.elProps.model === modelId)\r\n        this.delete({ id: elementId });\r\n    });\r\n  }\r\n  public delete(key: ElementLoadProps): boolean {\r\n    const cachedElement = this.findElement(key);\r\n    if (cachedElement) {\r\n      if (cachedElement.elProps.id)\r\n        this._elementCache.delete(cachedElement.elProps.id);\r\n      this._cacheByCode.delete(ElementLRUCache.makeCodeKey(cachedElement.elProps.code));\r\n      if (cachedElement.elProps.federationGuid)\r\n        this._cacheByFederationGuid.delete(cachedElement.elProps.federationGuid);\r\n      return true;\r\n    }\r\n    return false;\r\n  }\r\n  public get(key: ElementLoadProps): CachedElement | undefined {\r\n    const cachedElement = this.findElement(key);\r\n    if (cachedElement) {\r\n      if (cachedElement.elProps.id) {\r\n        this._elementCache.delete(cachedElement.elProps.id);\r\n        this._elementCache.set(cachedElement.elProps.id, cachedElement);\r\n      }\r\n    }\r\n\r\n    if (cachedElement) {\r\n      if (key.displayStyle !== cachedElement.loadOptions.displayStyle ||\r\n        key.onlyBaseProperties !== cachedElement.loadOptions.onlyBaseProperties ||\r\n        key.renderTimeline !== cachedElement.loadOptions.renderTimeline ||\r\n        key.wantBRepData !== cachedElement.loadOptions.wantBRepData ||\r\n        key.wantGeometry !== cachedElement.loadOptions.wantGeometry) {\r\n        return undefined\r\n      }\r\n    }\r\n    return cachedElement;\r\n  }\r\n  public set(el: CachedElement): this {\r\n    if (!el.elProps.id)\r\n      ITwinError.throwError<ITwinError>({ message: \"Element must have an id\", iTwinErrorId: { scope: \"imodel-cache\", key: \"invalid-arguments\" } });\r\n\r\n    // do not cache this element as geom need to be rerender into geom props if any part changes\r\n    // TODO: find a way to handle caching geometry\r\n    if (el.loadOptions.wantGeometry) {\r\n      return this;\r\n    }\r\n\r\n    if (this._elementCache.has(el.elProps.id)) {\r\n      this._elementCache.delete(el.elProps.id);\r\n      this._elementCache.set(el.elProps.id, el);\r\n    } else {\r\n      this._elementCache.set(el.elProps.id, el);\r\n    }\r\n\r\n    if (el.elProps.federationGuid) {\r\n      this._cacheByFederationGuid.set(el.elProps.federationGuid, el.elProps.id);\r\n    }\r\n\r\n    this._cacheByCode.set(ElementLRUCache.makeCodeKey(el.elProps.code), el.elProps.id);\r\n    if (this._elementCache.size > this.capacity) {\r\n      const oldestKey = this._elementCache.keys().next().value as Id64String;\r\n      const oldestElement = this._elementCache.get(oldestKey);\r\n      this.delete({ id: oldestKey, federationGuid: oldestElement?.elProps.federationGuid, code: oldestElement?.elProps.code });\r\n    }\r\n    return this;\r\n  }\r\n  public get [Symbol.toStringTag](): string {\r\n    return `EntityCache(this.size=${this.size}, capacity=${this.capacity})`;\r\n  }\r\n};\r\n\r\n/* @internal */\r\ninterface CachedArgs {\r\n  id?: Id64String;\r\n  code?: string;\r\n  federationGuid?: Id64String;\r\n}\r\n\r\n/**\r\n * A map to store instance keys based on different optional arguments like id, code, or federationGuid.\r\n * This allows the cache to be searched by any combination of arguments.\r\n */\r\nclass ArgumentsToResultMap {\r\n  private _idToResult = new Map<Id64String, IModelJsNative.ResolveInstanceKeyResult>();\r\n  private _codeToResult = new Map<string, IModelJsNative.ResolveInstanceKeyResult>();\r\n  private _federationGuidToResult = new Map<Id64String, IModelJsNative.ResolveInstanceKeyResult>();\r\n\r\n  public constructor() { }\r\n\r\n  public set(args: CachedArgs, result: IModelJsNative.ResolveInstanceKeyResult): void {\r\n    if (!args.id && !args.code && !args.federationGuid)\r\n      ITwinError.throwError<ITwinError>({ message: \"At least one id, code, or federationGuid must be provided\", iTwinErrorId: { scope: \"imodel-cache\", key: \"invalid-arguments\" } });\r\n\r\n    if (args.id)\r\n      this._idToResult.set(args.id, result);\r\n    else\r\n      this._idToResult.set(result.id, result);\r\n\r\n    if (args.code)\r\n      this._codeToResult.set(args.code, result);\r\n    if (args.federationGuid)\r\n      this._federationGuidToResult.set(args.federationGuid, result);\r\n  }\r\n  public get(args: CachedArgs): IModelJsNative.ResolveInstanceKeyResult | undefined {\r\n    if (!args.id && !args.code && !args.federationGuid)\r\n      ITwinError.throwError<ITwinError>({ message: \"At least one id, code, or federationGuid must be provided\", iTwinErrorId: { scope: \"imodel-cache\", key: \"invalid-arguments\" } });\r\n\r\n    if (args.id)\r\n      return this._idToResult.get(args.id);\r\n    else if (args.code)\r\n      return this._codeToResult.get(args.code);\r\n    else if (args.federationGuid)\r\n      return this._federationGuidToResult.get(args.federationGuid);\r\n    return undefined;\r\n  }\r\n  public delete(args: CachedArgs): boolean {\r\n    if (!args.id && !args.code && !args.federationGuid)\r\n      ITwinError.throwError<ITwinError>({ message: \"At least one id, code, or federationGuid must be provided\", iTwinErrorId: { scope: \"imodel-cache\", key: \"invalid-arguments\" } });\r\n\r\n    let deleted = false;\r\n    if (args.id)\r\n      deleted = this._idToResult.delete(args.id) ? true : deleted;\r\n    if (args.code)\r\n      deleted = this._codeToResult.delete(args.code) ? true : deleted;\r\n    if (args.federationGuid)\r\n      deleted = this._federationGuidToResult.delete(args.federationGuid) ? true : deleted;\r\n    return deleted;\r\n  }\r\n  public clear(): void {\r\n    this._idToResult.clear();\r\n    this._codeToResult.clear();\r\n    this._federationGuidToResult.clear();\r\n  }\r\n  public get size(): number {\r\n    return this._idToResult.size; // Id to key will always be stored even if code or federationGuid are not provided.\r\n  }\r\n  public get [Symbol.toStringTag](): string {\r\n    return `idCacheSize=${this._idToResult.size}, codeCacheSize=${this._codeToResult.size}, federationGuidCacheSize=${this._federationGuidToResult.size}`;\r\n  }\r\n}\r\n\r\n/**\r\n * A LRU cache for entities. Cache contains the ElementProps and the load options used to load it.\r\n * Cache can be searched by id, code or federationGuid.\r\n */\r\nexport class InstanceKeyLRUCache {\r\n  public static readonly DEFAULT_CAPACITY = 2000;\r\n  private _argsToResultCache = new ArgumentsToResultMap();\r\n  private _resultToArgsCache = new Map<Id64String, CachedArgs>();\r\n\r\n  public constructor(public readonly capacity = ElementLRUCache.DEFAULT_CAPACITY) { }\r\n\r\n  public set(key: IModelJsNative.ResolveInstanceKeyArgs, result: IModelJsNative.ResolveInstanceKeyResult): this {\r\n    const cacheArgs: CachedArgs = InstanceKeyLRUCache.makeCachedArgs(key);\r\n    cacheArgs.id = cacheArgs.id ? cacheArgs.id : result.id;\r\n    const existingArgs = this._resultToArgsCache.get(result.id);\r\n    if (existingArgs) {\r\n      // Combine existing args with new args for more complete key\r\n      this._argsToResultCache.delete(existingArgs);\r\n      const combinedArgs: CachedArgs = InstanceKeyLRUCache.combineCachedArgs(existingArgs, cacheArgs);\r\n      this._argsToResultCache.set(combinedArgs, result);\r\n      this._resultToArgsCache.set(result.id, combinedArgs);\r\n    } else {\r\n      this._argsToResultCache.set(cacheArgs, result);\r\n      this._resultToArgsCache.set(result.id, cacheArgs);\r\n    }\r\n\r\n    if (this._resultToArgsCache.size > this.capacity) {\r\n      const oldestKey = this._resultToArgsCache.keys().next().value as Id64String;\r\n      const oldestArgs = this._resultToArgsCache.get(oldestKey);\r\n      this.deleteCachedArgs({id: oldestArgs?.id,code: oldestArgs?.code, federationGuid: oldestArgs?.federationGuid});\r\n    }\r\n    return this;\r\n  }\r\n  public get(key: IModelJsNative.ResolveInstanceKeyArgs): IModelJsNative.ResolveInstanceKeyResult | undefined {\r\n    const args = InstanceKeyLRUCache.makeCachedArgs(key);\r\n    const cachedResult = this._argsToResultCache.get(args);\r\n    if (cachedResult) {\r\n      // Pop the cached result to the end of the cache to mark it as recently used\r\n      const cachedArgs = this._resultToArgsCache.get(cachedResult.id);\r\n      if (cachedArgs) {\r\n        this._resultToArgsCache.delete(cachedResult.id);\r\n        this._resultToArgsCache.set(cachedResult.id, cachedArgs);\r\n      }\r\n    }\r\n    return cachedResult;\r\n  }\r\n  public deleteById(id: string): boolean {\r\n    if (!Id64.isValidId64(id))\r\n      ITwinError.throwError<ITwinError>({ message: \"Invalid id provided\", iTwinErrorId: { scope: \"imodel-cache\", key: \"invalid-arguments\" } });\r\n\r\n    const cacheArgs = {\r\n      id: Id64.fromString(id),\r\n    }\r\n    return this.deleteCachedArgs(cacheArgs);\r\n  }\r\n  public delete(key: IModelJsNative.ResolveInstanceKeyArgs): boolean {\r\n    const cacheArgs = InstanceKeyLRUCache.makeCachedArgs(key);\r\n    return this.deleteCachedArgs(cacheArgs);\r\n  }\r\n  private deleteCachedArgs(key: CachedArgs): boolean {\r\n    const result = this._argsToResultCache.get(key);\r\n    if (result) {\r\n      const argsToDelete = this._resultToArgsCache.get(result.id);\r\n      this._argsToResultCache.delete({id: argsToDelete?.id, code: argsToDelete?.code, federationGuid: argsToDelete?.federationGuid});\r\n      this._resultToArgsCache.delete(result.id);\r\n      return true;\r\n    }\r\n    return false;\r\n  }\r\n  private static makeCachedArgs(args: IModelJsNative.ResolveInstanceKeyArgs): CachedArgs {\r\n    if (!args.partialKey && !args.code && !args.federationGuid)\r\n      ITwinError.throwError<ITwinError>({ message: \"ResolveInstanceKeyArgs must have a partialKey, code, or federationGuid\", iTwinErrorId: { scope: \"imodel-cache\", key: \"invalid-arguments\" } });\r\n\r\n    return {\r\n      id: args.partialKey?.id,\r\n      code: args.code ? InstanceKeyLRUCache.makeCodeKey(args.code) : undefined,\r\n      federationGuid: args.federationGuid,\r\n    };\r\n  }\r\n  private static combineCachedArgs(originalArgs: CachedArgs, newArgs: CachedArgs): CachedArgs {\r\n    if (!originalArgs.id && !originalArgs.code && !originalArgs.federationGuid && !newArgs.id && !newArgs.code && !newArgs.federationGuid)\r\n      ITwinError.throwError<ITwinError>({ message: \"ResolveInstanceKeyArgs must have a partialKey, code, or federationGuid\", iTwinErrorId: { scope: \"imodel-cache\", key: \"invalid-arguments\" } });\r\n\r\n    return {\r\n      id: newArgs.id ? newArgs.id : originalArgs.id,\r\n      code: newArgs.code ? newArgs.code : originalArgs.code,\r\n      federationGuid: newArgs.federationGuid ? newArgs.federationGuid : originalArgs.federationGuid,\r\n    };\r\n  }\r\n  private static makeCodeKey(code: CodeProps): string {\r\n    const keys = [code.scope, code.spec];\r\n    if (code.value !== undefined) {\r\n      keys.push(code.value);\r\n    }\r\n    return JSON.stringify(keys);\r\n  }\r\n  public clear(): void {\r\n    this._argsToResultCache.clear();\r\n    this._resultToArgsCache.clear();\r\n  }\r\n  public get size(): number {\r\n    return this._resultToArgsCache.size;\r\n  }\r\n  public get [Symbol.toStringTag](): string {\r\n    return `InstanceKeyCache(size=${this.size}, capacity=${this.capacity})`;\r\n  }\r\n};"]}

package/lib/esm/internal/Symbols.d.ts

@@ -17,4 +17,5 @@ export declare const _setHubAccess: unique symbol;
 export declare const _getHubAccess: unique symbol;
 export declare const _mockCheckpoint: unique symbol;
 export declare const _cache: unique symbol;
+export declare const _instanceKeyCache: unique symbol;
 //# sourceMappingURL=Symbols.d.ts.map

package/lib/esm/internal/Symbols.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Symbols.d.ts","sourceRoot":"","sources":["../../../src/internal/Symbols.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,eAAO,MAAM,yBAAyB,eAAmG,CAAC;AAM1I,eAAO,MAAM,MAAM,eAA2B,CAAC;AAC/C,eAAO,MAAM,kBAAkB,eAAuC,CAAC;AACvE,eAAO,MAAM,UAAU,eAA+B,CAAC;AACvD,eAAO,MAAM,QAAQ,eAA6B,CAAC;AACnD,eAAO,MAAM,IAAI,eAAyB,CAAC;AAC3C,gBAAgB;AAChB,eAAO,MAAM,SAAS,eAA8B,CAAC;AACrD,eAAO,MAAM,gBAAgB,eAAqC,CAAC;AACnE,eAAO,MAAM,cAAc,eAAmC,CAAC;AAC/D,gBAAgB;AAChB,eAAO,MAAM,UAAU,eAA+B,CAAC;AACvD,eAAO,MAAM,aAAa,eAAkC,CAAC;AAC7D,eAAO,MAAM,aAAa,eAAkC,CAAC;AAC7D,eAAO,MAAM,eAAe,eAAoC,CAAC;AACjE,eAAO,MAAM,MAAM,eAA2B,CAAC"}
+{"version":3,"file":"Symbols.d.ts","sourceRoot":"","sources":["../../../src/internal/Symbols.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,eAAO,MAAM,yBAAyB,eAAmG,CAAC;AAM1I,eAAO,MAAM,MAAM,eAA2B,CAAC;AAC/C,eAAO,MAAM,kBAAkB,eAAuC,CAAC;AACvE,eAAO,MAAM,UAAU,eAA+B,CAAC;AACvD,eAAO,MAAM,QAAQ,eAA6B,CAAC;AACnD,eAAO,MAAM,IAAI,eAAyB,CAAC;AAC3C,gBAAgB;AAChB,eAAO,MAAM,SAAS,eAA8B,CAAC;AACrD,eAAO,MAAM,gBAAgB,eAAqC,CAAC;AACnE,eAAO,MAAM,cAAc,eAAmC,CAAC;AAC/D,gBAAgB;AAChB,eAAO,MAAM,UAAU,eAA+B,CAAC;AACvD,eAAO,MAAM,aAAa,eAAkC,CAAC;AAC7D,eAAO,MAAM,aAAa,eAAkC,CAAC;AAC7D,eAAO,MAAM,eAAe,eAAoC,CAAC;AACjE,eAAO,MAAM,MAAM,eAA2B,CAAC;AAC/C,eAAO,MAAM,iBAAiB,eAAsC,CAAC"}

package/lib/esm/internal/Symbols.js

@@ -24,4 +24,5 @@ export const _setHubAccess = Symbol.for(sym("setHubAccess"));
 export const _getHubAccess = Symbol.for(sym("getHubAccess"));
 export const _mockCheckpoint = Symbol.for(sym("mockCheckpoint"));
 export const _cache = Symbol.for(sym("cache"));
+export const _instanceKeyCache = Symbol.for(sym("instanceKeyCache"));
 //# sourceMappingURL=Symbols.js.map

package/lib/esm/internal/Symbols.js.map

@@ -1 +1 @@
-{"version":3,"file":"Symbols.js","sourceRoot":"","sources":["../../../src/internal/Symbols.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAEH,MAAM,CAAC,MAAM,yBAAyB,GAAG,MAAM,CAAC,GAAG,CAAC,oFAAoF,CAAC,CAAC;AAE1I,SAAS,GAAG,CAAC,IAAY;IACvB,OAAO,GAAG,IAAI,wCAAwC,CAAC;AACzD,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;AAC/C,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,CAAC;AACvE,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC;AACvD,MAAM,CAAC,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;AACnD,MAAM,CAAC,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;AAC3C,gBAAgB;AAChB,MAAM,CAAC,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC;AACrD,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC;AACnE,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC;AAC/D,gBAAgB;AAChB,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC;AACvD,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC;AAC7D,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC;AAC7D,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC;AACjE,MAAM,CAAC,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Workspace\r\n */\r\n\r\nexport const _implementationProhibited = Symbol.for(\"Implementations of this interface can only be obtained from the containing package\");\r\n\r\nfunction sym(name: string): string {\r\n  return `${name}_core-backend_INTERNAL_ONLY_DO_NOT_USE`;\r\n}\r\n\r\nexport const _close = Symbol.for(sym(\"close\"));\r\nexport const _elementWasCreated = Symbol.for(sym(\"elementWasCreated\"));\r\nexport const _faceProps = Symbol.for(sym(\"faceProps\"));\r\nexport const _getData = Symbol.for(sym(\"getData\"));\r\nexport const _key = Symbol.for(sym(\"key\"));\r\n/** @internal */\r\nexport const _nativeDb = Symbol.for(sym(\"nativeDb\"));\r\nexport const _releaseAllLocks = Symbol.for(sym(\"releaseAllLocks\"));\r\nexport const _verifyChannel = Symbol.for(sym(\"verifyChannel\"));\r\n/** @internal */\r\nexport const _hubAccess = Symbol.for(sym(\"hubAccess\"));\r\nexport const _setHubAccess = Symbol.for(sym(\"setHubAccess\"));\r\nexport const _getHubAccess = Symbol.for(sym(\"getHubAccess\"));\r\nexport const _mockCheckpoint = Symbol.for(sym(\"mockCheckpoint\"));\r\nexport const _cache = Symbol.for(sym(\"cache\"));\r\n"]}
+{"version":3,"file":"Symbols.js","sourceRoot":"","sources":["../../../src/internal/Symbols.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAEH,MAAM,CAAC,MAAM,yBAAyB,GAAG,MAAM,CAAC,GAAG,CAAC,oFAAoF,CAAC,CAAC;AAE1I,SAAS,GAAG,CAAC,IAAY;IACvB,OAAO,GAAG,IAAI,wCAAwC,CAAC;AACzD,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;AAC/C,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,CAAC;AACvE,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC;AACvD,MAAM,CAAC,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;AACnD,MAAM,CAAC,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;AAC3C,gBAAgB;AAChB,MAAM,CAAC,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC;AACrD,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC;AACnE,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC;AAC/D,gBAAgB;AAChB,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC;AACvD,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC;AAC7D,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC;AAC7D,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC;AACjE,MAAM,CAAC,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;AAC/C,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAAC","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Workspace\r\n */\r\n\r\nexport const _implementationProhibited = Symbol.for(\"Implementations of this interface can only be obtained from the containing package\");\r\n\r\nfunction sym(name: string): string {\r\n  return `${name}_core-backend_INTERNAL_ONLY_DO_NOT_USE`;\r\n}\r\n\r\nexport const _close = Symbol.for(sym(\"close\"));\r\nexport const _elementWasCreated = Symbol.for(sym(\"elementWasCreated\"));\r\nexport const _faceProps = Symbol.for(sym(\"faceProps\"));\r\nexport const _getData = Symbol.for(sym(\"getData\"));\r\nexport const _key = Symbol.for(sym(\"key\"));\r\n/** @internal */\r\nexport const _nativeDb = Symbol.for(sym(\"nativeDb\"));\r\nexport const _releaseAllLocks = Symbol.for(sym(\"releaseAllLocks\"));\r\nexport const _verifyChannel = Symbol.for(sym(\"verifyChannel\"));\r\n/** @internal */\r\nexport const _hubAccess = Symbol.for(sym(\"hubAccess\"));\r\nexport const _setHubAccess = Symbol.for(sym(\"setHubAccess\"));\r\nexport const _getHubAccess = Symbol.for(sym(\"getHubAccess\"));\r\nexport const _mockCheckpoint = Symbol.for(sym(\"mockCheckpoint\"));\r\nexport const _cache = Symbol.for(sym(\"cache\"));\r\nexport const _instanceKeyCache = Symbol.for(sym(\"instanceKeyCache\"));\r\n"]}

package/lib/esm/test/ElementLRUCache.test.js

@@ -1,5 +1,6 @@
 import { expect } from "chai";
-import { ElementLRUCache } from "../internal/ElementLRUCache";
+import { ElementLRUCache, InstanceKeyLRUCache } from "../internal/ElementLRUCache";
+import { Id64 } from "@itwin/core-bentley";
 describe('ElementLruCache', () => {
     const testElem1 = {
         loadOptions: {},
@@ -125,6 +126,7 @@ describe('ElementLruCache', () => {
         cache.set(testElem2);
         cache.set(testElem3);
         cache.set(testElemFedGuid);
+        expect(cache.size).to.equal(3);
         const retrievedElem = cache.get({ id: testElem2.elProps.id });
         expect(retrievedElem).to.not.be.undefined;
         expect(retrievedElem).to.equal(testElem2);
@@ -209,4 +211,225 @@ describe('ElementLruCache', () => {
         expect(retrievedElem).to.be.undefined;
     });
 });
+describe('InstanceKeyLRUCache', () => {
+    const testArgs1 = {
+        partialKey: {
+            id: Id64.fromJSON("0x123"),
+            baseClassName: "baseName",
+        },
+    };
+    const testArgs2 = {
+        federationGuid: "testFedGuid",
+    };
+    const testArgs3 = {
+        code: {
+            spec: "testSpec",
+            scope: "testScope",
+            value: "testValue"
+        }
+    };
+    const testArgs4 = {
+        code: {
+            spec: "testSpec",
+            scope: "testScope"
+        }
+    };
+    const testResults = [
+        {
+            id: Id64.fromJSON("0x123"),
+            classFullName: "testName1",
+        },
+        {
+            id: Id64.fromJSON("0x122"),
+            classFullName: "testName2",
+        },
+        {
+            id: Id64.fromJSON("0x133"),
+            classFullName: "testName3",
+        },
+        {
+            id: Id64.fromJSON("0x144"),
+            classFullName: "testName4",
+        }
+    ];
+    it('should store and retrieve a valid InstanceKey', () => {
+        const cache = new InstanceKeyLRUCache(3);
+        cache.set(testArgs1, testResults[0]);
+        const retrievedResult = cache.get({ partialKey: testArgs1.partialKey });
+        expect(retrievedResult).to.not.be.undefined;
+        expect(retrievedResult).to.equal(testResults[0]);
+    });
+    it('should overwrite existing valid InstanceKey', () => {
+        const cache = new InstanceKeyLRUCache(3);
+        const testResult = testResults[0];
+        cache.set(testArgs1, testResult);
+        const retrievedResult = cache.get({ partialKey: testArgs1.partialKey });
+        expect(retrievedResult).to.not.be.undefined;
+        expect(retrievedResult).to.equal(testResult);
+        const newTestResult = { id: testResult.id, classFullName: "newModel" };
+        cache.set(testArgs1, newTestResult);
+        const retrievedResult2 = cache.get({ partialKey: testArgs1.partialKey });
+        expect(retrievedResult2).to.not.be.undefined;
+        expect(retrievedResult2).to.equal(newTestResult);
+    });
+    it('should store and retrieve a valid InstanceKey by fedGuid', () => {
+        const cache = new InstanceKeyLRUCache(3);
+        cache.set(testArgs2, testResults[0]);
+        const retrievedResult = cache.get({ federationGuid: testArgs2.federationGuid });
+        expect(retrievedResult).to.not.be.undefined;
+        expect(retrievedResult).to.equal(testResults[0]);
+    });
+    it('should store and retrieve a valid InstanceKey by code', () => {
+        const cache = new InstanceKeyLRUCache(3);
+        cache.set(testArgs3, testResults[0]);
+        const retrievedResult = cache.get({ code: testArgs3.code });
+        expect(retrievedResult).to.not.be.undefined;
+        expect(retrievedResult).to.equal(testResults[0]);
+        cache.set(testArgs4, testResults[1]);
+        const retrievedResult2 = cache.get({ code: testArgs4.code });
+        expect(retrievedResult2).to.not.be.undefined;
+        expect(retrievedResult2).to.equal(testResults[1]);
+    });
+    it('should find the same InstanceKey with either code, fedGuid, or Id', () => {
+        const cache = new InstanceKeyLRUCache(3);
+        cache.set({ ...testArgs1, ...testArgs2, ...testArgs3 }, testResults[0]);
+        const retrievedResultById = cache.get({ partialKey: testArgs1.partialKey });
+        expect(retrievedResultById).to.not.be.undefined;
+        expect(retrievedResultById).to.equal(testResults[0]);
+        const retrievedResultByFedGuid = cache.get({ federationGuid: testArgs2.federationGuid });
+        expect(retrievedResultByFedGuid).to.not.be.undefined;
+        expect(retrievedResultByFedGuid).to.equal(testResults[0]);
+        const retrievedResultByCode = cache.get({ code: testArgs3.code });
+        expect(retrievedResultByCode).to.not.be.undefined;
+        expect(retrievedResultByCode).to.equal(testResults[0]);
+    });
+    it('should update an existing InstanceKey with either code, fedGuid, or Id', () => {
+        const cache = new InstanceKeyLRUCache(3);
+        cache.set(testArgs1, testResults[0]);
+        cache.set(testArgs2, testResults[0]);
+        cache.set(testArgs3, testResults[0]);
+        const retrievedResultById = cache.get({ partialKey: testArgs1.partialKey });
+        expect(retrievedResultById).to.not.be.undefined;
+        expect(retrievedResultById).to.equal(testResults[0]);
+        const retrievedResultByFedGuid = cache.get({ federationGuid: testArgs2.federationGuid });
+        expect(retrievedResultByFedGuid).to.not.be.undefined;
+        expect(retrievedResultByFedGuid).to.equal(testResults[0]);
+        const retrievedResultByCode = cache.get({ code: testArgs3.code });
+        expect(retrievedResultByCode).to.not.be.undefined;
+        expect(retrievedResultByCode).to.equal(testResults[0]);
+    });
+    it('should delete least used element', () => {
+        const cache = new InstanceKeyLRUCache(3);
+        cache.set(testArgs1, testResults[0]);
+        cache.set(testArgs2, testResults[1]);
+        cache.set(testArgs3, testResults[2]);
+        cache.set(testArgs4, testResults[3]);
+        expect(cache.size).to.equal(3);
+        const retrievedResult = cache.get(testArgs2);
+        expect(retrievedResult).to.not.be.undefined;
+        expect(retrievedResult).to.equal(testResults[1]);
+        const retrievedResult2 = cache.get(testArgs1);
+        expect(retrievedResult2).to.be.undefined;
+        const retrievedResult3 = cache.get(testArgs3);
+        expect(retrievedResult3).to.not.be.undefined;
+        expect(retrievedResult3).to.equal(testResults[2]);
+    });
+    it('should delete with partialKey', () => {
+        const cache = new InstanceKeyLRUCache(3);
+        cache.set(testArgs1, testResults[0]);
+        cache.set(testArgs2, testResults[1]);
+        cache.set(testArgs3, testResults[2]);
+        expect(cache.size).to.equal(3);
+        cache.delete({ partialKey: testArgs1.partialKey });
+        expect(cache.size).to.equal(2);
+        const retrievedResult = cache.get({ partialKey: testArgs1.partialKey });
+        expect(retrievedResult).to.be.undefined;
+        const retrievedResult2 = cache.get(testArgs2);
+        expect(retrievedResult2).to.not.be.undefined;
+        expect(retrievedResult2).to.equal(testResults[1]);
+    });
+    it('should delete with id', () => {
+        const cache = new InstanceKeyLRUCache(3);
+        cache.set(testArgs1, testResults[0]);
+        cache.set(testArgs2, testResults[1]);
+        cache.set(testArgs3, testResults[2]);
+        expect(cache.size).to.equal(3);
+        cache.deleteById(testArgs1.partialKey.id);
+        expect(cache.size).to.equal(2);
+        const retrievedResult = cache.get({ partialKey: testArgs1.partialKey });
+        expect(retrievedResult).to.be.undefined;
+        const retrievedResult2 = cache.get(testArgs2);
+        expect(retrievedResult2).to.not.be.undefined;
+        expect(retrievedResult2).to.equal(testResults[1]);
+    });
+    it('should throw when deleting with a bad id', () => {
+        const cache = new InstanceKeyLRUCache(3);
+        cache.set(testArgs1, testResults[0]);
+        cache.set(testArgs2, testResults[1]);
+        cache.set(testArgs3, testResults[2]);
+        expect(cache.size).to.equal(3);
+        expect(() => cache.deleteById("badid")).to.throw(Error, "Invalid id provided");
+        expect(cache.size).to.equal(3);
+    });
+    it('should delete with federation guid', () => {
+        const cache = new InstanceKeyLRUCache(3);
+        cache.set(testArgs1, testResults[0]);
+        cache.set(testArgs2, testResults[1]);
+        cache.set(testArgs3, testResults[2]);
+        expect(cache.size).to.equal(3);
+        cache.delete({ federationGuid: testArgs2.federationGuid });
+        expect(cache.size).to.equal(2);
+        const retrievedResult = cache.get({ federationGuid: testArgs2.federationGuid });
+        expect(retrievedResult).to.be.undefined;
+        const retrievedResult2 = cache.get(testArgs3);
+        expect(retrievedResult2).to.not.be.undefined;
+        expect(retrievedResult2).to.equal(testResults[2]);
+    });
+    it('should delete with code', () => {
+        const cache = new InstanceKeyLRUCache(3);
+        cache.set(testArgs1, testResults[0]);
+        cache.set(testArgs2, testResults[1]);
+        cache.set(testArgs3, testResults[2]);
+        expect(cache.size).to.equal(3);
+        cache.delete({ code: testArgs3.code });
+        expect(cache.size).to.equal(2);
+        const retrievedResult = cache.get({ code: testArgs3.code });
+        expect(retrievedResult).to.be.undefined;
+        const retrievedResult2 = cache.get(testArgs1);
+        expect(retrievedResult2).to.not.be.undefined;
+        expect(retrievedResult2).to.equal(testResults[0]);
+    });
+    it('should delete with any applicable arg', () => {
+        const cache = new InstanceKeyLRUCache(3);
+        cache.set(testArgs1, testResults[0]);
+        cache.set(testArgs2, testResults[0]);
+        cache.set(testArgs3, testResults[0]);
+        expect(cache.size).to.equal(1);
+        cache.delete(testArgs3);
+        expect(cache.size).to.equal(0);
+        const retrievedResult = cache.get(testArgs1);
+        expect(retrievedResult).to.be.undefined;
+        cache.set(testArgs1, testResults[0]);
+        cache.set(testArgs2, testResults[1]);
+        cache.set(testArgs3, testResults[2]);
+        expect(cache.size).to.equal(3);
+        cache.set(testArgs4, testResults[0]);
+        expect(cache.size).to.equal(3);
+        cache.delete(testArgs4);
+        expect(cache.size).to.equal(2);
+        const retrievedResult2 = cache.get(testArgs1);
+        expect(retrievedResult2).to.be.undefined;
+    });
+    it('should clear the cache', () => {
+        const cache = new InstanceKeyLRUCache(3);
+        cache.set(testArgs1, testResults[0]);
+        cache.set(testArgs2, testResults[1]);
+        cache.set(testArgs3, testResults[2]);
+        expect(cache.size).to.equal(3);
+        cache.clear();
+        expect(cache.size).to.equal(0);
+        const retrievedElem = cache.get(testArgs1);
+        expect(retrievedElem).to.be.undefined;
+    });
+});
 //# sourceMappingURL=ElementLRUCache.test.js.map