@hyperttp/core 1.3.0 → 1.3.3

package/utils/decompress.d.ts

@@ -1,7 +1,27 @@
 import type { TransportStreamExtensions } from "@hyperttp/types";
 type StreamPayload = ReadableStream<Uint8Array> & TransportStreamExtensions;
 type BufferPayload = Uint8Array & TransportStreamExtensions;
+/**
+ * @ru Полностью декомпрессирует буфер, последовательно применяя цепочку алгоритмов из Content-Encoding.
+ * @en Fully decompresses a buffer by sequentially applying the Content-Encoding chain.
+ * @param body - Compressed Uint8Array body.
+ * @param encoding - Raw Content-Encoding header (may contain multiple comma-separated values).
+ * @returns Decompressed buffer with a noop dump method.
+ */
 export declare function decompressBuffer(body: Uint8Array, encoding: string): BufferPayload;
+/**
+ * @ru Создаёт декомпрессирующий поток, минимизируя конвертацию между Web и Node.js стримами.
+ * @en Creates a decompressing stream while minimising conversion between Web and Node.js streams.
+ *
+ * @ru Алгоритм: для gzip/deflate при наличии глобального DecompressionStream использует Web Streams API,
+ * иначе переключается на Node.js zlib. Brotli всегда идёт через Node.js (до появления стандартного Web-потока).
+ * @en Algorithm: for gzip/deflate, if global DecompressionStream is available, uses Web Streams API;
+ * otherwise falls back to Node.js zlib. Brotli always goes through Node.js (until standard Web stream is available).
+ *
+ * @param body - Original compressed ReadableStream.
+ * @param encoding - Raw Content-Encoding header (may be a chain).
+ * @returns Decompressed ReadableStream with a dump method that cancels the stream.
+ */
 export declare function createDecompressStream(body: ReadableStream<Uint8Array>, encoding: string): StreamPayload;
 export {};
 //# sourceMappingURL=decompress.d.ts.map

