nlcurl 0.1.0

package/dist/http/h1/client.d.ts

@@ -0,0 +1,21 @@
+/**
+ * HTTP/1.1 client.
+ *
+ * Sends requests and receives responses over a TLS (or plain TCP)
+ * Duplex stream.  Supports connection reuse (keep-alive).
+ */
+import type { Duplex } from 'node:stream';
+import type { NLcURLRequest } from '../../core/request.js';
+import { NLcURLResponse } from '../../core/response.js';
+import type { RequestTimings } from '../../core/request.js';
+export interface H1ClientOptions {
+    /** Default headers to merge with each request. */
+    defaultHeaders?: Array<[string, string]>;
+}
+/**
+ * Send a single HTTP/1.1 request over an already-connected stream.
+ *
+ * Returns a fully parsed NLcURLResponse.
+ */
+export declare function sendH1Request(stream: Duplex, request: NLcURLRequest, options?: H1ClientOptions, timings?: Partial<RequestTimings>): Promise<NLcURLResponse>;
+//# sourceMappingURL=client.d.ts.map

package/dist/http/h1/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/http/h1/client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAKxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,MAAM,WAAW,eAAe;IAC9B,kDAAkD;IAClD,cAAc,CAAC,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC1C;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,aAAa,EACtB,OAAO,GAAE,eAAoB,EAC7B,OAAO,GAAE,OAAO,CAAC,cAAc,CAAM,GACpC,OAAO,CAAC,cAAc,CAAC,CAyDzB"}

package/dist/http/h1/client.js

@@ -0,0 +1,136 @@
+/**
+ * HTTP/1.1 client.
+ *
+ * Sends requests and receives responses over a TLS (or plain TCP)
+ * Duplex stream.  Supports connection reuse (keep-alive).
+ */
+import { NLcURLResponse } from '../../core/response.js';
+import { HTTPError, TimeoutError } from '../../core/errors.js';
+import { encodeRequest } from './encoder.js';
+import { HttpResponseParser } from './parser.js';
+import { decompressBody } from '../../utils/encoding.js';
+/**
+ * Send a single HTTP/1.1 request over an already-connected stream.
+ *
+ * Returns a fully parsed NLcURLResponse.
+ */
+export async function sendH1Request(stream, request, options = {}, timings = {}) {
+    const encoded = encodeRequest(request, options.defaultHeaders ?? []);
+    // Write request
+    await new Promise((resolve, reject) => {
+        stream.write(encoded, (err) => {
+            if (err)
+                reject(new HTTPError(err.message, 0));
+            else
+                resolve();
+        });
+    });
+    // Read response
+    const parser = new HttpResponseParser(request.method ?? 'GET');
+    const parsed = await readResponse(stream, parser, request);
+    const firstByteTime = Date.now();
+    if (timings.connect) {
+        timings.firstByte = firstByteTime - timings.connect;
+    }
+    // Decompress body
+    const encoding = parsed.headers.get('content-encoding');
+    let body;
+    if (encoding) {
+        body = await decompressBody(parsed.body, encoding);
+    }
+    else {
+        body = parsed.body;
+    }
+    // Build response headers
+    const responseHeaders = {};
+    for (const [k, v] of parsed.headers) {
+        responseHeaders[k] = v;
+    }
+    return new NLcURLResponse({
+        status: parsed.statusCode,
+        statusText: parsed.statusMessage,
+        headers: responseHeaders,
+        rawHeaders: parsed.rawHeaders.map(([k, v]) => [k.toLowerCase(), v]),
+        rawBody: body,
+        httpVersion: parsed.httpVersion,
+        url: request.url,
+        redirectCount: 0,
+        timings: {
+            dns: timings.dns ?? 0,
+            connect: timings.connect ?? 0,
+            tls: timings.tls ?? 0,
+            firstByte: timings.firstByte ?? 0,
+            total: 0, // Filled after return
+        },
+        request: {
+            url: request.url,
+            method: request.method ?? 'GET',
+            headers: request.headers ?? {},
+        },
+    });
+}
+// ---- Internals ----
+function readResponse(stream, parser, request) {
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        let timer;
+        const timeout = request.timeout;
+        const timeoutMs = typeof timeout === 'number' ? timeout : (timeout?.total ?? timeout?.response ?? 0);
+        if (timeoutMs > 0) {
+            timer = setTimeout(() => {
+                if (!settled) {
+                    settled = true;
+                    cleanup();
+                    reject(new TimeoutError('Response timed out', 'response'));
+                }
+            }, timeoutMs);
+        }
+        const onData = (chunk) => {
+            try {
+                if (parser.feed(chunk)) {
+                    settled = true;
+                    cleanup();
+                    resolve(parser.getResult());
+                }
+            }
+            catch (err) {
+                settled = true;
+                cleanup();
+                reject(err);
+            }
+        };
+        const onEnd = () => {
+            if (!settled) {
+                parser.connectionClosed();
+                try {
+                    settled = true;
+                    cleanup();
+                    resolve(parser.getResult());
+                }
+                catch {
+                    settled = true;
+                    cleanup();
+                    reject(new HTTPError('Connection closed before response complete', 0));
+                }
+            }
+        };
+        const onError = (err) => {
+            if (!settled) {
+                settled = true;
+                cleanup();
+                reject(new HTTPError(err.message, 0));
+            }
+        };
+        const cleanup = () => {
+            if (timer)
+                clearTimeout(timer);
+            stream.removeListener('data', onData);
+            stream.removeListener('end', onEnd);
+            stream.removeListener('error', onError);
+        };
+        stream.on('data', onData);
+        stream.once('end', onEnd);
+        stream.once('error', onError);
+    });
+}
+//# sourceMappingURL=client.js.map

