clear-router 2.5.11 → 2.5.13

package/dist/{router-DCGZNRNj.d.cts → router-DTI0BowV.d.cts}

@@ -9,8 +9,10 @@ declare class Response$2 {
   headers: Headers;
   sent: boolean;
   statusCode: number;
-  constructor(init?: Partial<Response$2>);
+  statusText: string;
+  constructor(init?: Partial<Response$2 | globalThis.Response>);
   status(code: number): this;
+  setStatusText(text: string): this;
   code(code: number): this;
   setHeader(name: string, value: string): this;
   header(name: string, value: string): this;
@@ -195,14 +197,25 @@ interface ClearRouterPluginRequestContext {
   ctx: any;
   request: Request$1;
   response: Response$2;
+  getBindings: () => Record<string, BindValue>;
   [key: string]: any;
 }
+interface ClearRouterPluginArgumentsContext extends ClearRouterPluginRequestContext {
+  target?: object;
+  method?: PropertyKey;
+  handler?: object;
+  metadata?: object;
+  tokens: BindToken[];
+  designTokens: BindToken[];
+}
 type PluginBindFactory<T = any> = (ctx: ClearRouterPluginRequestContext) => T | Promise<T>;
 type PluginBindValue<T = any> = BindValue<T> | PluginBindFactory<T>;
 type PluginBind = <T>(token: BindToken<T>, value: PluginBindValue<T>) => void;
+type PluginArgumentsResolver = (ctx: ClearRouterPluginArgumentsContext) => any[] | undefined | Promise<any[] | undefined>;
 interface ClearRouterPluginContext<Options = any> {
   container: typeof Container;
   bind: PluginBind;
+  resolveArguments: (resolver: PluginArgumentsResolver) => void;
   bindings: Record<string, BindValue>;
   configure: (options: RouterConfig) => void;
   configureDefaults: (options: RouterConfig) => void;
@@ -243,13 +256,15 @@ declare abstract class CoreRouter {
   private static readonly defaultConfigKey;
   private static readonly pluginStoreKey;
   private static readonly pluginPendingKey;
+  private static readonly pluginArgumentResolversKey;
   protected static createBaseConfig(): RouterConfig;
   protected static mergeConfig(target: RouterConfig, source?: RouterConfig): RouterConfig;
   protected static getDefaultConfig(): RouterConfig;
-  protected static resolveStateNamespace(this: any): string;
+  protected static resolveStateNamespace(): string;
   protected static getStateStore(): Record<string, any>;
   protected static getPluginStore(): Set<string>;
   protected static getPluginPendingStore(): Set<Promise<void>>;
+  protected static getPluginArgumentResolvers(): Set<PluginArgumentsResolver>;
   protected static createDefaultState(): {
     config: RouterConfig;
     groupContext: AsyncLocalStorage<{
@@ -263,10 +278,10 @@ declare abstract class CoreRouter {
     groupMiddlewares: any[];
     globalMiddlewares: any[];
   };
-  protected static bindStateAccessors(this: any): void;
+  protected static bindStateAccessors(): void;
   protected static createDefaultOptionsHandler(): any;
   static config: RouterConfig;
-  static configureDefaults(this: any, options?: RouterConfig): void;
+  static configureDefaults(options?: RouterConfig): void;
   /**
    * Use a registered plugin
    *
@@ -275,8 +290,8 @@ declare abstract class CoreRouter {
    * @param options
    * @returns
    */
-  static use<Options = any>(this: any, plugin: ClearRouterPluginInput<Options>, options?: Options): Promise<void>;
-  protected static pluginsReady(this: any): Promise<void>;
+  static use<Options = any>(plugin: ClearRouterPluginInput<Options>, options?: Options): Promise<void>;
+  protected static pluginsReady(): Promise<void>;
   protected static groupContext: AsyncLocalStorage<{
     prefix: string;
     groupMiddlewares: any[];
@@ -291,7 +306,8 @@ declare abstract class CoreRouter {
   protected static getCurrentPluginRequestContext(): ClearRouterPluginRequestContext | undefined;
   protected static createPluginRequestContext(ctx: any): ClearRouterPluginRequestContext;
   protected static createPluginBind(): PluginBind;
-  protected static ensureState(this: any): void;
+  protected static resolvePluginArguments(this: any, ctx: any, routeContext: Omit<ClearRouterPluginArgumentsContext, keyof ClearRouterPluginRequestContext>): Promise<any[] | undefined>;
+  protected static ensureState(): void;
   /**
    * Normalizes a path by ensuring it starts with a single slash and does not have trailing
    * slashes, while preserving dynamic segments and parameters.
@@ -308,7 +324,7 @@ declare abstract class CoreRouter {
    * @returns
    */
   static configure(this: any, options?: RouterConfig): void;
-  protected static resolveMethodOverride(this: any, method: string, headers: Headers | Record<string, any>, body: unknown): HttpMethod | null;
+  protected static resolveMethodOverride(method: string, headers: Headers | Record<string, any>, body: unknown): HttpMethod | null;
   /**
    * Adds a new route to the router.
    *
@@ -318,7 +334,7 @@ declare abstract class CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static add(this: any, methods: HttpMethod | HttpMethod[], path: string, handler: any, middlewares?: any[] | any): void;
+  static add(methods: HttpMethod | HttpMethod[], path: string, handler: any, middlewares?: any[] | any): void;
   /**
    * Define a resourceful API controller with standard CRUD routes.
    *
@@ -327,7 +343,7 @@ declare abstract class CoreRouter {
    * @param controller
    * @param options
    */
-  static apiResource(this: any, basePath: string, controller: any, options?: {
+  static apiResource(basePath: string, controller: any, options?: {
     only?: ControllerAction[];
     except?: ControllerAction[];
     middlewares?: ApiResourceMiddleware<any>;
@@ -340,7 +356,7 @@ declare abstract class CoreRouter {
    * @param handler       The handler function for the GET route.
    * @param middlewares   Optional middlewares to apply to the GET route.
    */
-  static get(this: any, path: string, handler: any, middlewares?: any[] | any): void;
+  static get(path: string, handler: any, middlewares?: any[] | any): void;
   /**
    * Adds a new POST route to the router.
    *
@@ -349,7 +365,7 @@ declare abstract class CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static post(this: any, path: string, handler: any, middlewares?: any[] | any): void;
+  static post(path: string, handler: any, middlewares?: any[] | any): void;
   /**
    * Adds a new PUT route to the router.
    *
@@ -358,7 +374,7 @@ declare abstract class CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static put(this: any, path: string, handler: any, middlewares?: any[] | any): void;
+  static put(path: string, handler: any, middlewares?: any[] | any): void;
   /**
    * Adds a new DELETE route to the router.
    *
@@ -367,7 +383,7 @@ declare abstract class CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static delete(this: any, path: string, handler: any, middlewares?: any[] | any): void;
+  static delete(path: string, handler: any, middlewares?: any[] | any): void;
   /**
    * Adds a new PATCH route to the router.
    *
@@ -376,7 +392,7 @@ declare abstract class CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static patch(this: any, path: string, handler: any, middlewares?: any[] | any): void;
+  static patch(path: string, handler: any, middlewares?: any[] | any): void;
   /**
    * Adds a new OPTIONS route to the router.
    *
@@ -385,7 +401,7 @@ declare abstract class CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static options(this: any, path: string, handler: any, middlewares?: any[] | any): void;
+  static options(path: string, handler: any, middlewares?: any[] | any): void;
   /**
    * Adds a new HEAD route to the router.
    *
@@ -394,7 +410,7 @@ declare abstract class CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static head(this: any, path: string, handler: any, middlewares?: any[] | any): void;
+  static head(path: string, handler: any, middlewares?: any[] | any): void;
   /**
    * Defines a group of routes with a common prefix.
    *
@@ -403,7 +419,7 @@ declare abstract class CoreRouter {
    * @param callback
    * @param middlewares
    */
-  static group(this: any, prefix: string, callback: () => void | Promise<void>, middlewares?: any[]): Promise<void>;
+  static group(prefix: string, callback: () => void | Promise<void>, middlewares?: any[]): Promise<void>;
   /**
    * Adds global middlewares to the router, which will be applied to all routes.
    *
@@ -411,24 +427,24 @@ declare abstract class CoreRouter {
    * @param middlewares
    * @param callback
    */
-  static middleware(this: any, middlewares: any[], callback: () => void): void;
+  static middleware(middlewares: any[], callback: () => void): void;
   /**
    * Retrieves all registered routes in the router, optionally organized by path or method
    * for easier access and management.
    *
    * @param this
    */
-  static allRoutes(this: any): Array<Route<any, any, any>>;
+  static allRoutes(): Array<Route<any, any, any>>;
   /**
    * @param this
    * @param type  - 'path' to get routes organized by path
    */
-  static allRoutes(this: any, type: 'path'): Record<string, Route<any, any, any>>;
+  static allRoutes(type: 'path'): Record<string, Route<any, any, any>>;
   /**
    * @param this
    * @param type  - 'method' to get routes organized by method
    */
-  static allRoutes(this: any, type: 'method'): { [method in Uppercase<HttpMethod>]?: Array<Route<any, any, any>> };
+  static allRoutes(type: 'method'): { [method in Uppercase<HttpMethod>]?: Array<Route<any, any, any>> };
   protected static resolveHandler(route: Route<any, any, any>): {
     handlerFunction: ((ctx: any, req: Request$1) => any | Promise<any>) | null;
     instance: Controller<any> | null;
@@ -437,7 +453,7 @@ declare abstract class CoreRouter {
     bindingHandler?: object;
     bindingMetadata?: object;
   };
-  protected static callHandler(this: any, handlerFunction: (ctx: any, req: Request$1) => any | Promise<any>, ctx: any, bindingTarget?: object, bindingMethod?: PropertyKey, bindingHandler?: object, bindingMetadata?: object): Promise<any>;
+  protected static callHandler(handlerFunction: (ctx: any, req: Request$1) => any | Promise<any>, ctx: any, bindingTarget?: object, bindingMethod?: PropertyKey, bindingHandler?: object, bindingMetadata?: object): Promise<any>;
   protected static bindRequestToInstance(ctx: any, instance: Controller<any> | Route<any, any, any> | null, route: Route<any, any, any>, payload: {
     body: Record<string, any>;
     query: Record<string, any>;
@@ -446,4 +462,4 @@ declare abstract class CoreRouter {
   }): void;
 }
 //#endregion
-export { HttpMethod as C, ControllerHandler as S, Handler$1 as _, ClearRouterPluginRequestContext as a, ApiResourceMiddleware as b, PluginBindValue as c, Request$1 as d, Route as f, Middleware as g, HttpContext as h, ClearRouterPluginInput as i, PluginSetupResult as l, Handler as m, ClearRouterPlugin as n, PluginBind as o, H3App as p, ClearRouterPluginContext as r, PluginBindFactory as s, CoreRouter as t, definePlugin as u, HttpContext$1 as v, Response$2 as w, ControllerAction as x, Middleware$1 as y };
+export { ControllerAction as C, Response$2 as E, ApiResourceMiddleware as S, HttpMethod as T, HttpContext as _, ClearRouterPluginInput as a, HttpContext$1 as b, PluginBind as c, PluginSetupResult as d, definePlugin as f, Handler as g, H3App as h, ClearRouterPluginContext as i, PluginBindFactory as l, Route as m, ClearRouterPlugin as n, ClearRouterPluginRequestContext as o, Request$1 as p, ClearRouterPluginArgumentsContext as r, PluginArgumentsResolver as s, CoreRouter as t, PluginBindValue as u, Middleware as v, ControllerHandler as w, Middleware$1 as x, Handler$1 as y };

package/dist/{router-BkYtqjYr.d.mts → router-DiKqUyvk.d.mts}

@@ -9,8 +9,10 @@ declare class Response$2 {
   headers: Headers;
   sent: boolean;
   statusCode: number;
-  constructor(init?: Partial<Response$2>);
+  statusText: string;
+  constructor(init?: Partial<Response$2 | globalThis.Response>);
   status(code: number): this;
+  setStatusText(text: string): this;
   code(code: number): this;
   setHeader(name: string, value: string): this;
   header(name: string, value: string): this;
@@ -195,14 +197,25 @@ interface ClearRouterPluginRequestContext {
   ctx: any;
   request: Request$1;
   response: Response$2;
+  getBindings: () => Record<string, BindValue>;
   [key: string]: any;
 }
+interface ClearRouterPluginArgumentsContext extends ClearRouterPluginRequestContext {
+  target?: object;
+  method?: PropertyKey;
+  handler?: object;
+  metadata?: object;
+  tokens: BindToken[];
+  designTokens: BindToken[];
+}
 type PluginBindFactory<T = any> = (ctx: ClearRouterPluginRequestContext) => T | Promise<T>;
 type PluginBindValue<T = any> = BindValue<T> | PluginBindFactory<T>;
 type PluginBind = <T>(token: BindToken<T>, value: PluginBindValue<T>) => void;
+type PluginArgumentsResolver = (ctx: ClearRouterPluginArgumentsContext) => any[] | undefined | Promise<any[] | undefined>;
 interface ClearRouterPluginContext<Options = any> {
   container: typeof Container;
   bind: PluginBind;
+  resolveArguments: (resolver: PluginArgumentsResolver) => void;
   bindings: Record<string, BindValue>;
   configure: (options: RouterConfig) => void;
   configureDefaults: (options: RouterConfig) => void;
@@ -243,13 +256,15 @@ declare abstract class CoreRouter {
   private static readonly defaultConfigKey;
   private static readonly pluginStoreKey;
   private static readonly pluginPendingKey;
+  private static readonly pluginArgumentResolversKey;
   protected static createBaseConfig(): RouterConfig;
   protected static mergeConfig(target: RouterConfig, source?: RouterConfig): RouterConfig;
   protected static getDefaultConfig(): RouterConfig;
-  protected static resolveStateNamespace(this: any): string;
+  protected static resolveStateNamespace(): string;
   protected static getStateStore(): Record<string, any>;
   protected static getPluginStore(): Set<string>;
   protected static getPluginPendingStore(): Set<Promise<void>>;
+  protected static getPluginArgumentResolvers(): Set<PluginArgumentsResolver>;
   protected static createDefaultState(): {
     config: RouterConfig;
     groupContext: AsyncLocalStorage<{
@@ -263,10 +278,10 @@ declare abstract class CoreRouter {
     groupMiddlewares: any[];
     globalMiddlewares: any[];
   };
-  protected static bindStateAccessors(this: any): void;
+  protected static bindStateAccessors(): void;
   protected static createDefaultOptionsHandler(): any;
   static config: RouterConfig;
-  static configureDefaults(this: any, options?: RouterConfig): void;
+  static configureDefaults(options?: RouterConfig): void;
   /**
    * Use a registered plugin
    *
@@ -275,8 +290,8 @@ declare abstract class CoreRouter {
    * @param options
    * @returns
    */
-  static use<Options = any>(this: any, plugin: ClearRouterPluginInput<Options>, options?: Options): Promise<void>;
-  protected static pluginsReady(this: any): Promise<void>;
+  static use<Options = any>(plugin: ClearRouterPluginInput<Options>, options?: Options): Promise<void>;
+  protected static pluginsReady(): Promise<void>;
   protected static groupContext: AsyncLocalStorage<{
     prefix: string;
     groupMiddlewares: any[];
@@ -291,7 +306,8 @@ declare abstract class CoreRouter {
   protected static getCurrentPluginRequestContext(): ClearRouterPluginRequestContext | undefined;
   protected static createPluginRequestContext(ctx: any): ClearRouterPluginRequestContext;
   protected static createPluginBind(): PluginBind;
-  protected static ensureState(this: any): void;
+  protected static resolvePluginArguments(this: any, ctx: any, routeContext: Omit<ClearRouterPluginArgumentsContext, keyof ClearRouterPluginRequestContext>): Promise<any[] | undefined>;
+  protected static ensureState(): void;
   /**
    * Normalizes a path by ensuring it starts with a single slash and does not have trailing
    * slashes, while preserving dynamic segments and parameters.
@@ -308,7 +324,7 @@ declare abstract class CoreRouter {
    * @returns
    */
   static configure(this: any, options?: RouterConfig): void;
-  protected static resolveMethodOverride(this: any, method: string, headers: Headers | Record<string, any>, body: unknown): HttpMethod | null;
+  protected static resolveMethodOverride(method: string, headers: Headers | Record<string, any>, body: unknown): HttpMethod | null;
   /**
    * Adds a new route to the router.
    *
@@ -318,7 +334,7 @@ declare abstract class CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static add(this: any, methods: HttpMethod | HttpMethod[], path: string, handler: any, middlewares?: any[] | any): void;
+  static add(methods: HttpMethod | HttpMethod[], path: string, handler: any, middlewares?: any[] | any): void;
   /**
    * Define a resourceful API controller with standard CRUD routes.
    *
@@ -327,7 +343,7 @@ declare abstract class CoreRouter {
    * @param controller
    * @param options
    */
-  static apiResource(this: any, basePath: string, controller: any, options?: {
+  static apiResource(basePath: string, controller: any, options?: {
     only?: ControllerAction[];
     except?: ControllerAction[];
     middlewares?: ApiResourceMiddleware<any>;
@@ -340,7 +356,7 @@ declare abstract class CoreRouter {
    * @param handler       The handler function for the GET route.
    * @param middlewares   Optional middlewares to apply to the GET route.
    */
-  static get(this: any, path: string, handler: any, middlewares?: any[] | any): void;
+  static get(path: string, handler: any, middlewares?: any[] | any): void;
   /**
    * Adds a new POST route to the router.
    *
@@ -349,7 +365,7 @@ declare abstract class CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static post(this: any, path: string, handler: any, middlewares?: any[] | any): void;
+  static post(path: string, handler: any, middlewares?: any[] | any): void;
   /**
    * Adds a new PUT route to the router.
    *
@@ -358,7 +374,7 @@ declare abstract class CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static put(this: any, path: string, handler: any, middlewares?: any[] | any): void;
+  static put(path: string, handler: any, middlewares?: any[] | any): void;
   /**
    * Adds a new DELETE route to the router.
    *
@@ -367,7 +383,7 @@ declare abstract class CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static delete(this: any, path: string, handler: any, middlewares?: any[] | any): void;
+  static delete(path: string, handler: any, middlewares?: any[] | any): void;
   /**
    * Adds a new PATCH route to the router.
    *
@@ -376,7 +392,7 @@ declare abstract class CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static patch(this: any, path: string, handler: any, middlewares?: any[] | any): void;
+  static patch(path: string, handler: any, middlewares?: any[] | any): void;
   /**
    * Adds a new OPTIONS route to the router.
    *
@@ -385,7 +401,7 @@ declare abstract class CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static options(this: any, path: string, handler: any, middlewares?: any[] | any): void;
+  static options(path: string, handler: any, middlewares?: any[] | any): void;
   /**
    * Adds a new HEAD route to the router.
    *
@@ -394,7 +410,7 @@ declare abstract class CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static head(this: any, path: string, handler: any, middlewares?: any[] | any): void;
+  static head(path: string, handler: any, middlewares?: any[] | any): void;
   /**
    * Defines a group of routes with a common prefix.
    *
@@ -403,7 +419,7 @@ declare abstract class CoreRouter {
    * @param callback
    * @param middlewares
    */
-  static group(this: any, prefix: string, callback: () => void | Promise<void>, middlewares?: any[]): Promise<void>;
+  static group(prefix: string, callback: () => void | Promise<void>, middlewares?: any[]): Promise<void>;
   /**
    * Adds global middlewares to the router, which will be applied to all routes.
    *
@@ -411,24 +427,24 @@ declare abstract class CoreRouter {
    * @param middlewares
    * @param callback
    */
-  static middleware(this: any, middlewares: any[], callback: () => void): void;
+  static middleware(middlewares: any[], callback: () => void): void;
   /**
    * Retrieves all registered routes in the router, optionally organized by path or method
    * for easier access and management.
    *
    * @param this
    */
-  static allRoutes(this: any): Array<Route<any, any, any>>;
+  static allRoutes(): Array<Route<any, any, any>>;
   /**
    * @param this
    * @param type  - 'path' to get routes organized by path
    */
-  static allRoutes(this: any, type: 'path'): Record<string, Route<any, any, any>>;
+  static allRoutes(type: 'path'): Record<string, Route<any, any, any>>;
   /**
    * @param this
    * @param type  - 'method' to get routes organized by method
    */
-  static allRoutes(this: any, type: 'method'): { [method in Uppercase<HttpMethod>]?: Array<Route<any, any, any>> };
+  static allRoutes(type: 'method'): { [method in Uppercase<HttpMethod>]?: Array<Route<any, any, any>> };
   protected static resolveHandler(route: Route<any, any, any>): {
     handlerFunction: ((ctx: any, req: Request$1) => any | Promise<any>) | null;
     instance: Controller<any> | null;
@@ -437,7 +453,7 @@ declare abstract class CoreRouter {
     bindingHandler?: object;
     bindingMetadata?: object;
   };
-  protected static callHandler(this: any, handlerFunction: (ctx: any, req: Request$1) => any | Promise<any>, ctx: any, bindingTarget?: object, bindingMethod?: PropertyKey, bindingHandler?: object, bindingMetadata?: object): Promise<any>;
+  protected static callHandler(handlerFunction: (ctx: any, req: Request$1) => any | Promise<any>, ctx: any, bindingTarget?: object, bindingMethod?: PropertyKey, bindingHandler?: object, bindingMetadata?: object): Promise<any>;
   protected static bindRequestToInstance(ctx: any, instance: Controller<any> | Route<any, any, any> | null, route: Route<any, any, any>, payload: {
     body: Record<string, any>;
     query: Record<string, any>;
@@ -446,4 +462,4 @@ declare abstract class CoreRouter {
   }): void;
 }
 //#endregion
-export { HttpMethod as C, ControllerHandler as S, Handler$1 as _, ClearRouterPluginRequestContext as a, ApiResourceMiddleware as b, PluginBindValue as c, Request$1 as d, Route as f, Middleware as g, HttpContext as h, ClearRouterPluginInput as i, PluginSetupResult as l, Handler as m, ClearRouterPlugin as n, PluginBind as o, H3App as p, ClearRouterPluginContext as r, PluginBindFactory as s, CoreRouter as t, definePlugin as u, HttpContext$1 as v, Response$2 as w, ControllerAction as x, Middleware$1 as y };
+export { ControllerAction as C, Response$2 as E, ApiResourceMiddleware as S, HttpMethod as T, HttpContext as _, ClearRouterPluginInput as a, HttpContext$1 as b, PluginBind as c, PluginSetupResult as d, definePlugin as f, Handler as g, H3App as h, ClearRouterPluginContext as i, PluginBindFactory as l, Route as m, ClearRouterPlugin as n, ClearRouterPluginRequestContext as o, Request$1 as p, ClearRouterPluginArgumentsContext as r, PluginArgumentsResolver as s, CoreRouter as t, PluginBindValue as u, Middleware as v, ControllerHandler as w, Middleware$1 as x, Handler$1 as y };

package/dist/types/core/Response.d.mts

@@ -4,8 +4,10 @@ declare class Response {
   headers: Headers;
   sent: boolean;
   statusCode: number;
-  constructor(init?: Partial<Response>);
+  statusText: string;
+  constructor(init?: Partial<Response | globalThis.Response>);
   status(code: number): this;
+  setStatusText(text: string): this;
   code(code: number): this;
   setHeader(name: string, value: string): this;
   header(name: string, value: string): this;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clear-router",
-  "version": "2.5.11",
+  "version": "2.5.13",
   "description": "Laravel-style routing for Node.js with support for Express, H3, Fastify, Hono, and Koa, including CommonJS, ESM, and TypeScript support.",
   "keywords": [
     "h3",