@npy/fetch 0.1.0 → 0.1.1

package/src/errors.d.cts

@@ -0,0 +1,110 @@
+export declare const ErrorType: {
+    readonly ABORTED: "ABORTED";
+    readonly NETWORK: "NETWORK";
+    readonly TIMEOUT: "TIMEOUT";
+    readonly HTTP_CLIENT_ERROR: "HTTP_CLIENT_ERROR";
+    readonly HTTP_SERVER_ERROR: "HTTP_SERVER_ERROR";
+};
+export type ErrorType = (typeof ErrorType)[keyof typeof ErrorType];
+export declare const FetchErrorCode: {
+    readonly ABORTED: "ERR_FETCH_ABORTED";
+    readonly TIMEOUT: "ERR_FETCH_TIMEOUT";
+    readonly CONNECTION: "ERR_FETCH_CONNECTION";
+    readonly AGENT_CLOSED: "ERR_FETCH_AGENT_CLOSED";
+    readonly AGENT_BUSY: "ERR_FETCH_AGENT_BUSY";
+    readonly ORIGIN_MISMATCH: "ERR_FETCH_ORIGIN_MISMATCH";
+    readonly UNSUPPORTED_PROTOCOL: "ERR_FETCH_UNSUPPORTED_PROTOCOL";
+    readonly UNSUPPORTED_METHOD: "ERR_FETCH_UNSUPPORTED_METHOD";
+    readonly TLS_ALPN: "ERR_FETCH_TLS_ALPN";
+    readonly REQUEST_WRITE: "ERR_FETCH_REQUEST_WRITE";
+    readonly RESPONSE_HEADERS: "ERR_FETCH_RESPONSE_HEADERS";
+    readonly RESPONSE_BODY: "ERR_FETCH_RESPONSE_BODY";
+    readonly RESPONSE_DECODE: "ERR_FETCH_RESPONSE_DECODE";
+    readonly HTTP_STATUS: "ERR_FETCH_HTTP_STATUS";
+};
+export type FetchErrorCode = (typeof FetchErrorCode)[keyof typeof FetchErrorCode];
+export type FetchErrorPhase = "agent" | "connect" | "request" | "response" | "body" | "decode" | "policy";
+export interface FetchErrorContext {
+    url?: string;
+    method?: string;
+    origin?: string;
+    scheme?: string;
+    host?: string;
+    port?: number;
+    status?: number;
+    alpn?: string | null;
+    details?: Record<string, unknown>;
+}
+export interface FetchErrorOptions {
+    message: string;
+    code: FetchErrorCode;
+    phase: FetchErrorPhase;
+    cause?: unknown;
+    context?: FetchErrorContext;
+    retryable?: boolean;
+    type?: ErrorType;
+}
+export declare class FetchError extends Error {
+    readonly code: FetchErrorCode;
+    readonly phase: FetchErrorPhase;
+    readonly context?: FetchErrorContext;
+    readonly retryable: boolean;
+    readonly type?: ErrorType;
+    readonly cause: unknown;
+    constructor(options: FetchErrorOptions);
+    get name(): string;
+    get [Symbol.toStringTag](): string;
+    toJSON(): {
+        name: string;
+        message: string;
+        code: FetchErrorCode;
+        phase: FetchErrorPhase;
+        retryable: boolean;
+        type: ErrorType | undefined;
+        context: FetchErrorContext | undefined;
+        cause: unknown;
+    };
+}
+export declare class RequestAbortedError extends FetchError {
+    constructor(cause?: unknown, context?: FetchErrorContext, message?: string);
+}
+export declare class ConnectTimeoutError extends FetchError {
+    constructor(cause?: unknown, context?: FetchErrorContext, message?: string);
+}
+export declare class ConnectionError extends FetchError {
+    constructor(cause?: unknown, context?: FetchErrorContext, message?: string);
+}
+export declare class AgentClosedError extends FetchError {
+    constructor(context?: FetchErrorContext, cause?: unknown);
+}
+export declare class AgentBusyError extends FetchError {
+    constructor(context?: FetchErrorContext, cause?: unknown);
+}
+export declare class OriginMismatchError extends FetchError {
+    constructor(expectedOrigin: string, actualOrigin: string, context?: FetchErrorContext);
+}
+export declare class UnsupportedProtocolError extends FetchError {
+    constructor(protocol: string, context?: FetchErrorContext);
+}
+export declare class UnsupportedMethodError extends FetchError {
+    constructor(method: string, context?: FetchErrorContext);
+}
+export declare class UnsupportedAlpnProtocolError extends FetchError {
+    constructor(alpn: string, context?: FetchErrorContext, cause?: unknown);
+}
+export declare class RequestWriteError extends FetchError {
+    constructor(cause?: unknown, context?: FetchErrorContext, message?: string);
+}
+export declare class ResponseHeaderError extends FetchError {
+    constructor(cause?: unknown, context?: FetchErrorContext, message?: string);
+}
+export declare class ResponseBodyError extends FetchError {
+    constructor(cause?: unknown, context?: FetchErrorContext, message?: string);
+}
+export declare class ResponseDecodeError extends FetchError {
+    constructor(cause?: unknown, context?: FetchErrorContext, message?: string);
+}
+export declare class HttpStatusError extends FetchError {
+    readonly statusCode: number;
+    constructor(statusCode: number, context?: FetchErrorContext, cause?: unknown, message?: string);
+}

