import * as fs from 'node:fs';
/**
 * This module exists to isolate filesystem operations from the rest of the codebase.
 * This makes testing easier by avoiding direct fs mocking in jest configuration.
 *
 * Additionally, abstracting storage operations allows for future flexibility -
 * this export utility may need to work with storage systems other than the local filesystem
 * (e.g. S3, Google Cloud Storage, etc).
 */
export interface Utility {
    exists: (path: string) => Promise<boolean>;
    isDirectory: (path: string) => Promise<boolean>;
    isFile: (path: string) => Promise<boolean>;
    isReadable: (path: string) => Promise<boolean>;
    isWritable: (path: string) => Promise<boolean>;
    isFileReadable: (path: string) => Promise<boolean>;
    isDirectoryWritable: (path: string) => Promise<boolean>;
    isDirectoryReadable: (path: string) => Promise<boolean>;
    createDirectory: (path: string) => Promise<void>;
    readFile: (path: string, encoding: string) => Promise<string>;
    readStream: (path: string) => Promise<fs.ReadStream>;
    writeFile: (path: string, data: string | Buffer, encoding: string) => Promise<void>;
    forEachFileIn: (directory: string, callback: (path: string) => Promise<void>, options?: {
        pattern: string;
        limit?: number;
        concurrency?: number;
    }) => Promise<void>;
    hashFile: (path: string, length: number) => Promise<string>;
    listFiles: (directory: string) => Promise<string[]>;
}
export declare const create: (params: {
    log?: (message: string, ...args: any[]) => void;
}) => Utility;