import { type OpenApiSourceFileSystem } from "./spec-source.js";
import type { OpenApiDocument } from "./generate.js";
export declare const DEFAULT_OPENAPI_FETCH_TIMEOUT_MS = 3000;
export declare const DEFAULT_OPENAPI_CACHE_MAX_AGE_MS: number;
export interface OpenApiSpecCacheOptions {
    directory?: string;
    maxAgeMs?: number;
    onFallback?: (message: string) => void | Promise<void>;
}
export interface LoadCachedOpenApiSourceOptions {
    cache: false | OpenApiSpecCacheOptions;
    fetch: typeof globalThis.fetch;
    fs: OpenApiSpecCacheFileSystem;
    onTimeout?: (context: OpenApiTimeoutContext) => void | Promise<void>;
    timeoutMs?: number;
}
export interface OpenApiTimeoutContext {
    source: string;
    timeoutMs: number;
    usingCachedDocument: boolean;
}
export interface OpenApiSpecCacheFileSystem extends OpenApiSourceFileSystem {
    writeFile?(filePath: string, contents: string, options?: {
        encoding?: BufferEncoding;
        flag?: string;
        mode?: number;
    }): Promise<void>;
    rename?(fromPath: string, toPath: string): Promise<void>;
    mkdir?(directoryPath: string, options?: {
        recursive?: boolean;
        mode?: number;
    }): Promise<unknown>;
    unlink?(filePath: string): Promise<void>;
    realpath?(filePath: string): Promise<string>;
}
export interface LoadedOpenApiSource {
    sourceText: string;
    document: OpenApiDocument;
    commit?: () => Promise<void>;
}
export declare function loadCachedOpenApiSource(inputUrl: URL, options: LoadCachedOpenApiSourceOptions): Promise<LoadedOpenApiSource>;