package/src/errors.d.ts

@@ -0,0 +1,110 @@
+export declare const ErrorType: {
+    readonly ABORTED: "ABORTED";
+    readonly NETWORK: "NETWORK";
+    readonly TIMEOUT: "TIMEOUT";
+    readonly HTTP_CLIENT_ERROR: "HTTP_CLIENT_ERROR";
+    readonly HTTP_SERVER_ERROR: "HTTP_SERVER_ERROR";
+};
+export type ErrorType = (typeof ErrorType)[keyof typeof ErrorType];
+export declare const FetchErrorCode: {
+    readonly ABORTED: "ERR_FETCH_ABORTED";
+    readonly TIMEOUT: "ERR_FETCH_TIMEOUT";
+    readonly CONNECTION: "ERR_FETCH_CONNECTION";
+    readonly AGENT_CLOSED: "ERR_FETCH_AGENT_CLOSED";
+    readonly AGENT_BUSY: "ERR_FETCH_AGENT_BUSY";
+    readonly ORIGIN_MISMATCH: "ERR_FETCH_ORIGIN_MISMATCH";
+    readonly UNSUPPORTED_PROTOCOL: "ERR_FETCH_UNSUPPORTED_PROTOCOL";
+    readonly UNSUPPORTED_METHOD: "ERR_FETCH_UNSUPPORTED_METHOD";
+    readonly TLS_ALPN: "ERR_FETCH_TLS_ALPN";
+    readonly REQUEST_WRITE: "ERR_FETCH_REQUEST_WRITE";
+    readonly RESPONSE_HEADERS: "ERR_FETCH_RESPONSE_HEADERS";
+    readonly RESPONSE_BODY: "ERR_FETCH_RESPONSE_BODY";
+    readonly RESPONSE_DECODE: "ERR_FETCH_RESPONSE_DECODE";
+    readonly HTTP_STATUS: "ERR_FETCH_HTTP_STATUS";
+};
+export type FetchErrorCode = (typeof FetchErrorCode)[keyof typeof FetchErrorCode];
+export type FetchErrorPhase = "agent" | "connect" | "request" | "response" | "body" | "decode" | "policy";
+export interface FetchErrorContext {
+    url?: string;
+    method?: string;
+    origin?: string;
+    scheme?: string;
+    host?: string;
+    port?: number;
+    status?: number;
+    alpn?: string | null;
+    details?: Record<string, unknown>;
+}
+export interface FetchErrorOptions {
+    message: string;
+    code: FetchErrorCode;
+    phase: FetchErrorPhase;
+    cause?: unknown;
+    context?: FetchErrorContext;
+    retryable?: boolean;
+    type?: ErrorType;
+}
+export declare class FetchError extends Error {
+    readonly code: FetchErrorCode;
+    readonly phase: FetchErrorPhase;
+    readonly context?: FetchErrorContext;
+    readonly retryable: boolean;
+    readonly type?: ErrorType;
+    readonly cause: unknown;
+    constructor(options: FetchErrorOptions);
+    get name(): string;
+    get [Symbol.toStringTag](): string;
+    toJSON(): {
+        name: string;
+        message: string;
+        code: FetchErrorCode;
+        phase: FetchErrorPhase;
+        retryable: boolean;
+        type: ErrorType | undefined;
+        context: FetchErrorContext | undefined;
+        cause: unknown;
+    };
+}
+export declare class RequestAbortedError extends FetchError {
+    constructor(cause?: unknown, context?: FetchErrorContext, message?: string);
+}
+export declare class ConnectTimeoutError extends FetchError {
+    constructor(cause?: unknown, context?: FetchErrorContext, message?: string);
+}
+export declare class ConnectionError extends FetchError {
+    constructor(cause?: unknown, context?: FetchErrorContext, message?: string);
+}
+export declare class AgentClosedError extends FetchError {
+    constructor(context?: FetchErrorContext, cause?: unknown);
+}
+export declare class AgentBusyError extends FetchError {
+    constructor(context?: FetchErrorContext, cause?: unknown);
+}
+export declare class OriginMismatchError extends FetchError {
+    constructor(expectedOrigin: string, actualOrigin: string, context?: FetchErrorContext);
+}
+export declare class UnsupportedProtocolError extends FetchError {
+    constructor(protocol: string, context?: FetchErrorContext);
+}
+export declare class UnsupportedMethodError extends FetchError {
+    constructor(method: string, context?: FetchErrorContext);
+}
+export declare class UnsupportedAlpnProtocolError extends FetchError {
+    constructor(alpn: string, context?: FetchErrorContext, cause?: unknown);
+}
+export declare class RequestWriteError extends FetchError {
+    constructor(cause?: unknown, context?: FetchErrorContext, message?: string);
+}
+export declare class ResponseHeaderError extends FetchError {
+    constructor(cause?: unknown, context?: FetchErrorContext, message?: string);
+}
+export declare class ResponseBodyError extends FetchError {
+    constructor(cause?: unknown, context?: FetchErrorContext, message?: string);
+}
+export declare class ResponseDecodeError extends FetchError {
+    constructor(cause?: unknown, context?: FetchErrorContext, message?: string);
+}
+export declare class HttpStatusError extends FetchError {
+    readonly statusCode: number;
+    constructor(statusCode: number, context?: FetchErrorContext, cause?: unknown, message?: string);
+}

