@skillsmith/core 0.5.5 → 0.5.6

package/dist/billing/webhook-handlers.js.map

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

package/dist/billing/webhook-types.d.ts

@@ -0,0 +1,42 @@
+/**
+ * SMI-1070: Stripe Webhook Types
+ *
+ * Configuration and type definitions for the webhook handler.
+ */
+import type { Database as DatabaseType } from '../db/database-interface.js';
+import type { StripeClient } from './StripeClient.js';
+import type { BillingService } from './BillingService.js';
+import type { LicenseTier } from './types.js';
+export interface StripeWebhookHandlerConfig {
+    /**
+     * StripeClient for API calls
+     */
+    stripeClient: StripeClient;
+    /**
+     * BillingService for database operations
+     */
+    billingService: BillingService;
+    /**
+     * Database connection (for license key storage)
+     */
+    db: DatabaseType;
+    /**
+     * Callback for license key generation
+     * Called when a subscription is created/activated
+     */
+    onLicenseKeyNeeded?: (params: {
+        customerId: string;
+        tier: LicenseTier;
+        expiresAt: Date;
+        subscriptionId: string;
+    }) => Promise<string>;
+    /**
+     * Callback for sending emails
+     */
+    onEmailNeeded?: (params: {
+        type: 'license_key' | 'payment_failed' | 'subscription_canceled';
+        email: string;
+        data: Record<string, unknown>;
+    }) => Promise<void>;
+}
+//# sourceMappingURL=webhook-types.d.ts.map

package/dist/billing/webhook-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-types.d.ts","sourceRoot":"","sources":["../../src/billing/webhook-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,IAAI,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAC3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAM7C,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,YAAY,EAAE,YAAY,CAAA;IAE1B;;OAEG;IACH,cAAc,EAAE,cAAc,CAAA;IAE9B;;OAEG;IACH,EAAE,EAAE,YAAY,CAAA;IAEhB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,CAAC,MAAM,EAAE;QAC5B,UAAU,EAAE,MAAM,CAAA;QAClB,IAAI,EAAE,WAAW,CAAA;QACjB,SAAS,EAAE,IAAI,CAAA;QACf,cAAc,EAAE,MAAM,CAAA;KACvB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IAErB;;OAEG;IACH,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE;QACvB,IAAI,EAAE,aAAa,GAAG,gBAAgB,GAAG,uBAAuB,CAAA;QAChE,KAAK,EAAE,MAAM,CAAA;QACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAC9B,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CACpB"}

package/dist/billing/webhook-types.js

@@ -0,0 +1,7 @@
+/**
+ * SMI-1070: Stripe Webhook Types
+ *
+ * Configuration and type definitions for the webhook handler.
+ */
+export {};
+//# sourceMappingURL=webhook-types.js.map

package/dist/billing/webhook-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-types.js","sourceRoot":"","sources":["../../src/billing/webhook-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/cache/CacheEntry.d.ts

