@happyvertical/cache 0.74.8

package/dist/chunks/file-DyC_7WDS.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-DyC_7WDS.js","sources":["../../src/providers/file.ts"],"sourcesContent":["/**\n * File cache provider implementation with compression\n */\n\nimport {\n  mkdir,\n  readdir,\n  readFile,\n  rm,\n  stat,\n  writeFile,\n} from 'node:fs/promises';\nimport { join, resolve } from 'node:path';\nimport { promisify } from 'node:util';\nimport { gunzip, gzip } from 'node:zlib';\nimport type {\n  CacheEntry,\n  CacheProvider,\n  CacheStats,\n  FileOptions,\n} from '../shared/types';\nimport {\n  CacheError,\n  CacheKeyError,\n  CacheSerializationError,\n  CacheSizeError,\n} from '../shared/types';\nimport {\n  calculateExpiration,\n  calculateSize,\n  deserialize,\n  extractKey,\n  formatKey,\n  isExpired,\n  isValidKey,\n  matchesPattern,\n  serialize,\n} from '../shared/utils';\n\nconst gzipAsync = promisify(gzip);\nconst gunzipAsync = promisify(gunzip);\n\n/**\n * File cache provider implementation\n * Stores cache entries as files with optional compression\n */\nexport class FileProvider implements CacheProvider {\n  private cacheDir: string;\n  private namespace?: string;\n  private defaultTTL?: number;\n  private maxSize: number;\n  private compression: boolean;\n  private fileExtension: string;\n  private checkPeriod: number;\n  private checkInterval?: NodeJS.Timeout;\n  private stats: {\n    hits: number;\n    misses: number;\n    evictions: number;\n  };\n\n  constructor(options: FileOptions) {\n    this.cacheDir = resolve(options.cacheDir);\n    this.namespace = options.namespace;\n    this.defaultTTL = options.defaultTTL;\n    this.maxSize = options.maxSize || 500 * 1024 * 1024; // 500MB default\n    this.compression = options.compression ?? false;\n    this.fileExtension = options.fileExtension || '.cache';\n    this.checkPeriod = options.checkPeriod || 300000; // 5 minutes default\n    this.stats = {\n      hits: 0,\n      misses: 0,\n      evictions: 0,\n    };\n\n    // Ensure cache directory exists\n    this.ensureCacheDir();\n\n    // Start background cleanup\n    this.startCleanup();\n  }\n\n  async get<T = any>(key: string): Promise<T | undefined> {\n    if (!isValidKey(key)) {\n      throw new CacheKeyError(key, 'file');\n    }\n\n    const fullKey = formatKey(this.namespace, key);\n    const filePath = this.getFilePath(fullKey);\n\n    try {\n      const fileContent = await readFile(filePath);\n      let data: Buffer;\n\n      // Decompress if needed\n      if (this.compression) {\n        data = await gunzipAsync(fileContent);\n      } else {\n        data = fileContent;\n      }\n\n      const entry: CacheEntry<T> = deserialize(data.toString('utf-8'));\n\n      // Check if expired\n      if (isExpired(entry.expiresAt)) {\n        await rm(filePath, { force: true });\n        this.stats.misses++;\n        return undefined;\n      }\n\n      // Update hit count\n      entry.hits++;\n      this.stats.hits++;\n\n      // Write back updated entry (for hit tracking)\n      await this.writeEntry(filePath, entry);\n\n      return entry.value;\n    } catch (error: any) {\n      if (error.code === 'ENOENT') {\n        this.stats.misses++;\n        return undefined;\n      }\n      throw new CacheError(\n        `Failed to read cache entry: ${error.message}`,\n        'READ_ERROR',\n        'file',\n      );\n    }\n  }\n\n  async set<T = any>(key: string, value: T, ttl?: number): Promise<void> {\n    if (!isValidKey(key)) {\n      throw new CacheKeyError(key, 'file');\n    }\n\n    const fullKey = formatKey(this.namespace, key);\n    const filePath = this.getFilePath(fullKey);\n    const expiresAt = calculateExpiration(ttl ?? this.defaultTTL);\n\n    const entry: CacheEntry<T> = {\n      value,\n      createdAt: Date.now(),\n      expiresAt,\n      size: calculateSize(value),\n      hits: 0,\n      metadata: {\n        compressed: this.compression,\n        namespace: this.namespace,\n      },\n    };\n\n    // Check if we need to evict files\n    await this.evictIfNeeded(entry.size);\n\n    // Write entry to file\n    await this.writeEntry(filePath, entry);\n  }\n\n  async has(key: string): Promise<boolean> {\n    if (!isValidKey(key)) {\n      throw new CacheKeyError(key, 'file');\n    }\n\n    const fullKey = formatKey(this.namespace, key);\n    const filePath = this.getFilePath(fullKey);\n\n    try {\n      const fileContent = await readFile(filePath);\n      let data: Buffer;\n\n      if (this.compression) {\n        data = await gunzipAsync(fileContent);\n      } else {\n        data = fileContent;\n      }\n\n      const entry: CacheEntry = deserialize(data.toString('utf-8'));\n\n      // Check if expired\n      if (isExpired(entry.expiresAt)) {\n        await rm(filePath, { force: true });\n        return false;\n      }\n\n      return true;\n    } catch (error: any) {\n      if (error.code === 'ENOENT') {\n        return false;\n      }\n      throw new CacheError(\n        `Failed to check cache entry: ${error.message}`,\n        'CHECK_ERROR',\n        'file',\n      );\n    }\n  }\n\n  async delete(key: string): Promise<boolean> {\n    if (!isValidKey(key)) {\n      throw new CacheKeyError(key, 'file');\n    }\n\n    const fullKey = formatKey(this.namespace, key);\n    const filePath = this.getFilePath(fullKey);\n\n    try {\n      await rm(filePath);\n      return true;\n    } catch (error: any) {\n      if (error.code === 'ENOENT') {\n        return false;\n      }\n      throw new CacheError(\n        `Failed to delete cache entry: ${error.message}`,\n        'DELETE_ERROR',\n        'file',\n      );\n    }\n  }\n\n  async clear(namespace?: string): Promise<void> {\n    if (namespace) {\n      // Clear specific namespace\n      const prefix = this.sanitizeKey(`${namespace}:`);\n      const files = await this.getAllFiles();\n\n      for (const file of files) {\n        if (file.startsWith(prefix)) {\n          await rm(join(this.cacheDir, file), { force: true });\n        }\n      }\n    } else {\n      // Clear all cache files\n      try {\n        await rm(this.cacheDir, { recursive: true, force: true });\n        await this.ensureCacheDir();\n        this.stats.hits = 0;\n        this.stats.misses = 0;\n        this.stats.evictions = 0;\n      } catch (error: any) {\n        throw new CacheError(\n          `Failed to clear cache: ${error.message}`,\n          'CLEAR_ERROR',\n          'file',\n        );\n      }\n    }\n  }\n\n  async keys(pattern?: string): Promise<string[]> {\n    const files = await this.getAllFiles();\n    const keys: string[] = [];\n\n    for (const file of files) {\n      // Remove file extension\n      const key = file.replace(this.fileExtension, '');\n\n      // Check if file is expired\n      const filePath = join(this.cacheDir, file);\n      try {\n        const fileContent = await readFile(filePath);\n        let data: Buffer;\n\n        if (this.compression) {\n          data = await gunzipAsync(fileContent);\n        } else {\n          data = fileContent;\n        }\n\n        const entry: CacheEntry = deserialize(data.toString('utf-8'));\n\n        if (!isExpired(entry.expiresAt)) {\n          const desanitized = this.desanitizeKey(key);\n          keys.push(extractKey(this.namespace, desanitized));\n        }\n      } catch {}\n    }\n\n    // Apply pattern filter if provided\n    if (pattern) {\n      return keys.filter((key) => matchesPattern(pattern, key));\n    }\n\n    return keys;\n  }\n\n  async getMany<T = any>(keys: string[]): Promise<Map<string, T>> {\n    const result = new Map<string, T>();\n\n    for (const key of keys) {\n      const value = await this.get<T>(key);\n      if (value !== undefined) {\n        result.set(key, value);\n      }\n    }\n\n    return result;\n  }\n\n  async setMany<T = any>(\n    entries: Array<{ key: string; value: T; ttl?: number }>,\n  ): Promise<void> {\n    for (const entry of entries) {\n      await this.set(entry.key, entry.value, entry.ttl);\n    }\n  }\n\n  async deleteMany(keys: string[]): Promise<number> {\n    let deleted = 0;\n\n    for (const key of keys) {\n      const wasDeleted = await this.delete(key);\n      if (wasDeleted) {\n        deleted++;\n      }\n    }\n\n    return deleted;\n  }\n\n  async getStats(): Promise<CacheStats> {\n    const files = await this.getAllFiles();\n    let totalSize = 0;\n    let entries = 0;\n\n    for (const file of files) {\n      const filePath = join(this.cacheDir, file);\n      try {\n        const stats = await stat(filePath);\n        totalSize += stats.size;\n\n        // Check if expired\n        const fileContent = await readFile(filePath);\n        let data: Buffer;\n\n        if (this.compression) {\n          data = await gunzipAsync(fileContent);\n        } else {\n          data = fileContent;\n        }\n\n        const entry: CacheEntry = deserialize(data.toString('utf-8'));\n\n        if (!isExpired(entry.expiresAt)) {\n          entries++;\n        }\n      } catch {}\n    }\n\n    const totalAccesses = this.stats.hits + this.stats.misses;\n    const hitRate = totalAccesses > 0 ? this.stats.hits / totalAccesses : 0;\n\n    return {\n      entries,\n      totalSize,\n      hits: this.stats.hits,\n      misses: this.stats.misses,\n      hitRate,\n      evictions: this.stats.evictions,\n      backend: {\n        type: 'file',\n        cacheDir: this.cacheDir,\n        compression: this.compression,\n        maxSize: this.maxSize,\n      },\n    };\n  }\n\n  async touch(key: string, ttl: number): Promise<boolean> {\n    if (!isValidKey(key)) {\n      throw new CacheKeyError(key, 'file');\n    }\n\n    const fullKey = formatKey(this.namespace, key);\n    const filePath = this.getFilePath(fullKey);\n\n    try {\n      const fileContent = await readFile(filePath);\n      let data: Buffer;\n\n      if (this.compression) {\n        data = await gunzipAsync(fileContent);\n      } else {\n        data = fileContent;\n      }\n\n      const entry: CacheEntry = deserialize(data.toString('utf-8'));\n\n      if (isExpired(entry.expiresAt)) {\n        return false;\n      }\n\n      entry.expiresAt = calculateExpiration(ttl);\n      await this.writeEntry(filePath, entry);\n\n      return true;\n    } catch (error: any) {\n      if (error.code === 'ENOENT') {\n        return false;\n      }\n      throw new CacheError(\n        `Failed to touch cache entry: ${error.message}`,\n        'TOUCH_ERROR',\n        'file',\n      );\n    }\n  }\n\n  async close(): Promise<void> {\n    // Stop cleanup interval\n    if (this.checkInterval) {\n      clearInterval(this.checkInterval);\n      this.checkInterval = undefined;\n    }\n  }\n\n  /**\n   * Ensures cache directory exists\n   */\n  private async ensureCacheDir(): Promise<void> {\n    try {\n      await mkdir(this.cacheDir, { recursive: true });\n    } catch (error: any) {\n      throw new CacheError(\n        `Failed to create cache directory: ${error.message}`,\n        'INIT_ERROR',\n        'file',\n      );\n    }\n  }\n\n  /**\n   * Gets the file path for a cache key\n   */\n  private getFilePath(key: string): string {\n    const sanitizedKey = this.sanitizeKey(key);\n    return join(this.cacheDir, `${sanitizedKey}${this.fileExtension}`);\n  }\n\n  /**\n   * Sanitizes a key for use as a filename\n   */\n  private sanitizeKey(key: string): string {\n    return key.replace(/[^a-zA-Z0-9_:-]/g, '_');\n  }\n\n  /**\n   * Desanitizes a filename back to the original key\n   */\n  private desanitizeKey(sanitized: string): string {\n    // This is a simple implementation - in practice, you might need\n    // a more sophisticated mapping\n    return sanitized;\n  }\n\n  /**\n   * Gets all cache file names\n   */\n  private async getAllFiles(): Promise<string[]> {\n    try {\n      const files = await readdir(this.cacheDir);\n      return files.filter((file) => file.endsWith(this.fileExtension));\n    } catch (error: any) {\n      if (error.code === 'ENOENT') {\n        return [];\n      }\n      throw new CacheError(\n        `Failed to list cache files: ${error.message}`,\n        'LIST_ERROR',\n        'file',\n      );\n    }\n  }\n\n  /**\n   * Writes an entry to a file\n   */\n  private async writeEntry(filePath: string, entry: CacheEntry): Promise<void> {\n    try {\n      let data: Buffer;\n      const json = serialize(entry);\n      data = Buffer.from(json, 'utf-8');\n\n      // Compress if enabled\n      if (this.compression) {\n        data = await gzipAsync(data);\n      }\n\n      await writeFile(filePath, data);\n    } catch (error: any) {\n      throw new CacheSerializationError(\n        `Failed to write cache entry: ${error.message}`,\n        'file',\n      );\n    }\n  }\n\n  /**\n   * Evicts files if size limit is exceeded\n   */\n  private async evictIfNeeded(newEntrySize: number): Promise<void> {\n    const stats = await this.getStats();\n\n    // Check if we need to evict\n    if (stats.totalSize + newEntrySize > this.maxSize) {\n      await this.evict();\n\n      // Check again after eviction\n      const updatedStats = await this.getStats();\n      if (updatedStats.totalSize + newEntrySize > this.maxSize) {\n        throw new CacheSizeError(\n          `Cannot cache entry: would exceed max size of ${this.maxSize} bytes`,\n          'file',\n        );\n      }\n    }\n  }\n\n  /**\n   * Evicts oldest files based on creation time\n   */\n  private async evict(): Promise<void> {\n    const files = await this.getAllFiles();\n    const filesWithStats: Array<{ file: string; createdAt: number }> = [];\n\n    for (const file of files) {\n      const filePath = join(this.cacheDir, file);\n      try {\n        const fileContent = await readFile(filePath);\n        let data: Buffer;\n\n        if (this.compression) {\n          data = await gunzipAsync(fileContent);\n        } else {\n          data = fileContent;\n        }\n\n        const entry: CacheEntry = deserialize(data.toString('utf-8'));\n        filesWithStats.push({ file, createdAt: entry.createdAt });\n      } catch {}\n    }\n\n    // Sort by creation time (oldest first)\n    filesWithStats.sort((a, b) => a.createdAt - b.createdAt);\n\n    // Remove oldest 10% of files\n    const toRemove = Math.max(1, Math.floor(filesWithStats.length * 0.1));\n    for (let i = 0; i < toRemove; i++) {\n      const filePath = join(this.cacheDir, filesWithStats[i].file);\n      await rm(filePath, { force: true });\n      this.stats.evictions++;\n    }\n  }\n\n  /**\n   * Starts background cleanup of expired files\n   */\n  private startCleanup(): void {\n    this.checkInterval = setInterval(() => {\n      this.removeExpiredFiles();\n    }, this.checkPeriod);\n\n    // Don't block process exit\n    if (this.checkInterval.unref) {\n      this.checkInterval.unref();\n    }\n  }\n\n  /**\n   * Removes expired files\n   */\n  private async removeExpiredFiles(): Promise<void> {\n    const files = await this.getAllFiles();\n\n    for (const file of files) {\n      const filePath = join(this.cacheDir, file);\n      try {\n        const fileContent = await readFile(filePath);\n        let data: Buffer;\n\n        if (this.compression) {\n          data = await gunzipAsync(fileContent);\n        } else {\n          data = fileContent;\n        }\n\n        const entry: CacheEntry = deserialize(data.toString('utf-8'));\n\n        if (isExpired(entry.expiresAt)) {\n          await rm(filePath, { force: true });\n        }\n      } catch {}\n    }\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/chunks/memory-C6vfNZYg.js

@@ -0,0 +1,274 @@
+import { isValidKey, CacheKeyError, formatKey, isExpired, calculateSize, calculateExpiration, extractKey, matchesPattern, CacheSizeError } from "../index.js";
+class MemoryProvider {
+  cache;
+  namespace;
+  defaultTTL;
+  maxSize;
+  maxEntries;
+  evictionPolicy;
+  checkPeriod;
+  checkInterval;
+  stats;
+  constructor(options) {
+    this.cache = /* @__PURE__ */ new Map();
+    this.namespace = options.namespace;
+    this.defaultTTL = options.defaultTTL;
+    this.maxSize = options.maxSize || 100 * 1024 * 1024;
+    this.maxEntries = options.maxEntries || 1e4;
+    this.evictionPolicy = options.evictionPolicy || "lru";
+    this.checkPeriod = options.checkPeriod || 6e4;
+    this.stats = {
+      hits: 0,
+      misses: 0,
+      evictions: 0
+    };
+    this.startExpirationCheck();
+  }
+  async get(key) {
+    if (!isValidKey(key)) {
+      throw new CacheKeyError(key, "memory");
+    }
+    const fullKey = formatKey(this.namespace, key);
+    const entry = this.cache.get(fullKey);
+    if (!entry) {
+      this.stats.misses++;
+      return void 0;
+    }
+    if (isExpired(entry.expiresAt)) {
+      this.cache.delete(fullKey);
+      this.stats.misses++;
+      return void 0;
+    }
+    entry.hits++;
+    if (this.evictionPolicy === "lru") {
+      this.cache.delete(fullKey);
+      this.cache.set(fullKey, entry);
+    }
+    this.stats.hits++;
+    return entry.value;
+  }
+  async set(key, value, ttl) {
+    if (!isValidKey(key)) {
+      throw new CacheKeyError(key, "memory");
+    }
+    const fullKey = formatKey(this.namespace, key);
+    const size = calculateSize(value);
+    const expiresAt = calculateExpiration(ttl ?? this.defaultTTL);
+    const entry = {
+      value,
+      createdAt: Date.now(),
+      expiresAt,
+      size,
+      hits: 0,
+      metadata: {
+        namespace: this.namespace
+      }
+    };
+    await this.evictIfNeeded(size);
+    this.cache.set(fullKey, entry);
+  }
+  async has(key) {
+    if (!isValidKey(key)) {
+      throw new CacheKeyError(key, "memory");
+    }
+    const fullKey = formatKey(this.namespace, key);
+    const entry = this.cache.get(fullKey);
+    if (!entry) {
+      return false;
+    }
+    if (isExpired(entry.expiresAt)) {
+      this.cache.delete(fullKey);
+      return false;
+    }
+    return true;
+  }
+  async delete(key) {
+    if (!isValidKey(key)) {
+      throw new CacheKeyError(key, "memory");
+    }
+    const fullKey = formatKey(this.namespace, key);
+    return this.cache.delete(fullKey);
+  }
+  async clear(namespace) {
+    if (namespace) {
+      const prefix = `${namespace}:`;
+      for (const key of this.cache.keys()) {
+        if (key.startsWith(prefix)) {
+          this.cache.delete(key);
+        }
+      }
+    } else {
+      this.cache.clear();
+      this.stats.hits = 0;
+      this.stats.misses = 0;
+      this.stats.evictions = 0;
+    }
+  }
+  async keys(pattern) {
+    const allKeys = Array.from(this.cache.keys());
+    const validKeys = [];
+    for (const key of allKeys) {
+      const entry = this.cache.get(key);
+      if (entry && !isExpired(entry.expiresAt)) {
+        validKeys.push(extractKey(this.namespace, key));
+      }
+    }
+    if (pattern) {
+      return validKeys.filter((key) => matchesPattern(pattern, key));
+    }
+    return validKeys;
+  }
+  async getMany(keys) {
+    const result = /* @__PURE__ */ new Map();
+    for (const key of keys) {
+      const value = await this.get(key);
+      if (value !== void 0) {
+        result.set(key, value);
+      }
+    }
+    return result;
+  }
+  async setMany(entries) {
+    for (const entry of entries) {
+      await this.set(entry.key, entry.value, entry.ttl);
+    }
+  }
+  async deleteMany(keys) {
+    let deleted = 0;
+    for (const key of keys) {
+      const wasDeleted = await this.delete(key);
+      if (wasDeleted) {
+        deleted++;
+      }
+    }
+    return deleted;
+  }
+  async getStats() {
+    let totalSize = 0;
+    let entries = 0;
+    for (const entry of this.cache.values()) {
+      if (!isExpired(entry.expiresAt)) {
+        totalSize += entry.size;
+        entries++;
+      }
+    }
+    const totalAccesses = this.stats.hits + this.stats.misses;
+    const hitRate = totalAccesses > 0 ? this.stats.hits / totalAccesses : 0;
+    return {
+      entries,
+      totalSize,
+      hits: this.stats.hits,
+      misses: this.stats.misses,
+      hitRate,
+      evictions: this.stats.evictions,
+      backend: {
+        type: "memory",
+        evictionPolicy: this.evictionPolicy,
+        maxSize: this.maxSize,
+        maxEntries: this.maxEntries
+      }
+    };
+  }
+  async touch(key, ttl) {
+    if (!isValidKey(key)) {
+      throw new CacheKeyError(key, "memory");
+    }
+    const fullKey = formatKey(this.namespace, key);
+    const entry = this.cache.get(fullKey);
+    if (!entry || isExpired(entry.expiresAt)) {
+      return false;
+    }
+    entry.expiresAt = calculateExpiration(ttl);
+    return true;
+  }
+  async close() {
+    if (this.checkInterval) {
+      clearInterval(this.checkInterval);
+      this.checkInterval = void 0;
+    }
+    this.cache.clear();
+  }
+  /**
+   * Evicts entries if size or count limits are exceeded
+   */
+  async evictIfNeeded(newEntrySize) {
+    const stats = await this.getStats();
+    if (stats.entries >= this.maxEntries) {
+      await this.evict(1);
+    }
+    while (stats.totalSize + newEntrySize > this.maxSize && this.cache.size > 0) {
+      await this.evict(1);
+      const updatedStats = await this.getStats();
+      if (updatedStats.totalSize + newEntrySize <= this.maxSize) {
+        break;
+      }
+    }
+    const finalStats = await this.getStats();
+    if (finalStats.totalSize + newEntrySize > this.maxSize) {
+      throw new CacheSizeError(
+        `Cannot cache entry: would exceed max size of ${this.maxSize} bytes`,
+        "memory"
+      );
+    }
+  }
+  /**
+   * Evicts entries based on eviction policy
+   */
+  async evict(count) {
+    if (this.cache.size === 0) {
+      return;
+    }
+    const entries = Array.from(this.cache.entries());
+    switch (this.evictionPolicy) {
+      case "lru": {
+        for (let i = 0; i < count && i < entries.length; i++) {
+          this.cache.delete(entries[i][0]);
+          this.stats.evictions++;
+        }
+        break;
+      }
+      case "lfu": {
+        const sorted = entries.sort((a, b) => a[1].hits - b[1].hits);
+        for (let i = 0; i < count && i < sorted.length; i++) {
+          this.cache.delete(sorted[i][0]);
+          this.stats.evictions++;
+        }
+        break;
+      }
+      case "fifo": {
+        const sorted = entries.sort((a, b) => a[1].createdAt - b[1].createdAt);
+        for (let i = 0; i < count && i < sorted.length; i++) {
+          this.cache.delete(sorted[i][0]);
+          this.stats.evictions++;
+        }
+        break;
+      }
+    }
+  }
+  /**
+   * Starts background task to remove expired entries
+   */
+  startExpirationCheck() {
+    this.checkInterval = setInterval(() => {
+      this.removeExpiredEntries();
+    }, this.checkPeriod);
+    if (this.checkInterval.unref) {
+      this.checkInterval.unref();
+    }
+  }
+  /**
+   * Removes all expired entries from the cache
+   */
+  removeExpiredEntries() {
+    const now = Date.now();
+    for (const [key, entry] of this.cache.entries()) {
+      if (entry.expiresAt && now >= entry.expiresAt) {
+        this.cache.delete(key);
+      }
+    }
+  }
+}
+export {
+  MemoryProvider
+};
+//# sourceMappingURL=memory-C6vfNZYg.js.map

package/dist/chunks/memory-C6vfNZYg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-C6vfNZYg.js","sources":["../../src/providers/memory.ts"],"sourcesContent":["/**\n * Memory cache provider implementation with LRU eviction\n */\n\nimport type {\n  CacheEntry,\n  CacheProvider,\n  CacheStats,\n  MemoryOptions,\n} from '../shared/types';\nimport { CacheKeyError, CacheSizeError } from '../shared/types';\nimport {\n  calculateExpiration,\n  calculateSize,\n  extractKey,\n  formatKey,\n  isExpired,\n  isValidKey,\n  matchesPattern,\n} from '../shared/utils';\n\n/**\n * Memory cache provider implementation\n * Stores cache entries in memory with LRU eviction\n */\nexport class MemoryProvider implements CacheProvider {\n  private cache: Map<string, CacheEntry>;\n  private namespace?: string;\n  private defaultTTL?: number;\n  private maxSize: number;\n  private maxEntries: number;\n  private evictionPolicy: 'lru' | 'lfu' | 'fifo';\n  private checkPeriod: number;\n  private checkInterval?: NodeJS.Timeout;\n  private stats: {\n    hits: number;\n    misses: number;\n    evictions: number;\n  };\n\n  constructor(options: MemoryOptions) {\n    this.cache = new Map();\n    this.namespace = options.namespace;\n    this.defaultTTL = options.defaultTTL;\n    this.maxSize = options.maxSize || 100 * 1024 * 1024; // 100MB default\n    this.maxEntries = options.maxEntries || 10000; // 10k entries default\n    this.evictionPolicy = options.evictionPolicy || 'lru';\n    this.checkPeriod = options.checkPeriod || 60000; // 1 minute default\n    this.stats = {\n      hits: 0,\n      misses: 0,\n      evictions: 0,\n    };\n\n    // Start background expiration check\n    this.startExpirationCheck();\n  }\n\n  async get<T = any>(key: string): Promise<T | undefined> {\n    if (!isValidKey(key)) {\n      throw new CacheKeyError(key, 'memory');\n    }\n\n    const fullKey = formatKey(this.namespace, key);\n    const entry = this.cache.get(fullKey);\n\n    if (!entry) {\n      this.stats.misses++;\n      return undefined;\n    }\n\n    // Check if expired\n    if (isExpired(entry.expiresAt)) {\n      this.cache.delete(fullKey);\n      this.stats.misses++;\n      return undefined;\n    }\n\n    // Update access statistics for LRU/LFU\n    entry.hits++;\n\n    // For LRU, move to end of map (most recently used)\n    if (this.evictionPolicy === 'lru') {\n      this.cache.delete(fullKey);\n      this.cache.set(fullKey, entry);\n    }\n\n    this.stats.hits++;\n    return entry.value as T;\n  }\n\n  async set<T = any>(key: string, value: T, ttl?: number): Promise<void> {\n    if (!isValidKey(key)) {\n      throw new CacheKeyError(key, 'memory');\n    }\n\n    const fullKey = formatKey(this.namespace, key);\n    const size = calculateSize(value);\n    const expiresAt = calculateExpiration(ttl ?? this.defaultTTL);\n\n    const entry: CacheEntry<T> = {\n      value,\n      createdAt: Date.now(),\n      expiresAt,\n      size,\n      hits: 0,\n      metadata: {\n        namespace: this.namespace,\n      },\n    };\n\n    // Check if we need to evict entries\n    await this.evictIfNeeded(size);\n\n    this.cache.set(fullKey, entry);\n  }\n\n  async has(key: string): Promise<boolean> {\n    if (!isValidKey(key)) {\n      throw new CacheKeyError(key, 'memory');\n    }\n\n    const fullKey = formatKey(this.namespace, key);\n    const entry = this.cache.get(fullKey);\n\n    if (!entry) {\n      return false;\n    }\n\n    // Check if expired\n    if (isExpired(entry.expiresAt)) {\n      this.cache.delete(fullKey);\n      return false;\n    }\n\n    return true;\n  }\n\n  async delete(key: string): Promise<boolean> {\n    if (!isValidKey(key)) {\n      throw new CacheKeyError(key, 'memory');\n    }\n\n    const fullKey = formatKey(this.namespace, key);\n    return this.cache.delete(fullKey);\n  }\n\n  async clear(namespace?: string): Promise<void> {\n    if (namespace) {\n      // Clear specific namespace\n      const prefix = `${namespace}:`;\n      for (const key of this.cache.keys()) {\n        if (key.startsWith(prefix)) {\n          this.cache.delete(key);\n        }\n      }\n    } else {\n      // Clear all entries\n      this.cache.clear();\n      this.stats.hits = 0;\n      this.stats.misses = 0;\n      this.stats.evictions = 0;\n    }\n  }\n\n  async keys(pattern?: string): Promise<string[]> {\n    const allKeys = Array.from(this.cache.keys());\n\n    // Filter out expired entries and extract keys without namespace\n    const validKeys: string[] = [];\n    for (const key of allKeys) {\n      const entry = this.cache.get(key);\n      if (entry && !isExpired(entry.expiresAt)) {\n        validKeys.push(extractKey(this.namespace, key));\n      }\n    }\n\n    // Apply pattern filter if provided (pattern is applied to the extracted key, not the full key)\n    if (pattern) {\n      return validKeys.filter((key) => matchesPattern(pattern, key));\n    }\n\n    return validKeys;\n  }\n\n  async getMany<T = any>(keys: string[]): Promise<Map<string, T>> {\n    const result = new Map<string, T>();\n\n    for (const key of keys) {\n      const value = await this.get<T>(key);\n      if (value !== undefined) {\n        result.set(key, value);\n      }\n    }\n\n    return result;\n  }\n\n  async setMany<T = any>(\n    entries: Array<{ key: string; value: T; ttl?: number }>,\n  ): Promise<void> {\n    for (const entry of entries) {\n      await this.set(entry.key, entry.value, entry.ttl);\n    }\n  }\n\n  async deleteMany(keys: string[]): Promise<number> {\n    let deleted = 0;\n\n    for (const key of keys) {\n      const wasDeleted = await this.delete(key);\n      if (wasDeleted) {\n        deleted++;\n      }\n    }\n\n    return deleted;\n  }\n\n  async getStats(): Promise<CacheStats> {\n    // Calculate current cache size\n    let totalSize = 0;\n    let entries = 0;\n\n    for (const entry of this.cache.values()) {\n      if (!isExpired(entry.expiresAt)) {\n        totalSize += entry.size;\n        entries++;\n      }\n    }\n\n    const totalAccesses = this.stats.hits + this.stats.misses;\n    const hitRate = totalAccesses > 0 ? this.stats.hits / totalAccesses : 0;\n\n    return {\n      entries,\n      totalSize,\n      hits: this.stats.hits,\n      misses: this.stats.misses,\n      hitRate,\n      evictions: this.stats.evictions,\n      backend: {\n        type: 'memory',\n        evictionPolicy: this.evictionPolicy,\n        maxSize: this.maxSize,\n        maxEntries: this.maxEntries,\n      },\n    };\n  }\n\n  async touch(key: string, ttl: number): Promise<boolean> {\n    if (!isValidKey(key)) {\n      throw new CacheKeyError(key, 'memory');\n    }\n\n    const fullKey = formatKey(this.namespace, key);\n    const entry = this.cache.get(fullKey);\n\n    if (!entry || isExpired(entry.expiresAt)) {\n      return false;\n    }\n\n    entry.expiresAt = calculateExpiration(ttl);\n    return true;\n  }\n\n  async close(): Promise<void> {\n    // Stop expiration check interval\n    if (this.checkInterval) {\n      clearInterval(this.checkInterval);\n      this.checkInterval = undefined;\n    }\n\n    // Clear cache\n    this.cache.clear();\n  }\n\n  /**\n   * Evicts entries if size or count limits are exceeded\n   */\n  private async evictIfNeeded(newEntrySize: number): Promise<void> {\n    const stats = await this.getStats();\n\n    // Check if we need to evict based on entry count\n    if (stats.entries >= this.maxEntries) {\n      await this.evict(1);\n    }\n\n    // Check if we need to evict based on size\n    while (\n      stats.totalSize + newEntrySize > this.maxSize &&\n      this.cache.size > 0\n    ) {\n      await this.evict(1);\n      const updatedStats = await this.getStats();\n      if (updatedStats.totalSize + newEntrySize <= this.maxSize) {\n        break;\n      }\n    }\n\n    // Final check - if still too large, throw error\n    const finalStats = await this.getStats();\n    if (finalStats.totalSize + newEntrySize > this.maxSize) {\n      throw new CacheSizeError(\n        `Cannot cache entry: would exceed max size of ${this.maxSize} bytes`,\n        'memory',\n      );\n    }\n  }\n\n  /**\n   * Evicts entries based on eviction policy\n   */\n  private async evict(count: number): Promise<void> {\n    if (this.cache.size === 0) {\n      return;\n    }\n\n    const entries = Array.from(this.cache.entries());\n\n    switch (this.evictionPolicy) {\n      case 'lru': {\n        // LRU: Remove oldest (first in map, since we move accessed items to end)\n        for (let i = 0; i < count && i < entries.length; i++) {\n          this.cache.delete(entries[i][0]);\n          this.stats.evictions++;\n        }\n        break;\n      }\n\n      case 'lfu': {\n        // LFU: Remove least frequently used\n        const sorted = entries.sort((a, b) => a[1].hits - b[1].hits);\n        for (let i = 0; i < count && i < sorted.length; i++) {\n          this.cache.delete(sorted[i][0]);\n          this.stats.evictions++;\n        }\n        break;\n      }\n\n      case 'fifo': {\n        // FIFO: Remove oldest by creation time\n        const sorted = entries.sort((a, b) => a[1].createdAt - b[1].createdAt);\n        for (let i = 0; i < count && i < sorted.length; i++) {\n          this.cache.delete(sorted[i][0]);\n          this.stats.evictions++;\n        }\n        break;\n      }\n    }\n  }\n\n  /**\n   * Starts background task to remove expired entries\n   */\n  private startExpirationCheck(): void {\n    this.checkInterval = setInterval(() => {\n      this.removeExpiredEntries();\n    }, this.checkPeriod);\n\n    // Don't block process exit\n    if (this.checkInterval.unref) {\n      this.checkInterval.unref();\n    }\n  }\n\n  /**\n   * Removes all expired entries from the cache\n   */\n  private removeExpiredEntries(): void {\n    const now = Date.now();\n\n    for (const [key, entry] of this.cache.entries()) {\n      if (entry.expiresAt && now >= entry.expiresAt) {\n        this.cache.delete(key);\n      }\n    }\n  }\n}\n"],"names":[],"mappings":"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"}