Wooks Official Documentation

Composables for Node.js

Type-safe event context. Lazy by design.

Typed Event Context

Every event gets a typed, extensible state — not ad-hoc properties on req. Declare slots, compute lazily, cache automatically.

One API. Every event type.

HTTP, WebSocket, CLI, Workflows — the same composable pattern works everywhere. Learn once, use anywhere.

Lazy by default

Body parsing, cookie reading, auth extraction — nothing runs until you call it. Auth fails with a 100KB body? Wooks rejects 3.5× faster.

TypeScript-first

Fully typed context slots, route params, and composable return values. Type safety through compile-time branding.

Advanced Router

Regex constraints, multi-wildcards, optional params. Fastest on enterprise-grade route patterns — ahead of Hono, Fastify, and h3.

Build your own composables

defineWook() lets you create reusable, cached, typed composables — like building your own useAuth().

See it in practice.

Express

// Middleware chain + req/res threading
app.post('/users',
  bodyParser.json(),
  authenticate,
  async (req, res) => {
    res.status(201).json({ name: req.body.name })
  }
)

Wooks

// Just call what you need
app.post('/users', async () => {
  await useAuthorization()
  const user = await useBody().parseBody<User>()
  return { name: user.name } // status 201 is default for POST
})

70,332 req/s

21-route SaaS benchmark — fastest overall, 10–15% ahead on cookie-heavy traffic.

See benchmarks →

One pattern. Every event type.

HTTP, WebSocket, CLI, Workflows — the same composable API everywhere. Learn once, use anywhere.

Try it →

import { createHttpApp, useRouteParams } from '@wooksjs/event-http'
import { useBody } from '@wooksjs/http-body'

const app = createHttpApp()

app.post('/users/:org', async () => {
  const { parseBody } = useBody()
  const { get } = useRouteParams<{ org: string }>()
  const user = await parseBody<{ name: string }>()
  return { org: get('org'), created: user.name }
})

app.listen(3000)