nlcurl 0.6.0 → 0.8.0

package/dist/http/alt-svc.d.ts

@@ -0,0 +1,67 @@
+/** Parsed Alt-Svc header entry. */
+export interface AltSvcEntry {
+    /** ALPN protocol identifier (e.g. "h3"). */
+    alpn: string;
+    /** Alternative authority hostname. */
+    host: string;
+    /** Alternative authority port. */
+    port: number;
+    /** Maximum age of the entry in seconds. */
+    maxAge: number;
+    /** Whether the entry persists across network changes. */
+    persist: boolean;
+    /** Timestamp when the entry was stored. */
+    storedAt: number;
+}
+/** Configuration for {@link AltSvcStore}. */
+export interface AltSvcConfig {
+    /** Maximum number of entries across all origins. */
+    maxEntries?: number;
+    /** Whether Alt-Svc processing is enabled. */
+    enabled?: boolean;
+}
+/** Store for Alt-Svc (Alternative Services) header entries. */
+export declare class AltSvcStore {
+    private readonly entries;
+    private readonly maxEntries;
+    private totalEntries;
+    /**
+     * Create a new Alt-Svc store.
+     *
+     * @param {AltSvcConfig} [config] - Store configuration.
+     */
+    constructor(config?: AltSvcConfig);
+    /**
+     * Parse an Alt-Svc response header and store the entries.
+     *
+     * @param {string} origin - Request origin (scheme + host + port).
+     * @param {string} headerValue - Raw Alt-Svc header value.
+     */
+    parseHeader(origin: string, headerValue: string): void;
+    /**
+     * Look up the best alternative service for an origin.
+     *
+     * @param {string} origin - Request origin to look up.
+     * @returns {AltSvcEntry|undefined} Best matching entry, preferring h3, or `undefined` if none.
+     */
+    lookup(origin: string): AltSvcEntry | undefined;
+    /**
+     * Check whether an origin has an HTTP/3 alternative service.
+     *
+     * @param {string} origin - Request origin to check.
+     * @returns {boolean} `true` if an h3 entry exists for the origin.
+     */
+    hasH3(origin: string): boolean;
+    /**
+     * Remove all Alt-Svc entries for an origin.
+     *
+     * @param {string} origin - Origin to clear.
+     */
+    clear(origin: string): void;
+    /** Remove all Alt-Svc entries from the store. */
+    clearAll(): void;
+    /** Total number of entries across all origins. */
+    get size(): number;
+    private evictOldest;
+}
+//# sourceMappingURL=alt-svc.d.ts.map

package/dist/http/alt-svc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alt-svc.d.ts","sourceRoot":"","sources":["../../src/http/alt-svc.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,MAAM,WAAW,WAAW;IAC1B,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,OAAO,EAAE,OAAO,CAAC;IACjB,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,6CAA6C;AAC7C,MAAM,WAAW,YAAY;IAC3B,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAKD,+DAA+D;AAC/D,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoC;IAC5D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,YAAY,CAAK;IAEzB;;;;OAIG;gBACS,MAAM,CAAC,EAAE,YAAY;IAIjC;;;;;OAKG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAyBtD;;;;;OAKG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IA2B/C;;;;;OAKG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAK9B;;;;OAIG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAQ3B,iDAAiD;IACjD,QAAQ,IAAI,IAAI;IAKhB,kDAAkD;IAClD,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,OAAO,CAAC,WAAW;CAiBpB"}

package/dist/http/alt-svc.js