package/dist/http/h1/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/http/h1/client.ts"],"names":[],"mappings":"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"}

package/dist/http/h1/encoder.d.ts

@@ -0,0 +1,11 @@
+/**
+ * HTTP/1.1 request encoder.
+ *
+ * Serializes NLcURLRequest objects into raw HTTP/1.1 wire format.
+ */
+import type { NLcURLRequest } from '../../core/request.js';
+/**
+ * Encode an HTTP/1.1 request to a Buffer ready to write to a socket.
+ */
+export declare function encodeRequest(request: NLcURLRequest, defaultHeaders: Array<[string, string]>): Buffer;
+//# sourceMappingURL=encoder.d.ts.map

package/dist/http/h1/encoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoder.d.ts","sourceRoot":"","sources":["../../../src/http/h1/encoder.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAe,MAAM,uBAAuB,CAAC;AAExE;;GAEG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,aAAa,EACtB,cAAc,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GACtC,MAAM,CA0DR"}

package/dist/http/h1/encoder.js

@@ -0,0 +1,75 @@
+/**
+ * HTTP/1.1 request encoder.
+ *
+ * Serializes NLcURLRequest objects into raw HTTP/1.1 wire format.
+ */
+/**
+ * Encode an HTTP/1.1 request to a Buffer ready to write to a socket.
+ */
+export function encodeRequest(request, defaultHeaders) {
+    const url = new URL(request.url);
+    const path = url.pathname + url.search;
+    const host = url.port
+        ? `${url.hostname}:${url.port}`
+        : url.hostname;
+    const lines = [];
+    lines.push(`${request.method} ${path} HTTP/1.1`);
+    // Collect headers -- merge defaults under request headers
+    const headerMap = new Map();
+    // Apply default headers first (lowercase keys)
+    for (const [k, v] of defaultHeaders) {
+        headerMap.set(k.toLowerCase(), v);
+    }
+    // Host header
+    if (!headerMap.has('host')) {
+        headerMap.set('host', host);
+    }
+    // Apply request headers (override defaults)
+    if (request.headers) {
+        for (const [k, v] of Object.entries(request.headers)) {
+            headerMap.set(k.toLowerCase(), v);
+        }
+    }
+    // Body handling
+    let bodyBuffer;
+    if (request.body !== undefined && request.body !== null) {
+        bodyBuffer = serializeBody(request.body);
+        if (!headerMap.has('content-length')) {
+            headerMap.set('content-length', String(bodyBuffer.length));
+        }
+        if (!headerMap.has('content-type')) {
+            headerMap.set('content-type', 'application/x-www-form-urlencoded');
+        }
+    }
+    // Emit headers (validate against CRLF injection)
+    for (const [k, v] of headerMap) {
+        if (/[\r\n\0]/.test(k) || /[\r\n\0]/.test(v)) {
+            throw new Error(`Invalid header: name or value contains forbidden characters`);
+        }
+        lines.push(`${k}: ${v}`);
+    }
+    lines.push('');
+    lines.push('');
+    const head = Buffer.from(lines.join('\r\n'), 'latin1');
+    if (bodyBuffer) {
+        return Buffer.concat([head, bodyBuffer]);
+    }
+    return head;
+}
+function serializeBody(body) {
+    if (body === null || body === undefined)
+        return Buffer.alloc(0);
+    if (Buffer.isBuffer(body))
+        return body;
+    if (typeof body === 'string')
+        return Buffer.from(body, 'utf-8');
+    if (body instanceof URLSearchParams) {
+        return Buffer.from(body.toString(), 'utf-8');
+    }
+    if (typeof body === 'object' && !(body instanceof ReadableStream)) {
+        return Buffer.from(JSON.stringify(body), 'utf-8');
+    }
+    // ReadableStream: not supported in synchronous encoding
+    return Buffer.alloc(0);
+}
+//# sourceMappingURL=encoder.js.map

