nlcurl 0.6.0 → 0.8.0

package/dist/utils/buffer-writer.js

@@ -1,53 +1,35 @@
 const INITIAL_CAPACITY = 1024;
 const GROWTH_FACTOR = 2;
 const MAX_CAPACITY = 256 * 1024 * 1024;
-/**
- * Growable binary buffer writer that serializes typed values in big-endian byte
- * order. The internal buffer doubles in capacity as needed. Call
- * {@link BufferWriter.toBuffer} to obtain the written bytes as a new `Buffer`.
- *
- * @example
- * const w = new BufferWriter();
- * w.writeUInt8(0x16);
- * w.writeUInt16(0x0303);
- * w.writeVector16(data);
- * return w.toBuffer();
- */
+/** Auto-growing big-endian buffer builder. */
 export class BufferWriter {
     _buf;
     _pos;
     /**
-     * Creates a new BufferWriter with an optional initial capacity.
+     * Create a writer with the given initial capacity.
      *
-     * @param {number} [capacity=1024] - Initial internal buffer capacity in bytes.
+     * @param {number} [capacity] - Initial buffer allocation in bytes.
      */
     constructor(capacity = INITIAL_CAPACITY) {
         this._buf = Buffer.allocUnsafe(capacity);
         this._pos = 0;
     }
-    /** Current write position (equals the number of bytes written so far). */
+    /** Current write position (identical to the number of bytes written). */
     get position() {
         return this._pos;
     }
-    /** Number of bytes that have been written (alias for {@link BufferWriter.position}). */
+    /** Number of bytes written so far. */
     get length() {
         return this._pos;
     }
-    /**
-     * Returns a copy of the written bytes as a new `Buffer`. The returned buffer
-     * contains only the bytes that have been written, regardless of the internal
-     * capacity.
-     *
-     * @returns {Buffer} Copy of all written data.
-     */
+    /** Copy the written region into a new buffer and return it. */
     toBuffer() {
         return Buffer.from(this._buf.subarray(0, this._pos));
     }
     /**
-     * Writes one unsigned byte and advances the write position by 1.
+     * Write an unsigned 8-bit integer.
      *
-     * @param {number} value - Byte value (only the lowest 8 bits are used).
-     * @returns {this} This instance for chaining.
+     * @param {number} value - Value to write.
      */
     writeUInt8(value) {
         this.ensureCapacity(1);
@@ -56,10 +38,9 @@ export class BufferWriter {
         return this;
     }
     /**
-     * Writes one big-endian unsigned 16-bit integer and advances the write position by 2.
+     * Write an unsigned 16-bit big-endian integer.
      *
-     * @param {number} value - 16-bit value to write.
-     * @returns {this} This instance for chaining.
+     * @param {number} value - Value to write.
      */
     writeUInt16(value) {
         this.ensureCapacity(2);
@@ -68,10 +49,9 @@ export class BufferWriter {
         return this;
     }
     /**
-     * Writes one big-endian unsigned 24-bit integer and advances the write position by 3.
+     * Write an unsigned 24-bit big-endian integer.
      *
-     * @param {number} value - 24-bit value to write.
-     * @returns {this} This instance for chaining.
+     * @param {number} value - Value to write.
      */
     writeUInt24(value) {
         this.ensureCapacity(3);
@@ -82,10 +62,9 @@ export class BufferWriter {
         return this;
     }
     /**
-     * Writes one big-endian unsigned 32-bit integer and advances the write position by 4.
+     * Write an unsigned 32-bit big-endian integer.
      *
-     * @param {number} value - 32-bit value to write.
-     * @returns {this} This instance for chaining.
+     * @param {number} value - Value to write.
      */
     writeUInt32(value) {
         this.ensureCapacity(4);
@@ -94,10 +73,9 @@ export class BufferWriter {
         return this;
     }
     /**
-     * Appends raw bytes from `data` and advances the write position accordingly.
+     * Write raw bytes into the buffer.
      *
-     * @param {Buffer | Uint8Array} data - Data to write.
-     * @returns {this} This instance for chaining.
+     * @param {Buffer | Uint8Array} data - Bytes to append.
      */
     writeBytes(data) {
         this.ensureCapacity(data.length);
@@ -111,12 +89,9 @@ export class BufferWriter {
         return this;
     }
     /**
-     * Writes a length-prefixed byte vector using an 8-bit length prefix.
-     * Equivalent to `writeUInt8(data.length)` followed by `writeBytes(data)`.
+     * Write a length-prefixed vector with a 1-byte length prefix.
      *
-     * @param {Buffer | Uint8Array} data - Data to write (must be ≤ 255 bytes).
-     * @returns {this} This instance for chaining.
-     * @throws {RangeError} If `data.length` exceeds 255.
+     * @param {Buffer | Uint8Array} data - Data to write.
      */
     writeVector8(data) {
         if (data.length > 0xff) {
@@ -127,12 +102,9 @@ export class BufferWriter {
         return this;
     }
     /**
-     * Writes a length-prefixed byte vector using a big-endian 16-bit length prefix.
-     * Equivalent to `writeUInt16(data.length)` followed by `writeBytes(data)`.
+     * Write a length-prefixed vector with a 2-byte big-endian length prefix.
      *
-     * @param {Buffer | Uint8Array} data - Data to write (must be ≤ 65 535 bytes).
-     * @returns {this} This instance for chaining.
-     * @throws {RangeError} If `data.length` exceeds 65 535.
+     * @param {Buffer | Uint8Array} data - Data to write.
      */
     writeVector16(data) {
         if (data.length > 0xffff) {
@@ -143,12 +115,9 @@ export class BufferWriter {
         return this;
     }
     /**
-     * Writes a length-prefixed byte vector using a big-endian 24-bit length prefix.
-     * Equivalent to `writeUInt24(data.length)` followed by `writeBytes(data)`.
+     * Write a length-prefixed vector with a 3-byte big-endian length prefix.
      *
-     * @param {Buffer | Uint8Array} data - Data to write (must be ≤ 16 777 215 bytes).
-     * @returns {this} This instance for chaining.
-     * @throws {RangeError} If `data.length` exceeds 16 777 215.
+     * @param {Buffer | Uint8Array} data - Data to write.
      */
     writeVector24(data) {
         if (data.length > 0xffffff) {
@@ -159,13 +128,10 @@ export class BufferWriter {
         return this;
     }
     /**
-     * Reserves `size` bytes at the current position without writing any data,
-     * advances the cursor, and returns the byte offset of the reserved region.
-     * Use this to write a length prefix, then later patch it with
-     * {@link BufferWriter.patchUInt16} or {@link BufferWriter.patchUInt24}.
+     * Reserve space and return its offset for later patching.
      *
      * @param {number} size - Number of bytes to reserve.
-     * @returns {number} Byte offset of the start of the reserved region.
+     * @returns {number} Starting offset of the reserved region.
      */
     reserve(size) {
         this.ensureCapacity(size);
@@ -174,21 +140,19 @@ export class BufferWriter {
         return offset;
     }
     /**
-     * Overwrites a previously reserved 16-bit slot with `value` in big-endian byte order.
-     * Does not advance the write cursor.
+     * Overwrite a previously reserved 16-bit value.
      *
-     * @param {number} offset - Byte offset returned by {@link BufferWriter.reserve}.
-     * @param {number} value  - 16-bit value to patch in.
+     * @param {number} offset - Byte offset to patch.
+     * @param {number} value - New 16-bit value.
      */
     patchUInt16(offset, value) {
         this._buf.writeUInt16BE(value, offset);
     }
     /**
-     * Overwrites a previously reserved 24-bit slot with `value` in big-endian byte order.
-     * Does not advance the write cursor.
+     * Overwrite a previously reserved 24-bit value.
      *
-     * @param {number} offset - Byte offset returned by {@link BufferWriter.reserve}.
-     * @param {number} value  - 24-bit value to patch in.
+     * @param {number} offset - Byte offset to patch.
+     * @param {number} value - New 24-bit value.
      */
     patchUInt24(offset, value) {
         this._buf[offset] = (value >>> 16) & 0xff;

package/dist/utils/buffer-writer.js.map

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

package/dist/utils/compression.d.ts

@@ -0,0 +1,18 @@
+/** Supported request body compression encodings. */
+export type RequestEncoding = "gzip" | "deflate" | "br";
+/**
+ * Compress a request body buffer with the specified encoding.
+ *
+ * @param {Buffer} body - Uncompressed body bytes.
+ * @param {RequestEncoding} encoding - Compression algorithm.
+ * @returns {Promise<Buffer>} Compressed buffer.
+ */
+export declare function compressBody(body: Buffer, encoding: RequestEncoding): Promise<Buffer>;
+/**
+ * Determine whether a body is large enough to benefit from compression.
+ *
+ * @param {number} bodySize - Body size in bytes.
+ * @returns {boolean} `true` if the body meets the minimum threshold.
+ */
+export declare function shouldCompress(bodySize: number): boolean;
+//# sourceMappingURL=compression.d.ts.map

package/dist/utils/compression.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compression.d.ts","sourceRoot":"","sources":["../../src/utils/compression.ts"],"names":[],"mappings":"AAOA,oDAAoD;AACpD,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;AAExD;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAW3F;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAExD"}

package/dist/utils/compression.js

@@ -0,0 +1,34 @@
+import * as zlib from "node:zlib";
+import { promisify } from "node:util";
+const gzipAsync = promisify(zlib.gzip);
+const deflateAsync = promisify(zlib.deflate);
+const brotliCompressAsync = promisify(zlib.brotliCompress);
+/**
+ * Compress a request body buffer with the specified encoding.
+ *
+ * @param {Buffer} body - Uncompressed body bytes.
+ * @param {RequestEncoding} encoding - Compression algorithm.
+ * @returns {Promise<Buffer>} Compressed buffer.
+ */
+export async function compressBody(body, encoding) {
+    switch (encoding) {
+        case "gzip":
+            return gzipAsync(body);
+        case "deflate":
+            return deflateAsync(body);
+        case "br":
+            return brotliCompressAsync(body);
+        default:
+            return body;
+    }
+}
+/**
+ * Determine whether a body is large enough to benefit from compression.
+ *
+ * @param {number} bodySize - Body size in bytes.
+ * @returns {boolean} `true` if the body meets the minimum threshold.
+ */
+export function shouldCompress(bodySize) {
+    return bodySize >= 1024;
+}
+//# sourceMappingURL=compression.js.map

package/dist/utils/compression.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compression.js","sourceRoot":"","sources":["../../src/utils/compression.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACvC,MAAM,YAAY,GAAG,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAC7C,MAAM,mBAAmB,GAAG,SAAS,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;AAK3D;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAY,EAAE,QAAyB;IACxE,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,MAAM;YACT,OAAO,SAAS,CAAC,IAAI,CAAoB,CAAC;QAC5C,KAAK,SAAS;YACZ,OAAO,YAAY,CAAC,IAAI,CAAoB,CAAC;QAC/C,KAAK,IAAI;YACP,OAAO,mBAAmB,CAAC,IAAI,CAAoB,CAAC;QACtD;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,OAAO,QAAQ,IAAI,IAAI,CAAC;AAC1B,CAAC"}

package/dist/utils/dictionary-transport.d.ts

@@ -0,0 +1,97 @@
+/** Stored compression dictionary with associated metadata. */
+export interface CompressionDictionary {
+    /** SHA-256 hash of the dictionary data in structured field format. */
+    hash: string;
+    /** URL from which the dictionary was fetched. */
+    url: string;
+    /** Raw dictionary bytes. */
+    data: Buffer;
+    /** Timestamp (ms since epoch) when the dictionary was stored. */
+    storedAt: number;
+    /** URL match pattern from the `Use-As-Dictionary` header. */
+    matchPattern?: string;
+    /** Expiry timestamp (ms since epoch). */
+    expiresAt?: number;
+}
+/** Configuration for the compression dictionary store. */
+export interface DictionaryConfig {
+    /** Maximum number of dictionaries to cache. */
+    maxEntries?: number;
+    /** Maximum individual dictionary size in bytes. */
+    maxDictionarySize?: number;
+}
+/**
+ * Parse a `Use-As-Dictionary` response header.
+ *
+ * @param {string} header - Raw header value.
+ * @returns {{ match?: string; matchDest?: string[]; id?: string } | null} Parsed fields, or `null` if the header is empty.
+ */
+export declare function parseUseAsDictionary(header: string): {
+    match?: string;
+    matchDest?: string[];
+    id?: string;
+} | null;
+/**
+ * Compute the SHA-256 structured hash of dictionary data.
+ *
+ * @param {Buffer} data - Raw dictionary bytes.
+ * @returns {string} Hash string in structured field byte-sequence format.
+ */
+export declare function computeDictionaryHash(data: Buffer): string;
+/**
+ * Build an `Available-Dictionary` request header value.
+ *
+ * @param {string} hash - Dictionary hash.
+ * @returns {string} Header value string.
+ */
+export declare function buildAvailableDictionaryHeader(hash: string): string;
+/**
+ * Append dictionary-based encodings to an `Accept-Encoding` header.
+ *
+ * @param {string} [existingEncoding] - Current `Accept-Encoding` value.
+ * @returns {string} Updated encoding string with `dcb` and `dcz` appended.
+ */
+export declare function buildDictionaryAcceptEncoding(existingEncoding?: string): string;
+/** Cache of compression dictionaries for shared dictionary transport. */
+export declare class DictionaryStore {
+    private readonly dictionaries;
+    private readonly maxEntries;
+    private readonly maxDictionarySize;
+    /**
+     * Create a new dictionary store.
+     *
+     * @param {DictionaryConfig} [config] - Cache size and dictionary size limits.
+     */
+    constructor(config?: DictionaryConfig);
+    /**
+     * Store a dictionary response.
+     *
+     * @param {string} url - URL the dictionary was fetched from.
+     * @param {Buffer} data - Raw dictionary bytes.
+     * @param {{ match?: string; id?: string }} [metadata] - Match pattern and ID from the response header.
+     * @param {number} [maxAge] - Maximum age in seconds.
+     */
+    store(url: string, data: Buffer, metadata?: {
+        match?: string;
+        id?: string;
+    }, maxAge?: number): void;
+    /**
+     * Find a dictionary whose match pattern covers the given request URL.
+     *
+     * @param {string} requestUrl - URL being requested.
+     * @returns {CompressionDictionary | undefined} Matching dictionary, or `undefined` if none found.
+     */
+    findForUrl(requestUrl: string): CompressionDictionary | undefined;
+    /**
+     * Retrieve a dictionary by its hash.
+     *
+     * @param {string} hash - Dictionary hash string.
+     * @returns {CompressionDictionary | undefined} Dictionary entry, or `undefined` if not found.
+     */
+    getByHash(hash: string): CompressionDictionary | undefined;
+    /** Number of dictionaries currently stored. */
+    get size(): number;
+    /** Remove all stored dictionaries. */
+    clear(): void;
+}
+//# sourceMappingURL=dictionary-transport.d.ts.map

package/dist/utils/dictionary-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dictionary-transport.d.ts","sourceRoot":"","sources":["../../src/utils/dictionary-transport.ts"],"names":[],"mappings":"AAEA,8DAA8D;AAC9D,MAAM,WAAW,qBAAqB;IACpC,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,GAAG,EAAE,MAAM,CAAC;IACZ,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,QAAQ,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,0DAA0D;AAC1D,MAAM,WAAW,gBAAgB;IAC/B,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb,GAAG,IAAI,CA2BP;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG1D;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,CAQ/E;AAED,yEAAyE;AACzE,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA4C;IACzE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAE3C;;;;OAIG;gBACS,MAAM,CAAC,EAAE,gBAAgB;IAKrC;;;;;;;OAOG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IA2BnG;;;;;OAKG;IACH,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS;IAmBjE;;;;;OAKG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS;IAI1D,+CAA+C;IAC/C,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,sCAAsC;IACtC,KAAK,IAAI,IAAI;CAGd"}

package/dist/utils/dictionary-transport.js

@@ -0,0 +1,171 @@
+import { createHash } from "node:crypto";
+/**
+ * Parse a `Use-As-Dictionary` response header.
+ *
+ * @param {string} header - Raw header value.
+ * @returns {{ match?: string; matchDest?: string[]; id?: string } | null} Parsed fields, or `null` if the header is empty.
+ */
+export function parseUseAsDictionary(header) {
+    if (!header)
+        return null;
+    const result = {};
+    const matchRegex = /match="([^"]+)"/;
+    const matchMatch = header.match(matchRegex);
+    if (matchMatch) {
+        result.match = matchMatch[1];
+    }
+    const destRegex = /match-dest=\(([^)]*)\)/;
+    const destMatch = header.match(destRegex);
+    if (destMatch) {
+        result.matchDest = destMatch[1]
+            .split(/\s+/)
+            .map((s) => s.replace(/"/g, ""))
+            .filter(Boolean);
+    }
+    const idRegex = /id="([^"]+)"/;
+    const idMatch = header.match(idRegex);
+    if (idMatch) {
+        result.id = idMatch[1];
+    }
+    return result;
+}
+/**
+ * Compute the SHA-256 structured hash of dictionary data.
+ *
+ * @param {Buffer} data - Raw dictionary bytes.
+ * @returns {string} Hash string in structured field byte-sequence format.
+ */
+export function computeDictionaryHash(data) {
+    const hash = createHash("sha256").update(data).digest("base64");
+    return `:${hash}:`;
+}
+/**
+ * Build an `Available-Dictionary` request header value.
+ *
+ * @param {string} hash - Dictionary hash.
+ * @returns {string} Header value string.
+ */
+export function buildAvailableDictionaryHeader(hash) {
+    return hash;
+}
+/**
+ * Append dictionary-based encodings to an `Accept-Encoding` header.
+ *
+ * @param {string} [existingEncoding] - Current `Accept-Encoding` value.
+ * @returns {string} Updated encoding string with `dcb` and `dcz` appended.
+ */
+export function buildDictionaryAcceptEncoding(existingEncoding) {
+    const base = existingEncoding ?? "gzip, deflate, br";
+    const encodings = base.split(",").map((s) => s.trim());
+    if (!encodings.includes("dcb"))
+        encodings.push("dcb");
+    if (!encodings.includes("dcz"))
+        encodings.push("dcz");
+    return encodings.join(", ");
+}
+/** Cache of compression dictionaries for shared dictionary transport. */
+export class DictionaryStore {
+    dictionaries = new Map();
+    maxEntries;
+    maxDictionarySize;
+    /**
+     * Create a new dictionary store.
+     *
+     * @param {DictionaryConfig} [config] - Cache size and dictionary size limits.
+     */
+    constructor(config) {
+        this.maxEntries = config?.maxEntries ?? 50;
+        this.maxDictionarySize = config?.maxDictionarySize ?? 10 * 1024 * 1024;
+    }
+    /**
+     * Store a dictionary response.
+     *
+     * @param {string} url - URL the dictionary was fetched from.
+     * @param {Buffer} data - Raw dictionary bytes.
+     * @param {{ match?: string; id?: string }} [metadata] - Match pattern and ID from the response header.
+     * @param {number} [maxAge] - Maximum age in seconds.
+     */
+    store(url, data, metadata, maxAge) {
+        if (data.length > this.maxDictionarySize)
+            return;
+        if (this.dictionaries.size >= this.maxEntries) {
+            let oldest;
+            let oldestTime = Infinity;
+            for (const [key, entry] of this.dictionaries) {
+                if (entry.storedAt < oldestTime) {
+                    oldestTime = entry.storedAt;
+                    oldest = key;
+                }
+            }
+            if (oldest)
+                this.dictionaries.delete(oldest);
+        }
+        const hash = computeDictionaryHash(data);
+        const now = Date.now();
+        this.dictionaries.set(hash, {
+            hash,
+            url,
+            data,
+            storedAt: now,
+            matchPattern: metadata?.match,
+            expiresAt: maxAge ? now + maxAge * 1000 : undefined,
+        });
+    }
+    /**
+     * Find a dictionary whose match pattern covers the given request URL.
+     *
+     * @param {string} requestUrl - URL being requested.
+     * @returns {CompressionDictionary | undefined} Matching dictionary, or `undefined` if none found.
+     */
+    findForUrl(requestUrl) {
+        const now = Date.now();
+        for (const dict of this.dictionaries.values()) {
+            if (dict.expiresAt && dict.expiresAt < now) {
+                this.dictionaries.delete(dict.hash);
+                continue;
+            }
+            if (dict.matchPattern) {
+                if (matchesPattern(requestUrl, dict.matchPattern, dict.url)) {
+                    return dict;
+                }
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Retrieve a dictionary by its hash.
+     *
+     * @param {string} hash - Dictionary hash string.
+     * @returns {CompressionDictionary | undefined} Dictionary entry, or `undefined` if not found.
+     */
+    getByHash(hash) {
+        return this.dictionaries.get(hash);
+    }
+    /** Number of dictionaries currently stored. */
+    get size() {
+        return this.dictionaries.size;
+    }
+    /** Remove all stored dictionaries. */
+    clear() {
+        this.dictionaries.clear();
+    }
+}
+function matchesPattern(requestUrl, pattern, dictionaryUrl) {
+    try {
+        const dictBase = new URL(dictionaryUrl);
+        const reqUrl = new URL(requestUrl);
+        if (reqUrl.origin !== dictBase.origin)
+            return false;
+        if (pattern === "*" || pattern === "/*")
+            return true;
+        if (pattern.endsWith("*")) {
+            const prefix = pattern.slice(0, -1);
+            return reqUrl.pathname.startsWith(prefix);
+        }
+        return reqUrl.pathname === pattern;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=dictionary-transport.js.map

package/dist/utils/dictionary-transport.js.map

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

package/dist/utils/encoding.d.ts

@@ -1,44 +1,28 @@
 import { Transform } from "node:stream";
-/**
- * `true` when the current Node.js runtime provides native Zstandard
- * decompression support (`zlib.zstdDecompress`). `false` on older Node.js
- * versions that lack the API.
- */
+/** Whether the current Node.js build supports zstd decompression. */
 export declare const supportsZstd: boolean;
 /**
- * Decompresses a response body buffer using the algorithm indicated by
- * `contentEncoding`. Supports `gzip`, `x-gzip`, `deflate`, `br` (Brotli),
- * `zstd` (when available), and `identity`. Unrecognized encodings are
- * returned as-is.
+ * Decompress a response body according to `Content-Encoding` layers.
  *
- * @param {Buffer}            body            - Raw compressed body bytes.
- * @param {string | undefined} contentEncoding - Value of the `Content-Encoding` header.
- * @returns {Promise<Buffer>} Decompressed body bytes.
+ * @param {Buffer} body - Compressed body bytes.
+ * @param {string | undefined} contentEncoding - Comma-separated encoding list.
+ * @returns {Promise<Buffer>} Decompressed buffer.
  */
 export declare function decompressBody(body: Buffer, contentEncoding: string | undefined): Promise<Buffer>;
 /**
- * Creates a Node.js `Transform` stream that decompresses data on-the-fly
- * using the algorithm indicated by `contentEncoding`. Returns `null` when
- * no transform is needed (unknown or `identity` encoding).
+ * Create a streaming decompressor for the given `Content-Encoding`.
  *
- * @param {string | undefined} contentEncoding - Value of the `Content-Encoding` header.
- * @returns {Transform | null} Decompressor stream, or `null` if no decompression is required.
+ * @param {string | undefined} contentEncoding - Comma-separated encoding list.
+ * @returns {Transform | null} Transform stream, or `null` if no decompression is needed.
  */
 export declare function createDecompressStream(contentEncoding: string | undefined): Transform | null;
-/**
- * Returns the default `Accept-Encoding` header value supported by this
- * Node.js runtime. Includes `zstd` when Zstandard is available.
- *
- * @returns {string} E.g. `"gzip, deflate, br, zstd"` or `"gzip, deflate, br"`.
- */
+/** Return the default `Accept-Encoding` header value for this runtime. */
 export declare function defaultAcceptEncoding(): string;
 /**
- * Filters `zstd` from a caller-supplied `Accept-Encoding` value when the
- * current runtime does not support Zstandard decompression. Otherwise returns
- * the value unchanged.
+ * Strip unsupported encodings (e.g. `zstd`) from an `Accept-Encoding` value.
  *
- * @param {string} value - Caller-supplied `Accept-Encoding` header value.
- * @returns {string} Sanitized encoding list compatible with the runtime.
+ * @param {string} value - Original `Accept-Encoding` header value.
+ * @returns {string} Sanitized header value.
  */
 export declare function sanitizeAcceptEncoding(value: string): string;
 //# sourceMappingURL=encoding.d.ts.map

package/dist/utils/encoding.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"encoding.d.ts","sourceRoot":"","sources":["../../src/utils/encoding.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAiB,MAAM,aAAa,CAAC;AASvD;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,OAAsC,CAAC;AAElE;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CA4BvG;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,eAAe,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,IAAI,CA8B5F;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAO5D"}
+{"version":3,"file":"encoding.d.ts","sourceRoot":"","sources":["../../src/utils/encoding.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AASxC,qEAAqE;AACrE,eAAO,MAAM,YAAY,EAAE,OAAsC,CAAC;AAwClE;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAWvG;AA2BD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,eAAe,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,IAAI,CA0C5F;AAED,0EAA0E;AAC1E,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAO5D"}