@@ -0,0 +1,186 @@
+const DEFAULT_MAX_AGE = 86400;
+const DEFAULT_MAX_ENTRIES = 1000;
+/** Store for Alt-Svc (Alternative Services) header entries. */
+export class AltSvcStore {
+    entries = new Map();
+    maxEntries;
+    totalEntries = 0;
+    /**
+     * Create a new Alt-Svc store.
+     *
+     * @param {AltSvcConfig} [config] - Store configuration.
+     */
+    constructor(config) {
+        this.maxEntries = config?.maxEntries ?? DEFAULT_MAX_ENTRIES;
+    }
+    /**
+     * Parse an Alt-Svc response header and store the entries.
+     *
+     * @param {string} origin - Request origin (scheme + host + port).
+     * @param {string} headerValue - Raw Alt-Svc header value.
+     */
+    parseHeader(origin, headerValue) {
+        const trimmed = headerValue.trim();
+        if (trimmed === "clear") {
+            this.clear(origin);
+            return;
+        }
+        const now = Date.now();
+        const parsed = parseAltSvcHeader(trimmed, origin, now);
+        if (parsed.length === 0)
+            return;
+        const existing = this.entries.get(origin);
+        if (existing) {
+            this.totalEntries -= existing.length;
+        }
+        while (this.totalEntries + parsed.length > this.maxEntries) {
+            this.evictOldest();
+        }
+        this.entries.set(origin, parsed);
+        this.totalEntries += parsed.length;
+    }
+    /**
+     * Look up the best alternative service for an origin.
+     *
+     * @param {string} origin - Request origin to look up.
+     * @returns {AltSvcEntry|undefined} Best matching entry, preferring h3, or `undefined` if none.
+     */
+    lookup(origin) {
+        const entries = this.entries.get(origin);
+        if (!entries)
+            return undefined;
+        const now = Date.now();
+        const valid = entries.filter((e) => now - e.storedAt < e.maxAge * 1000);
+        if (valid.length === 0) {
+            this.entries.delete(origin);
+            this.totalEntries -= entries.length;
+            return undefined;
+        }
+        if (valid.length !== entries.length) {
+            this.totalEntries -= entries.length - valid.length;
+            this.entries.set(origin, valid);
+        }
+        const h3 = valid.find((e) => e.alpn === "h3");
+        if (h3)
+            return h3;
+        const h3Draft = valid.find((e) => e.alpn.startsWith("h3-"));
+        if (h3Draft)
+            return h3Draft;
+        return valid[0];
+    }
+    /**
+     * Check whether an origin has an HTTP/3 alternative service.
+     *
+     * @param {string} origin - Request origin to check.
+     * @returns {boolean} `true` if an h3 entry exists for the origin.
+     */
+    hasH3(origin) {
+        const entry = this.lookup(origin);
+        return entry !== undefined && (entry.alpn === "h3" || entry.alpn.startsWith("h3-"));
+    }
+    /**
+     * Remove all Alt-Svc entries for an origin.
+     *
+     * @param {string} origin - Origin to clear.
+     */
+    clear(origin) {
+        const entries = this.entries.get(origin);
+        if (entries) {
+            this.totalEntries -= entries.length;
+            this.entries.delete(origin);
+        }
+    }
+    /** Remove all Alt-Svc entries from the store. */
+    clearAll() {
+        this.entries.clear();
+        this.totalEntries = 0;
+    }
+    /** Total number of entries across all origins. */
+    get size() {
+        return this.totalEntries;
+    }
+    evictOldest() {
+        let oldestOrigin;
+        let oldestTime = Infinity;
+        for (const [origin, entries] of this.entries) {
+            for (const entry of entries) {
+                if (entry.storedAt < oldestTime) {
+                    oldestTime = entry.storedAt;
+                    oldestOrigin = origin;
+                }
+            }
+        }
+        if (oldestOrigin) {
+            this.clear(oldestOrigin);
+        }
+    }
+}
+function parseAltSvcHeader(value, origin, now) {
+    const entries = [];
+    const originUrl = new URL(origin);
+    const defaultHost = originUrl.hostname;
+    const defaultPort = parseInt(originUrl.port) || (originUrl.protocol === "https:" ? 443 : 80);
+    const alternatives = splitAltSvc(value);
+    for (const alt of alternatives) {
+        const entry = parseSingleAltSvc(alt.trim(), defaultHost, defaultPort, now);
+        if (entry)
+            entries.push(entry);
+    }
+    return entries;
+}
+function splitAltSvc(value) {
+    const parts = [];
+    let current = "";
+    let inQuotes = false;
+    for (const ch of value) {
+        if (ch === '"') {
+            inQuotes = !inQuotes;
+            current += ch;
+        }
+        else if (ch === "," && !inQuotes) {
+            parts.push(current);
+            current = "";
+        }
+        else {
+            current += ch;
+        }
+    }
+    if (current)
+        parts.push(current);
+    return parts;
+}
+function parseSingleAltSvc(alt, defaultHost, defaultPort, now) {
+    const match = alt.match(/^([a-zA-Z0-9-]+)="([^"]*)"/);
+    if (!match)
+        return null;
+    const alpn = match[1];
+    const authority = match[2];
+    let host = defaultHost;
+    let port = defaultPort;
+    if (authority) {
+        const colonIdx = authority.lastIndexOf(":");
+        if (colonIdx >= 0) {
+            const hostPart = authority.substring(0, colonIdx);
+            const portPart = authority.substring(colonIdx + 1);
+            if (hostPart)
+                host = hostPart;
+            const parsedPort = parseInt(portPart, 10);
+            if (!isNaN(parsedPort) && parsedPort > 0 && parsedPort <= 65535) {
+                port = parsedPort;
+            }
+        }
+    }
+    let maxAge = DEFAULT_MAX_AGE;
+    let persist = false;
+    const params = alt.substring(match[0].length);
+    const maMatch = params.match(/;\s*ma=(\d+)/);
+    if (maMatch) {
+        maxAge = parseInt(maMatch[1], 10);
+    }
+    const persistMatch = params.match(/;\s*persist=1/);
+    if (persistMatch) {
+        persist = true;
+    }
+    return { alpn, host, port, maxAge, persist, storedAt: now };
+}
+//# sourceMappingURL=alt-svc.js.map