package/dist/http/h1/encoder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoder.js","sourceRoot":"","sources":["../../../src/http/h1/encoder.ts"],"names":[],"mappings":"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"}

package/dist/http/h1/parser.d.ts

@@ -0,0 +1,61 @@
+/**
+ * HTTP/1.1 response parser.
+ *
+ * Incrementally parses HTTP/1.1 responses from a byte stream.
+ * Handles chunked transfer encoding and content-length framing.
+ */
+export interface ParsedResponse {
+    httpVersion: string;
+    statusCode: number;
+    statusMessage: string;
+    headers: Map<string, string>;
+    /** Raw header entries preserving order and case. */
+    rawHeaders: Array<[string, string]>;
+    body: Buffer;
+}
+/**
+ * Incremental HTTP/1.1 response parser.
+ */
+export declare class HttpResponseParser {
+    private requestMethod;
+    private state;
+    private buffer;
+    private httpVersion;
+    private statusCode;
+    private statusMessage;
+    private headers;
+    private rawHeaders;
+    private contentLength;
+    private isChunked;
+    private bodyChunks;
+    private bodyBytesRead;
+    private result;
+    /** Maximum header section size (256 KB). */
+    private static readonly MAX_HEADER_SIZE;
+    /** Maximum body size (128 MB). */
+    private static readonly MAX_BODY_SIZE;
+    constructor(requestMethod?: string);
+    /**
+     * Feed data into the parser.
+     *
+     * Returns `true` when the response is fully parsed.
+     * After that, call `getResult()` to retrieve the parsed response,
+     * and `getRemainder()` for any trailing bytes.
+     */
+    feed(data: Buffer): boolean;
+    getResult(): ParsedResponse;
+    /** Get remaining data after the response (for connection reuse). */
+    getRemainder(): Buffer;
+    private parseStatusLine;
+    private parseHeaders;
+    private finalizeHeaders;
+    private parseBody;
+    private parseChunkedBody;
+    private finalize;
+    /**
+     * Signal that the connection was closed.
+     * Finalizes a "read until close" body.
+     */
+    connectionClosed(): void;
+}
+//# sourceMappingURL=parser.d.ts.map

package/dist/http/h1/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../src/http/h1/parser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,oDAAoD;IACpD,UAAU,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACpC,IAAI,EAAE,MAAM,CAAC;CACd;AAUD;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,KAAK,CAA0B;IACvC,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,WAAW,CAAM;IACzB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,aAAa,CAAM;IAC3B,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,UAAU,CAA+B;IACjD,OAAO,CAAC,aAAa,CAAM;IAC3B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAgB;IAClC,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,MAAM,CAA+B;IAE7C,4CAA4C;IAC5C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAU;IACjD,kCAAkC;IAClC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAa;gBAEtC,aAAa,SAAQ;IAIjC;;;;;;OAMG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAuB3B,SAAS,IAAI,cAAc;IAO3B,oEAAoE;IACpE,YAAY,IAAI,MAAM;IAItB,OAAO,CAAC,eAAe;IAwBvB,OAAO,CAAC,YAAY;IAsCpB,OAAO,CAAC,eAAe;IA8CvB,OAAO,CAAC,SAAS;IA6BjB,OAAO,CAAC,gBAAgB;IA4CxB,OAAO,CAAC,QAAQ;IAYhB;;;OAGG;IACH,gBAAgB,IAAI,IAAI;CAKzB"}

