@itwin/presentation-backend 4.0.0-dev.48 → 4.0.0-dev.51

package/lib/cjs/presentation-backend/TemporaryStorage.d.ts

@@ -1,124 +1,124 @@
-/** @packageDocumentation
- * @module Core
- */
-import { IDisposable } from "@itwin/core-bentley";
-/**
- * Configuration properties for [[TemporaryStorage]].
- * @internal
- */
-export interface TemporaryStorageProps<T> {
-    /** A method that's called for every value before it's removed from storage */
-    cleanupHandler?: (id: string, value: T, reason: "timeout" | "dispose" | "request") => void;
-    onDisposedSingle?: (id: string) => void;
-    onDisposedAll?: () => void;
-    /**
-     * An interval at which the storage attempts to clean up its values.
-     * When `0` or `undefined` is specified, values are not cleaned up
-     * automatically and cleanup has to be initiated manually by calling
-     * [[TemporaryStorage.disposeOutdatedValues]].
-     */
-    cleanupInterval?: number;
-    /**
-     * Shortest period of time which the value should be kept in storage
-     * unused before it's cleaned up.
-     *
-     * `undefined` means the values may be kept unused in the storage indefinitely.
-     * `0` means the values are removed from the storage on every cleanup (either manual
-     * call to [[TemporaryStorage.disposeOutdatedValues]] or scheduled (controlled
-     * by [[cleanupInterval]])).
-     */
-    unusedValueLifetime?: number;
-    /**
-     * The maximum period of time which the value should be kept in storage
-     * before it's cleaned up. The time is measured from the moment the value is added
-     * to the storage.
-     *
-     * `undefined` means the values may be kept indefinitely. `0` means they're removed
-     * up on every cleanup (either manual call to [[TemporaryStorage.disposeOutdatedValues]]
-     * or scheduled (controlled by [[cleanupInterval]])).
-     */
-    maxValueLifetime?: number;
-}
-/** Value with know last used time */
-interface TemporaryValue<T> {
-    created: Date;
-    lastUsed: Date;
-    value: T;
-}
-/**
- * Storage for values that get removed from it after being unused (not-requested
- * for a specified amount of time).
- *
- * @internal
- */
-export declare class TemporaryStorage<T> implements IDisposable {
-    private _timer?;
-    protected _values: Map<string, TemporaryValue<T>>;
-    readonly props: TemporaryStorageProps<T>;
-    /**
-     * Constructor. Creates the storage using supplied params.
-     */
-    constructor(props: TemporaryStorageProps<T>);
-    /**
-     * Destructor. Must be called to clean up the stored values
-     * and other resources
-     */
-    dispose(): void;
-    /**
-     * Cleans up values that are currently outdated (based
-     * on their max and unused value lifetimes specified through [[Props]]).
-     */
-    disposeOutdatedValues: () => void;
-    private deleteExistingEntry;
-    /**
-     * Get a value from the storage.
-     *
-     * **Note:** requesting a value with this method updates it's last used time.
-     */
-    getValue(id: string): T | undefined;
-    notifyValueUsed(id: string): void;
-    /**
-     * Adds a value into the storage.
-     * @throws An error when trying to add a value with ID that's already stored in the storage.
-     */
-    addValue(id: string, value: T): void;
-    /** Deletes a value with given id. */
-    deleteValue(id: string): void;
-    /**
-     * Get all values currently in this storage.
-     *
-     * **Note:** requesting values with this method **doesn't**
-     * update their last used times.
-     */
-    get values(): T[];
-}
-/**
- * Configuration properties for [[FactoryBasedTemporaryStorage]].
- * @internal
- */
-export interface FactoryBasedTemporaryStorageProps<T> extends TemporaryStorageProps<T> {
-    /** A factory method that creates a stored value given it's identifier */
-    factory: (id: string, onValueUsed: () => void) => T;
-}
-/**
- * Storage for values that get removed from it after being unused (not-requested
- * for a specified amount of time).
- *
- * @internal
- */
-export declare class FactoryBasedTemporaryStorage<T> extends TemporaryStorage<T> {
-    readonly props: FactoryBasedTemporaryStorageProps<T>;
-    /**
-     * Constructor. Creates the storage using supplied params.
-     */
-    constructor(props: FactoryBasedTemporaryStorageProps<T>);
-    /**
-     * Get a value from the storage. If the value with the specified id
-     * doesn't exist, it gets created.
-     *
-     * **Note:** requesting a value with this method updates it's last used time.
-     */
-    getValue(id: string): T;
-}
-export {};
+/** @packageDocumentation
+ * @module Core
+ */
+import { IDisposable } from "@itwin/core-bentley";
+/**
+ * Configuration properties for [[TemporaryStorage]].
+ * @internal
+ */
+export interface TemporaryStorageProps<T> {
+    /** A method that's called for every value before it's removed from storage */
+    cleanupHandler?: (id: string, value: T, reason: "timeout" | "dispose" | "request") => void;
+    onDisposedSingle?: (id: string) => void;
+    onDisposedAll?: () => void;
+    /**
+     * An interval at which the storage attempts to clean up its values.
+     * When `0` or `undefined` is specified, values are not cleaned up
+     * automatically and cleanup has to be initiated manually by calling
+     * [[TemporaryStorage.disposeOutdatedValues]].
+     */
+    cleanupInterval?: number;
+    /**
+     * Shortest period of time which the value should be kept in storage
+     * unused before it's cleaned up.
+     *
+     * `undefined` means the values may be kept unused in the storage indefinitely.
+     * `0` means the values are removed from the storage on every cleanup (either manual
+     * call to [[TemporaryStorage.disposeOutdatedValues]] or scheduled (controlled
+     * by [[cleanupInterval]])).
+     */
+    unusedValueLifetime?: number;
+    /**
+     * The maximum period of time which the value should be kept in storage
+     * before it's cleaned up. The time is measured from the moment the value is added
+     * to the storage.
+     *
+     * `undefined` means the values may be kept indefinitely. `0` means they're removed
+     * up on every cleanup (either manual call to [[TemporaryStorage.disposeOutdatedValues]]
+     * or scheduled (controlled by [[cleanupInterval]])).
+     */
+    maxValueLifetime?: number;
+}
+/** Value with know last used time */
+interface TemporaryValue<T> {
+    created: Date;
+    lastUsed: Date;
+    value: T;
+}
+/**
+ * Storage for values that get removed from it after being unused (not-requested
+ * for a specified amount of time).
+ *
+ * @internal
+ */
+export declare class TemporaryStorage<T> implements IDisposable {
+    private _timer?;
+    protected _values: Map<string, TemporaryValue<T>>;
+    readonly props: TemporaryStorageProps<T>;
+    /**
+     * Constructor. Creates the storage using supplied params.
+     */
+    constructor(props: TemporaryStorageProps<T>);
+    /**
+     * Destructor. Must be called to clean up the stored values
+     * and other resources
+     */
+    dispose(): void;
+    /**
+     * Cleans up values that are currently outdated (based
+     * on their max and unused value lifetimes specified through [[Props]]).
+     */
+    disposeOutdatedValues: () => void;
+    private deleteExistingEntry;
+    /**
+     * Get a value from the storage.
+     *
+     * **Note:** requesting a value with this method updates it's last used time.
+     */
+    getValue(id: string): T | undefined;
+    notifyValueUsed(id: string): void;
+    /**
+     * Adds a value into the storage.
+     * @throws An error when trying to add a value with ID that's already stored in the storage.
+     */
+    addValue(id: string, value: T): void;
+    /** Deletes a value with given id. */
+    deleteValue(id: string): void;
+    /**
+     * Get all values currently in this storage.
+     *
+     * **Note:** requesting values with this method **doesn't**
+     * update their last used times.
+     */
+    get values(): T[];
+}
+/**
+ * Configuration properties for [[FactoryBasedTemporaryStorage]].
+ * @internal
+ */
+export interface FactoryBasedTemporaryStorageProps<T> extends TemporaryStorageProps<T> {
+    /** A factory method that creates a stored value given it's identifier */
+    factory: (id: string, onValueUsed: () => void) => T;
+}
+/**
+ * Storage for values that get removed from it after being unused (not-requested
+ * for a specified amount of time).
+ *
+ * @internal
+ */
+export declare class FactoryBasedTemporaryStorage<T> extends TemporaryStorage<T> {
+    readonly props: FactoryBasedTemporaryStorageProps<T>;
+    /**
+     * Constructor. Creates the storage using supplied params.
+     */
+    constructor(props: FactoryBasedTemporaryStorageProps<T>);
+    /**
+     * Get a value from the storage. If the value with the specified id
+     * doesn't exist, it gets created.
+     *
+     * **Note:** requesting a value with this method updates it's last used time.
+     */
+    getValue(id: string): T;
+}
+export {};
 //# sourceMappingURL=TemporaryStorage.d.ts.map

