@athenna/http 4.33.0 → 4.34.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@athenna/http",
-  "version": "4.33.0",
+  "version": "4.34.0",
   "description": "The Athenna Http server. Built on top of fastify.",
   "license": "MIT",
   "author": "João Lenon <lenon@athenna.io>",
@@ -74,7 +74,7 @@
   },
   "devDependencies": {
     "@athenna/artisan": "^4.42.0",
-    "@athenna/common": "^4.38.0",
+    "@athenna/common": "^4.39.0",
     "@athenna/config": "^4.21.0",
     "@athenna/ioc": "^4.20.0",
     "@athenna/logger": "^4.20.0",

package/src/exceptions/NotFoundValidatorException.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @athenna/ioc
+ *
+ * (c) João Lenon <lenon@athenna.io>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+import { Exception } from '@athenna/common';
+export declare class NotFoundValidatorException extends Exception {
+    constructor(alias: string, namedAlias: string);
+}

package/src/exceptions/NotFoundValidatorException.js

@@ -0,0 +1,19 @@
+/**
+ * @athenna/ioc
+ *
+ * (c) João Lenon <lenon@athenna.io>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+import { Exception } from '@athenna/common';
+export class NotFoundValidatorException extends Exception {
+    constructor(alias, namedAlias) {
+        super({
+            status: 500,
+            code: 'E_NOT_FOUND_VALIDATOR_ERROR',
+            message: `The validator with ${namedAlias} named alias and ${alias} alias has not been found inside the container.`,
+            help: `Remember to register the validator in your .athennarc.json file.`
+        });
+    }
+}

package/src/router/Route.d.ts

@@ -50,6 +50,11 @@ export declare class Route {
      * ```
      */
     prefix(prefix: string): Route;
+    /**
+     * Set a named validator, validator closure or a MiddlewareContract implementation
+     * in the route.
+     */
+    validator(validator: MiddlewareRouteType, prepend?: boolean): Route;
     /**
      * Set a named middleware, middleware closure or a MiddlewareContract implementation
      * in the route.

package/src/router/Route.js

@@ -8,6 +8,7 @@
  */
 import { Is, Options, Route as RouteHelper } from '@athenna/common';
 import { UndefinedMethodException } from '#src/exceptions/UndefinedMethodException';
+import { NotFoundValidatorException } from '#src/exceptions/NotFoundValidatorException';
 import { NotFoundMiddlewareException } from '#src/exceptions/NotFoundMiddlewareException';
 export class Route {
     constructor(url, methods, handler) {
@@ -84,6 +85,31 @@ export class Route {
         this.route.prefixes.push(prefix);
         return this;
     }
+    /**
+     * Set a named validator, validator closure or a MiddlewareContract implementation
+     * in the route.
+     */
+    validator(validator, prepend = false) {
+        const insertionType = prepend ? 'unshift' : 'push';
+        if (Is.String(validator)) {
+            const namedAlias = `App/Validators/Names/${validator}`;
+            const alias = `App/Validators/${validator}`;
+            if (!ioc.has(namedAlias) && !ioc.has(alias)) {
+                throw new NotFoundValidatorException(alias, namedAlias);
+            }
+            this.route.middlewares.middlewares[insertionType]((...args) => {
+                const mid = ioc.use(namedAlias) || ioc.safeUse(alias);
+                return mid.handle.bind(mid)(...args);
+            });
+            return this;
+        }
+        if (Is.Function(validator)) {
+            this.route.middlewares.middlewares[insertionType](validator);
+            return this;
+        }
+        this.route.middlewares.middlewares[insertionType](validator.handle.bind(validator));
+        return this;
+    }
     /**
      * Set a named middleware, middleware closure or a MiddlewareContract implementation
      * in the route.

package/src/router/RouteGroup.d.ts

@@ -37,6 +37,17 @@ export declare class RouteGroup {
      * ```
      */
     name(name: string): RouteGroup;
+    /**
+     * Add a validator to all routes in the group.
+     *
+     * @example
+     * ```ts
+     * Route.group(() => {
+     *
+     * }).validator('auth')
+     * ```
+     */
+    validator(validator: MiddlewareRouteType): RouteGroup;
     /**
      * Add a middleware to all routes in the group.
      *

package/src/router/RouteGroup.js

@@ -40,6 +40,20 @@ export class RouteGroup {
         this.routes.forEach(route => this.invoke(route, 'name', [name]));
         return this;
     }
+    /**
+     * Add a validator to all routes in the group.
+     *
+     * @example
+     * ```ts
+     * Route.group(() => {
+     *
+     * }).validator('auth')
+     * ```
+     */
+    validator(validator) {
+        this.routes.forEach(route => this.invoke(route, 'validator', [validator, true]));
+        return this;
+    }
     /**
      * Add a middleware to all routes in the group.
      *

package/src/router/RouteResource.d.ts

@@ -22,6 +22,15 @@ export declare class RouteResource {
      */
     controller: any;
     constructor(resource: string, controller: any);
+    /**
+     * Set a validator for the route resource.
+     *
+     * @example
+     * ```ts
+     * Route.resource('/test', 'TestController').validator('auth')
+     * ```
+     */
+    validator(validator: MiddlewareRouteType, prepend?: boolean): RouteResource;
     /**
      * Set a middleware for the route resource.
      *

package/src/router/RouteResource.js

@@ -18,6 +18,18 @@ export class RouteResource {
         this.controller = controller;
         this.buildRoutes();
     }
+    /**
+     * Set a validator for the route resource.
+     *
+     * @example
+     * ```ts
+     * Route.resource('/test', 'TestController').validator('auth')
+     * ```
+     */
+    validator(validator, prepend) {
+        this.routes.forEach(route => route.validator(validator, prepend));
+        return this;
+    }
     /**
      * Set a middleware for the route resource.
      *