import type { FileInfo } from "../adapters/base.js";
import { isNotFoundError } from "./not-found-error.js";
export { isNotFoundError };
/** Stable native identity for one filesystem object. */
export interface PathIdentity {
    readonly device: string;
    readonly inode: string;
}
/**
 * Runtime-neutral filesystem contract.
 *
 * Operations reject filesystem failures. Callers that intentionally tolerate a
 * missing path can classify the rejection with {@link isNotFoundError}.
 */
export interface FileSystem {
    readTextFile(path: string): Promise<string>;
    readFile(path: string): Promise<Uint8Array>;
    /** Exact bounded binary read; implementations must reject oversized files before materializing them. */
    readFileBytesWithinLimit?(path: string, byteLimit: number): Promise<Uint8Array>;
    readFileSnapshotWithinLimit?(path: string, containmentRoot: string, byteLimit: number): Promise<Uint8Array>;
    writeTextFile(path: string, data: string): Promise<void>;
    writeFile(path: string, data: Uint8Array): Promise<void>;
    createFileBytesExclusive?(path: string, data: Uint8Array): Promise<void>;
    /** Atomically replace a path when same-filesystem rename is supported. */
    rename?(from: string, to: string): Promise<void>;
    exists(path: string): Promise<boolean>;
    stat(path: string): Promise<FileInfo>;
    lstat?(path: string): Promise<FileInfo>;
    mkdir(path: string, options?: {
        recursive?: boolean;
    }): Promise<void>;
    readDir(path: string): AsyncIterable<{
        name: string;
        isFile: boolean;
        isDirectory: boolean;
        isSymlink?: boolean;
    }>;
    /** Remove a path, rejecting when it does not exist. */
    remove(path: string, options?: {
        recursive?: boolean;
    }): Promise<void>;
    /** Atomically create a unique directory beneath the operating-system temp root. */
    makeTempDir(options?: {
        prefix?: string;
    }): Promise<string>;
    /** Change permissions, rejecting operational failures. */
    chmod(path: string, mode: number): Promise<void>;
}
/** Create the runtime-native filesystem implementation. */
export declare function createFileSystem(): FileSystem;
/** Read a file as text. */
export declare function readTextFile(path: string): Promise<string>;
/** Read a file as bytes. */
export declare function readFile(path: string): Promise<Uint8Array>;
/** Write text to a file. */
export declare function writeTextFile(path: string, data: string): Promise<void>;
/** Write bytes to a file. */
export declare function writeFile(path: string, data: Uint8Array): Promise<void>;
/** Return false for a missing path and propagate every other filesystem error. */
export declare function exists(path: string): Promise<boolean>;
/** Read file metadata. */
export declare function stat(path: string): Promise<FileInfo>;
/** Read file metadata without following a terminal symbolic link. */
export declare function lstat(path: string): Promise<FileInfo>;
/**
 * Read a path's native device/inode identity without following a terminal
 * symbolic link. Returns undefined only when the runtime cannot expose a
 * stable identity for the backing filesystem.
 */
export declare function getPathIdentity(path: string): Promise<PathIdentity | undefined>;
/** Create a directory. */
export declare function mkdir(path: string, options?: {
    recursive?: boolean;
}): Promise<void>;
/** Remove a file or directory, rejecting when the path does not exist. */
export declare function remove(path: string, options?: {
    recursive?: boolean;
}): Promise<void>;
/** Read directory entries. */
export declare function readDir(path: string): AsyncIterable<{
    name: string;
    isFile: boolean;
    isDirectory: boolean;
    isSymlink?: boolean;
}>;
/** Atomically create a unique directory beneath the operating-system temp root. */
export declare function makeTempDir(options?: {
    prefix?: string;
}): Promise<string>;
/** Change file permissions, rejecting operational failures. */
export declare function chmod(path: string, mode: number): Promise<void>;
export declare function symlink(target: string, path: string): Promise<void>;
/**
 * Resolve a path to its canonical absolute form, following symlinks.
 * Throws if the path does not exist. Useful for containment checks where a
 * symlink could otherwise escape an intended directory.
 */
export declare function realPath(path: string): Promise<string>;
/** Error shape for is already exists. */
export declare function isAlreadyExistsError(error: unknown): boolean;
//# sourceMappingURL=fs.d.ts.map