@hyperttp/core 1.3.1 → 1.4.0

package/utils/decompress.js

@@ -1,8 +1,19 @@
-import { brotliDecompressSync, createBrotliDecompress, createGunzip, createInflate, gunzipSync, inflateSync, } from "node:zlib";
-import { Readable } from "node:stream";
+import { runtimeImport } from "../transports/manager.js";
 /**
- * @ru Разбирает строку Content-Encoding на массив кодировок (без identity).
- * @en Parses a Content-Encoding string into an array of encodings (excluding identity).
+ * @ru Флаг серверного окружения (Node.js/Bun/Deno).
+ * @en Server environment flag (Node.js/Bun/Deno).
+ */
+const IS_SERVER = typeof window === "undefined" && typeof self === "undefined";
+/**
+ * @ru No-op функция для dump() буферов. Буферы не требуют освобождения ресурсов.
+ * @en No-op function for buffer dump(). Buffers don't require resource cleanup.
+ */
+const NOOP_DUMP = async () => { };
+/**
+ * @ru Парсит строку Content-Encoding в массив кодировок.
+ * Игнорирует 'identity' (без сжатия) и пустые значения.
+ * @en Parses Content-Encoding string into an array of encodings.
+ * Ignores 'identity' (no compression) and empty values.
  * @param encoding - The Content-Encoding header value.
  * @returns Array of normalized encoding names.
  */
@@ -13,21 +24,21 @@ function parseEncodings(encoding) {
         .filter((part) => part.length > 0 && part !== "identity");
 }
 /**
- * @ru Прикрепляет пустой метод dump к буферу для соответствия интерфейсу TransportStreamExtensions.
- * @en Attaches a no-op dump method to a buffer to conform to TransportStreamExtensions.
- * @param buffer - The buffer to decorate.
- * @returns The same buffer with a dump method.
+ * @ru Добавляет no-op метод dump() к буферу.
+ * @en Attaches a no-op dump() method to the buffer.
+ * @param buffer - The Uint8Array to extend.
+ * @returns The buffer with dump() method attached.
  */
 function attachNoopDump(buffer) {
     const payload = buffer;
-    payload.dump = async () => { };
+    payload.dump = NOOP_DUMP;
     return payload;
 }
 /**
- * @ru Прикрепляет метод dump, который отменяет поток, к ReadableStream.
- * @en Attaches a dump method that cancels the stream to a ReadableStream.
- * @param stream - The stream to decorate.
- * @returns The same stream with a dump method.
+ * @ru Добавляет метод dump() к стриму для отмены и освобождения сокета.
+ * @en Attaches a dump() method to the stream for cancellation and socket release.
+ * @param stream - The ReadableStream to extend.
+ * @returns The stream with dump() method attached.
  */
 function attachStreamDump(stream) {
     const payload = stream;
@@ -42,74 +53,154 @@ function attachStreamDump(stream) {
     return payload;
 }
 /**
- * @ru Применяет декомпрессию один раз для заданной кодировки. Поддерживает gzip, deflate, br.
- * @en Applies decompression once for a given encoding. Supports gzip, deflate, br.
- * @param input - The compressed input buffer.
- * @param encoding - Single encoding name (e.g., 'gzip', 'deflate', 'br').
- * @returns Decompressed buffer, or original if encoding is not recognized.
+ * @ru Декомпрессирует буфер с использованием Web API (DecompressionStream).
+ * Поддерживает gzip и deflate. Возвращает исходный буфер, если декомпрессия невозможна.
+ * @en Decompresses a buffer using Web API (DecompressionStream).
+ * Supports gzip and deflate. Returns the original buffer if decompression is not possible.
+ * @param input - The compressed Uint8Array.
+ * @param encoding - The compression encoding ('gzip', 'deflate').
+ * @returns The decompressed Uint8Array, or the original input if not applicable.
+ */
+async function decompressOnceWeb(input, encoding) {
+    const enc = encoding.trim().toLowerCase();
+    if (typeof globalThis.DecompressionStream === "undefined")
+        return input;
+    const isGzip = enc === "gzip" || enc === "x-gzip";
+    const isDeflate = enc === "deflate";
+    if (!isGzip && !isDeflate)
+        return input;
+    const format = isGzip ? "gzip" : "deflate";
+    const inputStream = new ReadableStream({
+        start(controller) {
+            controller.enqueue(input);
+            controller.close();
+        },
+    });
+    const decompressedStream = inputStream.pipeThrough(new globalThis.DecompressionStream(format));
+    const reader = decompressedStream.getReader();
+    const chunks = [];
+    let totalLength = 0;
+    try {
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            if (value) {
+                chunks.push(value);
+                totalLength += value.byteLength;
+            }
+        }
+    }
+    finally {
+        reader.releaseLock();
+    }
+    if (chunks.length === 0)
+        return new Uint8Array(0);
+    if (chunks.length === 1)
+        return chunks[0];
+    const result = new Uint8Array(totalLength);
+    let offset = 0;
+    for (const chunk of chunks) {
+        result.set(chunk, offset);
+        offset += chunk.byteLength;
+    }
+    return result;
+}
+/**
+ * @ru Декомпрессирует буфер с использованием node:zlib.
+ * Поддерживает gzip, deflate и brotli.
+ * @en Decompresses a buffer using node:zlib.
+ * Supports gzip, deflate, and brotli.
+ * @param input - The compressed Uint8Array.
+ * @param encoding - The compression encoding.
+ * @returns The decompressed Uint8Array.
  */
