@hyperttp/core 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 IT IF OR
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,210 @@
+# @hyperttp/core 🚀
+
+> English | Русский
+
+---
+
+## 🌐 Language / Язык
+
+- 🇺🇸 [English](https://github.com/IT-IF-OR/hyperttp-core)
+- 🇷🇺 [Русский](https://github.com/IT-IF-OR/hyperttp-core/tree/main/lang/ru)
+
+---
+
+High-performance HTTP core for Node.js and Bun built on top of `undici`.
+
+`@hyperttp/core` is designed for:
+
+- stable p90/p99 latency,
+- predictable behavior under load,
+- tail-latency reduction,
+- high throughput performance,
+- low overhead transport-layer abstraction.
+
+---
+
+## Features
+
+- ⚡ High performance HTTP execution layer
+- 📉 Stable p90/p99 latency under load
+- 🔄 Keep-Alive & connection pooling
+- 🌊 Stream response support
+- 🍪 CookieAgent integration
+- 📈 Request metrics tracking
+- 🔧 Flexible network-layer configuration
+- ♻️ Retry & redirect handling
+- 🧩 Simple API over `undici`
+
+---
+
+## Performance
+
+`@hyperttp/core` provides:
+
+- minimal p99 latency among most HTTP clients,
+- throughput close to `undici`,
+- significantly more stable latency under load.
+
+---
+
+## Benchmark
+
+### Test configuration
+
+```txt
+Requests      20000
+Concurrency   200
+Warmup        500
+Timeout       60000 ms
+Runtime       Node.js
+```
+
+Benchmark executed via:
+
+```bash
+npx tsx ./bench.ts
+```
+
+---
+
+## [Benchmark results](https://github.com/IT-IF-OR/bench)
+
+| Client         |   RPS |     Avg |      p99 |    Heap |
+| :------------- | ----: | ------: | -------: | ------: |
+| undici         | 9.86K | 20.22ms | 203.05ms |  155 MB |
+| @hyperttp/core | 9.04K | 22.10ms |  29.14ms |  295 MB |
+| hyperttp       | 7.10K | 28.12ms |  40.02ms |  272 MB |
+| fetch          | 5.78K | 34.47ms | 322.17ms |  289 MB |
+| ky             | 4.50K | 44.35ms | 440.24ms |  374 MB |
+| axios          | 4.08K | 48.76ms |  54.92ms |  238 MB |
+| node-fetch     | 3.62K | 55.10ms |  83.60ms |  434 MB |
+| got            | 3.06K | 65.31ms |  96.38ms |  164 MB |
+| superagent     | 2.96K | 67.29ms |  78.96ms | 81.1 MB |
+
+---
+
+## Why p99 matters
+
+Most HTTP clients look good on average latency but suffer from high tail latency
+under load.
+
+`@hyperttp/core` is optimized for:
+
+- stable scheduling behavior,
+- predictable concurrency,
+- minimized latency spikes,
+- burst workload stability.
+
+---
+
+## Installation
+
+### Bun
+
+```bash
+bun add @hyperttp/core
+```
+
+### npm
+
+```bash
+npm install @hyperttp/core
+```
+
+---
+
+## Quick start
+
+```ts
+import { HyperCore } from "@hyperttp/core";
+
+const core = new HyperCore({
+  verbose: true,
+});
+
+const response = await core.get("http://localhost:3000/json");
+
+console.log(response.body);
+```
+
+---
+
+## Configuration
+
+```ts
+import { HyperCore } from "@hyperttp/core";
+
+const core = new HyperCore({
+  verbose: true,
+
+  trackMetrics: true,
+
+  network: {
+    timeout: 30000,
+    maxConcurrent: 500,
+    pipelining: 10,
+    keepAliveTimeout: 30000,
+    allowHttp2: true,
+    followRedirects: true,
+    maxRedirects: 5,
+  },
+
+  retry: {
+    maxRetries: 3,
+  },
+});
+```
+
+---
+
+## Stream API
+
+```ts
+import fs from "node:fs";
+
+const stream = await core.stream("https://example.com/file.zip");
+
+stream.body.pipe(fs.createWriteStream("./file.zip"));
+```
+
+---
+
+## Metrics
+
+```ts
+const core = new HyperCore({
+  trackMetrics: true,
+});
+
+const response = await core.get("https://api.example.com");
+
+console.log(response.meta?.timings);
+```
+
+Example:
+
+```ts
+{
+  networkMs: 12.41;
+}
+```
+
+---
+
+## Runtime support
+
+- Node.js 18+
+- Bun
+
+---
+
+## Built on
+
+- `undici`
+- `http-cookie-agent`
+
+---
+
+## License
+
+MIT

package/dist/Core/HyperCore.d.ts

@@ -0,0 +1,59 @@
+import type { Method } from "../types/http.js";
+import type { HttpClientOptions } from "../types/options.js";
+import type { RequestBodyData, RequestInterface } from "../types/request.js";
+import type { StreamResponse } from "../types/stream.js";
+import type { Readable } from "node:stream";
+import type { RequestMetrics } from "../types/metrics.js";
+export interface InternalRequest {
+    method: Method;
+    url: RequestInterface | string;
+    headers: Record<string, string>;
+    body?: RequestBodyData;
+    signal?: AbortSignal;
+    isGet: boolean;
+    meta?: {
+        timings?: {
+            serializationMs?: number;
+            networkMs?: number;
+            parsingMs?: number;
+        };
+        [key: string]: any;
+    };
+}
+export interface HttpResponse<T = any> {
+    status: number;
+    headers: Record<string, any>;
+    url?: string;
+    body: T;
+}
+export interface HyperStats {
+    inflightRequests?: number;
+    cacheSize?: number;
+    queuedRequests?: number;
+    activeQueue?: number;
+    rateLimitHits?: number;
+    [key: string]: any;
+}
+export declare class HyperCore {
+    config: HttpClientOptions;
+    private agent;
+    private executor;
+    private defaultHeaders;
+    constructor(config: HttpClientOptions);
+    dispatch: <T = any>(req: InternalRequest) => Promise<HttpResponse<T>>;
+    get<T = any>(req: RequestInterface | string, signal?: AbortSignal): Promise<HttpResponse<T>>;
+    post<T = any>(req: RequestInterface | string, body?: RequestBodyData, signal?: AbortSignal): Promise<HttpResponse<T>>;
+    put<T = any>(req: RequestInterface | string, body?: RequestBodyData): Promise<HttpResponse<T>>;
+    delete<T = any>(req: RequestInterface | string): Promise<HttpResponse<T>>;
+    patch<T = any>(req: RequestInterface | string, body?: RequestBodyData): Promise<HttpResponse<T>>;
+    options<T = any>(req: RequestInterface | string, body?: RequestBodyData): Promise<HttpResponse<T>>;
+    head(req: RequestInterface | string): Promise<HttpResponse<null>>;
+    extend(options: Partial<HttpClientOptions>): HyperCore;
+    create(options: Partial<HttpClientOptions>): HyperCore;
+    stream(req: RequestInterface | string): Promise<StreamResponse<Readable>>;
+    private requestInternal;
+    getStats(): HyperStats;
+    getAllMetrics(): RequestMetrics[];
+    destroy(): Promise<void>;
+}
+//# sourceMappingURL=HyperCore.d.ts.map

package/dist/Core/HyperCore.d.ts.map

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

package/dist/Core/HyperCore.js

@@ -0,0 +1,162 @@
+import { CookieAgent } from "http-cookie-agent/undici";
+import { RequestExecutor } from "./RequestExecutor.js";
+export class HyperCore {
+    config;
+    agent;
+    executor;
+    defaultHeaders;
+    constructor(config) {
+        this.config = config;
+        const concurrency = config.network?.maxConcurrent === 0
+            ? Infinity
+            : (config.network?.maxConcurrent ?? 500);
+        const pipelining = config.network?.pipelining === 0
+            ? 256
+            : (config.network?.pipelining ?? 10);
+        this.agent = new CookieAgent({
+            connections: concurrency === Infinity ? 0x7fffffff : concurrency,
+            pipelining: pipelining,
+            keepAliveTimeout: config.network?.keepAliveTimeout ?? 30000,
+            keepAliveMaxTimeout: config.network?.keepAliveTimeout ?? 30000,
+            connect: { rejectUnauthorized: config.network?.rejectUnauthorized },
+            allowH2: config.network?.allowHttp2 ?? true,
+        });
+        const retryOptions = {
+            maxRetries: config.retry?.maxRetries ?? 3,
+            ...config.retry,
+        };
+        const network = config.network;
+        this.executor = new RequestExecutor(this.agent, {
+            timeout: network?.timeout ?? 30000,
+            maxRetries: retryOptions.maxRetries ?? 3,
+            followRedirects: network?.followRedirects ?? true,
+            maxRedirects: network?.maxRedirects ?? 5,
+            retryOptions: retryOptions,
+            verbose: config.verbose ?? false,
+            logger: config.logger,
+        });
+        this.defaultHeaders = {
+            Accept: "application/json, text/plain, */*",
+            "Accept-Encoding": "gzip, deflate, br",
+            "User-Agent": config.network?.userAgent || "Hyperttp/2.0",
+        };
+    }
+    dispatch = async (req) => {
+        const urlString = typeof req.url === "string" ? req.url : req.url.getURL();
+        if (req.signal?.aborted) {
+            throw new Error("Request aborted by user");
+        }
+        req.meta = req.meta || {};
+        req.meta.timings = req.meta.timings || {};
+        const startNetwork = this.config.trackMetrics
+            ? process.hrtime.bigint()
+            : null;
+        const rawResponse = await this.executor.execute(req.method, urlString, req.headers, req.body, req.signal);
+        if (this.config.trackMetrics && startNetwork !== null) {
+            req.meta.timings.networkMs =
+                Number(process.hrtime.bigint() - startNetwork) / 1_000_000;
+        }
+        return {
+            status: rawResponse.status,
+            headers: rawResponse.headers,
+            body: req.method === "HEAD" ? undefined : rawResponse.body,
+            url: rawResponse.url,
+        };
+    };
+    get(req, signal) {
+        if (typeof req === "string") {
+            return this.dispatch({
+                method: "GET",
+                url: req,
+                headers: { ...this.defaultHeaders },
+                isGet: true,
+                signal,
+            });
+        }
+        return this.requestInternal("GET", req, undefined, true, signal);
+    }
+    post(req, body, signal) {
+        return this.requestInternal("POST", req, body, false, signal);
+    }
+    put(req, body) {
+        return this.requestInternal("PUT", req, body, false);
+    }
+    delete(req) {
+        return this.requestInternal("DELETE", req, undefined, false);
+    }
+    patch(req, body) {
+        return this.requestInternal("PATCH", req, body, false);
+    }
+    options(req, body) {
+        return this.requestInternal("OPTIONS", req, body, false);
+    }
+    async head(req) {
+        return this.requestInternal("HEAD", req, undefined, false);
+    }
+    extend(options) {
+        return new HyperCore({
+            ...this.config,
+            ...options,
+            network: {
+                ...this.config.network,
+                ...options.network,
+            },
+        });
+    }
+    create(options) {
+        return this.extend(options);
+    }
+    async stream(req) {
+        const url = typeof req === "string" ? req : req.getURL();
+        const signal = typeof req !== "string"
+            ? (req.getSignal?.() ?? req.signal)
+            : undefined;
+        const headers = {
+            ...this.defaultHeaders,
+            ...(typeof req !== "string" ? req.getHeaders?.() : {}),
+        };
+        const rawResponse = await this.executor.execute("GET", url, headers, undefined, signal);
+        return {
+            status: rawResponse.status,
+            headers: rawResponse.headers,
+            body: rawResponse.body,
+            url: rawResponse.url,
+        };
+    }
+    async requestInternal(method, req, body, isGet = false, signal) {
+        return this.dispatch({
+            method,
+            url: req,
+            headers: {
+                ...this.defaultHeaders,
+                ...(typeof req !== "string" ? req.getHeaders?.() : {}),
+            },
+            body: typeof req !== "string" && req.getBodyData ? req.getBodyData() : body,
+            isGet,
+            signal: typeof req !== "string" ? req.getSignal?.() : signal,
+        });
+    }
+    getStats() {
+        return {};
+    }
+    getAllMetrics() {
+        return [];
+    }
+    async destroy() {
+        try {
+            const anyAgent = this.agent;
+            if (typeof anyAgent.destroy === "function") {
+                await anyAgent.destroy();
+            }
+            else if (typeof anyAgent.close === "function") {
+                await anyAgent.close();
+            }
+        }
+        catch (error) {
+            if (this.config.verbose) {
+                console.warn("[HyperCore] destroy failed:", error);
+            }
+        }
+    }
+}
+//# sourceMappingURL=HyperCore.js.map

package/dist/Core/HyperCore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HyperCore.js","sourceRoot":"","sources":["../../src/Core/HyperCore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AA2CvD,MAAM,OAAO,SAAS;IACb,MAAM,CAAoB;IACzB,KAAK,CAAc;IACnB,QAAQ,CAAkB;IAC1B,cAAc,CAAyB;IAE/C,YAAY,MAAyB;QACnC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QAErB,MAAM,WAAW,GACf,MAAM,CAAC,OAAO,EAAE,aAAa,KAAK,CAAC;YACjC,CAAC,CAAC,QAAQ;YACV,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,aAAa,IAAI,GAAG,CAAC,CAAC;QAE7C,MAAM,UAAU,GACd,MAAM,CAAC,OAAO,EAAE,UAAU,KAAK,CAAC;YAC9B,CAAC,CAAC,GAAG;YACL,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,UAAU,IAAI,EAAE,CAAC,CAAC;QAEzC,IAAI,CAAC,KAAK,GAAG,IAAI,WAAW,CAAC;YAC3B,WAAW,EAAE,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,WAAW;YAChE,UAAU,EAAE,UAAU;YACtB,gBAAgB,EAAE,MAAM,CAAC,OAAO,EAAE,gBAAgB,IAAI,KAAK;YAC3D,mBAAmB,EAAE,MAAM,CAAC,OAAO,EAAE,gBAAgB,IAAI,KAAK;YAC9D,OAAO,EAAE,EAAE,kBAAkB,EAAE,MAAM,CAAC,OAAO,EAAE,kBAAkB,EAAE;YACnE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,UAAU,IAAI,IAAI;SAC5C,CAAC,CAAC;QAEH,MAAM,YAAY,GAAiB;YACjC,UAAU,EAAG,MAAc,CAAC,KAAK,EAAE,UAAU,IAAI,CAAC;YAClD,GAAI,MAAc,CAAC,KAAK;SACzB,CAAC;QAEF,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAE/B,IAAI,CAAC,QAAQ,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,KAAK,EAAE;YAC9C,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,KAAK;YAClC,UAAU,EAAE,YAAY,CAAC,UAAU,IAAI,CAAC;YACxC,eAAe,EAAE,OAAO,EAAE,eAAe,IAAI,IAAI;YACjD,YAAY,EAAE,OAAO,EAAE,YAAY,IAAI,CAAC;YACxC,YAAY,EAAE,YAAY;YAC1B,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,KAAK;YAChC,MAAM,EAAE,MAAM,CAAC,MAAM;SACtB,CAAC,CAAC;QAEH,IAAI,CAAC,cAAc,GAAG;YACpB,MAAM,EAAE,mCAAmC;YAC3C,iBAAiB,EAAE,mBAAmB;YACtC,YAAY,EAAE,MAAM,CAAC,OAAO,EAAE,SAAS,IAAI,cAAc;SAC1D,CAAC;IACJ,CAAC;IAEM,QAAQ,GAAG,KAAK,EACrB,GAAoB,EACM,EAAE;QAC5B,MAAM,SAAS,GAAG,OAAO,GAAG,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;QAE3E,IAAI,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC7C,CAAC;QAED,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;QAC1B,GAAG,CAAC,IAAI,CAAC,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;QAE1C,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY;YAC3C,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE;YACzB,CAAC,CAAC,IAAI,CAAC;QAET,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAC7C,GAAG,CAAC,MAAM,EACV,SAAS,EACT,GAAG,CAAC,OAAO,EACX,GAAG,CAAC,IAAI,EACR,GAAG,CAAC,MAAM,CACX,CAAC;QAEF,IAAI,IAAI,CAAC,MAAM,CAAC,YAAY,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;YACtD,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS;gBACxB,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,YAAY,CAAC,GAAG,SAAS,CAAC;QAC/D,CAAC;QAED,OAAO;YACL,MAAM,EAAE,WAAW,CAAC,MAAM;YAC1B,OAAO,EAAE,WAAW,CAAC,OAAO;YAC5B,IAAI,EAAE,GAAG,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAE,SAAiB,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI;YACnE,GAAG,EAAE,WAAW,CAAC,GAAG;SACrB,CAAC;IACJ,CAAC,CAAC;IAEK,GAAG,CACR,GAA8B,EAC9B,MAAoB;QAEpB,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC5B,OAAO,IAAI,CAAC,QAAQ,CAAI;gBACtB,MAAM,EAAE,KAAK;gBACb,GAAG,EAAE,GAAG;gBACR,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,cAAc,EAAE;gBACnC,KAAK,EAAE,IAAI;gBACX,MAAM;aACP,CAAC,CAAC;QACL,CAAC;QACD,OAAO,IAAI,CAAC,eAAe,CAAI,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IACtE,CAAC;IAEM,IAAI,CACT,GAA8B,EAC9B,IAAsB,EACtB,MAAoB;QAEpB,OAAO,IAAI,CAAC,eAAe,CAAI,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IACnE,CAAC;IAEM,GAAG,CACR,GAA8B,EAC9B,IAAsB;QAEtB,OAAO,IAAI,CAAC,eAAe,CAAI,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IAC1D,CAAC;IAEM,MAAM,CACX,GAA8B;QAE9B,OAAO,IAAI,CAAC,eAAe,CAAI,QAAQ,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;IAClE,CAAC;IAEM,KAAK,CACV,GAA8B,EAC9B,IAAsB;QAEtB,OAAO,IAAI,CAAC,eAAe,CAAI,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IAC5D,CAAC;IAEM,OAAO,CACZ,GAA8B,EAC9B,IAAsB;QAEtB,OAAO,IAAI,CAAC,eAAe,CAAI,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IAC9D,CAAC;IAEM,KAAK,CAAC,IAAI,CACf,GAA8B;QAE9B,OAAO,IAAI,CAAC,eAAe,CAAO,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;IACnE,CAAC;IAEM,MAAM,CAAC,OAAmC;QAC/C,OAAO,IAAI,SAAS,CAAC;YACnB,GAAG,IAAI,CAAC,MAAM;YACd,GAAG,OAAO;YACV,OAAO,EAAE;gBACP,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO;gBACtB,GAAG,OAAO,CAAC,OAAO;aACnB;SACF,CAAC,CAAC;IACL,CAAC;IAEM,MAAM,CAAC,OAAmC;QAC/C,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IAEM,KAAK,CAAC,MAAM,CACjB,GAA8B;QAE9B,MAAM,GAAG,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;QACzD,MAAM,MAAM,GACV,OAAO,GAAG,KAAK,QAAQ;YACrB,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,IAAK,GAAW,CAAC,MAAM,CAAC;YAC5C,CAAC,CAAC,SAAS,CAAC;QAChB,MAAM,OAAO,GAAG;YACd,GAAG,IAAI,CAAC,cAAc;YACtB,GAAG,CAAC,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACvD,CAAC;QAEF,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAC7C,KAAK,EACL,GAAG,EACH,OAAO,EACP,SAAS,EACT,MAAM,CACP,CAAC;QAEF,OAAO;YACL,MAAM,EAAE,WAAW,CAAC,MAAM;YAC1B,OAAO,EAAE,WAAW,CAAC,OAAO;YAC5B,IAAI,EAAE,WAAW,CAAC,IAAI;YACtB,GAAG,EAAE,WAAW,CAAC,GAAG;SACrB,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,eAAe,CAC3B,MAAc,EACd,GAA8B,EAC9B,IAAsB,EACtB,QAAiB,KAAK,EACtB,MAAoB;QAEpB,OAAO,IAAI,CAAC,QAAQ,CAAI;YACtB,MAAM;YACN,GAAG,EAAE,GAAG;YACR,OAAO,EAAE;gBACP,GAAG,IAAI,CAAC,cAAc;gBACtB,GAAG,CAAC,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACvD;YACD,IAAI,EACF,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI;YACvE,KAAK;YACL,MAAM,EAAE,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM;SAC7D,CAAC,CAAC;IACL,CAAC;IAEM,QAAQ;QACb,OAAO,EAAE,CAAC;IACZ,CAAC;IAEM,aAAa;QAClB,OAAO,EAAE,CAAC;IACZ,CAAC;IAEM,KAAK,CAAC,OAAO;QAClB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAY,CAAC;YACnC,IAAI,OAAO,QAAQ,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;gBAC3C,MAAM,QAAQ,CAAC,OAAO,EAAE,CAAC;YAC3B,CAAC;iBAAM,IAAI,OAAO,QAAQ,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;gBAChD,MAAM,QAAQ,CAAC,KAAK,EAAE,CAAC;YACzB,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACxB,OAAO,CAAC,IAAI,CAAC,6BAA6B,EAAE,KAAK,CAAC,CAAC;YACrD,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/dist/Core/RequestExecutor.d.ts

@@ -0,0 +1,56 @@
+import { Agent } from "undici";
+import type { RetryOptions } from "../types/retry.js";
+import type { LogLevel } from "../types/http.js";
+import type { RequestMetrics } from "../types/metrics.js";
+type LowLevelResponse = {
+    status: number;
+    headers: Record<string, string | string[] | undefined>;
+    body: any;
+    url: string;
+};
+interface DynamicInterceptor {
+    applyRequest(config: any): Promise<any>;
+    applyResponse(response: any): Promise<any>;
+}
+/**
+ * @en Low-level request executor responsible for handling the actual HTTP lifecycle.
+ * @ru Низкоуровневый исполнитель запросов, отвечающий за полный цикл HTTP-жизни.
+ */
+export declare class RequestExecutor {
+    private agent;
+    private options;
+    private readonly redirectStatusCodes;
+    constructor(agent: Agent, options: {
+        timeout: number;
+        maxRetries: number;
+        followRedirects: boolean;
+        maxRedirects: number;
+        retryOptions: RetryOptions;
+        verbose?: boolean;
+        logger?: (level: LogLevel, message: string, meta?: any) => void;
+    });
+    /**
+     * @en Executes a raw HTTP request.
+     * @ru Выполняет "сырой" HTTP-запрос.
+     */
+    execute(method: string, url: string, headers: Record<string, string>, body: string | Buffer | undefined, signal?: AbortSignal, metrics?: RequestMetrics, interceptors?: DynamicInterceptor | any): Promise<LowLevelResponse>;
+    /**
+     * @en Calculates the delay for the next retry attempt using exponential backoff.
+     * @ru Вычисляет задержку для следующей попытки повтора.
+     */
+    private calcDelay;
+    private sleep;
+    /**
+     * @en Ensures that the response body stream is properly closed to prevent memory leaks.
+     * @ru Гарантирует, что поток тела ответа корректно закрыт.
+     */
+    private drainBody;
+    /**
+     * @en Checks if the status code should trigger a retry attempt.
+     * @ru Проверяет, должен ли данный статус-код вызывать повтор запроса.
+     */
+    private shouldRetry;
+    private executeCore;
+}
+export {};
+//# sourceMappingURL=RequestExecutor.d.ts.map

package/dist/Core/RequestExecutor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RequestExecutor.d.ts","sourceRoot":"","sources":["../../src/Core/RequestExecutor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAU,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAG1D,KAAK,gBAAgB,GAAG;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;IACvD,IAAI,EAAE,GAAG,CAAC;IACV,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,UAAU,kBAAkB;IAC1B,YAAY,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IACxC,aAAa,CAAC,QAAQ,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;CAC5C;AAED;;;GAGG;AACH,qBAAa,eAAe;IAIxB,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,OAAO;IAJjB,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAsC;gBAGhE,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,eAAe,EAAE,OAAO,CAAC;QACzB,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,YAAY,CAAC;QAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC;KACjE;IAGH;;;OAGG;IACG,OAAO,CACX,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,EACjC,MAAM,CAAC,EAAE,WAAW,EACpB,OAAO,CAAC,EAAE,cAAc,EACxB,YAAY,CAAC,EAAE,kBAAkB,GAAG,GAAG,GACtC,OAAO,CAAC,gBAAgB,CAAC;IAa5B;;;OAGG;IACH,OAAO,CAAC,SAAS;IAUjB,OAAO,CAAC,KAAK;IAIb;;;OAGG;YACW,SAAS;IAoBvB;;;OAGG;IACH,OAAO,CAAC,WAAW;YAQL,WAAW;CA2L1B"}