@e22m4u/ts-rest-router 0.5.1 → 0.5.3

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@e22m4u/ts-rest-router",
-  "version": "0.5.1",
-  "description": "REST маршрутизатор на основе контроллеров для TypeScript",
+  "version": "0.5.3",
+  "description": "Декларативный REST-маршрутизатор на основе контроллеров для TypeScript",
   "author": "Mikhail Evstropov <e22m4u@yandex.ru>",
   "license": "MIT",
   "keywords": [
@@ -41,18 +41,18 @@
     "prepare": "husky"
   },
   "dependencies": {
-    "@e22m4u/js-debug": "~0.2.2",
+    "@e22m4u/js-debug": "~0.2.3",
     "@e22m4u/js-format": "~0.2.0",
-    "@e22m4u/js-service": "~0.3.7",
-    "@e22m4u/js-trie-router": "~0.1.4",
-    "@e22m4u/ts-data-schema": "~0.3.1",
+    "@e22m4u/js-service": "~0.3.8",
+    "@e22m4u/js-trie-router": "~0.2.1",
+    "@e22m4u/ts-data-schema": "~0.4.2",
     "@e22m4u/ts-reflector": "~0.1.7",
     "http-errors": "~2.0.0"
   },
   "devDependencies": {
     "@commitlint/cli": "~19.8.1",
     "@commitlint/config-conventional": "~19.8.1",
-    "@eslint/js": "~9.35.0",
+    "@eslint/js": "~9.36.0",
     "@types/chai": "~5.2.2",
     "@types/debug": "~4.1.12",
     "@types/http-errors": "~2.0.5",
@@ -61,7 +61,7 @@
     "c8": "~10.1.3",
     "chai": "~6.0.1",
     "esbuild": "~0.25.10",
-    "eslint": "~9.35.0",
+    "eslint": "~9.36.0",
     "eslint-config-prettier": "~10.1.8",
     "eslint-plugin-chai-expect": "~3.1.0",
     "eslint-plugin-mocha": "~11.1.0",
@@ -71,6 +71,6 @@
     "rimraf": "~6.0.1",
     "tsx": "~4.20.5",
     "typescript": "~5.9.2",
-    "typescript-eslint": "~8.44.0"
+    "typescript-eslint": "~8.44.1"
   }
 }

package/src/controller-registry.spec.ts

@@ -2,7 +2,7 @@
 import {
   createRequestMock,
   createResponseMock,
-  HookName,
+  HookType,
   HttpMethod,
   ParsedCookie,
   ParsedHeaders,
@@ -180,7 +180,7 @@ describe('ControllerRegistry', function () {
         });
         const matching = routeReg.matchRouteByRequest(req);
         expect(matching).to.be.not.empty;
-        const res = matching!.route.hookRegistry.getHooks(HookName.PRE_HANDLER);
+        const res = matching!.route.hookRegistry.getHooks(HookType.PRE_HANDLER);
         expect(res).to.be.eql([PRE_HANDLER_1]);
       });
 
@@ -200,7 +200,7 @@ describe('ControllerRegistry', function () {
         });
         const matching = routeReg.matchRouteByRequest(req);
         expect(matching).to.be.not.empty;
-        const res = matching!.route.hookRegistry.getHooks(HookName.PRE_HANDLER);
+        const res = matching!.route.hookRegistry.getHooks(HookType.PRE_HANDLER);
         expect(res).to.be.eql([PRE_HANDLER_1]);
       });
 
@@ -220,7 +220,7 @@ describe('ControllerRegistry', function () {
         });
         const matching = routeReg.matchRouteByRequest(req);
         expect(matching).to.be.not.empty;
-        const res = matching!.route.hookRegistry.getHooks(HookName.PRE_HANDLER);
+        const res = matching!.route.hookRegistry.getHooks(HookType.PRE_HANDLER);
         expect(res).to.be.eql([PRE_HANDLER_1]);
       });
 
@@ -239,7 +239,7 @@ describe('ControllerRegistry', function () {
         });
         const matching = routeReg.matchRouteByRequest(req);
         expect(matching).to.be.not.empty;
