http-debugger

Zero-dependency HTTP debug middleware

Stream-level request capture, smart body truncation, cURL generation, and framework adapters for Express, Fastify, Hono, and Next.js.

Get Started

API Reference

View on GitHub

🚀

Stream-Level Capture

Intercepts raw HTTP streams — no body parser middleware required. Captures request and response bodies exactly as they flow.

✂️

Smart Body Truncation

Configurable maxBodySize with automatic truncation. Deep JSON objects and large arrays collapse gracefully.

📋

cURL Generation

One-click reproduction. Generates ready-to-paste cURL commands with headers and body for any captured request.

⚡

Zero Runtime Dependencies

No dependencies in production. Framework adapters use only peer dependencies you already have.

🌐

Edge-Compatible

Hono and Next.js adapters use WinterCG standard APIs — runs on Cloudflare Workers, Deno, Bun, Vercel Edge.

📊

Real-Time Dashboard

Optional embedded web UI at /__debugger with SSE live updates, search, and request inspection.

Quick Start

bash

npm install http-debugger

Express

import express from 'express'
import { httpDebugger } from 'http-debugger/express'

const app = express()
app.use(httpDebugger())

Fastify

import Fastify from 'fastify'
import { httpDebugger } from 'http-debugger/fastify'

const fastify = Fastify()
fastify.register(httpDebugger)

Hono

import { Hono } from 'hono'
import { httpDebugger } from 'http-debugger/hono'

const app = new Hono()
app.use('*', httpDebugger())

Next.js (App Router)

// app/api/users/route.ts
import { withHttpDebugger } from 'http-debugger/next'

async function handler(req: Request) {
  return Response.json({ users: [] })
}

export const GET = withHttpDebugger(handler)

// app/__debugger/[[...route]]/route.ts
import { dashboardRoute } from 'http-debugger/next'

export const GET = dashboardRoute({ maxDepth: 4, sanitize: true })

Why http-debugger?

Feature	http-debugger	Morgan	Pino
Stream-level capture	✅	❌	❌
Request body capture	✅	❌	❌
Response body capture	✅	❌	❌
Body truncation	✅	❌	❌
cURL generation	✅	❌	❌
Zero runtime deps	✅	✅	❌
TypeScript support	✅	❌	✅
Express	✅	✅	✅
Fastify	✅	❌	✅
Hono / Edge	✅	❌	❌
Next.js (App Router)	✅	❌	❌

http-debugger

Stream-Level Capture

Smart Body Truncation

cURL Generation

Zero Runtime Dependencies

Edge-Compatible

Real-Time Dashboard

Quick Start ​

Express ​

Fastify ​

Hono ​

Next.js (App Router) ​

Why http-debugger? ​