/**
 * KVAdapter - Cloudflare KV storage adapter
 * Optimized for document storage, caching, and warm tier data
 */
import { KeyValueAdapter, StorageResult, PerformanceMetrics, AdapterConfig, Document, DocumentQuery } from '../interfaces/storage-engine';
export interface KVConfig extends AdapterConfig {
    namespace: KVNamespace;
    defaultTTL: number;
    compressionThreshold: number;
    compressionAlgorithm: 'gzip' | 'brotli';
    cacheTTL: number;
    maxKeySize: number;
    maxValueSize: number;
}
export interface KVDocument {
    document: Document;
    metadata: {
        compressed: boolean;
        size: number;
        createdAt: string;
        updatedAt: string;
        version: number;
    };
}
export declare class KVAdapter implements KeyValueAdapter {
    readonly backend = "kv";
    private kv;
    private config;
    private metrics;
    private compressionCache;
    constructor(config: KVConfig);
    initialize(): Promise<void>;
    destroy(): Promise<void>;
    health(): Promise<boolean>;
    getMetrics(): Promise<PerformanceMetrics>;
    put(key: string, value: any, options?: {
        ttl?: number;
        metadata?: Record<string, string>;
    }): Promise<StorageResult<boolean>>;
    get(key: string): Promise<StorageResult<{
        value: any;
        metadata?: Record<string, string>;
    }>>;
    delete(key: string): Promise<StorageResult<boolean>>;
    list(prefix?: string, limit?: number): Promise<StorageResult<Array<{
        key: string;
        metadata?: any;
    }>>>;
    putDocument(collection: string, document: Document): Promise<StorageResult<Document>>;
    getDocument(collection: string, id: string): Promise<StorageResult<Document | null>>;
    deleteDocument(collection: string, id: string): Promise<StorageResult<boolean>>;
    findDocuments(collection: string, query: DocumentQuery): Promise<StorageResult<Document[]>>;
    putCache(key: string, value: any, ttl?: number): Promise<StorageResult<boolean>>;
    getCache(key: string): Promise<StorageResult<any>>;
    deleteCache(key: string): Promise<StorageResult<boolean>>;
    putMany(items: Array<{
        key: string;
        value: any;
        options?: any;
    }>): Promise<StorageResult<number>>;
    private getDocumentKey;
    private validateKey;
    private validateValueSize;
    private serializeValue;
    private deserializeValue;
    private compressValue;
    private decompressValue;
    private matchesFilter;
    private getNestedValue;
    private sortDocuments;
    private updateMetrics;
    private createStorageError;
    private isRetryableError;
}
//# sourceMappingURL=kv-adapter.d.ts.map