@hyperttp/core ⚡

English | Русский

🌐 Language

• 🇺🇸 English
• 🇷🇺 Русский

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

Requests        100000
Concurrency     500
Warmup          500
Timeout         60000 ms

Run benchmark:

bun run bench.ts && npx tsx bench.ts

Benchmark results

🟦 Node.js v24.14.1 — Undici transport

🏆 Leaderboard (by RPS)

🟨 Bun v1.3.14 — Bun transport

🏆 Leaderboard (by RPS)

🟩 Node.js v24.14.1 — Node transport

🏆 Leaderboard (by RPS)

🟪 Bun v1.3.14 — Node transport

🏆 Leaderboard (by RPS)

Quick start

Installation

npm install @hyperttp/core

Usage

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.

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