export type FilesErrorCode = "NotFound" | "Unauthorized" | "Conflict" | "ReadOnly" | "Provider";
export type ProviderFilesErrorCode = Exclude<FilesErrorCode, "ReadOnly">;
export declare class FilesError extends Error {
    readonly code: FilesErrorCode;
    readonly aborted: boolean;
    /**
     * `true` when the operation was cut off by a configured `timeout` rather
     * than a caller's abort signal. Timeouts also set `aborted` (the attempt
     * was cancelled either way), so this is the bit that tells "the backend
     * hung" apart from "the caller changed their mind" — `failover()` uses it
     * to try the next backend on a timeout but respect a deliberate abort.
     */
    readonly timedOut: boolean;
    /**
     * `true` when the failure is deterministic — re-issuing the identical
     * request can only fail the same way (a host that ignores `Range`, a
     * delimiter the provider can't honor). `Provider`-coded errors are
     * otherwise presumed transient and retried; this flag opts a specific
     * failure out of that.
     */
    readonly permanent: boolean;
    /**
     * The original provider error, preserved for debugging.
     *
     * **Logging note:** provider errors (especially from `@aws-sdk`) can carry
     * fields like request IDs, response headers, and partial request metadata.
     * If you serialize `FilesError` into logs that cross a trust boundary,
     * consider stripping `cause` or whitelisting fields rather than
     * `JSON.stringify`-ing the whole thing.
     */
    readonly cause?: unknown;
    constructor(code: FilesErrorCode, message: string, cause?: unknown, opts?: {
        aborted?: boolean;
        timedOut?: boolean;
        permanent?: boolean;
    });
    static wrap(err: unknown, fallbackCode?: FilesErrorCode): FilesError;
}
//# sourceMappingURL=errors.d.ts.map