-        const res = matching!.route.hookRegistry.getHooks(HookName.PRE_HANDLER);
+        const res = matching!.route.hookRegistry.getHooks(HookType.PRE_HANDLER);
         expect(res).to.be.eql([PRE_HANDLER_1]);
       });
 
@@ -258,7 +258,7 @@ describe('ControllerRegistry', function () {
         });
         const matching = routeReg.matchRouteByRequest(req);
         expect(matching).to.be.not.empty;
-        const res = matching!.route.hookRegistry.getHooks(HookName.PRE_HANDLER);
+        const res = matching!.route.hookRegistry.getHooks(HookType.PRE_HANDLER);
         expect(res).to.be.eql([PRE_HANDLER_1]);
       });
     });
@@ -281,7 +281,7 @@ describe('ControllerRegistry', function () {
         });
         const matching = routeReg.matchRouteByRequest(req);
         expect(matching).to.be.not.empty;
-        const res = matching!.route.hookRegistry.getHooks(HookName.PRE_HANDLER);
+        const res = matching!.route.hookRegistry.getHooks(HookType.PRE_HANDLER);
         expect(res).to.be.eql([PRE_HANDLER_1, PRE_HANDLER_2]);
       });
 
@@ -301,7 +301,7 @@ describe('ControllerRegistry', function () {
         });
         const matching = routeReg.matchRouteByRequest(req);
         expect(matching).to.be.not.empty;
-        const res = matching!.route.hookRegistry.getHooks(HookName.PRE_HANDLER);
+        const res = matching!.route.hookRegistry.getHooks(HookType.PRE_HANDLER);
         expect(res).to.be.eql([PRE_HANDLER_1, PRE_HANDLER_2]);
       });
 
@@ -321,7 +321,7 @@ describe('ControllerRegistry', function () {
         });
         const matching = routeReg.matchRouteByRequest(req);
         expect(matching).to.be.not.empty;
-        const res = matching!.route.hookRegistry.getHooks(HookName.PRE_HANDLER);
+        const res = matching!.route.hookRegistry.getHooks(HookType.PRE_HANDLER);
         expect(res).to.be.eql([PRE_HANDLER_1, PRE_HANDLER_2]);
       });
 
@@ -342,7 +342,7 @@ describe('ControllerRegistry', function () {
         });
         const matching = routeReg.matchRouteByRequest(req);
         expect(matching).to.be.not.empty;
-        const res = matching!.route.hookRegistry.getHooks(HookName.PRE_HANDLER);
+        const res = matching!.route.hookRegistry.getHooks(HookType.PRE_HANDLER);
         expect(res).to.be.eql([PRE_HANDLER_1, PRE_HANDLER_2]);
       });
 
@@ -363,7 +363,7 @@ describe('ControllerRegistry', function () {
         });
         const matching = routeReg.matchRouteByRequest(req);
         expect(matching).to.be.not.empty;
-        const res = matching!.route.hookRegistry.getHooks(HookName.PRE_HANDLER);
+        const res = matching!.route.hookRegistry.getHooks(HookType.PRE_HANDLER);
         expect(res).to.be.eql([PRE_HANDLER_1, PRE_HANDLER_2]);
       });
     });
@@ -385,7 +385,7 @@ describe('ControllerRegistry', function () {
         const matching = routeReg.matchRouteByRequest(req);
         expect(matching).to.be.not.empty;
         const res = matching!.route.hookRegistry.getHooks(
-          HookName.POST_HANDLER,
+          HookType.POST_HANDLER,
         );
         expect(res).to.be.eql([POST_HANDLER_1]);
       });
@@ -407,7 +407,7 @@ describe('ControllerRegistry', function () {
         const matching = routeReg.matchRouteByRequest(req);
         expect(matching).to.be.not.empty;
         const res = matching!.route.hookRegistry.getHooks(
-          HookName.POST_HANDLER,
+          HookType.POST_HANDLER,
         );
         expect(res).to.be.eql([POST_HANDLER_1]);
       });
@@ -429,7 +429,7 @@ describe('ControllerRegistry', function () {
         const matching = routeReg.matchRouteByRequest(req);
         expect(matching).to.be.not.empty;
         const res = matching!.route.hookRegistry.getHooks(
-          HookName.POST_HANDLER,
+          HookType.POST_HANDLER,
         );
         expect(res).to.be.eql([POST_HANDLER_1]);
       });
