@skillsmith/core 0.5.4 → 0.5.6

package/dist/cache/TieredCache.js

@@ -0,0 +1,334 @@
+/**
+ * SMI-644: Enhanced Tiered Cache with TTL Management
+ * L1 (memory) + L2 (SQLite) with automatic promotion/demotion
+ */
+import { LRUCache } from 'lru-cache';
+import { createDatabaseAsync } from '../db/createDatabase.js';
+import { TTLTier, createCacheEntry, recordHit, isExpired, shouldRefresh, serializeCacheEntry, deserializeCacheEntry, isValidCacheKey, } from './CacheEntry.js';
+/**
+ * Entry size estimator for memory bounds
+ */
+function estimateEntrySize(entry) {
+    // Rough estimation: key + JSON data + overhead
+    const keySize = entry.key.length * 2; // UTF-16
+    const dataSize = JSON.stringify(entry.data).length * 2;
+    const overhead = 200; // Object overhead + metadata
+    return keySize + dataSize + overhead;
+}
+/**
+ * Enhanced two-tier cache with TTL management
+ */
+export class EnhancedTieredCache {
+    l1;
+    db = null;
+    config;
+    pruneTimer = null;
+    // Statistics
+    stats = {
+        l1Hits: 0,
+        l1Misses: 0,
+        l2Hits: 0,
+        l2Misses: 0,
+        promotions: 0,
+        demotions: 0,
+        evictions: 0,
+    };
+    // Prepared statements for L2
+    stmts = null;
+    /**
+     * @deprecated If l2.dbPath is passed, use EnhancedTieredCache.create(config) instead —
+     * the async factory supports both native and WASM SQLite. Passing l2.dbPath to this
+     * constructor throws to prevent silent data loss.
+     */
+    constructor(config = {}) {
+        if (config.l2?.dbPath) {
+            throw new Error('[EnhancedTieredCache] Cannot open a database file in the sync constructor. ' +
+                'Use await EnhancedTieredCache.create(config) instead.');
+        }
+        this.initFromConfig(config);
+    }
+    /**
+     * Async factory — supports both native and WASM SQLite.
+     *
+     * @param config - Cache configuration; l2.dbPath is opened via createDatabaseAsync
+     * @returns Fully initialised EnhancedTieredCache instance
+     */
+    static async create(config = {}) {
+        // Bypass the throwing constructor by omitting l2.dbPath
+        const { l2, ...rest } = config;
+        const instance = new EnhancedTieredCache(rest);
+        if (l2?.dbPath) {
+            await instance.initL2Async(l2.dbPath);
+            const pruneInterval = l2.pruneIntervalMs ?? 5 * 60 * 1000;
+            instance.pruneTimer = setInterval(() => instance.prune(), pruneInterval);
+            instance.pruneTimer.unref();
+        }
+        return instance;
+    }
+    initFromConfig(config) {
+        const l1MaxEntries = config.l1?.maxEntries ?? 1000;
+        const l1MaxMemoryBytes = config.l1?.maxMemoryBytes ?? 100 * 1024 * 1024; // 100MB
+        this.config = {
+            l1: {
+                maxEntries: l1MaxEntries,
+                maxMemoryBytes: l1MaxMemoryBytes,
+            },
+            l2: config.l2 ?? undefined,
+            enablePromotion: config.enablePromotion ?? true,
+            enableDemotion: config.enableDemotion ?? true,
+        };
+        // Initialize L1 with memory-bounded LRU
+        this.l1 = new LRUCache({
+            max: l1MaxEntries,
+            maxSize: l1MaxMemoryBytes,
+            sizeCalculation: estimateEntrySize,
+            dispose: (entry, key) => {
+                // On L1 eviction, demote to L2 if popular enough
+                if (this.config.enableDemotion && this.db && !isExpired(entry)) {
+                    this.demoteToL2(key, entry);
+                }
+                this.stats.evictions++;
+            },
+        });
+    }
+    async initL2Async(dbPath) {
+        const db = (this.db = await createDatabaseAsync(dbPath));
+        db.pragma('cache_size = -16000');
+        db.exec(`
+      CREATE TABLE IF NOT EXISTS cache_entries (
+        key TEXT PRIMARY KEY, data_json TEXT NOT NULL, total_count INTEGER NOT NULL,
+        created_at INTEGER NOT NULL, expires_at INTEGER NOT NULL,
+        hit_count INTEGER NOT NULL DEFAULT 0, last_accessed_at INTEGER NOT NULL, ttl_tier INTEGER NOT NULL
+      );
+      CREATE INDEX IF NOT EXISTS idx_cache_expires ON cache_entries(expires_at);
+      CREATE INDEX IF NOT EXISTS idx_cache_tier ON cache_entries(ttl_tier);
+    `);
+        this.stmts = {
+            get: db.prepare(`SELECT key, data_json, total_count, created_at, expires_at,
+               hit_count, last_accessed_at, ttl_tier FROM cache_entries WHERE key = ? AND expires_at > ?`),
+            set: db.prepare(`INSERT OR REPLACE INTO cache_entries
+        (key, data_json, total_count, created_at, expires_at, hit_count, last_accessed_at, ttl_tier)
+        VALUES (?, ?, ?, ?, ?, ?, ?, ?)`),
+            has: db.prepare(`SELECT 1 FROM cache_entries WHERE key = ? AND expires_at > ?`),
+            delete: db.prepare(`DELETE FROM cache_entries WHERE key = ?`),
+            prune: db.prepare(`DELETE FROM cache_entries WHERE expires_at <= ?`),
+            count: db.prepare(`SELECT COUNT(*) as count FROM cache_entries WHERE expires_at > ?`),
+            updateHit: db.prepare(`UPDATE cache_entries SET hit_count = ?, last_accessed_at = ?, ttl_tier = ? WHERE key = ?`),
+            countByTier: db.prepare(`SELECT COUNT(*) as count FROM cache_entries WHERE ttl_tier = ? AND expires_at > ?`),
+        };
+    }
+    /**
+     * Get entry from cache (L1 first, then L2)
+     */
+    get(key) {
+        if (!isValidCacheKey(key)) {
+            return undefined;
+        }
+        const now = Date.now();
+        // Check L1 first
+        const l1Entry = this.l1.get(key);
+        if (l1Entry) {
+            if (isExpired(l1Entry, now)) {
+                this.l1.delete(key);
+                this.stats.l1Misses++;
+            }
+            else {
+                this.stats.l1Hits++;
+                // Update hit count
+                const updated = recordHit(l1Entry);
+                this.l1.set(key, updated);
+                return { results: updated.data, totalCount: updated.totalCount };
+            }
+        }
+        else {
+            this.stats.l1Misses++;
+        }
+        // Check L2 if available
+        if (this.db && this.stmts) {
+            const row = this.stmts.get.get(key, now);
+            if (row) {
+                this.stats.l2Hits++;
+                try {
+                    const entry = deserializeCacheEntry(row);
+                    const updated = recordHit(entry);
+                    // Update L2 hit stats
+                    this.stmts.updateHit.run(updated.hitCount, updated.lastAccessedAt, updated.ttlTier, key);
+                    // Promote to L1
+                    if (this.config.enablePromotion) {
+                        this.l1.set(key, updated);
+                        this.stats.promotions++;
+                    }
+                    return { results: updated.data, totalCount: updated.totalCount };
+                }
+                catch {
+                    // Corrupted entry, remove it
+                    this.stmts.delete.run(key);
+                }
+            }
+            else {
+                this.stats.l2Misses++;
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Store entry in cache
+     */
+    set(key, results, totalCount, ttlTier = TTLTier.STANDARD) {
+        if (!isValidCacheKey(key)) {
+            throw new Error('Invalid cache key');
+        }
+        const entry = createCacheEntry(key, results, totalCount, ttlTier);
+        // Store in L1
+        this.l1.set(key, entry);
+        // Store in L2 if available
+        if (this.db && this.stmts) {
+            const serialized = serializeCacheEntry(entry);
+            this.stmts.set.run(serialized.key, serialized.data_json, serialized.total_count, serialized.created_at, serialized.expires_at, serialized.hit_count, serialized.last_accessed_at, serialized.ttl_tier);
+        }
+    }
+    /**
+     * Check if key exists in cache
+     */
+    has(key) {
+        if (!isValidCacheKey(key)) {
+            return false;
+        }
+        const now = Date.now();
+        // Check L1
+        const l1Entry = this.l1.get(key);
+        if (l1Entry && !isExpired(l1Entry, now)) {
+            return true;
+        }
+        // Check L2
+        if (this.db && this.stmts) {
+            return this.stmts.has.get(key, now) !== undefined;
+        }
+        return false;
+    }
+    /**
+     * Delete specific entry
+     */
+    delete(key) {
+        let deleted = false;
+        if (this.l1.has(key)) {
+            this.l1.delete(key);
+            deleted = true;
+        }
+        if (this.db && this.stmts) {
+            const result = this.stmts.delete.run(key);
+            if (result.changes > 0) {
+                deleted = true;
+            }
+        }
+        return deleted;
+    }
+    /**
+     * Invalidate all entries (called on index update)
+     */
+    invalidateAll() {
+        this.l1.clear();
+        if (this.db) {
+            this.db.exec('DELETE FROM cache_entries');
+        }
+    }
+    /**
+     * Prune expired entries
+     */
+    prune() {
+        const now = Date.now();
+        let pruned = 0;
+        // L1 handles its own expiration via TTL
+        // Just trigger a check
+        this.l1.purgeStale();
+        // Prune L2
+        if (this.db && this.stmts) {
+            const result = this.stmts.prune.run(now);
+            pruned = result.changes;
+        }
+        return pruned;
+    }
+    /**
+     * Get entries that need background refresh
+     */
+    getEntriesNeedingRefresh() {
+        const now = Date.now();
+        const keys = [];
+        // Check L1 entries
+        for (const [key, entry] of this.l1.entries()) {
+            if (shouldRefresh(entry, now)) {
+                keys.push(key);
+            }
+        }
+        return keys;
+    }
+    /**
+     * Get cache statistics
+     */
+    getStats() {
+        const totalHits = this.stats.l1Hits + this.stats.l2Hits;
+        const totalMisses = this.stats.l1Misses + this.stats.l2Misses;
+        const total = totalHits + totalMisses;
+        let l2Size = 0;
+        let popularEntries = 0;
+        let rareEntries = 0;
+        if (this.db && this.stmts) {
+            try {
+                const now = Date.now();
+                const countResult = this.stmts.count.get(now);
+                l2Size = countResult?.count ?? 0;
+                const popularResult = this.stmts.countByTier.get(TTLTier.POPULAR, now);
+                popularEntries = popularResult?.count ?? 0;
+                const rareResult = this.stmts.countByTier.get(TTLTier.RARE, now);
+                rareEntries = rareResult?.count ?? 0;
+            }
+            catch {
+                // Database may be corrupted or closed, return zeros for L2 stats
+            }
+        }
+        return {
+            l1Hits: this.stats.l1Hits,
+            l1Misses: this.stats.l1Misses,
+            l2Hits: this.stats.l2Hits,
+            l2Misses: this.stats.l2Misses,
+            totalHits,
+            totalMisses,
+            hitRate: total > 0 ? totalHits / total : 0,
+            l1Size: this.l1.size,
+            l2Size,
+            promotions: this.stats.promotions,
+            demotions: this.stats.demotions,
+            evictions: this.stats.evictions,
+            popularEntries,
+            rareEntries,
+        };
+    }
+    /**
+     * Demote entry from L1 to L2
+     */
+    demoteToL2(key, entry) {
+        if (!this.db || !this.stmts)
+            return;
+        // Only demote if entry is still valuable (not rare)
+        if (entry.ttlTier !== TTLTier.RARE) {
+            const serialized = serializeCacheEntry(entry);
+            this.stmts.set.run(serialized.key, serialized.data_json, serialized.total_count, serialized.created_at, serialized.expires_at, serialized.hit_count, serialized.last_accessed_at, serialized.ttl_tier);
+            this.stats.demotions++;
+        }
+    }
+    /**
+     * Close cache and cleanup resources
+     */
+    close() {
+        if (this.pruneTimer) {
+            clearInterval(this.pruneTimer);
+            this.pruneTimer = null;
+        }
+        if (this.db) {
+            this.db.close();
+            this.db = null;
+            this.stmts = null;
+        }
+    }
+}
+//# sourceMappingURL=TieredCache.js.map

package/dist/cache/TieredCache.js.map

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

package/dist/cache/index.d.ts

@@ -0,0 +1,75 @@
+/**
+ * SMI-585/SMI-644: Cache exports
+ * Two-tier caching with TTL management for search results
+ */
+export { L1Cache } from './lru.js';
+export type { SearchCacheEntry, SearchResult, CacheStats } from './lru.js';
+export { L2Cache } from './sqlite.js';
+export type { L2CacheOptions } from './sqlite.js';
+export { TTLTier, POPULARITY_THRESHOLDS, createCacheEntry, recordHit, calculateTTLTier, isExpired, shouldRefresh, isValidCacheKey, serializeCacheEntry, deserializeCacheEntry, getTTLTierName, } from './CacheEntry.js';
+export type { CacheEntry, SerializedCacheEntry } from './CacheEntry.js';
+export { EnhancedTieredCache } from './TieredCache.js';
+export type { L1Config, L2Config, TieredCacheConfig, TieredCacheStats } from './TieredCache.js';
+export { CacheManager } from './CacheManager.js';
+export type { SearchOptions, RefreshCallback, CacheManagerConfig } from './CacheManager.js';
+import { type SearchResult, type CacheStats } from './lru.js';
+import { type L2CacheOptions } from './sqlite.js';
+export interface TieredCacheOptions {
+    l1MaxSize?: number;
+    l2Options?: L2CacheOptions;
+}
+/**
+ * Two-tier cache combining L1 (memory) and L2 (SQLite)
+ */
+export declare class TieredCache {
+    private l1;
+    private l2;
+    /**
+     * @deprecated If l2Options is passed, use TieredCache.create(options) — async factory
+     * with WASM fallback. Passing l2Options to this constructor throws to prevent silent
+     * data loss.
+     */
+    constructor(options?: TieredCacheOptions);
+    /**
+     * Async factory — supports both native and WASM SQLite.
+     *
+     * @param options - Cache options; l2Options.dbPath is opened via createDatabaseAsync
+     * @returns Fully initialised TieredCache instance
+     */
+    static create(options?: TieredCacheOptions): Promise<TieredCache>;
+    /**
+     * Get from cache, checking L1 first, then L2
+     */
+    get(key: string): {
+        results: SearchResult[];
+        totalCount: number;
+    } | undefined;
+    /**
+     * Store in both cache tiers
+     */
+    set(key: string, results: SearchResult[], totalCount: number): void;
+    /**
+     * Check if key exists in either tier
+     */
+    has(key: string): boolean;
+    /**
+     * Invalidate all caches (called when index updates)
+     */
+    invalidateAll(): void;
+    /**
+     * Get combined stats
+     */
+    getStats(): {
+        l1: CacheStats;
+        l2: CacheStats | null;
+    };
+    /**
+     * Prune expired entries
+     */
+    prune(): void;
+    /**
+     * Close L2 database
+     */
+    close(): void;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/cache/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAA;AAClC,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAE1E,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AACrC,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAGjD,OAAO,EACL,OAAO,EACP,qBAAqB,EACrB,gBAAgB,EAChB,SAAS,EACT,gBAAgB,EAChB,SAAS,EACT,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,GACf,MAAM,iBAAiB,CAAA;AACxB,YAAY,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAA;AAEvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AACtD,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAE/F,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAE3F,OAAO,EAAW,KAAK,YAAY,EAAE,KAAK,UAAU,EAAE,MAAM,UAAU,CAAA;AACtE,OAAO,EAAW,KAAK,cAAc,EAAE,MAAM,aAAa,CAAA;AAE1D,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,cAAc,CAAA;CAC3B;AAED;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,EAAE,CAAS;IACnB,OAAO,CAAC,EAAE,CAAuB;IAEjC;;;;OAIG;gBACS,OAAO,GAAE,kBAAuB;IAU5C;;;;;OAKG;WACU,MAAM,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,WAAW,CAAC;IAQ3E;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,YAAY,EAAE,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS;IAoB7E;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAQnE;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB;;OAEG;IACH,aAAa,IAAI,IAAI;IAKrB;;OAEG;IACH,QAAQ,IAAI;QAAE,EAAE,EAAE,UAAU,CAAC;QAAC,EAAE,EAAE,UAAU,GAAG,IAAI,CAAA;KAAE;IAOrD;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd"}

package/dist/cache/index.js

@@ -0,0 +1,110 @@
+/**
+ * SMI-585/SMI-644: Cache exports
+ * Two-tier caching with TTL management for search results
+ */
+// SMI-585: Basic cache components
+export { L1Cache } from './lru.js';
+export { L2Cache } from './sqlite.js';
+// SMI-644: Enhanced cache with TTL management
+export { TTLTier, POPULARITY_THRESHOLDS, createCacheEntry, recordHit, calculateTTLTier, isExpired, shouldRefresh, isValidCacheKey, serializeCacheEntry, deserializeCacheEntry, getTTLTierName, } from './CacheEntry.js';
+export { EnhancedTieredCache } from './TieredCache.js';
+export { CacheManager } from './CacheManager.js';
+import { L1Cache } from './lru.js';
+import { L2Cache } from './sqlite.js';
+/**
+ * Two-tier cache combining L1 (memory) and L2 (SQLite)
+ */
+export class TieredCache {
+    l1;
+    l2 = null;
+    /**
+     * @deprecated If l2Options is passed, use TieredCache.create(options) — async factory
+     * with WASM fallback. Passing l2Options to this constructor throws to prevent silent
+     * data loss.
+     */
+    constructor(options = {}) {
+        if (options.l2Options) {
+            throw new Error('[TieredCache] Cannot open a database file in the sync constructor. ' +
+                'Use await TieredCache.create(options) instead.');
+        }
+        this.l1 = new L1Cache(options.l1MaxSize ?? 100);
+    }
+    /**
+     * Async factory — supports both native and WASM SQLite.
+     *
+     * @param options - Cache options; l2Options.dbPath is opened via createDatabaseAsync
+     * @returns Fully initialised TieredCache instance
+     */
+    static async create(options = {}) {
+        const instance = new TieredCache({ l1MaxSize: options.l1MaxSize });
+        if (options.l2Options) {
+            instance.l2 = await L2Cache.create(options.l2Options);
+        }
+        return instance;
+    }
+    /**
+     * Get from cache, checking L1 first, then L2
+     */
+    get(key) {
+        // Check L1 first
+        const l1Entry = this.l1.get(key);
+        if (l1Entry) {
+            return { results: l1Entry.results, totalCount: l1Entry.totalCount };
+        }
+        // Check L2 if available
+        if (this.l2) {
+            const l2Entry = this.l2.get(key);
+            if (l2Entry) {
+                // Promote to L1
+                this.l1.set(key, l2Entry.results, l2Entry.totalCount);
+                return { results: l2Entry.results, totalCount: l2Entry.totalCount };
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Store in both cache tiers
+     */
+    set(key, results, totalCount) {
+        this.l1.set(key, results, totalCount);
+        if (this.l2) {
+            this.l2.set(key, results, totalCount);
+        }
+    }
+    /**
+     * Check if key exists in either tier
+     */
+    has(key) {
+        return this.l1.has(key) || (this.l2?.has(key) ?? false);
+    }
+    /**
+     * Invalidate all caches (called when index updates)
+     */
+    invalidateAll() {
+        this.l1.invalidateAll();
+        this.l2?.invalidateAll();
+    }
+    /**
+     * Get combined stats
+     */
+    getStats() {
+        return {
+            l1: this.l1.getStats(),
+            l2: this.l2?.getStats() ?? null,
+        };
+    }
+    /**
+     * Prune expired entries
+     */
+    prune() {
+        this.l1.prune();
+        this.l2?.prune();
+    }
+    /**
+     * Close L2 database
+     */
+    close() {
+        this.l2?.close();
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/cache/index.js.map

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

package/dist/cache/lru.d.ts

@@ -0,0 +1,68 @@
+/**
+ * SMI-585: L1 In-Memory LRU Cache
+ * Fast in-memory cache for frequently accessed search results
+ */
+export interface SearchCacheEntry {
+    results: SearchResult[];
+    totalCount: number;
+    timestamp: number;
+}
+export interface SearchResult {
+    id: string;
+    name: string;
+    description: string;
+    score: number;
+    source: string;
+}
+export interface CacheStats {
+    hits: number;
+    misses: number;
+    hitRate: number;
+    size: number;
+    maxSize: number;
+}
+export declare class L1Cache {
+    private cache;
+    private hits;
+    private misses;
+    constructor(maxSize?: number);
+    /**
+     * Generate cache key from query and filters
+     */
+    static generateKey(query: string, filters?: Record<string, unknown>): string;
+    /**
+     * Get cached search results
+     */
+    get(key: string): SearchCacheEntry | undefined;
+    /**
+     * Store search results in cache
+     */
+    set(key: string, results: SearchResult[], totalCount: number): void;
+    /**
+     * Check if key exists in cache
+     */
+    has(key: string): boolean;
+    /**
+     * Delete specific cache entry
+     */
+    delete(key: string): boolean;
+    /**
+     * Clear all cache entries
+     */
+    clear(): void;
+    /**
+     * Invalidate all search-related entries
+     * Called when the skill index is updated
+     */
+    invalidateAll(): void;
+    /**
+     * Get cache statistics
+     */
+    getStats(): CacheStats;
+    /**
+     * Prune expired entries
+     */
+    prune(): void;
+}
+export default L1Cache;
+//# sourceMappingURL=lru.d.ts.map

package/dist/cache/lru.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lru.d.ts","sourceRoot":"","sources":["../../src/cache/lru.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,YAAY,EAAE,CAAA;IACvB,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,qBAAa,OAAO;IAClB,OAAO,CAAC,KAAK,CAAoC;IACjD,OAAO,CAAC,IAAI,CAAI;IAChB,OAAO,CAAC,MAAM,CAAI;gBAEN,OAAO,GAAE,MAAY;IASjC;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;IAsB5E;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAY9C;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAQnE;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI5B;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;;OAGG;IACH,aAAa,IAAI,IAAI;IAIrB;;OAEG;IACH,QAAQ,IAAI,UAAU;IAWtB;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd;AAED,eAAe,OAAO,CAAA"}