/** Reports bytes downloaded for a single fetch; `total` from Content-Length. */
export type ProgressCallback = (bytesReceived: number, total?: number) => void;
export type BufferEncoding = 'ascii' | 'utf8' | 'utf-8' | 'utf16le' | 'utf-16le' | 'ucs2' | 'ucs-2' | 'base64' | 'base64url' | 'latin1' | 'binary' | 'hex';
export type Fetcher = (input: RequestInfo, init?: RequestInit) => Promise<Response>;
export interface FilehandleOptions {
    signal?: AbortSignal;
    headers?: Record<string, string>;
    overrides?: Omit<RequestInit, 'headers'>;
    encoding?: BufferEncoding;
    fetch?: Fetcher;
    /**
     * Opt-in download-progress reporting. When set, the response body is streamed
     * and this is called with the running byte count (and Content-Length total
     * when available) as chunks arrive. Omitting it keeps the faster
     * non-streaming read.
     */
    onProgress?: ProgressCallback;
}
export interface Stats {
    size: number;
    /** Set by `LocalFile` */
    mtimeMs?: number;
    /** Set by `LocalFile` */
    ino?: number;
}
/** `readFile()` arguments for the byte-returning call. */
export type ReadFileOptions = Omit<FilehandleOptions, 'encoding'>;
/** `readFile()` arguments for the string-returning call. */
export type ReadFileTextOptions = BufferEncoding | (ReadFileOptions & {
    encoding: BufferEncoding;
});
export interface GenericFilehandle {
    /**
     * Where this handle's bytes come from — a URL for a remote file, a path for a
     * local one — or undefined when there is no such thing.
     *
     * Optional because "undefined" is a real answer and not a gap: a
     * {@link BlobFile} wraps bytes handed to the page, which have no address
     * anyone could go and look at. A caller showing a slow or stuck read to a
     * human wants exactly this distinction, and gets it without having to know
     * which implementation it is holding.
     *
     * It is what the handle was constructed with, so a relative URL stays
     * relative and a presigned URL keeps its query string. A caller putting one on
     * screen is the one that has to resolve or redact it.
     */
    readonly source?: string;
    read(length: number, position: number, opts?: FilehandleOptions): Promise<Uint8Array<ArrayBuffer>>;
    readFile(options?: ReadFileOptions): Promise<Uint8Array<ArrayBuffer>>;
    readFile(options: ReadFileTextOptions): Promise<string>;
    stat(): Promise<Stats>;
    close(): Promise<void>;
}