@@ -450,7 +450,7 @@ describe('ControllerRegistry', function () {
         const matching = routeReg.matchRouteByRequest(req);
         expect(matching).to.be.not.empty;
         const res = matching!.route.hookRegistry.getHooks(
-          HookName.POST_HANDLER,
+          HookType.POST_HANDLER,
         );
         expect(res).to.be.eql([POST_HANDLER_1]);
       });
@@ -471,7 +471,7 @@ describe('ControllerRegistry', function () {
         const matching = routeReg.matchRouteByRequest(req);
         expect(matching).to.be.not.empty;
         const res = matching!.route.hookRegistry.getHooks(
-          HookName.POST_HANDLER,
+          HookType.POST_HANDLER,
         );
         expect(res).to.be.eql([POST_HANDLER_1]);
       });
@@ -496,7 +496,7 @@ describe('ControllerRegistry', function () {
         const matching = routeReg.matchRouteByRequest(req);
         expect(matching).to.be.not.empty;
         const res = matching!.route.hookRegistry.getHooks(
-          HookName.POST_HANDLER,
+          HookType.POST_HANDLER,
         );
         expect(res).to.be.eql([POST_HANDLER_1, POST_HANDLER_2]);
       });
@@ -518,7 +518,7 @@ describe('ControllerRegistry', function () {
         const matching = routeReg.matchRouteByRequest(req);
         expect(matching).to.be.not.empty;
         const res = matching!.route.hookRegistry.getHooks(
-          HookName.POST_HANDLER,
+          HookType.POST_HANDLER,
         );
         expect(res).to.be.eql([POST_HANDLER_1, POST_HANDLER_2]);
       });
@@ -540,7 +540,7 @@ describe('ControllerRegistry', function () {
         const matching = routeReg.matchRouteByRequest(req);
         expect(matching).to.be.not.empty;
         const res = matching!.route.hookRegistry.getHooks(
-          HookName.POST_HANDLER,
+          HookType.POST_HANDLER,
         );
         expect(res).to.be.eql([POST_HANDLER_1, POST_HANDLER_2]);
       });
@@ -563,7 +563,7 @@ describe('ControllerRegistry', function () {
         const matching = routeReg.matchRouteByRequest(req);
         expect(matching).to.be.not.empty;
         const res = matching!.route.hookRegistry.getHooks(
-          HookName.POST_HANDLER,
+          HookType.POST_HANDLER,
         );
         expect(res).to.be.eql([POST_HANDLER_1, POST_HANDLER_2]);
       });
@@ -586,7 +586,7 @@ describe('ControllerRegistry', function () {
         const matching = routeReg.matchRouteByRequest(req);
         expect(matching).to.be.not.empty;
         const res = matching!.route.hookRegistry.getHooks(
-          HookName.POST_HANDLER,
+          HookType.POST_HANDLER,
         );
         expect(res).to.be.eql([POST_HANDLER_1, POST_HANDLER_2]);
       });

package/src/controller-registry.ts

