@hemia/common 0.0.3 → 0.0.4

package/dist/hemia-common.esm.js

@@ -8,7 +8,10 @@ const METADATA_KEYS = {
     REDIRECT: 'redirect',
     GUARDS: 'hemia:guards',
     INTERCEPTORS: 'hemia:interceptors',
-    CUSTOM: 'hemia:custom'
+    CUSTOM: 'hemia:custom',
+    SERIALIZE: 'hemia:serialize',
+    ROLES: 'hemia:roles',
+    PERMISSIONS: 'hemia:permissions'
 };
 
 const Controller = (basePath = '/') => {
@@ -135,6 +138,30 @@ function UseInterceptors(...interceptors) {
     };
 }
 
+/**
+ * Decorador que asigna metadata personalizada a una clase o método.
+ * @param metadataKey La clave para guardar la metadata (string, symbol, etc.)
+ * @param metadataValue El valor a guardar (objeto, array, primitivo, etc.)
+ */
+const SetMetadata = (metadataKey, metadataValue) => {
+    return (target, key, descriptor) => {
+        if (descriptor) {
+            Reflect.defineMetadata(metadataKey, metadataValue, descriptor.value);
+            return descriptor;
+        }
+        Reflect.defineMetadata(metadataKey, metadataValue, target);
+        return target;
+    };
+};
+
+/**
+ * Decorador que transforma la respuesta saliente a una instancia del DTO proporcionado.
+ * @param dto La clase DTO a la que quieres convertir la respuesta.
+ */
+function Serialize(dto) {
+    return SetMetadata(METADATA_KEYS.SERIALIZE, dto);
+}
+
 class ApiResponse {
     static success(data, message = 'OK', status = 200) {
         return {
@@ -223,4 +250,4 @@ class HttpErrorWithDetails extends HttpError {
     }
 }
 
-export { ApiResponse, BadRequestError, Body, ConflictError, Controller, CustomHttpError, Delete, ForbiddenError, GatewayTimeoutError, Get, Head, Header, Headers, Host, HttpError, HttpErrorWithDetails, HttpMethod, InternalServerError, Ip, METADATA_KEYS, Next, NotFoundError, Options, Param, ParamType, Patch, Post, Put, Query, Redirect, Req, Request, Res, Response, ServiceUnavailableError, Session, UnauthorizedError, UnprocessableEntityError, UseGuards, UseInterceptors, isRedirectResponse };
+export { ApiResponse, BadRequestError, Body, ConflictError, Controller, CustomHttpError, Delete, ForbiddenError, GatewayTimeoutError, Get, Head, Header, Headers, Host, HttpError, HttpErrorWithDetails, HttpMethod, InternalServerError, Ip, METADATA_KEYS, Next, NotFoundError, Options, Param, ParamType, Patch, Post, Put, Query, Redirect, Req, Request, Res, Response, Serialize, ServiceUnavailableError, Session, SetMetadata, UnauthorizedError, UnprocessableEntityError, UseGuards, UseInterceptors, isRedirectResponse };

package/dist/hemia-common.js

@@ -10,7 +10,10 @@ const METADATA_KEYS = {
     REDIRECT: 'redirect',
     GUARDS: 'hemia:guards',
     INTERCEPTORS: 'hemia:interceptors',
-    CUSTOM: 'hemia:custom'
+    CUSTOM: 'hemia:custom',
+    SERIALIZE: 'hemia:serialize',
+    ROLES: 'hemia:roles',
+    PERMISSIONS: 'hemia:permissions'
 };
 
 const Controller = (basePath = '/') => {
@@ -137,6 +140,30 @@ function UseInterceptors(...interceptors) {
     };
 }
 
+/**
+ * Decorador que asigna metadata personalizada a una clase o método.
+ * @param metadataKey La clave para guardar la metadata (string, symbol, etc.)
+ * @param metadataValue El valor a guardar (objeto, array, primitivo, etc.)
+ */
+const SetMetadata = (metadataKey, metadataValue) => {
+    return (target, key, descriptor) => {
+        if (descriptor) {
+            Reflect.defineMetadata(metadataKey, metadataValue, descriptor.value);
+            return descriptor;
+        }
+        Reflect.defineMetadata(metadataKey, metadataValue, target);
+        return target;
+    };
+};
+
+/**
+ * Decorador que transforma la respuesta saliente a una instancia del DTO proporcionado.
+ * @param dto La clase DTO a la que quieres convertir la respuesta.
+ */
+function Serialize(dto) {
+    return SetMetadata(METADATA_KEYS.SERIALIZE, dto);
+}
+
 class ApiResponse {
     static success(data, message = 'OK', status = 200) {
         return {
@@ -257,8 +284,10 @@ exports.Req = Req;
 exports.Request = Request;
 exports.Res = Res;
 exports.Response = Response;
+exports.Serialize = Serialize;
 exports.ServiceUnavailableError = ServiceUnavailableError;
 exports.Session = Session;
+exports.SetMetadata = SetMetadata;
 exports.UnauthorizedError = UnauthorizedError;
 exports.UnprocessableEntityError = UnprocessableEntityError;
 exports.UseGuards = UseGuards;

package/dist/types/decorators/auth/index.d.ts

@@ -0,0 +1,2 @@
+export * from './roles.decorator';
+export * from './permissions.decorator';

package/dist/types/decorators/auth/permissions.decorator.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Define los permisos específicos requeridos para acceder a un recurso.
+ * @param permissions Lista de permisos (ej: 'read:users', 'write:posts')
+ */
+export declare const Permissions: (...permissions: string[]) => (target: object | Function, key?: string | symbol, descriptor?: PropertyDescriptor) => object;

package/dist/types/decorators/auth/roles.decorator.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Define los roles requeridos para acceder a un recurso.
+ * @param roles Lista de roles (ej: 'admin', 'user')
+ */
+export declare const Roles: (...roles: string[]) => (target: object | Function, key?: string | symbol, descriptor?: PropertyDescriptor) => object;

package/dist/types/decorators/core/index.d.ts

@@ -1,2 +1,4 @@
 export * from "./use-guards.decorator";
 export * from "./use-interceptors.decorator";
+export * from "./set-metadata.decorator";
+export * from "./serialize.decorator";

package/dist/types/decorators/core/serialize.decorator.d.ts

@@ -0,0 +1,9 @@
+import { Type } from "../../interfaces";
+export interface SerializeOptions {
+    excludeExtraneousValues?: boolean;
+}
+/**
+ * Decorador que transforma la respuesta saliente a una instancia del DTO proporcionado.
+ * @param dto La clase DTO a la que quieres convertir la respuesta.
+ */
+export declare function Serialize(dto: Type<any>): (target: object | Function, key?: string | symbol, descriptor?: PropertyDescriptor) => object;

package/dist/types/decorators/core/set-metadata.decorator.d.ts

@@ -0,0 +1,7 @@
+import 'reflect-metadata';
+/**
+ * Decorador que asigna metadata personalizada a una clase o método.
+ * @param metadataKey La clave para guardar la metadata (string, symbol, etc.)
+ * @param metadataValue El valor a guardar (objeto, array, primitivo, etc.)
+ */
+export declare const SetMetadata: <K = string | symbol, V = any>(metadataKey: K, metadataValue: V) => (target: object | Function, key?: string | symbol, descriptor?: PropertyDescriptor) => object;

package/dist/types/decorators/metadata.d.ts

@@ -7,4 +7,7 @@ export declare const METADATA_KEYS: {
     readonly GUARDS: "hemia:guards";
     readonly INTERCEPTORS: "hemia:interceptors";
     readonly CUSTOM: "hemia:custom";
+    readonly SERIALIZE: "hemia:serialize";
+    readonly ROLES: "hemia:roles";
+    readonly PERMISSIONS: "hemia:permissions";
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hemia/common",
-  "version": "0.0.3",
+  "version": "0.0.4",
   "description": "Paquete común para proyectos de Hemia",
   "main": "dist/hemia-common.js",
   "module": "dist/hemia-common.esm.js",