package/lib/cjs/presentation-backend/TemporaryStorage.js

@@ -1,152 +1,152 @@
-"use strict";
-/*---------------------------------------------------------------------------------------------
-* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
-* See LICENSE.md in the project root for license terms and full copyright notice.
-*--------------------------------------------------------------------------------------------*/
-/** @packageDocumentation
- * @module Core
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.FactoryBasedTemporaryStorage = exports.TemporaryStorage = void 0;
-const core_bentley_1 = require("@itwin/core-bentley");
-const presentation_common_1 = require("@itwin/presentation-common");
-/**
- * Storage for values that get removed from it after being unused (not-requested
- * for a specified amount of time).
- *
- * @internal
- */
-class TemporaryStorage {
-    /**
-     * Constructor. Creates the storage using supplied params.
-     */
-    constructor(props) {
-        /**
-         * Cleans up values that are currently outdated (based
-         * on their max and unused value lifetimes specified through [[Props]]).
-         */
-        this.disposeOutdatedValues = () => {
-            const now = (new Date()).getTime();
-            const valuesToDispose = [];
-            for (const [key, entry] of this._values.entries()) {
-                if (this.props.maxValueLifetime !== undefined) {
-                    if (this.props.maxValueLifetime === 0 || (now - entry.created.getTime()) > this.props.maxValueLifetime) {
-                        valuesToDispose.push(key);
-                        continue;
-                    }
-                }
-                if (this.props.unusedValueLifetime !== undefined) {
-                    if (this.props.unusedValueLifetime === 0 || (now - entry.lastUsed.getTime()) > this.props.unusedValueLifetime) {
-                        valuesToDispose.push(key);
-                        continue;
-                    }
-                }
-            }
-            for (const id of valuesToDispose)
-                this.deleteExistingEntry(id, true);
-        };
-        this.props = props;
-        this._values = new Map();
-        if (this.props.cleanupInterval)
-            this._timer = setInterval(this.disposeOutdatedValues, this.props.cleanupInterval);
-    }
-    /**
-     * Destructor. Must be called to clean up the stored values
-     * and other resources
-     */
-    dispose() {
-        if (this._timer)
-            clearInterval(this._timer);
-        if (this.props.cleanupHandler) {
-            this._values.forEach((v, id) => {
-                this.props.cleanupHandler(id, v.value, "dispose");
-            });
-        }
-        this._values.clear();
-        this.props.onDisposedAll && this.props.onDisposedAll();
-    }
-    deleteExistingEntry(id, isTimeout) {
-        (0, core_bentley_1.assert)(this._values.has(id));
-        this.props.cleanupHandler && this.props.cleanupHandler(id, this._values.get(id).value, isTimeout ? "timeout" : "request");
-        this._values.delete(id);
-        this.props.onDisposedSingle && this.props.onDisposedSingle(id);
-    }
-    /**
-     * Get a value from the storage.
-     *
-     * **Note:** requesting a value with this method updates it's last used time.
-     */
-    getValue(id) {
-        if (this._values.has(id)) {
-            const v = this._values.get(id);
-            v.lastUsed = new Date();
-            return v.value;
-        }
-        return undefined;
-    }
-    notifyValueUsed(id) {
-        const entry = this._values.get(id);
-        // istanbul ignore else
-        if (entry)
-            entry.lastUsed = new Date();
-    }
-    /**
-     * Adds a value into the storage.
-     * @throws An error when trying to add a value with ID that's already stored in the storage.
-     */
-    addValue(id, value) {
-        if (this._values.has(id))
-            throw new presentation_common_1.PresentationError(presentation_common_1.PresentationStatus.InvalidArgument, `A value with given ID "${id}" already exists in this storage.`);
-        this._values.set(id, { value, created: new Date(), lastUsed: new Date() });
-    }
-    /** Deletes a value with given id. */
-    deleteValue(id) {
-        // istanbul ignore else
-        if (this._values.has(id))
-            this.deleteExistingEntry(id, false);
-    }
-    /**
-     * Get all values currently in this storage.
-     *
-     * **Note:** requesting values with this method **doesn't**
-     * update their last used times.
-     */
-    get values() {
-        const values = new Array();
-        for (const v of this._values.values())
-            values.push(v.value);
-        return values;
-    }
-}
-exports.TemporaryStorage = TemporaryStorage;
-/**
- * Storage for values that get removed from it after being unused (not-requested
- * for a specified amount of time).
- *
- * @internal
- */
-class FactoryBasedTemporaryStorage extends TemporaryStorage {
-    /**
-     * Constructor. Creates the storage using supplied params.
-     */
-    constructor(props) {
-        super(props);
-        this.props = props;
-    }
-    /**
-     * Get a value from the storage. If the value with the specified id
-     * doesn't exist, it gets created.
-     *
-     * **Note:** requesting a value with this method updates it's last used time.
-     */
-    getValue(id) {
-        const existingValue = super.getValue(id);
-        if (existingValue)
-            return existingValue;
-        const value = this.props.factory(id, () => this.notifyValueUsed(id));
-        this.addValue(id, value);
-        return value;
-    }
-}
-exports.FactoryBasedTemporaryStorage = FactoryBasedTemporaryStorage;
+"use strict";
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Core
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FactoryBasedTemporaryStorage = exports.TemporaryStorage = void 0;
+const core_bentley_1 = require("@itwin/core-bentley");
+const presentation_common_1 = require("@itwin/presentation-common");
+/**
+ * Storage for values that get removed from it after being unused (not-requested
+ * for a specified amount of time).
+ *
+ * @internal
+ */
+class TemporaryStorage {
+    /**
+     * Constructor. Creates the storage using supplied params.
+     */
+    constructor(props) {
+        /**
+         * Cleans up values that are currently outdated (based
+         * on their max and unused value lifetimes specified through [[Props]]).
+         */
+        this.disposeOutdatedValues = () => {
+            const now = (new Date()).getTime();
+            const valuesToDispose = [];
+            for (const [key, entry] of this._values.entries()) {
+                if (this.props.maxValueLifetime !== undefined) {
+                    if (this.props.maxValueLifetime === 0 || (now - entry.created.getTime()) > this.props.maxValueLifetime) {
+                        valuesToDispose.push(key);
+                        continue;
+                    }
+                }
+                if (this.props.unusedValueLifetime !== undefined) {
+                    if (this.props.unusedValueLifetime === 0 || (now - entry.lastUsed.getTime()) > this.props.unusedValueLifetime) {
+                        valuesToDispose.push(key);
+                        continue;
+                    }
+                }
+            }
+            for (const id of valuesToDispose)
+                this.deleteExistingEntry(id, true);
+        };
+        this.props = props;
+        this._values = new Map();
+        if (this.props.cleanupInterval)
+            this._timer = setInterval(this.disposeOutdatedValues, this.props.cleanupInterval);
+    }
+    /**
+     * Destructor. Must be called to clean up the stored values
+     * and other resources
+     */
+    dispose() {
+        if (this._timer)
+            clearInterval(this._timer);
+        if (this.props.cleanupHandler) {
+            this._values.forEach((v, id) => {
+                this.props.cleanupHandler(id, v.value, "dispose");
+            });
+        }
+        this._values.clear();
+        this.props.onDisposedAll && this.props.onDisposedAll();
+    }
+    deleteExistingEntry(id, isTimeout) {
+        (0, core_bentley_1.assert)(this._values.has(id));
+        this.props.cleanupHandler && this.props.cleanupHandler(id, this._values.get(id).value, isTimeout ? "timeout" : "request");
+        this._values.delete(id);
+        this.props.onDisposedSingle && this.props.onDisposedSingle(id);
+    }
+    /**
+     * Get a value from the storage.
+     *
+     * **Note:** requesting a value with this method updates it's last used time.
+     */
+    getValue(id) {
+        if (this._values.has(id)) {
+            const v = this._values.get(id);
+            v.lastUsed = new Date();
+            return v.value;
+        }
+        return undefined;
+    }
+    notifyValueUsed(id) {
+        const entry = this._values.get(id);
+        // istanbul ignore else
+        if (entry)
+            entry.lastUsed = new Date();
+    }
+    /**
+     * Adds a value into the storage.
+     * @throws An error when trying to add a value with ID that's already stored in the storage.
+     */
+    addValue(id, value) {
+        if (this._values.has(id))
+            throw new presentation_common_1.PresentationError(presentation_common_1.PresentationStatus.InvalidArgument, `A value with given ID "${id}" already exists in this storage.`);
+        this._values.set(id, { value, created: new Date(), lastUsed: new Date() });
+    }
+    /** Deletes a value with given id. */
+    deleteValue(id) {
+        // istanbul ignore else
+        if (this._values.has(id))
+            this.deleteExistingEntry(id, false);
+    }
+    /**
+     * Get all values currently in this storage.
+     *
+     * **Note:** requesting values with this method **doesn't**
+     * update their last used times.
+     */
+    get values() {
+        const values = new Array();
+        for (const v of this._values.values())
+            values.push(v.value);
+        return values;
+    }
+}
+exports.TemporaryStorage = TemporaryStorage;
+/**
+ * Storage for values that get removed from it after being unused (not-requested
+ * for a specified amount of time).
+ *
+ * @internal
+ */
+class FactoryBasedTemporaryStorage extends TemporaryStorage {
+    /**
+     * Constructor. Creates the storage using supplied params.
+     */
+    constructor(props) {
+        super(props);
+        this.props = props;
+    }
+    /**
+     * Get a value from the storage. If the value with the specified id
+     * doesn't exist, it gets created.
+     *
+     * **Note:** requesting a value with this method updates it's last used time.
+     */
+    getValue(id) {
+        const existingValue = super.getValue(id);
+        if (existingValue)
+            return existingValue;
+        const value = this.props.factory(id, () => this.notifyValueUsed(id));
+        this.addValue(id, value);
+        return value;
+    }
+}
+exports.FactoryBasedTemporaryStorage = FactoryBasedTemporaryStorage;
 //# sourceMappingURL=TemporaryStorage.js.map

