@happyvertical/cache 0.80.0 → 0.80.2

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../src/shared/types.ts","../src/shared/utils.ts","../src/index.ts"],"sourcesContent":["/**\n * Core types and interfaces for the Cache library\n */\n\n/**\n * Standardized cache entry structure (internal use)\n */\nexport interface CacheEntry<T = any> {\n  /**\n   * The cached value\n   */\n  value: T;\n\n  /**\n   * When this entry was created (Unix timestamp in milliseconds)\n   */\n  createdAt: number;\n\n  /**\n   * When this entry will expire (Unix timestamp in milliseconds)\n   * undefined means no expiration\n   */\n  expiresAt?: number;\n\n  /**\n   * Size in bytes (for memory/disk management)\n   */\n  size: number;\n\n  /**\n   * Number of times this entry has been accessed\n   */\n  hits: number;\n\n  /**\n   * Additional metadata\n   */\n  metadata?: {\n    compressed?: boolean;\n    serialized?: boolean;\n    namespace?: string;\n  };\n}\n\n/**\n * Cache statistics\n */\nexport interface CacheStats {\n  /**\n   * Total number of cached entries\n   */\n  entries: number;\n\n  /**\n   * Total size in bytes\n   */\n  totalSize: number;\n\n  /**\n   * Cache hit count\n   */\n  hits: number;\n\n  /**\n   * Cache miss count\n   */\n  misses: number;\n\n  /**\n   * Hit rate (hits / (hits + misses))\n   */\n  hitRate: number;\n\n  /**\n   * Number of evictions (entries removed due to size/TTL)\n   */\n  evictions: number;\n\n  /**\n   * Backend-specific statistics\n   */\n  backend?: {\n    type: 'memory' | 'file' | 'redis' | 's3';\n    [key: string]: any;\n  };\n}\n\n/**\n * Cache provider interface - all providers must implement this\n */\nexport interface CacheProvider {\n  /**\n   * Retrieves a value from the cache by key\n   * @param key - The cache key\n   * @returns Promise resolving to the cached value, or undefined if not found or expired\n   */\n  get<T = any>(key: string): Promise<T | undefined>;\n\n  /**\n   * Stores a value in the cache with an optional time-to-live\n   * @param key - The cache key\n   * @param value - The value to cache\n   * @param ttl - Optional time-to-live in seconds\n   * @returns Promise resolving when the value is cached\n   */\n  set<T = any>(key: string, value: T, ttl?: number): Promise<void>;\n\n  /**\n   * Checks if a key exists in the cache and is not expired\n   * @param key - The cache key\n   * @returns Promise resolving to true if the key exists and is valid\n   */\n  has(key: string): Promise<boolean>;\n\n  /**\n   * Removes a value from the cache\n   * @param key - The cache key\n   * @returns Promise resolving to true if the key was deleted, false if it didn't exist\n   */\n  delete(key: string): Promise<boolean>;\n\n  /**\n   * Clears all entries from the cache, or all entries in a namespace if specified\n   * @param namespace - Optional namespace to clear\n   * @returns Promise resolving when the cache is cleared\n   */\n  clear(namespace?: string): Promise<void>;\n\n  /**\n   * Gets all keys in the cache, optionally filtered by a pattern\n   * @param pattern - Optional glob-style pattern to filter keys\n   * @returns Promise resolving to an array of matching keys\n   */\n  keys(pattern?: string): Promise<string[]>;\n\n  /**\n   * Retrieves multiple values from the cache\n   * @param keys - An array of cache keys\n   * @returns Promise resolving to a map of key-value pairs\n   */\n  getMany<T = any>(keys: string[]): Promise<Map<string, T>>;\n\n  /**\n   * Stores multiple key-value pairs in the cache\n   * @param entries - An array of {key, value, ttl?} objects\n   * @returns Promise resolving when all values are cached\n   */\n  setMany<T = any>(\n    entries: Array<{ key: string; value: T; ttl?: number }>,\n  ): Promise<void>;\n\n  /**\n   * Removes multiple values from the cache\n   * @param keys - An array of cache keys\n   * @returns Promise resolving to the number of keys deleted\n   */\n  deleteMany(keys: string[]): Promise<number>;\n\n  /**\n   * Gets cache statistics\n   * @returns Promise resolving to cache statistics\n   */\n  getStats(): Promise<CacheStats>;\n\n  /**\n   * Updates the TTL for an existing cache entry\n   * @param key - The cache key\n   * @param ttl - New time-to-live in seconds\n   * @returns Promise resolving to true if TTL was updated, false if key doesn't exist\n   */\n  touch(key: string, ttl: number): Promise<boolean>;\n\n  /**\n   * Closes the cache connection/cleanup resources\n   * @returns Promise resolving when cleanup is complete\n   */\n  close(): Promise<void>;\n}\n\n/**\n * Cache adapter interface (structurally identical to CacheProvider)\n */\nexport interface CacheAdapter extends CacheProvider {}\n\n/**\n * Memory cache options\n */\nexport interface MemoryOptions {\n  provider: 'memory';\n  namespace?: string;\n  /** Default time-to-live in seconds for entries without an explicit TTL */\n  defaultTTL?: number;\n  /** Maximum total cache size in bytes (default: 100 MB) */\n  maxSize?: number;\n  /** Maximum number of entries (default: 10 000) */\n  maxEntries?: number;\n  evictionPolicy?: 'lru' | 'lfu' | 'fifo';\n  /** Interval in milliseconds between expired-entry sweeps (default: 60 000) */\n  checkPeriod?: number;\n}\n\n/**\n * File cache options\n */\nexport interface FileOptions {\n  provider: 'file';\n  /** Directory where cache files are stored (required) */\n  cacheDir: string;\n  namespace?: string;\n  /** Default time-to-live in seconds for entries without an explicit TTL */\n  defaultTTL?: number;\n  /** Maximum total cache size in bytes (default: 500 MB) */\n  maxSize?: number;\n  /** Enable gzip compression for stored files (default: false) */\n  compression?: boolean;\n  /** File suffix for cache files (default: '.cache') */\n  fileExtension?: string;\n  /** Interval in milliseconds between expired-file cleanup sweeps (default: 300 000) */\n  checkPeriod?: number;\n}\n\n/**\n * Redis cache options\n */\nexport interface RedisOptions {\n  provider: 'redis';\n  /** Redis server hostname (default: 'localhost') */\n  host?: string;\n  /** Redis server port (default: 6379) */\n  port?: number;\n  password?: string;\n  /** Redis database index 0-15 (default: 0) */\n  db?: number;\n  namespace?: string;\n  /** Alternative to namespace — used as the key prefix */\n  keyPrefix?: string;\n  /** Default time-to-live in seconds for entries without an explicit TTL */\n  defaultTTL?: number;\n  /** Enable gzip compression for values exceeding compressionThreshold (default: false) */\n  enableCompression?: boolean;\n  /** Minimum value size in bytes before compression applies (default: 1024) */\n  compressionThreshold?: number;\n  /** Socket connect timeout in milliseconds (default: 5000) */\n  connectTimeout?: number;\n  /** Per-command timeout in milliseconds */\n  commandTimeout?: number;\n  retryStrategy?: (times: number) => number | null;\n}\n\n/**\n * S3 cache options\n * Use this for CI environments where cache needs to persist between runs\n */\nexport interface S3Options {\n  provider: 's3';\n  /** S3 bucket name (required) */\n  bucket: string;\n  /** Key prefix for cache files (default: 'cache/') */\n  prefix?: string;\n  /** AWS region (default: from AWS_REGION env var or 'us-east-1') */\n  region?: string;\n  /** Optional namespace for key organization */\n  namespace?: string;\n  /** Default TTL in seconds */\n  defaultTTL?: number;\n  /** Enable gzip compression (default: true) */\n  compression?: boolean;\n  /** Only compress if value exceeds this size in bytes (default: 1024) */\n  compressionThreshold?: number;\n}\n\n/**\n * Discriminated union of all cache adapter options\n */\nexport type CacheAdapterOptions =\n  | MemoryOptions\n  | FileOptions\n  | RedisOptions\n  | S3Options;\n\n/**\n * Base cache error class\n */\nexport class CacheError extends Error {\n  constructor(\n    message: string,\n    public code: string,\n    public provider: string,\n  ) {\n    super(message);\n    this.name = 'CacheError';\n  }\n}\n\n/**\n * Invalid cache key error\n */\nexport class CacheKeyError extends CacheError {\n  constructor(\n    public key: string,\n    provider: string,\n  ) {\n    super(`Invalid cache key: ${key}`, 'INVALID_KEY', provider);\n    this.name = 'CacheKeyError';\n  }\n}\n\n/**\n * Cache connection error\n */\nexport class CacheConnectionError extends CacheError {\n  constructor(message: string, provider: string) {\n    super(message, 'CONNECTION_ERROR', provider);\n    this.name = 'CacheConnectionError';\n  }\n}\n\n/**\n * Cache size limit exceeded error\n */\nexport class CacheSizeError extends CacheError {\n  constructor(message: string, provider: string) {\n    super(message, 'SIZE_EXCEEDED', provider);\n    this.name = 'CacheSizeError';\n  }\n}\n\n/**\n * Cache serialization error\n */\nexport class CacheSerializationError extends CacheError {\n  constructor(message: string, provider: string) {\n    super(message, 'SERIALIZATION_ERROR', provider);\n    this.name = 'CacheSerializationError';\n  }\n}\n","/**\n * Utility functions for cache operations\n */\n\n/**\n * Validates a cache key\n * @param key - The cache key to validate\n * @returns True if the key is valid\n */\nexport function isValidKey(key: string): boolean {\n  return typeof key === 'string' && key.length > 0 && key.length <= 250;\n}\n\n/**\n * Calculates the size of a value in bytes (approximate)\n * @param value - The value to measure\n * @returns Size in bytes\n */\nexport function calculateSize(value: any): number {\n  try {\n    const json = JSON.stringify(value);\n    return new Blob([json]).size;\n  } catch {\n    // Fallback to rough estimate if stringify fails\n    return 0;\n  }\n}\n\n/**\n * Checks if a pattern matches a string (glob-style)\n * @param pattern - The glob pattern (supports * wildcard)\n * @param str - The string to test\n * @returns True if the pattern matches\n */\nexport function matchesPattern(pattern: string, str: string): boolean {\n  // Convert glob pattern to regex\n  const regexPattern = pattern\n    .replace(/[.+^${}()|[\\]\\\\]/g, '\\\\$&') // Escape regex special chars\n    .replace(/\\*/g, '.*') // Convert * to .*\n    .replace(/\\?/g, '.'); // Convert ? to .\n\n  const regex = new RegExp(`^${regexPattern}$`);\n  return regex.test(str);\n}\n\n/**\n * Formats a namespace and key into a full key\n * @param namespace - Optional namespace\n * @param key - The cache key\n * @returns Formatted key with namespace prefix if provided\n */\nexport function formatKey(namespace: string | undefined, key: string): string {\n  return namespace ? `${namespace}:${key}` : key;\n}\n\n/**\n * Extracts the original key from a namespaced key\n * @param namespace - Optional namespace\n * @param fullKey - The full key with namespace\n * @returns Original key without namespace\n */\nexport function extractKey(\n  namespace: string | undefined,\n  fullKey: string,\n): string {\n  if (!namespace) {\n    return fullKey;\n  }\n  const prefix = `${namespace}:`;\n  return fullKey.startsWith(prefix) ? fullKey.slice(prefix.length) : fullKey;\n}\n\n/**\n * Checks if an entry has expired\n * @param expiresAt - Expiration timestamp (undefined means no expiration)\n * @returns True if the entry has expired\n */\nexport function isExpired(expiresAt: number | undefined): boolean {\n  if (expiresAt === undefined) {\n    return false;\n  }\n  return Date.now() >= expiresAt;\n}\n\n/**\n * Calculates expiration timestamp from TTL\n * @param ttl - Time-to-live in seconds (undefined means no expiration)\n * @returns Expiration timestamp in milliseconds, or undefined\n */\nexport function calculateExpiration(\n  ttl: number | undefined,\n): number | undefined {\n  if (ttl === undefined || ttl <= 0) {\n    return undefined;\n  }\n  return Date.now() + ttl * 1000;\n}\n\n/**\n * Serializes a value to JSON string\n * @param value - The value to serialize\n * @returns JSON string\n * @throws Error if serialization fails\n */\nexport function serialize(value: any): string {\n  try {\n    return JSON.stringify(value);\n  } catch (error) {\n    throw new Error(\n      `Failed to serialize value: ${error instanceof Error ? error.message : 'Unknown error'}`,\n    );\n  }\n}\n\n/**\n * Deserializes a JSON string to a value\n * @param json - The JSON string\n * @returns Deserialized value\n * @throws Error if deserialization fails\n */\nexport function deserialize<T = any>(json: string): T {\n  try {\n    return JSON.parse(json);\n  } catch (error) {\n    throw new Error(\n      `Failed to deserialize value: ${error instanceof Error ? error.message : 'Unknown error'}`,\n    );\n  }\n}\n","/**\n * Cache package entry point\n * Provides standardized caching interface\n */\n\nimport { loadEnvConfig } from '@happyvertical/utils';\nimport type {\n  CacheAdapter,\n  CacheAdapterOptions,\n  FileOptions,\n  MemoryOptions,\n  RedisOptions,\n  S3Options,\n} from './shared/types';\n\n// Export all types\nexport * from './shared/types';\nexport * from './shared/utils';\n\n/**\n * Type guard for Memory cache options\n */\nfunction isMemoryOptions(\n  options: CacheAdapterOptions,\n): options is MemoryOptions {\n  return options.provider === 'memory';\n}\n\n/**\n * Type guard for File cache options\n */\nfunction isFileOptions(options: CacheAdapterOptions): options is FileOptions {\n  return options.provider === 'file';\n}\n\n/**\n * Type guard for Redis cache options\n */\nfunction isRedisOptions(options: CacheAdapterOptions): options is RedisOptions {\n  return options.provider === 'redis';\n}\n\n/**\n * Type guard for S3 cache options\n */\nfunction isS3Options(options: CacheAdapterOptions): options is S3Options {\n  return options.provider === 's3';\n}\n\n/**\n * Factory function to create a cache adapter instance\n *\n * Supports environment variable configuration using the HAVE_CACHE_* pattern:\n * - HAVE_CACHE_PROVIDER → provider ('memory'|'file'|'redis'|'s3')\n * - HAVE_CACHE_NAMESPACE → namespace (string)\n * - HAVE_CACHE_DEFAULT_TTL → defaultTTL (number: seconds)\n * - HAVE_CACHE_MAX_SIZE → maxSize (number: bytes)\n * - HAVE_CACHE_MAX_ENTRIES → maxEntries (number, memory only)\n * - HAVE_CACHE_EVICTION_POLICY → evictionPolicy ('lru'|'lfu'|'fifo', memory only)\n * - HAVE_CACHE_CACHE_DIR → cacheDir (string, file only)\n * - HAVE_CACHE_COMPRESSION → compression (boolean, file/s3)\n * - HAVE_CACHE_HOST → host (string, redis only)\n * - HAVE_CACHE_PORT → port (number, redis only)\n * - HAVE_CACHE_BUCKET → bucket (string, s3 only)\n * - HAVE_CACHE_PREFIX → prefix (string, s3 only)\n * - HAVE_CACHE_REGION → region (string, s3 only)\n *\n * User-provided options always take precedence over environment variables.\n *\n * @param options - Configuration options for the cache provider\n * @returns Promise resolving to a cache adapter that implements CacheAdapter\n *\n * @example\n * ```typescript\n * // Create memory cache with explicit options\n * const memoryCache = await getCache({\n *   provider: 'memory',\n *   maxSize: 100 * 1024 * 1024,\n *   evictionPolicy: 'lru'\n * });\n *\n * // Create memory cache with environment variables\n * // HAVE_CACHE_PROVIDER=memory\n * // HAVE_CACHE_MAX_SIZE=104857600\n * // HAVE_CACHE_EVICTION_POLICY=lru\n * const envCache = await getCache({ provider: 'memory' });\n *\n * // Create file cache\n * const fileCache = await getCache({\n *   provider: 'file',\n *   cacheDir: './cache',\n *   compression: true\n * });\n *\n * // Create Redis cache\n * const redisCache = await getCache({\n *   provider: 'redis',\n *   host: 'localhost',\n *   port: 6379\n * });\n *\n * // Create S3 cache (for CI persistence)\n * const s3Cache = await getCache({\n *   provider: 's3',\n *   bucket: 'my-cache-bucket',\n *   prefix: 'cache/',\n *   region: 'us-east-1'\n * });\n *\n * // Use the cache\n * await memoryCache.set('user:123', { name: 'John' });\n * const user = await memoryCache.get('user:123');\n * ```\n */\nexport async function getCache(\n  options: CacheAdapterOptions,\n): Promise<CacheAdapter> {\n  // Load configuration from environment variables, merging with user options\n  // User options always take precedence\n  // Use 'any' to work around TypeScript's discriminated union type checking\n  const config = loadEnvConfig(options as any, {\n    packageName: 'cache',\n    schema: {\n      provider: 'string',\n      namespace: 'string',\n      defaultTTL: 'number',\n      maxSize: 'number',\n      maxEntries: 'number',\n      evictionPolicy: 'string',\n      checkPeriod: 'number',\n      cacheDir: 'string',\n      compression: 'boolean',\n      fileExtension: 'string',\n      host: 'string',\n      port: 'number',\n      password: 'string',\n      db: 'number',\n      keyPrefix: 'string',\n      enableCompression: 'boolean',\n      compressionThreshold: 'number',\n      connectTimeout: 'number',\n      commandTimeout: 'number',\n      // S3 options\n      bucket: 'string',\n      prefix: 'string',\n      region: 'string',\n    } as any,\n    allowUnknown: false,\n  }) as CacheAdapterOptions;\n\n  if (isMemoryOptions(config)) {\n    const { MemoryProvider } = await import('./providers/memory.js');\n    return new MemoryProvider(config);\n  }\n\n  if (isFileOptions(config)) {\n    const { FileProvider } = await import('./providers/file.js');\n    return new FileProvider(config);\n  }\n\n  if (isRedisOptions(config)) {\n    const { RedisProvider } = await import('./providers/redis.js');\n    return new RedisProvider(config);\n  }\n\n  if (isS3Options(config)) {\n    const { S3Provider } = await import('./providers/s3.js');\n    return new S3Provider(config);\n  }\n\n  // This should never happen due to TypeScript's discriminated union\n  throw new Error(`Unsupported provider: ${(config as any).provider}`);\n}\n\n/** @internal */\nexport const PACKAGE_VERSION_INITIALIZED = true;\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/shared/types.ts","../src/shared/utils.ts","../src/index.ts"],"sourcesContent":["/**\n * Core types and interfaces for the Cache library\n */\n\n/**\n * Standardized cache entry structure (internal use)\n */\nexport interface CacheEntry<T = any> {\n  /**\n   * The cached value\n   */\n  value: T;\n\n  /**\n   * When this entry was created (Unix timestamp in milliseconds)\n   */\n  createdAt: number;\n\n  /**\n   * When this entry will expire (Unix timestamp in milliseconds)\n   * undefined means no expiration\n   */\n  expiresAt?: number;\n\n  /**\n   * Size in bytes (for memory/disk management)\n   */\n  size: number;\n\n  /**\n   * Number of times this entry has been accessed\n   */\n  hits: number;\n\n  /**\n   * Additional metadata\n   */\n  metadata?: {\n    compressed?: boolean;\n    serialized?: boolean;\n    namespace?: string;\n  };\n}\n\n/**\n * Cache statistics\n */\nexport interface CacheStats {\n  /**\n   * Total number of cached entries\n   */\n  entries: number;\n\n  /**\n   * Total size in bytes\n   */\n  totalSize: number;\n\n  /**\n   * Cache hit count\n   */\n  hits: number;\n\n  /**\n   * Cache miss count\n   */\n  misses: number;\n\n  /**\n   * Hit rate (hits / (hits + misses))\n   */\n  hitRate: number;\n\n  /**\n   * Number of evictions (entries removed due to size/TTL)\n   */\n  evictions: number;\n\n  /**\n   * Backend-specific statistics\n   */\n  backend?: {\n    type: 'memory' | 'file' | 'redis' | 's3';\n    [key: string]: any;\n  };\n}\n\n/**\n * Cache provider interface - all providers must implement this\n */\nexport interface CacheProvider {\n  /**\n   * Retrieves a value from the cache by key\n   * @param key - The cache key\n   * @returns Promise resolving to the cached value, or undefined if not found or expired\n   */\n  get<T = any>(key: string): Promise<T | undefined>;\n\n  /**\n   * Stores a value in the cache with an optional time-to-live\n   * @param key - The cache key\n   * @param value - The value to cache\n   * @param ttl - Optional time-to-live in seconds\n   * @returns Promise resolving when the value is cached\n   */\n  set<T = any>(key: string, value: T, ttl?: number): Promise<void>;\n\n  /**\n   * Checks if a key exists in the cache and is not expired\n   * @param key - The cache key\n   * @returns Promise resolving to true if the key exists and is valid\n   */\n  has(key: string): Promise<boolean>;\n\n  /**\n   * Removes a value from the cache\n   * @param key - The cache key\n   * @returns Promise resolving to true if the key was deleted, false if it didn't exist\n   */\n  delete(key: string): Promise<boolean>;\n\n  /**\n   * Clears all entries from the cache, or all entries in a namespace if specified\n   * @param namespace - Optional namespace to clear\n   * @returns Promise resolving when the cache is cleared\n   */\n  clear(namespace?: string): Promise<void>;\n\n  /**\n   * Gets all keys in the cache, optionally filtered by a pattern\n   * @param pattern - Optional glob-style pattern to filter keys\n   * @returns Promise resolving to an array of matching keys\n   */\n  keys(pattern?: string): Promise<string[]>;\n\n  /**\n   * Retrieves multiple values from the cache\n   * @param keys - An array of cache keys\n   * @returns Promise resolving to a map of key-value pairs\n   */\n  getMany<T = any>(keys: string[]): Promise<Map<string, T>>;\n\n  /**\n   * Stores multiple key-value pairs in the cache\n   * @param entries - An array of {key, value, ttl?} objects\n   * @returns Promise resolving when all values are cached\n   */\n  setMany<T = any>(\n    entries: Array<{ key: string; value: T; ttl?: number }>,\n  ): Promise<void>;\n\n  /**\n   * Removes multiple values from the cache\n   * @param keys - An array of cache keys\n   * @returns Promise resolving to the number of keys deleted\n   */\n  deleteMany(keys: string[]): Promise<number>;\n\n  /**\n   * Gets cache statistics\n   * @returns Promise resolving to cache statistics\n   */\n  getStats(): Promise<CacheStats>;\n\n  /**\n   * Updates the TTL for an existing cache entry\n   * @param key - The cache key\n   * @param ttl - New time-to-live in seconds\n   * @returns Promise resolving to true if TTL was updated, false if key doesn't exist\n   */\n  touch(key: string, ttl: number): Promise<boolean>;\n\n  /**\n   * Closes the cache connection/cleanup resources\n   * @returns Promise resolving when cleanup is complete\n   */\n  close(): Promise<void>;\n}\n\n/**\n * Cache adapter interface (structurally identical to CacheProvider)\n */\nexport interface CacheAdapter extends CacheProvider {}\n\n/**\n * Memory cache options\n */\nexport interface MemoryOptions {\n  provider: 'memory';\n  namespace?: string;\n  /** Default time-to-live in seconds for entries without an explicit TTL */\n  defaultTTL?: number;\n  /** Maximum total cache size in bytes (default: 100 MB) */\n  maxSize?: number;\n  /** Maximum number of entries (default: 10 000) */\n  maxEntries?: number;\n  evictionPolicy?: 'lru' | 'lfu' | 'fifo';\n  /** Interval in milliseconds between expired-entry sweeps (default: 60 000) */\n  checkPeriod?: number;\n}\n\n/**\n * File cache options\n */\nexport interface FileOptions {\n  provider: 'file';\n  /** Directory where cache files are stored (required) */\n  cacheDir: string;\n  namespace?: string;\n  /** Default time-to-live in seconds for entries without an explicit TTL */\n  defaultTTL?: number;\n  /** Maximum total cache size in bytes (default: 500 MB) */\n  maxSize?: number;\n  /** Enable gzip compression for stored files (default: false) */\n  compression?: boolean;\n  /** File suffix for cache files (default: '.cache') */\n  fileExtension?: string;\n  /** Interval in milliseconds between expired-file cleanup sweeps (default: 300 000) */\n  checkPeriod?: number;\n}\n\n/**\n * Redis cache options\n */\nexport interface RedisOptions {\n  provider: 'redis';\n  /** Redis server hostname (default: 'localhost') */\n  host?: string;\n  /** Redis server port (default: 6379) */\n  port?: number;\n  password?: string;\n  /** Redis database index 0-15 (default: 0) */\n  db?: number;\n  namespace?: string;\n  /** Alternative to namespace — used as the key prefix */\n  keyPrefix?: string;\n  /** Default time-to-live in seconds for entries without an explicit TTL */\n  defaultTTL?: number;\n  /** Enable gzip compression for values exceeding compressionThreshold (default: false) */\n  enableCompression?: boolean;\n  /** Minimum value size in bytes before compression applies (default: 1024) */\n  compressionThreshold?: number;\n  /** Socket connect timeout in milliseconds (default: 5000) */\n  connectTimeout?: number;\n  /** Per-command timeout in milliseconds */\n  commandTimeout?: number;\n  retryStrategy?: (times: number) => number | null;\n}\n\n/**\n * S3 cache options\n * Use this for CI environments where cache needs to persist between runs\n */\nexport interface S3Options {\n  provider: 's3';\n  /** S3 bucket name (required) */\n  bucket: string;\n  /** Key prefix for cache files (default: 'cache/') */\n  prefix?: string;\n  /** AWS region (default: from AWS_REGION env var or 'us-east-1') */\n  region?: string;\n  /** Optional namespace for key organization */\n  namespace?: string;\n  /** Default TTL in seconds */\n  defaultTTL?: number;\n  /** Enable gzip compression (default: true) */\n  compression?: boolean;\n  /** Only compress if value exceeds this size in bytes (default: 1024) */\n  compressionThreshold?: number;\n}\n\n/**\n * Discriminated union of all cache adapter options\n */\nexport type CacheAdapterOptions =\n  | MemoryOptions\n  | FileOptions\n  | RedisOptions\n  | S3Options;\n\n/**\n * Base cache error class\n */\nexport class CacheError extends Error {\n  constructor(\n    message: string,\n    public code: string,\n    public provider: string,\n  ) {\n    super(message);\n    this.name = 'CacheError';\n  }\n}\n\n/**\n * Invalid cache key error\n */\nexport class CacheKeyError extends CacheError {\n  constructor(\n    public key: string,\n    provider: string,\n  ) {\n    super(`Invalid cache key: ${key}`, 'INVALID_KEY', provider);\n    this.name = 'CacheKeyError';\n  }\n}\n\n/**\n * Cache connection error\n */\nexport class CacheConnectionError extends CacheError {\n  constructor(message: string, provider: string) {\n    super(message, 'CONNECTION_ERROR', provider);\n    this.name = 'CacheConnectionError';\n  }\n}\n\n/**\n * Cache size limit exceeded error\n */\nexport class CacheSizeError extends CacheError {\n  constructor(message: string, provider: string) {\n    super(message, 'SIZE_EXCEEDED', provider);\n    this.name = 'CacheSizeError';\n  }\n}\n\n/**\n * Cache serialization error\n */\nexport class CacheSerializationError extends CacheError {\n  constructor(message: string, provider: string) {\n    super(message, 'SERIALIZATION_ERROR', provider);\n    this.name = 'CacheSerializationError';\n  }\n}\n","/**\n * Utility functions for cache operations\n */\n\n/**\n * Validates a cache key\n * @param key - The cache key to validate\n * @returns True if the key is valid\n */\nexport function isValidKey(key: string): boolean {\n  return typeof key === 'string' && key.length > 0 && key.length <= 250;\n}\n\n/**\n * Calculates the size of a value in bytes (approximate)\n * @param value - The value to measure\n * @returns Size in bytes\n */\nexport function calculateSize(value: any): number {\n  try {\n    const json = JSON.stringify(value);\n    return new Blob([json]).size;\n  } catch {\n    // Fallback to rough estimate if stringify fails\n    return 0;\n  }\n}\n\n/**\n * Checks if a pattern matches a string (glob-style)\n * @param pattern - The glob pattern (supports * wildcard)\n * @param str - The string to test\n * @returns True if the pattern matches\n */\nexport function matchesPattern(pattern: string, str: string): boolean {\n  // Convert glob pattern to regex\n  const regexPattern = pattern\n    .replace(/[.+^${}()|[\\]\\\\]/g, '\\\\$&') // Escape regex special chars\n    .replace(/\\*/g, '.*') // Convert * to .*\n    .replace(/\\?/g, '.'); // Convert ? to .\n\n  const regex = new RegExp(`^${regexPattern}$`);\n  return regex.test(str);\n}\n\n/**\n * Formats a namespace and key into a full key\n * @param namespace - Optional namespace\n * @param key - The cache key\n * @returns Formatted key with namespace prefix if provided\n */\nexport function formatKey(namespace: string | undefined, key: string): string {\n  return namespace ? `${namespace}:${key}` : key;\n}\n\n/**\n * Extracts the original key from a namespaced key\n * @param namespace - Optional namespace\n * @param fullKey - The full key with namespace\n * @returns Original key without namespace\n */\nexport function extractKey(\n  namespace: string | undefined,\n  fullKey: string,\n): string {\n  if (!namespace) {\n    return fullKey;\n  }\n  const prefix = `${namespace}:`;\n  return fullKey.startsWith(prefix) ? fullKey.slice(prefix.length) : fullKey;\n}\n\n/**\n * Checks if an entry has expired\n * @param expiresAt - Expiration timestamp (undefined means no expiration)\n * @returns True if the entry has expired\n */\nexport function isExpired(expiresAt: number | undefined): boolean {\n  if (expiresAt === undefined) {\n    return false;\n  }\n  return Date.now() >= expiresAt;\n}\n\n/**\n * Calculates expiration timestamp from TTL\n * @param ttl - Time-to-live in seconds (undefined means no expiration)\n * @returns Expiration timestamp in milliseconds, or undefined\n */\nexport function calculateExpiration(\n  ttl: number | undefined,\n): number | undefined {\n  if (ttl === undefined || ttl <= 0) {\n    return undefined;\n  }\n  return Date.now() + ttl * 1000;\n}\n\n/**\n * Serializes a value to JSON string\n * @param value - The value to serialize\n * @returns JSON string\n * @throws Error if serialization fails\n */\nexport function serialize(value: any): string {\n  try {\n    return JSON.stringify(value);\n  } catch (error) {\n    throw new Error(\n      `Failed to serialize value: ${error instanceof Error ? error.message : 'Unknown error'}`,\n    );\n  }\n}\n\n/**\n * Deserializes a JSON string to a value\n * @param json - The JSON string\n * @returns Deserialized value\n * @throws Error if deserialization fails\n */\nexport function deserialize<T = any>(json: string): T {\n  try {\n    return JSON.parse(json);\n  } catch (error) {\n    throw new Error(\n      `Failed to deserialize value: ${error instanceof Error ? error.message : 'Unknown error'}`,\n    );\n  }\n}\n","/**\n * Cache package entry point\n * Provides standardized caching interface\n */\n\nimport { loadEnvConfig } from '@happyvertical/utils';\nimport type {\n  CacheAdapter,\n  CacheAdapterOptions,\n  FileOptions,\n  MemoryOptions,\n  RedisOptions,\n  S3Options,\n} from './shared/types';\n\n// Export all types\nexport * from './shared/types';\nexport * from './shared/utils';\n\n/**\n * Type guard for Memory cache options\n */\nfunction isMemoryOptions(\n  options: CacheAdapterOptions,\n): options is MemoryOptions {\n  return options.provider === 'memory';\n}\n\n/**\n * Type guard for File cache options\n */\nfunction isFileOptions(options: CacheAdapterOptions): options is FileOptions {\n  return options.provider === 'file';\n}\n\n/**\n * Type guard for Redis cache options\n */\nfunction isRedisOptions(options: CacheAdapterOptions): options is RedisOptions {\n  return options.provider === 'redis';\n}\n\n/**\n * Type guard for S3 cache options\n */\nfunction isS3Options(options: CacheAdapterOptions): options is S3Options {\n  return options.provider === 's3';\n}\n\n/**\n * Factory function to create a cache adapter instance\n *\n * Supports environment variable configuration using the HAVE_CACHE_* pattern:\n * - HAVE_CACHE_PROVIDER → provider ('memory'|'file'|'redis'|'s3')\n * - HAVE_CACHE_NAMESPACE → namespace (string)\n * - HAVE_CACHE_DEFAULT_TTL → defaultTTL (number: seconds)\n * - HAVE_CACHE_MAX_SIZE → maxSize (number: bytes)\n * - HAVE_CACHE_MAX_ENTRIES → maxEntries (number, memory only)\n * - HAVE_CACHE_EVICTION_POLICY → evictionPolicy ('lru'|'lfu'|'fifo', memory only)\n * - HAVE_CACHE_CACHE_DIR → cacheDir (string, file only)\n * - HAVE_CACHE_COMPRESSION → compression (boolean, file/s3)\n * - HAVE_CACHE_HOST → host (string, redis only)\n * - HAVE_CACHE_PORT → port (number, redis only)\n * - HAVE_CACHE_BUCKET → bucket (string, s3 only)\n * - HAVE_CACHE_PREFIX → prefix (string, s3 only)\n * - HAVE_CACHE_REGION → region (string, s3 only)\n *\n * User-provided options always take precedence over environment variables.\n *\n * @param options - Configuration options for the cache provider\n * @returns Promise resolving to a cache adapter that implements CacheAdapter\n *\n * @example\n * ```typescript\n * // Create memory cache with explicit options\n * const memoryCache = await getCache({\n *   provider: 'memory',\n *   maxSize: 100 * 1024 * 1024,\n *   evictionPolicy: 'lru'\n * });\n *\n * // Create memory cache with environment variables\n * // HAVE_CACHE_PROVIDER=memory\n * // HAVE_CACHE_MAX_SIZE=104857600\n * // HAVE_CACHE_EVICTION_POLICY=lru\n * const envCache = await getCache({ provider: 'memory' });\n *\n * // Create file cache\n * const fileCache = await getCache({\n *   provider: 'file',\n *   cacheDir: './cache',\n *   compression: true\n * });\n *\n * // Create Redis cache\n * const redisCache = await getCache({\n *   provider: 'redis',\n *   host: 'localhost',\n *   port: 6379\n * });\n *\n * // Create S3 cache (for CI persistence)\n * const s3Cache = await getCache({\n *   provider: 's3',\n *   bucket: 'my-cache-bucket',\n *   prefix: 'cache/',\n *   region: 'us-east-1'\n * });\n *\n * // Use the cache\n * await memoryCache.set('user:123', { name: 'John' });\n * const user = await memoryCache.get('user:123');\n * ```\n */\nexport async function getCache(\n  options: CacheAdapterOptions,\n): Promise<CacheAdapter> {\n  // Load configuration from environment variables, merging with user options\n  // User options always take precedence\n  // Use 'any' to work around TypeScript's discriminated union type checking\n  const config = loadEnvConfig(options as any, {\n    packageName: 'cache',\n    schema: {\n      provider: 'string',\n      namespace: 'string',\n      defaultTTL: 'number',\n      maxSize: 'number',\n      maxEntries: 'number',\n      evictionPolicy: 'string',\n      checkPeriod: 'number',\n      cacheDir: 'string',\n      compression: 'boolean',\n      fileExtension: 'string',\n      host: 'string',\n      port: 'number',\n      password: 'string',\n      db: 'number',\n      keyPrefix: 'string',\n      enableCompression: 'boolean',\n      compressionThreshold: 'number',\n      connectTimeout: 'number',\n      commandTimeout: 'number',\n      // S3 options\n      bucket: 'string',\n      prefix: 'string',\n      region: 'string',\n    } as any,\n    allowUnknown: false,\n  }) as CacheAdapterOptions;\n\n  if (isMemoryOptions(config)) {\n    const { MemoryProvider } = await import('./providers/memory.js');\n    return new MemoryProvider(config);\n  }\n\n  if (isFileOptions(config)) {\n    const { FileProvider } = await import('./providers/file.js');\n    return new FileProvider(config);\n  }\n\n  if (isRedisOptions(config)) {\n    const { RedisProvider } = await import('./providers/redis.js');\n    return new RedisProvider(config);\n  }\n\n  if (isS3Options(config)) {\n    const { S3Provider } = await import('./providers/s3.js');\n    return new S3Provider(config);\n  }\n\n  // This should never happen due to TypeScript's discriminated union\n  throw new Error(`Unsupported provider: ${(config as any).provider}`);\n}\n\n/** @internal */\nexport const PACKAGE_VERSION_INITIALIZED = true;\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@happyvertical/cache",
-  "version": "0.80.0",
+  "version": "0.80.2",
   "description": "Standardized caching interface supporting Memory, File, and Redis backends",
   "type": "module",
   "main": "./dist/index.js",
@@ -50,14 +50,14 @@
     "@aws-sdk/client-s3": "3.1034.0",
     "@aws-sdk/credential-providers": "3.1034.0",
     "redis": "^5.12.1",
-    "@happyvertical/utils": "0.80.0"
+    "@happyvertical/utils": "0.80.2"
   },
   "devDependencies": {
     "@types/node": "25.0.10",
-    "typescript": "^5.9.3",
-    "vite": "7.3.2",
+    "typescript": "5.9.3",
+    "vite": "8.1.4",
     "vite-plugin-dts": "4.5.4",
-    "vitest": "^4.1.5"
+    "vitest": "4.1.10"
   },
   "scripts": {
     "test": "vitest --config ../../vitest.package.config.ts run",

package/dist/chunks/file-DyC_7WDS.js

@@ -1,450 +0,0 @@
-import { readFile, rm, stat, mkdir, readdir, writeFile } from "node:fs/promises";
-import { resolve, join } from "node:path";
-import { promisify } from "node:util";
-import { gunzip, gzip } from "node:zlib";
-import { isValidKey, CacheKeyError, formatKey, deserialize, isExpired, CacheError, calculateExpiration, calculateSize, extractKey, matchesPattern, serialize, CacheSerializationError, CacheSizeError } from "../index.js";
-const gzipAsync = promisify(gzip);
-const gunzipAsync = promisify(gunzip);
-class FileProvider {
-  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 void 0;
-      }
-      entry.hits++;
-      this.stats.hits++;
-      await this.writeEntry(filePath, entry);
-      return entry.value;
-    } catch (error) {
-      if (error.code === "ENOENT") {
-        this.stats.misses++;
-        return void 0;
-      }
-      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;
-      }
-      const entry = deserialize(data.toString("utf-8"));
-      if (isExpired(entry.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;
-        }
-        const entry = deserialize(data.toString("utf-8"));
-        if (!isExpired(entry.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) {
-      const wasDeleted = await this.delete(key);
-      if (wasDeleted) {
-        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;
-        }
-        const entry = deserialize(data.toString("utf-8"));
-        if (!isExpired(entry.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 {
-      const files = await readdir(this.cacheDir);
-      return files.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) {
-    const stats = await this.getStats();
-    if (stats.totalSize + newEntrySize > this.maxSize) {
-      await this.evict();
-      const updatedStats = await this.getStats();
-      if (updatedStats.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 * 0.1));
-    for (let i = 0; i < toRemove; i++) {
-      const filePath = join(this.cacheDir, filesWithStats[i].file);
-      await rm(filePath, { 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;
-        }
-        const entry = deserialize(data.toString("utf-8"));
-        if (isExpired(entry.expiresAt)) {
-          await rm(filePath, { force: true });
-        }
-      } catch {
-      }
-    }
-  }
-}
-export {
-  FileProvider
-};
-//# sourceMappingURL=file-DyC_7WDS.js.map

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

@@ -1 +0,0 @@
-{"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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"}