package/utils/decompress.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"decompress.d.ts","sourceRoot":"","sources":["../../src/utils/decompress.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAEjE,KAAK,aAAa,GAAG,cAAc,CAAC,UAAU,CAAC,GAAG,yBAAyB,CAAC;AAC5E,KAAK,aAAa,GAAG,UAAU,GAAG,yBAAyB,CAAC;AA8C5D,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,UAAU,EAChB,QAAQ,EAAE,MAAM,GACf,aAAa,CAQf;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,EAChC,QAAQ,EAAE,MAAM,GACf,aAAa,CA0Df"}
+{"version":3,"file":"decompress.d.ts","sourceRoot":"","sources":["../../src/utils/decompress.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAEjE,KAAK,aAAa,GAAG,cAAc,CAAC,UAAU,CAAC,GAAG,yBAAyB,CAAC;AAC5E,KAAK,aAAa,GAAG,UAAU,GAAG,yBAAyB,CAAC;AAqE5D;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,UAAU,EAChB,QAAQ,EAAE,MAAM,GACf,aAAa,CASf;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,EAChC,QAAQ,EAAE,MAAM,GACf,aAAa,CA+Cf"}

package/utils/decompress.js

@@ -1,16 +1,34 @@
 import { brotliDecompressSync, createBrotliDecompress, createGunzip, createInflate, gunzipSync, inflateSync, } from "node:zlib";
 import { Readable } from "node:stream";
+/**
+ * @ru Разбирает заголовок Content-Encoding в массив алгоритмов, исключая "identity".
+ * @en Parses Content-Encoding header into an array of algorithms, excluding "identity".
+ * @param encoding - Raw Content-Encoding header value (e.g., "gzip, deflate").
+ * @returns Array of normalized encoding names.
+ */
 function parseEncodings(encoding) {
     return encoding
         .split(",")
         .map((part) => part.trim().toLowerCase())
         .filter((part) => part.length > 0 && part !== "identity");
 }
+/**
+ * @ru Добавляет noop-метод dump к буферу, сохраняя совместимость с TransportStreamExtensions.
+ * @en Attaches a noop dump method to a buffer, maintaining TransportStreamExtensions compatibility.
+ * @param buffer - The Uint8Array buffer.
+ * @returns Buffer with dump method attached.
+ */
 function attachNoopDump(buffer) {
     const payload = buffer;
     payload.dump = async () => { };
     return payload;
 }
+/**
+ * @ru Добавляет метод dump к стриму, который отменяет (cancel) поток.
+ * @en Attaches a dump method to a stream that cancels the stream.
+ * @param stream - ReadableStream to enhance.
+ * @returns Stream with dump method attached.
+ */
 function attachStreamDump(stream) {
     const payload = stream;
     payload.dump = async () => {
@@ -23,8 +41,16 @@ function attachStreamDump(stream) {
     };
     return payload;
 }
+/**
+ * @ru Применяет один этап декомпрессии к буферу синхронно (для одиночных чанков).
+ * @en Applies a single decompression step to a buffer synchronously (for single chunks).
+ * @param input - Compressed buffer.
+ * @param encoding - Single encoding name ("gzip", "deflate", "br").
+ * @returns Decompressed buffer, or original if encoding is unknown.
+ * @throws If decompression fails due to corrupt data.
+ */
 function decompressOnce(input, encoding) {
-    const buffer = Buffer.from(input);
+    const buffer = Buffer.from(input.buffer, input.byteOffset, input.byteLength);
     switch (encoding) {
         case "gzip":
         case "x-gzip":
@@ -37,42 +63,66 @@ function decompressOnce(input, encoding) {
             return input;
     }
 }
+/**
+ * @ru Полностью декомпрессирует буфер, последовательно применяя цепочку алгоритмов из Content-Encoding.
+ * @en Fully decompresses a buffer by sequentially applying the Content-Encoding chain.
+ * @param body - Compressed Uint8Array body.
+ * @param encoding - Raw Content-Encoding header (may contain multiple comma-separated values).
+ * @returns Decompressed buffer with a noop dump method.
+ */
 export 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++) {
+        current = decompressOnce(current, encodings[i]);
     }
     return attachNoopDump(current);
 }
+/**
+ * @ru Создаёт декомпрессирующий поток, минимизируя конвертацию между Web и Node.js стримами.
+ * @en Creates a decompressing stream while minimising conversion between Web and Node.js streams.
+ *
+ * @ru Алгоритм: для gzip/deflate при наличии глобального DecompressionStream использует Web Streams API,
+ * иначе переключается на Node.js zlib. Brotli всегда идёт через Node.js (до появления стандартного Web-потока).
+ * @en Algorithm: for gzip/deflate, if global DecompressionStream is available, uses Web Streams API;
+ * otherwise falls back to Node.js zlib. Brotli always goes through Node.js (until standard Web stream is available).
+ *
+ * @param body - Original compressed ReadableStream.
+ * @param encoding - Raw Content-Encoding header (may be a chain).
+ * @returns Decompressed ReadableStream with a dump method that cancels the stream.
+ */
 export 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;
+    let nodeReadableStream = null;
+    for (let i = 0; i < encodings.length; i++) {
+        const enc = encodings[i];
+        const isGzip = enc === "gzip" || enc === "x-gzip";
+        const isDeflate = enc === "deflate";
+        if ((isGzip || isDeflate) && typeof DecompressionStream !== "undefined") {
+            if (nodeReadableStream) {
+                current = Readable.toWeb(nodeReadableStream);
+                nodeReadableStream = null;
             }
-            const nodeReadable = Readable.fromWeb(current);
-            const decompressed = nodeReadable.pipe(createGunzip());
-            current = Readable.toWeb(decompressed);
-            continue;
+            current = current.pipeThrough(new DecompressionStream(isGzip ? "gzip" : "deflate"));
         }
-        if (enc === "deflate") {
-            if (typeof DecompressionStream !== "undefined") {
-                current = current.pipeThrough(new DecompressionStream("deflate"));
-                continue;
+        else {
+            if (!nodeReadableStream) {
+                nodeReadableStream = Readable.fromWeb(current);
             }
-            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);
+            if (isGzip)
+                nodeReadableStream = nodeReadableStream.pipe(createGunzip());
+            else if (isDeflate)
+                nodeReadableStream = nodeReadableStream.pipe(createInflate());
+            else if (enc === "br")
+                nodeReadableStream = nodeReadableStream.pipe(createBrotliDecompress());
         }
     }
+    if (nodeReadableStream) {
+        current = Readable.toWeb(nodeReadableStream);
+    }
     return attachStreamDump(current);
 }
 //# sourceMappingURL=decompress.js.map

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":"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"}

package/utils/merge.js

@@ -7,23 +7,17 @@
  */
 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;
@@ -34,6 +28,6 @@ export function deepMerge(target, source) {
  * @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;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAGvB,MAAS,EAAE,MAAS;IACpB,MAAM,MAAM,GAA4B,EAAE,GAAG,MAAM,EAAE,CAAC;IAEtD,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;QAEhC,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;IAED,OAAO,MAAe,CAAC;AACzB,CAAC;AAED;;;;GAIG;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,7 +1,32 @@
 import type { Method, RequestBodyData } from "@hyperttp/types";
-export type NormalizedBody = string | Uint8Array | ArrayBuffer | FormData | URLSearchParams | ReadableStream | Blob | null | undefined;
+/**
+ * @ru Нормализует строку HTTP-метода в стандартную заглавную форму (например, "get" → "GET").
+ * @en Normalizes an HTTP method string to its standard uppercase form (e.g., "get" → "GET").
+ * @param method - Raw method string.
+ * @returns Normalized method (e.g., "GET", "POST", etc.).
+ */
 export declare function normalizeMethod(method: string): Method;
+/**
+ * @ru Извлекает и нормализует URL из строки или объекта запроса (поддерживает поля url, _url, или комбинацию scheme/host/path).
+ * @en Extracts and normalizes a URL from a string or request object (supports url, _url fields, or scheme/host/path combination).
+ * @param req - Request object or plain URL string.
+ * @returns Normalized URL string.
+ * @throws If URL cannot be determined.
+ */
 export declare function normalizeUrl(req: any): string;
+/**
+ * @ru Нормализует входные заголовки (объект, массив пар) в стандартный объект с ключами в нижнем регистре и правильным объединением значений.
+ * @en Normalizes input headers (object, array of pairs) into a standard object with lower‑case keys and proper value merging.
+ * @param headers - Raw headers (plain object, array of [key, value] pairs, or null/undefined).
+ * @returns Normalized headers object (keys are lower‑case, values are strings or arrays for set-cookie).
+ */
 export declare function normalizeHeaders(headers: unknown): Record<string, string | string[]>;
+/**
+ * @ru Возвращает тело запроса только для методов, поддерживающих тело (не GET/HEAD), иначе undefined.
+ * @en Returns the request body only for methods that support a body (not GET/HEAD), otherwise undefined.
+ * @param method - HTTP method.
+ * @param body - Original request body (if any).
+ * @returns The body for allowed methods, or undefined for GET/HEAD.
+ */
 export declare function normalizeBody(method: Method, body: RequestBodyData | undefined): RequestBodyData | undefined;
 //# 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;AAuCd,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAItD;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAY7C;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,OAAO,GACf,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CA+HnC;AAED,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;AAuC/D;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAGtD;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAU7C;AA0CD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,OAAO,GACf,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CA+CnC;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,eAAe,GAAG,SAAS,GAChC,eAAe,GAAG,SAAS,CAE7B"}

package/utils/normalize.js

@@ -33,12 +33,23 @@ const METHOD_CACHE = {
     options: "OPTIONS",
     OPTIONS: "OPTIONS",
 };
+/**
+ * @ru Нормализует строку HTTP-метода в стандартную заглавную форму (например, "get" → "GET").
+ * @en Normalizes an HTTP method string to its standard uppercase form (e.g., "get" → "GET").
+ * @param method - Raw method string.
+ * @returns Normalized method (e.g., "GET", "POST", etc.).
+ */
 export function normalizeMethod(method) {
     const cached = METHOD_CACHE[method];
-    if (cached !== undefined)
-        return cached;
-    return method.toUpperCase();
+    return cached !== undefined ? cached : method.toUpperCase();
 }
+/**
+ * @ru Извлекает и нормализует URL из строки или объекта запроса (поддерживает поля url, _url, или комбинацию scheme/host/path).
+ * @en Extracts and normalizes a URL from a string or request object (supports url, _url fields, or scheme/host/path combination).
+ * @param req - Request object or plain URL string.
+ * @returns Normalized URL string.
+ * @throws If URL cannot be determined.
+ */
 export function normalizeUrl(req) {
     if (typeof req === "string")
         return req;
@@ -51,45 +62,58 @@ export function normalizeUrl(req) {
     }
     throw new Error("URL missing in request");
 }
+/**
+ * @ru Вспомогательная функция для добавления заголовка в результирующий объект с учётом правил объединения (одиночные, множественные, cookie, set-cookie).
+ * @en Helper function to append a header to the result object, respecting merging rules (single-value, multi-value, cookie, set-cookie).
+ * @param out - Target object accumulating headers.
+ * @param lowerKey - Header name in lower case.
+ * @param value - Header value as a string.
+ */
+function appendHeader(out, lowerKey, value) {
+    if (SINGLE_VALUE_HEADERS[lowerKey] !== undefined) {
+        out[lowerKey] = value;
+        return;
+    }
+    const existing = out[lowerKey];
+    if (existing === undefined) {
+        out[lowerKey] = value;
+        return;
+    }
+    if (lowerKey === "set-cookie") {
+        if (Array.isArray(existing)) {
+            existing.push(value);
+        }
+        else {
+            out[lowerKey] = [existing, value];
+        }
+        return;
+    }
+    if (lowerKey === "cookie" || lowerKey === "cookie2") {
+        out[lowerKey] = `${existing}; ${value}`;
+        return;
+    }
+    out[lowerKey] = `${existing}, ${value}`;
+}
+/**
+ * @ru Нормализует входные заголовки (объект, массив пар) в стандартный объект с ключами в нижнем регистре и правильным объединением значений.
+ * @en Normalizes input headers (object, array of pairs) into a standard object with lower‑case keys and proper value merging.
+ * @param headers - Raw headers (plain object, array of [key, value] pairs, or null/undefined).
+ * @returns Normalized headers object (keys are lower‑case, values are strings or arrays for set-cookie).
+ */
 export function normalizeHeaders(headers) {
     const out = Object.create(null);
     if (!headers || typeof headers !== "object")
         return out;
     if (Array.isArray(headers)) {
-        for (let i = 0; i < headers.length; i += 2) {
+        const len = headers.length;
+        for (let i = 0; i < len; i += 2) {
             const key = headers[i];
             if (typeof key !== "string" || !key)
                 continue;
             const rawValue = headers[i + 1];
             if (rawValue === undefined || rawValue === null)
                 continue;
-            const lower = key.toLowerCase();
-            const value = typeof rawValue === "string" ? rawValue : String(rawValue);
-            if (SINGLE_VALUE_HEADERS[lower] !== undefined) {
-                out[lower] = value;
-                continue;
-            }
-            const existing = out[lower];
-            if (existing === undefined) {
-                out[lower] = value;
-                continue;
-            }
-            if (lower === "set-cookie") {
-                if (Array.isArray(existing)) {
-                    existing.push(value);
-                }
-                else {
-                    out[lower] = [existing, value];
-                }
-                continue;
-            }
-            if (lower === "cookie" || lower === "cookie2") {
-                out[lower] = `${existing}; ${value}`;
-                continue;
-            }
-            out[lower] = Array.isArray(existing)
-                ? `${existing.join(", ")}, ${value}`
-                : `${existing}, ${value}`;
+            appendHeader(out, key.toLowerCase(), typeof rawValue === "string" ? rawValue : String(rawValue));
         }
         return out;
     }
@@ -101,74 +125,29 @@ export function normalizeHeaders(headers) {
                 continue;
             const lower = key.toLowerCase();
             if (Array.isArray(val)) {
-                for (let i = 0; i < val.length; i++) {
+                const vLen = val.length;
+                for (let i = 0; i < vLen; i++) {
                     const rawValue = val[i];
-                    if (rawValue === undefined || rawValue === null)
-                        continue;
-                    const value = typeof rawValue === "string" ? rawValue : String(rawValue);
-                    if (SINGLE_VALUE_HEADERS[lower] !== undefined) {
-                        out[lower] = value;
-                        continue;
-                    }
-                    const existing = out[lower];
-                    if (existing === undefined) {
-                        out[lower] = value;
-                        continue;
-                    }
-                    if (lower === "set-cookie") {
-                        if (Array.isArray(existing)) {
-                            existing.push(value);
-                        }
-                        else {
-                            out[lower] = [existing, value];
-                        }
-                        continue;
-                    }
-                    if (lower === "cookie" || lower === "cookie2") {
-                        out[lower] = `${existing}; ${value}`;
-                        continue;
+                    if (rawValue !== undefined && rawValue !== null) {
+                        appendHeader(out, lower, typeof rawValue === "string" ? rawValue : String(rawValue));
                     }
-                    out[lower] = Array.isArray(existing)
-                        ? `${existing.join(", ")}, ${value}`
-                        : `${existing}, ${value}`;
                 }
             }
             else {
-                const value = typeof val === "string" ? val : String(val);
-                if (SINGLE_VALUE_HEADERS[lower] !== undefined) {
-                    out[lower] = value;
-                    continue;
-                }
-                const existing = out[lower];
-                if (existing === undefined) {
-                    out[lower] = value;
-                    continue;
-                }
-                if (lower === "set-cookie") {
-                    if (Array.isArray(existing)) {
-                        existing.push(value);
-                    }
-                    else {
-                        out[lower] = [existing, value];
-                    }
-                    continue;
-                }
-                if (lower === "cookie" || lower === "cookie2") {
-                    out[lower] = `${existing}; ${value}`;
-                    continue;
-                }
-                out[lower] = Array.isArray(existing)
-                    ? `${existing.join(", ")}, ${value}`
-                    : `${existing}, ${value}`;
+                appendHeader(out, lower, typeof val === "string" ? val : String(val));
             }
         }
     }
     return out;
 }
+/**
+ * @ru Возвращает тело запроса только для методов, поддерживающих тело (не GET/HEAD), иначе undefined.
+ * @en Returns the request body only for methods that support a body (not GET/HEAD), otherwise undefined.
+ * @param method - HTTP method.
+ * @param body - Original request body (if any).
+ * @returns The body for allowed methods, or undefined for GET/HEAD.
+ */
 export function normalizeBody(method, body) {
-    if (method === "GET" || method === "HEAD") {
-        return undefined;
-    }
-    return body ?? undefined;
+    return method === "GET" || method === "HEAD" ? undefined : body;
 }
 //# sourceMappingURL=normalize.js.map

package/utils/normalize.js.map

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

package/utils/pipeline.d.ts

@@ -4,48 +4,80 @@ import type { HyperPlugin, PluginContext, InternalRequest, HttpResponse, Hypertt
  * @en Hook record structure with metadata for optimization and sorting.
  */
 export interface HookRecord<T> {
+    /** @ru Уникальное имя хука. @en Unique hook name. */
     readonly name: string;
+    /** @ru Приоритет выполнения (выше значение — раньше выполнение). @en Execution priority (higher value runs earlier). */
     readonly priority: number;
+    /** @ru Функция-обработчик. @en Handler function. */
     readonly run: T;
 }
+/**
+ * @ru Контейнер конвейеров для различных фаз обработки запроса/ответа.
+ * @en Pipeline container for different request/response processing phases.
+ */
 export interface PipelineContainer {
+    /** @ru Хуки, выполняемые перед отправкой запроса. @en Hooks executed before sending the request. */
     readonly request: HookRecord<Required<HyperPlugin>["onRequest"]>[];
+    /** @ru Хуки, обрабатывающие сырые данные транспорта. @en Hooks processing raw transport data. */
     readonly responseData: HookRecord<Required<HyperPlugin>["onResponseData"]>[];
+    /** @ru Хуки, мутирующие ответ (последовательное выполнение). @en Hooks that mutate the response (sequential execution). */
     readonly responseMutators: HookRecord<Required<HyperPlugin>["onResponse"]>[];
+    /** @ru Хуки с побочными эффектами (выполняются в фоне). @en Side-effect hooks (executed in the background). */
     readonly responseSideEffects: HookRecord<Required<HyperPlugin>["onResponse"]>[];
+    /** @ru Хуки для перехвата ошибок. @en Error interception hooks. */
     readonly error: HookRecord<Required<HyperPlugin>["onError"]>[];
 }
 /**
- * @ru Создает пустой контейнер для конвейеров плагинов.
+ * @ru Создаёт пустой контейнер для конвейеров плагинов.
  * @en Creates an empty container for plugin pipelines.
+ * @returns An empty pipeline container.
  */
 export declare function createPipelines(): PipelineContainer;
 /**
  * @ru Вставляет хук в массив с сохранением сортировки по убыванию приоритета (деревья поиска тут избыточны).
  * @en Inserts a hook into the array maintaining descending priority order.
+ * @param list - Target array to insert into.
+ * @param hook - Hook record to insert.
  */
 export declare function insertHookSorted<T>(list: HookRecord<T>[], hook: HookRecord<T>): void;
 /**
- * @ru Выполняет конвейер пред-запроса. Поддерживает short-circuit (ранний возврат ответа).
- * Использует Fast-Path для синхронных хуков без аллокации микротасок.
+ * @ru Выполняет конвейер пред-запроса. Поддерживает short-circuit (ранний возврат ответа). Использует Fast-Path для синхронных хуков без аллокации микротасок.
  * @en Executes the pre-request pipeline. Supports short-circuiting with fast-path for sync hooks.
+ * @param hooks - Array of request hooks.
+ * @param req - Internal request object.
+ * @param ctx - Plugin context.
+ * @returns A response if short-circuited, null otherwise, or a promise.
  */
 export declare function executeRequestPipeline(hooks: readonly HookRecord<Required<HyperPlugin>["onRequest"]>[], req: InternalRequest, ctx: PluginContext): Promise<HttpResponse<unknown> | null> | HttpResponse<unknown> | null | void;
 /**
- * @ru Выполняет низкоуровневый конвейер трансформации сырых данных транспорта (фаза DATA).
- * Если хук возвращает измененный TransportResponse, он передается дальше по цепочке.
- * @en Executes low-level transport data transformation pipeline (DATA phase).
+ * @ru Выполняет низкоуровневый конвейер трансформации сырых данных транспорта (фаза DATA). Если хук возвращает измененный TransportResponse, он передается дальше по цепочке.
+ * @en Executes low-level transport data transformation pipeline (DATA phase). If a hook returns a modified TransportResponse, it is passed along the chain.
+ * @param hooks - Array of response data hooks.
+ * @param res - Current transport response.
+ * @param ctx - Plugin context.
+ * @returns The (possibly transformed) transport response, either directly or wrapped in a promise.
  */
 export declare function executeResponseDataPipeline(hooks: readonly HookRecord<Required<HyperPlugin>["onResponseData"]>[], res: TransportResponse, ctx: PluginContext): Promise<TransportResponse> | TransportResponse;
 /**
- * @ru Выполняет конвейер пост-ответа. Разделен на мутаторы (последовательно) и сайд-эффекты (в фоне).
- * Оптимизирован для минимизации выделения памяти под замыкания логгера.
- * @en Executes the post-response pipeline. Split into mutators (sequential) and side-effects (background).
+ * @ru Выполняет конвейер пост-ответа. Разделен на мутаторы (последовательно) и сайд-эффекты (в фоне). Оптимизирован для минимизации выделения памяти под замыкания логгера.
+ * @en Executes the post-response pipeline. Split into mutators (sequential) and side-effects (background). Optimized to minimize memory allocations for logger closures.
+ * @param mutators - Hooks that mutate the response (executed sequentially).
+ * @param sideEffects - Hooks that run in background, errors are logged but do not break the main flow.
+ * @param res - HTTP response object.
+ * @param req - Internal request object.
+ * @param ctx - Plugin context.
+ * @param logger - Optional logger for side-effect errors.
+ * @returns A promise if any mutator returns a promise, otherwise void.
  */
 export declare function executeResponsePipeline(mutators: readonly HookRecord<Required<HyperPlugin>["onResponse"]>[], sideEffects: readonly HookRecord<Required<HyperPlugin>["onResponse"]>[], res: HttpResponse<unknown>, req: InternalRequest, ctx: PluginContext, logger?: HttpClientOptions["logger"]): Promise<void> | void;
 /**
  * @ru Выполняет конвейер перехвата ошибок. Первый вернувший HttpResponse плагин прерывает панику.
- * @en Executes the error interception pipeline. First plugin to return HttpResponse stops the panic.
+ * @en Executes the error interception pipeline. The first plugin that returns HttpResponse stops the panic.
+ * @param hooks - Array of error hooks.
+ * @param error - The error that occurred.
+ * @param req - Internal request object.
+ * @param ctx - Plugin context.
+ * @returns A response if recovered, null otherwise, or a promise.
  */
 export declare function executeErrorPipeline(hooks: readonly HookRecord<Required<HyperPlugin>["onError"]>[], error: HyperttpError, req: InternalRequest, ctx: PluginContext): Promise<HttpResponse<unknown> | null> | HttpResponse<unknown> | null | void;
 //# sourceMappingURL=pipeline.d.ts.map