package/src/fetch.d.cts

@@ -0,0 +1,36 @@
+import { BodyInit as FetchBodyInit } from './body';
+import { HttpClientOptions, HttpClient } from './http-client';
+export interface RequestInit extends Omit<globalThis.RequestInit, "body" | "headers"> {
+    body?: FetchBodyInit | null;
+    headers?: HeadersInit;
+    /**
+     * Optional client override for this call.
+     *
+     * Reader/Writer I/O options are configured at the client/pool level, not
+     * per request.
+     */
+    client?: HttpClient;
+}
+/** Clearer export for consumers that want to avoid shadowing the global name. */
+export interface FetchRequestInit extends RequestInit {
+}
+/**
+ * Options used only for constructing the default internal `HttpClient`.
+ *
+ * These are high-level client/pool/socket/I-O options; low-level Readers/Writers
+ * are not configured per request through this fetch-like API.
+ */
+export interface FetchOptions extends HttpClientOptions {
+}
+export interface FetchLike {
+    (input: RequestInfo | URL, init?: RequestInit): Promise<Response>;
+    close(): Promise<void>;
+    [Symbol.asyncDispose](): Promise<void>;
+    readonly client: HttpClient;
+}
+export declare function normalizeHeaders(headers?: HeadersInit): Headers;
+export declare function createFetch(client?: HttpClient): FetchLike;
+export type { HttpClientOptions };
+export { HttpClient };
+export declare const fetch: FetchLike;
+export default fetch;

package/src/fetch.d.ts

@@ -0,0 +1,36 @@
+import { BodyInit as FetchBodyInit } from './body';
+import { HttpClientOptions, HttpClient } from './http-client';
+export interface RequestInit extends Omit<globalThis.RequestInit, "body" | "headers"> {
+    body?: FetchBodyInit | null;
+    headers?: HeadersInit;
+    /**
+     * Optional client override for this call.
+     *
+     * Reader/Writer I/O options are configured at the client/pool level, not
+     * per request.
+     */
+    client?: HttpClient;
+}
+/** Clearer export for consumers that want to avoid shadowing the global name. */
+export interface FetchRequestInit extends RequestInit {
+}
+/**
+ * Options used only for constructing the default internal `HttpClient`.
+ *
+ * These are high-level client/pool/socket/I-O options; low-level Readers/Writers
+ * are not configured per request through this fetch-like API.
+ */
+export interface FetchOptions extends HttpClientOptions {
+}
+export interface FetchLike {
+    (input: RequestInfo | URL, init?: RequestInit): Promise<Response>;
+    close(): Promise<void>;
+    [Symbol.asyncDispose](): Promise<void>;
+    readonly client: HttpClient;
+}
+export declare function normalizeHeaders(headers?: HeadersInit): Headers;
+export declare function createFetch(client?: HttpClient): FetchLike;
+export type { HttpClientOptions };
+export { HttpClient };
+export declare const fetch: FetchLike;
+export default fetch;