@@ -0,0 +1,101 @@
+/**
+ * SMI-644: Cache Entry Data Structure
+ * Enhanced cache entry with TTL tracking and hit count for popularity detection
+ */
+import type { SearchResult } from './lru.js';
+/**
+ * TTL tiers based on query popularity
+ */
+export declare enum TTLTier {
+    /** Popular queries (>10 hits/hour): 4 hours */
+    POPULAR = 14400000,
+    /** Standard queries: 1 hour */
+    STANDARD = 3600000,
+    /** Rare queries (<1 hit/day): 15 minutes */
+    RARE = 900000
+}
+/**
+ * Popularity thresholds for TTL determination
+ */
+export declare const POPULARITY_THRESHOLDS: {
+    /** Hits per hour to be considered "popular" */
+    readonly POPULAR_HITS_PER_HOUR: 10;
+    /** Minimum age (ms) before evaluating popularity */
+    readonly MIN_AGE_FOR_EVALUATION: number;
+};
+/**
+ * Enhanced cache entry with TTL and popularity tracking
+ */
+export interface CacheEntry<T = SearchResult[]> {
+    /** Unique cache key */
+    key: string;
+    /** Cached data */
+    data: T;
+    /** Total count for search results */
+    totalCount: number;
+    /** Creation timestamp (ms) */
+    createdAt: number;
+    /** Expiration timestamp (ms) */
+    expiresAt: number;
+    /** Number of cache hits */
+    hitCount: number;
+    /** Last access timestamp (ms) */
+    lastAccessedAt: number;
+    /** Current TTL tier */
+    ttlTier: TTLTier;
+}
+/**
+ * Serialized format for persistent storage
+ */
+export interface SerializedCacheEntry {
+    key: string;
+    data_json: string;
+    total_count: number;
+    created_at: number;
+    expires_at: number;
+    hit_count: number;
+    last_accessed_at: number;
+    ttl_tier: number;
+}
+/**
+ * Create a new cache entry with default TTL
+ */
+export declare function createCacheEntry<T = SearchResult[]>(key: string, data: T, totalCount: number, ttlTier?: TTLTier): CacheEntry<T>;
+/**
+ * Record a hit on a cache entry
+ * Returns updated entry (immutable pattern)
+ */
+export declare function recordHit<T>(entry: CacheEntry<T>): CacheEntry<T>;
+/**
+ * Calculate TTL tier based on hit rate
+ */
+export declare function calculateTTLTier(createdAt: number, hitCount: number, now?: number): TTLTier;
+/**
+ * Check if cache entry is expired
+ */
+export declare function isExpired<T>(entry: CacheEntry<T>, now?: number): boolean;
+/**
+ * Check if entry should be refreshed (approaching expiration)
+ * Returns true if within 10% of TTL remaining
+ */
+export declare function shouldRefresh<T>(entry: CacheEntry<T>, now?: number): boolean;
+/**
+ * Validate cache key for security (standards.md §4)
+ * Prevents injection attacks through cache keys
+ */
+export declare function isValidCacheKey(key: string): boolean;
+/**
+ * Serialize cache entry for persistence
+ * Uses safe JSON serialization to prevent prototype pollution
+ */
+export declare function serializeCacheEntry<T>(entry: CacheEntry<T>): SerializedCacheEntry;
+/**
+ * Deserialize cache entry from persistence
+ * Validates data to prevent prototype pollution (security: standards.md §4)
+ */
+export declare function deserializeCacheEntry<T = SearchResult[]>(serialized: SerializedCacheEntry): CacheEntry<T>;
+/**
+ * Get human-readable TTL tier name
+ */
+export declare function getTTLTierName(tier: TTLTier): string;
+//# sourceMappingURL=CacheEntry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CacheEntry.d.ts","sourceRoot":"","sources":["../../src/cache/CacheEntry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAE5C;;GAEG;AACH,oBAAY,OAAO;IACjB,+CAA+C;IAC/C,OAAO,WAAqB;IAC5B,+BAA+B;IAC/B,QAAQ,UAAiB;IACzB,4CAA4C;IAC5C,IAAI,SAAiB;CACtB;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB;IAChC,+CAA+C;;IAE/C,oDAAoD;;CAE5C,CAAA;AAEV;;GAEG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,YAAY,EAAE;IAC5C,uBAAuB;IACvB,GAAG,EAAE,MAAM,CAAA;IACX,kBAAkB;IAClB,IAAI,EAAE,CAAC,CAAA;IACP,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAA;IAClB,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAA;IACjB,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAA;IACjB,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAA;IAChB,iCAAiC;IACjC,cAAc,EAAE,MAAM,CAAA;IACtB,uBAAuB;IACvB,OAAO,EAAE,OAAO,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,gBAAgB,EAAE,MAAM,CAAA;IACxB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,GAAG,YAAY,EAAE,EACjD,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,CAAC,EACP,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,OAA0B,GAClC,UAAU,CAAC,CAAC,CAAC,CAiBf;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAiBhE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,GAAG,GAAE,MAAmB,GACvB,OAAO,CAuBT;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG,GAAE,MAAmB,GAAG,OAAO,CAEpF;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG,GAAE,MAAmB,GAAG,OAAO,CAIxF;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAkBpD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,oBAAoB,CAWjF;AA8CD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,GAAG,YAAY,EAAE,EACtD,UAAU,EAAE,oBAAoB,GAC/B,UAAU,CAAC,CAAC,CAAC,CA+Cf;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAWpD"}

package/dist/cache/CacheEntry.js

