import type { DirEntry, FileInfo, FileSystemAdapter, FileWatcher, WatchOptions } from "../../base.js";
import { setupNodeFsWatcher } from "./shared-watcher.js";
import { type NativeSnapshotPlatform } from "./native-snapshot-identity.js";
export interface NodeFileSystemLogger {
    error(message: string, context?: Record<string, unknown>): void;
    debug(message: string, context?: Record<string, unknown>): void;
}
interface NodeFileSnapshotStat {
    readonly dev: bigint;
    readonly ino: bigint;
    readonly size: bigint;
    readonly mtimeNs: bigint;
    readonly ctimeNs: bigint;
    isFile(): boolean;
    isSymbolicLink(): boolean;
}
interface NodeFileHandle {
    stat(): Promise<NodeFileSnapshotStat>;
    read(buffer: Uint8Array, offset: number, length: number, position: number): Promise<{
        bytesRead: number;
    }>;
    writeFile(content: Uint8Array): Promise<void>;
    close(): Promise<void>;
}
export interface NodeFileSystemOperations {
    realpath(path: string): Promise<string>;
    lstat(path: string): Promise<NodeFileSnapshotStat>;
    open(path: string, flags: number | string): Promise<NodeFileHandle>;
}
export interface NodeFileSystemCapabilityOptions {
    /** Test seam for runtime constants. An own undefined value means unavailable. */
    readonly noFollow?: number;
    /** Test seam for native open and path semantics. */
    readonly platform?: NativeSnapshotPlatform;
    /** Test seam for create-new primitive availability. */
    readonly exclusiveCreate?: boolean;
    /** Test seam for deterministic filesystem races and write failures. */
    readonly operations?: Partial<NodeFileSystemOperations>;
}
/** Runtime whose Node-compatible filesystem implementation backs the adapter. */
export type NodeCompatibleRuntimeProvenance = "node" | "bun" | "deno" | "unknown";
export declare function hasUsableWindowsSnapshotIdentity(runtime: NodeCompatibleRuntimeProvenance): boolean;
export declare function readNodeFileSnapshotWithinLimit(operations: NodeFileSystemOperations, platform: NativeSnapshotPlatform, noFollow: number | undefined, path: string, containmentRoot: string, byteLimit: number): Promise<Uint8Array>;
/**
 * Resolve the `O_NOFOLLOW` open flag that binds an exact-inode snapshot read.
 *
 * `constants` is `undefined` in a runtime without `node:fs` — e.g. a browser
 * bundle that transitively imports this adapter. Dereferencing `.O_NOFOLLOW` on
 * it unconditionally threw `Cannot read properties of undefined (reading
 * 'O_NOFOLLOW')` during construction and aborted client hydration (#3661).
 * Treat the missing constants as "unavailable" (`undefined`) — the same meaning
 * {@link NodeFileSystemCapabilityOptions.noFollow} already documents for an own
 * `undefined` — so `canOpenExactSnapshot` degrades to `false` instead of the
 * constructor exploding. An own `noFollow` on `options` still wins (the test seam).
 */
export declare function resolveNoFollowFlag(options: NodeFileSystemCapabilityOptions, constants: {
    readonly O_NOFOLLOW?: number;
} | undefined): number | undefined;
/**
 * Filesystem implementation shared by runtimes that provide Node-compatible
 * `node:fs` APIs (currently Node.js and Bun).
 */
export declare class NodeCompatibleFileSystemAdapter implements FileSystemAdapter {
    private readonly logger;
    constructor(logger?: NodeFileSystemLogger, options?: NodeFileSystemCapabilityOptions);
    readFile(path: string): Promise<string>;
    readFileBytes(path: string): Promise<Uint8Array>;
    readFileBytesBounded(path: string, byteLimit: number): Promise<Uint8Array>;
    readFileBytesWithinLimit(path: string, byteLimit: number): Promise<Uint8Array>;
    writeFile(path: string, content: string): Promise<void>;
    writeFileBytes(path: string, content: Uint8Array): Promise<void>;
    rename(from: string, to: string): Promise<void>;
    exists(path: string): Promise<boolean>;
    readDir(path: string): AsyncIterable<DirEntry>;
    stat(path: string): Promise<FileInfo>;
    lstat(path: string): Promise<FileInfo>;
    realPath(path: string): Promise<string>;
    mkdir(path: string, options?: {
        recursive?: boolean;
    }): Promise<void>;
    remove(path: string, options?: {
        recursive?: boolean;
    }): Promise<void>;
    makeTempDir(prefix: string): Promise<string>;
    protected setupWatcher(path: string, options: Parameters<typeof setupNodeFsWatcher>[1]): Promise<void>;
    watch(paths: string | string[], options?: WatchOptions): FileWatcher;
}
export interface NodeCompatibleFileSystemAdapter {
    readFileSnapshotWithinLimit?(path: string, containmentRoot: string, byteLimit: number): Promise<Uint8Array>;
    createFileBytesExclusive?(path: string, content: Uint8Array): Promise<void>;
}
export {};
//# sourceMappingURL=node-filesystem-adapter.d.ts.map