package/src/http-client.d.cts

@@ -0,0 +1,23 @@
+import { AgentPoolOptions, SendOptions } from './types/agent';
+export declare class HttpClient implements AsyncDisposable {
+    #private;
+    constructor(options?: HttpClient.Options);
+    send(options: SendOptions): Promise<Response>;
+    close(): Promise<void>;
+    [Symbol.asyncDispose](): Promise<void>;
+}
+export declare namespace HttpClient {
+    /**
+     * High-level client configuration.
+     *
+     * At this layer, the API exposes:
+     * - pool management options
+     * - socket connection options
+     * - HTTP reader/writer options forwarded to the agent I/O layer
+     */
+    interface Options extends AgentPoolOptions {
+    }
+}
+/** Back-compat */
+export interface HttpClientOptions extends HttpClient.Options {
+}

package/src/http-client.d.ts

@@ -0,0 +1,23 @@
+import { AgentPoolOptions, SendOptions } from './types/agent';
+export declare class HttpClient implements AsyncDisposable {
+    #private;
+    constructor(options?: HttpClient.Options);
+    send(options: SendOptions): Promise<Response>;
+    close(): Promise<void>;
+    [Symbol.asyncDispose](): Promise<void>;
+}
+export declare namespace HttpClient {
+    /**
+     * High-level client configuration.
+     *
+     * At this layer, the API exposes:
+     * - pool management options
+     * - socket connection options
+     * - HTTP reader/writer options forwarded to the agent I/O layer
+     */
+    interface Options extends AgentPoolOptions {
+    }
+}
+/** Back-compat */
+export interface HttpClientOptions extends HttpClient.Options {
+}

package/src/index.d.cts

@@ -0,0 +1,7 @@
+export { connectTcp, connectTls, upgradeTls } from './_internal/net';
+export * from './body';
+export * from './dialers';
+export * from './encoding';
+export * from './errors';
+export * from './fetch';
+export * from './types';

package/src/index.d.ts

@@ -0,0 +1,7 @@
+export { connectTcp, connectTls, upgradeTls } from './_internal/net';
+export * from './body';
+export * from './dialers';
+export * from './encoding';
+export * from './errors';
+export * from './fetch';
+export * from './types';

package/src/io/_utils.d.cts

@@ -0,0 +1,10 @@
+type TransferEncodingInfo = {
+    has: boolean;
+    chunked: boolean;
+    codings: string[];
+};
+export declare function parseMaxBytes(value?: number | string): number | null;
+export declare function splitTokens(v: string | null): string[];
+export declare function parseTransferEncoding(headers: Headers): TransferEncodingInfo;
+export declare function parseContentLength(headers: Headers): number | null;
+export {};

package/src/io/_utils.d.ts

@@ -0,0 +1,10 @@
+type TransferEncodingInfo = {
+    has: boolean;
+    chunked: boolean;
+    codings: string[];
+};
+export declare function parseMaxBytes(value?: number | string): number | null;
+export declare function splitTokens(v: string | null): string[];
+export declare function parseTransferEncoding(headers: Headers): TransferEncodingInfo;
+export declare function parseContentLength(headers: Headers): number | null;
+export {};

package/src/io/buf-writer.d.cts

@@ -0,0 +1,13 @@
+import { ISyncWritable, IWritable } from '@fuman/io';
+export declare class BufWriter implements IWritable, ISyncWritable {
+    #private;
+    constructor(writable: IWritable, size?: number);
+    get bufferSize(): number;
+    get buffered(): number;
+    get available(): number;
+    reset(writable: IWritable): void;
+    writeSync(bytes: number): Uint8Array;
+    disposeWriteSync(written?: number): void;
+    flush(): Promise<void>;
+    write(bytes: Uint8Array): Promise<void>;
+}

package/src/io/buf-writer.d.ts

