/** * Middleware chain execution */ import type { Middleware, RouteContext } from './types.js'; /** * Execute a chain of middleware functions * Middleware can: * - Call next() to continue to the next middleware/handler * - Return a Response to short-circuit the chain * - Throw an error to trigger error handling */ export async function executeMiddlewareChain( middlewares: Middleware[], request: Request, context: TContext & RouteContext, finalHandler: () => Promise, onError?: (error: unknown) => Response | Promise, ): Promise { let index = 0; const next = async (): Promise => { try { // If we've reached the end of middleware, call the final handler if (index >= middlewares.length) { return await finalHandler(); } // Get current middleware and increment index const middleware = middlewares[index++]; // Convert failures at the point where downstream middleware is invoked. // This keeps the eventual error response inside upstream middleware such // as observability, so it can still finalize headers and completion hooks. return await middleware(request, context, next); } catch (error) { if (!onError) throw error; return onError(error); } }; return next(); } /** * Combine multiple middleware arrays into one */ export function combineMiddleware( ...middlewareArrays: (Middleware[] | undefined)[] ): Middleware[] { return middlewareArrays.filter((arr): arr is Middleware[] => !!arr).flat(); }