@@ -0,0 +1,238 @@
+/**
+ * SMI-644: Cache Entry Data Structure
+ * Enhanced cache entry with TTL tracking and hit count for popularity detection
+ */
+/**
+ * TTL tiers based on query popularity
+ */
+export var TTLTier;
+(function (TTLTier) {
+    /** Popular queries (>10 hits/hour): 4 hours */
+    TTLTier[TTLTier["POPULAR"] = 14400000] = "POPULAR";
+    /** Standard queries: 1 hour */
+    TTLTier[TTLTier["STANDARD"] = 3600000] = "STANDARD";
+    /** Rare queries (<1 hit/day): 15 minutes */
+    TTLTier[TTLTier["RARE"] = 900000] = "RARE";
+})(TTLTier || (TTLTier = {}));
+/**
+ * Popularity thresholds for TTL determination
+ */
+export const POPULARITY_THRESHOLDS = {
+    /** Hits per hour to be considered "popular" */
+    POPULAR_HITS_PER_HOUR: 10,
+    /** Minimum age (ms) before evaluating popularity */
+    MIN_AGE_FOR_EVALUATION: 60 * 1000, // 1 minute
+};
+/**
+ * Create a new cache entry with default TTL
+ */
+export function createCacheEntry(key, data, totalCount, ttlTier = TTLTier.STANDARD) {
+    // Validate key to prevent injection (security: standards.md §4)
+    if (!isValidCacheKey(key)) {
+        throw new Error('Invalid cache key: contains disallowed characters');
+    }
+    const now = Date.now();
+    return {
+        key,
+        data,
+        totalCount,
+        createdAt: now,
+        expiresAt: now + ttlTier,
+        hitCount: 0,
+        lastAccessedAt: now,
+        ttlTier,
+    };
+}
+/**
+ * Record a hit on a cache entry
+ * Returns updated entry (immutable pattern)
+ */
+export function recordHit(entry) {
+    const now = Date.now();
+    const newHitCount = entry.hitCount + 1;
+    // Calculate new TTL tier based on popularity
+    const newTier = calculateTTLTier(entry.createdAt, newHitCount, now);
+    // If tier upgraded, extend expiration
+    const newExpiresAt = newTier > entry.ttlTier ? now + newTier : entry.expiresAt;
+    return {
+        ...entry,
+        hitCount: newHitCount,
+        lastAccessedAt: now,
+        ttlTier: newTier,
+        expiresAt: newExpiresAt,
+    };
+}
+/**
+ * Calculate TTL tier based on hit rate
+ */
+export function calculateTTLTier(createdAt, hitCount, now = Date.now()) {
+    const ageMs = now - createdAt;
+    // Need minimum age to evaluate popularity
+    if (ageMs < POPULARITY_THRESHOLDS.MIN_AGE_FOR_EVALUATION) {
+        return TTLTier.STANDARD;
+    }
+    // Calculate hits per hour
+    const ageHours = ageMs / (60 * 60 * 1000);
+    const hitsPerHour = hitCount / Math.max(ageHours, 1 / 60); // Min 1 minute
+    if (hitsPerHour >= POPULARITY_THRESHOLDS.POPULAR_HITS_PER_HOUR) {
+        return TTLTier.POPULAR;
+    }
+    // Check for rare: less than 1 hit per day equivalent
+    const hitsPerDay = hitsPerHour * 24;
+    if (hitsPerDay < 1 && ageHours >= 1) {
+        return TTLTier.RARE;
+    }
+    return TTLTier.STANDARD;
+}
+/**
+ * Check if cache entry is expired
+ */
+export function isExpired(entry, now = Date.now()) {
+    return now >= entry.expiresAt;
+}
+/**
+ * Check if entry should be refreshed (approaching expiration)
+ * Returns true if within 10% of TTL remaining
+ */
+export function shouldRefresh(entry, now = Date.now()) {
+    const ttl = entry.expiresAt - entry.createdAt;
+    const remaining = entry.expiresAt - now;
+    return remaining > 0 && remaining < ttl * 0.1;
+}
+/**
+ * Validate cache key for security (standards.md §4)
+ * Prevents injection attacks through cache keys
+ */
+export function isValidCacheKey(key) {
+    // Max key length
+    if (key.length > 1024) {
+        return false;
+    }
+    // Must be non-empty string
+    if (!key || typeof key !== 'string') {
+        return false;
+    }
+    // Block null bytes and control characters
+    // eslint-disable-next-line no-control-regex
+    if (/[\x00-\x1f\x7f]/.test(key)) {
+        return false;
+    }
+    return true;
+}
+/**
+ * Serialize cache entry for persistence
+ * Uses safe JSON serialization to prevent prototype pollution
+ */
+export function serializeCacheEntry(entry) {
+    return {
+        key: entry.key,
+        data_json: JSON.stringify(entry.data),
+        total_count: entry.totalCount,
+        created_at: entry.createdAt,
+        expires_at: entry.expiresAt,
+        hit_count: entry.hitCount,
+        last_accessed_at: entry.lastAccessedAt,
+        ttl_tier: entry.ttlTier,
+    };
+}
+/** Pattern to detect prototype pollution attempts (standards.md §4.4) */
+const PROTOTYPE_POLLUTION_PATTERN = /"(__proto__|prototype|constructor)"\s*:/i;
+/**
+ * SMI-684: Recursively check for dangerous keys in parsed objects
+ * Prevents prototype pollution bypass via unicode escapes (e.g., \u005f\u005fproto\u005f\u005f)
+ * which are decoded by JSON.parse before we can detect them with regex
+ */
+function hasDangerousKeys(obj, depth = 0) {
+    // Prevent stack overflow on deeply nested objects
+    if (depth > 100)
+        return false;
+    // Handle null, primitives
+    if (typeof obj !== 'object' || obj === null)
+        return false;
+    // Handle arrays - check each element
+    if (Array.isArray(obj)) {
+        for (const item of obj) {
+            if (hasDangerousKeys(item, depth + 1)) {
+                return true;
+            }
+        }
+        return false;
+    }
+    // Handle objects - check keys and recurse into values
+    const keys = Object.keys(obj);
+    for (const key of keys) {
+        // Check for dangerous keys
+        if (key === '__proto__' || key === 'prototype' || key === 'constructor') {
+            return true;
+        }
+        // Recursively check nested objects
+        if (hasDangerousKeys(obj[key], depth + 1)) {
+            return true;
+        }
+    }
+    return false;
+}
+/** Valid TTL tier values */
+const VALID_TTL_TIERS = new Set([TTLTier.POPULAR, TTLTier.STANDARD, TTLTier.RARE]);
+/**
+ * Deserialize cache entry from persistence
+ * Validates data to prevent prototype pollution (security: standards.md §4)
+ */
+export function deserializeCacheEntry(serialized) {
+    // Check for prototype pollution before parsing (standards.md §4.4)
+    // This catches simple cases like {"__proto__": {}}
+    if (PROTOTYPE_POLLUTION_PATTERN.test(serialized.data_json)) {
+        throw new Error('Prototype pollution attempt detected in cache data');
+    }
+    // Parse JSON safely
+    let data;
+    try {
+        data = JSON.parse(serialized.data_json);
+    }
+    catch {
+        throw new Error('Failed to deserialize cache entry data');
+    }
+    // SMI-684: Post-parse validation to catch unicode escape bypasses
+    // e.g., {"\\u005f\\u005fproto\\u005f\\u005f": {}} becomes {"__proto__": {}} after parse
+    if (hasDangerousKeys(data)) {
+        throw new Error('Prototype pollution attempt detected in cache data');
+    }
+    // Validate all numeric fields
+    if (typeof serialized.created_at !== 'number' ||
+        typeof serialized.expires_at !== 'number' ||
+        typeof serialized.hit_count !== 'number' ||
+        typeof serialized.last_accessed_at !== 'number' ||
+        typeof serialized.total_count !== 'number') {
+        throw new Error('Invalid cache entry: numeric fields must be numbers');
+    }
+    // Validate TTL tier is a known value
+    if (!VALID_TTL_TIERS.has(serialized.ttl_tier)) {
+        throw new Error('Invalid cache entry: unknown TTL tier');
+    }
+    return {
+        key: serialized.key,
+        data,
+        totalCount: serialized.total_count,
+        createdAt: serialized.created_at,
+        expiresAt: serialized.expires_at,
+        hitCount: serialized.hit_count,
+        lastAccessedAt: serialized.last_accessed_at,
+        ttlTier: serialized.ttl_tier,
+    };
+}
+/**
+ * Get human-readable TTL tier name
+ */
+export function getTTLTierName(tier) {
+    switch (tier) {
+        case TTLTier.POPULAR:
+            return 'popular';
+        case TTLTier.STANDARD:
+            return 'standard';
+        case TTLTier.RARE:
+            return 'rare';
+        default:
+            return 'unknown';
+    }
+}
+//# sourceMappingURL=CacheEntry.js.map

