import { Storage } from '../utils/storage';
import { GeneratedPage } from '../providers/types';
export interface GeneratedPageCacheOptions {
    maxPages?: number;
    maxBytes?: number;
}
/**
 * Normalize a URL for cache-key purposes: lowercase host, strip fragment,
 * strip trailing slash, drop default ports.
 */
export declare function normalizeCacheUrl(url: string): string;
export interface GeneratedPageCache {
    /** Look up a cached page. Returns null on cache miss. */
    get(url: string): Promise<GeneratedPage | null>;
    /** Store a generated page. Returns false if the budget is exceeded. */
    put(url: string, page: GeneratedPage): Promise<boolean>;
    /** Whether the budget allows one more page. */
    hasCapacity(): Promise<boolean>;
    /** Current cache stats. */
    stats(): Promise<{
        count: number;
        bytes: number;
        maxPages: number;
        maxBytes: number;
    }>;
    /** Clear all cached pages. */
    clear(): Promise<void>;
}
export declare function createGeneratedPageCache(storage: Storage, options?: GeneratedPageCacheOptions): GeneratedPageCache;