@npy/fetch 0.1.1 → 0.1.3

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 {};

package/src/io/writers.d.cts

@@ -1,22 +0,0 @@
-import { IWritable } from '@fuman/io';
-import { BodyInit } from '../body';
-type Destination = IWritable;
-export declare namespace Writers {
-    interface Options {
-        highWaterMark?: number;
-        directWriteThreshold?: number;
-        coalesceBodyMaxBytes?: number;
-    }
-    interface Request {
-        url: URL;
-        method: string;
-        headers?: Headers;
-        body?: BodyInit | null;
-        signal?: AbortSignal;
-    }
-    interface Writer {
-        write(req: Request): Promise<void>;
-    }
-}
-export declare function createRequestWriter(dst: Destination, opts?: Writers.Options): Writers.Writer;
-export {};

package/src/io/writers.d.ts

@@ -1,22 +0,0 @@
-import { IWritable } from '@fuman/io';
-import { BodyInit } from '../body';
-type Destination = IWritable;
-export declare namespace Writers {
-    interface Options {
-        highWaterMark?: number;
-        directWriteThreshold?: number;
-        coalesceBodyMaxBytes?: number;
-    }
-    interface Request {
-        url: URL;
-        method: string;
-        headers?: Headers;
-        body?: BodyInit | null;
-        signal?: AbortSignal;
-    }
-    interface Writer {
-        write(req: Request): Promise<void>;
-    }
-}
-export declare function createRequestWriter(dst: Destination, opts?: Writers.Options): Writers.Writer;
-export {};

package/src/types/agent.d.cts

@@ -1,128 +0,0 @@
-import { BodyInit } from '../body';
-import { LineReader, Readers } from '../io/readers';
-import { Writers } from '../io/writers';
-import { Dialer } from './dialer';
-export interface Agent {
-    [Symbol.dispose](): void;
-    close(): void;
-    readonly hostname: string;
-    readonly port: number;
-    send(options: Agent.SendOptions): Promise<Response>;
-    whenIdle(): Promise<void>;
-    readonly isIdle: boolean;
-    readonly lastUsed: number;
-}
-export declare namespace Agent {
-    interface ConnectOptions {
-        /** Connection timeout (ms) used only while establishing the socket. */
-        timeout?: number;
-        /**
-         * Configure SO_KEEPALIVE on the underlying connection.
-         *
-         * - `true` / `false`: explicitly set the flag
-         * - `null`: do not touch the runtime default
-         */
-        keepAlive?: boolean | null;
-        /**
-         * Configure TCP_NODELAY on the underlying connection.
-         *
-         * This is a connection-level option only; it is not related to HTTP body
-         * buffering or writer coalescing.
-         */
-        noDelay?: boolean;
-    }
-    /**
-     * Reader options currently supported by the low-level HTTP response parser.
-     *
-     * These options are applied per-agent / per-pool, not per-request.
-     */
-    type ReaderOptions = Readers.Options & LineReader.ReadHeadersOptions;
-    /**
-     * Writer options currently supported by the low-level HTTP request writer.
-     *
-     * These options are applied per-agent / per-pool, not per-request.
-     */
-    type WriterOptions = Writers.Options;
-    /**
-     * High-level HTTP I/O configuration forwarded to the low-level Readers/Writers.
-     */
-    interface IOOptions {
-        reader?: ReaderOptions;
-        writer?: WriterOptions;
-    }
-    /**
-     * Complete agent-level configuration.
-     *
-     * `connect` controls socket establishment behavior.
-     * `io` controls HTTP reader/writer behavior.
-     */
-    interface Options {
-        connect?: ConnectOptions;
-        io?: IOOptions;
-    }
-    interface SendOptions {
-        /**
-         * Absolute request URL.
-         *
-         * Relative URLs are not supported at this layer.
-         */
-        url: string | URL;
-        /**
-         * HTTP method.
-         *
-         * The implementation may normalize casing before serialization.
-         */
-        method: string;
-        /**
-         * Pre-normalized headers for the low-level send path.
-         *
-         * Use `normalizeHeaders(...)` from the fetch layer when starting from a
-         * generic `HeadersInit`.
-         */
-        headers?: Headers;
-        body?: BodyInit | null;
-        signal?: AbortSignal;
-    }
-}
-export interface AgentPool {
-    [Symbol.asyncDispose](): Promise<void>;
-    close(): Promise<void>;
-    readonly hostname: string;
-    readonly port: number;
-    send(options: Agent.SendOptions): Promise<Response>;
-}
-export declare namespace AgentPool {
-    interface Options {
-        dialer?: Dialer;
-        poolMaxIdlePerHost?: number;
-        poolMaxPerHost?: number;
-        /** `false` disables idle eviction. Defaults are handled by the implementation. */
-        poolIdleTimeout?: number | false;
-        /**
-         * Publicly exposed socket/connection options.
-         */
-        connect?: Agent.ConnectOptions;
-        /**
-         * Publicly exposed HTTP I/O options forwarded to Readers/Writers.
-         *
-         * These are client/pool/agent-level settings, not per-request options.
-         */
-        io?: Agent.IOOptions;
-    }
-}
-/** Back-compat */
-export interface AgentConnectOptions extends Agent.ConnectOptions {
-}
-/** Back-compat */
-export interface AgentPoolOptions extends AgentPool.Options {
-}
-/** Back-compat */
-export interface SendOptions extends Agent.SendOptions {
-}
-/** Back-compat */
-export interface AgentIOOptions extends Agent.IOOptions {
-}
-/** Back-compat */
-export type AgentReaderOptions = Agent.ReaderOptions;
-/** Back-compat */
-export type AgentWriterOptions = Agent.WriterOptions;

