@happyvertical/cache 0.79.0 → 0.80.1

package/AGENT.md

@@ -7,7 +7,7 @@ Standardized caching interface supporting Memory, File, and Redis backends
 ## Package Map
 - Package: `@happyvertical/cache`
 - Hierarchy path: `@happyvertical/sdk > packages > cache`
-- Workspace position: `5 of 31` local packages
+- Workspace position: `5 of 32` local packages
 - Internal dependencies: `@happyvertical/utils`
 - Internal dependents: `@happyvertical/geo`, `@happyvertical/translator`
 - Knowledge graph files: `AGENT.md`, `metadata.json`, `ecosystem-manifest.json`

package/dist/chunks/file-BiNbZgFQ.js

@@ -0,0 +1,350 @@
+import { CacheError, CacheKeyError, CacheSerializationError, CacheSizeError, calculateExpiration, calculateSize, deserialize, extractKey, formatKey, isExpired, isValidKey, matchesPattern, serialize } from "../index.js";
+import { join, resolve } from "node:path";
+import { mkdir, readFile, readdir, rm, stat, writeFile } from "node:fs/promises";
+import { promisify } from "node:util";
+import { gunzip, gzip } from "node:zlib";
+//#region src/providers/file.ts
+/**
+* File cache provider implementation with compression
+*/
+var gzipAsync = promisify(gzip);
+var gunzipAsync = promisify(gunzip);
+/**
+* File cache provider implementation
+* Stores cache entries as files with optional compression
+*/
+var FileProvider = class {
+	cacheDir;
+	namespace;
+	defaultTTL;
+	maxSize;
+	compression;
+	fileExtension;
+	checkPeriod;
+	checkInterval;
+	stats;
+	constructor(options) {
+		this.cacheDir = resolve(options.cacheDir);
+		this.namespace = options.namespace;
+		this.defaultTTL = options.defaultTTL;
+		this.maxSize = options.maxSize || 500 * 1024 * 1024;
+		this.compression = options.compression ?? false;
+		this.fileExtension = options.fileExtension || ".cache";
+		this.checkPeriod = options.checkPeriod || 3e5;
+		this.stats = {
+			hits: 0,
+			misses: 0,
+			evictions: 0
+		};
+		this.ensureCacheDir();
+		this.startCleanup();
+	}
+	async get(key) {
+		if (!isValidKey(key)) throw new CacheKeyError(key, "file");
+		const fullKey = formatKey(this.namespace, key);
+		const filePath = this.getFilePath(fullKey);
+		try {
+			const fileContent = await readFile(filePath);
+			let data;
+			if (this.compression) data = await gunzipAsync(fileContent);
+			else data = fileContent;
+			const entry = deserialize(data.toString("utf-8"));
+			if (isExpired(entry.expiresAt)) {
+				await rm(filePath, { force: true });
+				this.stats.misses++;
+				return;
+			}
+			entry.hits++;
+			this.stats.hits++;
+			await this.writeEntry(filePath, entry);
+			return entry.value;
+		} catch (error) {
+			if (error.code === "ENOENT") {
+				this.stats.misses++;
+				return;
+			}
+			throw new CacheError(`Failed to read cache entry: ${error.message}`, "READ_ERROR", "file");
+		}
+	}
+	async set(key, value, ttl) {
+		if (!isValidKey(key)) throw new CacheKeyError(key, "file");
+		const fullKey = formatKey(this.namespace, key);
+		const filePath = this.getFilePath(fullKey);
+		const expiresAt = calculateExpiration(ttl ?? this.defaultTTL);
+		const entry = {
+			value,
+			createdAt: Date.now(),
+			expiresAt,
+			size: calculateSize(value),
+			hits: 0,
+			metadata: {
+				compressed: this.compression,
+				namespace: this.namespace
+			}
+		};
+		await this.evictIfNeeded(entry.size);
+		await this.writeEntry(filePath, entry);
+	}
+	async has(key) {
+		if (!isValidKey(key)) throw new CacheKeyError(key, "file");
+		const fullKey = formatKey(this.namespace, key);
+		const filePath = this.getFilePath(fullKey);
+		try {
+			const fileContent = await readFile(filePath);
+			let data;
+			if (this.compression) data = await gunzipAsync(fileContent);
+			else data = fileContent;
+			if (isExpired(deserialize(data.toString("utf-8")).expiresAt)) {
+				await rm(filePath, { force: true });
+				return false;
+			}
+			return true;
+		} catch (error) {
+			if (error.code === "ENOENT") return false;
+			throw new CacheError(`Failed to check cache entry: ${error.message}`, "CHECK_ERROR", "file");
+		}
+	}
+	async delete(key) {
+		if (!isValidKey(key)) throw new CacheKeyError(key, "file");
+		const fullKey = formatKey(this.namespace, key);
+		const filePath = this.getFilePath(fullKey);
+		try {
+			await rm(filePath);
+			return true;
+		} catch (error) {
+			if (error.code === "ENOENT") return false;
+			throw new CacheError(`Failed to delete cache entry: ${error.message}`, "DELETE_ERROR", "file");
+		}
+	}
+	async clear(namespace) {
+		if (namespace) {
+			const prefix = this.sanitizeKey(`${namespace}:`);
+			const files = await this.getAllFiles();
+			for (const file of files) if (file.startsWith(prefix)) await rm(join(this.cacheDir, file), { force: true });
+		} else try {
+			await rm(this.cacheDir, {
+				recursive: true,
+				force: true
+			});
+			await this.ensureCacheDir();
+			this.stats.hits = 0;
+			this.stats.misses = 0;
+			this.stats.evictions = 0;
+		} catch (error) {
+			throw new CacheError(`Failed to clear cache: ${error.message}`, "CLEAR_ERROR", "file");
+		}
+	}
+	async keys(pattern) {
+		const files = await this.getAllFiles();
+		const keys = [];
+		for (const file of files) {
+			const key = file.replace(this.fileExtension, "");
+			const filePath = join(this.cacheDir, file);
+			try {
+				const fileContent = await readFile(filePath);
+				let data;
+				if (this.compression) data = await gunzipAsync(fileContent);
+				else data = fileContent;
+				if (!isExpired(deserialize(data.toString("utf-8")).expiresAt)) {
+					const desanitized = this.desanitizeKey(key);
+					keys.push(extractKey(this.namespace, desanitized));
+				}
+			} catch {}
+		}
+		if (pattern) return keys.filter((key) => matchesPattern(pattern, key));
+		return keys;
+	}
+	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) if (await this.delete(key)) deleted++;
+		return deleted;
+	}
+	async getStats() {
+		const files = await this.getAllFiles();
+		let totalSize = 0;
+		let entries = 0;
+		for (const file of files) {
+			const filePath = join(this.cacheDir, file);
+			try {
+				const stats = await stat(filePath);
+				totalSize += stats.size;
+				const fileContent = await readFile(filePath);
+				let data;
+				if (this.compression) data = await gunzipAsync(fileContent);
+				else data = fileContent;
+				if (!isExpired(deserialize(data.toString("utf-8")).expiresAt)) entries++;
+			} catch {}
+		}
+		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: "file",
+				cacheDir: this.cacheDir,
+				compression: this.compression,
+				maxSize: this.maxSize
+			}
+		};
+	}
+	async touch(key, ttl) {
+		if (!isValidKey(key)) throw new CacheKeyError(key, "file");
+		const fullKey = formatKey(this.namespace, key);
+		const filePath = this.getFilePath(fullKey);
+		try {
+			const fileContent = await readFile(filePath);
+			let data;
+			if (this.compression) data = await gunzipAsync(fileContent);
+			else data = fileContent;
+			const entry = deserialize(data.toString("utf-8"));
+			if (isExpired(entry.expiresAt)) return false;
+			entry.expiresAt = calculateExpiration(ttl);
+			await this.writeEntry(filePath, entry);
+			return true;
+		} catch (error) {
+			if (error.code === "ENOENT") return false;
+			throw new CacheError(`Failed to touch cache entry: ${error.message}`, "TOUCH_ERROR", "file");
+		}
+	}
+	async close() {
+		if (this.checkInterval) {
+			clearInterval(this.checkInterval);
+			this.checkInterval = void 0;
+		}
+	}
+	/**
+	* Ensures cache directory exists
+	*/
+	async ensureCacheDir() {
+		try {
+			await mkdir(this.cacheDir, { recursive: true });
+		} catch (error) {
+			throw new CacheError(`Failed to create cache directory: ${error.message}`, "INIT_ERROR", "file");
+		}
+	}
+	/**
+	* Gets the file path for a cache key
+	*/
+	getFilePath(key) {
+		const sanitizedKey = this.sanitizeKey(key);
+		return join(this.cacheDir, `${sanitizedKey}${this.fileExtension}`);
+	}
+	/**
+	* Sanitizes a key for use as a filename
+	*/
+	sanitizeKey(key) {
+		return key.replace(/[^a-zA-Z0-9_:-]/g, "_");
+	}
+	/**
+	* Desanitizes a filename back to the original key
+	*/
+	desanitizeKey(sanitized) {
+		return sanitized;
+	}
+	/**
+	* Gets all cache file names
+	*/
+	async getAllFiles() {
+		try {
+			return (await readdir(this.cacheDir)).filter((file) => file.endsWith(this.fileExtension));
+		} catch (error) {
+			if (error.code === "ENOENT") return [];
+			throw new CacheError(`Failed to list cache files: ${error.message}`, "LIST_ERROR", "file");
+		}
+	}
+	/**
+	* Writes an entry to a file
+	*/
+	async writeEntry(filePath, entry) {
+		try {
+			let data;
+			const json = serialize(entry);
+			data = Buffer.from(json, "utf-8");
+			if (this.compression) data = await gzipAsync(data);
+			await writeFile(filePath, data);
+		} catch (error) {
+			throw new CacheSerializationError(`Failed to write cache entry: ${error.message}`, "file");
+		}
+	}
+	/**
+	* Evicts files if size limit is exceeded
+	*/
+	async evictIfNeeded(newEntrySize) {
+		if ((await this.getStats()).totalSize + newEntrySize > this.maxSize) {
+			await this.evict();
+			if ((await this.getStats()).totalSize + newEntrySize > this.maxSize) throw new CacheSizeError(`Cannot cache entry: would exceed max size of ${this.maxSize} bytes`, "file");
+		}
+	}
+	/**
+	* Evicts oldest files based on creation time
+	*/
+	async evict() {
+		const files = await this.getAllFiles();
+		const filesWithStats = [];
+		for (const file of files) {
+			const filePath = join(this.cacheDir, file);
+			try {
+				const fileContent = await readFile(filePath);
+				let data;
+				if (this.compression) data = await gunzipAsync(fileContent);
+				else data = fileContent;
+				const entry = deserialize(data.toString("utf-8"));
+				filesWithStats.push({
+					file,
+					createdAt: entry.createdAt
+				});
+			} catch {}
+		}
+		filesWithStats.sort((a, b) => a.createdAt - b.createdAt);
+		const toRemove = Math.max(1, Math.floor(filesWithStats.length * .1));
+		for (let i = 0; i < toRemove; i++) {
+			await rm(join(this.cacheDir, filesWithStats[i].file), { force: true });
+			this.stats.evictions++;
+		}
+	}
+	/**
+	* Starts background cleanup of expired files
+	*/
+	startCleanup() {
+		this.checkInterval = setInterval(() => {
+			this.removeExpiredFiles();
+		}, this.checkPeriod);
+		if (this.checkInterval.unref) this.checkInterval.unref();
+	}
+	/**
+	* Removes expired files
+	*/
+	async removeExpiredFiles() {
+		const files = await this.getAllFiles();
+		for (const file of files) {
+			const filePath = join(this.cacheDir, file);
+			try {
+				const fileContent = await readFile(filePath);
+				let data;
+				if (this.compression) data = await gunzipAsync(fileContent);
+				else data = fileContent;
+				if (isExpired(deserialize(data.toString("utf-8")).expiresAt)) await rm(filePath, { force: true });
+			} catch {}
+		}
+	}
+};
+//#endregion
+export { FileProvider };
+
+//# sourceMappingURL=file-BiNbZgFQ.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file-BiNbZgFQ.js","names":[],"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"],"mappings":"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"}

package/dist/chunks/memory-7jBOw6kZ.js

@@ -0,0 +1,224 @@
+import { CacheKeyError, CacheSizeError, calculateExpiration, calculateSize, extractKey, formatKey, isExpired, isValidKey, matchesPattern } from "../index.js";
+//#region src/providers/memory.ts
+/**
+* Memory cache provider implementation
+* Stores cache entries in memory with LRU eviction
+*/
+var MemoryProvider = class {
+	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;
+		}
+		if (isExpired(entry.expiresAt)) {
+			this.cache.delete(fullKey);
+			this.stats.misses++;
+			return;
+		}
+		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) if (await this.delete(key)) 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);
+			if ((await this.getStats()).totalSize + newEntrySize <= this.maxSize) break;
+		}
+		if ((await this.getStats()).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);
+	}
+};
+//#endregion
+export { MemoryProvider };
+
+//# sourceMappingURL=memory-7jBOw6kZ.js.map

package/dist/chunks/memory-7jBOw6kZ.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-7jBOw6kZ.js","names":[],"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"],"mappings":"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"}