package/dist/http/alt-svc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alt-svc.js","sourceRoot":"","sources":["../../src/http/alt-svc.ts"],"names":[],"mappings":"AAwBA,MAAM,eAAe,GAAG,KAAK,CAAC;AAC9B,MAAM,mBAAmB,GAAG,IAAI,CAAC;AAEjC,+DAA+D;AAC/D,MAAM,OAAO,WAAW;IACL,OAAO,GAAG,IAAI,GAAG,EAAyB,CAAC;IAC3C,UAAU,CAAS;IAC5B,YAAY,GAAG,CAAC,CAAC;IAEzB;;;;OAIG;IACH,YAAY,MAAqB;QAC/B,IAAI,CAAC,UAAU,GAAG,MAAM,EAAE,UAAU,IAAI,mBAAmB,CAAC;IAC9D,CAAC;IAED;;;;;OAKG;IACH,WAAW,CAAC,MAAc,EAAE,WAAmB;QAC7C,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC;QAEnC,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;YACxB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACnB,OAAO;QACT,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;QACvD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAEhC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,CAAC,YAAY,IAAI,QAAQ,CAAC,MAAM,CAAC;QACvC,CAAC;QAED,OAAO,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;YAC3D,IAAI,CAAC,WAAW,EAAE,CAAC;QACrB,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjC,IAAI,CAAC,YAAY,IAAI,MAAM,CAAC,MAAM,CAAC;IACrC,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,MAAc;QACnB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACzC,IAAI,CAAC,OAAO;YAAE,OAAO,SAAS,CAAC;QAE/B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEvB,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;QACxE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC5B,IAAI,CAAC,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;YACpC,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,IAAI,KAAK,CAAC,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC;YACpC,IAAI,CAAC,YAAY,IAAI,OAAO,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;YACnD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAClC,CAAC;QAED,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QAC9C,IAAI,EAAE;YAAE,OAAO,EAAE,CAAC;QAElB,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;QAC5D,IAAI,OAAO;YAAE,OAAO,OAAO,CAAC;QAE5B,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,MAAc;QAClB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAClC,OAAO,KAAK,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;IACtF,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAc;QAClB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACzC,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;YACpC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,iDAAiD;IACjD,QAAQ;QACN,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACrB,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;IACxB,CAAC;IAED,kDAAkD;IAClD,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAEO,WAAW;QACjB,IAAI,YAAgC,CAAC;QACrC,IAAI,UAAU,GAAG,QAAQ,CAAC;QAE1B,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAC7C,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC5B,IAAI,KAAK,CAAC,QAAQ,GAAG,UAAU,EAAE,CAAC;oBAChC,UAAU,GAAG,KAAK,CAAC,QAAQ,CAAC;oBAC5B,YAAY,GAAG,MAAM,CAAC;gBACxB,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,YAAY,EAAE,CAAC;YACjB,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;CACF;AAED,SAAS,iBAAiB,CAAC,KAAa,EAAE,MAAc,EAAE,GAAW;IACnE,MAAM,OAAO,GAAkB,EAAE,CAAC;IAClC,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;IAClC,MAAM,WAAW,GAAG,SAAS,CAAC,QAAQ,CAAC;IACvC,MAAM,WAAW,GAAG,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAE7F,MAAM,YAAY,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IAExC,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,iBAAiB,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,WAAW,EAAE,WAAW,EAAE,GAAG,CAAC,CAAC;QAC3E,IAAI,KAAK;YAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,WAAW,CAAC,KAAa;IAChC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,IAAI,QAAQ,GAAG,KAAK,CAAC;IAErB,KAAK,MAAM,EAAE,IAAI,KAAK,EAAE,CAAC;QACvB,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YACf,QAAQ,GAAG,CAAC,QAAQ,CAAC;YACrB,OAAO,IAAI,EAAE,CAAC;QAChB,CAAC;aAAM,IAAI,EAAE,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACpB,OAAO,GAAG,EAAE,CAAC;QACf,CAAC;aAAM,CAAC;YACN,OAAO,IAAI,EAAE,CAAC;QAChB,CAAC;IACH,CAAC;IACD,IAAI,OAAO;QAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACjC,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,iBAAiB,CAAC,GAAW,EAAE,WAAmB,EAAE,WAAmB,EAAE,GAAW;IAC3F,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;IACtD,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAExB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;IACvB,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;IAE5B,IAAI,IAAI,GAAG,WAAW,CAAC;IACvB,IAAI,IAAI,GAAG,WAAW,CAAC;IAEvB,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,QAAQ,GAAG,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAC5C,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;YAClB,MAAM,QAAQ,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;YAClD,MAAM,QAAQ,GAAG,SAAS,CAAC,SAAS,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;YACnD,IAAI,QAAQ;gBAAE,IAAI,GAAG,QAAQ,CAAC;YAC9B,MAAM,UAAU,GAAG,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YAC1C,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,UAAU,GAAG,CAAC,IAAI,UAAU,IAAI,KAAK,EAAE,CAAC;gBAChE,IAAI,GAAG,UAAU,CAAC;YACpB,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,MAAM,GAAG,eAAe,CAAC;IAC7B,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,MAAM,MAAM,GAAG,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IAC7C,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC,CAAC;IACrC,CAAC;IAED,MAAM,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IACnD,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,GAAG,IAAI,CAAC;IACjB,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;AAC9D,CAAC"}

