@flusys/nestjs-shared 1.1.0-beta → 1.2.0-rc.1

package/cjs/decorators/log-action.decorator.js

@@ -0,0 +1,149 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "LogAction", {
+    enumerable: true,
+    get: function() {
+        return LogAction;
+    }
+});
+const _common = require("@nestjs/common");
+const _winstonloggerclass = require("../classes/winston.logger.class");
+const _loggermiddleware = require("../middlewares/logger.middleware");
+function createLoggerAdapter(className, moduleName) {
+    if (moduleName) {
+        const winstonLogger = (0, _winstonloggerclass.createModuleLogger)(moduleName);
+        return {
+            log: (level, message, meta)=>{
+                winstonLogger.log(level, message, {
+                    context: className,
+                    ...meta
+                });
+            },
+            error: (message, stack, meta)=>{
+                winstonLogger.error(message, {
+                    context: className,
+                    stack,
+                    ...meta
+                });
+            }
+        };
+    }
+    const nestLogger = new _common.Logger(className);
+    return {
+        log: (level, message, meta)=>{
+            nestLogger[level](message, meta);
+        },
+        error: (message, stack, meta)=>{
+            nestLogger.error(message, stack, meta);
+        }
+    };
+}
+function LogAction(options = {}) {
+    return function(target, propertyKey, descriptor) {
+        const originalMethod = descriptor.value;
+        const className = target.constructor.name;
+        const methodName = String(propertyKey);
+        descriptor.value = async function(...args) {
+            const startTime = Date.now();
+            // Resolve module: decorator option > instance property > undefined
+            const moduleName = options.module || this.moduleName;
+            const logger = createLoggerAdapter(className, moduleName);
+            const action = options.action || `${this.entityName || className}.${methodName}`;
+            const logLevel = options.logLevel || 'debug';
+            const context = {
+                requestId: (0, _loggermiddleware.getRequestId)(),
+                userId: (0, _loggermiddleware.getUserId)(),
+                tenantId: (0, _loggermiddleware.getTenantId)(),
+                companyId: (0, _loggermiddleware.getCompanyId)(),
+                method: methodName,
+                module: moduleName
+            };
+            const startMessage = `Executing action method "${action}"`;
+            const startContext = options.includeParams ? {
+                ...context,
+                params: sanitizeParams(args)
+            } : context;
+            logger.log(logLevel, startMessage, startContext);
+            try {
+                const result = await originalMethod.apply(this, args);
+                const duration = Date.now() - startTime;
+                const resultType = getResultType(result);
+                const successMessage = `Executed action method "${action}", returned result "${resultType}" in ${duration.toFixed(2)}ms.`;
+                const successContext = options.includeResult && result ? {
+                    ...context,
+                    duration: `${duration}ms`,
+                    resultType,
+                    resultPreview: getResultPreview(result)
+                } : {
+                    ...context,
+                    duration: `${duration}ms`,
+                    resultType
+                };
+                logger.log(logLevel, successMessage, successContext);
+                return result;
+            } catch (error) {
+                const duration = Date.now() - startTime;
+                const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+                logger.error(`Failed action method "${action}" after ${duration.toFixed(2)}ms: ${errorMessage}`, error instanceof Error ? error.stack : undefined, {
+                    ...context,
+                    duration: `${duration}ms`,
+                    error: errorMessage
+                });
+                throw error;
+            }
+        };
+        return descriptor;
+    };
+}
+function sanitizeParams(args) {
+    return args.map((arg)=>{
+        if (arg === null || arg === undefined) return arg;
+        if (typeof arg === 'object') {
+            const sanitized = {
+                ...arg
+            };
+            const sensitiveKeys = [
+                'password',
+                'secret',
+                'token',
+                'apiKey',
+                'authorization'
+            ];
+            for (const key of Object.keys(sanitized)){
+                if (sensitiveKeys.some((sk)=>key.toLowerCase().includes(sk))) {
+                    sanitized[key] = '[REDACTED]';
+                }
+            }
+            return sanitized;
+        }
+        return arg;
+    });
+}
+function getResultType(result) {
+    if (result === null) return 'null';
+    if (result === undefined) return 'undefined';
+    if (Array.isArray(result)) return `Array<${result.length} items>`;
+    if (typeof result === 'object') {
+        const name = result.constructor?.name;
+        return name && name !== 'Object' ? name : 'Object';
+    }
+    return typeof result;
+}
+function getResultPreview(result) {
+    if (Array.isArray(result)) {
+        return {
+            count: result.length,
+            sample: result.slice(0, 2)
+        };
+    }
+    if (typeof result === 'object' && result !== null) {
+        const keys = Object.keys(result).slice(0, 5);
+        return {
+            keys,
+            hasMore: Object.keys(result).length > 5
+        };
+    }
+    return result;
+}

