/**
 * @fileoverview Caching infrastructure
 * @module @nahisaho/musubix-security/infrastructure/cache
 * @trace REQ-SEC-CACHE-001
 */
import type { CacheStrategy } from '../types/index.js';
/**
 * Cache statistics
 */
export interface CacheStats {
    hits: number;
    misses: number;
    size: number;
    entryCount: number;
    hitRate: number;
}
/**
 * Cache options
 */
export interface CacheOptions {
    /** Cache strategy */
    strategy: CacheStrategy;
    /** Cache directory for file strategy */
    cacheDir?: string;
    /** TTL in seconds */
    ttlSeconds?: number;
    /** Maximum cache size in bytes */
    maxSizeBytes?: number;
}
/**
 * Abstract cache interface
 */
export interface ICache<T = unknown> {
    get(key: string): Promise<T | undefined>;
    set(key: string, value: T, ttlSeconds?: number): Promise<void>;
    has(key: string): Promise<boolean>;
    delete(key: string): Promise<boolean>;
    clear(): Promise<void>;
    getStats(): CacheStats | Promise<CacheStats>;
}
/**
 * Memory cache implementation
 */
export declare class MemoryCache<T = unknown> implements ICache<T> {
    private cache;
    private stats;
    private maxSizeBytes;
    private defaultTtlSeconds;
    private currentSize;
    constructor(options?: CacheOptions);
    get(key: string): Promise<T | undefined>;
    set(key: string, value: T, ttlSeconds?: number): Promise<void>;
    has(key: string): Promise<boolean>;
    delete(key: string): Promise<boolean>;
    clear(): Promise<void>;
    getStats(): CacheStats;
    private evictOldest;
}
/**
 * File-based cache implementation
 */
export declare class FileCache<T = unknown> implements ICache<T> {
    private stats;
    private cacheDir;
    private defaultTtlSeconds;
    private initialized;
    constructor(options: CacheOptions);
    private ensureDir;
    private getCachePath;
    get(key: string): Promise<T | undefined>;
    set(key: string, value: T, ttlSeconds?: number): Promise<void>;
    has(key: string): Promise<boolean>;
    delete(key: string): Promise<boolean>;
    clear(): Promise<void>;
    getStats(): Promise<CacheStats>;
}
/**
 * No-op cache implementation
 */
export declare class NoopCache<T = unknown> implements ICache<T> {
    get(_key: string): Promise<T | undefined>;
    set(_key: string, _value: T): Promise<void>;
    has(_key: string): Promise<boolean>;
    delete(_key: string): Promise<boolean>;
    clear(): Promise<void>;
    getStats(): CacheStats;
}
/**
 * Create a cache instance based on options
 */
export declare function createCache<T = unknown>(options: CacheOptions): ICache<T>;
/**
 * Generate a cache key from multiple parts
 */
export declare function cacheKey(...parts: (string | number | boolean | undefined | null)[]): string;
/**
 * Generate a hash for a file's content
 */
export declare function contentHash(content: string): string;
//# sourceMappingURL=cache.d.ts.map