@zenofolio/hyper-decor 1.0.67 → 1.0.69

package/dist/__internals/constants.d.ts

@@ -14,7 +14,8 @@ export declare const KEY_PARAMS_MIDDLEWARES = "hyper:type:middlewares";
 export declare const KEY_PARAMS_SCOPE = "hyper:type:scope";
 export declare const KEY_PARAMS_ROLE = "hyper:type:role";
 export declare const KEY_PARAMS_PASS = "hyper:type:pass";
-export type KeyParams = typeof KEY_PARAMS_APP | typeof KEY_PARAMS_CONTROLLER | typeof KEY_PARAMS_MODULE | typeof KEY_PARAMS_ROUTE | typeof KEY_PARAMS_PARAM | typeof KEY_PARAMS_MIDDLEWARES | typeof KEY_PARAMS_SCOPE | typeof KEY_PARAMS_ROLE | typeof KEY_PARAMS_PASS;
+export declare const KEY_PARAMS_TRANSFORM = "hyper:type:transform";
+export type KeyParams = typeof KEY_PARAMS_APP | typeof KEY_PARAMS_CONTROLLER | typeof KEY_PARAMS_MODULE | typeof KEY_PARAMS_ROUTE | typeof KEY_PARAMS_PARAM | typeof KEY_PARAMS_MIDDLEWARES | typeof KEY_PARAMS_SCOPE | typeof KEY_PARAMS_ROLE | typeof KEY_PARAMS_PASS | typeof KEY_PARAMS_TRANSFORM;
 export declare const KEY_STATE_UPDATED = "hyper:state:updated";
 export declare const KEY_STATE_CREATED = "hyper:state:created";
 export declare const KEY_STATE_PREPARED = "hyper:state:prepared";

package/dist/__internals/constants.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FULL_ACCESS = exports.METADATA_STATE_KEYS = exports.METADATA_PARAMS_KEYS = exports.METADATA_METHOD_KEYS = exports.METADATA_STORE_KEYS = exports.METADATA_KEYS = exports.METADATA_HYPER_TYPE = exports.DESIGN_TYPE = exports.DESIGN_RETURNTYPE = exports.DESIGN_PARAMTYPES = exports.KEY_STATE_BY_PASS = exports.KEY_STATE_PREPARED = exports.KEY_STATE_CREATED = exports.KEY_STATE_UPDATED = exports.KEY_PARAMS_PASS = exports.KEY_PARAMS_ROLE = exports.KEY_PARAMS_SCOPE = exports.KEY_PARAMS_MIDDLEWARES = exports.KEY_PARAMS_PARAM = exports.KEY_PARAMS_ROUTE = exports.KEY_PARAMS_MODULE = exports.KEY_PARAMS_CONTROLLER = exports.KEY_PARAMS_APP = exports.KEY_TYPE_GUARD = exports.KEY_TYPE_SERVICE = exports.KEY_TYPE_ROUTE = exports.KEY_TYPE_MODULE = exports.KEY_TYPE_CONTROLLER = exports.KEY_TYPE_APP = void 0;
+exports.FULL_ACCESS = exports.METADATA_STATE_KEYS = exports.METADATA_PARAMS_KEYS = exports.METADATA_METHOD_KEYS = exports.METADATA_STORE_KEYS = exports.METADATA_KEYS = exports.METADATA_HYPER_TYPE = exports.DESIGN_TYPE = exports.DESIGN_RETURNTYPE = exports.DESIGN_PARAMTYPES = exports.KEY_STATE_BY_PASS = exports.KEY_STATE_PREPARED = exports.KEY_STATE_CREATED = exports.KEY_STATE_UPDATED = exports.KEY_PARAMS_TRANSFORM = exports.KEY_PARAMS_PASS = exports.KEY_PARAMS_ROLE = exports.KEY_PARAMS_SCOPE = exports.KEY_PARAMS_MIDDLEWARES = exports.KEY_PARAMS_PARAM = exports.KEY_PARAMS_ROUTE = exports.KEY_PARAMS_MODULE = exports.KEY_PARAMS_CONTROLLER = exports.KEY_PARAMS_APP = exports.KEY_TYPE_GUARD = exports.KEY_TYPE_SERVICE = exports.KEY_TYPE_ROUTE = exports.KEY_TYPE_MODULE = exports.KEY_TYPE_CONTROLLER = exports.KEY_TYPE_APP = void 0;
 //////////////////////////////
 /// Types constants
 //////////////////////////////
