import type { DirEntry, FileInfo, FileSystemAdapter, FileWatcher, ResolveFileOptions, SourceSnapshotFreshnessOptions, WatchOptions } from "../base.js";
import type { DirectoryEntry, FSAdapter } from "./veryfront/types.js";
export interface ExtendedFileSystemAdapter extends FileSystemAdapter {
    getUnderlyingAdapter(): FSAdapter;
    getAdapterType(): string;
    isVeryfrontAdapter(): boolean;
    isMultiProjectMode(): boolean;
    isContextualMode(): boolean;
    isFixedProjectMode(): boolean;
    setRequestToken(token: string): void;
    clearRequestToken(): void;
    setRequestBranch(branch: string | null): void;
    getRequestBranch(): string | null;
    clearRequestBranch(): void;
    setProductionMode(enabled: boolean, releaseId?: string | null): void;
    runWithContext<T>(projectSlug: string, token: string, fn: () => Promise<T>, projectId?: string, options?: {
        productionMode?: boolean;
        releaseId?: string | null;
        branch?: string | null;
        environmentName?: string | null;
    }): Promise<T>;
    readFileBytes(path: string): Promise<Uint8Array>;
    readonly maxWholeFileReadBytes?: number;
    readonly readFileBytesBounded?: (path: string, byteLimit: number) => Promise<Uint8Array>;
    readonly readFileBytesWithinLimit?: (path: string, byteLimit: number) => Promise<Uint8Array>;
    readonly readFileSnapshotWithinLimit?: (path: string, containmentRoot: string, byteLimit: number) => Promise<Uint8Array>;
    readonly createFileBytesExclusive?: (path: string, content: Uint8Array) => Promise<void>;
    readOptionalTextFile(path: string): Promise<string>;
    readdir(path: string): Promise<DirectoryEntry[]>;
    shutdown(): Promise<void>;
}
export declare function isExtendedFSAdapter(fs: FileSystemAdapter): fs is ExtendedFileSystemAdapter;
/**
 * Check if the adapter is using a virtual filesystem (Veryfront API, GitHub, etc.)
 * Centralized predicate — use this instead of inline checks.
 */
export declare function isVirtualFilesystem(fs: FileSystemAdapter): boolean;
export declare class NotSupportedError extends Error {
    constructor(operation: string, adapterType?: string);
}
export declare class FSAdapterWrapper implements ExtendedFileSystemAdapter {
    #private;
    private readonly _fsAdapter;
    private readonly _unboundedFileReader?;
    private readonly _wholeFileReader?;
    private readonly _fixedProjectMode;
    readonly symlinkSemantics: "none" | undefined;
    readonly projectContextSemantics: "fixed" | undefined;
    readonly maxWholeFileReadBytes?: number;
    readonly readFileBytesBounded?: (path: string, byteLimit: number) => Promise<Uint8Array>;
    readonly readFileBytesWithinLimit?: (path: string, byteLimit: number) => Promise<Uint8Array>;
    readonly readFileSnapshotWithinLimit?: (path: string, containmentRoot: string, byteLimit: number) => Promise<Uint8Array>;
    readonly createFileBytesExclusive?: (path: string, content: Uint8Array) => Promise<void>;
    readonly refreshSourceSnapshot?: (reason?: string) => Promise<void>;
    readonly ensureSourceSnapshotFresh?: (reason?: string, options?: SourceSnapshotFreshnessOptions) => Promise<void>;
    readonly sourceSnapshotFreshnessOptionsVersion?: 1;
    readonly getSourceSnapshotVersion?: () => number | undefined | Promise<number | undefined>;
    readonly getSourceSnapshotFingerprint?: () => string | undefined | Promise<string | undefined>;
    readonly getSourceSnapshotIdentity?: () => string | undefined | Promise<string | undefined>;
    constructor(fsAdapter: FSAdapter);
    getUnderlyingAdapter(): FSAdapter;
    getAdapterType(): string;
    isVeryfrontAdapter(): boolean;
    private get adapterType();
    private get contextual();
    private requireContextualMethod;
    setRequestToken(token: string): void;
    clearRequestToken(): void;
    setRequestBranch(branch: string | null): void;
    getRequestBranch(): string | null;
    clearRequestBranch(): void;
    setProductionMode(enabled: boolean, releaseId?: string | null): void;
    runWithContext<T>(projectSlug: string, token: string, fn: () => Promise<T>, projectId?: string, options?: {
        productionMode?: boolean;
        releaseId?: string | null;
        branch?: string | null;
        environmentName?: string | null;
    }): Promise<T>;
    isMultiProjectMode(): boolean;
    isFixedProjectMode(): boolean;
    isContextualMode(): boolean;
    readFile(path: string): Promise<string>;
    readOptionalTextFile(path: string): Promise<string>;
    readFileBytes(path: string): Promise<Uint8Array>;
    writeFile(path: string, content: string): Promise<void>;
    exists(path: string): Promise<boolean>;
    private getDirEntries;
    readDir(path: string): AsyncIterable<DirEntry>;
    readdir(path: string): Promise<DirectoryEntry[]>;
    stat(path: string): Promise<FileInfo>;
    resolveFile(basePath: string, options?: ResolveFileOptions): Promise<string | null>;
    mkdir(path: string, options?: {
        recursive?: boolean;
    }): Promise<void>;
    remove(path: string, options?: {
        recursive?: boolean;
    }): Promise<void>;
    makeTempDir(_prefix: string): Promise<string>;
    watch(_paths: string | string[], _options?: WatchOptions): FileWatcher;
    shutdown(): Promise<void>;
}
export declare function wrapFSAdapter(fsAdapter: FSAdapter): ExtendedFileSystemAdapter;
//# sourceMappingURL=wrapper.d.ts.map