package/dist/http/early-hints.d.ts

@@ -0,0 +1,23 @@
+/** Parsed early hint from a Link header in a 103 response. */
+export interface EarlyHint {
+    /** Target resource URI. */
+    uri: string;
+    /** Link relation type (e.g. "preload"). */
+    rel?: string;
+    /** Destination type for the resource (e.g. "script", "style"). */
+    as?: string;
+    /** MIME type of the linked resource. */
+    type?: string;
+    /** Whether the resource requires CORS. */
+    crossorigin?: boolean;
+}
+/**
+ * Parse a Link header into an array of early hints.
+ *
+ * @param {string} linkHeader - Raw Link header value.
+ * @returns {EarlyHint[]} Array of parsed early hint objects.
+ */
+export declare function parseLinkHeader(linkHeader: string): EarlyHint[];
+/** Callback invoked when 103 Early Hints are received. */
+export type EarlyHintsCallback = (hints: EarlyHint[]) => void;
+//# sourceMappingURL=early-hints.d.ts.map

package/dist/http/early-hints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"early-hints.d.ts","sourceRoot":"","sources":["../../src/http/early-hints.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,MAAM,WAAW,SAAS;IACxB,2BAA2B;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,2CAA2C;IAC3C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,EAAE,CA6B/D;AAED,0DAA0D;AAC1D,MAAM,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,IAAI,CAAC"}

package/dist/http/early-hints.js