package/dist/http/h1/parser.js

@@ -0,0 +1,258 @@
+/**
+ * HTTP/1.1 response parser.
+ *
+ * Incrementally parses HTTP/1.1 responses from a byte stream.
+ * Handles chunked transfer encoding and content-length framing.
+ */
+var ParserState;
+(function (ParserState) {
+    ParserState[ParserState["StatusLine"] = 0] = "StatusLine";
+    ParserState[ParserState["Headers"] = 1] = "Headers";
+    ParserState[ParserState["Body"] = 2] = "Body";
+    ParserState[ParserState["ChunkedBody"] = 3] = "ChunkedBody";
+    ParserState[ParserState["Complete"] = 4] = "Complete";
+})(ParserState || (ParserState = {}));
+/**
+ * Incremental HTTP/1.1 response parser.
+ */
+export class HttpResponseParser {
+    requestMethod;
+    state = ParserState.StatusLine;
+    buffer = Buffer.alloc(0);
+    httpVersion = '';
+    statusCode = 0;
+    statusMessage = '';
+    headers = new Map();
+    rawHeaders = [];
+    contentLength = -1;
+    isChunked = false;
+    bodyChunks = [];
+    bodyBytesRead = 0;
+    result = null;
+    /** Maximum header section size (256 KB). */
+    static MAX_HEADER_SIZE = 262144;
+    /** Maximum body size (128 MB). */
+    static MAX_BODY_SIZE = 134217728;
+    constructor(requestMethod = 'GET') {
+        this.requestMethod = requestMethod.toUpperCase();
+    }
+    /**
+     * Feed data into the parser.
+     *
+     * Returns `true` when the response is fully parsed.
+     * After that, call `getResult()` to retrieve the parsed response,
+     * and `getRemainder()` for any trailing bytes.
+     */
+    feed(data) {
+        this.buffer = Buffer.concat([this.buffer, data]);
+        while (this.state !== ParserState.Complete) {
+            switch (this.state) {
+                case ParserState.StatusLine:
+                    if (!this.parseStatusLine())
+                        return false;
+                    break;
+                case ParserState.Headers:
+                    if (!this.parseHeaders())
+                        return false;
+                    break;
+                case ParserState.Body:
+                    if (!this.parseBody())
+                        return false;
+                    break;
+                case ParserState.ChunkedBody:
+                    if (!this.parseChunkedBody())
+                        return false;
+                    break;
+            }
+        }
+        return true;
+    }
+    getResult() {
+        if (!this.result) {
+            throw new Error('Response not fully parsed');
+        }
+        return this.result;
+    }
+    /** Get remaining data after the response (for connection reuse). */
+    getRemainder() {
+        return this.buffer;
+    }
+    parseStatusLine() {
+        const idx = this.buffer.indexOf('\r\n');
+        if (idx === -1) {
+            if (this.buffer.length > HttpResponseParser.MAX_HEADER_SIZE) {
+                throw new Error('Status line too long');
+            }
+            return false;
+        }
+        const line = this.buffer.subarray(0, idx).toString('latin1');
+        this.buffer = this.buffer.subarray(idx + 2);
+        const match = /^(HTTP\/\d\.\d)\s+(\d{3})\s*(.*)$/.exec(line);
+        if (!match) {
+            throw new Error(`Invalid HTTP status line: ${line.substring(0, 100)}`);
+        }
+        this.httpVersion = match[1];
+        this.statusCode = parseInt(match[2], 10);
+        this.statusMessage = match[3] ?? '';
+        this.state = ParserState.Headers;
+        return true;
+    }
+    parseHeaders() {
+        while (true) {
+            const idx = this.buffer.indexOf('\r\n');
+            if (idx === -1) {
+                if (this.buffer.length > HttpResponseParser.MAX_HEADER_SIZE) {
+                    throw new Error('Header section too large');
+                }
+                return false;
+            }
+            const line = this.buffer.subarray(0, idx).toString('latin1');
+            this.buffer = this.buffer.subarray(idx + 2);
+            if (line === '') {
+                // End of headers
+                this.finalizeHeaders();
+                return true;
+            }
+            const colonIdx = line.indexOf(':');
+            if (colonIdx === -1) {
+                throw new Error(`Invalid header line: ${line.substring(0, 100)}`);
+            }
+            const name = line.substring(0, colonIdx);
+            const value = line.substring(colonIdx + 1).trim();
+            this.rawHeaders.push([name, value]);
+            const lower = name.toLowerCase();
+            const existing = this.headers.get(lower);
+            if (existing !== undefined) {
+                this.headers.set(lower, existing + ', ' + value);
+            }
+            else {
+                this.headers.set(lower, value);
+            }
+        }
+    }
+    finalizeHeaders() {
+        // HEAD responses never have a body (RFC 9110 §9.3.2)
+        if (this.requestMethod === 'HEAD') {
+            this.finalize();
+            return;
+        }
+        // Determine body framing
+        const te = this.headers.get('transfer-encoding');
+        if (te && te.toLowerCase().includes('chunked')) {
+            this.isChunked = true;
+            this.state = ParserState.ChunkedBody;
+            return;
+        }
+        const cl = this.headers.get('content-length');
+        if (cl !== undefined) {
+            this.contentLength = parseInt(cl, 10);
+            if (Number.isNaN(this.contentLength) || this.contentLength < 0) {
+                throw new Error(`Invalid content-length: ${cl}`);
+            }
+            if (this.contentLength === 0) {
+                this.finalize();
+                return;
+            }
+            this.state = ParserState.Body;
+            return;
+        }
+        // No content-length, no chunked -- could be:
+        //   1xx, 204, 304 → no body
+        //   Everything else → read until connection close
+        if (this.statusCode === 204 ||
+            this.statusCode === 304 ||
+            (this.statusCode >= 100 && this.statusCode < 200)) {
+            this.finalize();
+            return;
+        }
+        // Read until close -- set contentLength to a sentinel
+        this.contentLength = -1;
+        this.state = ParserState.Body;
+    }
+    parseBody() {
+        if (this.contentLength >= 0) {
+            const needed = this.contentLength - this.bodyBytesRead;
+            if (this.buffer.length >= needed) {
+                this.bodyChunks.push(this.buffer.subarray(0, needed));
+                this.bodyBytesRead += needed;
+                this.buffer = this.buffer.subarray(needed);
+                this.finalize();
+                return true;
+            }
+            // Not enough data yet
+            this.bodyChunks.push(Buffer.from(this.buffer));
+            this.bodyBytesRead += this.buffer.length;
+            this.buffer = Buffer.alloc(0);
+            return false;
+        }
+        // Read until close -- accumulate everything
+        if (this.buffer.length > 0) {
+            this.bodyChunks.push(Buffer.from(this.buffer));
+            this.bodyBytesRead += this.buffer.length;
+            if (this.bodyBytesRead > HttpResponseParser.MAX_BODY_SIZE) {
+                throw new Error('Response body exceeds maximum size');
+            }
+            this.buffer = Buffer.alloc(0);
+        }
+        return false;
+    }
+    parseChunkedBody() {
+        while (true) {
+            // Read chunk size line
+            const idx = this.buffer.indexOf('\r\n');
+            if (idx === -1)
+                return false;
+            const sizeLine = this.buffer.subarray(0, idx).toString('latin1').trim();
+            // Chunk extensions are ignored (per spec)
+            const semiIdx = sizeLine.indexOf(';');
+            const sizeStr = semiIdx >= 0 ? sizeLine.substring(0, semiIdx) : sizeLine;
+            const chunkSize = parseInt(sizeStr, 16);
+            if (Number.isNaN(chunkSize)) {
+                throw new Error(`Invalid chunk size: ${sizeLine.substring(0, 20)}`);
+            }
+            // Need: chunk-size-line + \r\n + chunk-data + \r\n
+            const totalNeeded = idx + 2 + chunkSize + 2;
+            if (this.buffer.length < totalNeeded)
+                return false;
+            if (chunkSize === 0) {
+                // Terminal chunk
+                this.buffer = this.buffer.subarray(totalNeeded);
+                // Skip optional trailers
+                const trailerEnd = this.buffer.indexOf('\r\n');
+                if (trailerEnd >= 0) {
+                    this.buffer = this.buffer.subarray(trailerEnd + 2);
+                }
+                this.finalize();
+                return true;
+            }
+            const chunkData = this.buffer.subarray(idx + 2, idx + 2 + chunkSize);
+            this.bodyChunks.push(Buffer.from(chunkData));
+            this.bodyBytesRead += chunkSize;
+            if (this.bodyBytesRead > HttpResponseParser.MAX_BODY_SIZE) {
+                throw new Error('Response body exceeds maximum size');
+            }
+            this.buffer = this.buffer.subarray(totalNeeded);
+        }
+    }
+    finalize() {
+        this.state = ParserState.Complete;
+        this.result = {
+            httpVersion: this.httpVersion,
+            statusCode: this.statusCode,
+            statusMessage: this.statusMessage,
+            headers: this.headers,
+            rawHeaders: this.rawHeaders,
+            body: Buffer.concat(this.bodyChunks),
+        };
+    }
+    /**
+     * Signal that the connection was closed.
+     * Finalizes a "read until close" body.
+     */
+    connectionClosed() {
+        if (this.state === ParserState.Body && this.contentLength === -1) {
+            this.finalize();
+        }
+    }
+}
+//# sourceMappingURL=parser.js.map

