Middleware

The Middleware class registers inbound or outbound middleware into the global router. Inbound middleware runs before route handlers; outbound middleware runs after. Both variants receive the request context and can return a CResponse to short-circuit the request, or void to continue.

Usage
Constructor Parameters
Properties

Usage

As with many modules, the Middleware class can be instantiated directly with new or extended. The middlewares are automatically registered and inserted into the lifecycle inside the constructor.

With new

import { C } from "@ozanarslan/corpus";

const server = new C.Server();

new C.Middleware({
	variant: "inbound",
	useOn: "*",
	handler: async (c) => {
		if (!c.headers.get("authorization")) {
			return new C.Response("Unauthorized", { status: 401 });
		}
	},
});

void server.listen(3000);

Extending

import { C } from "@ozanarslan/corpus";
import { SomeService } from "./SomeService";

class SomeMiddleware extends C.Middleware {
	constructor(
		private readonly someService: SomeService,
		...args: ConstructorParameters<typeof C.Middleware>
	) {
		super(...args);
	}

	override handler: C.MiddlewareHandler = (c) => {
		return this.someService.fn(c.headers);
	};
}

const server = new C.Server();
const someRoute = new C.Route("/", () => "ok");
const someService = new SomeService();
new SomeMiddleware(someService, { useOn: [someRoute] });
void server.listen(3000);

Constructor Parameters

`variant`

Either "inbound" or "outbound". Defaults to "inbound". Inbound middlewares run before the handlers and outbound middlewares run after. Mental model if coming from NestJS:

Corpus	NestJS
Inbound Middleware returning void	Middleware (calling `next()`)
Outbound Middleware returning void	Interceptor (post-handler, returning observable)
Inbound Middleware returning CResponse	Guard returning `false` or throwing
Outbound Middleware returning CResponse	Exception Filter catching and transforming
Inbound Middleware throwing	Guard or Middleware throwing
Outbound Middleware throwing	Interceptor or Exception Filter throwing

`useOn`

The route(s) and controller(s) this middleware applies to. Pass "*" to apply globally to all routes.

export type MiddlewareUseOn =
	| Array<RouteInterface | Controller>
	| RouteInterface
	| Controller
	| "*";

`handler`

The middleware function. Receives the request context and can return a CResponse or throw and error to halt further processing, or void to pass through.

Properties

All constructor options are stored as readonly properties: variant, useOn, and handler.

Middleware

Contents