@npy/fetch 0.1.1 → 0.1.2

package/src/body.d.cts

@@ -1,23 +0,0 @@
-import { Readable } from 'node:stream';
-import { FormDataPolyfill } from './_internal/guards';
-export type BodyInit = Exclude<RequestInit["body"], undefined | null> | FormDataPolyfill | Readable;
-export interface BodyState {
-    contentLength: number | null;
-    contentType: string | null;
-    body: Readable | ReadableStream | Uint8Array | null;
-}
-export declare const getFormDataLength: (form: FormData, boundary: string) => number;
-export declare const extractBody: (object: BodyInit | null) => BodyState;
-declare const kBodyInternals: unique symbol;
-export declare class Body {
-    private [kBodyInternals];
-    constructor(init: BodyInit | null);
-    get body(): Uint8Array<ArrayBufferLike> | Readable | ReadableStream<any> | null;
-    get bodyUsed(): boolean;
-    arrayBuffer(): Promise<ArrayBuffer>;
-    formData(): Promise<FormData>;
-    blob(): Promise<Blob>;
-    json(): Promise<any>;
-    text(): Promise<string>;
-}
-export {};

package/src/body.d.ts

@@ -1,23 +0,0 @@
-import { Readable } from 'node:stream';
-import { FormDataPolyfill } from './_internal/guards';
-export type BodyInit = Exclude<RequestInit["body"], undefined | null> | FormDataPolyfill | Readable;
-export interface BodyState {
-    contentLength: number | null;
-    contentType: string | null;
-    body: Readable | ReadableStream | Uint8Array | null;
-}
-export declare const getFormDataLength: (form: FormData, boundary: string) => number;
-export declare const extractBody: (object: BodyInit | null) => BodyState;
-declare const kBodyInternals: unique symbol;
-export declare class Body {
-    private [kBodyInternals];
-    constructor(init: BodyInit | null);
-    get body(): Uint8Array<ArrayBufferLike> | Readable | ReadableStream<any> | null;
-    get bodyUsed(): boolean;
-    arrayBuffer(): Promise<ArrayBuffer>;
-    formData(): Promise<FormData>;
-    blob(): Promise<Blob>;
-    json(): Promise<any>;
-    text(): Promise<string>;
-}
-export {};

package/src/encoding.d.cts

@@ -1,24 +0,0 @@
-type ByteStream = ReadableStream<Uint8Array>;
-type ByteTransform = TransformStream<Uint8Array, Uint8Array>;
-export declare function decodeStream(stream: ByteStream, contentEncoding?: string | string[]): ByteStream;
-export declare function decodeStream(stream: AsyncIterable<Uint8Array>, contentEncoding?: string | string[]): AsyncIterable<Uint8Array> | ByteStream;
-export declare function encodeStream(stream: ByteStream, contentEncoding?: string | string[]): ByteStream;
-export declare function encodeStream(stream: AsyncIterable<Uint8Array>, contentEncoding?: string | string[]): AsyncIterable<Uint8Array> | ByteStream;
-/**
- * Create a series of decoding streams based on the content-encoding header. The
- * resulting streams should be piped together to decode the content.
- *
- * @see {@link https://datatracker.ietf.org/doc/html/rfc9110#section-8.4.1}
- */
-export declare function createDecoders(contentEncoding?: string | string[]): ByteTransform[];
-/**
- * Create a series of encoding streams based on the content-encoding header (or
- * transfer-coding list).
- *
- * The resulting streams should be piped together to apply the encoding in the
- * declared order.
- *
- * @see {@link https://datatracker.ietf.org/doc/html/rfc9110#section-8.4.1}
- */
-export declare function createEncoders(contentEncoding?: string | string[]): ByteTransform[];
-export {};

package/src/encoding.d.ts

@@ -1,24 +0,0 @@
-type ByteStream = ReadableStream<Uint8Array>;
-type ByteTransform = TransformStream<Uint8Array, Uint8Array>;
-export declare function decodeStream(stream: ByteStream, contentEncoding?: string | string[]): ByteStream;
-export declare function decodeStream(stream: AsyncIterable<Uint8Array>, contentEncoding?: string | string[]): AsyncIterable<Uint8Array> | ByteStream;
-export declare function encodeStream(stream: ByteStream, contentEncoding?: string | string[]): ByteStream;
-export declare function encodeStream(stream: AsyncIterable<Uint8Array>, contentEncoding?: string | string[]): AsyncIterable<Uint8Array> | ByteStream;
-/**
- * Create a series of decoding streams based on the content-encoding header. The
- * resulting streams should be piped together to decode the content.
- *
- * @see {@link https://datatracker.ietf.org/doc/html/rfc9110#section-8.4.1}
- */
-export declare function createDecoders(contentEncoding?: string | string[]): ByteTransform[];
-/**
- * Create a series of encoding streams based on the content-encoding header (or
- * transfer-coding list).
- *
- * The resulting streams should be piped together to apply the encoding in the
- * declared order.
- *
- * @see {@link https://datatracker.ietf.org/doc/html/rfc9110#section-8.4.1}
- */
-export declare function createEncoders(contentEncoding?: string | string[]): ByteTransform[];
-export {};

package/src/fetch.d.cts

@@ -1,36 +0,0 @@
-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

@@ -1,36 +0,0 @@
-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

@@ -1,23 +0,0 @@
-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

@@ -1,23 +0,0 @@
-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

@@ -1,7 +0,0 @@
-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

@@ -1,7 +0,0 @@
-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/readers.d.cts

@@ -1,199 +0,0 @@
-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 {};

package/src/io/readers.d.ts

@@ -1,199 +0,0 @@
-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 {};