-function decompressOnce(input, encoding) {
-    const buffer = Buffer.from(input);
-    switch (encoding) {
+async function decompressOnceNode(input, encoding) {
+    const enc = encoding.trim().toLowerCase();
+    const zlib = await runtimeImport("node:zlib");
+    const buffer = Buffer.from(input.buffer, input.byteOffset, input.byteLength);
+    switch (enc) {
         case "gzip":
         case "x-gzip":
-            return gunzipSync(buffer);
+            return new Uint8Array(zlib.gunzipSync(buffer));
         case "deflate":
-            return inflateSync(buffer);
+            return new Uint8Array(zlib.inflateSync(buffer));
         case "br":
-            return brotliDecompressSync(buffer);
+            return new Uint8Array(zlib.brotliDecompressSync(buffer));
         default:
             return input;
     }
 }
 /**
- * @ru Декомпрессирует буфер, последовательно применяя все кодировки из Content-Encoding.
- * @en Decompresses a buffer by sequentially applying all encodings from Content-Encoding.
- * @param body - Compressed buffer (Uint8Array).
- * @param encoding - Content-Encoding header value (e.g., 'gzip, deflate').
- * @returns Decompressed buffer with a no-op dump method.
+ * @ru Декомпрессирует буфер с поддержкой множественных кодировок.
+ * Сначала пытается Web API, затем fallback на node:zlib для серверных сред.
+ * @en Decompresses a buffer with support for multiple encodings.
+ * Tries Web API first, then falls back to node:zlib for server environments.
+ * @param body - The compressed Uint8Array.
+ * @param encoding - The Content-Encoding header value (e.g., 'gzip, br').
+ * @returns The decompressed buffer with dump() method attached.
  */
-export function decompressBuffer(body, encoding) {
+export async function decompressBuffer(body, encoding) {
     let current = body;
-    for (const enc of parseEncodings(encoding)) {
-        current = decompressOnce(current, enc);
+    const encodings = parseEncodings(encoding);
+    for (let i = 0; i < encodings.length; i++) {
+        const enc = encodings[i];
+        const webResult = await decompressOnceWeb(current, enc);
+        if (webResult !== current) {
+            current = webResult;
+            continue;
+        }
+        if (IS_SERVER && (enc === "br" || enc === "gzip" || enc === "deflate" || enc === "x-gzip")) {
+            try {
+                current = await decompressOnceNode(current, enc);
+            }
+            catch {
+                continue;
+            }
+        }
     }
     return attachNoopDump(current);
 }
 /**
- * @ru Создаёт декомпрессирующий поток для тела ответа, поддерживая цепочку кодировок. Использует DecompressionStream (если доступен) или Node.js zlib.
- * @en Creates a decompressing stream for the response body, supporting chained encodings. Uses DecompressionStream (if available) or Node.js zlib.
- * @param body - Source compressed stream.
- * @param encoding - Content-Encoding header value.
- * @returns Transformed stream with a dump method that cancels the stream.
+ * @ru Создаёт декомпрессированный стрим с поддержкой множественных кодировок.
+ * Использует DecompressionStream для Web и node:zlib для Node.js.
+ * @en Creates a decompressed stream with support for multiple encodings.
+ * Uses DecompressionStream for Web and node:zlib for Node.js.
+ * @param body - The compressed ReadableStream.
+ * @param encoding - The Content-Encoding header value (e.g., 'gzip, br').
+ * @returns The decompressed stream with dump() method attached.
  */
-export function createDecompressStream(body, encoding) {
+export async function createDecompressStream(body, encoding) {
+    const encodings = parseEncodings(encoding);
+    if (encodings.length === 0)
+        return attachStreamDump(body);
     let current = body;
-    for (const enc of parseEncodings(encoding)) {
-        if (enc === "gzip" || enc === "x-gzip") {
-            if (typeof DecompressionStream !== "undefined") {
-                current = current.pipeThrough(new DecompressionStream("gzip"));
-                continue;
-            }
-            const nodeReadable = Readable.fromWeb(current);
-            const decompressed = nodeReadable.pipe(createGunzip());
-            current = Readable.toWeb(decompressed);
-            continue;
+    for (let i = 0; i < encodings.length; i++) {
+        const enc = encodings[i];
+        const isGzip = enc === "gzip" || enc === "x-gzip";
+        const isDeflate = enc === "deflate";
+        const isBrotli = enc === "br";
+        if ((isGzip || isDeflate) && typeof globalThis.DecompressionStream !== "undefined") {
+            const format = isGzip ? "gzip" : "deflate";
+            current = current.pipeThrough(new globalThis.DecompressionStream(format));
         }
-        if (enc === "deflate") {
-            if (typeof DecompressionStream !== "undefined") {
-                current = current.pipeThrough(new DecompressionStream("deflate"));
+        else if (IS_SERVER) {
+            try {
+                const { Readable } = await runtimeImport("node:stream");
+                const zlib = await runtimeImport("node:zlib");
+                const nodeReadableStream = Readable.fromWeb(current);
+                let transformer = nodeReadableStream;
+                if (isGzip)
+                    transformer = nodeReadableStream.pipe(zlib.createGunzip());
+                else if (isDeflate)
+                    transformer = nodeReadableStream.pipe(zlib.createInflate());
+                else if (isBrotli)
+                    transformer = nodeReadableStream.pipe(zlib.createBrotliDecompress());
+                current = Readable.toWeb(transformer);
+            }
+            catch {
                 continue;
             }
-            const nodeReadable = Readable.fromWeb(current);
-            const decompressed = nodeReadable.pipe(createInflate());
-            current = Readable.toWeb(decompressed);
-            continue;
-        }
-        if (enc === "br") {
-            const nodeReadable = Readable.fromWeb(current);
-            const decompressed = nodeReadable.pipe(createBrotliDecompress());
-            current = Readable.toWeb(decompressed);
         }
     }
     return attachStreamDump(current);

package/utils/decompress.js.map

@@ -1 +1 @@
-{"version":3,"file":"decompress.js","sourceRoot":"","sources":["../../src/utils/decompress.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"decompress.js","sourceRoot":"","sources":["../../src/utils/decompress.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAKzD;;;GAGG;AACH,MAAM,SAAS,GAAG,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,IAAI,KAAK,WAAW,CAAC;AAE/E;;;GAGG;AACH,MAAM,SAAS,GAAG,KAAK,IAAmB,EAAE,GAAE,CAAC,CAAC;AAEhD;;;;;;;GAOG;AACH,SAAS,cAAc,CAAC,QAAgB;IACtC,OAAO,QAAQ;SACZ,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;SACxC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,KAAK,UAAU,CAAC,CAAC;AAC9D,CAAC;AAED;;;;;GAKG;AACH,SAAS,cAAc,CAAC,MAAkB;IACxC,MAAM,OAAO,GAAG,MAAuB,CAAC;IACxC,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC;IACzB,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;GAKG;AACH,SAAS,gBAAgB,CAAC,MAAkC;IAC1D,MAAM,OAAO,GAAG,MAAuB,CAAC;IACxC,OAAO,CAAC,IAAI,GAAG,KAAK,IAAmB,EAAE;QACvC,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC;QACzB,CAAC;QAAC,MAAM,CAAC;YACP,EAAE;QACJ,CAAC;IACH,CAAC,CAAC;IACF,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;;GAQG;AACH,KAAK,UAAU,iBAAiB,CAAC,KAAiB,EAAE,QAAgB;IAClE,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC1C,IAAI,OAAO,UAAU,CAAC,mBAAmB,KAAK,WAAW;QAAE,OAAO,KAAK,CAAC;IAExE,MAAM,MAAM,GAAG,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,QAAQ,CAAC;IAClD,MAAM,SAAS,GAAG,GAAG,KAAK,SAAS,CAAC;IACpC,IAAI,CAAC,MAAM,IAAI,CAAC,SAAS;QAAE,OAAO,KAAK,CAAC;IAExC,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IAE3C,MAAM,WAAW,GAAG,IAAI,cAAc,CAAa;QACjD,KAAK,CAAC,UAAU;YACd,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC1B,UAAU,CAAC,KAAK,EAAE,CAAC;QACrB,CAAC;KACF,CAAC,CAAC;IAEH,MAAM,kBAAkB,GAAG,WAAW,CAAC,WAAW,CAChD,IAAI,UAAU,CAAC,mBAAmB,CAAC,MAAM,CAA4C,CACtF,CAAC;IAEF,MAAM,MAAM,GAAG,kBAAkB,CAAC,SAAS,EAAE,CAAC;IAC9C,MAAM,MAAM,GAAiB,EAAE,CAAC;IAChC,IAAI,WAAW,GAAG,CAAC,CAAC;IAEpB,IAAI,CAAC;QACH,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YAC5C,IAAI,IAAI;gBAAE,MAAM;YAChB,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACnB,WAAW,IAAI,KAAK,CAAC,UAAU,CAAC;YAClC,CAAC;QACH,CAAC;IACH,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,WAAW,EAAE,CAAC;IACvB,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;IAClD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC,CAAC,CAAE,CAAC;IAE3C,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,WAAW,CAAC,CAAC;IAC3C,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC;IAC7B,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;GAQG;AACH,KAAK,UAAU,kBAAkB,CAAC,KAAiB,EAAE,QAAgB;IACnE,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC1C,MAAM,IAAI,GAAG,MAAM,aAAa,CAAM,WAAW,CAAC,CAAC;IACnD,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IAE7E,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,MAAM,CAAC;QACZ,KAAK,QAAQ;YACX,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;QACjD,KAAK,SAAS;YACZ,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;QAClD,KAAK,IAAI;YACP,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC,CAAC;QAC3D;YACE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAgB,EAAE,QAAgB;IACvE,IAAI,OAAO,GAAe,IAAI,CAAC;IAC/B,MAAM,SAAS,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IAE3C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1C,MAAM,GAAG,GAAG,SAAS,CAAC,CAAC,CAAE,CAAC;QAE1B,MAAM,SAAS,GAAG,MAAM,iBAAiB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACxD,IAAI,SAAS,KAAK,OAAO,EAAE,CAAC;YAC1B,OAAO,GAAG,SAAS,CAAC;YACpB,SAAS;QACX,CAAC;QAED,IAAI,SAAS,IAAI,CAAC,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,QAAQ,CAAC,EAAE,CAAC;YAC3F,IAAI,CAAC;gBACH,OAAO,GAAG,MAAM,kBAAkB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YACnD,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,cAAc,CAAC,OAAO,CAAC,CAAC;AACjC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,IAAgC,EAChC,QAAgB;IAEhB,MAAM,SAAS,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IAC3C,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAE1D,IAAI,OAAO,GAA+B,IAAI,CAAC;IAE/C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1C,MAAM,GAAG,GAAG,SAAS,CAAC,CAAC,CAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,QAAQ,CAAC;QAClD,MAAM,SAAS,GAAG,GAAG,KAAK,SAAS,CAAC;QACpC,MAAM,QAAQ,GAAG,GAAG,KAAK,IAAI,CAAC;QAE9B,IAAI,CAAC,MAAM,IAAI,SAAS,CAAC,IAAI,OAAO,UAAU,CAAC,mBAAmB,KAAK,WAAW,EAAE,CAAC;YACnF,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;YAC3C,OAAO,GAAG,OAAO,CAAC,WAAW,CAC3B,IAAI,UAAU,CAAC,mBAAmB,CAAC,MAAM,CAA4C,CACtF,CAAC;QACJ,CAAC;aAAM,IAAI,SAAS,EAAE,CAAC;YACrB,IAAI,CAAC;gBACH,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,aAAa,CAAM,aAAa,CAAC,CAAC;gBAC7D,MAAM,IAAI,GAAG,MAAM,aAAa,CAAM,WAAW,CAAC,CAAC;gBAEnD,MAAM,kBAAkB,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAc,CAAC,CAAC;gBAC5D,IAAI,WAAW,GAAQ,kBAAkB,CAAC;gBAE1C,IAAI,MAAM;oBAAE,WAAW,GAAG,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;qBAClE,IAAI,SAAS;oBAAE,WAAW,GAAG,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC;qBAC3E,IAAI,QAAQ;oBAAE,WAAW,GAAG,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,sBAAsB,EAAE,CAAC,CAAC;gBAExF,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,WAAW,CAA0C,CAAC;YACjF,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,gBAAgB,CAAC,OAAO,CAAC,CAAC;AACnC,CAAC"}

package/utils/errors.d.ts

@@ -11,12 +11,6 @@ export declare class HttpClientError extends Error {
     /**
      * @ru Создает новый экземпляр HttpClientError.
      * @en Creates a new HttpClientError instance.
-     * @param message - Human-readable error message text.
-     * @param code - Internal stringified error state identifier code.
-     * @param statusCode - Numerical HTTP response status code received from the server.
-     * @param originalError - Raw captured exception instance causing this failure.
-     * @param url - Targeted request URL destination string.
-     * @param method - HTTP method verb utilized for the request.
      */
     constructor(message: string, code?: string, statusCode?: number | undefined, originalError?: Error | undefined, url?: string | undefined, method?: string | undefined);
 }
@@ -28,8 +22,6 @@ export declare class TimeoutError extends HttpClientError {
     /**
      * @ru Создает новый экземпляр TimeoutError.
      * @en Creates a new TimeoutError instance.
-     * @param url - Targeted request URL destination string.
-     * @param timeout - Threshold duration statement in milliseconds.
      */
     constructor(url: string, timeout: number);
 }
@@ -41,8 +33,6 @@ export declare class RateLimitError extends HttpClientError {
     /**
      * @ru Создает новый экземпляр RateLimitError.
      * @en Creates a new RateLimitError instance.
-     * @param url - Targeted request URL destination string.
-     * @param retryAfter - Optional cool-down period duration in milliseconds before the next retry attempt.
      */
     constructor(url: string, retryAfter?: number);
 }

package/utils/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IAa/B,IAAI,EAAE,MAAM;IACZ,UAAU,CAAC,EAAE,MAAM;IACnB,aAAa,CAAC,EAAE,KAAK;IACrB,GAAG,CAAC,EAAE,MAAM;IACZ,MAAM,CAAC,EAAE,MAAM;IAhBxB;;;;;;;;;OASG;gBAED,OAAO,EAAE,MAAM,EACR,IAAI,GAAE,MAAqB,EAC3B,UAAU,CAAC,EAAE,MAAM,YAAA,EACnB,aAAa,CAAC,EAAE,KAAK,YAAA,EACrB,GAAG,CAAC,EAAE,MAAM,YAAA,EACZ,MAAM,CAAC,EAAE,MAAM,YAAA;CAKzB;AAED;;;GAGG;AACH,qBAAa,YAAa,SAAQ,eAAe;IAC/C;;;;;OAKG;gBACS,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAIzC;AAED;;;GAGG;AACH,qBAAa,cAAe,SAAQ,eAAe;IACjD;;;;;OAKG;gBACS,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;CAU7C"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IAO/B,IAAI,EAAE,MAAM;IACZ,UAAU,CAAC,EAAE,MAAM;IACnB,aAAa,CAAC,EAAE,KAAK;IACrB,GAAG,CAAC,EAAE,MAAM;IACZ,MAAM,CAAC,EAAE,MAAM;IAVxB;;;OAGG;gBAED,OAAO,EAAE,MAAM,EACR,IAAI,GAAE,MAAqB,EAC3B,UAAU,CAAC,EAAE,MAAM,YAAA,EACnB,aAAa,CAAC,EAAE,KAAK,YAAA,EACrB,GAAG,CAAC,EAAE,MAAM,YAAA,EACZ,MAAM,CAAC,EAAE,MAAM,YAAA;CAKzB;AAED;;;GAGG;AACH,qBAAa,YAAa,SAAQ,eAAe;IAC/C;;;OAGG;gBACS,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAIzC;AAED;;;GAGG;AACH,qBAAa,cAAe,SAAQ,eAAe;IACjD;;;OAGG;gBACS,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;CAU7C"}

package/utils/errors.js

@@ -11,15 +11,9 @@ export class HttpClientError extends Error {
     /**
      * @ru Создает новый экземпляр HttpClientError.
      * @en Creates a new HttpClientError instance.
-     * @param message - Human-readable error message text.
-     * @param code - Internal stringified error state identifier code.
-     * @param statusCode - Numerical HTTP response status code received from the server.
-     * @param originalError - Raw captured exception instance causing this failure.
-     * @param url - Targeted request URL destination string.
-     * @param method - HTTP method verb utilized for the request.
      */
     constructor(message, code = "HTTP_ERROR", statusCode, originalError, url, method) {
-        super(message);
+        super(message, originalError ? { cause: originalError } : undefined);
         this.code = code;
         this.statusCode = statusCode;
         this.originalError = originalError;
@@ -36,8 +30,6 @@ export class TimeoutError extends HttpClientError {
     /**
      * @ru Создает новый экземпляр TimeoutError.
      * @en Creates a new TimeoutError instance.
-     * @param url - Targeted request URL destination string.
-     * @param timeout - Threshold duration statement in milliseconds.
      */
     constructor(url, timeout) {
         super(`Timeout after ${timeout}ms`, "TIMEOUT", 408, undefined, url);
@@ -52,8 +44,6 @@ export class RateLimitError extends HttpClientError {
     /**
      * @ru Создает новый экземпляр RateLimitError.
      * @en Creates a new RateLimitError instance.
-     * @param url - Targeted request URL destination string.
-     * @param retryAfter - Optional cool-down period duration in milliseconds before the next retry attempt.
      */
     constructor(url, retryAfter) {
         super(`Rate limited${retryAfter ? ` retry in ${retryAfter}ms` : ""}`, "RATE_LIMIT", 429, undefined, url);

package/utils/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAa/B;IACA;IACA;IACA;IACA;IAhBT;;;;;;;;;OASG;IACH,YACE,OAAe,EACR,OAAe,YAAY,EAC3B,UAAmB,EACnB,aAAqB,EACrB,GAAY,EACZ,MAAe;QAEtB,KAAK,CAAC,OAAO,CAAC,CAAC;QANR,SAAI,GAAJ,IAAI,CAAuB;QAC3B,eAAU,GAAV,UAAU,CAAS;QACnB,kBAAa,GAAb,aAAa,CAAQ;QACrB,QAAG,GAAH,GAAG,CAAS;QACZ,WAAM,GAAN,MAAM,CAAS;QAGtB,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,YAAa,SAAQ,eAAe;IAC/C;;;;;OAKG;IACH,YAAY,GAAW,EAAE,OAAe;QACtC,KAAK,CAAC,iBAAiB,OAAO,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;QACpE,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,cAAe,SAAQ,eAAe;IACjD;;;;;OAKG;IACH,YAAY,GAAW,EAAE,UAAmB;QAC1C,KAAK,CACH,eAAe,UAAU,CAAC,CAAC,CAAC,aAAa,UAAU,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,EAC9D,YAAY,EACZ,GAAG,EACH,SAAS,EACT,GAAG,CACJ,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAO/B;IACA;IACA;IACA;IACA;IAVT;;;OAGG;IACH,YACE,OAAe,EACR,OAAe,YAAY,EAC3B,UAAmB,EACnB,aAAqB,EACrB,GAAY,EACZ,MAAe;QAEtB,KAAK,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAN9D,SAAI,GAAJ,IAAI,CAAuB;QAC3B,eAAU,GAAV,UAAU,CAAS;QACnB,kBAAa,GAAb,aAAa,CAAQ;QACrB,QAAG,GAAH,GAAG,CAAS;QACZ,WAAM,GAAN,MAAM,CAAS;QAGtB,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,YAAa,SAAQ,eAAe;IAC/C;;;OAGG;IACH,YAAY,GAAW,EAAE,OAAe;QACtC,KAAK,CAAC,iBAAiB,OAAO,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;QACpE,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,cAAe,SAAQ,eAAe;IACjD;;;OAGG;IACH,YAAY,GAAW,EAAE,UAAmB;QAC1C,KAAK,CACH,eAAe,UAAU,CAAC,CAAC,CAAC,aAAa,UAAU,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,EAC9D,YAAY,EACZ,GAAG,EACH,SAAS,EACT,GAAG,CACJ,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF"}

package/utils/merge.d.ts

@@ -1,9 +1,6 @@
 /**
  * @ru Рекурсивно объединяет два объекта. Избегает лишних аллокаций памяти и защищает от разделения ссылок nested-структур.
  * @en Recursively merges two objects. Avoids redundant memory allocations and prevents shared reference leakage for nested structures.
- * @param target - Foundational target base object layout.
- * @param source - High-priority source object containing overrides.
- * @returns New deeply merged intersection object.
  */
 export declare function deepMerge<T extends Record<string, unknown>, S extends Record<string, unknown>>(target: T, source: S): T & S;
 //# sourceMappingURL=merge.d.ts.map

package/utils/merge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"merge.d.ts","sourceRoot":"","sources":["../../src/utils/merge.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,SAAS,CACvB,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAuB7B"}
+{"version":3,"file":"merge.d.ts","sourceRoot":"","sources":["../../src/utils/merge.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5F,MAAM,EAAE,CAAC,EACT,MAAM,EAAE,CAAC,GACR,CAAC,GAAG,CAAC,CAoBP"}

package/utils/merge.js

@@ -1,29 +1,20 @@
 /**
  * @ru Рекурсивно объединяет два объекта. Избегает лишних аллокаций памяти и защищает от разделения ссылок nested-структур.
  * @en Recursively merges two objects. Avoids redundant memory allocations and prevents shared reference leakage for nested structures.
- * @param target - Foundational target base object layout.
- * @param source - High-priority source object containing overrides.
- * @returns New deeply merged intersection object.
  */
 export function deepMerge(target, source) {
     const output = { ...target };
-    if (isObject(target) && isObject(source)) {
-        for (const key in source) {
-            if (Object.prototype.hasOwnProperty.call(source, key)) {
-                const sourceValue = source[key];
-                const targetValue = output[key];
-                if (isObject(sourceValue)) {
-                    if (key in output && isObject(targetValue)) {
-                        output[key] = deepMerge(targetValue, sourceValue);
-                    }
-                    else {
-                        output[key] = deepMerge({}, sourceValue);
-                    }
-                }
-                else if (sourceValue !== undefined) {
-                    output[key] = sourceValue;
-                }
-            }
+    for (const key of Object.keys(source)) {
+        const sourceValue = source[key];
+        const targetValue = output[key];
+        if (isObject(sourceValue) && isObject(targetValue)) {
+            output[key] = deepMerge(targetValue, sourceValue);
+            continue;
+        }
+        if (sourceValue !== undefined) {
+            output[key] = isObject(sourceValue)
+                ? deepMerge({}, sourceValue)
+                : sourceValue;
         }
     }
     return output;
@@ -31,9 +22,8 @@ export function deepMerge(target, source) {
 /**
  * @ru Быстрая проверка, является ли переданный элемент чистым объектом (исключая массивы и null).
  * @en Fast check verifying if the provided item is a plain object layout (excluding arrays and null).
- * @param item - Evaluated runtime variable value context.
  */
 function isObject(item) {
-    return typeof item === "object" && item !== null && !Array.isArray(item);
+    return Object.prototype.toString.call(item) === "[object Object]";
 }
 //# sourceMappingURL=merge.js.map

package/utils/merge.js.map

@@ -1 +1 @@
-{"version":3,"file":"merge.js","sourceRoot":"","sources":["../../src/utils/merge.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAGvB,MAAS,EAAE,MAAS;IACpB,MAAM,MAAM,GAAG,EAAE,GAAG,MAAM,EAA6B,CAAC;IAExD,IAAI,QAAQ,CAAC,MAAM,CAAC,IAAI,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACzC,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;YACzB,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC;gBACtD,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;gBAChC,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;gBAEhC,IAAI,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;oBAC1B,IAAI,GAAG,IAAI,MAAM,IAAI,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;wBAC3C,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;oBACpD,CAAC;yBAAM,CAAC;wBACN,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;oBAC3C,CAAC;gBACH,CAAC;qBAAM,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;oBACrC,MAAM,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC;gBAC5B,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAe,CAAC;AACzB,CAAC;AAED;;;;GAIG;AACH,SAAS,QAAQ,CAAC,IAAa;IAC7B,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAC3E,CAAC"}
+{"version":3,"file":"merge.js","sourceRoot":"","sources":["../../src/utils/merge.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,SAAS,CACvB,MAAS,EACT,MAAS;IAET,MAAM,MAAM,GAA4B,EAAE,GAAG,MAAM,EAAE,CAAC;IACtD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAChC,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,QAAQ,CAAC,WAAW,CAAC,IAAI,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;YACnD,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CACrB,WAAsC,EACtC,WAAsC,CACvC,CAAC;YACF,SAAS;QACX,CAAC;QAED,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAC9B,MAAM,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,WAAW,CAAC;gBACjC,CAAC,CAAC,SAAS,CAAC,EAAE,EAAE,WAAsC,CAAC;gBACvD,CAAC,CAAC,WAAW,CAAC;QAClB,CAAC;IACH,CAAC;IACD,OAAO,MAAe,CAAC;AACzB,CAAC;AAED;;;GAGG;AACH,SAAS,QAAQ,CAAC,IAAa;IAC7B,OAAO,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,iBAAiB,CAAC;AACpE,CAAC"}

package/utils/normalize.d.ts

@@ -1,33 +1,52 @@
 import type { Method, RequestBodyData } from "@hyperttp/types";
-export type NormalizedBody = string | Uint8Array | ArrayBuffer | FormData | URLSearchParams | ReadableStream | Blob | null | undefined;
+type NormalizedHeaders = Record<string, string | string[]>;
 /**
- * @ru Нормализует метод HTTP: приводит к верхнему регистру, использует кэш для часто встречающихся методов.
- * @en Normalizes an HTTP method: converts to uppercase, uses cache for common methods.
- * @param method - Raw method string (e.g., 'get', 'POST').
- * @returns Normalized uppercase method.
+ * @ru Нормализует HTTP-метод в верхний регистр с кэшированием.
+ * @en Normalizes HTTP method to uppercase with caching.
+ * @param method - The HTTP method string (e.g., 'get', 'POST').
+ * @returns The normalized HTTP method in uppercase.
  */
 export declare function normalizeMethod(method: string): Method;
 /**
- * @ru Извлекает URL из объекта запроса или строки. Поддерживает поля url, _url, или комбинацию scheme/host/path.
- * @en Extracts a URL from a request object or string. Supports url, _url fields, or scheme/host/path combination.
- * @param req - Request object or URL string.
- * @returns Normalized URL string.
- * @throws If URL cannot be resolved.
+ * @ru Извлекает URL из объекта запроса или строки.
+ * Поддерживает различные форматы: строка, объект с полем `url`, `_url`, или `scheme/host/path`.
+ * @en Extracts URL from a request object or string.
+ * Supports various formats: string, object with `url`, `_url`, or `scheme/host/path` fields.
+ * @param req - The request object or URL string.
+ * @returns The extracted URL string.
+ * @throws Error if URL is missing in the request.
  */
-export declare function normalizeUrl(req: any): string;
+export declare function normalizeUrl(req: unknown): string;
 /**
- * @ru Нормализует заголовки из различных форматов (массив, объект) в единый объект с правильной обработкой множественных значений (cookie, set-cookie).
- * @en Normalizes headers from various formats (array, object) into a single object with proper handling of multi-value headers (cookie, set-cookie).
- * @param headers - Raw headers in array or object format.
- * @returns Normalized headers object where values are strings or arrays of strings (for set-cookie).
+ * @ru Нормализует заголовки запроса в единый формат с ключами в нижнем регистре.
+ * Поддерживает различные входные форматы: объект, массив пар, плоский массив.
+ *
+ * Специальные правила:
+ * - `set-cookie` всегда хранится как массив
+ * - `cookie`/`cookie2` объединяются через `; `
+ * - Остальные множественные заголовки объединяются через `, `
+ * - Заголовки из SINGLE_VALUE_HEADERS перезаписываются (не объединяются)
+ *
+ * @en Normalizes request headers into a unified format with lowercase keys.
+ * Supports various input formats: object, array of pairs, flat array.
+ *
+ * Special rules:
+ * - `set-cookie` is always stored as an array
+ * - `cookie`/`cookie2` are joined with `; `
+ * - Other multiple headers are joined with `, `
+ * - Headers from SINGLE_VALUE_HEADERS are overwritten (not merged)
+ *
+ * @param headers - The headers to normalize (object, array of pairs, or flat array).
+ * @returns Normalized headers object with lowercase keys.
  */
-export declare function normalizeHeaders(headers: unknown): Record<string, string | string[]>;
+export declare function normalizeHeaders(headers: unknown): NormalizedHeaders;
 /**
- * @ru Нормализует тело запроса: для методов GET и HEAD тело всегда undefined, для остальных возвращает переданное тело.
- * @en Normalizes request body: for GET and HEAD methods body is always undefined, for others returns the provided body.
- * @param method - HTTP method.
- * @param body - Raw request body.
- * @returns Normalized body or undefined.
+ * @ru Нормализует тело запроса, удаляя его для методов GET и HEAD.
+ * @en Normalizes request body by removing it for GET and HEAD methods.
+ * @param method - The HTTP method.
+ * @param body - The request body data.
+ * @returns The body for methods that support it, or undefined for GET/HEAD.
  */
 export declare function normalizeBody(method: Method, body: RequestBodyData | undefined): RequestBodyData | undefined;
+export {};
 //# sourceMappingURL=normalize.d.ts.map

package/utils/normalize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../src/utils/normalize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAE/D,MAAM,MAAM,cAAc,GACtB,MAAM,GACN,UAAU,GACV,WAAW,GACX,QAAQ,GACR,eAAe,GACf,cAAc,GACd,IAAI,GACJ,IAAI,GACJ,SAAS,CAAC;AA+Cd;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAItD;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAY7C;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,OAAO,GACf,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CA+HnC;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,eAAe,GAAG,SAAS,GAChC,eAAe,GAAG,SAAS,CAK7B"}
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../src/utils/normalize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAE/D,KAAK,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;AAqH3D;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAGtD;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAwBjD;AAmED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,iBAAiB,CAqDpE;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,eAAe,GAAG,SAAS,GAChC,eAAe,GAAG,SAAS,CAE7B"}