@@ -62,7 +62,7 @@ export class ControllerRegistry extends DebuggableService {
     // заметить ошибку в коде, который использует
     // интерфейс данного сервиса
     if (this.hasController(ctor))
-      throw new Errorf('The controller %v is already registered.');
+      throw new Errorf('The controller %v is already registered.', ctor.name);
     // так как контроллером может быть любой
     // класс, выполняется проверка на наличие
     // метаданных применяемых декоратором
@@ -237,10 +237,10 @@ export class ControllerRegistry extends DebuggableService {
     let preHandlers: RoutePreHandler[] = [];
     const mdArray = BeforeActionReflector.getMetadata(ctor, actionName);
     mdArray.forEach(md => {
-      if (Array.isArray(md.middleware)) {
-        preHandlers = [...preHandlers, ...md.middleware];
+      if (Array.isArray(md.hook)) {
+        preHandlers = [...preHandlers, ...md.hook];
       } else {
-        preHandlers.push(md.middleware);
+        preHandlers.push(md.hook);
       }
     });
     if (mdArray.length) {
@@ -271,10 +271,10 @@ export class ControllerRegistry extends DebuggableService {
     let res: RoutePostHandler[] = [];
     const mdArray = AfterActionReflector.getMetadata(ctor, actionName);
     mdArray.forEach(md => {
-      if (Array.isArray(md.middleware)) {
-        res = [...res, ...md.middleware];
+      if (Array.isArray(md.hook)) {
+        res = [...res, ...md.hook];
       } else {
-        res.push(md.middleware);
+        res.push(md.hook);
       }
     });
     if (mdArray.length) {
@@ -366,7 +366,7 @@ export class ControllerRegistry extends DebuggableService {
     let res: RoutePostHandler[] = [];
     if (actionMd.after)
       res = Array.isArray(actionMd.after) ? actionMd.after : [actionMd.after];
-    debug('%v pre-handlers found.', res.length);
+    debug('%v post-handlers found.', res.length);
     return res;
   }
 

package/src/decorators/after-action/after-action-decorator.spec.ts

@@ -3,88 +3,85 @@ import {expect} from 'chai';
 import {afterAction} from './after-action-decorator.js';
 import {AfterActionReflector} from './after-action-reflector.js';
 
-const MIDDLEWARE_1 = () => undefined;
-const MIDDLEWARE_2 = () => undefined;
-const MIDDLEWARE_3 = () => undefined;
+const HOOK_1 = () => undefined;
+const HOOK_2 = () => undefined;
+const HOOK_3 = () => undefined;
 
 describe('afterAction', function () {
   describe('class target', function () {
-    it('sets given middleware to the target metadata', function () {
-      @afterAction(MIDDLEWARE_1)
+    it('sets given hook to the target metadata', function () {
+      @afterAction(HOOK_1)
       class Target {
         method() {}
       }
       const res = AfterActionReflector.getMetadata(Target);
-      expect(res).to.be.eql([{middleware: MIDDLEWARE_1}]);
+      expect(res).to.be.eql([{hook: HOOK_1}]);
     });
 
-    it('sets multiple middlewares to the target metadata', function () {
-      @afterAction([MIDDLEWARE_1, MIDDLEWARE_2])
+    it('sets multiple hooks to the target metadata', function () {
+      @afterAction([HOOK_1, HOOK_2])
       class Target {
         method() {}
       }
       const res = AfterActionReflector.getMetadata(Target);
-      expect(res).to.be.eql([{middleware: [MIDDLEWARE_1, MIDDLEWARE_2]}]);
+      expect(res).to.be.eql([{hook: [HOOK_1, HOOK_2]}]);
     });
 
     it('allows to use the decorator multiple times', function () {
-      @afterAction(MIDDLEWARE_1)
-      @afterAction([MIDDLEWARE_2, MIDDLEWARE_3])
+      @afterAction(HOOK_1)
+      @afterAction([HOOK_2, HOOK_3])
       class Target {
         method() {}
       }
       const res = AfterActionReflector.getMetadata(Target);
-      expect(res).to.be.eql([
-        {middleware: MIDDLEWARE_1},
-        {middleware: [MIDDLEWARE_2, MIDDLEWARE_3]},
-      ]);
+      expect(res).to.be.eql([{hook: HOOK_1}, {hook: [HOOK_2, HOOK_3]}]);
     });
   });
 
   describe('method target', function () {
-    it('sets given middleware to the target metadata', function () {
+    it('sets given hook to the target metadata', function () {
       class Target {
-        @afterAction(MIDDLEWARE_1)
+        @afterAction(HOOK_1)
         method() {}
       }
       const res = AfterActionReflector.getMetadata(Target, 'method');
       expect(res).to.be.eql([
         {
           propertyKey: 'method',
-          middleware: MIDDLEWARE_1,
+          hook: HOOK_1,
         },
       ]);
     });
 
-    it('sets multiple middlewares to the target metadata', function () {
+    it('sets multiple hooks to the target metadata', function () {
       class Target {
-        @afterAction([MIDDLEWARE_1, MIDDLEWARE_2])
+        @afterAction([HOOK_1, HOOK_2])
         method() {}
       }
       const res = AfterActionReflector.getMetadata(Target, 'method');
       expect(res).to.be.eql([
         {
           propertyKey: 'method',
-          middleware: [MIDDLEWARE_1, MIDDLEWARE_2],
+          hook: [HOOK_1, HOOK_2],
         },
       ]);
     });
 
     it('allows to use the decorator multiple times', function () {
       class Target {
-        @afterAction(MIDDLEWARE_1)
-        @afterAction([MIDDLEWARE_2, MIDDLEWARE_3])
+        @afterAction(HOOK_1)
+        @afterAction([HOOK_2, HOOK_3])
         method() {}
       }
       const res = AfterActionReflector.getMetadata(Target, 'method');
       expect(res).to.be.eql([
         {
           propertyKey: 'method',
-          middleware: MIDDLEWARE_1,
+          hook: HOOK_1,
         },
         {
           propertyKey: 'method',
-          middleware: [MIDDLEWARE_2, MIDDLEWARE_3],
+          hook: [HOOK_2, HOOK_3],
         },
       ]);
     });

package/src/decorators/after-action/after-action-decorator.ts

@@ -8,10 +8,10 @@ import {AfterActionReflector} from './after-action-reflector.js';
 /**
  * After action decorator.
  *
- * @param middleware
+ * @param hook
  */
 export function afterAction<T extends object>(
-  middleware: AfterActionMetadata['middleware'],
+  hook: AfterActionMetadata['hook'],
 ) {
   return function (
     target: Constructor<T> | Prototype<T>,
@@ -24,10 +24,10 @@ export function afterAction<T extends object>(
       descriptor,
     );
     if (decoratorType === DecoratorTargetType.CONSTRUCTOR) {
-      AfterActionReflector.addMetadata({middleware}, target as Constructor<T>);
+      AfterActionReflector.addMetadata({hook}, target as Constructor<T>);
     } else if (decoratorType === DecoratorTargetType.INSTANCE_METHOD) {
       AfterActionReflector.addMetadata(
-        {propertyKey, middleware},
+        {propertyKey, hook},
         target.constructor as Constructor<T>,
         propertyKey,
       );

package/src/decorators/after-action/after-action-metadata.ts

@@ -6,7 +6,7 @@ import {RoutePostHandler} from '@e22m4u/js-trie-router';
  */
 export type AfterActionMetadata = {
   propertyKey?: string;
-  middleware: RoutePostHandler | RoutePostHandler[];
+  hook: RoutePostHandler | RoutePostHandler[];
 };
 
 /**

package/src/decorators/after-action/after-action-reflector.spec.ts

@@ -3,17 +3,17 @@ import {Reflector} from '@e22m4u/ts-reflector';
 import {AfterActionReflector} from './after-action-reflector.js';
 import {AFTER_ACTION_METADATA_KEY} from './after-action-metadata.js';
 
-const MIDDLEWARE_1 = () => undefined;
-const MIDDLEWARE_2 = () => undefined;
-const MIDDLEWARE_3 = () => undefined;
+const HOOK_1 = () => undefined;
+const HOOK_2 = () => undefined;
+const HOOK_3 = () => undefined;
 
 describe('AfterActionReflector', function () {
   describe('class target', function () {
     describe('addMetadata', function () {
       it('adds a given value to the target metadata', function () {
         class Target {}
-        const md1 = {middleware: MIDDLEWARE_1};
-        const md2 = {middleware: [MIDDLEWARE_2, MIDDLEWARE_3]};
+        const md1 = {hook: HOOK_1};
+        const md2 = {hook: [HOOK_2, HOOK_3]};
         AfterActionReflector.addMetadata(md1, Target);
         AfterActionReflector.addMetadata(md2, Target);
         const res = Reflector.getOwnMetadata(AFTER_ACTION_METADATA_KEY, Target);
@@ -30,8 +30,8 @@ describe('AfterActionReflector', function () {
 
       it('returns existing metadata by the target', function () {
         class Target {}
-        const md1 = {middleware: MIDDLEWARE_1};
-        const md2 = {middleware: [MIDDLEWARE_2, MIDDLEWARE_3]};
+        const md1 = {hook: HOOK_1};
+        const md2 = {hook: [HOOK_2, HOOK_3]};
         const mdArray = [md1, md2];
         Reflector.defineMetadata(AFTER_ACTION_METADATA_KEY, mdArray, Target);
         const res = AfterActionReflector.getMetadata(Target);
@@ -44,8 +44,8 @@ describe('AfterActionReflector', function () {
     describe('addMetadata', function () {
       it('adds a given value to the target metadata', function () {
         class Target {}
-        const md1 = {middleware: MIDDLEWARE_1};
-        const md2 = {middleware: [MIDDLEWARE_2, MIDDLEWARE_3]};
+        const md1 = {hook: HOOK_1};
+        const md2 = {hook: [HOOK_2, HOOK_3]};
         AfterActionReflector.addMetadata(md1, Target, 'prop');
         AfterActionReflector.addMetadata(md2, Target, 'prop');
         const res = Reflector.getOwnMetadata(
@@ -66,8 +66,8 @@ describe('AfterActionReflector', function () {
 
       it('returns existing metadata by the target', function () {
         class Target {}
-        const md1 = {middleware: MIDDLEWARE_1};
-        const md2 = {middleware: [MIDDLEWARE_2, MIDDLEWARE_3]};
+        const md1 = {hook: HOOK_1};
+        const md2 = {hook: [HOOK_2, HOOK_3]};
         const mdArray = [md1, md2];
         Reflector.defineMetadata(
           AFTER_ACTION_METADATA_KEY,
@@ -84,8 +84,8 @@ describe('AfterActionReflector', function () {
   describe('addMetadata', function () {
     it('can distinguish class and method metadata', function () {
       class Target {}
-      const md1 = {middleware: MIDDLEWARE_1};
-      const md2 = {middleware: MIDDLEWARE_2};
+      const md1 = {hook: HOOK_1};
+      const md2 = {hook: HOOK_2};
       AfterActionReflector.addMetadata(md1, Target);
       AfterActionReflector.addMetadata(md2, Target, 'prop');
       const res1 = Reflector.getOwnMetadata(AFTER_ACTION_METADATA_KEY, Target);
@@ -102,8 +102,8 @@ describe('AfterActionReflector', function () {
   describe('getMetadata', function () {
     it('can distinguish class and method metadata', function () {
       class Target {}
-      const md1 = {middleware: MIDDLEWARE_1};
-      const md2 = {middleware: MIDDLEWARE_2};
+      const md1 = {hook: HOOK_1};
+      const md2 = {hook: HOOK_2};
       Reflector.defineMetadata(AFTER_ACTION_METADATA_KEY, [md1], Target);
       Reflector.defineMetadata(
         AFTER_ACTION_METADATA_KEY,

package/src/decorators/before-action/before-action-decorator.spec.ts

@@ -3,88 +3,85 @@ import {expect} from 'chai';
 import {beforeAction} from './before-action-decorator.js';
 import {BeforeActionReflector} from './before-action-reflector.js';
 
-const MIDDLEWARE_1 = () => undefined;
-const MIDDLEWARE_2 = () => undefined;
-const MIDDLEWARE_3 = () => undefined;
+const HOOK_1 = () => undefined;
+const HOOK_2 = () => undefined;
+const HOOK_3 = () => undefined;
 
 describe('beforeAction', function () {
   describe('class target', function () {
-    it('sets given middleware to the target metadata', function () {
-      @beforeAction(MIDDLEWARE_1)
+    it('sets given hook to the target metadata', function () {
+      @beforeAction(HOOK_1)
       class Target {
         method() {}
       }
       const res = BeforeActionReflector.getMetadata(Target);
-      expect(res).to.be.eql([{middleware: MIDDLEWARE_1}]);
+      expect(res).to.be.eql([{hook: HOOK_1}]);
     });
 
-    it('sets multiple middlewares to the target metadata', function () {
-      @beforeAction([MIDDLEWARE_1, MIDDLEWARE_2])
+    it('sets multiple hooks to the target metadata', function () {
+      @beforeAction([HOOK_1, HOOK_2])
       class Target {
         method() {}
       }
       const res = BeforeActionReflector.getMetadata(Target);
-      expect(res).to.be.eql([{middleware: [MIDDLEWARE_1, MIDDLEWARE_2]}]);
+      expect(res).to.be.eql([{hook: [HOOK_1, HOOK_2]}]);
     });
 
     it('allows to use the decorator multiple times', function () {
-      @beforeAction(MIDDLEWARE_1)
-      @beforeAction([MIDDLEWARE_2, MIDDLEWARE_3])
+      @beforeAction(HOOK_1)
+      @beforeAction([HOOK_2, HOOK_3])
       class Target {
         method() {}
       }
       const res = BeforeActionReflector.getMetadata(Target);
-      expect(res).to.be.eql([
-        {middleware: MIDDLEWARE_1},
-        {middleware: [MIDDLEWARE_2, MIDDLEWARE_3]},
-      ]);
+      expect(res).to.be.eql([{hook: HOOK_1}, {hook: [HOOK_2, HOOK_3]}]);
     });
   });
 
   describe('method target', function () {
-    it('sets given middleware to the target metadata', function () {
+    it('sets given hook to the target metadata', function () {
       class Target {
-        @beforeAction(MIDDLEWARE_1)
+        @beforeAction(HOOK_1)
         method() {}
       }
       const res = BeforeActionReflector.getMetadata(Target, 'method');
       expect(res).to.be.eql([
         {
           propertyKey: 'method',
-          middleware: MIDDLEWARE_1,
+          hook: HOOK_1,
         },
       ]);
     });
 
-    it('sets multiple middlewares to the target metadata', function () {
+    it('sets multiple hooks to the target metadata', function () {
       class Target {
-        @beforeAction([MIDDLEWARE_1, MIDDLEWARE_2])
+        @beforeAction([HOOK_1, HOOK_2])
         method() {}
       }
       const res = BeforeActionReflector.getMetadata(Target, 'method');
       expect(res).to.be.eql([
         {
           propertyKey: 'method',
-          middleware: [MIDDLEWARE_1, MIDDLEWARE_2],
+          hook: [HOOK_1, HOOK_2],
         },
       ]);
     });
 
     it('allows to use the decorator multiple times', function () {
       class Target {
-        @beforeAction(MIDDLEWARE_1)
-        @beforeAction([MIDDLEWARE_2, MIDDLEWARE_3])
+        @beforeAction(HOOK_1)
+        @beforeAction([HOOK_2, HOOK_3])
         method() {}
       }
       const res = BeforeActionReflector.getMetadata(Target, 'method');
       expect(res).to.be.eql([
         {
           propertyKey: 'method',
-          middleware: MIDDLEWARE_1,
+          hook: HOOK_1,
         },
         {
           propertyKey: 'method',
-          middleware: [MIDDLEWARE_2, MIDDLEWARE_3],
+          hook: [HOOK_2, HOOK_3],
         },
       ]);
     });

package/src/decorators/before-action/before-action-decorator.ts

@@ -8,10 +8,10 @@ import {BeforeActionReflector} from './before-action-reflector.js';
 /**
  * Before action decorator.
  *
- * @param middleware
+ * @param hook
  */
 export function beforeAction<T extends object>(
-  middleware: BeforeActionMetadata['middleware'],
+  hook: BeforeActionMetadata['hook'],
 ) {
   return function (
     target: Constructor<T> | Prototype<T>,
@@ -24,10 +24,10 @@ export function beforeAction<T extends object>(
       descriptor,
     );
     if (decoratorType === DecoratorTargetType.CONSTRUCTOR) {
-      BeforeActionReflector.addMetadata({middleware}, target as Constructor<T>);
+      BeforeActionReflector.addMetadata({hook}, target as Constructor<T>);
     } else if (decoratorType === DecoratorTargetType.INSTANCE_METHOD) {
       BeforeActionReflector.addMetadata(
-        {propertyKey, middleware},
+        {propertyKey, hook},
         target.constructor as Constructor<T>,
         propertyKey,
       );

package/src/decorators/before-action/before-action-metadata.ts

@@ -6,7 +6,7 @@ import {RoutePreHandler} from '@e22m4u/js-trie-router';
  */
 export type BeforeActionMetadata = {
   propertyKey?: string;
-  middleware: RoutePreHandler | RoutePreHandler[];
+  hook: RoutePreHandler | RoutePreHandler[];
 };
 
 /**