feat(core): introduce ResponseEntity, ResponseBody and produces support

Co-authored-by: Junie <junie@jetbrains.com>

Author: MaksymStoianov

src/controller/BaseBootApplication.ts

@@ -10,7 +10,7 @@ import {
   Provider,
   RouteMetadata
 } from "../domain/types";
-import { RequestMethod } from "../domain/enums";
+import { ContentMimeType, RequestMethod } from "../domain/enums";
 import {
   EventDispatcher,
   RequestFactory,
@@ -155,8 +155,11 @@ export abstract class BaseBootApplication {
         req: HttpRequest,
         status: number | undefined,
         headers: HttpHeaders | undefined,
-        data: unknown
-      ): HttpResponse => this._responseBuilder.create(req, status, headers, data)
+        data: unknown,
+        produce?: ContentMimeType,
+        isResponseBody?: boolean
+      ): HttpResponse =>
+        this._responseBuilder.create(req, status, headers, data, produce, isResponseBody)
     );
 
     return { request, response };

src/controller/decorators/ResponseBody.ts

@@ -0,0 +1,42 @@
+import { RESPONSE_BODY_METADATA } from "../../domain/constants";
+
+/**
+ * Decorator that tells the controller that the return object should be serialized
+ * directly into the HTTP response body.
+ *
+ * In this framework, this is the default behavior for all controller methods,
+ * but this decorator is provided for compatibility with Spring Boot patterns.
+ *
+ * @returns {MethodDecorator & ClassDecorator} A decorator.
+ *
+ * @example
+ * ```TypeScript
+ * import { ResponseBody, GetMapping, Controller } from "bootgs";
+ *
+ * @Controller()
+ * class MyController {
+ *   @GetMapping("/data")
+ *   @ResponseBody
+ *   getData() {
+ *     return { message: "Hello" };
+ *   }
+ * }
+ * ```
+ */
+export function ResponseBody(): MethodDecorator & ClassDecorator {
+  return (
+    target: object,
+    propertyKey?: string | symbol,
+    descriptor?: TypedPropertyDescriptor<any>
+  ): void => {
+    if (propertyKey) {
+      if (descriptor && descriptor.value) {
+        Reflect.defineMetadata(RESPONSE_BODY_METADATA, true, descriptor.value);
+      } else {
+        Reflect.defineMetadata(RESPONSE_BODY_METADATA, true, target, propertyKey);
+      }
+    } else {
+      Reflect.defineMetadata(RESPONSE_BODY_METADATA, true, target);
+    }
+  };
+}

src/controller/decorators/RestController.ts

@@ -1,8 +1,12 @@
-import { HttpController } from "../../controller/decorators";
+import { HttpController } from "./HttpController";
+import { ResponseBody } from "./ResponseBody";
 
 /**
  * Decorator that marks a class as a REST controller.
  *
+ * @param   {string} [path] - The base path for all routes in the controller.
+ * @returns {ClassDecorator} A decorator.
+ *
  * @example
  * ```TypeScript
  * import { RestController, Get, Param } from "bootgs";
@@ -16,4 +20,9 @@ import { HttpController } from "../../controller/decorators";
  * }
  * ```
  */
-export const RestController = HttpController;
+export function RestController(path?: string): ClassDecorator {
+  return (target: object): void => {
+    HttpController(path)(target as any);
+    ResponseBody()(target as any);
+  };
+}

src/controller/decorators/index.ts

@@ -16,3 +16,4 @@ export * from "./ResponseStatus";
 export * from "./ControllerAdvice";
 export * from "./ExceptionHandler";
 export * from "./Value";
+export * from "./ResponseBody";

src/controller/decorators/routing/DeleteMapping.ts

@@ -1,10 +1,10 @@
 import { RequestMethod } from "../../../domain/enums";
-import { createHttpDecorator } from "../../../repository";
+import { createHttpDecorator, HttpDecoratorOptions } from "../../../repository";
 
 /**
  * Route handler decorator for HTTP DELETE requests.
  *
- * @param   {string} [path] - Route path (optional).
+ * @param   {string | HttpDecoratorOptions} [options] - Route path or options (optional).
  * @returns {MethodDecorator} A method decorator.
  *
  * @example

src/controller/decorators/routing/GetMapping.ts

@@ -1,10 +1,10 @@
 import { RequestMethod } from "../../../domain/enums";
-import { createHttpDecorator } from "../../../repository";
+import { createHttpDecorator, HttpDecoratorOptions } from "../../../repository";
 
 /**
  * Route handler decorator for HTTP GET requests.
  *
- * @param   {string} [path] - Route path (optional).
+ * @param   {string | HttpDecoratorOptions} [options] - Route path or options (optional).
  * @returns {MethodDecorator} A method decorator.
  *
  * @example

src/controller/decorators/routing/HeadMapping.ts

@@ -1,10 +1,10 @@
 import { RequestMethod } from "../../../domain/enums";
-import { createHttpDecorator } from "../../../repository";
+import { createHttpDecorator, HttpDecoratorOptions } from "../../../repository";
 
 /**
  * Route handler decorator for HTTP HEAD requests.
  *
- * @param   {string} [path] - Route path (optional).
+ * @param   {string | HttpDecoratorOptions} [options] - Route path or options (optional).
  * @returns {MethodDecorator} A method decorator.
  *
  * @example

src/controller/decorators/routing/OptionsMapping.ts

@@ -1,10 +1,10 @@
 import { RequestMethod } from "../../../domain/enums";
-import { createHttpDecorator } from "../../../repository";
+import { createHttpDecorator, HttpDecoratorOptions } from "../../../repository";
 
 /**
  * Route handler decorator for HTTP OPTIONS requests.
  *
- * @param   {string} [path] - Route path (optional).
+ * @param   {string | HttpDecoratorOptions} [options] - Route path or options (optional).
  * @returns {MethodDecorator} A method decorator.
  *
  * @example

src/controller/decorators/routing/PatchMapping.ts

@@ -1,10 +1,10 @@
 import { RequestMethod } from "../../../domain/enums";
-import { createHttpDecorator } from "../../../repository";
+import { createHttpDecorator, HttpDecoratorOptions } from "../../../repository";
 
 /**
  * Route handler decorator for HTTP PATCH requests.
  *
- * @param   {string} [path] - Route path (optional).
+ * @param   {string | HttpDecoratorOptions} [options] - Route path or options (optional).
  * @returns {MethodDecorator} A method decorator.
  *
  * @example

src/controller/decorators/routing/PostMapping.ts

@@ -1,10 +1,10 @@
 import { RequestMethod } from "../../../domain/enums";
-import { createHttpDecorator } from "../../../repository";
+import { createHttpDecorator, HttpDecoratorOptions } from "../../../repository";
 
 /**
  * Route handler decorator for HTTP POST requests.
  *
- * @param   {string} [path] - Route path (optional).
+ * @param   {string | HttpDecoratorOptions} [options] - Route path or options (optional).
  * @returns {MethodDecorator} A method decorator.
  *
  * @example