@hyperttp/core 1.1.11 → 1.2.0

package/transports/node.js

@@ -1,145 +1,273 @@
-import { pipeline, Readable } from "node:stream";
-import zlib from "node:zlib";
-import { CookieAgent } from "http-cookie-agent/undici";
-import { RequestExecutor } from "../Core/RequestExecutor.js";
+import http from "node:http";
+import https from "node:https";
+import { Readable } from "node:stream";
+const REDIRECT_STATUS_CODES = new Set([301, 302, 303, 307, 308]);
+const DEFAULT_RETRY_STATUS_CODES = [502, 503, 504];
+export function isRedirect(status) {
+    return REDIRECT_STATUS_CODES.has(status);
+}
+export function combineSignal(signal, timeoutMs) {
+    if (timeoutMs <= 0) {
+        return {
+            signal,
+            cancelTimer: () => { },
+            isTimeoutAbort: () => false,
+        };
+    }
+    const timeoutController = new AbortController();
+    const timer = setTimeout(() => timeoutController.abort(), timeoutMs);
+    let combinedSignal;
+    if (signal) {
+        if (typeof AbortSignal.any === "function") {
+            combinedSignal = AbortSignal.any([signal, timeoutController.signal]);
+        }
+        else {
+            const onAbort = () => timeoutController.abort();
+            signal.addEventListener("abort", onAbort, { once: true });
+            combinedSignal = timeoutController.signal;
+        }
+    }
+    else {
+        combinedSignal = timeoutController.signal;
+    }
+    return {
+        signal: combinedSignal,
+        cancelTimer: () => clearTimeout(timer),
+        isTimeoutAbort: () => timeoutController.signal.aborted,
+    };
+}
+export function shouldRetry(status, retryOptions) {
+    const codes = retryOptions.retryStatusCodes;
+    if (codes && codes.length > 0) {
+        return codes.includes(status);
+    }
+    return DEFAULT_RETRY_STATUS_CODES.includes(status);
+}
+export function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+export function calcDelay(attempt, retryOptions) {
+    const { baseDelay = 1000, maxDelay = 10000, jitter = true } = retryOptions;
+    const base = Math.min(baseDelay * 2 ** attempt, maxDelay);
+    return jitter ? base * (0.75 + Math.random() * 0.5) : base;
+}
+/**
+ * @ru Реализация ответа для стандартного Node.js транспорта.
+ */
+class NodeTransportResponse {
+    status;
+    headers;
+    url;
+    body;
+    baseUrl;
+    _rawBody;
+    _cachedText;
+    _cachedJson;
+    _cachedJsonReady = false;
+    constructor(status, headers, url, rawBody) {
+        this.status = status;
+        this.headers = headers;
+        this.url = url;
+        this._rawBody = rawBody;
+        this.baseUrl = url;
+        const stream = Readable.from([rawBody]);
+        Object.defineProperty(stream, "dump", {
+            value: () => Promise.resolve(),
+            writable: false,
+            enumerable: false,
+            configurable: true,
+        });
+        this.body = stream;
+    }
+    async text() {
+        if (this._cachedText === undefined) {
+            this._cachedText = this._rawBody.toString("utf-8");
+        }
+        return this._cachedText;
+    }
+    async json() {
+        if (this._cachedJsonReady) {
+            return this._cachedJson;
+        }
+        const text = await this.text();
+        if (!text.trim()) {
+            this._cachedJson = null;
+            this._cachedJsonReady = true;
+            return null;
+        }
+        this._cachedJson = JSON.parse(text);
+        this._cachedJsonReady = true;
+        return this._cachedJson;
+    }
+}
+/**
+ * @ru Высокопроизводительный транспорт на базе классических модулей http/https Node.js.
+ */
 export class NodeTransport {
-    agent;
-    executor;
+    config;
+    httpAgent;
+    httpsAgent;
     constructor(config) {
-        const concurrency = config.network?.maxConcurrent === 0
-            ? Infinity
-            : (config.network?.maxConcurrent ?? 500);
-        const allowH2 = config.network?.allowHttp2 ?? true;
-        const pipelining = config.network?.pipelining !== undefined
-            ? config.network.pipelining === 0
-                ? 256
-                : config.network.pipelining
-            : allowH2
-                ? 100
-                : 1;
-        this.agent = new CookieAgent({
-            connections: concurrency === Infinity ? null : concurrency,
-            pipelining,
-            keepAliveTimeout: config.network?.keepAliveTimeout ?? 30000,
-            keepAliveMaxTimeout: config.network?.keepAliveTimeout ?? 30000,
-            clientTtl: 60000,
-            connect: { rejectUnauthorized: config.network?.rejectUnauthorized },
-            allowH2,
-        });
-        const retryOptions = {
-            maxRetries: config.retry?.maxRetries ?? 3,
-            ...config.retry,
+        this.config = config;
+        const agentOptions = {
+            keepAlive: true,
+            keepAliveMsecs: config.network?.keepAliveTimeout ?? 30000,
+            maxSockets: config.network?.maxConcurrent ?? 500,
+            maxFreeSockets: Math.min(256, Math.floor((config.network?.maxConcurrent ?? 500) / 2)),
+            scheduling: "lifo",
         };
-        this.executor = new RequestExecutor(this.agent, {
-            timeout: config.network?.timeout ?? 30000,
-            maxRetries: retryOptions.maxRetries ?? 3,
-            followRedirects: config.network?.followRedirects ?? true,
-            maxRedirects: config.network?.maxRedirects ?? 5,
-            retryOptions: retryOptions,
-            verbose: config.verbose ?? false,
-            logger: config.logger,
-        });
+        this.httpAgent = new http.Agent(agentOptions);
+        this.httpsAgent = new https.Agent(agentOptions);
+    }
+    get timeout() {
+        return this.config.network?.timeout ?? 30000;
     }
     async execute(req) {
-        const rawResponse = await this.executor.execute(req.method, req.url, req.headers, req.body, req.signal);
-        const normalizedHeaders = {};
-        const rawHeaders = rawResponse.headers;
-        const keys = Object.keys(rawHeaders);
-        let contentEncoding = undefined;
-        for (let i = 0; i < keys.length; i++) {
-            const key = keys[i];
-            const value = rawHeaders[key];
-            if (value === undefined)
-                continue;
-            const lowerKey = key.toLowerCase();
-            if (lowerKey === "content-encoding") {
-                contentEncoding = Array.isArray(value) ? value[0] : value;
+        let currentUrl = req.url;
+        let currentMethod = req.method;
+        let currentHeaders = { ...req.headers };
+        let currentBody = req.body;
+        let redirects = 0;
+        let attempt = 0;
+        const maxRedirects = this.config.network?.maxRedirects ?? 5;
+        const maxRetries = this.config.retry?.maxRetries ?? 3;
+        const isStreamBody = currentBody instanceof Readable;
+        while (true) {
+            const { signal, cancelTimer, isTimeoutAbort } = combineSignal(req.signal, this.timeout);
+            try {
+                const fullUrl = new URL(currentUrl);
+                const result = await this.dispatchOnce(fullUrl, {
+                    method: currentMethod,
+                    headers: currentHeaders,
+                    body: currentBody,
+                    signal,
+                });
+                if ((this.config.network?.followRedirects ?? true) &&
+                    isRedirect(result.status)) {
+                    if (redirects >= maxRedirects) {
+                        throw new Error("Too many redirects");
+                    }
+                    const location = result.headers["location"];
+                    if (location && typeof location === "string") {
+                        const nextUrl = new URL(location, fullUrl.toString()).toString();
+                        let nextMethod = currentMethod;
+                        if (result.status === 303 ||
+                            ((result.status === 301 || result.status === 302) &&
+                                currentMethod === "POST")) {
+                            nextMethod = "GET";
+                        }
+                        currentUrl = nextUrl;
+                        currentMethod = nextMethod;
+                        currentBody =
+                            nextMethod === "GET" || isStreamBody ? undefined : currentBody;
+                        const nextHeaders = { ...currentHeaders };
+                        if (nextMethod === "GET") {
+                            delete nextHeaders["content-type"];
+                            delete nextHeaders["content-length"];
+                        }
+                        currentHeaders = nextHeaders;
+                        redirects += 1;
+                        continue;
+                    }
+                }
+                if (!isStreamBody &&
+                    shouldRetry(result.status, this.config.retry ?? {})) {
+                    if (attempt < maxRetries) {
+                        await sleep(calcDelay(attempt, this.config.retry ?? {}));
+                        attempt += 1;
+                        continue;
+                    }
+                }
+                return new NodeTransportResponse(result.status, result.headers, fullUrl.toString(), result.body);
             }
-            if (Array.isArray(value)) {
-                normalizedHeaders[key] =
-                    lowerKey === "set-cookie" ? value.join("\n") : value.join(", ");
+            catch (err) {
+                if (err.name === "AbortError" || isTimeoutAbort()) {
+                    if (req.signal?.aborted)
+                        throw err;
+                    if (isTimeoutAbort()) {
+                        throw new Error(`Request timeout after ${this.timeout}ms`, {
+                            cause: err,
+                        });
+                    }
+                    throw new Error("Transport closed or aborted", { cause: err });
+                }
+                const retryableCodes = [
+                    "ECONNREFUSED",
+                    "ETIMEDOUT",
+                    "ECONNRESET",
+                    "EPIPE",
+                ];
+                if (!isStreamBody &&
+                    attempt < maxRetries &&
+                    retryableCodes.includes(err.code)) {
+                    await sleep(calcDelay(attempt, this.config.retry ?? {}));
+                    attempt += 1;
+                    continue;
+                }
+                throw err;
             }
-            else {
-                normalizedHeaders[key] = value;
+            finally {
+                cancelTimer();
             }
         }
-        const decompressedBody = this.wrapDecompress(rawResponse.body, contentEncoding);
-        if (decompressedBody instanceof Readable) {
-            Object.defineProperty(decompressedBody, "dump", {
-                value: function () {
-                    return new Promise((resolve, reject) => {
-                        if (this.destroyed || this.readableEnded || this.closed) {
-                            return resolve();
-                        }
-                        if (typeof this.resume === "function") {
-                            this.on("data", () => { });
-                            this.on("end", resolve);
-                            this.on("error", reject);
-                            this.resume();
-                        }
-                        else {
-                            resolve();
-                        }
+    }
+    dispatchOnce(url, options) {
+        return new Promise((resolve, reject) => {
+            const isHttps = url.protocol === "https:";
+            const requestFn = isHttps ? https.request : http.request;
+            const agent = isHttps ? this.httpsAgent : this.httpAgent;
+            const reqOptions = {
+                method: options.method,
+                headers: options.headers,
+                agent,
+                signal: options.signal,
+            };
+            if (options.signal?.aborted) {
+                const abortError = new Error("The operation was aborted.");
+                abortError.name = "AbortError";
+                return reject(abortError);
+            }
+            const req = requestFn(url, reqOptions, (res) => {
+                const chunks = [];
+                res.on("data", (chunk) => {
+                    chunks.push(chunk);
+                });
+                res.on("end", () => {
+                    const body = chunks.length === 0 ? Buffer.alloc(0) : Buffer.concat(chunks);
+                    resolve({
+                        status: res.statusCode ?? 200,
+                        headers: res.headers,
+                        body,
                     });
-                },
-                writable: true,
-                configurable: true,
-                enumerable: false,
+                });
+                res.on("error", (err) => {
+                    reject(err);
+                });
             });
-        }
-        return {
-            status: rawResponse.status,
-            headers: normalizedHeaders,
-            body: decompressedBody,
-            url: rawResponse.url,
-        };
-    }
-    wrapDecompress(body, contentEncoding) {
-        if (!(body instanceof Readable))
-            return body;
-        const encoding = contentEncoding?.toLowerCase().trim();
-        if (!encoding || encoding === "none" || encoding === "identity") {
-            return body;
-        }
-        let decompressor = null;
-        if (encoding === "gzip") {
-            decompressor = zlib.createGunzip({ flush: zlib.constants.Z_SYNC_FLUSH });
-        }
-        else if (encoding === "deflate") {
-            decompressor = zlib.createInflate();
-        }
-        else if (encoding === "br") {
-            decompressor = zlib.createBrotliDecompress();
-        }
-        if (!decompressor) {
-            return body;
-        }
-        const decompressedStream = pipeline(body, decompressor, (err) => {
-            if (err) {
-                decompressedStream.emit("error", err);
-                if (this.executor.verbose) {
-                    console.error?.(`[Hyperttp] Decompression failed: ${err.message}`);
+            req.on("error", (err) => {
+                reject(err);
+            });
+            if (options.body !== undefined && options.body !== null) {
+                if (Buffer.isBuffer(options.body) || typeof options.body === "string") {
+                    req.write(options.body);
+                }
+                else if (options.body instanceof Readable) {
+                    options.body.pipe(req);
+                    return; // Управление потоком передано pipe
+                }
+                else {
+                    req.write(JSON.stringify(options.body));
                 }
             }
+            req.end();
         });
-        return decompressedStream;
+    }
+    async close() {
+        this.httpAgent.destroy();
+        this.httpsAgent.destroy();
     }
     async destroy() {
-        await new Promise((resolve) => setImmediate(resolve));
-        try {
-            const structuralAgent = this.agent;
-            if (typeof structuralAgent.close === "function") {
-                await structuralAgent.close();
-            }
-            else if (typeof structuralAgent.destroy === "function") {
-                await structuralAgent.destroy();
-            }
-        }
-        catch (err) {
-            if (this.executor.verbose) {
-                console.warn("Transport destroy error (likely race condition):", err);
-            }
-        }
+        await this.close();
     }
 }
 //# sourceMappingURL=node.js.map

package/transports/node.js.map

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

package/utils/errors.d.ts

@@ -0,0 +1,49 @@
+/**
+ * @ru Базовый класс ошибок клиента Hyperttp, агрегирующий контекст неудачного сетевого запроса.
+ * @en Base error class for the Hyperttp client, providing explicit layout context for failed requests.
+ */
+export declare class HttpClientError extends Error {
+    code: string;
+    statusCode?: number | undefined;
+    originalError?: Error | undefined;
+    url?: string | undefined;
+    method?: string | undefined;
+    /**
+     * @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);
+}
+/**
+ * @ru Ошибка, возникающая при превышении лимита времени ожидания ответа от сервера.
+ * @en Error thrown when a network request exceeds its allocated execution timeout threshold.
+ */
+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);
+}
+/**
+ * @ru Ошибка, генерируемая при получении HTTP-статуса 429 (превышение лимита частоты запросов).
+ * @en Error triggered when encountering an HTTP 429 status code indicating rate limit exhaustion.
+ */
+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);
+}
+//# sourceMappingURL=errors.d.ts.map

package/utils/errors.d.ts.map

@@ -0,0 +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"}

package/utils/errors.js

@@ -0,0 +1,63 @@
+/**
+ * @ru Базовый класс ошибок клиента Hyperttp, агрегирующий контекст неудачного сетевого запроса.
+ * @en Base error class for the Hyperttp client, providing explicit layout context for failed requests.
+ */
+export class HttpClientError extends Error {
+    code;
+    statusCode;
+    originalError;
+    url;
+    method;
+    /**
+     * @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);
+        this.code = code;
+        this.statusCode = statusCode;
+        this.originalError = originalError;
+        this.url = url;
+        this.method = method;
+        this.name = "HttpClientError";
+    }
+}
+/**
+ * @ru Ошибка, возникающая при превышении лимита времени ожидания ответа от сервера.
+ * @en Error thrown when a network request exceeds its allocated execution timeout threshold.
+ */
+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);
+        this.name = "TimeoutError";
+    }
+}
+/**
+ * @ru Ошибка, генерируемая при получении HTTP-статуса 429 (превышение лимита частоты запросов).
+ * @en Error triggered when encountering an HTTP 429 status code indicating rate limit exhaustion.
+ */
+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);
+        this.name = "RateLimitError";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/utils/errors.js.map

@@ -0,0 +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"}

package/utils/merge.d.ts

@@ -1,2 +1,9 @@
-export declare function deepMerge<T extends Record<string, any>, S extends Record<string, any>>(target: T, source: S): T & S;
+/**
+ * @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,wBAAgB,SAAS,CACvB,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC7B,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC7B,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAqB7B"}
+{"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"}