package/src/types/agent.d.ts

@@ -1,128 +0,0 @@
-import { BodyInit } from '../body';
-import { LineReader, Readers } from '../io/readers';
-import { Writers } from '../io/writers';
-import { Dialer } from './dialer';
-export interface Agent {
-    [Symbol.dispose](): void;
-    close(): void;
-    readonly hostname: string;
-    readonly port: number;
-    send(options: Agent.SendOptions): Promise<Response>;
-    whenIdle(): Promise<void>;
-    readonly isIdle: boolean;
-    readonly lastUsed: number;
-}
-export declare namespace Agent {
-    interface ConnectOptions {
-        /** Connection timeout (ms) used only while establishing the socket. */
-        timeout?: number;
-        /**
-         * Configure SO_KEEPALIVE on the underlying connection.
-         *
-         * - `true` / `false`: explicitly set the flag
-         * - `null`: do not touch the runtime default
-         */
-        keepAlive?: boolean | null;
-        /**
-         * Configure TCP_NODELAY on the underlying connection.
-         *
-         * This is a connection-level option only; it is not related to HTTP body
-         * buffering or writer coalescing.
-         */
-        noDelay?: boolean;
-    }
-    /**
-     * Reader options currently supported by the low-level HTTP response parser.
-     *
-     * These options are applied per-agent / per-pool, not per-request.
-     */
-    type ReaderOptions = Readers.Options & LineReader.ReadHeadersOptions;
-    /**
-     * Writer options currently supported by the low-level HTTP request writer.
-     *
-     * These options are applied per-agent / per-pool, not per-request.
-     */
-    type WriterOptions = Writers.Options;
-    /**
-     * High-level HTTP I/O configuration forwarded to the low-level Readers/Writers.
-     */
-    interface IOOptions {
-        reader?: ReaderOptions;
-        writer?: WriterOptions;
-    }
-    /**
-     * Complete agent-level configuration.
-     *
-     * `connect` controls socket establishment behavior.
-     * `io` controls HTTP reader/writer behavior.
-     */
-    interface Options {
-        connect?: ConnectOptions;
-        io?: IOOptions;
-    }
-    interface SendOptions {
-        /**
-         * Absolute request URL.
-         *
-         * Relative URLs are not supported at this layer.
-         */
-        url: string | URL;
-        /**
-         * HTTP method.
-         *
-         * The implementation may normalize casing before serialization.
-         */
-        method: string;
-        /**
-         * Pre-normalized headers for the low-level send path.
-         *
-         * Use `normalizeHeaders(...)` from the fetch layer when starting from a
-         * generic `HeadersInit`.
-         */
-        headers?: Headers;
-        body?: BodyInit | null;
-        signal?: AbortSignal;
-    }
-}
-export interface AgentPool {
-    [Symbol.asyncDispose](): Promise<void>;
-    close(): Promise<void>;
-    readonly hostname: string;
-    readonly port: number;
-    send(options: Agent.SendOptions): Promise<Response>;
-}
-export declare namespace AgentPool {
-    interface Options {
-        dialer?: Dialer;
-        poolMaxIdlePerHost?: number;
-        poolMaxPerHost?: number;
-        /** `false` disables idle eviction. Defaults are handled by the implementation. */
-        poolIdleTimeout?: number | false;
-        /**
-         * Publicly exposed socket/connection options.
-         */
-        connect?: Agent.ConnectOptions;
-        /**
-         * Publicly exposed HTTP I/O options forwarded to Readers/Writers.
-         *
-         * These are client/pool/agent-level settings, not per-request options.
-         */
-        io?: Agent.IOOptions;
-    }
-}
-/** Back-compat */
-export interface AgentConnectOptions extends Agent.ConnectOptions {
-}
-/** Back-compat */
-export interface AgentPoolOptions extends AgentPool.Options {
-}
-/** Back-compat */
-export interface SendOptions extends Agent.SendOptions {
-}
-/** Back-compat */
-export interface AgentIOOptions extends Agent.IOOptions {
-}
-/** Back-compat */
-export type AgentReaderOptions = Agent.ReaderOptions;
-/** Back-compat */
-export type AgentWriterOptions = Agent.WriterOptions;

