@metamask-previews/phishing-controller 17.4.0-preview-5b293ee50 → 17.4.0-preview-3866c0ff1

package/CHANGELOG.md

@@ -7,32 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
-### Added
-
-- Add `PhishingDataService`, a `BaseDataService` subclass that now performs all network requests for `PhishingController` (stalelist, hotlist diffs, C2 domain blocklist, URL/token/address scans, and approvals)
-  - Exposes the messenger actions `PhishingDataService:getStalelist`, `PhishingDataService:getHotlistDiffs`, `PhishingDataService:getC2DomainBlocklist`, `PhishingDataService:scanUrl`, `PhishingDataService:bulkScanUrls`, `PhishingDataService:scanToken`, `PhishingDataService:bulkScanTokens`, `PhishingDataService:scanAddress`, and `PhishingDataService:getApprovals`, making query results available to the UI via `@metamask/react-data-query`
-  - Requests are wrapped in a shared retry policy, configurable via the `policyOptions` constructor option; circuit breaking is disabled by default because the service spans four independent API hosts and a broken circuit caused by one host would pause phishing-list updates from the others
-  - Scan results are cached per URL hostname, token, and address for `SCAN_RESULT_STALE_TIME` (1 minute, matching the previous cache TTLs); bulk scans only request items without a fresh cached result and coalesce them into batched API calls (up to 50 URLs / 100 tokens per request), and single and bulk URL scans share cache entries; approvals are never cached
-  - The query cache is persisted between sessions by default (`persistenceConfig`, max age 5 minutes), which requires the `StorageService:setItem`, `StorageService:getItem`, and `StorageService:removeItem` messenger actions and an `init` call during client initialization (automatic with `@metamask/wallet`); pass `persistenceConfig: null` to disable
-- Export the `resolveChainName` utility, which maps chain IDs to the chain names used in scan query keys, enabling UI consumers to construct `PhishingDataService` query keys
-
 ### Changed
 
