@shadow-library/fastify 1.6.1 → 1.6.2

package/README.md

@@ -956,6 +956,8 @@ class CreateProductDto {
 
 The `@ApiOperation` decorator allows you to add OpenAPI/Swagger metadata to your route handlers. This metadata is integrated into the Fastify route schema and can be consumed by documentation generators like Swagger UI.
 
+> **Note:** Tags are auto-generated from controller class names (e.g., `UserController` → `['User']`, `UserAccountHandler` → `['User Account']`) by stripping common suffixes and converting camelCase to spaced words. Similarly, summaries are auto-generated from method names when using HTTP input decorators. Use `@ApiOperation` to override these defaults.
+
 ```typescript
 @ApiOperation({
   summary: string;              // Short description of the operation

package/cjs/decorators/http-controller.decorator.d.ts

@@ -1,7 +1 @@
-/**
- * Defining types
- */
-/**
- * Declaring the constants
- */
 export declare function HttpController(path?: string): ClassDecorator;

package/cjs/decorators/http-controller.decorator.js

@@ -9,12 +9,23 @@ const app_1 = require("@shadow-library/app");
  * Importing user defined packages
  */
 const constants_1 = require("../constants.js");
+const api_operation_decorator_1 = require("./api-operation.decorator.js");
 /**
  * Defining types
  */
 /**
  * Declaring the constants
  */
+const controllerNameSuffixes = ['Controller', 'API', 'Api', 'Handler', 'Resource', 'Endpoint', 'Route'];
 function HttpController(path = '') {
-    return target => (0, app_1.Controller)({ [constants_1.HTTP_CONTROLLER_TYPE]: 'router', path })(target);
+    return target => {
+        let tag = target.name;
+        for (const suffix of controllerNameSuffixes)
+            tag = tag.replace(suffix, '');
+        if (!tag)
+            tag = target.name;
+        tag = tag.replace(/([a-z])([A-Z])|([A-Z]+)([A-Z][a-z])/g, '$1$3 $2$4');
+        (0, app_1.Controller)({ [constants_1.HTTP_CONTROLLER_TYPE]: 'router', path })(target);
+        (0, api_operation_decorator_1.ApiOperation)({ tags: [tag] })(target);
+    };
 }

package/cjs/decorators/http-route.decorator.d.ts

@@ -1,6 +1,3 @@
-/**
- * Importing user defined packages
- */
 /**
  * Defining types
  */

package/cjs/decorators/http-route.decorator.js

@@ -9,6 +9,7 @@ const app_1 = require("@shadow-library/app");
 /**
  * Importing user defined packages
  */
+const api_operation_decorator_1 = require("./api-operation.decorator.js");
 /**
  * Defining types
  */
@@ -29,7 +30,12 @@ var HttpMethod;
 function HttpRoute(options) {
     if (options.path && options.path.charAt(0) !== '/')
         options.path = `/${options.path}`;
-    return (0, app_1.Route)(options);
+    return (target, propertyKey, descriptor) => {
+        const methodName = propertyKey.toString();
+        const summary = methodName.charAt(0).toUpperCase() + methodName.slice(1).replace(/([a-z])([A-Z])|([A-Z]+)([A-Z][a-z])/g, '$1$3 $2$4');
+        (0, app_1.Route)(options)(target, propertyKey, descriptor);
+        (0, api_operation_decorator_1.ApiOperation)({ summary })(target, propertyKey, descriptor);
+    };
 }
 const Get = (path) => HttpRoute({ method: HttpMethod.GET, path });
 exports.Get = Get;

package/esm/decorators/http-controller.decorator.d.ts

@@ -1,7 +1 @@
-/**
- * Defining types
- */
-/**
- * Declaring the constants
- */
 export declare function HttpController(path?: string): ClassDecorator;

package/esm/decorators/http-controller.decorator.js

@@ -6,12 +6,23 @@ import { Controller } from '@shadow-library/app';
  * Importing user defined packages
  */
 import { HTTP_CONTROLLER_TYPE } from '../constants.js';
+import { ApiOperation } from './api-operation.decorator.js';
 /**
  * Defining types
  */
 /**
  * Declaring the constants
  */
+const controllerNameSuffixes = ['Controller', 'API', 'Api', 'Handler', 'Resource', 'Endpoint', 'Route'];
 export function HttpController(path = '') {
-    return target => Controller({ [HTTP_CONTROLLER_TYPE]: 'router', path })(target);
+    return target => {
+        let tag = target.name;
+        for (const suffix of controllerNameSuffixes)
+            tag = tag.replace(suffix, '');
+        if (!tag)
+            tag = target.name;
+        tag = tag.replace(/([a-z])([A-Z])|([A-Z]+)([A-Z][a-z])/g, '$1$3 $2$4');
+        Controller({ [HTTP_CONTROLLER_TYPE]: 'router', path })(target);
+        ApiOperation({ tags: [tag] })(target);
+    };
 }

package/esm/decorators/http-route.decorator.d.ts

@@ -1,6 +1,3 @@
-/**
- * Importing user defined packages
- */
 /**
  * Defining types
  */

package/esm/decorators/http-route.decorator.js

@@ -5,6 +5,7 @@ import { Route } from '@shadow-library/app';
 /**
  * Importing user defined packages
  */
+import { ApiOperation } from './api-operation.decorator.js';
 /**
  * Defining types
  */
@@ -25,7 +26,12 @@ export var HttpMethod;
 export function HttpRoute(options) {
     if (options.path && options.path.charAt(0) !== '/')
         options.path = `/${options.path}`;
-    return Route(options);
+    return (target, propertyKey, descriptor) => {
+        const methodName = propertyKey.toString();
+        const summary = methodName.charAt(0).toUpperCase() + methodName.slice(1).replace(/([a-z])([A-Z])|([A-Z]+)([A-Z][a-z])/g, '$1$3 $2$4');
+        Route(options)(target, propertyKey, descriptor);
+        ApiOperation({ summary })(target, propertyKey, descriptor);
+    };
 }
 export const Get = (path) => HttpRoute({ method: HttpMethod.GET, path });
 export const Post = (path) => HttpRoute({ method: HttpMethod.POST, path });

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@shadow-library/fastify",
   "type": "module",
-  "version": "1.6.1",
+  "version": "1.6.2",
   "sideEffects": false,
   "description": "A Fastify wrapper featuring decorator-based routing, middleware and error handling",
   "repository": {