package/dist/cache/CacheEntry.js.map

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

package/dist/cache/CacheManager.d.ts

@@ -0,0 +1,178 @@
+/**
+ * SMI-644: Unified Cache Manager
+ * Provides high-level cache operations with:
+ * - Popular query detection (dynamic TTL)
+ * - Background refresh for hot entries
+ * - Cache invalidation coordination
+ * - Statistics and monitoring
+ */
+import type { SearchResult } from './lru.js';
+import { TTLTier, POPULARITY_THRESHOLDS, getTTLTierName } from './CacheEntry.js';
+import { type TieredCacheConfig, type TieredCacheStats } from './TieredCache.js';
+/**
+ * Search options for cache key generation
+ */
+export interface SearchOptions {
+    query: string;
+    filters?: Record<string, unknown>;
+    limit?: number;
+    offset?: number;
+}
+/**
+ * Refresh callback type
+ */
+export type RefreshCallback = (options: SearchOptions) => Promise<{
+    results: SearchResult[];
+    totalCount: number;
+}>;
+/**
+ * Cache manager configuration
+ */
+export interface CacheManagerConfig extends TieredCacheConfig {
+    /** Enable background refresh for hot entries (default: true) */
+    enableBackgroundRefresh?: boolean;
+    /** Background refresh interval in ms (default: 30 seconds) */
+    refreshIntervalMs?: number;
+    /** Maximum concurrent refreshes (default: 3) */
+    maxConcurrentRefreshes?: number;
+    /** Callback to refresh cache entries */
+    refreshCallback?: RefreshCallback;
+}
+/**
+ * Unified Cache Manager
+ * Coordinates L1/L2 caching with intelligent TTL management
+ */
+export declare class CacheManager {
+    private cache;
+    private config;
+    private queryFrequencies;
+    private refreshTimer;
+    /** SMI-683: Use Map<key, Promise> for proper deduplication of concurrent refreshes */
+    private activeRefreshes;
+    private refreshCallback;
+    private lastInvalidation;
+    private invalidationCallbacks;
+    /**
+     * @deprecated Use CacheManager.create(config) — async factory with WASM fallback.
+     * This constructor always throws to prevent silent data loss.
+     */
+    constructor(_config?: CacheManagerConfig);
+    /**
+     * Async factory — supports both native and WASM SQLite.
+     *
+     * @param config - Cache manager configuration
+     * @returns Fully initialised CacheManager instance
+     */
+    static create(config?: CacheManagerConfig): Promise<CacheManager>;
+    /**
+     * Generate cache key from search options
+     */
+    static generateKey(options: SearchOptions): string;
+    /**
+     * Parse search options from cache key
+     * SMI-683: Fixed regex to handle empty filters (was: .+? requires at least 1 char)
+     */
+    static parseKey(key: string): SearchOptions | null;
+    /**
+     * Get cached results for search options
+     */
+    get(options: SearchOptions): {
+        results: SearchResult[];
+        totalCount: number;
+    } | undefined;
+    /**
+     * Get or compute cached results
+     * @param options Search options
+     * @param compute Function to compute results if not cached
+     */
+    getOrCompute(options: SearchOptions, compute: () => Promise<{
+        results: SearchResult[];
+        totalCount: number;
+    }>): Promise<{
+        results: SearchResult[];
+        totalCount: number;
+    }>;
+    /**
+     * Store results in cache with automatic TTL detection
+     */
+    set(options: SearchOptions, results: SearchResult[], totalCount: number): void;
+    /**
+     * Check if results are cached
+     */
+    has(options: SearchOptions): boolean;
+    /**
+     * Delete specific cached result
+     */
+    delete(options: SearchOptions): boolean;
+    /**
+     * Invalidate all cached results
+     * Should be called when the skill index is updated
+     */
+    invalidateAll(): void;
+    /**
+     * Register callback for invalidation events
+     */
+    onInvalidate(callback: () => void): () => void;
+    /**
+     * Get time since last invalidation
+     */
+    getTimeSinceInvalidation(): number;
+    /**
+     * Prune expired entries
+     */
+    prune(): number;
+    /**
+     * Get comprehensive cache statistics
+     */
+    getStats(): TieredCacheStats & {
+        queryFrequencies: {
+            popular: number;
+            standard: number;
+            rare: number;
+        };
+        backgroundRefresh: {
+            active: number;
+            lastRun: number;
+        };
+    };
+    /**
+     * Get detailed hit rate by TTL tier
+     */
+    getHitRateByTier(): Record<string, number>;
+    /**
+     * Set the refresh callback for background refresh
+     */
+    setRefreshCallback(callback: RefreshCallback): void;
+    /**
+     * Close cache manager and cleanup resources
+     */
+    close(): void;
+    /**
+     * Record a hit for query frequency tracking
+     */
+    private recordQueryHit;
+    /**
+     * Determine TTL tier based on query frequency
+     */
+    private determineTTLTier;
+    /**
+     * Prune old query frequency entries
+     */
+    private pruneQueryFrequencies;
+    /**
+     * Start background refresh loop
+     */
+    private startBackgroundRefresh;
+    /**
+     * Perform background refresh for entries approaching expiration
+     */
+    private performBackgroundRefresh;
+    /**
+     * Refresh a single cache entry
+     * SMI-683: Fixed race condition by using Map<string, Promise<void>> for proper deduplication.
+     * Concurrent calls for the same key now return the same promise instance.
+     */
+    private refreshEntry;
+}
+export { TTLTier, getTTLTierName, POPULARITY_THRESHOLDS };
+//# sourceMappingURL=CacheManager.d.ts.map

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

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