@wthek/nestjs-middleware

Official @wthek Extension – NestJS Middleware for http-error-kit

Seamless NestJS Error Handling with @wthek

Built for applications powered by http-error-kit, this middleware ensures that all http-error-kit errors are properly formatted and returned with the correct HTTP status codes.

💡 What the HEK?! Need a hassle-free way to manage error responses for http-error-kit errors in NestJS? @wthek/nestjs-middleware has got you covered!

✅ Supports both Express and Fastify underlying NestJS apps out of the box.

Features

• Official http-error-kit Extension – The recommended middleware for NestJS apps.
• Dual Engine Support – Works with both Express and Fastify-based NestJS apps.
• Auto-sets HTTP status codes – Ensures the response status matches the error type.
• Plug-and-Play Middleware – Just drop it before starting your server!
• Graceful Fallbacks – Passes unrecognized errors to the next middleware.

Table of Content

• Installation
• Usage
• How It Works
• Why Use @wthek/nestjs-middleware?
• Explore More WTHek Extensions
• People
• Donations
• License

Installation

npm install @wthek/nestjs-middleware

Usage

Add Middleware Just Before Starting the Server

To catch all errors correctly, place KitNestJsMiddleware(app) in main.ts file before starting the NestJS server.

import { NestFactory } from '@nestjs/core';
import { AppModule } from './app.module';
import { KitNestJsMiddleware } from '@wthek/nestjs-middleware';

async function bootstrap() {
  const app = await NestFactory.create(AppModule);
  KitNestJsMiddleware(app);
  await app.listen(process.env.PORT ?? 3000);
}
bootstrap();

How It Works

• Catches errors thrown in routes and middleware
• Checks if the error is an instance of any http-error-kit Errors
• Formats the error response and sets the correct HTTP status code
• Passes other errors to the next middleware (so they can be handled separately)

Why Use @wthek/nestjs-middleware?

• No more manual error handling – Status codes are automatically set.
• Consistent API responses – Standardized errors improve debugging & logging.
• Works perfectly with http-error-kit – Fully compatible with existing http-error-kit error structures.

Explore More WTHek Extensions

The WTHek ecosystem continues to grow with new extensions to simplify error handling across various frameworks and libraries. Stay updated with the latest tools that integrate seamlessly with http-error-kit.

Check out the official list of extensions: Official Extensions List

People

The original author of the project is Himanshu Bansal

Donations

This is all voluntary work, so if you want to support my efforts you can

• Buy Me A Coffee
• Paypal
• GitHub Sponsor
• Patreon
• Open Collective

You can also use the following:

License

@wthek/nestjs-middleware project is open-sourced software licensed under the MIT license by Himanshu Bansal.