@axiomify/native

uWebSockets.js adapter for Axiomify. Highest-throughput transport: 73,000–84,000 req/s single-process on an 8-core machine.

Install

npm install @axiomify/native @axiomify/core zod

Requires Node.js 22 or 24 (uWS pre-compiled binary).

Quick example

import { Axiomify } from '@axiomify/core';
import { NativeAdapter } from '@axiomify/native';
import { z } from 'zod';

const app = new Axiomify();
app.enableRequestId();

app.route({
  method: 'GET',
  path: '/ping',
  handler: async (_req, res) => res.send({ pong: true }),
});

const adapter = new NativeAdapter(app, { port: 3000 });

// Single process
adapter.listen(() => console.log('Ready on :3000'));

// Multi-core (production)
adapter.listenClustered({
  onWorkerReady: () => console.log(`[${process.pid}] ready`),
  onPrimary: (pids) => console.log('Workers:', pids),
  onWorkerExit: (pid, code) => console.error(`Worker ${pid} exited (${code})`),
});
// Zero-downtime reload: kill -USR2 <primary-pid>

HTTP/2

uWebSockets.js exposes no HTTP/2 API from its JS bindings, so HTTP/2 support ships as a separate adapter built on node:http2:

• NativeAdapter (uWS) — the HTTP/1.1 raw-throughput path. Pick it when requests/second is the metric that matters.
• Http2Adapter (node:http2) — trades peak throughput for HTTP/2 semantics: stream multiplexing over one connection, HPACK header compression, and TLS+ALPN deployments.

import { Http2Adapter } from '@axiomify/native';

const adapter = new Http2Adapter(app, {
  port: 443,
  tls: { keyFile: './key.pem', certFile: './cert.pem' }, // or inline { key, cert }
});
adapter.listen(() => console.log('h2 ready on :443'));

The secure server advertises ALPN ['h2', 'http/1.1'] with allowHTTP1: true, so non-h2 clients transparently fall back to HTTP/1.1 over the same port. For local development and tests, cleartext HTTP/2 is available with h2c: true (no TLS — browsers will not connect to h2c).

Same API surface as NativeAdapter: maxBodySize, trustProxy + proxyIpValidator, cookies, SSE, streaming, gracefulShutdown(). See docs/packages/native.md for the full option table.

Benchmarks

| Scenario | Req/s | p99 | | ---------------------------- | -----: | ----: | | GET /users/:id/posts/:postId | 83,947 | 20 ms | | GET /ping | 73,511 | 26 ms | | POST /echo (JSON body) | 54,720 | 30 ms |

8-core machine, autocannon 100 conns, pipelining 10, 12 s.

Documentation

See docs/packages/native.md.