package/lib/cjs/presentation-backend/TemporaryStorage.js.map

@@ -1 +1 @@
-{"version":3,"file":"TemporaryStorage.js","sourceRoot":"","sources":["../../../src/presentation-backend/TemporaryStorage.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Core\n */\n\nimport { assert, IDisposable } from \"@itwin/core-bentley\";\nimport { PresentationError, PresentationStatus } from \"@itwin/presentation-common\";\n\n/**\n * Configuration properties for [[TemporaryStorage]].\n * @internal\n */\nexport interface TemporaryStorageProps<T> {\n  /** A method that's called for every value before it's removed from storage */\n  cleanupHandler?: (id: string, value: T, reason: \"timeout\" | \"dispose\" | \"request\") => void;\n\n  onDisposedSingle?: (id: string) => void;\n  onDisposedAll?: () => void;\n\n  /**\n   * An interval at which the storage attempts to clean up its values.\n   * When `0` or `undefined` is specified, values are not cleaned up\n   * automatically and cleanup has to be initiated manually by calling\n   * [[TemporaryStorage.disposeOutdatedValues]].\n   */\n  cleanupInterval?: number;\n\n  /**\n   * Shortest period of time which the value should be kept in storage\n   * unused before it's cleaned up.\n   *\n   * `undefined` means the values may be kept unused in the storage indefinitely.\n   * `0` means the values are removed from the storage on every cleanup (either manual\n   * call to [[TemporaryStorage.disposeOutdatedValues]] or scheduled (controlled\n   * by [[cleanupInterval]])).\n   */\n  unusedValueLifetime?: number;\n\n  /**\n   * The maximum period of time which the value should be kept in storage\n   * before it's cleaned up. The time is measured from the moment the value is added\n   * to the storage.\n   *\n   * `undefined` means the values may be kept indefinitely. `0` means they're removed\n   * up on every cleanup (either manual call to [[TemporaryStorage.disposeOutdatedValues]]\n   * or scheduled (controlled by [[cleanupInterval]])).\n   */\n  maxValueLifetime?: number;\n}\n\n/** Value with know last used time */\ninterface TemporaryValue<T> {\n  created: Date;\n  lastUsed: Date;\n  value: T;\n}\n\n/**\n * Storage for values that get removed from it after being unused (not-requested\n * for a specified amount of time).\n *\n * @internal\n */\nexport class TemporaryStorage<T> implements IDisposable {\n\n  private _timer?: NodeJS.Timer;\n  protected _values: Map<string, TemporaryValue<T>>;\n  public readonly props: TemporaryStorageProps<T>;\n\n  /**\n   * Constructor. Creates the storage using supplied params.\n   */\n  constructor(props: TemporaryStorageProps<T>) {\n    this.props = props;\n    this._values = new Map<string, TemporaryValue<T>>();\n    if (this.props.cleanupInterval)\n      this._timer = setInterval(this.disposeOutdatedValues, this.props.cleanupInterval);\n  }\n\n  /**\n   * Destructor. Must be called to clean up the stored values\n   * and other resources\n   */\n  public dispose() {\n    if (this._timer)\n      clearInterval(this._timer);\n\n    if (this.props.cleanupHandler) {\n      this._values.forEach((v, id) => {\n        this.props.cleanupHandler!(id, v.value, \"dispose\");\n      });\n    }\n    this._values.clear();\n    this.props.onDisposedAll && this.props.onDisposedAll();\n  }\n\n  /**\n   * Cleans up values that are currently outdated (based\n   * on their max and unused value lifetimes specified through [[Props]]).\n   */\n  public disposeOutdatedValues = () => {\n    const now = (new Date()).getTime();\n    const valuesToDispose: string[] = [];\n    for (const [key, entry] of this._values.entries()) {\n      if (this.props.maxValueLifetime !== undefined) {\n        if (this.props.maxValueLifetime === 0 || (now - entry.created.getTime()) > this.props.maxValueLifetime) {\n          valuesToDispose.push(key);\n          continue;\n        }\n      }\n      if (this.props.unusedValueLifetime !== undefined) {\n        if (this.props.unusedValueLifetime === 0 || (now - entry.lastUsed.getTime()) > this.props.unusedValueLifetime) {\n          valuesToDispose.push(key);\n          continue;\n        }\n      }\n    }\n    for (const id of valuesToDispose)\n      this.deleteExistingEntry(id, true);\n  };\n\n  private deleteExistingEntry(id: string, isTimeout: boolean) {\n    assert(this._values.has(id));\n    this.props.cleanupHandler && this.props.cleanupHandler(id, this._values.get(id)!.value, isTimeout ? \"timeout\" : \"request\");\n    this._values.delete(id);\n    this.props.onDisposedSingle && this.props.onDisposedSingle(id);\n  }\n\n  /**\n   * Get a value from the storage.\n   *\n   * **Note:** requesting a value with this method updates it's last used time.\n   */\n  public getValue(id: string): T | undefined {\n    if (this._values.has(id)) {\n      const v = this._values.get(id)!;\n      v.lastUsed = new Date();\n      return v.value;\n    }\n    return undefined;\n  }\n\n  public notifyValueUsed(id: string) {\n    const entry = this._values.get(id);\n    // istanbul ignore else\n    if (entry)\n      entry.lastUsed = new Date();\n  }\n\n  /**\n   * Adds a value into the storage.\n   * @throws An error when trying to add a value with ID that's already stored in the storage.\n   */\n  public addValue(id: string, value: T) {\n    if (this._values.has(id))\n      throw new PresentationError(PresentationStatus.InvalidArgument, `A value with given ID \"${id}\" already exists in this storage.`);\n    this._values.set(id, { value, created: new Date(), lastUsed: new Date() });\n  }\n\n  /** Deletes a value with given id. */\n  public deleteValue(id: string) {\n    // istanbul ignore else\n    if (this._values.has(id))\n      this.deleteExistingEntry(id, false);\n  }\n\n  /**\n   * Get all values currently in this storage.\n   *\n   * **Note:** requesting values with this method **doesn't**\n   * update their last used times.\n   */\n  public get values(): T[] {\n    const values = new Array<T>();\n    for (const v of this._values.values())\n      values.push(v.value);\n    return values;\n  }\n\n}\n\n/**\n * Configuration properties for [[FactoryBasedTemporaryStorage]].\n * @internal\n */\nexport interface FactoryBasedTemporaryStorageProps<T> extends TemporaryStorageProps<T> {\n  /** A factory method that creates a stored value given it's identifier */\n  factory: (id: string, onValueUsed: () => void) => T;\n}\n\n/**\n * Storage for values that get removed from it after being unused (not-requested\n * for a specified amount of time).\n *\n * @internal\n */\nexport class FactoryBasedTemporaryStorage<T> extends TemporaryStorage<T> {\n\n  public override readonly props: FactoryBasedTemporaryStorageProps<T>;\n\n  /**\n   * Constructor. Creates the storage using supplied params.\n   */\n  constructor(props: FactoryBasedTemporaryStorageProps<T>) {\n    super(props);\n    this.props = props;\n  }\n\n  /**\n   * Get a value from the storage. If the value with the specified id\n   * doesn't exist, it gets created.\n   *\n   * **Note:** requesting a value with this method updates it's last used time.\n   */\n  public override getValue(id: string): T {\n    const existingValue = super.getValue(id);\n    if (existingValue)\n      return existingValue;\n\n    const value = this.props.factory(id, () => this.notifyValueUsed(id));\n    this.addValue(id, value);\n    return value;\n  }\n}\n"]}
+{"version":3,"file":"TemporaryStorage.js","sourceRoot":"","sources":["../../../src/presentation-backend/TemporaryStorage.ts"],"names":[],"mappings":"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","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 Core\r\n */\r\n\r\nimport { assert, IDisposable } from \"@itwin/core-bentley\";\r\nimport { PresentationError, PresentationStatus } from \"@itwin/presentation-common\";\r\n\r\n/**\r\n * Configuration properties for [[TemporaryStorage]].\r\n * @internal\r\n */\r\nexport interface TemporaryStorageProps<T> {\r\n  /** A method that's called for every value before it's removed from storage */\r\n  cleanupHandler?: (id: string, value: T, reason: \"timeout\" | \"dispose\" | \"request\") => void;\r\n\r\n  onDisposedSingle?: (id: string) => void;\r\n  onDisposedAll?: () => void;\r\n\r\n  /**\r\n   * An interval at which the storage attempts to clean up its values.\r\n   * When `0` or `undefined` is specified, values are not cleaned up\r\n   * automatically and cleanup has to be initiated manually by calling\r\n   * [[TemporaryStorage.disposeOutdatedValues]].\r\n   */\r\n  cleanupInterval?: number;\r\n\r\n  /**\r\n   * Shortest period of time which the value should be kept in storage\r\n   * unused before it's cleaned up.\r\n   *\r\n   * `undefined` means the values may be kept unused in the storage indefinitely.\r\n   * `0` means the values are removed from the storage on every cleanup (either manual\r\n   * call to [[TemporaryStorage.disposeOutdatedValues]] or scheduled (controlled\r\n   * by [[cleanupInterval]])).\r\n   */\r\n  unusedValueLifetime?: number;\r\n\r\n  /**\r\n   * The maximum period of time which the value should be kept in storage\r\n   * before it's cleaned up. The time is measured from the moment the value is added\r\n   * to the storage.\r\n   *\r\n   * `undefined` means the values may be kept indefinitely. `0` means they're removed\r\n   * up on every cleanup (either manual call to [[TemporaryStorage.disposeOutdatedValues]]\r\n   * or scheduled (controlled by [[cleanupInterval]])).\r\n   */\r\n  maxValueLifetime?: number;\r\n}\r\n\r\n/** Value with know last used time */\r\ninterface TemporaryValue<T> {\r\n  created: Date;\r\n  lastUsed: Date;\r\n  value: T;\r\n}\r\n\r\n/**\r\n * Storage for values that get removed from it after being unused (not-requested\r\n * for a specified amount of time).\r\n *\r\n * @internal\r\n */\r\nexport class TemporaryStorage<T> implements IDisposable {\r\n\r\n  private _timer?: NodeJS.Timer;\r\n  protected _values: Map<string, TemporaryValue<T>>;\r\n  public readonly props: TemporaryStorageProps<T>;\r\n\r\n  /**\r\n   * Constructor. Creates the storage using supplied params.\r\n   */\r\n  constructor(props: TemporaryStorageProps<T>) {\r\n    this.props = props;\r\n    this._values = new Map<string, TemporaryValue<T>>();\r\n    if (this.props.cleanupInterval)\r\n      this._timer = setInterval(this.disposeOutdatedValues, this.props.cleanupInterval);\r\n  }\r\n\r\n  /**\r\n   * Destructor. Must be called to clean up the stored values\r\n   * and other resources\r\n   */\r\n  public dispose() {\r\n    if (this._timer)\r\n      clearInterval(this._timer);\r\n\r\n    if (this.props.cleanupHandler) {\r\n      this._values.forEach((v, id) => {\r\n        this.props.cleanupHandler!(id, v.value, \"dispose\");\r\n      });\r\n    }\r\n    this._values.clear();\r\n    this.props.onDisposedAll && this.props.onDisposedAll();\r\n  }\r\n\r\n  /**\r\n   * Cleans up values that are currently outdated (based\r\n   * on their max and unused value lifetimes specified through [[Props]]).\r\n   */\r\n  public disposeOutdatedValues = () => {\r\n    const now = (new Date()).getTime();\r\n    const valuesToDispose: string[] = [];\r\n    for (const [key, entry] of this._values.entries()) {\r\n      if (this.props.maxValueLifetime !== undefined) {\r\n        if (this.props.maxValueLifetime === 0 || (now - entry.created.getTime()) > this.props.maxValueLifetime) {\r\n          valuesToDispose.push(key);\r\n          continue;\r\n        }\r\n      }\r\n      if (this.props.unusedValueLifetime !== undefined) {\r\n        if (this.props.unusedValueLifetime === 0 || (now - entry.lastUsed.getTime()) > this.props.unusedValueLifetime) {\r\n          valuesToDispose.push(key);\r\n          continue;\r\n        }\r\n      }\r\n    }\r\n    for (const id of valuesToDispose)\r\n      this.deleteExistingEntry(id, true);\r\n  };\r\n\r\n  private deleteExistingEntry(id: string, isTimeout: boolean) {\r\n    assert(this._values.has(id));\r\n    this.props.cleanupHandler && this.props.cleanupHandler(id, this._values.get(id)!.value, isTimeout ? \"timeout\" : \"request\");\r\n    this._values.delete(id);\r\n    this.props.onDisposedSingle && this.props.onDisposedSingle(id);\r\n  }\r\n\r\n  /**\r\n   * Get a value from the storage.\r\n   *\r\n   * **Note:** requesting a value with this method updates it's last used time.\r\n   */\r\n  public getValue(id: string): T | undefined {\r\n    if (this._values.has(id)) {\r\n      const v = this._values.get(id)!;\r\n      v.lastUsed = new Date();\r\n      return v.value;\r\n    }\r\n    return undefined;\r\n  }\r\n\r\n  public notifyValueUsed(id: string) {\r\n    const entry = this._values.get(id);\r\n    // istanbul ignore else\r\n    if (entry)\r\n      entry.lastUsed = new Date();\r\n  }\r\n\r\n  /**\r\n   * Adds a value into the storage.\r\n   * @throws An error when trying to add a value with ID that's already stored in the storage.\r\n   */\r\n  public addValue(id: string, value: T) {\r\n    if (this._values.has(id))\r\n      throw new PresentationError(PresentationStatus.InvalidArgument, `A value with given ID \"${id}\" already exists in this storage.`);\r\n    this._values.set(id, { value, created: new Date(), lastUsed: new Date() });\r\n  }\r\n\r\n  /** Deletes a value with given id. */\r\n  public deleteValue(id: string) {\r\n    // istanbul ignore else\r\n    if (this._values.has(id))\r\n      this.deleteExistingEntry(id, false);\r\n  }\r\n\r\n  /**\r\n   * Get all values currently in this storage.\r\n   *\r\n   * **Note:** requesting values with this method **doesn't**\r\n   * update their last used times.\r\n   */\r\n  public get values(): T[] {\r\n    const values = new Array<T>();\r\n    for (const v of this._values.values())\r\n      values.push(v.value);\r\n    return values;\r\n  }\r\n\r\n}\r\n\r\n/**\r\n * Configuration properties for [[FactoryBasedTemporaryStorage]].\r\n * @internal\r\n */\r\nexport interface FactoryBasedTemporaryStorageProps<T> extends TemporaryStorageProps<T> {\r\n  /** A factory method that creates a stored value given it's identifier */\r\n  factory: (id: string, onValueUsed: () => void) => T;\r\n}\r\n\r\n/**\r\n * Storage for values that get removed from it after being unused (not-requested\r\n * for a specified amount of time).\r\n *\r\n * @internal\r\n */\r\nexport class FactoryBasedTemporaryStorage<T> extends TemporaryStorage<T> {\r\n\r\n  public override readonly props: FactoryBasedTemporaryStorageProps<T>;\r\n\r\n  /**\r\n   * Constructor. Creates the storage using supplied params.\r\n   */\r\n  constructor(props: FactoryBasedTemporaryStorageProps<T>) {\r\n    super(props);\r\n    this.props = props;\r\n  }\r\n\r\n  /**\r\n   * Get a value from the storage. If the value with the specified id\r\n   * doesn't exist, it gets created.\r\n   *\r\n   * **Note:** requesting a value with this method updates it's last used time.\r\n   */\r\n  public override getValue(id: string): T {\r\n    const existingValue = super.getValue(id);\r\n    if (existingValue)\r\n      return existingValue;\r\n\r\n    const value = this.props.factory(id, () => this.notifyValueUsed(id));\r\n    this.addValue(id, value);\r\n    return value;\r\n  }\r\n}\r\n"]}