clear-router 2.9.0 → 2.9.1

package/README.md

@@ -95,7 +95,21 @@ See [API.md](https://arkstack-hq.github.io/clear-router/api) for complete API do
 ## Middleware Execution Order
 
 ```txt
-[ Global Middleware ] → [ Group Middleware ] → [ Route Middleware ]
+[ Global Middleware ] → [ Group Middleware ] → [ @middleware (class) ] → [ @middleware (method) ] → [ Route Middleware ]
+```
+
+Controllers and controller methods can declare middleware with the `@middleware`
+decorator, accepting the same shapes as any other middleware (callbacks,
+middleware classes, or instances exposing a `handle` method):
+
+```ts
+import { middleware } from 'clear-router/decorators';
+
+@middleware([auth])
+class AccountController {
+  @middleware(GuestMiddleware)
+  create() {}
+}
 ```
 
 ## Handler Execution

package/dist/core/CoreRouter.cjs

@@ -3,6 +3,7 @@ const require_RouteGroup = require('../RouteGroup.cjs');
 const require_RouteRegistrar = require('../RouteRegistrar.cjs');
 const require_Request = require('./Request.cjs');
 const require_Response = require('./Response.cjs');
+const require_middleware = require('../decorators/middleware.cjs');
 const require_bindings = require('./bindings.cjs');
 const require_ResourceRoutes = require('../ResourceRoutes.cjs');
 let node_async_hooks = require("node:async_hooks");
@@ -790,6 +791,7 @@ var CoreRouter = class {
 		const route = new require_Route.Route(methods.includes("options") ? methods : methods.concat("options"), fullPath, handler, this.resolveMiddlewares([
 			...this.globalMiddlewares,
 			...activeGroupMiddlewares,
+			...require_middleware.getControllerMiddlewares(handler),
 			...middlewares || []
 		]), {
 			registrationPaths,

package/dist/core/CoreRouter.mjs

@@ -3,6 +3,7 @@ import { RouteGroup } from "../RouteGroup.mjs";
 import { RouteRegistrar } from "../RouteRegistrar.mjs";
 import { Request } from "./Request.mjs";
 import { Response } from "./Response.mjs";
+import { getControllerMiddlewares } from "../decorators/middleware.mjs";
 import { Container, getBindingMetadataFromTargets, getDesignParamTypes, getStandardMetadata, isClass } from "./bindings.mjs";
 import { ResourceRoutes } from "../ResourceRoutes.mjs";
 import { createRequire } from "node:module";
@@ -790,6 +791,7 @@ var CoreRouter = class {
 		const route = new Route(methods.includes("options") ? methods : methods.concat("options"), fullPath, handler, this.resolveMiddlewares([
 			...this.globalMiddlewares,
 			...activeGroupMiddlewares,
+			...getControllerMiddlewares(handler),
 			...middlewares || []
 		]), {
 			registrationPaths,

package/dist/core/index.cjs

@@ -4,6 +4,7 @@ const require_RouteGroup = require('../RouteGroup.cjs');
 const require_Request = require('./Request.cjs');
 const require_Response = require('./Response.cjs');
 const require_plugins = require('./plugins.cjs');
+const require_middleware = require('../decorators/middleware.cjs');
 const require_CoreRouter = require('./CoreRouter.cjs');
 
 exports.CoreRouter = require_CoreRouter.CoreRouter;
@@ -11,5 +12,7 @@ exports.Request = require_Request.Request;
 exports.Response = require_Response.Response;
 exports.RouteGroup = require_RouteGroup.RouteGroup;
 exports.definePlugin = require_plugins.definePlugin;
+exports.getControllerMiddlewares = require_middleware.getControllerMiddlewares;
 exports.importFile = require_helpers.importFile;
+exports.middleware = require_middleware.middleware;
 exports.wrap = require_helpers.wrap;

package/dist/core/index.d.cts

@@ -1,7 +1,8 @@
 import { Response } from "./Response.cjs";
 import { Request } from "./Request.cjs";
 import { ClearRouterPlugin, ClearRouterPluginArgumentsContext, ClearRouterPluginContext, ClearRouterPluginInput, ClearRouterPluginRequestContext, PluginArgumentsResolver, PluginBind, PluginBindFactory, PluginBindValue, PluginSetupResult, definePlugin } from "./plugins.cjs";
+import { MiddlewareDecorator, MiddlewareInput, getControllerMiddlewares, middleware } from "../decorators/middleware.cjs";
 import { RouteGroup } from "../RouteGroup.cjs";
 import { CoreRouter } from "./CoreRouter.cjs";
 import { importFile, wrap } from "./helpers.cjs";
-export { ClearRouterPlugin, ClearRouterPluginArgumentsContext, ClearRouterPluginContext, ClearRouterPluginInput, ClearRouterPluginRequestContext, CoreRouter, PluginArgumentsResolver, PluginBind, PluginBindFactory, PluginBindValue, PluginSetupResult, Request, Response, RouteGroup, definePlugin, importFile, wrap };
+export { ClearRouterPlugin, ClearRouterPluginArgumentsContext, ClearRouterPluginContext, ClearRouterPluginInput, ClearRouterPluginRequestContext, CoreRouter, MiddlewareDecorator, MiddlewareInput, PluginArgumentsResolver, PluginBind, PluginBindFactory, PluginBindValue, PluginSetupResult, Request, Response, RouteGroup, definePlugin, getControllerMiddlewares, importFile, middleware, wrap };

package/dist/core/index.d.mts

@@ -1,7 +1,8 @@
 import { Response } from "./Response.mjs";
 import { Request } from "./Request.mjs";
 import { ClearRouterPlugin, ClearRouterPluginArgumentsContext, ClearRouterPluginContext, ClearRouterPluginInput, ClearRouterPluginRequestContext, PluginArgumentsResolver, PluginBind, PluginBindFactory, PluginBindValue, PluginSetupResult, definePlugin } from "./plugins.mjs";
+import { MiddlewareDecorator, MiddlewareInput, getControllerMiddlewares, middleware } from "../decorators/middleware.mjs";
 import { RouteGroup } from "../RouteGroup.mjs";
 import { CoreRouter } from "./CoreRouter.mjs";
 import { importFile, wrap } from "./helpers.mjs";
-export { ClearRouterPlugin, ClearRouterPluginArgumentsContext, ClearRouterPluginContext, ClearRouterPluginInput, ClearRouterPluginRequestContext, CoreRouter, PluginArgumentsResolver, PluginBind, PluginBindFactory, PluginBindValue, PluginSetupResult, Request, Response, RouteGroup, definePlugin, importFile, wrap };
+export { ClearRouterPlugin, ClearRouterPluginArgumentsContext, ClearRouterPluginContext, ClearRouterPluginInput, ClearRouterPluginRequestContext, CoreRouter, MiddlewareDecorator, MiddlewareInput, PluginArgumentsResolver, PluginBind, PluginBindFactory, PluginBindValue, PluginSetupResult, Request, Response, RouteGroup, definePlugin, getControllerMiddlewares, importFile, middleware, wrap };

package/dist/core/index.mjs

@@ -3,6 +3,7 @@ import { RouteGroup } from "../RouteGroup.mjs";
 import { Request } from "./Request.mjs";
 import { Response } from "./Response.mjs";
 import { definePlugin } from "./plugins.mjs";
+import { getControllerMiddlewares, middleware } from "../decorators/middleware.mjs";
 import { CoreRouter } from "./CoreRouter.mjs";
 
-export { CoreRouter, Request, Response, RouteGroup, definePlugin, importFile, wrap };
+export { CoreRouter, Request, Response, RouteGroup, definePlugin, getControllerMiddlewares, importFile, middleware, wrap };

package/dist/decorators/index.cjs

@@ -1,5 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_middleware = require('./middleware.cjs');
 const require_bindings = require('../core/bindings.cjs');
 
 exports.Bind = require_bindings.Bind;
-exports.Container = require_bindings.Container;
+exports.Container = require_bindings.Container;
+exports.getControllerMiddlewares = require_middleware.getControllerMiddlewares;
+exports.middleware = require_middleware.middleware;

package/dist/decorators/index.d.cts

@@ -1,2 +1,3 @@
 import { Bind, BindDecorator, BindFactory, BindToken, BindValue, Container } from "../core/bindings.cjs";
-export { Bind, type BindDecorator, type BindFactory, type BindToken, type BindValue, Container };
+import { MiddlewareDecorator, MiddlewareInput, getControllerMiddlewares, middleware } from "./middleware.cjs";
+export { Bind, type BindDecorator, type BindFactory, type BindToken, type BindValue, Container, type MiddlewareDecorator, type MiddlewareInput, getControllerMiddlewares, middleware };

package/dist/decorators/index.d.mts

@@ -1,2 +1,3 @@
 import { Bind, BindDecorator, BindFactory, BindToken, BindValue, Container } from "../core/bindings.mjs";
-export { Bind, type BindDecorator, type BindFactory, type BindToken, type BindValue, Container };
+import { MiddlewareDecorator, MiddlewareInput, getControllerMiddlewares, middleware } from "./middleware.mjs";
+export { Bind, type BindDecorator, type BindFactory, type BindToken, type BindValue, Container, type MiddlewareDecorator, type MiddlewareInput, getControllerMiddlewares, middleware };

package/dist/decorators/index.mjs

@@ -1,3 +1,4 @@
+import { getControllerMiddlewares, middleware } from "./middleware.mjs";
 import { Bind, Container } from "../core/bindings.mjs";
 
-export { Bind, Container };
+export { Bind, Container, getControllerMiddlewares, middleware };

package/dist/decorators/middleware.cjs

@@ -0,0 +1,100 @@
+
+//#region src/decorators/middleware.ts
+const CLASS_KEY = "__class__";
+const metadataKey = Symbol.for("clear-router:middleware-metadata");
+const store = /* @__PURE__ */ new WeakMap();
+/**
+* Attach one or more middleware to a controller class or a controller method.
+*
+* @example
+* ```ts
+* @Middleware([auth])
+* class AccountController {}
+*
+* class LoginController {
+*     @Middleware(GuestMiddleware)
+*     create () {}
+* }
+* ```
+*
+* Accepts the middleware variadically or as arrays, and every supported
+* middleware shape: callbacks, middleware classes, or instances exposing a
+* `handle` method.
+*
+* @param middlewares
+* @returns
+*/
+function middleware(...middlewares) {
+	const flattened = middlewares.flat();
+	return ((target, propertyKeyOrContext) => {
+		if (isStandardClassContext(propertyKeyOrContext)) {
+			setClassMiddlewareMetadata(target, flattened);
+			setStandardMetadata(propertyKeyOrContext.metadata, CLASS_KEY, flattened);
+			return;
+		}
+		if (isStandardMethodContext(propertyKeyOrContext)) {
+			setStandardMetadata(propertyKeyOrContext.metadata, propertyKeyOrContext.name, flattened);
+			return;
+		}
+		if (typeof propertyKeyOrContext === "undefined") {
+			setClassMiddlewareMetadata(target, flattened);
+			return;
+		}
+		setMiddlewareMetadata(target, propertyKeyOrContext, flattened);
+	});
+}
+/**
+* Collect the decorator-declared middleware for a controller route handler,
+* ordered class-level first then method-level. Returns an empty array for
+* non-controller (callback) handlers or handlers without any decorators.
+*
+* @param handler
+* @returns
+*/
+function getControllerMiddlewares(handler) {
+	if (!Array.isArray(handler) || handler.length !== 2) return [];
+	const [controller, method] = handler;
+	if (!controller) return [];
+	const constructor = typeof controller === "function" ? controller : controller.constructor;
+	const prototype = typeof controller === "function" ? controller.prototype : Object.getPrototypeOf(controller);
+	const standardMetadata = constructor?.[Symbol.metadata];
+	const classMiddlewares = getMiddlewareMetadata(constructor, CLASS_KEY) ?? getMiddlewareMetadata(prototype, CLASS_KEY) ?? getStandardMetadata(standardMetadata, CLASS_KEY) ?? [];
+	const methodMiddlewares = getMiddlewareMetadata(prototype, method) ?? getMiddlewareMetadata(constructor, method) ?? getStandardMetadata(standardMetadata, method) ?? [];
+	return [...classMiddlewares, ...methodMiddlewares];
+}
+function setClassMiddlewareMetadata(target, middlewares) {
+	setMiddlewareMetadata(target, CLASS_KEY, middlewares);
+	const prototype = target.prototype;
+	if (prototype) setMiddlewareMetadata(prototype, CLASS_KEY, middlewares);
+}
+function setMiddlewareMetadata(target, propertyKey, middlewares) {
+	const map = store.get(target) ?? /* @__PURE__ */ new Map();
+	const existing = map.get(propertyKey);
+	map.set(propertyKey, existing ? [...existing, ...middlewares] : middlewares);
+	store.set(target, map);
+}
+function getMiddlewareMetadata(target, propertyKey) {
+	if (!target) return void 0;
+	return store.get(target)?.get(propertyKey);
+}
+function setStandardMetadata(metadata, propertyKey, middlewares) {
+	if (!metadata) return;
+	const record = metadata;
+	record[metadataKey] = record[metadataKey] ?? {};
+	const existing = record[metadataKey][propertyKey];
+	record[metadataKey][propertyKey] = existing ? [...existing, ...middlewares] : middlewares;
+}
+function getStandardMetadata(metadata, propertyKey) {
+	const record = metadata && metadata[metadataKey];
+	return record ? record[propertyKey] : void 0;
+}
+function isStandardMethodContext(value) {
+	return Boolean(value && typeof value === "object" && value.kind === "method" && typeof value.name !== "undefined");
+}
+function isStandardClassContext(value) {
+	return Boolean(value && typeof value === "object" && value.kind === "class" && typeof value.name !== "undefined");
+}
+
+//#endregion
+exports.getControllerMiddlewares = getControllerMiddlewares;
+exports.middleware = middleware;

package/dist/decorators/middleware.d.cts

@@ -0,0 +1,51 @@
+import { ClassMiddleware, MiddlewareHandle } from "../types/basic.cjs";
+
+//#region src/decorators/middleware.d.ts
+/**
+ * Any value accepted as a middleware by the router: a plain callback, a class
+ * exposing a `handle` method, or an already-instantiated object exposing one.
+ */
+type MiddlewareInput = MiddlewareHandle | ClassMiddleware;
+/**
+ * Decorator produced by {@link Middleware}. Works both as a class decorator (to
+ * apply the middleware to every action of a controller) and as a method
+ * decorator (to apply it to a single action). Supports the legacy
+ * (`experimentalDecorators`) and TC39 standard decorator signatures.
+ */
+type MiddlewareDecorator = MethodDecorator & ClassDecorator & {
+  <This, Value extends (this: This, ...args: any[]) => any>(value: Value, context: ClassMethodDecoratorContext<This, Value>): void | Value;
+  <Value extends abstract new (...args: any[]) => any>(value: Value, context: ClassDecoratorContext<Value>): void | Value;
+};
+/**
+ * Attach one or more middleware to a controller class or a controller method.
+ *
+ * @example
+ * ```ts
+ * @Middleware([auth])
+ * class AccountController {}
+ *
+ * class LoginController {
+ *     @Middleware(GuestMiddleware)
+ *     create () {}
+ * }
+ * ```
+ *
+ * Accepts the middleware variadically or as arrays, and every supported
+ * middleware shape: callbacks, middleware classes, or instances exposing a
+ * `handle` method.
+ *
+ * @param middlewares
+ * @returns
+ */
+declare function middleware(...middlewares: Array<MiddlewareInput | MiddlewareInput[]>): MiddlewareDecorator;
+/**
+ * Collect the decorator-declared middleware for a controller route handler,
+ * ordered class-level first then method-level. Returns an empty array for
+ * non-controller (callback) handlers or handlers without any decorators.
+ *
+ * @param handler
+ * @returns
+ */
+declare function getControllerMiddlewares(handler: any): MiddlewareInput[];
+//#endregion
+export { MiddlewareDecorator, MiddlewareInput, getControllerMiddlewares, middleware };

package/dist/decorators/middleware.d.mts

@@ -0,0 +1,51 @@
+import { ClassMiddleware, MiddlewareHandle } from "../types/basic.mjs";
+
+//#region src/decorators/middleware.d.ts
+/**
+ * Any value accepted as a middleware by the router: a plain callback, a class
+ * exposing a `handle` method, or an already-instantiated object exposing one.
+ */
+type MiddlewareInput = MiddlewareHandle | ClassMiddleware;
+/**
+ * Decorator produced by {@link Middleware}. Works both as a class decorator (to
+ * apply the middleware to every action of a controller) and as a method
+ * decorator (to apply it to a single action). Supports the legacy
+ * (`experimentalDecorators`) and TC39 standard decorator signatures.
+ */
+type MiddlewareDecorator = MethodDecorator & ClassDecorator & {
+  <This, Value extends (this: This, ...args: any[]) => any>(value: Value, context: ClassMethodDecoratorContext<This, Value>): void | Value;
+  <Value extends abstract new (...args: any[]) => any>(value: Value, context: ClassDecoratorContext<Value>): void | Value;
+};
+/**
+ * Attach one or more middleware to a controller class or a controller method.
+ *
+ * @example
+ * ```ts
+ * @Middleware([auth])
+ * class AccountController {}
+ *
+ * class LoginController {
+ *     @Middleware(GuestMiddleware)
+ *     create () {}
+ * }
+ * ```
+ *
+ * Accepts the middleware variadically or as arrays, and every supported
+ * middleware shape: callbacks, middleware classes, or instances exposing a
+ * `handle` method.
+ *
+ * @param middlewares
+ * @returns
+ */
+declare function middleware(...middlewares: Array<MiddlewareInput | MiddlewareInput[]>): MiddlewareDecorator;
+/**
+ * Collect the decorator-declared middleware for a controller route handler,
+ * ordered class-level first then method-level. Returns an empty array for
+ * non-controller (callback) handlers or handlers without any decorators.
+ *
+ * @param handler
+ * @returns
+ */
+declare function getControllerMiddlewares(handler: any): MiddlewareInput[];
+//#endregion
+export { MiddlewareDecorator, MiddlewareInput, getControllerMiddlewares, middleware };

package/dist/decorators/middleware.mjs

@@ -0,0 +1,98 @@
+//#region src/decorators/middleware.ts
+const CLASS_KEY = "__class__";
+const metadataKey = Symbol.for("clear-router:middleware-metadata");
+const store = /* @__PURE__ */ new WeakMap();
+/**
+* Attach one or more middleware to a controller class or a controller method.
+*
+* @example
+* ```ts
+* @Middleware([auth])
+* class AccountController {}
+*
+* class LoginController {
+*     @Middleware(GuestMiddleware)
+*     create () {}
+* }
+* ```
+*
+* Accepts the middleware variadically or as arrays, and every supported
+* middleware shape: callbacks, middleware classes, or instances exposing a
+* `handle` method.
+*
+* @param middlewares
+* @returns
+*/
+function middleware(...middlewares) {
+	const flattened = middlewares.flat();
+	return ((target, propertyKeyOrContext) => {
+		if (isStandardClassContext(propertyKeyOrContext)) {
+			setClassMiddlewareMetadata(target, flattened);
+			setStandardMetadata(propertyKeyOrContext.metadata, CLASS_KEY, flattened);
+			return;
+		}
+		if (isStandardMethodContext(propertyKeyOrContext)) {
+			setStandardMetadata(propertyKeyOrContext.metadata, propertyKeyOrContext.name, flattened);
+			return;
+		}
+		if (typeof propertyKeyOrContext === "undefined") {
+			setClassMiddlewareMetadata(target, flattened);
+			return;
+		}
+		setMiddlewareMetadata(target, propertyKeyOrContext, flattened);
+	});
+}
+/**
+* Collect the decorator-declared middleware for a controller route handler,
+* ordered class-level first then method-level. Returns an empty array for
+* non-controller (callback) handlers or handlers without any decorators.
+*
+* @param handler
+* @returns
+*/
+function getControllerMiddlewares(handler) {
+	if (!Array.isArray(handler) || handler.length !== 2) return [];
+	const [controller, method] = handler;
+	if (!controller) return [];
+	const constructor = typeof controller === "function" ? controller : controller.constructor;
+	const prototype = typeof controller === "function" ? controller.prototype : Object.getPrototypeOf(controller);
+	const standardMetadata = constructor?.[Symbol.metadata];
+	const classMiddlewares = getMiddlewareMetadata(constructor, CLASS_KEY) ?? getMiddlewareMetadata(prototype, CLASS_KEY) ?? getStandardMetadata(standardMetadata, CLASS_KEY) ?? [];
+	const methodMiddlewares = getMiddlewareMetadata(prototype, method) ?? getMiddlewareMetadata(constructor, method) ?? getStandardMetadata(standardMetadata, method) ?? [];
+	return [...classMiddlewares, ...methodMiddlewares];
+}
+function setClassMiddlewareMetadata(target, middlewares) {
+	setMiddlewareMetadata(target, CLASS_KEY, middlewares);
+	const prototype = target.prototype;
+	if (prototype) setMiddlewareMetadata(prototype, CLASS_KEY, middlewares);
+}
+function setMiddlewareMetadata(target, propertyKey, middlewares) {
+	const map = store.get(target) ?? /* @__PURE__ */ new Map();
+	const existing = map.get(propertyKey);
+	map.set(propertyKey, existing ? [...existing, ...middlewares] : middlewares);
+	store.set(target, map);
+}
+function getMiddlewareMetadata(target, propertyKey) {
+	if (!target) return void 0;
+	return store.get(target)?.get(propertyKey);
+}
+function setStandardMetadata(metadata, propertyKey, middlewares) {
+	if (!metadata) return;
+	const record = metadata;
+	record[metadataKey] = record[metadataKey] ?? {};
+	const existing = record[metadataKey][propertyKey];
+	record[metadataKey][propertyKey] = existing ? [...existing, ...middlewares] : middlewares;
+}
+function getStandardMetadata(metadata, propertyKey) {
+	const record = metadata && metadata[metadataKey];
+	return record ? record[propertyKey] : void 0;
+}
+function isStandardMethodContext(value) {
+	return Boolean(value && typeof value === "object" && value.kind === "method" && typeof value.name !== "undefined");
+}
+function isStandardClassContext(value) {
+	return Boolean(value && typeof value === "object" && value.kind === "class" && typeof value.name !== "undefined");
+}
+
+//#endregion
+export { getControllerMiddlewares, middleware };

package/dist/decorators/setup.cjs

@@ -1,4 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_middleware = require('./middleware.cjs');
 const require_bindings = require('../core/bindings.cjs');
 const require_CoreRouter = require('../core/CoreRouter.cjs');
 require('./index.cjs');
@@ -12,4 +13,6 @@ require_CoreRouter.CoreRouter.configureDefaults({ container: {
 
 //#endregion
 exports.Bind = require_bindings.Bind;
-exports.Container = require_bindings.Container;
+exports.Container = require_bindings.Container;
+exports.getControllerMiddlewares = require_middleware.getControllerMiddlewares;
+exports.middleware = require_middleware.middleware;

package/dist/decorators/setup.d.cts

@@ -1,2 +1,3 @@
 import { Bind, BindDecorator, BindFactory, BindToken, BindValue, Container } from "../core/bindings.cjs";
-export { Bind, BindDecorator, BindFactory, BindToken, BindValue, Container };
+import { MiddlewareDecorator, MiddlewareInput, getControllerMiddlewares, middleware } from "./middleware.cjs";
+export { Bind, BindDecorator, BindFactory, BindToken, BindValue, Container, MiddlewareDecorator, MiddlewareInput, getControllerMiddlewares, middleware };

package/dist/decorators/setup.d.mts

@@ -1,2 +1,3 @@
 import { Bind, BindDecorator, BindFactory, BindToken, BindValue, Container } from "../core/bindings.mjs";
-export { Bind, BindDecorator, BindFactory, BindToken, BindValue, Container };
+import { MiddlewareDecorator, MiddlewareInput, getControllerMiddlewares, middleware } from "./middleware.mjs";
+export { Bind, BindDecorator, BindFactory, BindToken, BindValue, Container, MiddlewareDecorator, MiddlewareInput, getControllerMiddlewares, middleware };

package/dist/decorators/setup.mjs

@@ -1,3 +1,4 @@
+import { getControllerMiddlewares, middleware } from "./middleware.mjs";
 import { Bind, Container } from "../core/bindings.mjs";
 import { CoreRouter } from "../core/CoreRouter.mjs";
 import "./index.mjs";
@@ -10,4 +11,4 @@ CoreRouter.configureDefaults({ container: {
 } });
 
 //#endregion
-export { Bind, Container };
+export { Bind, Container, getControllerMiddlewares, middleware };

package/dist/index.cjs

@@ -8,6 +8,7 @@ const require_RouteRegistrar = require('./RouteRegistrar.cjs');
 const require_Request = require('./core/Request.cjs');
 const require_Response = require('./core/Response.cjs');
 const require_plugins = require('./core/plugins.cjs');
+const require_middleware = require('./decorators/middleware.cjs');
 const require_CoreRouter = require('./core/CoreRouter.cjs');
 require('./core/index.cjs');
 
@@ -20,6 +21,8 @@ exports.Route = require_Route.Route;
 exports.RouteGroup = require_RouteGroup.RouteGroup;
 exports.RouteRegistrar = require_RouteRegistrar.RouteRegistrar;
 exports.definePlugin = require_plugins.definePlugin;
+exports.getControllerMiddlewares = require_middleware.getControllerMiddlewares;
 exports.importFile = require_helpers.importFile;
+exports.middleware = require_middleware.middleware;
 exports.parseDomainParameters = require_Route.parseDomainParameters;
 exports.wrap = require_helpers.wrap;

package/dist/index.d.cts

@@ -4,9 +4,10 @@ import { ClearRequest } from "./ClearRequest.cjs";
 import { Route, parseDomainParameters } from "./Route.cjs";
 import { Request } from "./core/Request.cjs";
 import { ClearRouterPlugin, ClearRouterPluginArgumentsContext, ClearRouterPluginContext, ClearRouterPluginInput, ClearRouterPluginRequestContext, PluginArgumentsResolver, PluginBind, PluginBindFactory, PluginBindValue, PluginSetupResult, definePlugin } from "./core/plugins.cjs";
+import { MiddlewareDecorator, MiddlewareInput, getControllerMiddlewares, middleware } from "./decorators/middleware.cjs";
 import { Controller } from "./Controller.cjs";
 import { RouteGroup } from "./RouteGroup.cjs";
 import { RouteRegistrar, RouteRegistrarGroupFactory } from "./RouteRegistrar.cjs";
 import { CoreRouter } from "./core/CoreRouter.cjs";
 import { importFile, wrap } from "./core/helpers.cjs";
-export { ClearHttpContext, ClearRequest, ClearRouterPlugin, ClearRouterPluginArgumentsContext, ClearRouterPluginContext, ClearRouterPluginInput, ClearRouterPluginRequestContext, Controller, CoreRouter, PluginArgumentsResolver, PluginBind, PluginBindFactory, PluginBindValue, PluginSetupResult, Request, Response, Route, RouteGroup, RouteParameter, RouteRegistrar, RouteRegistrarGroupFactory, definePlugin, importFile, parseDomainParameters, wrap };
+export { ClearHttpContext, ClearRequest, ClearRouterPlugin, ClearRouterPluginArgumentsContext, ClearRouterPluginContext, ClearRouterPluginInput, ClearRouterPluginRequestContext, Controller, CoreRouter, MiddlewareDecorator, MiddlewareInput, PluginArgumentsResolver, PluginBind, PluginBindFactory, PluginBindValue, PluginSetupResult, Request, Response, Route, RouteGroup, RouteParameter, RouteRegistrar, RouteRegistrarGroupFactory, definePlugin, getControllerMiddlewares, importFile, middleware, parseDomainParameters, wrap };

package/dist/index.d.mts

@@ -4,9 +4,10 @@ import { ClearRequest } from "./ClearRequest.mjs";
 import { Route, parseDomainParameters } from "./Route.mjs";
 import { Request } from "./core/Request.mjs";
 import { ClearRouterPlugin, ClearRouterPluginArgumentsContext, ClearRouterPluginContext, ClearRouterPluginInput, ClearRouterPluginRequestContext, PluginArgumentsResolver, PluginBind, PluginBindFactory, PluginBindValue, PluginSetupResult, definePlugin } from "./core/plugins.mjs";
+import { MiddlewareDecorator, MiddlewareInput, getControllerMiddlewares, middleware } from "./decorators/middleware.mjs";
 import { Controller } from "./Controller.mjs";
 import { RouteGroup } from "./RouteGroup.mjs";
 import { RouteRegistrar, RouteRegistrarGroupFactory } from "./RouteRegistrar.mjs";
 import { CoreRouter } from "./core/CoreRouter.mjs";
 import { importFile, wrap } from "./core/helpers.mjs";
-export { ClearHttpContext, ClearRequest, ClearRouterPlugin, ClearRouterPluginArgumentsContext, ClearRouterPluginContext, ClearRouterPluginInput, ClearRouterPluginRequestContext, Controller, CoreRouter, PluginArgumentsResolver, PluginBind, PluginBindFactory, PluginBindValue, PluginSetupResult, Request, Response, Route, RouteGroup, RouteParameter, RouteRegistrar, RouteRegistrarGroupFactory, definePlugin, importFile, parseDomainParameters, wrap };
+export { ClearHttpContext, ClearRequest, ClearRouterPlugin, ClearRouterPluginArgumentsContext, ClearRouterPluginContext, ClearRouterPluginInput, ClearRouterPluginRequestContext, Controller, CoreRouter, MiddlewareDecorator, MiddlewareInput, PluginArgumentsResolver, PluginBind, PluginBindFactory, PluginBindValue, PluginSetupResult, Request, Response, Route, RouteGroup, RouteParameter, RouteRegistrar, RouteRegistrarGroupFactory, definePlugin, getControllerMiddlewares, importFile, middleware, parseDomainParameters, wrap };

package/dist/index.mjs

@@ -7,7 +7,8 @@ import { RouteRegistrar } from "./RouteRegistrar.mjs";
 import { Request } from "./core/Request.mjs";
 import { Response } from "./core/Response.mjs";
 import { definePlugin } from "./core/plugins.mjs";
+import { getControllerMiddlewares, middleware } from "./decorators/middleware.mjs";
 import { CoreRouter } from "./core/CoreRouter.mjs";
 import "./core/index.mjs";
 
-export { ClearRequest, Controller, CoreRouter, Request, Response, Route, RouteGroup, RouteRegistrar, definePlugin, importFile, parseDomainParameters, wrap };
+export { ClearRequest, Controller, CoreRouter, Request, Response, Route, RouteGroup, RouteRegistrar, definePlugin, getControllerMiddlewares, importFile, middleware, parseDomainParameters, wrap };

package/package.json

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