Max P.
a236fa7c97
- Refactor HttpKernel and related interfaces to support generic contexts. - Add typed query parameters, route params, and state to IContext. - Introduce HttpMethod type for stricter HTTP method validation. - Update RouteBuilder and middleware to handle generic contexts. - Improve test cases to verify compatibility with new types. Signed-off-by: Max P. <Mail@MPassarello.de>
74 lines
2.6 KiB
TypeScript
74 lines
2.6 KiB
TypeScript
import { IRouteMatcherFactory } from './Interfaces/IRouteMatcher.ts';
|
|
import {
|
|
IContext,
|
|
IHandler,
|
|
IMiddleware,
|
|
IRouteBuilder,
|
|
IRouteDefinition,
|
|
} from './Interfaces/mod.ts';
|
|
import { RegisterRoute } from './Types/mod.ts';
|
|
import { createRouteMatcher } from './Utils/createRouteMatcher.ts';
|
|
|
|
/**
|
|
* Provides a fluent builder interface for defining a single route,
|
|
* including HTTP method, path or matcher, middleware chain and final handler.
|
|
*
|
|
* This builder is stateless and immutable; each chained call returns a new instance.
|
|
*/
|
|
export class RouteBuilder<TContext extends IContext = IContext>
|
|
implements IRouteBuilder<TContext> {
|
|
/**
|
|
* Constructs a new instance of the route builder.
|
|
*
|
|
* @param registerRoute - A delegate used to register the finalized route definition.
|
|
* @param def - The route definition (static path or dynamic matcher).
|
|
* @param mws - The list of middleware functions collected so far (default: empty).
|
|
*/
|
|
constructor(
|
|
private readonly registerRoute: RegisterRoute<TContext>,
|
|
private readonly def: IRouteDefinition,
|
|
private readonly mws: IMiddleware<TContext>[] = [],
|
|
private readonly matcherFactory: IRouteMatcherFactory =
|
|
createRouteMatcher,
|
|
) {}
|
|
|
|
/**
|
|
* Adds a middleware function to the current route definition.
|
|
*
|
|
* Middleware is executed in the order it is added.
|
|
* Returns a new builder instance with the additional middleware appended.
|
|
*
|
|
* @param mw - A middleware function to be executed before the handler.
|
|
* @returns A new `RouteBuilder` instance for continued chaining.
|
|
*/
|
|
middleware<_TContext extends IContext = TContext>(
|
|
mw: IMiddleware<_TContext>,
|
|
): IRouteBuilder<_TContext> {
|
|
return new RouteBuilder<_TContext>(
|
|
this.registerRoute as unknown as RegisterRoute<_TContext>,
|
|
this.def,
|
|
[...this.mws as unknown as IMiddleware<_TContext>[], mw],
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Finalizes the route by assigning the handler and registering the route.
|
|
*
|
|
* Internally constructs a matcher function from the route definition
|
|
* and passes all route data to the registration delegate.
|
|
*
|
|
* @param handler - The final request handler for this route.
|
|
*/
|
|
handle<_TContext extends IContext = TContext>(
|
|
handler: IHandler<_TContext>,
|
|
): void {
|
|
const matcher = this.matcherFactory(this.def);
|
|
this.registerRoute({
|
|
method: this.def.method,
|
|
matcher,
|
|
middlewares: this.mws,
|
|
handler: handler as unknown as IHandler<TContext>,
|
|
});
|
|
}
|
|
}
|