@@ -0,0 +1,13 @@
+import { ISyncWritable, IWritable } from '@fuman/io';
+export declare class BufWriter implements IWritable, ISyncWritable {
+    #private;
+    constructor(writable: IWritable, size?: number);
+    get bufferSize(): number;
+    get buffered(): number;
+    get available(): number;
+    reset(writable: IWritable): void;
+    writeSync(bytes: number): Uint8Array;
+    disposeWriteSync(written?: number): void;
+    flush(): Promise<void>;
+    write(bytes: Uint8Array): Promise<void>;
+}

package/src/io/io.d.cts

@@ -0,0 +1,5 @@
+import { IConnection } from '@fuman/net';
+import { LineReader, Readers } from './readers';
+import { Writers } from './writers';
+export declare function readResponse(conn: IConnection<unknown>, options: (Readers.Options & LineReader.ReadHeadersOptions) | undefined, shouldIgnoreBody: (status: number) => boolean, onDone?: (reusable: boolean) => void): Promise<Response>;
+export declare function writeRequest(conn: IConnection<unknown>, req: Writers.Request, options?: Writers.Options): Promise<void>;

package/src/io/io.d.ts

@@ -0,0 +1,5 @@
+import { IConnection } from '@fuman/net';
+import { LineReader, Readers } from './readers';
+import { Writers } from './writers';
+export declare function readResponse(conn: IConnection<unknown>, options: (Readers.Options & LineReader.ReadHeadersOptions) | undefined, shouldIgnoreBody: (status: number) => boolean, onDone?: (reusable: boolean) => void): Promise<Response>;
+export declare function writeRequest(conn: IConnection<unknown>, req: Writers.Request, options?: Writers.Options): Promise<void>;

package/src/io/readers.d.cts