@@ -0,0 +1,33 @@
+/**
+ * Parse a Link header into an array of early hints.
+ *
+ * @param {string} linkHeader - Raw Link header value.
+ * @returns {EarlyHint[]} Array of parsed early hint objects.
+ */
+export function parseLinkHeader(linkHeader) {
+    const hints = [];
+    const parts = linkHeader.split(",");
+    for (const part of parts) {
+        const trimmed = part.trim();
+        const uriMatch = /^<([^>]+)>/.exec(trimmed);
+        if (!uriMatch)
+            continue;
+        const hint = { uri: uriMatch[1] };
+        const params = trimmed.substring(uriMatch[0].length);
+        const relMatch = /;\s*rel\s*=\s*"?([^";]+)"?/i.exec(params);
+        if (relMatch)
+            hint.rel = relMatch[1].trim();
+        const asMatch = /;\s*as\s*=\s*"?([^";]+)"?/i.exec(params);
+        if (asMatch)
+            hint.as = asMatch[1].trim();
+        const typeMatch = /;\s*type\s*=\s*"?([^";]+)"?/i.exec(params);
+        if (typeMatch)
+            hint.type = typeMatch[1].trim();
+        if (/;\s*crossorigin/i.test(params)) {
+            hint.crossorigin = true;
+        }
+        hints.push(hint);
+    }
+    return hints;
+}
+//# sourceMappingURL=early-hints.js.map

package/dist/http/early-hints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"early-hints.js","sourceRoot":"","sources":["../../src/http/early-hints.ts"],"names":[],"mappings":"AAcA;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,UAAkB;IAChD,MAAM,KAAK,GAAgB,EAAE,CAAC;IAE9B,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACpC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5C,IAAI,CAAC,QAAQ;YAAE,SAAS;QAExB,MAAM,IAAI,GAAc,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAE,EAAE,CAAC;QAE9C,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QACrD,MAAM,QAAQ,GAAG,6BAA6B,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5D,IAAI,QAAQ;YAAE,IAAI,CAAC,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC;QAE7C,MAAM,OAAO,GAAG,4BAA4B,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1D,IAAI,OAAO;YAAE,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC;QAE1C,MAAM,SAAS,GAAG,8BAA8B,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC9D,IAAI,SAAS;YAAE,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC;QAEhD,IAAI,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YACpC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QAC1B,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/http/form-data.d.ts

@@ -1,58 +1,40 @@
-/**
- * Represents a single form field value. Either a string or a file descriptor.
- */
+/** File attachment for multipart form-data encoding. */
 export interface FormFile {
-    /** The file content as a Buffer. */
+    /** Raw file content. */
     data: Buffer;
-    /** The filename to use in the Content-Disposition header. */
+    /** Name of the file. */
     filename: string;
-    /** The MIME type of the file. Defaults to `application/octet-stream`. */
+    /** MIME content type (defaults to application/octet-stream). */
     contentType?: string;
 }
+/** A form field value — either a plain string or a file attachment. */
 export type FormValue = string | FormFile;
-/**
- * Builds a `multipart/form-data` request body per RFC 7578.
- *
- * Generates a cryptographically random boundary and serializes all fields
- * into a single `Buffer` suitable for use as a request body. The
- * corresponding `Content-Type` header (including the boundary parameter)
- * is available via {@link FormData.contentType}.
- *
- * @example
- * ```ts
- * const form = new FormData();
- * form.append("username", "alice");
- * form.append("avatar", { data: avatarBuffer, filename: "avatar.png", contentType: "image/png" });
- *
- * const response = await post("https://example.com/upload", form);
- * ```
- */
+/** Multipart form-data encoder for HTTP request bodies. */
 export declare class FormData {
     private readonly fields;
     private readonly boundary;
+    /** Create a new FormData instance with a random boundary. */
     constructor();
     /**
-     * Appends a field to the form data.
+     * Append a field to the form.
      *
-     * @param {string}    name  - The field name.
-     * @param {FormValue} value - A string value or a {@link FormFile} descriptor.
-     * @returns {this} The `FormData` instance for chaining.
+     * @param {string} name - Field name.
+     * @param {FormValue} value - String value or file attachment.
+     * @returns {this} This instance for chaining.
      */
     append(name: string, value: FormValue): this;
-    /**
-     * Returns the `Content-Type` header value including the boundary parameter.
-     * Must be set on the request for the server to parse the body correctly.
-     */
+    /** Content-Type header value including the boundary parameter. */
     get contentType(): string;
     /**
-     * Returns the boundary string used for this form data instance.
+     * Return the multipart boundary string.
+     *
+     * @returns {string} The boundary delimiter.
      */
     getBoundary(): string;
     /**
-     * Serializes all appended fields into a single `Buffer` in
-     * `multipart/form-data` format per RFC 7578.
+     * Encode all fields into a multipart form-data buffer.
      *
-     * @returns {Buffer} The encoded multipart body.
+     * @returns {Buffer} Wire-format multipart body.
      */
     encode(): Buffer;
 }

