deco-express 0.1.5 → 0.2.0

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { Express, RequestHandler } from 'express';
+import { RequestHandler, Express } from 'express';
 import Joi from 'joi';
 
 /**
@@ -34,19 +34,24 @@ declare function Route(method: keyof Express, path?: string, ...middleware: Requ
  * and is prepended to every route path registered by {@link Route} decorators
  * on the class's methods.
  *
+ * Controller-level middleware is stored under the `"controllerMiddleware"` key
+ * and is prepended to every route handler in the controller.
+ *
  * @param baseRoute - The base path prefix for all routes in the controller
  *   (e.g. `"/users"`). Defaults to `""` (no prefix).
+ * @param middleware - Zero or more Express middleware functions that are
+ *   executed **before** every route handler in the controller.
  *
  * @example
  * ```ts
- * \@Controller('/users')
+ * \@Controller('/users', authMiddleware)
  * class UserController {
  *   \@Route('get', '/:id')
  *   getUser(req: Request, res: Response) { ... }
  * }
  * ```
  */
-declare function Controller(baseRoute?: string): (target: object) => void;
+declare function Controller(baseRoute?: string, ...middleware: RequestHandler[]): (target: object) => void;
 
 /**
  * Method decorator that validates `req.body` against a Joi schema before the
@@ -91,8 +96,10 @@ type Constructor<T = object> = new (...args: unknown[]) => T;
  * For each controller the function:
  * 1. Instantiates the class with `new`.
  * 2. Reads the `"baseRoute"` metadata set by {@link Controller}.
- * 3. Reads the `"routeHandlers"` metadata set by {@link Route}.
- * 4. Mounts each handler at the resolved full path on the Express app.
+ * 3. Reads the `"controllerMiddleware"` metadata set by {@link Controller}.
+ * 4. Reads the `"routeHandlers"` metadata set by {@link Route}.
+ * 5. Mounts each handler at the resolved full path on the Express app,
+ *    with controller-level middleware prepended to each route's handlers.
  *
  * The full path is built as:
  * ```
@@ -105,6 +112,8 @@ type Constructor<T = object> = new (...args: unknown[]) => T;
  * @param version - API version number. When `addApi` is `true` and `version`
  *   is non-zero, a `/v{version}` segment is inserted after `/api`.
  *   Defaults to `1`.
+ * @param log - When `true`, prints each registered route to the console.
+ *   Defaults to `false`.
  *
  * @example
  * ```ts
@@ -113,11 +122,11 @@ type Constructor<T = object> = new (...args: unknown[]) => T;
  * import { UserController } from './controllers/user';
  *
  * const app = express();
- * defineRoutes([UserController], app);
- * // Routes are now available at /api/v1/...
+ * defineRoutes([UserController], app, true, 1, true);
+ * // [deco-express] GET /api/v1/users/:id
  * ```
  */
-declare function defineRoutes(controllers: Constructor[], application: Express, addApi?: boolean, version?: number): void;
+declare function defineRoutes(controllers: Constructor[], application: Express, addApi?: boolean, version?: number, log?: boolean): void;
 
 /**
  * A nested map that stores route handlers organised by HTTP method and path.

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { Express, RequestHandler } from 'express';
+import { RequestHandler, Express } from 'express';
 import Joi from 'joi';
 
 /**
@@ -34,19 +34,24 @@ declare function Route(method: keyof Express, path?: string, ...middleware: Requ
  * and is prepended to every route path registered by {@link Route} decorators
  * on the class's methods.
  *
+ * Controller-level middleware is stored under the `"controllerMiddleware"` key
+ * and is prepended to every route handler in the controller.
+ *
  * @param baseRoute - The base path prefix for all routes in the controller
  *   (e.g. `"/users"`). Defaults to `""` (no prefix).
+ * @param middleware - Zero or more Express middleware functions that are
+ *   executed **before** every route handler in the controller.
  *
  * @example
  * ```ts
- * \@Controller('/users')
+ * \@Controller('/users', authMiddleware)
  * class UserController {
  *   \@Route('get', '/:id')
  *   getUser(req: Request, res: Response) { ... }
  * }
  * ```
  */
-declare function Controller(baseRoute?: string): (target: object) => void;
+declare function Controller(baseRoute?: string, ...middleware: RequestHandler[]): (target: object) => void;
 
 /**
  * Method decorator that validates `req.body` against a Joi schema before the
@@ -91,8 +96,10 @@ type Constructor<T = object> = new (...args: unknown[]) => T;
  * For each controller the function:
  * 1. Instantiates the class with `new`.
  * 2. Reads the `"baseRoute"` metadata set by {@link Controller}.
- * 3. Reads the `"routeHandlers"` metadata set by {@link Route}.
- * 4. Mounts each handler at the resolved full path on the Express app.
+ * 3. Reads the `"controllerMiddleware"` metadata set by {@link Controller}.
+ * 4. Reads the `"routeHandlers"` metadata set by {@link Route}.
+ * 5. Mounts each handler at the resolved full path on the Express app,
+ *    with controller-level middleware prepended to each route's handlers.
  *
  * The full path is built as:
  * ```
@@ -105,6 +112,8 @@ type Constructor<T = object> = new (...args: unknown[]) => T;
  * @param version - API version number. When `addApi` is `true` and `version`
  *   is non-zero, a `/v{version}` segment is inserted after `/api`.
  *   Defaults to `1`.
+ * @param log - When `true`, prints each registered route to the console.
+ *   Defaults to `false`.
  *
  * @example
  * ```ts
@@ -113,11 +122,11 @@ type Constructor<T = object> = new (...args: unknown[]) => T;
  * import { UserController } from './controllers/user';
  *
  * const app = express();
- * defineRoutes([UserController], app);
- * // Routes are now available at /api/v1/...
+ * defineRoutes([UserController], app, true, 1, true);
+ * // [deco-express] GET /api/v1/users/:id
  * ```
  */
