export declare class FileHandler {
    private static locks;
    private static readonly RETRY_COUNT;
    private static readonly RETRY_DELAY;
    private static readonly CONCURRENCY_LIMIT;
    /**
     * 并发控制
     * @param operation 要执行的操作
     * @param limit 并发限制
     * @returns 操作结果
     */
    private static withConcurrencyLimit;
    /**
     * 文件操作包装器
     * @param filePath 文件路径
     * @param operation 要执行的操作
     * @returns 操作结果
     */
    private static withFileOp;
    /**
     * 事务处理
     * @param operations 要执行的操作数组
     * @returns 操作结果数组
     */
    static withTransaction<T>(operations: Array<{
        filePath: string;
        operation: () => Promise<T>;
        rollback?: () => Promise<void>;
    }>): Promise<T[]>;
    /**
     * 读取 JSON 数据
     * @param filePath 文件路径
     * @returns JSON 数据
     */
    static readJsonData<T>(filePath: string): Promise<T[]>;
    /**
     * 写入 JSON 数据
     * @param filePath 文件路径
     * @param data 要写入的数据
     */
    static writeJsonData<T>(filePath: string, data: T[]): Promise<void>;
    /**
     * 确保目录存在
     * @param dir 目录路径
     */
    static ensureDirectory(dir: string): Promise<void>;
    /**
     * 确保 JSON 文件存在
     * @param filePath 文件路径
     */
    static ensureJsonFile(filePath: string): Promise<void>;
    /**
     * 保存媒体文件
     * @param filePath 文件路径
     * @param data 文件数据
     */
    static saveMediaFile(filePath: string, data: Buffer | string): Promise<void>;
    /**
     * 删除媒体文件
     * @param filePath 文件路径
     */
    static deleteMediaFile(filePath: string): Promise<void>;
}