David Snelling
f8c45f2d8d
Open source vector database with HNSW indexing, graph relationships, and metadata facets. Features CLI with professional augmentation registry integration for discovering extensions and capabilities.
93 lines
2.4 KiB
TypeScript
93 lines
2.4 KiB
TypeScript
/**
|
|
* SearchCache - Caches search results for improved performance
|
|
*/
|
|
import { SearchResult } from '../coreTypes.js';
|
|
export interface CacheEntry<T = any> {
|
|
results: SearchResult<T>[];
|
|
timestamp: number;
|
|
hits: number;
|
|
}
|
|
export interface SearchCacheConfig {
|
|
maxAge?: number;
|
|
maxSize?: number;
|
|
enabled?: boolean;
|
|
hitCountWeight?: number;
|
|
}
|
|
export declare class SearchCache<T = any> {
|
|
private cache;
|
|
private maxAge;
|
|
private maxSize;
|
|
private enabled;
|
|
private hitCountWeight;
|
|
private hits;
|
|
private misses;
|
|
private evictions;
|
|
constructor(config?: SearchCacheConfig);
|
|
/**
|
|
* Generate cache key from search parameters
|
|
*/
|
|
getCacheKey(query: any, k: number, options?: Record<string, any>): string;
|
|
/**
|
|
* Get cached results if available and not expired
|
|
*/
|
|
get(key: string): SearchResult<T>[] | null;
|
|
/**
|
|
* Cache search results
|
|
*/
|
|
set(key: string, results: SearchResult<T>[]): void;
|
|
/**
|
|
* Evict the oldest entry based on timestamp and hit count
|
|
*/
|
|
private evictOldest;
|
|
/**
|
|
* Clear all cached results
|
|
*/
|
|
clear(): void;
|
|
/**
|
|
* Invalidate cache entries that might be affected by data changes
|
|
*/
|
|
invalidate(pattern?: string | RegExp): void;
|
|
/**
|
|
* Smart invalidation for real-time data updates
|
|
* Only clears cache if it's getting stale or if data changes significantly
|
|
*/
|
|
invalidateOnDataChange(changeType?: 'add' | 'update' | 'delete'): void;
|
|
/**
|
|
* Check if cache entries have expired and remove them
|
|
* This is especially important in distributed scenarios where
|
|
* real-time updates might be delayed or missed
|
|
*/
|
|
cleanupExpiredEntries(): number;
|
|
/**
|
|
* Get cache statistics
|
|
*/
|
|
getStats(): {
|
|
hits: number;
|
|
misses: number;
|
|
evictions: number;
|
|
hitRate: number;
|
|
size: number;
|
|
maxSize: number;
|
|
enabled: boolean;
|
|
};
|
|
/**
|
|
* Enable or disable caching
|
|
*/
|
|
setEnabled(enabled: boolean): void;
|
|
/**
|
|
* Get memory usage estimate in bytes
|
|
*/
|
|
getMemoryUsage(): number;
|
|
/**
|
|
* Get current cache configuration
|
|
*/
|
|
getConfig(): SearchCacheConfig;
|
|
/**
|
|
* Update cache configuration dynamically
|
|
*/
|
|
updateConfig(newConfig: Partial<SearchCacheConfig>): void;
|
|
/**
|
|
* Evict entries if cache exceeds maxSize
|
|
*/
|
|
private evictIfNeeded;
|
|
}
|