/**
 * Fetches a remote document over http(s) with optional auth headers,
 * a timeout, and typed errors. Used by every input parser when
 * `inputPath` is a URL.
 *
 * SECURITY NOTE: When `auth` is configured, the headers are sent to
 * **every** URL fetched through this helper, including external `$ref`
 * targets on other hosts. See docs/configurations#auth-scope for details.
 */
import { InputAuthConfig } from '../codegen/types';
export interface FetchedDocument {
    content: string;
    contentType: string | null;
    finalUrl: string;
}
export declare function fetchRemoteDocument(url: string, auth?: InputAuthConfig, options?: {
    timeoutMs?: number;
}): Promise<FetchedDocument>;