package/dist/http/form-data.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"form-data.d.ts","sourceRoot":"","sources":["../../src/http/form-data.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAC;IACjB,yEAAyE;IACzE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE1C;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiD;IACxE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;;IAMlC;;;;;;OAMG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI;IAK5C;;;OAGG;IACH,IAAI,WAAW,IAAI,MAAM,CAExB;IAED;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;;;;OAKG;IACH,MAAM,IAAI,MAAM;CA2BjB"}
+{"version":3,"file":"form-data.d.ts","sourceRoot":"","sources":["../../src/http/form-data.ts"],"names":[],"mappings":"AAEA,wDAAwD;AACxD,MAAM,WAAW,QAAQ;IACvB,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,uEAAuE;AACvE,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE1C,2DAA2D;AAC3D,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiD;IACxE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAElC,6DAA6D;;IAK7D;;;;;;OAMG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI;IAK5C,kEAAkE;IAClE,IAAI,WAAW,IAAI,MAAM,CAExB;IAED;;;;OAIG;IACH,WAAW,IAAI,MAAM;IAIrB;;;;OAIG;IACH,MAAM,IAAI,MAAM;CA2BjB"}

package/dist/http/form-data.js

@@ -1,56 +1,39 @@
 import { randomBytes } from "node:crypto";