package/dist/http/h1/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../../src/http/h1/parser.ts"],"names":[],"mappings":"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"}

package/dist/http/h2/client.d.ts

@@ -0,0 +1,48 @@
+/**
+ * HTTP/2 client.
+ *
+ * Multiplexed HTTP/2 client that runs over a TLS Duplex stream.
+ * Sends the connection preface with browser-profile-matched SETTINGS
+ * and WINDOW_UPDATE for Akamai HTTP/2 fingerprint control.
+ */
+import type { Duplex } from 'node:stream';
+import type { NLcURLRequest, RequestTimings } from '../../core/request.js';
+import { NLcURLResponse } from '../../core/response.js';
+import type { H2Profile } from '../../fingerprints/types.js';
+export declare class H2Client {
+    private readonly stream;
+    private readonly encoder;
+    private readonly decoder;
+    private readonly h2Profile;
+    private readonly defaultHeaders;
+    private nextStreamId;
+    private streams;
+    private readBuffer;
+    private prefaceSent;
+    private closed;
+    constructor(stream: Duplex, h2Profile?: H2Profile, defaultHeaders?: Array<[string, string]>);
+    /**
+     * Send the HTTP/2 connection preface.
+     *
+     * Must be called before sending any requests.
+     */
+    sendPreface(): void;
+    /**
+     * Send an HTTP/2 request and return the response.
+     */
+    request(req: NLcURLRequest, timings?: Partial<RequestTimings>): Promise<NLcURLResponse>;
+    /**
+     * Gracefully close the HTTP/2 connection.
+     */
+    close(): void;
+    destroy(): void;
+    private buildRequestHeaders;
+    private write;
+    private onData;
+    private processFrames;
+    private handleFrame;
+    private finalizeStream;
+    private onError;
+    private onClose;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/http/h2/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/http/h2/client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAGxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAmC7D,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwB;IAClD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA0B;IAEzD,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,OAAO,CAA+B;IAC9C,OAAO,CAAC,UAAU,CAAmB;IACrC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,MAAM,CAAS;gBAGrB,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,SAAS,EACrB,cAAc,GAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM;IAa9C;;;;OAIG;IACH,WAAW,IAAI,IAAI;IA4CnB;;OAEG;IACG,OAAO,CACX,GAAG,EAAE,aAAa,EAClB,OAAO,GAAE,OAAO,CAAC,cAAc,CAAM,GACpC,OAAO,CAAC,cAAc,CAAC;IA8D1B;;OAEG;IACH,KAAK,IAAI,IAAI;IAOb,OAAO,IAAI,IAAI;IAYf,OAAO,CAAC,mBAAmB;IAsD3B,OAAO,CAAC,KAAK;IAMb,OAAO,CAAC,MAAM;IAKd,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,WAAW;YAiFL,cAAc;IA8C5B,OAAO,CAAC,OAAO;IASf,OAAO,CAAC,OAAO;CAQhB"}