@metamask-previews/phishing-controller 13.1.0-preview-5a701133 → 14.0.0-preview-c20b7569

package/CHANGELOG.md

@@ -7,8 +7,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [14.0.0]
+
 ### Added
 
+- Add bulk token scanning functionality to detect malicious tokens ([#6483](https://github.com/MetaMask/core/pull/6483))
+  - Add `bulkScanTokens` method to scan multiple tokens for malicious activity
+  - Add `BulkTokenScanRequest` and `BulkTokenScanResponse` types
+  - Add `tokenScanCache` to `PhishingControllerState`
+  - Add proper action registration for `bulkScanTokens` method as `PhishingControllerBulkScanTokensAction`
+  - Support for multiple chains including Ethereum, Polygon, BSC, Arbitrum, Avalanche, Base, Optimism, ect...
+- Add token screening from transaction simulation data ([#6617](https://github.com/MetaMask/core/pull/6617))
+  - Add `#onTransactionControllerStateChange` method to handle transaction state changes
+  - Add `#scanTokensFromSimulation` method to extract and scan tokens from transaction simulation data
+  - Add `start` and `stop` methods to manage Transaction Controller state change subscription
 - Add two new controller state metadata properties: `includeInStateLogs` and `usedInUi` ([#6587](https://github.com/MetaMask/core/pull/6587))
 
 ### Changed
@@ -404,7 +416,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
     All changes listed after this point were applied to this package following the monorepo conversion.
 
-[Unreleased]: https://github.com/MetaMask/core/compare/@metamask/phishing-controller@13.1.0...HEAD
+[Unreleased]: https://github.com/MetaMask/core/compare/@metamask/phishing-controller@14.0.0...HEAD
+[14.0.0]: https://github.com/MetaMask/core/compare/@metamask/phishing-controller@13.1.0...@metamask/phishing-controller@14.0.0
 [13.1.0]: https://github.com/MetaMask/core/compare/@metamask/phishing-controller@13.0.0...@metamask/phishing-controller@13.1.0
 [13.0.0]: https://github.com/MetaMask/core/compare/@metamask/phishing-controller@12.6.0...@metamask/phishing-controller@13.0.0
 [12.6.0]: https://github.com/MetaMask/core/compare/@metamask/phishing-controller@12.5.0...@metamask/phishing-controller@12.6.0

package/dist/CacheManager.cjs

@@ -0,0 +1,177 @@
+"use strict";
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _CacheManager_instances, _CacheManager_cacheTTL, _CacheManager_maxCacheSize, _CacheManager_cache, _CacheManager_updateState, _CacheManager_persistCache, _CacheManager_evictEntries;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CacheManager = void 0;
+const utils_1 = require("./utils.cjs");
+/**
+ * Generic cache manager with TTL and size limit support
+ *
+ * @template T - The type of data to cache
+ */
+class CacheManager {
+    /**
+     * Constructor for CacheManager
+     *
+     * @param options - Cache configuration options
+     * @param options.cacheTTL - Time to live in seconds for cached entries
+     * @param options.maxCacheSize - Maximum number of entries in the cache
+     * @param options.initialCache - Initial cache state
+     * @param options.updateState - Function to update the state when cache changes
+     */
+    constructor({ cacheTTL = 300, // 5 minutes default
+    maxCacheSize = 100, initialCache = {}, updateState, }) {
+        _CacheManager_instances.add(this);
+        _CacheManager_cacheTTL.set(this, void 0);
+        _CacheManager_maxCacheSize.set(this, void 0);
+        _CacheManager_cache.set(this, void 0);
+        _CacheManager_updateState.set(this, void 0);
+        __classPrivateFieldSet(this, _CacheManager_cacheTTL, cacheTTL, "f");
+        __classPrivateFieldSet(this, _CacheManager_maxCacheSize, maxCacheSize, "f");
+        __classPrivateFieldSet(this, _CacheManager_cache, new Map(Object.entries(initialCache)), "f");
+        __classPrivateFieldSet(this, _CacheManager_updateState, updateState, "f");
+        __classPrivateFieldGet(this, _CacheManager_instances, "m", _CacheManager_evictEntries).call(this);
+    }
+    /**
+     * Set the time-to-live for cached entries
+     *
+     * @param ttl - The TTL in seconds
+     */
+    setTTL(ttl) {
+        __classPrivateFieldSet(this, _CacheManager_cacheTTL, ttl, "f");
+    }
+    /**
+     * Get the current TTL setting
+     *
+     * @returns The TTL in seconds
+     */
+    getTTL() {
+        return __classPrivateFieldGet(this, _CacheManager_cacheTTL, "f");
+    }
+    /**
+     * Set the maximum cache size
+     *
+     * @param maxSize - The maximum cache size
+     */
+    setMaxSize(maxSize) {
+        __classPrivateFieldSet(this, _CacheManager_maxCacheSize, maxSize, "f");
+        __classPrivateFieldGet(this, _CacheManager_instances, "m", _CacheManager_evictEntries).call(this);
+    }
+    /**
+     * Get the current maximum cache size
+     *
+     * @returns The maximum cache size
+     */
+    getMaxSize() {
+        return __classPrivateFieldGet(this, _CacheManager_maxCacheSize, "f");
+    }
+    /**
+     * Get the current cache size
+     *
+     * @returns The current number of entries in the cache
+     */
+    getSize() {
+        return __classPrivateFieldGet(this, _CacheManager_cache, "f").size;
+    }
+    /**
+     * Clear the cache
+     */
+    clear() {
+        __classPrivateFieldGet(this, _CacheManager_cache, "f").clear();
+        __classPrivateFieldGet(this, _CacheManager_instances, "m", _CacheManager_persistCache).call(this);
+    }
+    /**
+     * Get a cached result if it exists and is not expired
+     *
+     * @param key - The cache key
+     * @returns The cached data or undefined if not found or expired
+     */
+    get(key) {
+        const cacheEntry = __classPrivateFieldGet(this, _CacheManager_cache, "f").get(key);
+        if (!cacheEntry) {
+            return undefined;
+        }
+        // Check if the entry is expired
+        const now = (0, utils_1.fetchTimeNow)();
+        if (now - cacheEntry.timestamp > __classPrivateFieldGet(this, _CacheManager_cacheTTL, "f")) {
+            // Entry expired, remove it from cache
+            __classPrivateFieldGet(this, _CacheManager_cache, "f").delete(key);
+            __classPrivateFieldGet(this, _CacheManager_instances, "m", _CacheManager_persistCache).call(this);
+            return undefined;
+        }
+        return cacheEntry.data;
+    }
+    /**
+     * Add an entry to the cache, evicting oldest entries if necessary
+     *
+     * @param key - The cache key
+     * @param data - The data to cache
+     */
+    set(key, data) {
+        __classPrivateFieldGet(this, _CacheManager_cache, "f").set(key, {
+            data,
+            timestamp: (0, utils_1.fetchTimeNow)(),
+        });
+        __classPrivateFieldGet(this, _CacheManager_instances, "m", _CacheManager_evictEntries).call(this);
+        __classPrivateFieldGet(this, _CacheManager_instances, "m", _CacheManager_persistCache).call(this);
+    }
+    /**
+     * Delete a specific entry from the cache
+     *
+     * @param key - The cache key
+     * @returns True if an entry was deleted
+     */
+    delete(key) {
+        const result = __classPrivateFieldGet(this, _CacheManager_cache, "f").delete(key);
+        if (result) {
+            __classPrivateFieldGet(this, _CacheManager_instances, "m", _CacheManager_persistCache).call(this);
+        }
+        return result;
+    }
+    /**
+     * Get all keys in the cache
+     *
+     * @returns Array of cache keys
+     */
+    keys() {
+        return Array.from(__classPrivateFieldGet(this, _CacheManager_cache, "f").keys());
+    }
+    /**
+     * Get all entries in the cache (including expired ones)
+     * Useful for debugging or persistence
+     *
+     * @returns Record of all cache entries
+     */
+    getAllEntries() {
+        return Object.fromEntries(__classPrivateFieldGet(this, _CacheManager_cache, "f"));
+    }
+}
+exports.CacheManager = CacheManager;
+_CacheManager_cacheTTL = new WeakMap(), _CacheManager_maxCacheSize = new WeakMap(), _CacheManager_cache = new WeakMap(), _CacheManager_updateState = new WeakMap(), _CacheManager_instances = new WeakSet(), _CacheManager_persistCache = function _CacheManager_persistCache() {
+    __classPrivateFieldGet(this, _CacheManager_updateState, "f").call(this, Object.fromEntries(__classPrivateFieldGet(this, _CacheManager_cache, "f")));
+}, _CacheManager_evictEntries = function _CacheManager_evictEntries() {
+    if (__classPrivateFieldGet(this, _CacheManager_cache, "f").size <= __classPrivateFieldGet(this, _CacheManager_maxCacheSize, "f")) {
+        return;
+    }
+    const entriesToRemove = __classPrivateFieldGet(this, _CacheManager_cache, "f").size - __classPrivateFieldGet(this, _CacheManager_maxCacheSize, "f");
+    let count = 0;
+    // Delete the oldest entries (Map maintains insertion order)
+    for (const key of __classPrivateFieldGet(this, _CacheManager_cache, "f").keys()) {
+        if (count >= entriesToRemove) {
+            break;
+        }
+        __classPrivateFieldGet(this, _CacheManager_cache, "f").delete(key);
+        count += 1;
+    }
+};
+//# sourceMappingURL=CacheManager.cjs.map

package/dist/CacheManager.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"CacheManager.cjs","sourceRoot":"","sources":["../src/CacheManager.ts"],"names":[],"mappings":"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","sourcesContent":["import { fetchTimeNow } from './utils';\n\n/**\n * Generic cache entry type that wraps the data with a timestamp\n */\nexport type CacheEntry<T> = {\n  data: T;\n  timestamp: number;\n};\n\n/**\n * Configuration options for CacheManager\n */\nexport type CacheManagerOptions<T> = {\n  cacheTTL?: number;\n  maxCacheSize?: number;\n  initialCache?: Record<string, CacheEntry<T>>;\n  updateState: (cache: Record<string, CacheEntry<T>>) => void;\n};\n\n/**\n * Generic cache manager with TTL and size limit support\n *\n * @template T - The type of data to cache\n */\nexport class CacheManager<T> {\n  #cacheTTL: number;\n\n  #maxCacheSize: number;\n\n  readonly #cache: Map<string, CacheEntry<T>>;\n\n  readonly #updateState: (cache: Record<string, CacheEntry<T>>) => void;\n\n  /**\n   * Constructor for CacheManager\n   *\n   * @param options - Cache configuration options\n   * @param options.cacheTTL - Time to live in seconds for cached entries\n   * @param options.maxCacheSize - Maximum number of entries in the cache\n   * @param options.initialCache - Initial cache state\n   * @param options.updateState - Function to update the state when cache changes\n   */\n  constructor({\n    cacheTTL = 300, // 5 minutes default\n    maxCacheSize = 100,\n    initialCache = {},\n    updateState,\n  }: CacheManagerOptions<T>) {\n    this.#cacheTTL = cacheTTL;\n    this.#maxCacheSize = maxCacheSize;\n    this.#cache = new Map(Object.entries(initialCache));\n    this.#updateState = updateState;\n    this.#evictEntries();\n  }\n\n  /**\n   * Set the time-to-live for cached entries\n   *\n   * @param ttl - The TTL in seconds\n   */\n  setTTL(ttl: number): void {\n    this.#cacheTTL = ttl;\n  }\n\n  /**\n   * Get the current TTL setting\n   *\n   * @returns The TTL in seconds\n   */\n  getTTL(): number {\n    return this.#cacheTTL;\n  }\n\n  /**\n   * Set the maximum cache size\n   *\n   * @param maxSize - The maximum cache size\n   */\n  setMaxSize(maxSize: number): void {\n    this.#maxCacheSize = maxSize;\n    this.#evictEntries();\n  }\n\n  /**\n   * Get the current maximum cache size\n   *\n   * @returns The maximum cache size\n   */\n  getMaxSize(): number {\n    return this.#maxCacheSize;\n  }\n\n  /**\n   * Get the current cache size\n   *\n   * @returns The current number of entries in the cache\n   */\n  getSize(): number {\n    return this.#cache.size;\n  }\n\n  /**\n   * Clear the cache\n   */\n  clear(): void {\n    this.#cache.clear();\n    this.#persistCache();\n  }\n\n  /**\n   * Get a cached result if it exists and is not expired\n   *\n   * @param key - The cache key\n   * @returns The cached data or undefined if not found or expired\n   */\n  get(key: string): T | undefined {\n    const cacheEntry = this.#cache.get(key);\n    if (!cacheEntry) {\n      return undefined;\n    }\n\n    // Check if the entry is expired\n    const now = fetchTimeNow();\n    if (now - cacheEntry.timestamp > this.#cacheTTL) {\n      // Entry expired, remove it from cache\n      this.#cache.delete(key);\n      this.#persistCache();\n      return undefined;\n    }\n\n    return cacheEntry.data;\n  }\n\n  /**\n   * Add an entry to the cache, evicting oldest entries if necessary\n   *\n   * @param key - The cache key\n   * @param data - The data to cache\n   */\n  set(key: string, data: T): void {\n    this.#cache.set(key, {\n      data,\n      timestamp: fetchTimeNow(),\n    });\n\n    this.#evictEntries();\n    this.#persistCache();\n  }\n\n  /**\n   * Delete a specific entry from the cache\n   *\n   * @param key - The cache key\n   * @returns True if an entry was deleted\n   */\n  delete(key: string): boolean {\n    const result = this.#cache.delete(key);\n    if (result) {\n      this.#persistCache();\n    }\n    return result;\n  }\n\n  /**\n   * Get all keys in the cache\n   *\n   * @returns Array of cache keys\n   */\n  keys(): string[] {\n    return Array.from(this.#cache.keys());\n  }\n\n  /**\n   * Get all entries in the cache (including expired ones)\n   * Useful for debugging or persistence\n   *\n   * @returns Record of all cache entries\n   */\n  getAllEntries(): Record<string, CacheEntry<T>> {\n    return Object.fromEntries(this.#cache);\n  }\n\n  /**\n   * Persist the current cache state\n   */\n  #persistCache(): void {\n    this.#updateState(Object.fromEntries(this.#cache));\n  }\n\n  /**\n   * Evict oldest entries if cache exceeds max size\n   */\n  #evictEntries(): void {\n    if (this.#cache.size <= this.#maxCacheSize) {\n      return;\n    }\n\n    const entriesToRemove = this.#cache.size - this.#maxCacheSize;\n    let count = 0;\n    // Delete the oldest entries (Map maintains insertion order)\n    for (const key of this.#cache.keys()) {\n      if (count >= entriesToRemove) {\n        break;\n      }\n      this.#cache.delete(key);\n      count += 1;\n    }\n  }\n}\n"]}

package/dist/CacheManager.d.cts

@@ -0,0 +1,104 @@
+/**
+ * Generic cache entry type that wraps the data with a timestamp
+ */
+export type CacheEntry<T> = {
+    data: T;
+    timestamp: number;
+};
+/**
+ * Configuration options for CacheManager
+ */
+export type CacheManagerOptions<T> = {
+    cacheTTL?: number;
+    maxCacheSize?: number;
+    initialCache?: Record<string, CacheEntry<T>>;
+    updateState: (cache: Record<string, CacheEntry<T>>) => void;
+};
+/**
+ * Generic cache manager with TTL and size limit support
+ *
+ * @template T - The type of data to cache
+ */
+export declare class CacheManager<T> {
+    #private;
+    /**
+     * Constructor for CacheManager
+     *
+     * @param options - Cache configuration options
+     * @param options.cacheTTL - Time to live in seconds for cached entries
+     * @param options.maxCacheSize - Maximum number of entries in the cache
+     * @param options.initialCache - Initial cache state
+     * @param options.updateState - Function to update the state when cache changes
+     */
+    constructor({ cacheTTL, // 5 minutes default
+    maxCacheSize, initialCache, updateState, }: CacheManagerOptions<T>);
+    /**
+     * Set the time-to-live for cached entries
+     *
+     * @param ttl - The TTL in seconds
+     */
+    setTTL(ttl: number): void;
+    /**
+     * Get the current TTL setting
+     *
+     * @returns The TTL in seconds
+     */
+    getTTL(): number;
+    /**
+     * Set the maximum cache size
+     *
+     * @param maxSize - The maximum cache size
+     */
+    setMaxSize(maxSize: number): void;
+    /**
+     * Get the current maximum cache size
+     *
+     * @returns The maximum cache size
+     */
+    getMaxSize(): number;
+    /**
+     * Get the current cache size
+     *
+     * @returns The current number of entries in the cache
+     */
+    getSize(): number;
+    /**
+     * Clear the cache
+     */
+    clear(): void;
+    /**
+     * Get a cached result if it exists and is not expired
+     *
+     * @param key - The cache key
+     * @returns The cached data or undefined if not found or expired
+     */
+    get(key: string): T | undefined;
+    /**
+     * Add an entry to the cache, evicting oldest entries if necessary
+     *
+     * @param key - The cache key
+     * @param data - The data to cache
+     */
+    set(key: string, data: T): void;
+    /**
+     * Delete a specific entry from the cache
+     *
+     * @param key - The cache key
+     * @returns True if an entry was deleted
+     */
+    delete(key: string): boolean;
+    /**
+     * Get all keys in the cache
+     *
+     * @returns Array of cache keys
+     */
+    keys(): string[];
+    /**
+     * Get all entries in the cache (including expired ones)
+     * Useful for debugging or persistence
+     *
+     * @returns Record of all cache entries
+     */
+    getAllEntries(): Record<string, CacheEntry<T>>;
+}
+//# sourceMappingURL=CacheManager.d.cts.map

package/dist/CacheManager.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CacheManager.d.cts","sourceRoot":"","sources":["../src/CacheManager.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI;IAC1B,IAAI,EAAE,CAAC,CAAC;IACR,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAAI;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7C,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;CAC7D,CAAC;AAEF;;;;GAIG;AACH,qBAAa,YAAY,CAAC,CAAC;;IASzB;;;;;;;;OAQG;gBACS,EACV,QAAc,EAAE,oBAAoB;IACpC,YAAkB,EAClB,YAAiB,EACjB,WAAW,GACZ,EAAE,mBAAmB,CAAC,CAAC,CAAC;IAQzB;;;;OAIG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIzB;;;;OAIG;IACH,MAAM,IAAI,MAAM;IAIhB;;;;OAIG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAKjC;;;;OAIG;IACH,UAAU,IAAI,MAAM;IAIpB;;;;OAIG;IACH,OAAO,IAAI,MAAM;IAIjB;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAkB/B;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI;IAU/B;;;;;OAKG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAQ5B;;;;OAIG;IACH,IAAI,IAAI,MAAM,EAAE;IAIhB;;;;;OAKG;IACH,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;CA8B/C"}

package/dist/CacheManager.d.mts

@@ -0,0 +1,104 @@
+/**
+ * Generic cache entry type that wraps the data with a timestamp
+ */
+export type CacheEntry<T> = {
+    data: T;
+    timestamp: number;
+};
+/**
+ * Configuration options for CacheManager
+ */
+export type CacheManagerOptions<T> = {
+    cacheTTL?: number;
+    maxCacheSize?: number;
+    initialCache?: Record<string, CacheEntry<T>>;
+    updateState: (cache: Record<string, CacheEntry<T>>) => void;
+};
+/**
+ * Generic cache manager with TTL and size limit support
+ *
+ * @template T - The type of data to cache
+ */
+export declare class CacheManager<T> {
+    #private;
+    /**
+     * Constructor for CacheManager
+     *
+     * @param options - Cache configuration options
+     * @param options.cacheTTL - Time to live in seconds for cached entries
+     * @param options.maxCacheSize - Maximum number of entries in the cache
+     * @param options.initialCache - Initial cache state
+     * @param options.updateState - Function to update the state when cache changes
+     */
+    constructor({ cacheTTL, // 5 minutes default
+    maxCacheSize, initialCache, updateState, }: CacheManagerOptions<T>);
+    /**
+     * Set the time-to-live for cached entries
+     *
+     * @param ttl - The TTL in seconds
+     */
+    setTTL(ttl: number): void;
+    /**
+     * Get the current TTL setting
+     *
+     * @returns The TTL in seconds
+     */
+    getTTL(): number;
+    /**
+     * Set the maximum cache size
+     *
+     * @param maxSize - The maximum cache size
+     */
+    setMaxSize(maxSize: number): void;
+    /**
+     * Get the current maximum cache size
+     *
+     * @returns The maximum cache size
+     */
+    getMaxSize(): number;
+    /**
+     * Get the current cache size
+     *
+     * @returns The current number of entries in the cache
+     */
+    getSize(): number;
+    /**
+     * Clear the cache
+     */
+    clear(): void;
+    /**
+     * Get a cached result if it exists and is not expired
+     *
+     * @param key - The cache key
+     * @returns The cached data or undefined if not found or expired
+     */
+    get(key: string): T | undefined;
+    /**
+     * Add an entry to the cache, evicting oldest entries if necessary
+     *
+     * @param key - The cache key
+     * @param data - The data to cache
+     */
+    set(key: string, data: T): void;
+    /**
+     * Delete a specific entry from the cache
+     *
+     * @param key - The cache key
+     * @returns True if an entry was deleted
+     */
+    delete(key: string): boolean;
+    /**
+     * Get all keys in the cache
+     *
+     * @returns Array of cache keys
+     */
+    keys(): string[];
+    /**
+     * Get all entries in the cache (including expired ones)
+     * Useful for debugging or persistence
+     *
+     * @returns Record of all cache entries
+     */
+    getAllEntries(): Record<string, CacheEntry<T>>;
+}
+//# sourceMappingURL=CacheManager.d.mts.map

package/dist/CacheManager.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CacheManager.d.mts","sourceRoot":"","sources":["../src/CacheManager.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI;IAC1B,IAAI,EAAE,CAAC,CAAC;IACR,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAAI;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7C,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;CAC7D,CAAC;AAEF;;;;GAIG;AACH,qBAAa,YAAY,CAAC,CAAC;;IASzB;;;;;;;;OAQG;gBACS,EACV,QAAc,EAAE,oBAAoB;IACpC,YAAkB,EAClB,YAAiB,EACjB,WAAW,GACZ,EAAE,mBAAmB,CAAC,CAAC,CAAC;IAQzB;;;;OAIG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIzB;;;;OAIG;IACH,MAAM,IAAI,MAAM;IAIhB;;;;OAIG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAKjC;;;;OAIG;IACH,UAAU,IAAI,MAAM;IAIpB;;;;OAIG;IACH,OAAO,IAAI,MAAM;IAIjB;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAkB/B;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI;IAU/B;;;;;OAKG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAQ5B;;;;OAIG;IACH,IAAI,IAAI,MAAM,EAAE;IAIhB;;;;;OAKG;IACH,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;CA8B/C"}

package/dist/CacheManager.mjs

@@ -0,0 +1,173 @@
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _CacheManager_instances, _CacheManager_cacheTTL, _CacheManager_maxCacheSize, _CacheManager_cache, _CacheManager_updateState, _CacheManager_persistCache, _CacheManager_evictEntries;
+import { fetchTimeNow } from "./utils.mjs";
+/**
+ * Generic cache manager with TTL and size limit support
+ *
+ * @template T - The type of data to cache
+ */
+export class CacheManager {
+    /**
+     * Constructor for CacheManager
+     *
+     * @param options - Cache configuration options
+     * @param options.cacheTTL - Time to live in seconds for cached entries
+     * @param options.maxCacheSize - Maximum number of entries in the cache
+     * @param options.initialCache - Initial cache state
+     * @param options.updateState - Function to update the state when cache changes
+     */
+    constructor({ cacheTTL = 300, // 5 minutes default
+    maxCacheSize = 100, initialCache = {}, updateState, }) {
+        _CacheManager_instances.add(this);
+        _CacheManager_cacheTTL.set(this, void 0);
+        _CacheManager_maxCacheSize.set(this, void 0);
+        _CacheManager_cache.set(this, void 0);
+        _CacheManager_updateState.set(this, void 0);
+        __classPrivateFieldSet(this, _CacheManager_cacheTTL, cacheTTL, "f");
+        __classPrivateFieldSet(this, _CacheManager_maxCacheSize, maxCacheSize, "f");
+        __classPrivateFieldSet(this, _CacheManager_cache, new Map(Object.entries(initialCache)), "f");
+        __classPrivateFieldSet(this, _CacheManager_updateState, updateState, "f");
+        __classPrivateFieldGet(this, _CacheManager_instances, "m", _CacheManager_evictEntries).call(this);
+    }
+    /**
+     * Set the time-to-live for cached entries
+     *
+     * @param ttl - The TTL in seconds
+     */
+    setTTL(ttl) {
+        __classPrivateFieldSet(this, _CacheManager_cacheTTL, ttl, "f");
+    }
+    /**
+     * Get the current TTL setting
+     *
+     * @returns The TTL in seconds
+     */
+    getTTL() {
+        return __classPrivateFieldGet(this, _CacheManager_cacheTTL, "f");
+    }
+    /**
+     * Set the maximum cache size
+     *
+     * @param maxSize - The maximum cache size
+     */
+    setMaxSize(maxSize) {
+        __classPrivateFieldSet(this, _CacheManager_maxCacheSize, maxSize, "f");
+        __classPrivateFieldGet(this, _CacheManager_instances, "m", _CacheManager_evictEntries).call(this);
+    }
+    /**
+     * Get the current maximum cache size
+     *
+     * @returns The maximum cache size
+     */
+    getMaxSize() {
+        return __classPrivateFieldGet(this, _CacheManager_maxCacheSize, "f");
+    }
+    /**
+     * Get the current cache size
+     *
+     * @returns The current number of entries in the cache
+     */
+    getSize() {
+        return __classPrivateFieldGet(this, _CacheManager_cache, "f").size;
+    }
+    /**
+     * Clear the cache
+     */
+    clear() {
+        __classPrivateFieldGet(this, _CacheManager_cache, "f").clear();
+        __classPrivateFieldGet(this, _CacheManager_instances, "m", _CacheManager_persistCache).call(this);
+    }
+    /**
+     * Get a cached result if it exists and is not expired
+     *
+     * @param key - The cache key
+     * @returns The cached data or undefined if not found or expired
+     */
+    get(key) {
+        const cacheEntry = __classPrivateFieldGet(this, _CacheManager_cache, "f").get(key);
+        if (!cacheEntry) {
+            return undefined;
+        }
+        // Check if the entry is expired
+        const now = fetchTimeNow();
+        if (now - cacheEntry.timestamp > __classPrivateFieldGet(this, _CacheManager_cacheTTL, "f")) {
+            // Entry expired, remove it from cache
+            __classPrivateFieldGet(this, _CacheManager_cache, "f").delete(key);
+            __classPrivateFieldGet(this, _CacheManager_instances, "m", _CacheManager_persistCache).call(this);
+            return undefined;
+        }
+        return cacheEntry.data;
+    }
+    /**
+     * Add an entry to the cache, evicting oldest entries if necessary
+     *
+     * @param key - The cache key
+     * @param data - The data to cache
+     */
+    set(key, data) {
+        __classPrivateFieldGet(this, _CacheManager_cache, "f").set(key, {
+            data,
+            timestamp: fetchTimeNow(),
+        });
+        __classPrivateFieldGet(this, _CacheManager_instances, "m", _CacheManager_evictEntries).call(this);
+        __classPrivateFieldGet(this, _CacheManager_instances, "m", _CacheManager_persistCache).call(this);
+    }
+    /**
+     * Delete a specific entry from the cache
+     *
+     * @param key - The cache key
+     * @returns True if an entry was deleted
+     */
+    delete(key) {
+        const result = __classPrivateFieldGet(this, _CacheManager_cache, "f").delete(key);
+        if (result) {
+            __classPrivateFieldGet(this, _CacheManager_instances, "m", _CacheManager_persistCache).call(this);
+        }
+        return result;
+    }
+    /**
+     * Get all keys in the cache
+     *
+     * @returns Array of cache keys
+     */
+    keys() {
+        return Array.from(__classPrivateFieldGet(this, _CacheManager_cache, "f").keys());
+    }
+    /**
+     * Get all entries in the cache (including expired ones)
+     * Useful for debugging or persistence
+     *
+     * @returns Record of all cache entries
+     */
+    getAllEntries() {
+        return Object.fromEntries(__classPrivateFieldGet(this, _CacheManager_cache, "f"));
+    }
+}
+_CacheManager_cacheTTL = new WeakMap(), _CacheManager_maxCacheSize = new WeakMap(), _CacheManager_cache = new WeakMap(), _CacheManager_updateState = new WeakMap(), _CacheManager_instances = new WeakSet(), _CacheManager_persistCache = function _CacheManager_persistCache() {
+    __classPrivateFieldGet(this, _CacheManager_updateState, "f").call(this, Object.fromEntries(__classPrivateFieldGet(this, _CacheManager_cache, "f")));
+}, _CacheManager_evictEntries = function _CacheManager_evictEntries() {
+    if (__classPrivateFieldGet(this, _CacheManager_cache, "f").size <= __classPrivateFieldGet(this, _CacheManager_maxCacheSize, "f")) {
+        return;
+    }
+    const entriesToRemove = __classPrivateFieldGet(this, _CacheManager_cache, "f").size - __classPrivateFieldGet(this, _CacheManager_maxCacheSize, "f");
+    let count = 0;
+    // Delete the oldest entries (Map maintains insertion order)
+    for (const key of __classPrivateFieldGet(this, _CacheManager_cache, "f").keys()) {
+        if (count >= entriesToRemove) {
+            break;
+        }
+        __classPrivateFieldGet(this, _CacheManager_cache, "f").delete(key);
+        count += 1;
+    }
+};
+//# sourceMappingURL=CacheManager.mjs.map

package/dist/CacheManager.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"CacheManager.mjs","sourceRoot":"","sources":["../src/CacheManager.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,OAAO,EAAE,YAAY,EAAE,oBAAgB;AAoBvC;;;;GAIG;AACH,MAAM,OAAO,YAAY;IASvB;;;;;;;;OAQG;IACH,YAAY,EACV,QAAQ,GAAG,GAAG,EAAE,oBAAoB;IACpC,YAAY,GAAG,GAAG,EAClB,YAAY,GAAG,EAAE,EACjB,WAAW,GACY;;QAtBzB,yCAAkB;QAElB,6CAAsB;QAEb,sCAAmC;QAEnC,4CAA6D;QAiBpE,uBAAA,IAAI,0BAAa,QAAQ,MAAA,CAAC;QAC1B,uBAAA,IAAI,8BAAiB,YAAY,MAAA,CAAC;QAClC,uBAAA,IAAI,uBAAU,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,MAAA,CAAC;QACpD,uBAAA,IAAI,6BAAgB,WAAW,MAAA,CAAC;QAChC,uBAAA,IAAI,2DAAc,MAAlB,IAAI,CAAgB,CAAC;IACvB,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,GAAW;QAChB,uBAAA,IAAI,0BAAa,GAAG,MAAA,CAAC;IACvB,CAAC;IAED;;;;OAIG;IACH,MAAM;QACJ,OAAO,uBAAA,IAAI,8BAAU,CAAC;IACxB,CAAC;IAED;;;;OAIG;IACH,UAAU,CAAC,OAAe;QACxB,uBAAA,IAAI,8BAAiB,OAAO,MAAA,CAAC;QAC7B,uBAAA,IAAI,2DAAc,MAAlB,IAAI,CAAgB,CAAC;IACvB,CAAC;IAED;;;;OAIG;IACH,UAAU;QACR,OAAO,uBAAA,IAAI,kCAAc,CAAC;IAC5B,CAAC;IAED;;;;OAIG;IACH,OAAO;QACL,OAAO,uBAAA,IAAI,2BAAO,CAAC,IAAI,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,KAAK;QACH,uBAAA,IAAI,2BAAO,CAAC,KAAK,EAAE,CAAC;QACpB,uBAAA,IAAI,2DAAc,MAAlB,IAAI,CAAgB,CAAC;IACvB,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,GAAW;QACb,MAAM,UAAU,GAAG,uBAAA,IAAI,2BAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACxC,IAAI,CAAC,UAAU,EAAE;YACf,OAAO,SAAS,CAAC;SAClB;QAED,gCAAgC;QAChC,MAAM,GAAG,GAAG,YAAY,EAAE,CAAC;QAC3B,IAAI,GAAG,GAAG,UAAU,CAAC,SAAS,GAAG,uBAAA,IAAI,8BAAU,EAAE;YAC/C,sCAAsC;YACtC,uBAAA,IAAI,2BAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACxB,uBAAA,IAAI,2DAAc,MAAlB,IAAI,CAAgB,CAAC;YACrB,OAAO,SAAS,CAAC;SAClB;QAED,OAAO,UAAU,CAAC,IAAI,CAAC;IACzB,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,GAAW,EAAE,IAAO;QACtB,uBAAA,IAAI,2BAAO,CAAC,GAAG,CAAC,GAAG,EAAE;YACnB,IAAI;YACJ,SAAS,EAAE,YAAY,EAAE;SAC1B,CAAC,CAAC;QAEH,uBAAA,IAAI,2DAAc,MAAlB,IAAI,CAAgB,CAAC;QACrB,uBAAA,IAAI,2DAAc,MAAlB,IAAI,CAAgB,CAAC;IACvB,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,GAAW;QAChB,MAAM,MAAM,GAAG,uBAAA,IAAI,2BAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACvC,IAAI,MAAM,EAAE;YACV,uBAAA,IAAI,2DAAc,MAAlB,IAAI,CAAgB,CAAC;SACtB;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;OAIG;IACH,IAAI;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,uBAAA,IAAI,2BAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IACxC,CAAC;IAED;;;;;OAKG;IACH,aAAa;QACX,OAAO,MAAM,CAAC,WAAW,CAAC,uBAAA,IAAI,2BAAO,CAAC,CAAC;IACzC,CAAC;CA4BF;;IAtBG,uBAAA,IAAI,iCAAa,MAAjB,IAAI,EAAc,MAAM,CAAC,WAAW,CAAC,uBAAA,IAAI,2BAAO,CAAC,CAAC,CAAC;AACrD,CAAC;IAMC,IAAI,uBAAA,IAAI,2BAAO,CAAC,IAAI,IAAI,uBAAA,IAAI,kCAAc,EAAE;QAC1C,OAAO;KACR;IAED,MAAM,eAAe,GAAG,uBAAA,IAAI,2BAAO,CAAC,IAAI,GAAG,uBAAA,IAAI,kCAAc,CAAC;IAC9D,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,4DAA4D;IAC5D,KAAK,MAAM,GAAG,IAAI,uBAAA,IAAI,2BAAO,CAAC,IAAI,EAAE,EAAE;QACpC,IAAI,KAAK,IAAI,eAAe,EAAE;YAC5B,MAAM;SACP;QACD,uBAAA,IAAI,2BAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACxB,KAAK,IAAI,CAAC,CAAC;KACZ;AACH,CAAC","sourcesContent":["import { fetchTimeNow } from './utils';\n\n/**\n * Generic cache entry type that wraps the data with a timestamp\n */\nexport type CacheEntry<T> = {\n  data: T;\n  timestamp: number;\n};\n\n/**\n * Configuration options for CacheManager\n */\nexport type CacheManagerOptions<T> = {\n  cacheTTL?: number;\n  maxCacheSize?: number;\n  initialCache?: Record<string, CacheEntry<T>>;\n  updateState: (cache: Record<string, CacheEntry<T>>) => void;\n};\n\n/**\n * Generic cache manager with TTL and size limit support\n *\n * @template T - The type of data to cache\n */\nexport class CacheManager<T> {\n  #cacheTTL: number;\n\n  #maxCacheSize: number;\n\n  readonly #cache: Map<string, CacheEntry<T>>;\n\n  readonly #updateState: (cache: Record<string, CacheEntry<T>>) => void;\n\n  /**\n   * Constructor for CacheManager\n   *\n   * @param options - Cache configuration options\n   * @param options.cacheTTL - Time to live in seconds for cached entries\n   * @param options.maxCacheSize - Maximum number of entries in the cache\n   * @param options.initialCache - Initial cache state\n   * @param options.updateState - Function to update the state when cache changes\n   */\n  constructor({\n    cacheTTL = 300, // 5 minutes default\n    maxCacheSize = 100,\n    initialCache = {},\n    updateState,\n  }: CacheManagerOptions<T>) {\n    this.#cacheTTL = cacheTTL;\n    this.#maxCacheSize = maxCacheSize;\n    this.#cache = new Map(Object.entries(initialCache));\n    this.#updateState = updateState;\n    this.#evictEntries();\n  }\n\n  /**\n   * Set the time-to-live for cached entries\n   *\n   * @param ttl - The TTL in seconds\n   */\n  setTTL(ttl: number): void {\n    this.#cacheTTL = ttl;\n  }\n\n  /**\n   * Get the current TTL setting\n   *\n   * @returns The TTL in seconds\n   */\n  getTTL(): number {\n    return this.#cacheTTL;\n  }\n\n  /**\n   * Set the maximum cache size\n   *\n   * @param maxSize - The maximum cache size\n   */\n  setMaxSize(maxSize: number): void {\n    this.#maxCacheSize = maxSize;\n    this.#evictEntries();\n  }\n\n  /**\n   * Get the current maximum cache size\n   *\n   * @returns The maximum cache size\n   */\n  getMaxSize(): number {\n    return this.#maxCacheSize;\n  }\n\n  /**\n   * Get the current cache size\n   *\n   * @returns The current number of entries in the cache\n   */\n  getSize(): number {\n    return this.#cache.size;\n  }\n\n  /**\n   * Clear the cache\n   */\n  clear(): void {\n    this.#cache.clear();\n    this.#persistCache();\n  }\n\n  /**\n   * Get a cached result if it exists and is not expired\n   *\n   * @param key - The cache key\n   * @returns The cached data or undefined if not found or expired\n   */\n  get(key: string): T | undefined {\n    const cacheEntry = this.#cache.get(key);\n    if (!cacheEntry) {\n      return undefined;\n    }\n\n    // Check if the entry is expired\n    const now = fetchTimeNow();\n    if (now - cacheEntry.timestamp > this.#cacheTTL) {\n      // Entry expired, remove it from cache\n      this.#cache.delete(key);\n      this.#persistCache();\n      return undefined;\n    }\n\n    return cacheEntry.data;\n  }\n\n  /**\n   * Add an entry to the cache, evicting oldest entries if necessary\n   *\n   * @param key - The cache key\n   * @param data - The data to cache\n   */\n  set(key: string, data: T): void {\n    this.#cache.set(key, {\n      data,\n      timestamp: fetchTimeNow(),\n    });\n\n    this.#evictEntries();\n    this.#persistCache();\n  }\n\n  /**\n   * Delete a specific entry from the cache\n   *\n   * @param key - The cache key\n   * @returns True if an entry was deleted\n   */\n  delete(key: string): boolean {\n    const result = this.#cache.delete(key);\n    if (result) {\n      this.#persistCache();\n    }\n    return result;\n  }\n\n  /**\n   * Get all keys in the cache\n   *\n   * @returns Array of cache keys\n   */\n  keys(): string[] {\n    return Array.from(this.#cache.keys());\n  }\n\n  /**\n   * Get all entries in the cache (including expired ones)\n   * Useful for debugging or persistence\n   *\n   * @returns Record of all cache entries\n   */\n  getAllEntries(): Record<string, CacheEntry<T>> {\n    return Object.fromEntries(this.#cache);\n  }\n\n  /**\n   * Persist the current cache state\n   */\n  #persistCache(): void {\n    this.#updateState(Object.fromEntries(this.#cache));\n  }\n\n  /**\n   * Evict oldest entries if cache exceeds max size\n   */\n  #evictEntries(): void {\n    if (this.#cache.size <= this.#maxCacheSize) {\n      return;\n    }\n\n    const entriesToRemove = this.#cache.size - this.#maxCacheSize;\n    let count = 0;\n    // Delete the oldest entries (Map maintains insertion order)\n    for (const key of this.#cache.keys()) {\n      if (count >= entriesToRemove) {\n        break;\n      }\n      this.#cache.delete(key);\n      count += 1;\n    }\n  }\n}\n"]}