@zenofolio/hyper-decor 1.0.59 → 1.0.61

package/dist/__internals/creators/request.creator.d.ts

@@ -1,6 +1,5 @@
 import "reflect-metadata";
-import { Request } from "hyper-express";
-import { ByPassKeys } from "../stores/params.store";
+import { Request } from "hyper-express/types";
 import { ParameterResolver } from "../../decorators";
 /**
  * Creates a parameter decorator for handling request data.
@@ -9,4 +8,4 @@ import { ParameterResolver } from "../../decorators";
  * @param {IParamsResolver} resolver - Resolver function to handle the parameter.
  * @returns {ParameterDecorator} - The parameter decorator function.
  */
-export default function createParamDecorator(key: keyof Request | ByPassKeys, decoratorName: string, resolver: ParameterResolver): ParameterDecorator;
+export default function createParamDecorator(key: keyof Request | "req" | "res", decoratorName: string, resolver: ParameterResolver): ParameterDecorator;

package/dist/__internals/creators/routes.creator.d.ts

@@ -1,11 +1,9 @@
 import "reflect-metadata";
-import { Request, Response } from "hyper-express";
 /**
  * Helper function to create route decorators for HTTP methods.
  *
  * @param {string} method - The HTTP method (e.g., GET, POST).
- * @param {(req: Request, res: Response) => any} [resolver] - Optional resolver for the route.
  * @returns {(path?: string) => MethodDecorator} - A method decorator for defining routes.
  *
  */
-export default function createRouteDecorator<T extends any = undefined>(method: string, resolver?: (req: Request, res: Response) => any): (path?: string, options?: T) => MethodDecorator & ClassDecorator;
+export default function createRouteDecorator<T extends any = undefined>(method: string): (path?: string, options?: T) => MethodDecorator & ClassDecorator;

package/dist/__internals/creators/routes.creator.js

@@ -8,11 +8,10 @@ const decorator_base_1 = require("../decorator-base");
  * Helper function to create route decorators for HTTP methods.
  *
  * @param {string} method - The HTTP method (e.g., GET, POST).
- * @param {(req: Request, res: Response) => any} [resolver] - Optional resolver for the route.
  * @returns {(path?: string) => MethodDecorator} - A method decorator for defining routes.
  *
  */