package/cjs/decorators/require-permission.decorator.js

@@ -15,18 +15,18 @@ _export(exports, {
     get RequirePermission () {
         return RequirePermission;
     },
-    get RequirePermissionCondition () {
-        return RequirePermissionCondition;
+    get RequirePermissionLogic () {
+        return RequirePermissionLogic;
     }
 });
 const _common = require("@nestjs/common");
 const _constants = require("../constants");
 const RequirePermission = (...permissions)=>(0, _common.SetMetadata)(_constants.PERMISSIONS_KEY, {
         permissions,
-        operator: 'and'
+        operator: 'AND'
     });
 const RequireAnyPermission = (...permissions)=>(0, _common.SetMetadata)(_constants.PERMISSIONS_KEY, {
         permissions,
-        operator: 'or'
+        operator: 'OR'
     });
-const RequirePermissionCondition = (condition)=>(0, _common.SetMetadata)(_constants.PERMISSIONS_KEY, condition);
+const RequirePermissionLogic = (logic)=>(0, _common.SetMetadata)(_constants.PERMISSIONS_KEY, logic);

package/cjs/dtos/delete.dto.js

@@ -36,6 +36,7 @@ let DeleteDto = class DeleteDto {
     constructor(){
         _define_property(this, "id", void 0);
         _define_property(this, "type", void 0);
+        _define_property(this, "deletedById", void 0);
     }
 };
 _ts_decorate([
@@ -80,3 +81,12 @@ _ts_decorate([
     ]),
     _ts_metadata("design:type", String)
 ], DeleteDto.prototype, "type", void 0);
+_ts_decorate([
+    (0, _swagger.ApiPropertyOptional)({
+        description: 'User ID who initiated the deletion (auto-set by interceptor)',
+        example: 'f2e9c8d0-7a2a-11eb-9439-0242ac130002'
+    }),
+    (0, _classvalidator.IsOptional)(),
+    (0, _classvalidator.IsUUID)(),
+    _ts_metadata("design:type", String)
+], DeleteDto.prototype, "deletedById", void 0);

package/cjs/dtos/filter-and-pagination.dto.js

@@ -49,7 +49,6 @@ let FilterAndPaginationDto = class FilterAndPaginationDto {
         _define_property(this, "sort", void 0);
         _define_property(this, "select", void 0);
         _define_property(this, "withDeleted", void 0);
-        _define_property(this, "extraKey", void 0);
     }
 };
 _ts_decorate([
@@ -97,7 +96,7 @@ _ts_decorate([
         type: [
             String
         ],
-        description: 'Fields to return. If empty, returns all fields.',
+        description: 'Fields to return. Must be valid field names (alphanumeric, underscores only). If empty, returns all fields.',
         example: [
             'id',
             'name',
@@ -107,6 +106,17 @@ _ts_decorate([
     }),
     (0, _classvalidator.IsOptional)(),
     (0, _classvalidator.IsArray)(),
+    (0, _classvalidator.IsString)({
+        each: true
+    }),
+    (0, _classvalidator.Matches)(/^[a-zA-Z_][a-zA-Z0-9_]*$/, {
+        each: true,
+        message: 'Select fields must be valid identifiers (alphanumeric and underscores only)'
+    }),
+    (0, _classvalidator.MaxLength)(64, {
+        each: true,
+        message: 'Field names must be 64 characters or less'
+    }),
     _ts_metadata("design:type", Array)
 ], FilterAndPaginationDto.prototype, "select", void 0);
 _ts_decorate([
@@ -119,25 +129,9 @@ _ts_decorate([
     (0, _classvalidator.IsBoolean)(),
     _ts_metadata("design:type", Boolean)
 ], FilterAndPaginationDto.prototype, "withDeleted", void 0);
-_ts_decorate([
-    (0, _swagger.ApiPropertyOptional)({
-        type: [
-            String
-        ],
-        description: 'Additional relation keys to include',
-        example: [
-            'category',
-            'createdBy'
-        ]
-    }),
-    (0, _classvalidator.IsOptional)(),
-    (0, _classvalidator.IsArray)(),
-    _ts_metadata("design:type", Array)
-], FilterAndPaginationDto.prototype, "extraKey", void 0);
 let GetByIdBodyDto = class GetByIdBodyDto {
     constructor(){
         _define_property(this, "select", void 0);
-        _define_property(this, "extraKey", void 0);
     }
 };
 _ts_decorate([
@@ -145,7 +139,7 @@ _ts_decorate([
         type: [
             String
         ],
-        description: 'Fields to return. If empty, returns all fields.',
+        description: 'Fields to return. Must be valid field names (alphanumeric, underscores only). If empty, returns all fields.',
         example: [
             'id',
             'name',
@@ -155,20 +149,16 @@ _ts_decorate([
     }),
     (0, _classvalidator.IsOptional)(),
     (0, _classvalidator.IsArray)(),
-    _ts_metadata("design:type", Array)
-], GetByIdBodyDto.prototype, "select", void 0);
-_ts_decorate([
-    (0, _swagger.ApiPropertyOptional)({
-        type: [
-            String
-        ],
-        description: 'Additional relation keys to include',
-        example: [
-            'category',
-            'createdBy'
-        ]
+    (0, _classvalidator.IsString)({
+        each: true
+    }),
+    (0, _classvalidator.Matches)(/^[a-zA-Z_][a-zA-Z0-9_]*$/, {
+        each: true,
+        message: 'Select fields must be valid identifiers (alphanumeric and underscores only)'
+    }),
+    (0, _classvalidator.MaxLength)(64, {
+        each: true,
+        message: 'Field names must be 64 characters or less'
     }),
-    (0, _classvalidator.IsOptional)(),
-    (0, _classvalidator.IsArray)(),
     _ts_metadata("design:type", Array)
-], GetByIdBodyDto.prototype, "extraKey", void 0);
+], GetByIdBodyDto.prototype, "select", void 0);

package/cjs/dtos/get-by-ids.dto.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "GetByIdsDto", {
+    enumerable: true,
+    get: function() {
+        return GetByIdsDto;
+    }
+});
+const _swagger = require("@nestjs/swagger");
+const _classvalidator = require("class-validator");
+function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+function _ts_decorate(decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for(var i = decorators.length - 1; i >= 0; i--)if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+function _ts_metadata(k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+let GetByIdsDto = class GetByIdsDto {
+    constructor(){
+        _define_property(this, "ids", void 0);
+        _define_property(this, "select", void 0);
+    }
+};
+_ts_decorate([
+    (0, _swagger.ApiProperty)({
+        description: 'Array of IDs to retrieve',
+        type: [
+            String
+        ],
+        example: [
+            'uuid-1',
+            'uuid-2'
+        ]
+    }),
+    (0, _classvalidator.IsNotEmpty)(),
+    (0, _classvalidator.IsArray)(),
+    (0, _classvalidator.IsUUID)('all', {
+        each: true
+    }),
+    _ts_metadata("design:type", Array)
+], GetByIdsDto.prototype, "ids", void 0);
+_ts_decorate([
+    (0, _swagger.ApiPropertyOptional)({
+        description: 'Select specific fields to return (comma-separated or array)'
+    }),
+    (0, _classvalidator.IsOptional)(),
+    _ts_metadata("design:type", Object)
+], GetByIdsDto.prototype, "select", void 0);

package/cjs/dtos/identity-response.dto.js

@@ -8,8 +8,8 @@ Object.defineProperty(exports, "IdentityResponseDto", {
         return IdentityResponseDto;
     }
 });
-const _classtransformer = require("class-transformer");
 const _swagger = require("@nestjs/swagger");
+const _classtransformer = require("class-transformer");
 function _define_property(obj, key, value) {
     if (key in obj) {
         Object.defineProperty(obj, key, {
@@ -44,28 +44,28 @@ let IdentityResponseDto = class IdentityResponseDto {
     }
 };
 _ts_decorate([
+    (0, _classtransformer.Expose)(),
     (0, _swagger.ApiProperty)({
         type: String,
         format: 'uuid'
     }),
-    (0, _classtransformer.Expose)(),
     _ts_metadata("design:type", String)
 ], IdentityResponseDto.prototype, "id", void 0);
 _ts_decorate([
+    (0, _classtransformer.Expose)(),
     (0, _swagger.ApiProperty)({
         type: String,
         format: 'date-time'
     }),
-    (0, _classtransformer.Expose)(),
     (0, _classtransformer.Type)(()=>Date),
     _ts_metadata("design:type", typeof Date === "undefined" ? Object : Date)
 ], IdentityResponseDto.prototype, "createdAt", void 0);
 _ts_decorate([
+    (0, _classtransformer.Expose)(),
     (0, _swagger.ApiProperty)({
         type: String,
         format: 'date-time'
     }),
-    (0, _classtransformer.Expose)(),
     (0, _classtransformer.Type)(()=>Date),
     _ts_metadata("design:type", typeof Date === "undefined" ? Object : Date)
 ], IdentityResponseDto.prototype, "updatedAt", void 0);
@@ -76,7 +76,6 @@ _ts_decorate([
         nullable: true,
         required: false
     }),
-    (0, _classtransformer.Expose)(),
     (0, _classtransformer.Type)(()=>Date),
     _ts_metadata("design:type", Object)
 ], IdentityResponseDto.prototype, "deletedAt", void 0);
@@ -87,7 +86,6 @@ _ts_decorate([
         nullable: true,
         required: false
     }),
-    (0, _classtransformer.Expose)(),
     _ts_metadata("design:type", Object)
 ], IdentityResponseDto.prototype, "createdById", void 0);
 _ts_decorate([
@@ -97,7 +95,6 @@ _ts_decorate([
         nullable: true,
         required: false
     }),
-    (0, _classtransformer.Expose)(),
     _ts_metadata("design:type", Object)
 ], IdentityResponseDto.prototype, "updatedById", void 0);
 _ts_decorate([
@@ -107,6 +104,5 @@ _ts_decorate([
         nullable: true,
         required: false
     }),
-    (0, _classtransformer.Expose)(),
     _ts_metadata("design:type", Object)
 ], IdentityResponseDto.prototype, "deletedById", void 0);

package/cjs/dtos/index.js

@@ -4,6 +4,7 @@ Object.defineProperty(exports, "__esModule", {
 });
 _export_star(require("./delete.dto"), exports);
 _export_star(require("./filter-and-pagination.dto"), exports);
+_export_star(require("./get-by-ids.dto"), exports);
 _export_star(require("./identity-response.dto"), exports);
 _export_star(require("./pagination.dto"), exports);
 _export_star(require("./response-payload.dto"), exports);

package/cjs/dtos/pagination.dto.js

@@ -35,17 +35,13 @@ function _ts_metadata(k, v) {
 }
 let PaginationDto = class PaginationDto {
     constructor(){
-        /**
-   * Number of items per page. Defaults to 10 when not provided or invalid.
-   */ _define_property(this, "pageSize", 10);
-        /**
-   * Zero-based page index. Defaults to 0 when not provided or invalid.
-   */ _define_property(this, "currentPage", 0);
+        _define_property(this, "pageSize", 10);
+        _define_property(this, "currentPage", 0);
     }
 };
 _ts_decorate([
     (0, _swagger.ApiPropertyOptional)({
-        description: 'Number of items per page. Defaults to 10 when not provided or invalid.',
+        description: 'Number of items per page (default: 10)',
         example: 10
     }),
     (0, _classvalidator.IsOptional)(),
@@ -58,7 +54,7 @@ _ts_decorate([
 ], PaginationDto.prototype, "pageSize", void 0);
 _ts_decorate([
     (0, _swagger.ApiPropertyOptional)({
-        description: 'Zero-based page index. Defaults to 0 when not provided or invalid.',
+        description: 'Zero-based page index (default: 0)',
         example: 0
     }),
     (0, _classvalidator.IsOptional)(),