-- **BREAKING:** `PhishingController` no longer performs network requests directly; a `PhishingDataService` must be registered and its method actions delegated to the controller's messenger
-  - `PhishingControllerMessenger` now requires the `PhishingDataService` method actions listed above as allowed actions
-- **BREAKING:** Remove the `urlScanCache`, `tokenScanCache`, and `addressScanCache` properties from `PhishingControllerState`; scan results are now cached (and persisted) by `PhishingDataService`'s query cache
-  - Client state migrations should remove these properties from persisted `PhishingController` state
-- **BREAKING:** Remove the `urlScanCacheTTL`, `urlScanCacheMaxSize`, `tokenScanCacheTTL`, `tokenScanCacheMaxSize`, `addressScanCacheTTL`, and `addressScanCacheMaxSize` options from `PhishingControllerOptions`; scan result freshness is now controlled by `SCAN_RESULT_STALE_TIME` in `PhishingDataService`
-- Tokens for which the bulk scanning API returns no result are now negatively cached for `SCAN_RESULT_STALE_TIME` instead of being re-requested on every call
-- `scanUrl` now reports the underlying error message in `fetchError` for network errors instead of `'timeout of 8000ms exceeded'`
-- Malformed API responses (e.g. a stalelist without a numeric `lastUpdated`, or scan results without a `recommendedAction`/`result_type`) are now rejected and treated as request failures instead of being passed through
+- **BREAKING:** Bump minimum Node.js version to 22 ([#9168](https://github.com/MetaMask/core/pull/9168))
+- Optimize C2 domain blocklist lookups by switching internal storage from `Array` to `Set`, reducing per-lookup complexity from O(n) to O(1) ([#6388](https://github.com/MetaMask/core/pull/6388))
 - Bump `@metamask/transaction-controller` from `^69.5.2` to `^69.6.1` ([#9960](https://github.com/MetaMask/core/pull/9960), [#9969](https://github.com/MetaMask/core/pull/9969))
 
-### Removed
-
-- **BREAKING:** Remove the `CacheEntry` type; the custom cache manager has been replaced by `PhishingDataService`'s query cache
-- **BREAKING:** Remove the `DEFAULT_URL_SCAN_CACHE_TTL`, `DEFAULT_URL_SCAN_CACHE_MAX_SIZE`, `DEFAULT_TOKEN_SCAN_CACHE_TTL`, `DEFAULT_TOKEN_SCAN_CACHE_MAX_SIZE`, `DEFAULT_ADDRESS_SCAN_CACHE_TTL`, and `DEFAULT_ADDRESS_SCAN_CACHE_MAX_SIZE` constants
-
 ## [17.4.0]
 
 ### Added

package/dist/CacheManager.d.ts

@@ -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.ts.map

package/dist/CacheManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CacheManager.d.ts","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;IACH,YAAY,EACV,QAAc,EAAE,oBAAoB;IACpC,YAAkB,EAClB,YAAiB,EACjB,WAAW,GACZ,EAAE,mBAAmB,CAAC,CAAC,CAAC,EAMxB;IAED;;;;OAIG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAExB;IAED;;;;OAIG;IACH,MAAM,IAAI,MAAM,CAEf;IAED;;;;OAIG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAGhC;IAED;;;;OAIG;IACH,UAAU,IAAI,MAAM,CAEnB;IAED;;;;OAIG;IACH,OAAO,IAAI,MAAM,CAEhB;IAED;;OAEG;IACH,KAAK,IAAI,IAAI,CAGZ;IAED;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAgB9B;IAED;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,CAQ9B;IAED;;;;;OAKG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAM3B;IAED;;;;OAIG;IACH,IAAI,IAAI,MAAM,EAAE,CAEf;IAED;;;;;OAKG;IACH,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAE7C;CA4BF"}

package/dist/CacheManager.js

@@ -0,0 +1,167 @@
+import { fetchTimeNow } from './utils.js';
+/**
+ * Generic cache manager with TTL and size limit support
+ *
+ * @template T - The type of data to cache
+ */
+export class CacheManager {
+    #cacheTTL;
+    #maxCacheSize;
+    #cache;
+    #updateState;
+    /**
+     * 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, }) {
+        this.#cacheTTL = cacheTTL;
+        this.#maxCacheSize = maxCacheSize;
+        this.#cache = new Map(Object.entries(initialCache));
+        this.#updateState = updateState;
+        this.#evictEntries();
+    }
+    /**
+     * Set the time-to-live for cached entries
+     *
+     * @param ttl - The TTL in seconds
+     */
+    setTTL(ttl) {
+        this.#cacheTTL = ttl;
+    }
+    /**
+     * Get the current TTL setting
+     *
+     * @returns The TTL in seconds
+     */
+    getTTL() {
+        return this.#cacheTTL;
+    }
+    /**
+     * Set the maximum cache size
+     *
+     * @param maxSize - The maximum cache size
+     */
+    setMaxSize(maxSize) {
+        this.#maxCacheSize = maxSize;
+        this.#evictEntries();
+    }
+    /**
+     * Get the current maximum cache size
+     *
+     * @returns The maximum cache size
+     */
+    getMaxSize() {
+        return this.#maxCacheSize;
+    }
+    /**
+     * Get the current cache size
+     *
+     * @returns The current number of entries in the cache
+     */
+    getSize() {
+        return this.#cache.size;
+    }
+    /**
+     * Clear the cache
+     */
+    clear() {
+        this.#cache.clear();
+        this.#persistCache();
+    }
+    /**
+     * 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 = this.#cache.get(key);
+        if (!cacheEntry) {
+            return undefined;
+        }
+        // Check if the entry is expired
+        const now = fetchTimeNow();
+        if (now - cacheEntry.timestamp > this.#cacheTTL) {
+            // Entry expired, remove it from cache
+            this.#cache.delete(key);
+            this.#persistCache();
+            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) {
+        this.#cache.set(key, {
+            data,
+            timestamp: fetchTimeNow(),
+        });
+        this.#evictEntries();
+        this.#persistCache();
+    }
+    /**
+     * Delete a specific entry from the cache
+     *
+     * @param key - The cache key
+     * @returns True if an entry was deleted
+     */
+    delete(key) {
+        const result = this.#cache.delete(key);
+        if (result) {
+            this.#persistCache();
+        }
+        return result;
+    }
+    /**
+     * Get all keys in the cache
+     *
+     * @returns Array of cache keys
+     */
+    keys() {
+        return Array.from(this.#cache.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(this.#cache);
+    }
+    /**
+     * Persist the current cache state
+     */
+    #persistCache() {
+        this.#updateState(Object.fromEntries(this.#cache));
+    }
+    /**
+     * Evict oldest entries if cache exceeds max size
+     */
+    #evictEntries() {
+        if (this.#cache.size <= this.#maxCacheSize) {
+            return;
+        }
+        const entriesToRemove = this.#cache.size - this.#maxCacheSize;
+        let count = 0;
+        // Delete the oldest entries (Map maintains insertion order)
+        for (const key of this.#cache.keys()) {
+            if (count >= entriesToRemove) {
+                break;
+            }
+            this.#cache.delete(key);
+            count += 1;
+        }
+    }
+}
+//# sourceMappingURL=CacheManager.js.map

package/dist/CacheManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CacheManager.js","sourceRoot":"","sources":["../src/CacheManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAoB1C;;;;GAIG;AACH,MAAM,OAAO,YAAY;IACvB,SAAS,CAAS;IAElB,aAAa,CAAS;IAEb,MAAM,CAA6B;IAEnC,YAAY,CAAiD;IAEtE;;;;;;;;OAQG;IACH,YAAY,EACV,QAAQ,GAAG,GAAG,EAAE,oBAAoB;IACpC,YAAY,GAAG,GAAG,EAClB,YAAY,GAAG,EAAE,EACjB,WAAW,GACY;QACvB,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC1B,IAAI,CAAC,aAAa,GAAG,YAAY,CAAC;QAClC,IAAI,CAAC,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;QACpD,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC;QAChC,IAAI,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,GAAW;QAChB,IAAI,CAAC,SAAS,GAAG,GAAG,CAAC;IACvB,CAAC;IAED;;;;OAIG;IACH,MAAM;QACJ,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED;;;;OAIG;IACH,UAAU,CAAC,OAAe;QACxB,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC;QAC7B,IAAI,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC;IAED;;;;OAIG;IACH,UAAU;QACR,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED;;;;OAIG;IACH,OAAO;QACL,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACpB,IAAI,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,GAAW;QACb,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACxC,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,gCAAgC;QAChC,MAAM,GAAG,GAAG,YAAY,EAAE,CAAC;QAC3B,IAAI,GAAG,GAAG,UAAU,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;YAChD,sCAAsC;YACtC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACxB,IAAI,CAAC,aAAa,EAAE,CAAC;YACrB,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,UAAU,CAAC,IAAI,CAAC;IACzB,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,GAAW,EAAE,IAAO;QACtB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE;YACnB,IAAI;YACJ,SAAS,EAAE,YAAY,EAAE;SAC1B,CAAC,CAAC;QAEH,IAAI,CAAC,aAAa,EAAE,CAAC;QACrB,IAAI,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,GAAW;QAChB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACvC,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,CAAC,aAAa,EAAE,CAAC;QACvB,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;OAIG;IACH,IAAI;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IACxC,CAAC;IAED;;;;;OAKG;IACH,aAAa;QACX,OAAO,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,aAAa;QACX,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IACrD,CAAC;IAED;;OAEG;IACH,aAAa;QACX,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YAC3C,OAAO;QACT,CAAC;QAED,MAAM,eAAe,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC,aAAa,CAAC;QAC9D,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,4DAA4D;QAC5D,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;YACrC,IAAI,KAAK,IAAI,eAAe,EAAE,CAAC;gBAC7B,MAAM;YACR,CAAC;YACD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACxB,KAAK,IAAI,CAAC,CAAC;QACb,CAAC;IACH,CAAC;CACF","sourcesContent":["import { fetchTimeNow } from './utils.js';\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/{PathTrie.d.mts → PathTrie.d.ts}

@@ -43,4 +43,4 @@ export declare const convertListToTrie: (paths?: string[]) => PathTrie;
  * @returns A deep copy of the PathTrie.
  */
 export declare const deepCopyPathTrie: (original: PathTrie | undefined | null) => PathTrie;
-//# sourceMappingURL=PathTrie.d.mts.map
+//# sourceMappingURL=PathTrie.d.ts.map

package/dist/PathTrie.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PathTrie.d.ts","sourceRoot":"","sources":["../src/PathTrie.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,QAAQ,GAAG;IACrB,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AAEhD,eAAO,MAAM,UAAU,SAAU,QAAQ,GAAG,SAAS,KAAG,OAKvD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,YAAY,QAAS,MAAM,YAAY,QAAQ,SA0C3D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,cAAc,QAAS,MAAM,YAAY,QAAQ,SA+B7D,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,iBAAiB,QACvB,MAAM,YACD,QAAQ,KACjB,MAAM,GAAG,IAuBX,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,WAAW,MAAM,EAAE,KAAQ,QASxD,CAAC;AAkBF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,aACjB,QAAQ,GAAG,SAAS,GAAG,IAAI,KACpC,QAKF,CAAC"}

package/dist/{PathTrie.mjs → PathTrie.js}

@@ -1,4 +1,4 @@
-import { getHostnameAndPathComponents } from "./utils.mjs";
+import { getHostnameAndPathComponents } from './utils.js';
 export const isTerminal = (node) => {
     if (!node || typeof node !== 'object') {
         return false;
@@ -157,4 +157,4 @@ export const deepCopyPathTrie = (original) => {
     }
     return deepCopyPathNode(original);
 };
-//# sourceMappingURL=PathTrie.mjs.map
+//# sourceMappingURL=PathTrie.js.map

package/dist/PathTrie.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PathTrie.js","sourceRoot":"","sources":["../src/PathTrie.ts"],"names":[],"mappings":"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","sourcesContent":["import { getHostnameAndPathComponents } from './utils.js';\n\nexport type PathNode = {\n  [key: string]: PathNode;\n};\n\nexport type PathTrie = Record<string, PathNode>;\n\nexport const isTerminal = (node: PathNode | undefined): boolean => {\n  if (!node || typeof node !== 'object') {\n    return false;\n  }\n  return Object.keys(node).length === 0;\n};\n\n/**\n * Insert a URL into the trie.\n *\n * @param url - The URL to insert into the trie.\n * @param pathTrie - The trie to insert the URL into.\n */\nexport const insertToTrie = (url: string, pathTrie: PathTrie) => {\n  const { hostname, pathComponents } = getHostnameAndPathComponents(url);\n\n  if (pathComponents.length === 0 || !hostname) {\n    return;\n  }\n\n  const lowerHostname = hostname.toLowerCase();\n  if (!pathTrie[lowerHostname]) {\n    pathTrie[lowerHostname] = {} as PathNode;\n  }\n\n  let curr: PathNode = pathTrie[lowerHostname];\n  for (let i = 0; i < pathComponents.length; i++) {\n    const pathComponent = pathComponents[i];\n    const isLast = i === pathComponents.length - 1;\n    const exists = curr[pathComponent] !== undefined;\n\n    if (exists) {\n      if (!isLast && isTerminal(curr[pathComponent])) {\n        return;\n      }\n\n      if (isLast) {\n        // Prune descendants if the current path component is not terminal\n        if (!isTerminal(curr[pathComponent])) {\n          curr[pathComponent] = {};\n        }\n        return;\n      }\n      curr = curr[pathComponent];\n      continue;\n    }\n\n    if (isLast) {\n      curr[pathComponent] = {};\n      return;\n    }\n    const next: PathNode = {};\n    curr[pathComponent] = next;\n    curr = next;\n  }\n};\n\n/**\n * Delete a URL from the trie.\n *\n * @param url - The URL to delete from the trie.\n * @param pathTrie - The trie to delete the URL from.\n */\nexport const deleteFromTrie = (url: string, pathTrie: PathTrie) => {\n  const { hostname, pathComponents } = getHostnameAndPathComponents(url);\n\n  const lowerHostname = hostname.toLowerCase();\n  if (pathComponents.length === 0 || !pathTrie[lowerHostname]) {\n    return;\n  }\n\n  const pathToNode: { node: PathNode; key: string }[] = [\n    { node: pathTrie, key: lowerHostname },\n  ];\n  let curr: PathNode = pathTrie[lowerHostname];\n  for (const pathComponent of pathComponents) {\n    if (!curr[pathComponent]) {\n      return;\n    }\n\n    pathToNode.push({ node: curr, key: pathComponent });\n    curr = curr[pathComponent];\n  }\n\n  const lastEntry = pathToNode[pathToNode.length - 1];\n  delete lastEntry.node[lastEntry.key];\n  for (let i = pathToNode.length - 2; i >= 0; i--) {\n    const { node, key } = pathToNode[i];\n    if (isTerminal(node[key])) {\n      delete node[key];\n    } else {\n      break;\n    }\n  }\n};\n\n/**\n * Get the concatenated hostname and path components all the way down to the\n * terminal node in the trie that is prefixed in the passed URL. It will only\n * return a string if the terminal node in the trie is contained in the passed\n * URL.\n *\n * @param url - The URL to check.\n * @param pathTrie - The trie to check the URL in.\n * @returns The matched path prefix, or null if no match is found.\n */\nexport const matchedPathPrefix = (\n  url: string,\n  pathTrie: PathTrie,\n): string | null => {\n  const { hostname, pathComponents } = getHostnameAndPathComponents(url);\n\n  const lowerHostname = hostname.toLowerCase();\n  if (pathComponents.length === 0 || !hostname || !pathTrie[lowerHostname]) {\n    return null;\n  }\n\n  let matchedPath = `${hostname}/`;\n  let curr: PathNode = pathTrie[lowerHostname];\n  for (const pathComponent of pathComponents) {\n    if (!curr[pathComponent]) {\n      return null;\n    }\n    curr = curr[pathComponent];\n    // If we've reached a terminal node, then we can return the matched path.\n    if (isTerminal(curr)) {\n      matchedPath += pathComponent;\n      return matchedPath;\n    }\n    matchedPath += `${pathComponent}/`;\n  }\n  return null;\n};\n\n/**\n * Converts a list ofpaths into a PathTrie structure. This assumes that the\n * entries are only hostname+pathname format.\n *\n * @param paths - Array of hostname+pathname\n * @returns PathTrie structure for efficient path checking\n */\nexport const convertListToTrie = (paths: string[] = []): PathTrie => {\n  const pathTrie: PathTrie = {};\n  if (!paths || !Array.isArray(paths)) {\n    return pathTrie;\n  }\n  for (const path of paths) {\n    insertToTrie(path, pathTrie);\n  }\n  return pathTrie;\n};\n\n/**\n * Creates a deep copy of a PathNode structure.\n *\n * @param original - The original PathNode to copy.\n * @returns A deep copy of the PathNode.\n */\nconst deepCopyPathNode = (original: PathNode): PathNode => {\n  const copy: PathNode = {};\n\n  for (const [key, childNode] of Object.entries(original)) {\n    copy[key] = deepCopyPathNode(childNode);\n  }\n\n  return copy;\n};\n\n/**\n * Creates a deep copy of a PathTrie structure.\n *\n * @param original - The original PathTrie to copy.\n * @returns A deep copy of the PathTrie.\n */\nexport const deepCopyPathTrie = (\n  original: PathTrie | undefined | null,\n): PathTrie => {\n  if (!original) {\n    return {};\n  }\n  return deepCopyPathNode(original) as PathTrie;\n};\n"]}

package/dist/{PhishingController-method-action-types.d.cts → PhishingController-method-action-types.d.ts}

@@ -2,7 +2,7 @@
  * This file is auto generated.
  * Do not edit manually.
  */
-import type { PhishingController } from "./PhishingController.cjs";
+import type { PhishingController } from './PhishingController.js';
 /**
  * Finds known recipient addresses that look like an address poisoning match.
  *
@@ -120,4 +120,4 @@ export type PhishingControllerGetApprovalsAction = {
  * Union of all PhishingController action types.
  */
 export type PhishingControllerMethodActions = PhishingControllerCheckAddressPoisoningAction | PhishingControllerMaybeUpdateStateAction | PhishingControllerTestOriginAction | PhishingControllerIsBlockedRequestAction | PhishingControllerBypassAction | PhishingControllerScanUrlAction | PhishingControllerBulkScanUrlsAction | PhishingControllerScanAddressAction | PhishingControllerBulkScanTokensAction | PhishingControllerGetApprovalsAction;
-//# sourceMappingURL=PhishingController-method-action-types.d.cts.map
+//# sourceMappingURL=PhishingController-method-action-types.d.ts.map

package/dist/PhishingController-method-action-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PhishingController-method-action-types.d.ts","sourceRoot":"","sources":["../src/PhishingController-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE;;;;;GAKG;AACH,MAAM,MAAM,6CAA6C,GAAG;IAC1D,IAAI,EAAE,0CAA0C,CAAC;IACjD,OAAO,EAAE,kBAAkB,CAAC,uBAAuB,CAAC,CAAC;CACtD,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,wCAAwC,GAAG;IACrD,IAAI,EAAE,qCAAqC,CAAC;IAC5C,OAAO,EAAE,kBAAkB,CAAC,kBAAkB,CAAC,CAAC;CACjD,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,MAAM,kCAAkC,GAAG;IAC/C,IAAI,EAAE,+BAA+B,CAAC;IACtC,OAAO,EAAE,kBAAkB,CAAC,YAAY,CAAC,CAAC;CAC3C,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,MAAM,wCAAwC,GAAG;IACrD,IAAI,EAAE,qCAAqC,CAAC;IAC5C,OAAO,EAAE,kBAAkB,CAAC,kBAAkB,CAAC,CAAC;CACjD,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,8BAA8B,GAAG;IAC3C,IAAI,EAAE,2BAA2B,CAAC;IAClC,OAAO,EAAE,kBAAkB,CAAC,QAAQ,CAAC,CAAC;CACvC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,+BAA+B,GAAG;IAC5C,IAAI,EAAE,4BAA4B,CAAC;IACnC,OAAO,EAAE,kBAAkB,CAAC,SAAS,CAAC,CAAC;CACxC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,oCAAoC,GAAG;IACjD,IAAI,EAAE,iCAAiC,CAAC;IACxC,OAAO,EAAE,kBAAkB,CAAC,cAAc,CAAC,CAAC;CAC7C,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,mCAAmC,GAAG;IAChD,IAAI,EAAE,gCAAgC,CAAC;IACvC,OAAO,EAAE,kBAAkB,CAAC,aAAa,CAAC,CAAC;CAC5C,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,sCAAsC,GAAG;IACnD,IAAI,EAAE,mCAAmC,CAAC;IAC1C,OAAO,EAAE,kBAAkB,CAAC,gBAAgB,CAAC,CAAC;CAC/C,CAAC;AAEF,MAAM,MAAM,oCAAoC,GAAG;IACjD,IAAI,EAAE,iCAAiC,CAAC;IACxC,OAAO,EAAE,kBAAkB,CAAC,cAAc,CAAC,CAAC;CAC7C,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,+BAA+B,GACvC,6CAA6C,GAC7C,wCAAwC,GACxC,kCAAkC,GAClC,wCAAwC,GACxC,8BAA8B,GAC9B,+BAA+B,GAC/B,oCAAoC,GACpC,mCAAmC,GACnC,sCAAsC,GACtC,oCAAoC,CAAC"}

package/dist/{PhishingController-method-action-types.mjs → PhishingController-method-action-types.js}

@@ -3,4 +3,4 @@
  * Do not edit manually.
  */
 export {};
-//# sourceMappingURL=PhishingController-method-action-types.mjs.map
+//# sourceMappingURL=PhishingController-method-action-types.js.map

package/dist/PhishingController-method-action-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PhishingController-method-action-types.js","sourceRoot":"","sources":["../src/PhishingController-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/**\n * This file is auto generated.\n * Do not edit manually.\n */\n\nimport type { PhishingController } from './PhishingController.js';\n\n/**\n * Finds known recipient addresses that look like an address poisoning match.\n *\n * @param candidate - The recipient address being checked.\n * @returns Similar known recipient matches sorted by score.\n */\nexport type PhishingControllerCheckAddressPoisoningAction = {\n  type: `PhishingController:checkAddressPoisoning`;\n  handler: PhishingController['checkAddressPoisoning'];\n};\n\n/**\n * Conditionally update the phishing configuration.\n *\n * If the stalelist configuration is out of date, this function will call `updateStalelist`\n * to update the configuration. This will automatically grab the hotlist,\n * so it isn't necessary to continue on to download the hotlist and the c2 domain blocklist.\n *\n */\nexport type PhishingControllerMaybeUpdateStateAction = {\n  type: `PhishingController:maybeUpdateState`;\n  handler: PhishingController['maybeUpdateState'];\n};\n\n/**\n * Determines if a given origin is unapproved.\n *\n * It is strongly recommended that you call {@link maybeUpdateState} before calling this,\n * to check whether the phishing configuration is up-to-date. It will be updated if necessary\n * by calling {@link updateStalelist} or {@link updateHotlist}.\n *\n * @param origin - Domain origin of a website.\n * @returns Whether the origin is an unapproved origin.\n */\nexport type PhishingControllerTestOriginAction = {\n  type: `PhishingController:testOrigin`;\n  handler: PhishingController['testOrigin'];\n};\n\n/**\n * Checks if a request URL's domain is blocked against the request blocklist.\n *\n * This method is used to determine if a specific request URL is associated with a malicious\n * command and control (C2) domain. The URL's hostname is hashed and checked against a configured\n * blocklist of known malicious domains.\n *\n * @param origin - The full request URL to be checked.\n * @returns An object indicating whether the URL's domain is blocked and relevant metadata.\n */\nexport type PhishingControllerIsBlockedRequestAction = {\n  type: `PhishingController:isBlockedRequest`;\n  handler: PhishingController['isBlockedRequest'];\n};\n\n/**\n * Temporarily marks a given origin as approved.\n *\n * @param origin - The origin to mark as approved.\n */\nexport type PhishingControllerBypassAction = {\n  type: `PhishingController:bypass`;\n  handler: PhishingController['bypass'];\n};\n\n/**\n * Scan a URL for phishing. For most hosts only the hostname is sent to the API; for known\n * shared gateways the pathname is included (see `PHISHING_DETECTION_PATH_BASED_ROOT_DOMAINS`).\n * Only supports web URLs (`http:` / `https:`).\n *\n * @param url - The URL to scan.\n * @returns The phishing detection scan result.\n */\nexport type PhishingControllerScanUrlAction = {\n  type: `PhishingController:scanUrl`;\n  handler: PhishingController['scanUrl'];\n};\n\n/**\n * Scan multiple URLs for phishing in bulk. It will only scan the hostnames of the URLs.\n * It also only supports web URLs.\n *\n * @param urls - The URLs to scan.\n * @returns A mapping of URLs to their phishing detection scan results and errors.\n */\nexport type PhishingControllerBulkScanUrlsAction = {\n  type: `PhishingController:bulkScanUrls`;\n  handler: PhishingController['bulkScanUrls'];\n};\n\n/**\n * Scan an address for security alerts.\n *\n * @param chainId - The chain ID in hex format (e.g., '0x1' for Ethereum).\n * @param address - The address to scan.\n * @returns The address scan result.\n */\nexport type PhishingControllerScanAddressAction = {\n  type: `PhishingController:scanAddress`;\n  handler: PhishingController['scanAddress'];\n};\n\n/**\n * Scan multiple tokens for malicious activity in bulk.\n *\n * @param request - The bulk scan request containing chainId and tokens.\n * @param request.chainId - The chain identifier. Accepts a hex chain ID for\n * EVM chains (e.g. `'0x1'` for Ethereum) or a chain name for non-EVM chains\n * (e.g. `'solana'`).\n * @param request.tokens - Array of token addresses to scan.\n * @returns A mapping of token addresses to their scan results. For EVM chains,\n * addresses are lowercased; for non-EVM chains, original casing is preserved.\n * Tokens that fail to scan are omitted.\n */\nexport type PhishingControllerBulkScanTokensAction = {\n  type: `PhishingController:bulkScanTokens`;\n  handler: PhishingController['bulkScanTokens'];\n};\n\nexport type PhishingControllerGetApprovalsAction = {\n  type: `PhishingController:getApprovals`;\n  handler: PhishingController['getApprovals'];\n};\n\n/**\n * Union of all PhishingController action types.\n */\nexport type PhishingControllerMethodActions =\n  | PhishingControllerCheckAddressPoisoningAction\n  | PhishingControllerMaybeUpdateStateAction\n  | PhishingControllerTestOriginAction\n  | PhishingControllerIsBlockedRequestAction\n  | PhishingControllerBypassAction\n  | PhishingControllerScanUrlAction\n  | PhishingControllerBulkScanUrlsAction\n  | PhishingControllerScanAddressAction\n  | PhishingControllerBulkScanTokensAction\n  | PhishingControllerGetApprovalsAction;\n"]}