Class DefaultStatsCounter

packages/client/lib/client/cache.ts:289–368

* A StatsCounter implementation that maintains cache statistics.

 * A StatsCounter implementation that maintains cache statistics.
 */
class DefaultStatsCounter implements StatsCounter {
  #hitCount = 0;
  #missCount = 0;
  #loadSuccessCount = 0;
  #loadFailureCount = 0;
  #totalLoadTime = 0;
  #evictionCount = 0;

  /**
   * Records cache hits.
   *
   * @param count - The number of hits to record
   */
  recordHits(count: number): void {
    this.#hitCount += count;
  }

  /**
   * Records cache misses.
   *
   * @param count - The number of misses to record
   */
  recordMisses(count: number): void {
    this.#missCount += count;
  }

  /**
   * Records the successful load of a new entry.
   *
   * @param loadTime - The number of milliseconds spent loading the entry
   */
  recordLoadSuccess(loadTime: number): void {
    this.#loadSuccessCount++;
    this.#totalLoadTime += loadTime;
  }

  /**
   * Records the failed load of a new entry.
   *
   * @param loadTime - The number of milliseconds spent attempting to load the entry
   */
  recordLoadFailure(loadTime: number): void {
    this.#loadFailureCount++;
    this.#totalLoadTime += loadTime;
  }

  /**
   * Records cache evictions.
   *
   * @param count - The number of evictions to record
   */
  recordEvictions(count: number): void {
    this.#evictionCount += count;
  }

  /**
   * Returns a snapshot of the current statistics.
   *