toonify-mcp 0.3.1 → 0.4.0

package/README.md

@@ -18,6 +18,7 @@ Reduces Claude API token usage by **30-65% depending on data structure** through
 
 - **30-65% Token Reduction** (typically 50-55%) for JSON, CSV, YAML data
 - **Multilingual Support** - Accurate token counting for 15+ languages
+- **Enhanced Caching** - LRU cache with TTL expiration and optional disk persistence
 - **Fully Automatic** - PostToolUse hook intercepts tool results
 - **Zero Configuration** - Works out of the box with sensible defaults
 - **Dual Mode** - Works as Plugin (auto) or MCP Server (manual)
@@ -167,6 +168,30 @@ claude mcp call toonify get_stats '{}'
 # Or check Claude Code output for stats (if TOONIFY_SHOW_STATS=true)
 ```
 
+### Cache Management
+
+Toonify v0.4.0+ includes an enhanced LRU cache with TTL expiration:
+
+```bash
+# Get cache statistics
+claude mcp call toonify get_cache_stats '{}'
+
+# Clear all cached results
+claude mcp call toonify clear_cache '{}'
+
+# Clean up expired entries
+claude mcp call toonify cleanup_expired_cache '{}'
+```
+
+**Cache benefits:**
+- ✅ **50-500x faster** on cache hits (0.1ms vs 5-50ms)
+- ✅ Avoids re-optimizing identical content
+- ✅ Optional disk persistence for cross-session reuse
+- ✅ Automatic LRU eviction when full
+- ✅ TTL expiration (default: 1 hour)
+
+See [docs/CACHE.md](docs/CACHE.md) for detailed cache documentation.
+
 ## Troubleshooting
 
 ### Hook Not Triggering
@@ -241,6 +266,11 @@ Contributions welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guideli
 
 MIT License - see [LICENSE](LICENSE)
 
+---
+
+🇹🇼 **Crafted in Taiwan** | 台灣製造
+_Where innovation meets tradition_
+
 ## Changelog
 
 ### v0.3.0 (2025-12-26)

package/dist/optimizer/caching/cache-types.d.ts

@@ -33,4 +33,38 @@ export interface CacheStrategy {
     shouldCache: (content: string, tokens: number) => boolean;
     formatCacheStructure: (content: CachedContent) => any;
 }
+/**
+ * LRU Cache Configuration
+ */
+export interface LRUCacheConfig {
+    enabled: boolean;
+    maxSize: number;
+    ttl: number;
+    persistent: boolean;
+    persistPath?: string;
+}
+/**
+ * LRU Cache Entry
+ */
+export interface LRUCacheEntry<T> {
+    key: string;
+    value: T;
+    timestamp: number;
+    lastAccessed: number;
+    accessCount: number;
+    expiresAt: number;
+}
+/**
+ * LRU Cache Statistics
+ */
+export interface LRUCacheStats {
+    hits: number;
+    misses: number;
+    evictions: number;
+    expirations: number;
+    currentSize: number;
+    maxSize: number;
+    hitRate: number;
+    averageAccessCount: number;
+}
 //# sourceMappingURL=cache-types.d.ts.map

package/dist/optimizer/caching/cache-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cache-types.d.ts","sourceRoot":"","sources":["../../../src/optimizer/caching/cache-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,WAAW,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC1C,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,OAAO,CAAC;IACzB,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,WAAW,GAAG,QAAQ,CAAC;IACjC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,sBAAsB,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;IAC1D,oBAAoB,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,GAAG,CAAC;CACvD"}
+{"version":3,"file":"cache-types.d.ts","sourceRoot":"","sources":["../../../src/optimizer/caching/cache-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,WAAW,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC1C,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,OAAO,CAAC;IACzB,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,WAAW,GAAG,QAAQ,CAAC;IACjC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,sBAAsB,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;IAC1D,oBAAoB,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,GAAG,CAAC;CACvD;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,CAAC,CAAC;IACT,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB,EAAE,MAAM,CAAC;CAC5B"}

package/dist/optimizer/caching/index.d.ts

@@ -4,4 +4,6 @@
 export * from './cache-types.js';
 export * from './cache-strategies.js';
 export { CacheOptimizer } from './cache-optimizer.js';
+export { LRUCache } from './lru-cache.js';
+export { PersistentCache } from './persistent-cache.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/optimizer/caching/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/optimizer/caching/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/optimizer/caching/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/optimizer/caching/index.js

@@ -4,4 +4,6 @@
 export * from './cache-types.js';
 export * from './cache-strategies.js';
 export { CacheOptimizer } from './cache-optimizer.js';
+export { LRUCache } from './lru-cache.js';
+export { PersistentCache } from './persistent-cache.js';
 //# sourceMappingURL=index.js.map

package/dist/optimizer/caching/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/optimizer/caching/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/optimizer/caching/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/optimizer/caching/lru-cache.d.ts

@@ -0,0 +1,70 @@
+/**
+ * LRU Cache with TTL (Time-to-Live) support
+ * Features:
+ * - Least Recently Used eviction strategy
+ * - TTL-based expiration
+ * - Optional disk persistence
+ */
+import type { LRUCacheConfig, LRUCacheStats } from './cache-types.js';
+export declare class LRUCache<T = any> {
+    private cache;
+    private config;
+    private stats;
+    private persistentCache?;
+    private totalAccessCount;
+    constructor(config?: Partial<LRUCacheConfig>);
+    /**
+     * Generate cache key from content using SHA-256
+     */
+    static generateKey(content: string): string;
+    /**
+     * Get value from cache
+     */
+    get(key: string): T | undefined;
+    /**
+     * Set value in cache
+     */
+    set(key: string, value: T): void;
+    /**
+     * Check if entry has expired
+     */
+    private isExpired;
+    /**
+     * Evict least recently used entry
+     * Since Map maintains insertion order, the first entry is the least recently used
+     */
+    private evictLRU;
+    /**
+     * Clear all cache entries
+     */
+    clear(): void;
+    /**
+     * Clean up expired entries
+     */
+    cleanup(): number;
+    /**
+     * Get cache statistics
+     */
+    getStats(): LRUCacheStats;
+    /**
+     * Update hit rate and average access count (O(1) complexity)
+     */
+    private updateStats;
+    /**
+     * Load cache from disk
+     */
+    private loadFromDisk;
+    /**
+     * Force save all entries to disk and wait for completion
+     */
+    saveToDisk(): Promise<void>;
+    /**
+     * Get cache size
+     */
+    size(): number;
+    /**
+     * Check if key exists (without updating access time)
+     */
+    has(key: string): boolean;
+}
+//# sourceMappingURL=lru-cache.d.ts.map

package/dist/optimizer/caching/lru-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lru-cache.d.ts","sourceRoot":"","sources":["../../../src/optimizer/caching/lru-cache.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAiB,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGrF,qBAAa,QAAQ,CAAC,CAAC,GAAG,GAAG;IAC3B,OAAO,CAAC,KAAK,CAAgC;IAC7C,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,eAAe,CAAC,CAAqB;IAC7C,OAAO,CAAC,gBAAgB,CAAa;gBAEzB,MAAM,GAAE,OAAO,CAAC,cAAc,CAAM;IA6BhD;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAI3C;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAsC/B;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IA8BhC;;OAEG;IACH,OAAO,CAAC,SAAS;IAIjB;;;OAGG;IACH,OAAO,CAAC,QAAQ;IAqBhB;;OAEG;IACH,KAAK,IAAI,IAAI;IAUb;;OAEG;IACH,OAAO,IAAI,MAAM;IAqBjB;;OAEG;IACH,QAAQ,IAAI,aAAa;IAIzB;;OAEG;IACH,OAAO,CAAC,WAAW;IAQnB;;OAEG;IACH,OAAO,CAAC,YAAY;IAsBpB;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAWjC;;OAEG;IACH,IAAI,IAAI,MAAM;IAId;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;CAO1B"}

package/dist/optimizer/caching/lru-cache.js

@@ -0,0 +1,230 @@
+/**
+ * LRU Cache with TTL (Time-to-Live) support
+ * Features:
+ * - Least Recently Used eviction strategy
+ * - TTL-based expiration
+ * - Optional disk persistence
+ */
+import crypto from 'crypto';
+import { PersistentCache } from './persistent-cache.js';
+export class LRUCache {
+    cache;
+    config;
+    stats;
+    persistentCache;
+    totalAccessCount = 0; // Running total for O(1) average calculation
+    constructor(config = {}) {
+        this.config = {
+            enabled: true,
+            maxSize: 500,
+            ttl: 3600000, // 1 hour in milliseconds
+            persistent: false,
+            persistPath: '~/.toonify-mcp/cache/optimization-cache.json',
+            ...config
+        };
+        this.cache = new Map();
+        this.stats = {
+            hits: 0,
+            misses: 0,
+            evictions: 0,
+            expirations: 0,
+            currentSize: 0,
+            maxSize: this.config.maxSize,
+            hitRate: 0,
+            averageAccessCount: 0
+        };
+        // Initialize persistent cache if enabled
+        if (this.config.persistent && this.config.persistPath) {
+            this.persistentCache = new PersistentCache(this.config.persistPath);
+            this.loadFromDisk();
+        }
+    }
+    /**
+     * Generate cache key from content using SHA-256
+     */
+    static generateKey(content) {
+        return crypto.createHash('sha256').update(content).digest('hex');
+    }
+    /**
+     * Get value from cache
+     */
+    get(key) {
+        if (!this.config.enabled) {
+            return undefined;
+        }
+        const entry = this.cache.get(key);
+        if (!entry) {
+            this.stats.misses++;
+            this.updateStats();
+            return undefined;
+        }
+        // Check if expired
+        if (this.isExpired(entry)) {
+            this.totalAccessCount -= entry.accessCount; // Update running total
+            this.cache.delete(key);
+            this.stats.expirations++;
+            this.stats.misses++;
+            this.updateStats();
+            return undefined;
+        }
+        // Update access metadata (LRU)
+        entry.lastAccessed = Date.now();
+        entry.accessCount++;
+        this.totalAccessCount++; // Update running total
+        // Delete and re-insert to move to end (most recently used in Map)
+        this.cache.delete(key);
+        this.cache.set(key, entry);
+        this.stats.hits++;
+        this.updateStats();
+        return entry.value;
+    }
+    /**
+     * Set value in cache
+     */
+    set(key, value) {
+        if (!this.config.enabled) {
+            return;
+        }
+        const now = Date.now();
+        // Check if we need to evict (LRU)
+        if (this.cache.size >= this.config.maxSize && !this.cache.has(key)) {
+            this.evictLRU();
+        }
+        const entry = {
+            key,
+            value,
+            timestamp: now,
+            lastAccessed: now,
+            accessCount: 0,
+            expiresAt: now + this.config.ttl
+        };
+        this.cache.set(key, entry);
+        this.stats.currentSize = this.cache.size;
+        // Persist to disk if enabled
+        if (this.persistentCache) {
+            this.persistentCache.save(key, entry);
+        }
+    }
+    /**
+     * Check if entry has expired
+     */
+    isExpired(entry) {
+        return Date.now() > entry.expiresAt;
+    }
+    /**
+     * Evict least recently used entry
+     * Since Map maintains insertion order, the first entry is the least recently used
+     */
+    evictLRU() {
+        // Get first entry (least recently used)
+        const firstKey = this.cache.keys().next().value;
+        if (firstKey) {
+            const entry = this.cache.get(firstKey);
+            if (entry) {
+                this.totalAccessCount -= entry.accessCount; // Update running total
+            }
+            this.cache.delete(firstKey);
+            this.stats.evictions++;
+            this.stats.currentSize = this.cache.size;
+            // Remove from disk
+            if (this.persistentCache) {
+                this.persistentCache.delete(firstKey);
+            }
+        }
+    }
+    /**
+     * Clear all cache entries
+     */
+    clear() {
+        this.cache.clear();
+        this.stats.currentSize = 0;
+        this.totalAccessCount = 0; // Reset running total
+        if (this.persistentCache) {
+            this.persistentCache.clear();
+        }
+    }
+    /**
+     * Clean up expired entries
+     */
+    cleanup() {
+        let removed = 0;
+        const now = Date.now();
+        for (const [key, entry] of this.cache.entries()) {
+            if (now > entry.expiresAt) {
+                this.totalAccessCount -= entry.accessCount; // Update running total
+                this.cache.delete(key);
+                this.stats.expirations++;
+                removed++;
+                if (this.persistentCache) {
+                    this.persistentCache.delete(key);
+                }
+            }
+        }
+        this.stats.currentSize = this.cache.size;
+        return removed;
+    }
+    /**
+     * Get cache statistics
+     */
+    getStats() {
+        return { ...this.stats };
+    }
+    /**
+     * Update hit rate and average access count (O(1) complexity)
+     */
+    updateStats() {
+        const total = this.stats.hits + this.stats.misses;
+        this.stats.hitRate = total > 0 ? this.stats.hits / total : 0;
+        // Calculate average access count using running total (O(1))
+        this.stats.averageAccessCount = this.cache.size > 0 ? this.totalAccessCount / this.cache.size : 0;
+    }
+    /**
+     * Load cache from disk
+     */
+    loadFromDisk() {
+        if (!this.persistentCache) {
+            return;
+        }
+        const entries = this.persistentCache.loadAll();
+        const now = Date.now();
+        for (const entry of entries) {
+            // Skip expired entries
+            if (now > entry.expiresAt) {
+                this.stats.expirations++;
+                continue;
+            }
+            this.cache.set(entry.key, entry);
+            this.totalAccessCount += entry.accessCount; // Initialize running total from disk
+        }
+        this.stats.currentSize = this.cache.size;
+    }
+    /**
+     * Force save all entries to disk and wait for completion
+     */
+    async saveToDisk() {
+        if (!this.persistentCache) {
+            return;
+        }
+        // Flush all pending writes and save current state
+        await this.persistentCache.flush();
+        await this.persistentCache.saveAll(Array.from(this.cache.values()));
+        await this.persistentCache.flush(); // Ensure final save completes
+    }
+    /**
+     * Get cache size
+     */
+    size() {
+        return this.cache.size;
+    }
+    /**
+     * Check if key exists (without updating access time)
+     */
+    has(key) {
+        const entry = this.cache.get(key);
+        if (!entry) {
+            return false;
+        }
+        return !this.isExpired(entry);
+    }
+}
+//# sourceMappingURL=lru-cache.js.map

package/dist/optimizer/caching/lru-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lru-cache.js","sourceRoot":"","sources":["../../../src/optimizer/caching/lru-cache.ts"],"names":[],"mappings":"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"}

package/dist/optimizer/caching/persistent-cache.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Persistent Cache: Disk-based cache storage
+ * Features:
+ * - Save/load cache entries to/from disk
+ * - Atomic writes to prevent corruption
+ * - Auto-create cache directory
+ * - Operation serialization to prevent race conditions
+ * - Batched writes to reduce disk I/O
+ */
+import type { LRUCacheEntry } from './cache-types.js';
+export declare class PersistentCache<T = any> {
+    private filePath;
+    private writeQueue;
+    private isProcessing;
+    private pendingWrites;
+    private batchTimer;
+    private readonly BATCH_DELAY_MS;
+    constructor(filePath: string);
+    /**
+     * Ensure cache directory exists
+     */
+    private ensureDirectory;
+    /**
+     * Load all cache entries from disk
+     */
+    loadAll(): LRUCacheEntry<T>[];
+    /**
+     * Save all cache entries to disk synchronously (atomic write)
+     * Internal use only
+     */
+    private saveAllSync;
+    /**
+     * Save all cache entries to disk (queued)
+     */
+    saveAll(entries: LRUCacheEntry<T>[]): Promise<void>;
+    /**
+     * Flush all pending writes immediately
+     * Call this before process exit to ensure all writes are persisted
+     */
+    flush(): Promise<void>;
+    /**
+     * Queue a write operation
+     */
+    private queueWrite;
+    /**
+     * Process the write queue serially
+     */
+    private processQueue;
+    /**
+     * Execute a single write operation
+     */
+    private executeOperation;
+    /**
+     * Schedule a batched write operation
+     */
+    private scheduleBatchWrite;
+    /**
+     * Flush all pending writes to disk
+     */
+    private flushPendingWrites;
+    /**
+     * Save a single entry (batched and queued)
+     */
+    save(key: string, entry: LRUCacheEntry<T>): Promise<void>;
+    /**
+     * Delete a single entry (queued)
+     */
+    delete(key: string): Promise<void>;
+    /**
+     * Clear all cache entries (queued)
+     */
+    clear(): Promise<void>;
+    /**
+     * Get cache file size in bytes
+     */
+    getFileSize(): number;
+    /**
+     * Check if cache file exists
+     */
+    exists(): boolean;
+}
+//# sourceMappingURL=persistent-cache.d.ts.map

package/dist/optimizer/caching/persistent-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistent-cache.d.ts","sourceRoot":"","sources":["../../../src/optimizer/caching/persistent-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AActD,qBAAa,eAAe,CAAC,CAAC,GAAG,GAAG;IAClC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,UAAU,CAA2B;IAC7C,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,aAAa,CAA4C;IACjE,OAAO,CAAC,UAAU,CAA+B;IACjD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAO;gBAE1B,QAAQ,EAAE,MAAM;IAU5B;;OAEG;IACH,OAAO,CAAC,eAAe;IAOvB;;OAEG;IACH,OAAO,IAAI,aAAa,CAAC,CAAC,CAAC,EAAE;IAoB7B;;;OAGG;IACH,OAAO,CAAC,WAAW;IAgBnB;;OAEG;IACG,OAAO,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzD;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAe5B;;OAEG;IACH,OAAO,CAAC,UAAU;IAOlB;;OAEG;YACW,YAAY;IAqB1B;;OAEG;YACW,gBAAgB;IA4C9B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAU1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAkB1B;;OAEG;IACG,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/D;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B;;OAEG;IACH,WAAW,IAAI,MAAM;IAYrB;;OAEG;IACH,MAAM,IAAI,OAAO;CAGlB"}