import { ReadableStream } from 'web-streams-polyfill';
import { DataRuntime, DataToolkit, ProgressData, ProgressEventTarget } from './utility';
export declare enum BodyRequestMethods {
    POST = "POST",
    PUT = "PUT",
    PATCH = "PATCH",
    DELETE = "DELETE"
}
export interface RequestOptions {
    withCredentials?: boolean;
    timeout?: number;
    responseType?: XMLHttpRequestResponseType;
}
export interface Request<T = any> extends RequestOptions {
    method?: 'HEAD' | 'GET' | keyof typeof BodyRequestMethods;
    path: string | URL;
    headers?: HeadersInit;
    body?: BodyInit | HTMLFormElement | T;
    signal?: AbortSignal;
}
export interface Response<B = Request['body']> {
    status: number;
    statusText: string;
    headers: Record<string, string | object>;
    body?: B;
}
export declare class HTTPError<B = Request['body']> extends URIError {
    request: Request;
    response: Response<B>;
    constructor(message: string, request: Request, response: Response<B>);
}
export type LinkHeader = Record<string, {
    URI: string;
    rel: string;
    title?: string;
}>;
export declare const headerParser: {
    Link: (value: string) => LinkHeader;
};
export declare const parseHeaders: (raw: string) => Response["headers"];
export declare function parseBody<T>(raw: string, contentType: string): T;
export interface RequestResult<B> {
    response: Promise<Response<B>>;
    upload?: AsyncGenerator<ProgressData>;
    download: AsyncGenerator<ProgressData>;
}
/**
 * Minimum byte count for magic-number–based file type detection,
 * consistent with the file-type library
 * {@link https://github.com/sindresorhus/file-type}.
 */
export declare const FILE_TYPE_MAGIC_NUMBER_SIZE = 4100;
export interface HeadResponse {
    headers: Response['headers'];
    /** First {@link FILE_TYPE_MAGIC_NUMBER_SIZE} bytes from the response body. */
    body?: ArrayBuffer;
}
export type HTTPRuntime = DataRuntime & Partial<Pick<typeof globalThis, 'EventTarget' | 'XMLHttpRequest' | 'Headers' | 'fetch'>>;
export declare const defaultHTTPRuntime: HTTPRuntime;
export declare class HTTPToolkit extends DataToolkit {
    runtime: HTTPRuntime;
    constructor(runtime?: HTTPRuntime);
    requestXHR: <B>({ method, path, headers, body, signal, ...rest }: Request) => RequestResult<B>;
    requestFetch: <B>({ path, method, headers, withCredentials, body, signal, timeout, responseType }: Request) => RequestResult<B>;
    parseResponse: <B>({ status, statusText, headers, body }: globalThis.Response, responseType: Request["responseType"], downloadProgress: ProgressEventTarget) => Promise<Response<B>>;
    parseFetchBody: <B>(stream: ReadableStream<Uint8Array>, contentType: string, responseType: Request["responseType"]) => Promise<B>;
    rawRequest: <B>({ method, path, headers, body, signal, ...rest }: Request) => RequestResult<B>;
    /**
     * Sends a `HEAD` request, falling back to simulation when the server does
     * not support `HEAD`. Tries, in order:
     * 1. A standard `HEAD` request via `fetch()`.
     * 2. A `Range` GET to retrieve the first {@link FILE_TYPE_MAGIC_NUMBER_SIZE}
     *    bytes (magic-number file header).
     * 3. A plain `GET` that reads the first {@link FILE_TYPE_MAGIC_NUMBER_SIZE}
     *    bytes then cancels the body stream.
     */
    requestHead: ({ path, headers, withCredentials, timeout, signal }: Request) => Promise<HeadResponse>;
    /**
     * Sends a {@link Request}, with automatic HEAD-simulation fallback for
     * servers that do not support the `HEAD` method.
     */
    request: <B>(option: Request) => RequestResult<B>;
}
export declare const requestXHR: <B>({ method, path, headers, body, signal, ...rest }: Request) => RequestResult<B>, requestFetch: <B>({ path, method, headers, withCredentials, body, signal, timeout, responseType }: Request) => RequestResult<B>, parseResponse: <B>({ status, statusText, headers, body }: globalThis.Response, responseType: Request["responseType"], downloadProgress: ProgressEventTarget) => Promise<Response<B>>, parseFetchBody: <B>(stream: ReadableStream<Uint8Array>, contentType: string, responseType: Request["responseType"]) => Promise<B>, rawRequest: <B>({ method, path, headers, body, signal, ...rest }: Request) => RequestResult<B>, requestHead: ({ path, headers, withCredentials, timeout, signal }: Request) => Promise<HeadResponse>, request: <B>(option: Request) => RequestResult<B>;