@zenofolio/hyper-decor 1.0.69 → 1.0.72

package/dist/decorators/types.d.ts

@@ -74,6 +74,8 @@ export type HyperParameterMetadata = {
         name: string;
         method: string;
         resolver: ParameterResolver;
+        schema?: any;
+        isWholeSource?: boolean;
     }[]>;
 };
 export type HyperParamDecorator = (key: string) => (target: any, key: string, index: number) => void;

package/dist/exeptions/HyperException.d.ts

@@ -2,6 +2,7 @@ import { ExceptionType } from "./types";
 export default class HyperException extends Error {
     code: ExceptionType;
     additionalInfo: any;
-    constructor(message: string, code?: ExceptionType, additionalInfo?: any);
+    status: number;
+    constructor(message: string, code?: ExceptionType, additionalInfo?: any, status?: number);
     static throw(message: string, code?: ExceptionType, additionalInfo?: {}): void;
 }

package/dist/exeptions/HyperException.js

@@ -1,10 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 class HyperException extends Error {
-    constructor(message, code = "HyperException", additionalInfo = {}) {
+    constructor(message, code = "HyperException", additionalInfo = {}, status = 500) {
         super(message);
         this.code = code;
         this.additionalInfo = additionalInfo;
+        this.status = status;
     }
     static throw(message, code, additionalInfo = {}) {
         throw new this(message, code, additionalInfo);

package/dist/exeptions/HyperFileException.js

@@ -6,7 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const HyperException_1 = __importDefault(require("./HyperException"));
 class HyperFileException extends HyperException_1.default {
     constructor(message, additional) {
-        super(message, "HyperFileException", additional);
+        super(message, "HyperFileException", additional, 400);
     }
 }
 exports.default = HyperFileException;

package/dist/index.d.ts

@@ -11,3 +11,5 @@ export * from "./stores";
 export * from "./type";
 export * from "./common/transport";
 export * from "./common/message-bus";
+export * from "./__internals/transform/transform.registry";
+export * from "./lib/openapi";

package/dist/index.js

@@ -27,3 +27,5 @@ __exportStar(require("./stores"), exports);
 __exportStar(require("./type"), exports);
 __exportStar(require("./common/transport"), exports);
 __exportStar(require("./common/message-bus"), exports);
+__exportStar(require("./__internals/transform/transform.registry"), exports);
+__exportStar(require("./lib/openapi"), exports);

package/dist/lib/openapi/collectors/method.collector.js

@@ -4,7 +4,6 @@ exports.collectMethodMetadata = collectMethodMetadata;
 const constants_1 = require("../constants");
 const param_collector_1 = require("./param.collector");
 const constants_2 = require("../../../__internals/constants");
-const decorator_base_1 = require("../../../__internals/decorator-base");
 const transform_registry_1 = require("../../../__internals/transform/transform.registry");
 function collectMethodMetadata(target, methodName) {
     const methodMetadata = {};
@@ -22,20 +21,34 @@ function collectMethodMetadata(target, methodName) {
         description: Reflect.getMetadata(constants_1.REQUEST_BODY_DESCRIPTION, target, methodName),
         content: Reflect.getMetadata(constants_1.REQUEST_BODY_CONTENT, target, methodName),
     };
-    // Bridging @Transform to OpenAPI
-    const transform = (0, decorator_base_1.getDecorData)(constants_2.KEY_PARAMS_TRANSFORM, target, methodName);
-    if (transform) {
-        const openApiSchema = transform_registry_1.transformRegistry.getOpenApiSchema(transform.schema);
-        if (openApiSchema) {
-            const from = transform.options.from || 'body';
-            if (from === 'body') {
-                requestBody.content = requestBody.content || {};
-                requestBody.content['application/json'] = {
-                    schema: openApiSchema
-                };
+    // Bridge @Body to OpenAPI
+    const hyperParams = Reflect.getMetadata(constants_2.KEY_PARAMS_PARAM, target[methodName]);
+    if (hyperParams && hyperParams.params[methodName]) {
+        const bodyParam = hyperParams.params[methodName].find(p => ['body', 'BODY', 'req'].includes(p.key));
+        if (bodyParam) {
+            const targetSchema = bodyParam.schema;
+            if (targetSchema) {
+                const bodySchema = transform_registry_1.transformRegistry.getOpenApiSchema(targetSchema);
+                if (bodySchema) {
+                    requestBody.content = requestBody.content || {};
+                    requestBody.content['application/json'] = {
+                        schema: bodySchema
+                    };
+                }
             }
         }
     }
+    // Bridging @Output / return type to OpenAPI
+    const outputSchema = Reflect.getMetadata(constants_2.KEY_OUTPUT_SCHEMA, target, methodName)
+        || Reflect.getMetadata(constants_2.DESIGN_RETURNTYPE, target, methodName);
+    if (outputSchema && outputSchema !== Object && outputSchema !== Promise) {
+        const schema = transform_registry_1.transformRegistry.getOpenApiSchema(outputSchema);
+        if (schema) {
+            responses['200'] = responses['200'] || { description: 'Success' };
+            responses['200'].content = responses['200'].content || {};
+            responses['200'].content['application/json'] = { schema };
+        }
+    }
     // Asignamos las propiedades al objeto de metadata solo si existen
     if (summary)
         methodMetadata.summary = summary;

package/dist/lib/openapi/collectors/param.collector.d.ts

@@ -1,3 +1,2 @@
-import "reflect-metadata";
-import { Parameter } from "../types";
-export declare function collectParameterMetadata(target: any, methodName: string): Parameter[];
+import { OpenApiParameter } from "../types";
+export declare function collectParameterMetadata(target: any, methodName: string): OpenApiParameter[];

package/dist/lib/openapi/collectors/param.collector.js

@@ -1,26 +1,63 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.collectParameterMetadata = collectParameterMetadata;
-require("reflect-metadata");
 const constants_1 = require("../constants");
+const constants_2 = require("../../../__internals/constants");
+const transform_registry_1 = require("../../../__internals/transform/transform.registry");
 const function_util_1 = require("../../../__internals/utils/function.util");
 function collectParameterMetadata(target, methodName) {
     const parameters = Reflect.getMetadata(constants_1.PARAMETERS, target, methodName) || [];
-    const methodParams = Reflect.getMetadata("design:paramtypes", target, methodName) || [];
-    // Intentamos obtener los nombres de los parámetros utilizando extractArgsNames
-    const paramNames = (0, function_util_1.extractArgsNames)(target[methodName]);
-    // Si no se encuentran parámetros en los metadatos y hay tipos de parámetros disponibles
-    if (parameters.length === 0 && methodParams.length > 0) {
+    const hyperParams = Reflect.getMetadata(constants_2.KEY_PARAMS_PARAM, target[methodName]);
+    if (hyperParams && hyperParams.params[methodName]) {
+        hyperParams.params[methodName].forEach((p) => {
+            // Ignore body, req, res as they are not standard "parameters" in OpenAPI terms (body is separate)
+            if (['req', 'res', 'body', 'BODY'].includes(p.key))
+                return;
+            const locationMap = {
+                'query': 'query',
+                'params': 'path',
+                'headers': 'header',
+                'cookie': 'cookie'
+            };
+            const location = locationMap[p.key] || 'query';
+            if (p.isWholeSource && p.schema) {
+                const schema = transform_registry_1.transformRegistry.getOpenApiSchema(p.schema);
+                if (schema && schema.properties) {
+                    Object.keys(schema.properties).forEach((propKey) => {
+                        parameters.push({
+                            name: propKey,
+                            in: location,
+                            required: (schema.required || []).includes(propKey),
+                            schema: schema.properties[propKey]
+                        });
+                    });
+                }
+            }
+            else {
+                parameters.push({
+                    name: p.name,
+                    in: location,
+                    required: true, // TODO: detect optionality from design:paramtypes or metadata
+                    schema: p.schema ? transform_registry_1.transformRegistry.getOpenApiSchema(p.schema) : { type: 'string' }
+                });
+            }
+        });
+    }
+    // Fallback to design:paramtypes if no hyper-decor metadata found
+    if (parameters.length === 0) {
+        const methodParams = Reflect.getMetadata("design:paramtypes", target, methodName) || [];
+        const paramNames = (0, function_util_1.extractArgsNames)(target[methodName]);
         methodParams.forEach((paramType, index) => {
-            const param = {
-                name: paramNames && paramNames[index] ? paramNames[index] : `param${index}`, // Asignamos nombre genérico o el nombre inferido
-                in: "query", // Definir el tipo de parámetro, se puede modificar según sea necesario
+            var _a;
+            const name = paramNames && paramNames[index] ? paramNames[index] : `param${index}`;
+            parameters.push({
+                name,
+                in: "query",
                 required: true,
                 schema: {
-                    type: paramType.name.toLowerCase(), // Inferimos el tipo del parámetro
+                    type: ((_a = paramType === null || paramType === void 0 ? void 0 : paramType.name) === null || _a === void 0 ? void 0 : _a.toLowerCase()) === 'number' ? 'number' : 'string',
                 },
-            };
-            parameters.push(param);
+            });
         });
     }
     return parameters;

package/dist/lib/openapi/decorators/api-parameter.decorator.d.ts

@@ -1,3 +1,3 @@
 import 'reflect-metadata';
-import { Parameter } from '../types';
-export declare function ApiParameter(options: Parameter): (target: any, propertyKey: any) => void;
+import { OpenApiParameter } from '../types';
+export declare function ApiParameter(options: OpenApiParameter): (target: any, propertyKey: any) => void;

package/dist/lib/openapi/decorators/api-response.decorator.d.ts

@@ -1,3 +1,3 @@
 import "reflect-metadata";
-import { Responses } from "../types";
-export declare function ApiResponse(options: Responses): (target: any, propertyKey?: any, descriptor?: any) => any;
+import { OpenApiResponses } from "../types";
+export declare function ApiResponse(options: OpenApiResponses): (target: any, propertyKey?: any, descriptor?: any) => any;

package/dist/lib/openapi/decorators/api-tag.decorator.d.ts

@@ -1,3 +1,3 @@
 import 'reflect-metadata';
 import { Tag } from '../types';
-export declare function ApiTag(options: Tag): (target: any) => void;
+export declare function ApiTag(options: Tag | string): (target: any) => void;

package/dist/lib/openapi/decorators/api-tag.decorator.js

@@ -5,6 +5,9 @@ require("reflect-metadata");
 const tag_helper_1 = require("../helpers/tag.helper");
 function ApiTag(options) {
     return (target) => {
+        if (typeof options === 'string') {
+            options = { name: options };
+        }
         (0, tag_helper_1.apiTag)(target, options);
     };
 }

package/dist/lib/openapi/helpers/parameter.helper.d.ts

@@ -1,3 +1,3 @@
 import 'reflect-metadata';
-import { Parameter } from '../types';
-export declare function apiParameter(target: any, propertyKey: string, options: Parameter): void;
+import { OpenApiParameter } from '../types';
+export declare function apiParameter(target: any, propertyKey: string, options: OpenApiParameter): void;

package/dist/lib/openapi/helpers/response.helper.d.ts

@@ -1,3 +1,3 @@
 import "reflect-metadata";
-import { Responses } from "../types";
-export declare function apiResponse(target: any, propertyKey: string | symbol, options: Responses): void;
+import { OpenApiResponses } from "../types";
+export declare function apiResponse(target: any, propertyKey: string | symbol, options: OpenApiResponses): void;

package/dist/lib/openapi/types.d.ts

@@ -41,12 +41,12 @@ export interface Operation {
     description?: string;
     operationId?: string;
     tags?: Tag[];
-    parameters?: Parameter[];
+    parameters?: OpenApiParameter[];
     requestBody?: RequestBody;
-    responses: Responses;
+    responses: OpenApiResponses;
     security?: SecurityRequirement[];
 }
-export interface Parameter {
+export interface OpenApiParameter {
     name: string;
     in: "query" | "header" | "path" | "cookie";
     description?: string;
@@ -64,10 +64,10 @@ export interface RequestBody {
 export interface MediaType {
     schema: Schema;
 }
-export interface Responses {
-    [statusCode: string]: Response;
+export interface OpenApiResponses {
+    [statusCode: string]: OpenApiResponse;
 }
-export interface Response {
+export interface OpenApiResponse {
     description: string;
     content?: {
         [mediaType: string]: MediaType;
@@ -103,10 +103,10 @@ export interface Components {
         [schemaName: string]: Schema;
     };
     responses?: {
-        [responseName: string]: Response;
+        [responseName: string]: OpenApiResponse;
     };
     parameters?: {
-        [parameterName: string]: Parameter;
+        [parameterName: string]: OpenApiParameter;
     };
     securitySchemes?: {
         [schemeName: string]: SecurityScheme;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zenofolio/hyper-decor",
-  "version": "1.0.69",
+  "version": "1.0.72",
   "description": "Project core with utilities and features",
   "main": "dist/index.js",
   "author": "zenozaga",
@@ -21,14 +21,15 @@
     "@vitest/ui": "^4.0.18",
     "nodemon": "3.1.7",
     "typescript": "5.6.2",
+    "undici": "^7.24.0",
     "unplugin-swc": "^1.5.9",
     "vitest": "^4.0.18"
   },
   "dependencies": {
     "core-decorators": "^0.20.0",
-    "reflect-metadata": "^0.2.2",
     "eventemitter3": "^5.0.4",
     "file-type": "^19.5.0",
+    "reflect-metadata": "^0.2.2",
     "ts-type": "^3.0.8",
     "tsyringe": "^4.8.0"
   },