import { ILogHandler, LogLevel, LogMetadata } from '../types/index.js';
/**
 * Universal file-based log handler for persistent logging
 * Works in both Node.js (real files) and browser (localStorage)
 */
export declare class FileLogHandler implements ILogHandler {
    private filename;
    private maxSize?;
    private fs?;
    constructor(filename?: string, maxSize?: number);
    handle(level: LogLevel, message: string, args: any[], metadata: LogMetadata): void;
    /**
     * Format log entry as a single line for file storage
     */
    private formatLogLine;
    /**
     * Write to actual file in Node.js environment
     */
    private writeToFileNode;
    /**
     * Write to localStorage in browser environment
     */
    private writeToFileLocal;
    /**
     * Get stored logs (useful for debugging)
     */
    getLogs(): string | null;
    /**
     * Clear stored logs
     */
    clearLogs(): void;
}
//# sourceMappingURL=FileLogHandler.d.ts.map