http-context-middleware

HTTP Context Middleware for Node.js Framework


A lightweight, framework-agnostic middleware for managing HTTP context across Node.js applications using AsyncLocalStorage.

Features

- 🌐 Access request context from anywhere in your codebase
- 🔄 Thread-safe for concurrent requests
- 🧩 Framework-agnostic (adapters available for Express, more coming soon)
- 📋 TypeScript support with full type definitions
- 🔍 Request tracking with automatic IDs and timing
- 🧪 Well-tested

Installation

``bash
npm install @zakyyudha/http-context-middleware
`

Features

- Framework-agnostic context management
- Built-in adapters for Express (with more to come)
- Request tracking with unique request IDs
- Request timing out of the box
- Simple API for getting and setting context values

Usage

$3

`javascript
const express = require('express');
const { HttpContext, adapters } = require('@zakyyudha/http-context-middleware');

const app = express();

// Apply the middleware
app.use(adapters.express());

// Use context in other middleware
app.use((req, res, next) => {
// Store values in context
HttpContext.set('user', { id: 1, name: 'John' });
next();
});

app.get('/', (req, res) => {
// Retrieve values from context
const requestId = HttpContext.get('requestId');
const user = HttpContext.get('user');

res.json({
message: 'Hello World',
requestId,
user,
});
});

app.listen(3000);
`

$3

- HttpContext.getContext() - Returns the entire context object or null
- HttpContext.get(key) - Gets a value from the context
- HttpContext.set(key, value) - Sets a value in the context
- HttpContext.runWithContext(context, callback) - Runs a function with a given context

$3

- adapters.express(options) - Creates Express middleware
- Options:
- includeReqRes`: Whether to include req/res objects in context (default: false)

Future Plans

- Support for more frameworks: Koa, Fastify, Hapi, etc.
- Typescript support
- Context persistence across async boundaries
- Integration with logging libraries

License

MIT