import { type Middleware, type SpecialNextParam, convertToMiddleware } from '../middlewares/shared.js'; import { MiddlewareComposite } from '../middlewares/composite-sync.js'; import { MiddlewareRoute, type Routable, type RouteBuilder, type RouteBuilderArguments } from './route.js'; import { each } from '../each.js'; import type { UriTemplate } from '../uri-template/index.js'; export interface RouterOptions { caseSensitive?: boolean; mergeParams?: boolean; strict?: boolean; length?: number; separator?: string; name?: string; } export type Routes = { [key: string]: ((...args: T) => TReturnType) | Routes }; export type ParamCallback = (req, paramVal: unknown, name: string, ...rest) => Promise; /** * Use routes. * @param {Routes} routes - The routes. * @param {MiddlewareComposite & { route: RouteBuilder }} [parent] - The parent middleware composite. * @returns {MiddlewareComposite} The middleware composite. */ export function useRoutes(routes: Routes, parent?: MiddlewareComposite & { route: RouteBuilder }): MiddlewareComposite { if (!parent) parent = Object.assign(new MiddlewareComposite('byroutes'), { route(...args: RouteBuilderArguments) { return new MiddlewareRoute(...args) } }); each(routes, (route: ((...args: T) => TReturnType) | Routes, match) => { if (typeof match == 'number') return; const routed = new MiddlewareRoute(match as string); if (typeof (route) == 'object') { useRoutes(route, routed); } else routed.useMiddleware(convertToMiddleware(route)); parent.useMiddleware(routed); }); return parent; } /** * Router class. * @template T * @extends {MiddlewareComposite} * @implements {Middleware} */ export class Router }, ...unknown[]], TSpecialNextParam extends SpecialNextParam = SpecialNextParam> extends MiddlewareComposite implements Middleware { /** * Creates an instance of Router. * @param {RouterOptions} [options] - The router options. */ constructor(options?: RouterOptions) { super(options && options.name); } /** * Creates a new route. * @param {...RouteBuilderArguments} args - The route builder arguments. * @returns {MiddlewareRoute} The middleware route. */ public route(...args: RouteBuilderArguments): MiddlewareRoute { return new MiddlewareRoute(...args); } /** * Uses routes. * @param {Routes} routes - The routes. * @returns {this} The router instance. */ public useRoutes(routes: Routes): this { useRoutes(routes, this); return this; } /** * Uses middleware. * @param {string | UriTemplate} route - The route. * @param {...Middleware} middlewares - The middlewares. * @returns {this} The router instance. */ public useMiddleware(route: string | UriTemplate, ...middlewares: Middleware[]): this public useMiddleware(...middlewares: Middleware[]): this public useMiddleware(route: string | UriTemplate | Middleware, ...middlewares: Middleware[]): this { if (typeof route === 'string' || Array.isArray(route)) { const routed = new MiddlewareRoute(route); routed.useMiddleware(...middlewares); super.useMiddleware(routed); } else super.useMiddleware(route, ...middlewares); return this; } /** * Uses middleware. * @param {string | UriTemplate} route - The route. * @param {...((...args: T) => unknown)} middlewares - The middlewares. * @returns {this} The router instance. */ public use(route: string | UriTemplate, ...middlewares: ((...args: T) => unknown)[]): this public use(...middlewares: ((...args: T) => unknown)[]): this public use(route: string | UriTemplate | ((...args: T) => unknown), ...middlewares: ((...args: T) => unknown)[]): this { if (typeof route === 'string' || Array.isArray(route)) { const routed = new MiddlewareRoute(route); routed.use(...middlewares); super.useMiddleware(routed); return this; } else return super.use(route, ...middlewares); } } // // create Router#VERB functions // methods.concat('all').forEach(function (method) // { // Router.prototype[method] = function (path) // { // var route = this.route(path) // route[method].apply(route, slice.call(arguments, 1)) // return this // } // })