-function createRouteDecorator(method, resolver) {
+function createRouteDecorator(method) {
     return (path = "/", options) => (0, decorator_base_1.DecoratorHelper)({
         type: constants_1.KEY_TYPE_CONTROLLER,
         key: constants_1.KEY_PARAMS_ROUTE,

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

@@ -14,7 +14,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.prepareApplication = prepareApplication;
 const hyper_express_1 = require("hyper-express");
-const collectors_1 = require("../../collectors");
+const stores_1 = require("../../stores");
 const role_transform_1 = __importDefault(require("../transform/role.transform"));
 const scope_transfrom_1 = __importDefault(require("../transform/scope.transfrom"));
 const object_util_1 = require("../utils/object.util");
@@ -84,7 +84,7 @@ function prepareApplication(options, Target, app, log) {
                 .join(", ")}`);
         }
         (0, scope_transfrom_1.default)(data.scopes, (middleware, scopes) => {
-            collectors_1.ScopeStore.addAll(scopes);
+            stores_1.ScopeStore.addAll(scopes);
             app.use(middleware);
             log("middleware", `${Target.name} with scopes: ${data.scopes.join(", ")}`);
         });
@@ -139,7 +139,7 @@ function prepareTarget(_a) {
         ////////////////////////////////
         _router.use(...middlewares);
         (0, scope_transfrom_1.default)(scopes, (middleware, scopes) => {
-            collectors_1.ScopeStore.addAll(scopes);
+            stores_1.ScopeStore.addAll(scopes);
             _router.use(middleware);
         });
         (0, role_transform_1.default)(roles, (middleware) => _router.use(middleware));
@@ -220,7 +220,7 @@ function prepareRoutes(_a) {
         (0, role_transform_1.default)(metadata.roles, (middleware) => middlewares.push(middleware));
         (0, scope_transfrom_1.default)(metadata.scopes, (middleware, scopes) => {
             middlewares.push(middleware);
-            collectors_1.ScopeStore.addAll(scopes);
+            stores_1.ScopeStore.addAll(scopes);
         });
         log("routes", `${namespace}/${propertyKey} ${method.toUpperCase()} { ${path} }`);
         if (!hasParams) {

package/dist/__internals/stores/metadata.store.d.ts

@@ -0,0 +1,15 @@
+interface MetadataStoreOptions {
+    target: any;
+    propertyKey?: string | symbol;
+    descriptorOrIndex?: any;
+}
+declare class MetadatStore {
+    static define(key: string | symbol, value: any, { target, propertyKey }: MetadataStoreOptions): void;
+    static get<T>(key: string | symbol, { target, propertyKey }: MetadataStoreOptions, def: T): T;
+    static list<T extends any = any>(key: string | symbol, { target, propertyKey }: MetadataStoreOptions): {
+        has: () => boolean;
+        get: () => never[];
+        set: (...value: T[]) => void;
+    };
+}
+export default MetadatStore;

package/dist/__internals/stores/metadata.store.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const object_util_1 = require("../utils/object.util");
+class MetadatStore {
+    static define(key, value, { target, propertyKey }) {
+        if (target && typeof propertyKey === "string") {
+            Reflect.defineMetadata(key, value, Reflect.get(target, propertyKey));
+        }
+        else {
+            Reflect.defineMetadata(key, value, (0, object_util_1.$constructor)(target));
+        }
+    }
+    static get(key, { target, propertyKey }, def) {
+        if (target && typeof propertyKey === "string") {
+            return Reflect.getMetadata(key, Reflect.get(target, propertyKey)) || def;
+        }
+        else {
+            return Reflect.getMetadata(key, (0, object_util_1.$constructor)(target)) || def;
+        }
+    }
+    static list(key, { target, propertyKey }) {
+        return {
+            has: () => {
+                return this.get(key, { target, propertyKey }, []).length > 0;
+            },
+            get: () => {
+                return this.get(key, { target, propertyKey }, []);
+            },
+            set: (...value) => {
+                const list = this.get(key, { target, propertyKey }, []);
+                list.push(...value);
+                this.define(key, list, { target, propertyKey });
+            },
+        };
+    }
+}
+exports.default = MetadatStore;

package/dist/__internals/transform/middleware.transform.js

@@ -3,6 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.default = middlewareTransformer;
 const tsyringe_1 = require("tsyringe");
 function middlewareTransformer(list) {
+    if (!(list === null || list === void 0 ? void 0 : list.length))
+        return [];
     return list
         .map((middleware) => {
         if (isClass(middleware)) {

package/dist/common/helpers/role.js

@@ -38,6 +38,9 @@ const hasRole = (request, role) => {
     if (!roles) {
         return false;
     }
-    return (0, object_util_1.$array)(role).every((r) => roles.includes(r));
+    if (roles.includes("*")) {
+        return true;
+    }
+    return (0, object_util_1.$array)(role).some((r) => roles.includes(r));
 };
 exports.hasRole = hasRole;

package/dist/decorators/File.d.ts

@@ -1,4 +1,4 @@
-import { Request } from "hyper-express";
+import { Request } from "hyper-express/types";
 /**
  * File upload restrictions
  *

package/dist/decorators/HyperService.d.ts

@@ -0,0 +1,14 @@
+import { Constructor } from "./types";
+interface ServiceDecoratorOptions {
+    singleton?: boolean;
+}
+/**
+ * HyperService decorator is used to register a class as a service in the tsyringe container.
+ *
+ * No matter where this decorator is applied, the class will be registered in the tsyringe container
+ * and included in the service store to be launched when the application starts.
+ *
+ * @param options.singleton - Whether to register as a singleton (default: true)
+ */
+export declare const HyperService: ({ singleton, }?: ServiceDecoratorOptions) => (target: Constructor) => void;
+export {};

package/dist/decorators/HyperService.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HyperService = void 0;
+const tsyringe_1 = require("tsyringe");
+const service_store_1 = require("../__internals/stores/service.store");
+/**
+ * HyperService decorator is used to register a class as a service in the tsyringe container.
+ *
+ * No matter where this decorator is applied, the class will be registered in the tsyringe container
+ * and included in the service store to be launched when the application starts.
+ *
+ * @param options.singleton - Whether to register as a singleton (default: true)
+ */
+const HyperService = ({ singleton = true, } = {}) => {
+    return (target) => {
+        if (!tsyringe_1.container.isRegistered(target)) {
+            if (singleton) {
+                tsyringe_1.container.registerSingleton(target);
+            }
+            else {
+                tsyringe_1.container.register(target, { useClass: target });
+            }
+        }
+        service_store_1.serviceStore.add(target);
+    };
+};
+exports.HyperService = HyperService;

package/dist/decorators/Middleware.d.ts

@@ -9,11 +9,11 @@ export declare const Middleware: {
     /**
      * Exclude middleware from matching paths.
      *
-     * @param expresiosn
+     * @param expressions
      * @param middleware
      * @returns
      */
-    exclude(expresiosn: RegExp | RegExp[], middleware: MiddlewareHandler): ClassDecorator & MethodDecorator;
+    exclude(expressions: RegExp | RegExp[], middleware: MiddlewareHandler): ClassDecorator & MethodDecorator;
     /**
      * Only run middleware on matching paths.
      *
@@ -21,5 +21,5 @@ export declare const Middleware: {
      * @param middleware
      * @returns
      */
-    only(expresiosn: RegExp | RegExp[], middleware: MiddlewareHandler): ClassDecorator & MethodDecorator;
+    only(expressions: RegExp | RegExp[], middleware: MiddlewareHandler): ClassDecorator & MethodDecorator;
 };

package/dist/decorators/Middleware.js

@@ -6,12 +6,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Middleware = void 0;
 require("reflect-metadata");
 const constants_1 = require("../__internals/constants");
-const stores_1 = __importDefault(require("../__internals/stores"));
+const metadata_store_1 = __importDefault(require("../__internals/stores/metadata.store"));
 /**
  * Middleware decorator to attach middleware to controllers, modules, and routes.
  */
-const Middleware = (...middleware) => (Target, propertyKey, descriptor) => {
-    stores_1.default.define(constants_1.KEY_PARAMS_MIDDLEWARES, middleware, {
+const Middleware = (...middleware) => (Target, propertyKey) => {
+    metadata_store_1.default.define(constants_1.KEY_PARAMS_MIDDLEWARES, middleware, {
         target: Target,
         propertyKey,
     });
@@ -20,19 +20,11 @@ exports.Middleware = Middleware;
 /**
  * Exclude middleware from matching paths.
  *
- * @param expresiosn
+ * @param expressions
  * @param middleware
  * @returns
  */
-exports.Middleware.exclude = (expresiosn, middleware) => {
-    return (0, exports.Middleware)((req, res, next) => {
-        expresiosn = Array.isArray(expresiosn) ? expresiosn : [expresiosn];
-        const excluude = expresiosn.some((exp) => exp.test(req.path));
-        if (excluude)
-            return next();
-        return middleware(req, res, next);
-    });
-};
+exports.Middleware.exclude = (expressions, middleware) => (0, exports.Middleware)(buildHandler("exclude", expressions, middleware));
 /**
  * Only run middleware on matching paths.
  *
@@ -40,12 +32,22 @@ exports.Middleware.exclude = (expresiosn, middleware) => {
  * @param middleware
  * @returns
  */
-exports.Middleware.only = (expresiosn, middleware) => {
-    return (0, exports.Middleware)((req, res, next) => {
-        expresiosn = Array.isArray(expresiosn) ? expresiosn : [expresiosn];
-        const only = expresiosn.some((exp) => exp.test(req.path));
-        if (!only)
+exports.Middleware.only = (expressions, middleware) => (0, exports.Middleware)(buildHandler("only", expressions, middleware));
+/**
+ *
+ * Helper function to build middleware handlers for "only" and "exclude" modes.
+ *
+ * @param mode
+ * @param expresions
+ * @returns
+ */
+const buildHandler = (mode, expressions, middleware) => {
+    const matchers = Array.isArray(expressions) ? expressions : [expressions];
+    return (req, res, next) => {
+        const matches = matchers.some((rx) => rx.test(req.path));
+        if ((mode === "only" && !matches) || (mode === "exclude" && matches)) {
             return next();
+        }
         return middleware(req, res, next);
-    });
+    };
 };

package/dist/decorators/Pass.d.ts

@@ -3,10 +3,13 @@ interface PassOptions {
     (req: Request, res: Response): boolean | Promise<boolean>;
 }
 /**
- * This method will pass all checks if the function returns true.
+ * Pass decorator
  *
- * @param options
- * @returns
+ * This decorator allows bypassing checks when the provided function returns `true`.
+ * It can be applied to classes or methods, but not to properties.
+ *
+ * @param options - A function that returns true to allow bypassing
+ * @returns A class or method decorator
  */
 export declare const Pass: (options: PassOptions) => ClassDecorator & MethodDecorator;
 export {};

package/dist/decorators/Pass.js

@@ -8,10 +8,13 @@ const who_helper_1 = __importDefault(require("../__internals/helpers/who.helper"
 const NotPropertyException_1 = __importDefault(require("../exeptions/NotPropertyException"));
 const constants_1 = require("../__internals/constants");
 /**
- * This method will pass all checks if the function returns true.
+ * Pass decorator
  *
- * @param options
- * @returns
+ * This decorator allows bypassing checks when the provided function returns `true`.
+ * It can be applied to classes or methods, but not to properties.
+ *
+ * @param options - A function that returns true to allow bypassing
+ * @returns A class or method decorator
  */
 const Pass = (options) => (target, propertyKey, descriptorOrIndex) => {
     const { isProperty, isMethod } = (0, who_helper_1.default)(target, propertyKey, descriptorOrIndex);

package/dist/decorators/Role.js

@@ -5,10 +5,10 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Role = void 0;
 require("reflect-metadata");
-const constants_1 = require("../__internals/constants");
-const who_helper_1 = __importDefault(require("../__internals/helpers/who.helper"));
-const stores_1 = __importDefault(require("../__internals/stores"));
 const exeptions_1 = require("../exeptions");
+const who_helper_1 = __importDefault(require("../__internals/helpers/who.helper"));
+const constants_1 = require("../__internals/constants");
+const metadata_store_1 = __importDefault(require("../__internals/stores/metadata.store"));
 /**
  * Role decorator for setting role-based access control.
  */
@@ -21,11 +21,11 @@ const Role = (roles) => (target, propertyKey, descriptorOrIndex) => {
             descriptorOrIndex,
         });
     }
-    const { isProperty, isMethod } = (0, who_helper_1.default)(target, propertyKey, descriptorOrIndex);
+    const { isProperty } = (0, who_helper_1.default)(target, propertyKey, descriptorOrIndex);
     if (isProperty) {
         throw new Error(`Scope decorator cannot be used as parameter decorator in ${target.constructor.name}.${propertyKey}`);
     }
-    const list = stores_1.default.list(constants_1.KEY_PARAMS_ROLE, {
+    const list = metadata_store_1.default.list(constants_1.KEY_PARAMS_ROLE, {
         target,
         propertyKey,
     });

package/dist/decorators/Scope.js

@@ -7,7 +7,7 @@ exports.Scope = void 0;
 require("reflect-metadata");
 const constants_1 = require("../__internals/constants");
 const who_helper_1 = __importDefault(require("../__internals/helpers/who.helper"));
-const stores_1 = __importDefault(require("../__internals/stores"));
+const metadata_store_1 = __importDefault(require("../__internals/stores/metadata.store"));
 /**
  * Scope decorator for defining access scopes.
  */
@@ -16,7 +16,7 @@ const Scope = (scopes) => (target, propertyKey, descriptorOrIndex) => {
     if (isProperty) {
         throw new Error(`Scope decorator cannot be used as parameter decorator in ${target.constructor.name}.${propertyKey}`);
     }
-    const list = stores_1.default.list(constants_1.KEY_PARAMS_SCOPE, {
+    const list = metadata_store_1.default.list(constants_1.KEY_PARAMS_SCOPE, {
         target,
         propertyKey,
     });

package/dist/decorators/index.d.ts

@@ -1,6 +1,7 @@
 export * from "./HyperApp";
 export * from "./HyperModule";
 export * from "./HyperController";
+export * from "./HyperService";
 export * from "./Middleware";
 export * from "./Scope";
 export * from "./Role";
@@ -9,4 +10,3 @@ export * from "./types";
 export * from "./Http";
 export * from "./Pass";
 export * from "./File";
-export * from "./Service";

package/dist/decorators/index.js

@@ -17,6 +17,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./HyperApp"), exports);
 __exportStar(require("./HyperModule"), exports);
 __exportStar(require("./HyperController"), exports);
+__exportStar(require("./HyperService"), exports);
 __exportStar(require("./Middleware"), exports);
 __exportStar(require("./Scope"), exports);
 __exportStar(require("./Role"), exports);
@@ -25,4 +26,3 @@ __exportStar(require("./types"), exports);
 __exportStar(require("./Http"), exports);
 __exportStar(require("./Pass"), exports);
 __exportStar(require("./File"), exports);
-__exportStar(require("./Service"), exports);

package/dist/index.d.ts

@@ -6,5 +6,5 @@ export * from "./common/helpers";
 export * from "./common/bootstrap";
 export * from "hyper-express";
 export * from "tsyringe";
-export * from "./collectors";
+export * from "./stores";
 export * from "./type";

package/dist/index.js

@@ -22,5 +22,5 @@ __exportStar(require("./common/helpers"), exports);
 __exportStar(require("./common/bootstrap"), exports);
 __exportStar(require("hyper-express"), exports);
 __exportStar(require("tsyringe"), exports);
-__exportStar(require("./collectors"), exports);
+__exportStar(require("./stores"), exports);
 __exportStar(require("./type"), exports);

package/dist/stores/index.d.ts

@@ -0,0 +1 @@
+export * from "./scope.store";

package/dist/stores/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./scope.store"), exports);

package/dist/stores/scope.store.d.ts

@@ -0,0 +1,14 @@
+import { ScopeMap } from "../decorators";
+/**
+ * This class is a store for the scopes that are defined in the application.
+ *
+ */
+export declare class ScopeStore {
+    private static scopes;
+    static add(scope: ScopeMap): void;
+    static addAll(scopes: ScopeMap[]): void;
+    static getScopes(): ScopeMap[];
+    static getScopeNames(): string[];
+    static isEmpty(): boolean;
+    static clear(): void;
+}

package/dist/stores/scope.store.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScopeStore = void 0;
+/**
+ * This class is a store for the scopes that are defined in the application.
+ *
+ */
+class ScopeStore {
+    static add(scope) {
+        this.scopes.set(scope.scope, scope); // Evita duplicados basados en el nombre del scope
+    }
+    static addAll(scopes) {
+        scopes.forEach((scope) => this.add(scope));
+    }
+    static getScopes() {
+        return Array.from(this.scopes.values());
+    }
+    static getScopeNames() {
+        return Array.from(this.scopes.keys());
+    }
+    static isEmpty() {
+        return this.scopes.size === 0;
+    }
+    static clear() {
+        this.scopes.clear();
+    }
+}
+exports.ScopeStore = ScopeStore;
+ScopeStore.scopes = new Map();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zenofolio/hyper-decor",
-  "version": "1.0.59",
+  "version": "1.0.61",
   "description": "Project core with utilities and features",
   "main": "dist/index.js",
   "author": "zenozaga",