@@ -0,0 +1,199 @@
+import { IClosable, IReadable } from '@fuman/io';
+type Source = IReadable & IClosable;
+export declare function sanitizeHeaderValue(v: string): string;
+/**
+ * Reader options shared across the HTTP/1 response pipeline.
+ *
+ * @namespace Readers
+ */
+export declare namespace Readers {
+    /**
+     * Buffering configuration.
+     *
+     * @property {number} [bufferSize] - Initial size (in bytes) for the internal buffer.
+     *
+     * @property {number} [highWaterMark] - Target read size (in bytes) for each pull from the underlying source.
+     * Defaults to 16 KiB.
+     */
+    interface BufferingOptions {
+        bufferSize?: number;
+        highWaterMark?: number;
+    }
+    /**
+     * Response size limits.
+     *
+     * @property {number|string} [maxBodySize] - Maximum allowed entity-body size (raw, before content decoding).
+     * Can be a number of bytes or a human-readable string like "10mb".
+     *
+     * @property {number|string} [maxDecodedBodySize] - Maximum allowed decoded body size (after content decoding).
+     * Can be a number of bytes or a human-readable string like "10mb".
+     */
+    interface SizeLimitOptions {
+        maxBodySize?: number | string;
+        maxDecodedBodySize?: number | string;
+    }
+    /**
+     * Decompression behavior.
+     *
+     * @property {boolean} [decompress] - If true, the response body may be transparently decompressed based on
+     * Content-Encoding. Defaults to true.
+     */
+    interface DecompressionOptions {
+        decompress?: boolean;
+    }
+    /**
+     * Delimiter scanning limits.
+     *
+     * @property {number} [maxLineSize] - Maximum allowed bytes for a single CRLF-delimited line (excluding CRLF).
+     * Defaults to 64 KiB.
+     *
+     * @property {number} [maxBufferedBytes] - Maximum allowed buffered bytes while searching for CRLF.
+     * Defaults to 256 KiB.
+     */
+    interface DelimiterLimitsOptions {
+        maxLineSize?: number;
+        maxBufferedBytes?: number;
+    }
+    /**
+     * Unified options shape suitable for fetch-like response parsing.
+     */
+    type Options = LineReader.Options & BodyReader.Options & ChunkedBodyReader.Options;
+}
+/**
+ * CRLF-delimited reader that preserves over-reads in an internal buffer.
+ *
+ * Key property: once you finish reading headers, any bytes already read beyond
+ * the header terminator stay buffered and will be returned by read().
+ */
+export declare class LineReader implements IReadable, IClosable {
+    #private;
+    close: () => Promise<void> | void;
+    /**
+     * LineReader configuration.
+     *
+     * @namespace LineReader
+     */
+    static Options: never;
+    constructor(src: Source, opts?: LineReader.Options);
+    read(into: Uint8Array): Promise<number>;
+    readLine(): Promise<string | null>;
+    readHeaders(opts?: LineReader.ReadHeadersOptions): Promise<Headers>;
+}
+/**
+ * LineReader configuration.
+ *
+ * @namespace LineReader
+ */
+export declare namespace LineReader {
+    /**
+     * LineReader instance options.
+     *
+     * @property {number} [bufferSize] - Initial size (in bytes) for the internal buffer.
+     *
+     * @property {number} [highWaterMark] - Target read size (in bytes) for each pull from the underlying source.
+     * Defaults to 16 KiB.
+     *
+     * @property {number} [maxLineSize] - Maximum allowed bytes for a single CRLF-delimited line (excluding CRLF).
+     * Defaults to 64 KiB.
+     *
+     * @property {number} [maxBufferedBytes] - Maximum allowed buffered bytes while searching for CRLF.
+     * Defaults to 256 KiB.
+     */
+    interface Options extends Readers.BufferingOptions, Readers.DelimiterLimitsOptions {
+    }
+    /**
+     * Header parsing limits.
+     *
+     * @property {number} [maxHeaderSize] - Maximum allowed bytes for all header fields (including CRLFs).
+     * Defaults to 64 KiB.
+     */
+    interface ReadHeadersOptions {
+        maxHeaderSize?: number;
+    }
+}
+/**
+ * Body reader that streams bytes with either a fixed Content-Length or until EOF.
+ */
+export declare class BodyReader implements IReadable, IClosable {
+    #private;
+    close: () => Promise<void> | void;
+    /**
+     * BodyReader configuration.
+     *
+     * @namespace BodyReader
+     */
+    static Options: never;
+    constructor(src: Source, contentLength: number, opts?: BodyReader.Options);
+    read(into: Uint8Array): Promise<number>;
+}
+/**
+ * BodyReader configuration.
+ *
+ * @namespace BodyReader
+ */
+export declare namespace BodyReader {
+    /**
+     * BodyReader instance options.
+     *
+     * @property {number|string} [maxBodySize] - Maximum allowed entity-body size (raw, before content decoding).
+     * Can be a number of bytes or a human-readable string like "10mb".
+     *
+     * @property {number|string} [maxDecodedBodySize] - Maximum allowed decoded body size (after content decoding).
+     * Can be a number of bytes or a human-readable string like "10mb".
+     *
+     * @property {boolean} [decompress] - If true, the response body may be transparently decompressed based on
+     * Content-Encoding. Defaults to true.
+     */
+    interface Options extends Readers.SizeLimitOptions, Readers.DecompressionOptions {
+    }
+}
+/**
+ * RFC 7230 chunked transfer-coding decoder.
+ */
+export declare class ChunkedBodyReader implements IReadable, IClosable {
+    #private;
+    close: () => Promise<void> | void;
+    /**
+     * ChunkedBodyReader configuration.
+     *
+     * @namespace ChunkedBodyReader
+     */
+    static Options: never;
+    constructor(src: Source, opts?: ChunkedBodyReader.Options);
+    read(into: Uint8Array): Promise<number>;
+}
+/**
+ * ChunkedBodyReader configuration.
+ *
+ * @namespace ChunkedBodyReader
+ */
+export declare namespace ChunkedBodyReader {
+    /**
+     * ChunkedBodyReader instance options.
+     *
+     * @property {number|string} [maxBodySize] - Maximum allowed entity-body size (raw, before content decoding).
+     * Can be a number of bytes or a human-readable string like "10mb".
+     *
+     * @property {number|string} [maxDecodedBodySize] - Maximum allowed decoded body size (after content decoding).
+     * Can be a number of bytes or a human-readable string like "10mb".
+     *
+     * @property {boolean} [decompress] - If true, the response body may be transparently decompressed based on
+     * Content-Encoding. Defaults to true.
+     *
+     * @property {number} [bufferSize] - Initial size (in bytes) for the internal buffer.
+     *
+     * @property {number} [highWaterMark] - Target read size (in bytes) for each pull from the underlying source.
+     * Defaults to 16 KiB.
+     *
+     * @property {number} [maxLineSize] - Maximum allowed bytes for CRLF-delimited chunk control lines.
+     * Defaults to 64 KiB.
+     *
+     * @property {number} [maxChunkSize] - Maximum allowed bytes for any single chunk.
+     * Defaults to 16 MiB.
+     */
+    interface Options extends BodyReader.Options, Readers.BufferingOptions {
+        maxLineSize?: number;
+        maxChunkSize?: number;
+    }
+}
+export {};