Route-Level Middlewares

Attach middlewares to specific routes via middleware (singular) or middlewares (plural) exports in companion or API files.

Singular vs. Plural Middleware Exports

If both middleware AND middlewares are exported in the same file, they merge and execute in order: middleware first, then elements in middlewares array.

Singular (middleware)

import type { Handler } from '@nxpress/core';

export const middleware: Handler = (req, res) => {
  res.setHeader('X-Route-Scope', 'single');
};

Plural (middlewares)

import type { Handler } from '@nxpress/core';

export const middlewares: Handler[] = [
  (req, res) => { console.log('Middleware 1'); },
  (req, res) => { console.log('Middleware 2'); }
];

Folder-Level Middlewares

Middleware Execution Model