@hyperttp/core 🚀

English | Русский

🌐 Language / Язык

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

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

Requests      20000
Concurrency   200
Warmup        500
Timeout       60000 ms
Runtime       Node.js

Benchmark executed via:

npx tsx ./bench.ts

Benchmark results

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

bun add @hyperttp/core

npm

npm install @hyperttp/core

Quick start

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

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

import fs from "node:fs";

const stream = await core.stream("https://example.com/file.zip");

stream.body.pipe(fs.createWriteStream("./file.zip"));

Metrics

const core = new HyperCore({
  trackMetrics: true,
});

const response = await core.get("https://api.example.com");

console.log(response.meta?.timings);

Example:

{
  networkMs: 12.41;
}

Runtime support

• Node.js 18+
• Bun

Built on

• undici
• http-cookie-agent

License

MIT