-declare function defineRoutes(controllers: Constructor[], application: Express, addApi?: boolean, version?: number): void;
+declare function defineRoutes(controllers: Constructor[], application: Express, addApi?: boolean, version?: number, log?: boolean): void;
 
 /**
  * A nested map that stores route handlers organised by HTTP method and path.

package/dist/index.js

@@ -1,9 +1,7 @@
 "use strict";
-var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 var __export = (target, all) => {
@@ -18,14 +16,6 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/index.ts
@@ -51,15 +41,15 @@ function Route(method, path = "", ...middleware) {
   };
 }
 __name(Route, "Route");
-function Controller(baseRoute = "") {
+function Controller(baseRoute = "", ...middleware) {
   return (target) => {
     Reflect.defineMetadata("baseRoute", baseRoute, target);
+    Reflect.defineMetadata("controllerMiddleware", middleware, target);
   };
 }
 __name(Controller, "Controller");
 
 // src/decorators/validation.ts
-var import_joi = __toESM(require("joi"));
 function Validate(schema) {
   return function(_target, _propertyKey, descriptor) {
     const originalMethod = descriptor.value;
@@ -67,16 +57,7 @@ function Validate(schema) {
       try {
         await schema.validateAsync(req.body);
       } catch (error) {
-        if (error instanceof import_joi.default.ValidationError) {
-          return res.status(422).json({
-            message: "Validation failed",
-            details: error.details.map((d) => ({
-              field: d.path.join("."),
-              message: d.message
-            }))
-          });
-        }
-        return next(error);
+        return res.status(422).json(error);
       }
       return originalMethod.call(this, req, res, next);
     };
@@ -86,7 +67,7 @@ function Validate(schema) {
 __name(Validate, "Validate");
 
 // src/functions/routes.ts
-function defineRoutes(controllers, application, addApi = true, version = 1) {
+function defineRoutes(controllers, application, addApi = true, version = 1, log = false) {
   for (const ControllerClass of controllers) {
     const controller = new ControllerClass();
     const routeHandlers = Reflect.getMetadata(
@@ -94,12 +75,14 @@ function defineRoutes(controllers, application, addApi = true, version = 1) {
       controller
     );
     const controllerPath = Reflect.getMetadata("baseRoute", controller.constructor) ?? "";
+    const controllerMiddleware = Reflect.getMetadata("controllerMiddleware", controller.constructor) ?? [];
     if (!routeHandlers) continue;
     for (const [method, routes] of routeHandlers) {
       for (const [routePath, handlers] of routes) {
         const versionSegment = addApi && version ? `/v${version}` : "";
         const fullPath = `${addApi ? "/api" : ""}${versionSegment}${controllerPath}${routePath}`;
-        application[method](fullPath, handlers);
+        application[method](fullPath, [...controllerMiddleware, ...handlers]);
+        if (log) console.log(`[deco-express] ${method.toUpperCase()} ${fullPath}`);
       }
     }
   }

package/dist/index.mjs

@@ -16,15 +16,15 @@ function Route(method, path = "", ...middleware) {
   };
 }
 __name(Route, "Route");
-function Controller(baseRoute = "") {
+function Controller(baseRoute = "", ...middleware) {
   return (target) => {
     Reflect.defineMetadata("baseRoute", baseRoute, target);
+    Reflect.defineMetadata("controllerMiddleware", middleware, target);
   };
 }
 __name(Controller, "Controller");
 
 // src/decorators/validation.ts
-import Joi from "joi";
 function Validate(schema) {
   return function(_target, _propertyKey, descriptor) {
     const originalMethod = descriptor.value;
@@ -32,16 +32,7 @@ function Validate(schema) {
       try {
         await schema.validateAsync(req.body);
       } catch (error) {
-        if (error instanceof Joi.ValidationError) {
-          return res.status(422).json({
-            message: "Validation failed",
-            details: error.details.map((d) => ({
-              field: d.path.join("."),
-              message: d.message
-            }))
-          });
-        }
-        return next(error);
+        return res.status(422).json(error);
       }
       return originalMethod.call(this, req, res, next);
     };
@@ -51,7 +42,7 @@ function Validate(schema) {
 __name(Validate, "Validate");
 
 // src/functions/routes.ts
-function defineRoutes(controllers, application, addApi = true, version = 1) {
+function defineRoutes(controllers, application, addApi = true, version = 1, log = false) {
   for (const ControllerClass of controllers) {
     const controller = new ControllerClass();
     const routeHandlers = Reflect.getMetadata(
@@ -59,12 +50,14 @@ function defineRoutes(controllers, application, addApi = true, version = 1) {
       controller
     );
     const controllerPath = Reflect.getMetadata("baseRoute", controller.constructor) ?? "";
+    const controllerMiddleware = Reflect.getMetadata("controllerMiddleware", controller.constructor) ?? [];
     if (!routeHandlers) continue;
     for (const [method, routes] of routeHandlers) {
       for (const [routePath, handlers] of routes) {
         const versionSegment = addApi && version ? `/v${version}` : "";
         const fullPath = `${addApi ? "/api" : ""}${versionSegment}${controllerPath}${routePath}`;
-        application[method](fullPath, handlers);
+        application[method](fullPath, [...controllerMiddleware, ...handlers]);
+        if (log) console.log(`[deco-express] ${method.toUpperCase()} ${fullPath}`);
       }
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "deco-express",
-    "version": "0.1.5",
+    "version": "0.2.0",
     "author": "ndrolp",
     "description": "Decorator-based utilities for building Express.js REST APIs in TypeScript",
     "main": "./dist/index.js",