@hyperttp/core 1.1.12 → 1.2.0

package/README.md

@@ -0,0 +1,178 @@
+# @hyperttp/core ⚡
+
+> English | [Русский](https://github.com/IT-IF-OR/hyperttp-core/tree/main/lang/ru)
+
+---
+
+## 🌐 Language
+
+- 🇺🇸 English
+- 🇷🇺 [Русский](https://github.com/IT-IF-OR/hyperttp-core/tree/main/lang/ru)
+
+---
+
+**Hyperttp** is a high-performance, isomorphic HTTP client designed for modern Node.js and Bun environments.
+It is built as a thin core with an intelligent transport selection strategy and a powerful plugin system.
+
+## Why Hyperttp?
+
+- **⚡ Performance:** optimized hot-path HTTP request execution for Node.js and Bun
+- **🧩 Isomorphism:** unified API for Node.js and Bun. The system automatically selects the best transport
+  (native Bun, Undici, or standard Node.js `http`)
+- **🔌 Plugin system:** easily extend functionality via hooks
+  (`onRequest`, `onResponse`, `onError`)
+- **🛠️ Transport strategy:** easily add support for new runtimes
+  (Deno, Browser) via the `HyperTransport` interface
+
+---
+
+## Benchmarks
+
+### Test configuration
+
+```txt
+Requests        100000
+Concurrency     500
+Warmup          500
+Timeout         60000 ms
+```
+
+Run benchmark:
+
+```bash
+bun run bench.ts && npx tsx bench.ts
+```
+
+---
+
+## [Benchmark results](https://github.com/IT-IF-OR/bench)
+
+---
+
+# 🟦 Node.js v24.14.1 — Undici transport
+
+### 🏆 Leaderboard (by RPS)
+
+| Rank | Client         | RPS    | p99      | AVG     | Heap    |
+| ---- | -------------- | ------ | -------- | ------- | ------- |
+| 🥇 1 | @hyperttp/core | 27.72K | 43.45ms  | 17.95ms | 18.7 MB |
+| 🥈 2 | undici         | 19.80K | 59.51ms  | 25.17ms | 20.6 MB |
+| 🥉 3 | ky             | 7.82K  | 119.80ms | 63.86ms | 34.1 MB |
+| 4    | node-fetch     | 6.39K  | 125.38ms | 77.95ms | 15.2 MB |
+| 5    | superagent     | 6.28K  | 127.06ms | 79.50ms | 15.1 MB |
+| 6    | axios          | 6.19K  | 110.82ms | 80.53ms | 21.4 MB |
+| 7    | got            | 5.84K  | 130.92ms | 85.49ms | 15.7 MB |
+
+---
+
+# 🟨 Bun v1.3.14 — Bun transport
+
+### 🏆 Leaderboard (by RPS)
+
+| Rank | Client         | RPS    | p99     | AVG     | Heap    |
+| ---- | -------------- | ------ | ------- | ------- | ------- |
+| 🥇 1 | undici         | 36.42K | 15.67ms | 13.68ms | 31.8 MB |
+| 🥈 2 | node-fetch     | 36.29K | 16.70ms | 13.74ms | 4.07 MB |
+| 🥉 3 | @hyperttp/core | 34.26K | 21.61ms | 14.54ms | 34.9 MB |
+| 4    | ky             | 31.10K | 22.78ms | 16.05ms | 9.88 MB |
+| 5    | superagent     | 13.86K | 69.78ms | 36.00ms | 18.1 MB |
+| 6    | axios          | 8.98K  | 66.58ms | 55.52ms | 18.8 MB |
+| 7    | got            | 7.15K  | 86.70ms | 69.83ms | 25.2 MB |
+
+---
+
+# 🟩 Node.js v24.14.1 — Node transport
+
+### 🏆 Leaderboard (by RPS)
+
+| Rank | Client         | RPS    | p99      | AVG     | Heap    |
+| ---- | -------------- | ------ | -------- | ------- | ------- |
+| 🥇 1 | undici         | 20.08K | 66.21ms  | 24.76ms | 20.6 MB |
+| 🥈 2 | @hyperttp/core | 12.52K | 66.42ms  | 39.80ms | 14.1 MB |
+| 🥉 3 | ky             | 7.98K  | 113.21ms | 62.55ms | 23.1 MB |
+| 4    | node-fetch     | 6.71K  | 114.06ms | 74.23ms | 15.9 MB |
+| 5    | axios          | 6.29K  | 116.21ms | 79.22ms | 22.2 MB |
+| 6    | superagent     | 6.19K  | 125.31ms | 80.73ms | 15.2 MB |
+| 7    | got            | 5.86K  | 135.85ms | 85.18ms | 19.3 MB |
+
+---
+
+# 🟪 Bun v1.3.14 — Node transport
+
+### 🏆 Leaderboard (by RPS)
+
+| Rank | Client         | RPS    | p99      | AVG     | Heap    |
+| ---- | -------------- | ------ | -------- | ------- | ------- |
+| 🥇 1 | node-fetch     | 35.87K | 17.00ms  | 13.90ms | 6.21 MB |
+| 🥈 2 | undici         | 35.79K | 16.59ms  | 13.92ms | 25.4 MB |
+| 🥉 3 | ky             | 29.68K | 37.27ms  | 16.80ms | 17.3 MB |
+| 4    | @hyperttp/core | 17.32K | 50.71ms  | 28.79ms | 17.5 MB |
+| 5    | superagent     | 13.73K | 122.70ms | 36.37ms | 34.4 MB |
+| 6    | axios          | 8.77K  | 86.39ms  | 56.84ms | 18.9 MB |
+| 7    | got            | 6.97K  | 98.33ms  | 71.64ms | 25.3 MB |
+
+---
+
+## Quick start
+
+### Installation
+
+```bash
+npm install @hyperttp/core
+```
+
+---
+
+### Usage
+
+```typescript
+import { HyperCore } from "@hyperttp/core";
+
+const http = new HyperCore({
+  network: { userAgent: "MyApp/1.0" },
+});
+
+// GET request
+const response = await http.get("https://api.example.com/data");
+
+// POST request
+const result = await http.post("/users", { name: "John" });
+```
+
+---
+
+### Extending and plugins
+
+`HyperCore` supports creating isolated instances with custom configuration and plugins.
+
+```typescript
+const apiClient = http.extend({
+  network: { headers: { "X-Auth": "secret" } },
+});
+
+apiClient.use({
+  name: "logger-plugin",
+  enabled: () => true,
+  onRequest: async (req) => {
+    console.log(`Sending ${req.method} to ${req.url}`);
+  },
+});
+```
+
+---
+
+## Architecture
+
+Hyperttp is built on the **Strategy pattern**.
+
+1. **Core (`HyperCore`)**: orchestrates the request lifecycle
+2. **Transports (`HyperTransport`)**: low-level implementations for different runtimes
+   dynamically selected to minimize bundle size
+3. **Hooks**: executed during request lifecycle (before request, after response, on error)
+   allowing interception and modification without changing core logic
+
+---
+
+## License
+
+MIT

package/defaultConfig.d.ts

@@ -1,3 +1,3 @@
-import { HttpClientOptions } from "./types/options.js";
+import type { HttpClientOptions } from "@hyperttp/types";
 export declare const defaultConfig: HttpClientOptions;
 //# sourceMappingURL=defaultConfig.d.ts.map

package/defaultConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"defaultConfig.d.ts","sourceRoot":"","sources":["../src/defaultConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,eAAO,MAAM,aAAa,EAAE,iBAmB3B,CAAC"}
+{"version":3,"file":"defaultConfig.d.ts","sourceRoot":"","sources":["../src/defaultConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzD,eAAO,MAAM,aAAa,EAAE,iBAkB3B,CAAC"}

package/defaultConfig.js

@@ -2,7 +2,6 @@ export const defaultConfig = {
     network: {
         timeout: 30000,
         maxConcurrent: 500,
-        allowHttp2: true,
         pipelining: 10,
         keepAliveTimeout: 30000,
         followRedirects: true,

package/defaultConfig.js.map

@@ -1 +1 @@
-{"version":3,"file":"defaultConfig.js","sourceRoot":"","sources":["../src/defaultConfig.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,aAAa,GAAsB;IAC9C,OAAO,EAAE;QACP,OAAO,EAAE,KAAK;QACd,aAAa,EAAE,GAAG;QAClB,UAAU,EAAE,IAAI;QAChB,UAAU,EAAE,EAAE;QACd,gBAAgB,EAAE,KAAK;QACvB,eAAe,EAAE,IAAI;QACrB,YAAY,EAAE,CAAC;QACf,kBAAkB,EAAE,IAAI;QACxB,SAAS,EAAE,cAAc;KAC1B;IACD,KAAK,EAAE;QACL,UAAU,EAAE,CAAC;QACb,SAAS,EAAE,GAAG;QACd,QAAQ,EAAE,IAAI;QACd,MAAM,EAAE,IAAI;KACb;IACD,OAAO,EAAE,KAAK;CACf,CAAC"}
+{"version":3,"file":"defaultConfig.js","sourceRoot":"","sources":["../src/defaultConfig.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,aAAa,GAAsB;IAC9C,OAAO,EAAE;QACP,OAAO,EAAE,KAAK;QACd,aAAa,EAAE,GAAG;QAClB,UAAU,EAAE,EAAE;QACd,gBAAgB,EAAE,KAAK;QACvB,eAAe,EAAE,IAAI;QACrB,YAAY,EAAE,CAAC;QACf,kBAAkB,EAAE,IAAI;QACxB,SAAS,EAAE,cAAc;KAC1B;IACD,KAAK,EAAE;QACL,UAAU,EAAE,CAAC;QACb,SAAS,EAAE,GAAG;QACd,QAAQ,EAAE,IAAI;QACd,MAAM,EAAE,IAAI;KACb;IACD,OAAO,EAAE,KAAK;CACf,CAAC"}

package/index.d.ts

@@ -1,6 +1,3 @@
-export { HyperCore, RequestExecutor } from "./Core/index.js";
+export { HyperCore } from "./Core/index.js";
 export { deepMerge } from "./utils/merge.js";
-export type * from "./types/index.js";
-export type * from "./transports/bun.js";
-export type * from "./transports/node.js";
 //# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAE7D,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,mBAAmB,kBAAkB,CAAC;AACtC,mBAAmB,qBAAqB,CAAC;AACzC,mBAAmB,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC"}

package/index.js

@@ -1,3 +1,3 @@
-export { HyperCore, RequestExecutor } from "./Core/index.js";
+export { HyperCore } from "./Core/index.js";
 export { deepMerge } from "./utils/merge.js";
 //# sourceMappingURL=index.js.map

package/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAE7D,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC"}

package/package.json

@@ -1,10 +1,18 @@
 {
   "name": "@hyperttp/core",
-  "version": "1.1.12",
-  "description": "High-performance, extensible HTTP client for Node.js and Bun",
+  "version": "1.2.0",
+  "description": "High-performance, extensible HTTP client for Node.js and Bun and other",
   "type": "module",
   "main": "./index.js",
   "types": "./index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./index.js",
+      "require": "./index.js"
+    },
+    "./package.json": "./package.json"
+  },
   "keywords": [
     "http",
     "client",
@@ -20,11 +28,17 @@
     "url": "git+https://github.com/IT-IF-OR/hyperttp-core.git"
   },
   "peerDependencies": {
-    "typescript": "^6"
+    "typescript": "^6",
+    "@hyperttp/transport-bun": "^0.1.1",
+    "@hyperttp/transport-undici": "^0.1.0"
   },
-  "dependencies": {
-    "http-cookie-agent": "^8.0.0",
-    "undici": "^8.3.0"
+  "peerDependenciesMeta": {
+    "@hyperttp/transport-bun": {
+      "optional": true
+    },
+    "@hyperttp/transport-undici": {
+      "optional": true
+    }
   },
   "private": false
 }

package/transports/node.d.ts

@@ -1,14 +1,25 @@
-import type { HyperTransport, TransportRequest, TransportResponse } from "../types/transport.js";
-import type { HttpClientOptions } from "../types/options.js";
+import type { HttpClientOptions, HyperTransport, RetryOptions, TransportRequest, TransportResponse } from "@hyperttp/types";
+export declare function isRedirect(status: number): boolean;
+export declare function combineSignal(signal: AbortSignal | undefined, timeoutMs: number): {
+    signal?: AbortSignal;
+    cancelTimer: () => void;
+    isTimeoutAbort: () => boolean;
+};
+export declare function shouldRetry(status: number, retryOptions: RetryOptions): boolean;
+export declare function sleep(ms: number): Promise<void>;
+export declare function calcDelay(attempt: number, retryOptions: RetryOptions): number;
+/**
+ * @ru Высокопроизводительный транспорт на базе классических модулей http/https Node.js.
+ */
 export declare class NodeTransport implements HyperTransport {
-    private agent;
-    private executor;
-    private isClosed;
+    config: HttpClientOptions;
+    private readonly httpAgent;
+    private readonly httpsAgent;
     constructor(config: HttpClientOptions);
+    private get timeout();
     execute(req: TransportRequest): Promise<TransportResponse>;
-    private wrapDecompress;
+    private dispatchOnce;
     close(): Promise<void>;
     destroy(): Promise<void>;
-    private logWarning;
 }
 //# sourceMappingURL=node.d.ts.map

package/transports/node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../src/transports/node.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAU7D,qBAAa,aAAc,YAAW,cAAc;IAClD,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,QAAQ,CAAS;gBAEb,MAAM,EAAE,iBAAiB;IA2CxB,OAAO,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA4EvE,OAAO,CAAC,cAAc;IA0BT,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAkBtB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBrC,OAAO,CAAC,UAAU;CAMnB"}
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../src/transports/node.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,iBAAiB,EACjB,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EAElB,MAAM,iBAAiB,CAAC;AAKzB,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAElD;AAED,wBAAgB,aAAa,CAC3B,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,SAAS,EAAE,MAAM,GAChB;IACD,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,cAAc,EAAE,MAAM,OAAO,CAAC;CAC/B,CA8BA;AAED,wBAAgB,WAAW,CACzB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,YAAY,GACzB,OAAO,CAMT;AAED,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,GAAG,MAAM,CAI7E;AAkED;;GAEG;AACH,qBAAa,aAAc,YAAW,cAAc;IAC3C,MAAM,EAAE,iBAAiB,CAAC;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAa;IACvC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAc;gBAE7B,MAAM,EAAE,iBAAiB;IAkBrC,OAAO,KAAK,OAAO,GAElB;IAEY,OAAO,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAuHvE,OAAO,CAAC,YAAY;IAwEP,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAGtC"}