-/**
- * Builds a `multipart/form-data` request body per RFC 7578.
- *
- * Generates a cryptographically random boundary and serializes all fields
- * into a single `Buffer` suitable for use as a request body. The
- * corresponding `Content-Type` header (including the boundary parameter)
- * is available via {@link FormData.contentType}.
- *
- * @example
- * ```ts
- * const form = new FormData();
- * form.append("username", "alice");
- * form.append("avatar", { data: avatarBuffer, filename: "avatar.png", contentType: "image/png" });
- *
- * const response = await post("https://example.com/upload", form);
- * ```
- */
+/** Multipart form-data encoder for HTTP request bodies. */
 export class FormData {
     fields = [];
     boundary;
+    /** Create a new FormData instance with a random boundary. */
     constructor() {
         this.boundary = `----NLcURL${randomBytes(24).toString("hex")}`;
     }
     /**
-     * Appends a field to the form data.
+     * Append a field to the form.
      *
-     * @param {string}    name  - The field name.
-     * @param {FormValue} value - A string value or a {@link FormFile} descriptor.
-     * @returns {this} The `FormData` instance for chaining.
+     * @param {string} name - Field name.
+     * @param {FormValue} value - String value or file attachment.
+     * @returns {this} This instance for chaining.
      */
     append(name, value) {
         this.fields.push({ name, value });
         return this;
     }
-    /**
-     * Returns the `Content-Type` header value including the boundary parameter.
-     * Must be set on the request for the server to parse the body correctly.
-     */
+    /** Content-Type header value including the boundary parameter. */
     get contentType() {
         return `multipart/form-data; boundary=${this.boundary}`;
     }
     /**
-     * Returns the boundary string used for this form data instance.
+     * Return the multipart boundary string.
+     *
+     * @returns {string} The boundary delimiter.
      */
     getBoundary() {
         return this.boundary;
     }
     /**
-     * Serializes all appended fields into a single `Buffer` in
-     * `multipart/form-data` format per RFC 7578.
+     * Encode all fields into a multipart form-data buffer.
      *
-     * @returns {Buffer} The encoded multipart body.
+     * @returns {Buffer} Wire-format multipart body.
      */
     encode() {
         const parts = [];
@@ -76,11 +59,6 @@ export class FormData {
         return Buffer.concat(parts);
     }
 }
-/**
- * Escapes double quotes and backslashes in header parameter values
- * and strips control characters (\r, \n, \0) to prevent header injection
- * in Content-Disposition fields.
- */
 function escapeQuotes(str) {
     return str
         .replace(/[\r\n\0]/g, "")

package/dist/http/form-data.js.map

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

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

@@ -2,41 +2,29 @@ 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";
-/**
- * Options shared across all HTTP/1.1 client functions.
- *
- * @typedef  {Object}              H1ClientOptions
- * @property {Array<[string,string]>} [defaultHeaders] - Profile-level headers prepended before request-specific headers.
- */
+/** Options for the HTTP/1.1 client. */
 export interface H1ClientOptions {
+    /** Default headers to include in every request. */
     defaultHeaders?: Array<[string, string]>;
 }
 /**
- * Sends an HTTP/1.1 request over the given duplex stream and returns the
- * fully buffered response. Blocks until all response body bytes are received.
+ * Send an HTTP/1.1 request and buffer the entire response body.
  *
- * @param {Duplex}              stream  - Connected transport stream.
- * @param {NLcURLRequest}       request - Request descriptor.
- * @param {H1ClientOptions}     [options={}] - Client options.
- * @param {Partial<RequestTimings>} [timings={}] - Partial timings object to populate with `firstByte`.
- * @returns {Promise<NLcURLResponse>} Resolves with the fully received and decompressed response.
- * @throws {HTTPError}   If the connection is closed before the response completes.
- * @throws {TimeoutError} If the response timeout is exceeded.
+ * @param {Duplex} stream - Duplex stream (typically a TLS socket).
+ * @param {NLcURLRequest} request - Request to send.
+ * @param {H1ClientOptions} [options] - Client options.
+ * @param {Partial<RequestTimings>} [timings] - Partial timings object to populate.
+ * @returns {Promise<NLcURLResponse>} Buffered HTTP response.
  */
 export declare function sendH1Request(stream: Duplex, request: NLcURLRequest, options?: H1ClientOptions, timings?: Partial<RequestTimings>): Promise<NLcURLResponse>;
 /**
- * Sends an HTTP/1.1 request over the given duplex stream and returns a
- * streaming response whose body is available as a `Readable` stream on
- * `response.body`. The headers are fully parsed before resolving;
- * the body is streamed asynchronously.
+ * Send an HTTP/1.1 request with a streaming response body.
  *
- * @param {Duplex}              stream  - Connected transport stream.
- * @param {NLcURLRequest}       request - Request descriptor.
- * @param {H1ClientOptions}     [options={}] - Client options.
- * @param {Partial<RequestTimings>} [timings={}] - Partial timings object to populate with `firstByte`.
- * @returns {Promise<NLcURLResponse>} Resolves once headers are received; body is streamed via `response.body`.
- * @throws {HTTPError}   If the connection is closed before headers are received.
- * @throws {TimeoutError} If the response timeout is exceeded.
+ * @param {Duplex} stream - Duplex stream (typically a TLS socket).
+ * @param {NLcURLRequest} request - Request to send.
+ * @param {H1ClientOptions} [options] - Client options.
+ * @param {Partial<RequestTimings>} [timings] - Partial timings object to populate.
+ * @returns {Promise<NLcURLResponse>} HTTP response with a readable body stream.
  */
 export declare function sendH1StreamingRequest(stream: Duplex, request: NLcURLRequest, options?: H1ClientOptions, timings?: Partial<RequestTimings>): Promise<NLcURLResponse>;
 //# sourceMappingURL=client.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/http/h1/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,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;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,cAAc,CAAC,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC1C;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,GAAE,eAAoB,EAAE,OAAO,GAAE,OAAO,CAAC,cAAc,CAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAoDzK;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,GAAE,eAAoB,EAAE,OAAO,GAAE,OAAO,CAAC,cAAc,CAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAuDlL"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/http/h1/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,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,uCAAuC;AACvC,MAAM,WAAW,eAAe;IAC9B,mDAAmD;IACnD,cAAc,CAAC,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC1C;AAED;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,GAAE,eAAoB,EAAE,OAAO,GAAE,OAAO,CAAC,cAAc,CAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAuEzK;AAED;;;;;;;;GAQG;AACH,wBAAsB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,GAAE,eAAoB,EAAE,OAAO,GAAE,OAAO,CAAC,cAAc,CAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAuDlL"}