@@ -22,6 +22,7 @@ exports.KEY_PARAMS_MIDDLEWARES = "hyper:type:middlewares";
 exports.KEY_PARAMS_SCOPE = "hyper:type:scope";
 exports.KEY_PARAMS_ROLE = "hyper:type:role";
 exports.KEY_PARAMS_PASS = "hyper:type:pass";
+exports.KEY_PARAMS_TRANSFORM = "hyper:type:transform";
 //////////////////////////////
 /// State constants
 //////////////////////////////

package/dist/__internals/helpers/prepare.helper.js

@@ -24,8 +24,10 @@ const middleware_transform_1 = __importDefault(require("../transform/middleware.
 const tsyringe_1 = require("tsyringe");
 const path_util_1 = require("../utils/path.util");
 const imports_helper_1 = require("./imports.helper");
+const constants_2 = require("../constants");
 const message_bus_1 = require("../../common/message-bus");
 const transport_1 = require("../../common/transport");
+const transform_registry_1 = require("../transform/transform.registry");
 const if_router = (current) => {
     if (!current || !((current === null || current === void 0 ? void 0 : current.prototype) instanceof hyper_express_1.Router))
         return new hyper_express_1.Router();
@@ -258,6 +260,37 @@ function prepareRoutes(_a) {
         if (!$fn)
             return;
         const middlewares = [...metadata.middlewares];
+        // Agnostic Transform Integration
+        const transform = (0, decorator_base_1.getDecorData)(constants_2.KEY_PARAMS_TRANSFORM, target.prototype || target, propertyKey);
+        if (transform) {
+            middlewares.push((req, res, next) => __awaiter(this, void 0, void 0, function* () {
+                try {
+                    const from = transform.options.from || "body";
+                    let data;
+                    if (from === "body") {
+                        data = req.body !== undefined ? req.body : yield req.json();
+                    }
+                    else {
+                        data = req[from];
+                    }
+                    // Resolve through the chain of responsibility
+                    const transformed = yield transform_registry_1.transformRegistry.resolve({
+                        data,
+                        schema: transform.schema,
+                        options: transform.options,
+                        req,
+                        res,
+                        from
+                    });
+                    // Update the request object
+                    req[from] = transformed;
+                    next();
+                }
+                catch (err) {
+                    next(err);
+                }
+            }));
+        }
         (0, role_transform_1.default)(metadata.roles, (middleware) => middlewares.push(middleware));
         (0, scope_transfrom_1.default)(metadata.scopes, (middleware, scopes) => {
             middlewares.push(middleware);

package/dist/__internals/helpers/tree.helper.d.ts

@@ -4,15 +4,18 @@ export interface AppTree {
         target: any;
         fullPath: string;
     };
-    modules: ModuleNode[];
+    modules: Record<string, ModuleNode>;
+    paths: Record<string, RouteNode[]>;
+    openapi?: any;
 }
 export interface ModuleNode {
     metadata: HyperModuleMetadata;
     target: any;
     fullPath: string;
-    modules: ModuleNode[];
-    controllers: ControllerNode[];
+    modules: Record<string, ModuleNode>;
+    controllers: Record<string, ControllerNode>;
     services: any[];
+    openapi?: any;
 }
 export interface ControllerNode {
     metadata: HyperControllerMetadata;
@@ -20,13 +23,14 @@ export interface ControllerNode {
     fullPath: string;
     routes: RouteNode[];
     services: any[];
+    openapi?: any;
 }
 export interface RouteNode extends RouteMetadata {
     fullPath: string;
     params: any[];
+    openapi?: any;
 }
 /**
  * Extracts the complete application metadata tree.
- * This is useful for generating Swagger/OpenAPI documentation or graphing the app structure.
  */
 export declare function getAppTree(Target: any): AppTree;

package/dist/__internals/helpers/tree.helper.js

@@ -4,45 +4,78 @@ exports.getAppTree = getAppTree;
 const decorator_base_1 = require("../decorator-base");
 const constants_1 = require("../constants");
 const path_util_1 = require("../utils/path.util");
+const class_collector_1 = require("../../lib/openapi/collectors/class.collector");
+const metadata_registry_1 = require("../../lib/openapi/metadata.registry");
 /**
  * Extracts the complete application metadata tree.
- * This is useful for generating Swagger/OpenAPI documentation or graphing the app structure.
  */
 function getAppTree(Target) {
     const appMetadata = (0, decorator_base_1.getDecorData)(constants_1.KEY_PARAMS_APP, Target);
     const prefix = (appMetadata === null || appMetadata === void 0 ? void 0 : appMetadata.prefix) || "/";
-    return {
+    const tree = {
         app: Object.assign(Object.assign({}, appMetadata), { target: Target, fullPath: prefix }),
-        modules: ((appMetadata === null || appMetadata === void 0 ? void 0 : appMetadata.modules) || []).map(m => getModuleNode(m, prefix))
+        modules: {},
+        paths: {}
     };
+    ((appMetadata === null || appMetadata === void 0 ? void 0 : appMetadata.modules) || []).forEach(m => {
+        const node = getModuleNode(m, prefix, tree.paths);
+        tree.modules[m.name] = node;
+    });
+    // Apply tree processors
+    metadata_registry_1.openApiRegistry.getProcessors().forEach(processor => processor(tree));
+    return tree;
 }
-function getModuleNode(Target, parentPath = "") {
+function getModuleNode(Target, parentPath = "", globalPaths = {}) {
     const metadata = (0, decorator_base_1.getDecorData)(constants_1.KEY_PARAMS_MODULE, Target);
     const currentPath = (0, path_util_1.join)(parentPath, (metadata === null || metadata === void 0 ? void 0 : metadata.path) || "");
-    return {
+    const openapi = (0, class_collector_1.collectClassMetadata)(Target);
+    const node = {
         metadata,
         target: Target,
         fullPath: currentPath,
-        modules: ((metadata === null || metadata === void 0 ? void 0 : metadata.modules) || []).map(m => getModuleNode(m, currentPath)),
-        controllers: ((metadata === null || metadata === void 0 ? void 0 : metadata.controllers) || []).map(c => getControllerNode(c, currentPath)),
-        services: ((metadata === null || metadata === void 0 ? void 0 : metadata.imports) || [])
+        modules: {},
+        controllers: {},
+        services: ((metadata === null || metadata === void 0 ? void 0 : metadata.imports) || []),
+        openapi
     };
+    ((metadata === null || metadata === void 0 ? void 0 : metadata.modules) || []).forEach(m => {
+        node.modules[m.name] = getModuleNode(m, currentPath, globalPaths);
+    });
+    ((metadata === null || metadata === void 0 ? void 0 : metadata.controllers) || []).forEach(c => {
+        node.controllers[c.name] = getControllerNode(c, currentPath, globalPaths);
+    });
+    return node;
 }
-function getControllerNode(Target, parentPath = "") {
+function getControllerNode(Target, parentPath = "", globalPaths = {}) {
+    var _a;
     const metadata = (0, decorator_base_1.getDecorData)(constants_1.KEY_TYPE_CONTROLLER, Target);
     const routeList = (0, decorator_base_1.getDecorData)(constants_1.KEY_PARAMS_ROUTE, Target);
-    const paramMetadata = (0, decorator_base_1.getDecorData)(constants_1.KEY_PARAMS_PARAM, Target);
+    // Param metadata can be on the constructor or the prototype
+    const paramMetadata = (_a = (0, decorator_base_1.getDecorData)(constants_1.KEY_PARAMS_PARAM, Target)) !== null && _a !== void 0 ? _a : (0, decorator_base_1.getDecorData)(constants_1.KEY_PARAMS_PARAM, Target.prototype);
     const currentPath = (0, path_util_1.join)(parentPath, (metadata === null || metadata === void 0 ? void 0 : metadata.path) || "");
+    const openapi = (0, class_collector_1.collectClassMetadata)(Target);
     const routes = Array.from((routeList === null || routeList === void 0 ? void 0 : routeList.routes) || []).map((route) => {
-        var _a;
-        const params = ((_a = paramMetadata === null || paramMetadata === void 0 ? void 0 : paramMetadata.params) === null || _a === void 0 ? void 0 : _a[route.propertyKey]) || [];
-        return Object.assign(Object.assign({}, route), { fullPath: (0, path_util_1.join)(currentPath, route.path), params });
+        var _a, _b, _c, _d, _e, _f;
+        // Also try to get params from the handler itself if not in aggregated metadata
+        const params = (_e = (_b = (_a = paramMetadata === null || paramMetadata === void 0 ? void 0 : paramMetadata.params) === null || _a === void 0 ? void 0 : _a[route.propertyKey]) !== null && _b !== void 0 ? _b : (_d = (_c = (0, decorator_base_1.getDecorData)(constants_1.KEY_PARAMS_PARAM, route.handler)) === null || _c === void 0 ? void 0 : _c.params) === null || _d === void 0 ? void 0 : _d[route.propertyKey]) !== null && _e !== void 0 ? _e : [];
+        const fullPath = (0, path_util_1.join)(currentPath, route.path);
+        // Get OpenAPI metadata for the method
+        const methodOpenApi = ((_f = openapi.methods) === null || _f === void 0 ? void 0 : _f[route.propertyKey]) || {};
+        const routeNode = Object.assign(Object.assign({}, route), { fullPath,
+            params, openapi: methodOpenApi });
+        // Add to global paths map
+        if (!globalPaths[fullPath]) {
+            globalPaths[fullPath] = [];
+        }
+        globalPaths[fullPath].push(routeNode);
+        return routeNode;
     });
     return {
         metadata,
         target: Target,
         fullPath: currentPath,
         routes,
-        services: (metadata === null || metadata === void 0 ? void 0 : metadata.imports) || []
+        services: (metadata === null || metadata === void 0 ? void 0 : metadata.imports) || [],
+        openapi
     };
 }

package/dist/__internals/transform/transform.registry.d.ts

@@ -0,0 +1,33 @@
+import { Request, Response } from "hyper-express";
+export interface TransformContext<T = any, S = any> {
+    data: T;
+    schema: S;
+    options: any;
+    req: Request;
+    res: Response;
+    from: string;
+}
+export type TransformHandler<T = any, S = any> = (ctx: TransformContext<T, S>) => any | Promise<any>;
+export interface ITransformer<T = any, S = any> {
+    transform: TransformHandler<T, S>;
+    getOpenApiSchema?: (schema: S) => any;
+}
+export type TransformerInput = TransformHandler | ITransformer;
+declare class TransformRegistry {
+    private transformers;
+    /**
+     * Register a transformer (function or object with transform method).
+     */
+    register(input: TransformerInput): void;
+    /**
+     * Iterates through registered transformers to process the data.
+     * Returns the transformed data or the original data if no transformer matched.
+     */
+    resolve(ctx: TransformContext): Promise<any>;
+    /**
+     * Queries transformers to get an OpenAPI schema representation.
+     */
+    getOpenApiSchema(schema: any): any | undefined;
+}
+export declare const transformRegistry: TransformRegistry;
+export {};

package/dist/__internals/transform/transform.registry.js

@@ -0,0 +1,59 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.transformRegistry = void 0;
+class TransformRegistry {
+    constructor() {
+        this.transformers = [];
+    }
+    /**
+     * Register a transformer (function or object with transform method).
+     */
+    register(input) {
+        if (typeof input === 'function') {
+            this.transformers.push({ transform: input });
+        }
+        else {
+            this.transformers.push(input);
+        }
+    }
+    /**
+     * Iterates through registered transformers to process the data.
+     * Returns the transformed data or the original data if no transformer matched.
+     */
+    resolve(ctx) {
+        return __awaiter(this, void 0, void 0, function* () {
+            let currentData = ctx.data;
+            for (const transformer of this.transformers) {
+                const result = yield transformer.transform(Object.assign(Object.assign({}, ctx), { data: currentData }));
+                // If transformer returns non-undefined, we assume it's the new data (or unchanged but recognized)
+                if (result !== undefined) {
+                    currentData = result;
+                }
+            }
+            return currentData;
+        });
+    }
+    /**
+     * Queries transformers to get an OpenAPI schema representation.
+     */
+    getOpenApiSchema(schema) {
+        for (const transformer of this.transformers) {
+            if (transformer.getOpenApiSchema) {
+                const result = transformer.getOpenApiSchema(schema);
+                if (result !== undefined)
+                    return result;
+            }
+        }
+        return undefined;
+    }
+}
+exports.transformRegistry = new TransformRegistry();

package/dist/common/helpers/index.d.ts

@@ -1,2 +1,3 @@
 export * from "./role";
 export * from "./scopes";
+export * from "./state";

package/dist/common/helpers/index.js

@@ -16,3 +16,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./role"), exports);
 __exportStar(require("./scopes"), exports);
+__exportStar(require("./state"), exports);

package/dist/common/helpers/state.d.ts

@@ -0,0 +1,17 @@
+import type { Request } from "hyper-express";
+/**
+ * Save a custom value against the request directly via an internal Map
+ *
+ * @param {Request} request
+ * @param {string} key
+ * @param {any} value
+ */
+export declare const setValue: (request: Request, key: string, value: any) => void;
+/**
+ * Get a custom value from the request object directly via an internal Map
+ *
+ * @param {Request} request
+ * @param {string} key
+ * @param {any} defaultValue
+ */
+export declare const getValue: <T>(request: Request, key: string, defaultValue?: T) => T | any;

package/dist/common/helpers/state.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getValue = exports.setValue = void 0;
+const STATE_SYMBOL = Symbol("HYPER_DECOR_REQUEST_STATE");
+/**
+ * Get or create the internal state map for the request
+ * @param request
+ * @returns
+ */
+function getStore(request) {
+    if (!request[STATE_SYMBOL]) {
+        request[STATE_SYMBOL] = new Map();
+    }
+    return request[STATE_SYMBOL];
+}
+/**
+ * Save a custom value against the request directly via an internal Map
+ *
+ * @param {Request} request
+ * @param {string} key
+ * @param {any} value
+ */
+const setValue = (request, key, value) => {
+    const store = getStore(request);
+    if (value === undefined) {
+        store.delete(key);
+        return;
+    }
+    store.set(key, value);
+};
+exports.setValue = setValue;
+/**
+ * Get a custom value from the request object directly via an internal Map
+ *
+ * @param {Request} request
+ * @param {string} key
+ * @param {any} defaultValue
+ */
+const getValue = (request, key, defaultValue) => {
+    const store = getStore(request);
+    const value = store.get(key);
+    return value !== undefined ? value : defaultValue;
+};
+exports.getValue = getValue;

package/dist/decorators/Http.js

@@ -35,7 +35,7 @@ exports.Query = Query;
  * @returns
  */
 const Body = (resolver) => (0, request_creator_1.default)("req", "BODY", (request) => __awaiter(void 0, void 0, void 0, function* () {
-    const value = yield request.json();
+    const value = request.body !== undefined ? request.body : yield request.json();
     return resolver ? resolver(value) : value;
 }));
 exports.Body = Body;

package/dist/decorators/HyperApp.d.ts

@@ -1,7 +1,3 @@
 import "reflect-metadata";
 import { HyperAppDecorator } from "./types";
-/**
- * Decorator to define the main application class with assigned modules.
- * @param modules - List of modules to be used in the application.
- */
 export declare const HyperApp: HyperAppDecorator;

package/dist/decorators/HyperApp.js

@@ -16,11 +16,8 @@ const tsyringe_1 = require("tsyringe");
 const constants_1 = require("../__internals/constants");
 const decorator_base_1 = require("../__internals/decorator-base");
 const merge_metadata_1 = require("../__internals/helpers/merge-metadata");
+const transform_registry_1 = require("../__internals/transform/transform.registry");
 const prepare_helper_1 = require("../__internals/helpers/prepare.helper");
-/**
- * Decorator to define the main application class with assigned modules.
- * @param modules - List of modules to be used in the application.
- */
 const HyperApp = (options) => (0, decorator_base_1.DecoratorHelper)({
     type: constants_1.KEY_TYPE_APP,
     key: constants_1.KEY_PARAMS_APP,
@@ -33,6 +30,11 @@ const HyperApp = (options) => (0, decorator_base_1.DecoratorHelper)({
             this.storeLogs = {};
             this.listArguments = args;
         }
+        /** Registers an agnostic transformer (Zod, Joi, etc.) */
+        useTransform(transformer) {
+            transform_registry_1.transformRegistry.register(transformer);
+            return this;
+        }
         prepare() {
             return __awaiter(this, void 0, void 0, function* () {
                 tsyringe_1.container.registerInstance(hyper_express_1.Server, this);
@@ -52,10 +54,11 @@ const HyperApp = (options) => (0, decorator_base_1.DecoratorHelper)({
         /** Aplica las opciones y prepara la instancia del Target */
         applyOptions(Target) {
             return __awaiter(this, void 0, void 0, function* () {
-                var _a;
                 yield (0, prepare_helper_1.prepareApplication)(options, Target, this, this.log.bind(this));
                 const target = Reflect.construct(Target, this.listArguments);
-                (_a = target === null || target === void 0 ? void 0 : target.onPrepare) === null || _a === void 0 ? void 0 : _a.call(target);
+                if (target && typeof target === 'object' && 'onPrepare' in target) {
+                    target.onPrepare();
+                }
                 this.showLogs();
             });
         }

package/dist/decorators/Transform.d.ts

@@ -0,0 +1,14 @@
+import "reflect-metadata";
+export interface TransformOptions {
+    /**
+     * Where to extract the data from. Defaults to 'body'.
+     */
+    from?: 'body' | 'query' | 'params' | 'headers';
+}
+/**
+ * Agnostic decorator to transform/validate request data using a registered transformer.
+ *
+ * @param schema The schema or object to be used by the registered transformer.
+ * @param options Transformation options.
+ */
+export declare function Transform(schema: any, options?: TransformOptions): (target: any, propertyKey: any) => void;

package/dist/decorators/Transform.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Transform = Transform;
+require("reflect-metadata");
+const constants_1 = require("../__internals/constants");
+const decorator_base_1 = require("../__internals/decorator-base");
+/**
+ * Agnostic decorator to transform/validate request data using a registered transformer.
+ *
+ * @param schema The schema or object to be used by the registered transformer.
+ * @param options Transformation options.
+ */
+function Transform(schema, options = {}) {
+    return (target, propertyKey) => {
+        const data = { schema, options };
+        (0, decorator_base_1.defineDecorData)(constants_1.KEY_PARAMS_TRANSFORM, data, target, propertyKey);
+    };
+}

package/dist/decorators/index.d.ts

@@ -11,3 +11,4 @@ export * from "./Http";
 export * from "./Pass";
 export * from "./File";
 export * from "./Messaging";
+export * from "./Transform";

package/dist/decorators/index.js

@@ -27,3 +27,4 @@ __exportStar(require("./Http"), exports);
 __exportStar(require("./Pass"), exports);
 __exportStar(require("./File"), exports);
 __exportStar(require("./Messaging"), exports);
+__exportStar(require("./Transform"), exports);

package/dist/extension.js

@@ -31,6 +31,12 @@ const requestMethods = {
         (0, helpers_1.setRole)(this, role);
         (0, helpers_1.setScopes)(this, scopes);
     },
+    setValue(key, value) {
+        (0, helpers_1.setValue)(this, key, value);
+    },
+    getValue(key, defaultValue) {
+        return (0, helpers_1.getValue)(this, key, defaultValue);
+    },
 };
 /////////////////////////////
 /// Agregar métodos al prototipo

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

@@ -3,44 +3,58 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.collectClassMetadata = collectClassMetadata;
 require("reflect-metadata");
 const constants_1 = require("../constants");
-const method_collector_1 = require("./method.collector"); // Importamos el colector de métodos
+const method_collector_1 = require("./method.collector");
 const function_util_1 = require("../../../__internals/utils/function.util");
+const metadata_registry_1 = require("../metadata.registry");
 function collectClassMetadata(target) {
     var _a;
     const prototype = Reflect.getPrototypeOf(target);
     const constructor = prototype === null || prototype === void 0 ? void 0 : prototype.constructor;
     const name = target.name || (constructor === null || constructor === void 0 ? void 0 : constructor.name) || ((_a = target === null || target === void 0 ? void 0 : target.constructor) === null || _a === void 0 ? void 0 : _a.name);
     // Extraemos las metadata de la clase
-    const tags = Reflect.getMetadata(constants_1.TAGS, target) || [];
-    const security = Reflect.getMetadata(constants_1.SECURITY, target) || [];
+    let tags = Reflect.getMetadata(constants_1.TAGS, target) || [];
+    let security = Reflect.getMetadata(constants_1.SECURITY, target) || [];
+    // Invoke custom class collectors
+    metadata_registry_1.openApiRegistry.getCollectors("class").forEach(collector => {
+        const data = collector(target);
+        if (data === null || data === void 0 ? void 0 : data.tags)
+            tags = [...tags, ...data.tags];
+        if (data === null || data === void 0 ? void 0 : data.security)
+            security = [...security, ...data.security];
+    });
     // Si no tenemos tags, intentamos inferirlos
     if (tags.length === 0) {
-        tags.push({ name }); // El nombre de la clase podría ser un tag
+        tags.push({ name });
     }
     // Si no tenemos seguridad, intentamos asignar un valor predeterminado
     if (security.length === 0) {
-        security.push({ bearerAuth: [] }); // Se puede ajustar según la seguridad predeterminada de la clase
+        security.push({ bearerAuth: [] });
     }
     // Obtenemos todos los métodos de la clase
-    const methodNames = Object.getOwnPropertyNames(target.prototype).filter((method) => method !== "constructor");
+    const methodNames = Object.getOwnPropertyNames(target.prototype || {}).filter((method) => method !== "constructor");
     // Creamos una lista con la metadata de cada uno de los métodos
     const methods = {};
     methodNames.forEach((methodName) => {
         let methodMetadata = (0, method_collector_1.collectMethodMetadata)(target.prototype, methodName);
+        // Invoke custom method collectors
+        metadata_registry_1.openApiRegistry.getCollectors("method").forEach(collector => {
+            const data = collector(target.prototype, methodName);
+            methodMetadata = Object.assign(Object.assign({}, methodMetadata), data);
+        });
         // Si el método no tiene parámetros definidos, intentamos inferirlos
         if (!methodMetadata.parameters || methodMetadata.parameters.length === 0) {
             const methodParams = (0, function_util_1.extractArgsNames)(target.prototype[methodName]);
             methodParams === null || methodParams === void 0 ? void 0 : methodParams.forEach((paramName, index) => {
-                var _a;
                 const inferredParam = {
                     name: paramName || `param${index}`,
-                    in: "query", // Asignamos por defecto 'query', esto puede mejorarse según el contexto
+                    in: "query",
                     required: true,
                     schema: {
-                        type: "string", // Asignamos 'string' por defecto, también mejorable
+                        type: "string",
                     },
                 };
-                (_a = methodMetadata.parameters) === null || _a === void 0 ? void 0 : _a.push(inferredParam);
+                methodMetadata.parameters || (methodMetadata.parameters = []);
+                methodMetadata.parameters.push(inferredParam);
             });
         }
         methods[methodName] = methodMetadata;

package/dist/lib/openapi/collectors/index.d.ts

@@ -1,3 +1,4 @@
 export * from "./class.collector";
 export * from "./method.collector";
 export * from "./param.collector";
+export * from "./schema.collector";

package/dist/lib/openapi/collectors/index.js

@@ -17,3 +17,4 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./class.collector"), exports);
 __exportStar(require("./method.collector"), exports);
 __exportStar(require("./param.collector"), exports);
+__exportStar(require("./schema.collector"), exports);

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

@@ -1,3 +1,2 @@
-import 'reflect-metadata';
 import { Operation } from '../types';
 export declare function collectMethodMetadata(target: any, methodName: string): Operation;

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

@@ -1,15 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.collectMethodMetadata = collectMethodMetadata;
-require("reflect-metadata");
 const constants_1 = require("../constants");
-const param_collector_1 = require("./param.collector"); // Importamos el colector de parámetros
+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 = {};
     // Extraemos la metadata del método
     const summary = Reflect.getMetadata(constants_1.METHOD_SUMMARY, target, methodName);
     const operationId = Reflect.getMetadata(constants_1.METHOD_OPERATION_ID, target, methodName);
     const tags = Reflect.getMetadata(constants_1.METHOD_TAGS, target, methodName);
+    const security = Reflect.getMetadata(constants_1.SECURITY, target, methodName);
     // Extraemos las respuestas del método
     const responses = Reflect.getMetadata(constants_1.RESPONSES, target, methodName) || {};
     // Extraemos los parámetros del método
@@ -19,6 +22,20 @@ 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
+                };
+            }
+        }
+    }
     // Asignamos las propiedades al objeto de metadata solo si existen
     if (summary)
         methodMetadata.summary = summary;
@@ -26,6 +43,8 @@ function collectMethodMetadata(target, methodName) {
         methodMetadata.operationId = operationId;
     if (tags)
         methodMetadata.tags = tags;
+    if (security)
+        methodMetadata.security = security;
     if (responses && Object.keys(responses).length > 0)
         methodMetadata.responses = responses;
     if (parameters.length > 0)