package/src/types/dialer.d.ts

@@ -1,27 +0,0 @@
-import { ITcpConnection, ITlsConnection } from '@fuman/net';
-import { NodeTlsConnectOptions } from '@fuman/node';
-export interface Dialer {
-    dial(target: Dialer.Target, options?: Dialer.Options): Promise<Dialer.ConnectionLike>;
-}
-export declare namespace Dialer {
-    type ConnectionLike = ITcpConnection | ITlsConnection;
-    interface Target {
-        address: string;
-        port: number;
-        secure: boolean;
-        /** Server Name Indication (TLS). Defaults to the host when applicable. */
-        sni?: string;
-        /** Defaults to ["http/1.1"] when omitted by the dialer implementation. */
-        alpnProtocols?: string[];
-        /** Extra Node.js TLS options (minVersion, servername, etc.). */
-        extraOptions?: NodeTlsConnectOptions["extraOptions"];
-    }
-    interface Options {
-        signal?: AbortSignal;
-    }
-}
-/** Back-compat */
-export type ConnectionLike = Dialer.ConnectionLike;
-/** Back-compat */
-export interface DialTarget extends Dialer.Target {
-}

package/src/types/index.d.cts

@@ -1,2 +0,0 @@
-export * from './agent';
-export * from './dialer';

package/src/types/index.d.ts

@@ -1,2 +0,0 @@
-export * from './agent';
-export * from './dialer';

package/tests/test-utils.d.cts

@@ -1,8 +0,0 @@
-export interface TestServer {
-    server: ReturnType<typeof Bun.serve>;
-    baseUrl: string;
-    stop(): Promise<void>;
-}
-export declare function sleep(ms: number): Promise<void>;
-export declare function headersToObject(headers: Headers): Record<string, string>;
-export declare function createTestServer(): TestServer;

package/tests/test-utils.d.ts

@@ -1,8 +0,0 @@
-export interface TestServer {
-    server: ReturnType<typeof Bun.serve>;
-    baseUrl: string;
-    stop(): Promise<void>;
-}
-export declare function sleep(ms: number): Promise<void>;
-export declare function headersToObject(headers: Headers): Record<string, string>;
-export declare function createTestServer(): TestServer;