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

package/cjs/interceptors/index.js

@@ -4,11 +4,8 @@ Object.defineProperty(exports, "__esModule", {
 });
 _export_star(require("./delete-empty-id-from-body.interceptor"), exports);
 _export_star(require("./idempotency.interceptor"), exports);
-_export_star(require("./query-performance.interceptor"), exports);
 _export_star(require("./response-meta.interceptor"), exports);
-_export_star(require("./set-create-by-on-body.interceptor"), exports);
-_export_star(require("./set-delete-by-on-body.interceptor"), exports);
-_export_star(require("./set-update-by-on-body.interceptor"), exports);
+_export_star(require("./set-user-field-on-body.interceptor"), exports);
 _export_star(require("./slug.interceptor"), exports);
 function _export_star(from, to) {
     Object.keys(from).forEach(function(k) {

package/cjs/interceptors/set-user-field-on-body.interceptor.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: Object.getOwnPropertyDescriptor(all, name).get
+    });
+}
+_export(exports, {
+    get SetCreatedByOnBody () {
+        return SetCreatedByOnBody;
+    },
+    get SetDeletedByOnBody () {
+        return SetDeletedByOnBody;
+    },
+    get SetUpdateByOnBody () {
+        return SetUpdateByOnBody;
+    },
+    get createSetUserFieldInterceptor () {
+        return createSetUserFieldInterceptor;
+    }
+});
+const _common = require("@nestjs/common");
+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 createSetUserFieldInterceptor(fieldName) {
+    let SetUserFieldOnBody = class SetUserFieldOnBody {
+        intercept(context, next) {
+            const request = context.switchToHttp().getRequest();
+            const user = request?.user;
+            if (user) {
+                if (Array.isArray(request.body)) {
+                    request.body = request.body.map((item)=>({
+                            ...item,
+                            [fieldName]: user.id
+                        }));
+                } else if (typeof request.body === 'object' && request.body !== null) {
+                    request.body = {
+                        ...request.body,
+                        [fieldName]: user.id
+                    };
+                }
+            }
+            return next.handle();
+        }
+    };
+    SetUserFieldOnBody = _ts_decorate([
+        (0, _common.Injectable)()
+    ], SetUserFieldOnBody);
+    return SetUserFieldOnBody;
+}
+const SetCreatedByOnBody = createSetUserFieldInterceptor('createdById');
+const SetUpdateByOnBody = createSetUserFieldInterceptor('updatedById');
+const SetDeletedByOnBody = createSetUserFieldInterceptor('deletedById');

package/cjs/interceptors/slug.interceptor.js

@@ -29,26 +29,47 @@ function _ts_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);
+}
+function _ts_param(paramIndex, decorator) {
+    return function(target, key) {
+        decorator(target, key, paramIndex);
+    };
+}
 let Slug = class Slug {
     intercept(context, next) {
         const request = context.switchToHttp().getRequest();
         if (Array.isArray(request.body)) {
-            request.body = request.body.map((item)=>({
-                    ...item,
-                    slug: item.slug || (item?.name ? this.utilsService.transformToSlug(item.name) : null)
-                }));
-        } else if (!request.body.slug) {
+            request.body = request.body.map((item)=>{
+                // Only generate slug if not provided and name exists
+                if (!item.slug && item?.name) {
+                    return {
+                        ...item,
+                        slug: this.utilsService.transformToSlug(item.name)
+                    };
+                }
+                return item;
+            });
+        } else if (!request.body?.slug && request.body?.name) {
+            // Only generate slug if not provided and name exists
             request.body = {
                 ...request.body,
-                slug: request.body?.name ? this.utilsService.transformToSlug(request.body?.name) : null
+                slug: this.utilsService.transformToSlug(request.body.name)
             };
         }
         return next.handle();
     }
-    constructor(){
-        _define_property(this, "utilsService", new _utilsservice.UtilsService());
+    constructor(utilsService){
+        _define_property(this, "utilsService", void 0);
+        this.utilsService = utilsService;
     }
 };
 Slug = _ts_decorate([
-    (0, _common.Injectable)()
+    (0, _common.Injectable)(),
+    _ts_param(0, (0, _common.Inject)(_utilsservice.UtilsService)),
+    _ts_metadata("design:type", Function),
+    _ts_metadata("design:paramtypes", [
+        typeof _utilsservice.UtilsService === "undefined" ? Object : _utilsservice.UtilsService
+    ])
 ], Slug);

package/cjs/interfaces/datasource.interface.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});

package/cjs/interfaces/event-manager-adapter.interface.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "EVENT_MANAGER_ADAPTER", {
+    enumerable: true,
+    get: function() {
+        return EVENT_MANAGER_ADAPTER;
+    }
+});
+const EVENT_MANAGER_ADAPTER = 'EVENT_MANAGER_ADAPTER';

package/cjs/interfaces/index.js

@@ -3,10 +3,12 @@ Object.defineProperty(exports, "__esModule", {
     value: true
 });
 _export_star(require("./api.interface"), exports);
-_export_star(require("./base-query.interface"), exports);
+_export_star(require("./datasource.interface"), exports);
+_export_star(require("./event-manager-adapter.interface"), exports);
 _export_star(require("./identity.interface"), exports);
 _export_star(require("./logged-user-info.interface"), exports);
-_export_star(require("./logger.interface"), exports);
+_export_star(require("./module-config.interface"), exports);
+_export_star(require("./notification-adapter.interface"), exports);
 _export_star(require("./permission.interface"), exports);
 function _export_star(from, to) {
     Object.keys(from).forEach(function(k) {

package/cjs/interfaces/module-config.interface.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});

package/cjs/interfaces/notification-adapter.interface.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "NOTIFICATION_ADAPTER", {
+    enumerable: true,
+    get: function() {
+        return NOTIFICATION_ADAPTER;
+    }
+});
+const NOTIFICATION_ADAPTER = 'NOTIFICATION_ADAPTER';

package/cjs/interfaces/permission.interface.js

@@ -1,4 +1,4 @@
-"use strict";
+/** Action node - checks a single permission/action code */ "use strict";
 Object.defineProperty(exports, "__esModule", {
     value: true
 });

package/cjs/middlewares/logger.middleware.js

@@ -26,12 +26,6 @@ _export(exports, {
     },
     get requestContext () {
         return requestContext;
-    },
-    get setCompanyId () {
-        return setCompanyId;
-    },
-    get setUserId () {
-        return setUserId;
     }
 });
 const _config = require("@flusys/nestjs-core/config");
@@ -60,44 +54,87 @@ function _ts_decorate(decorators, target, key, desc) {
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
 // Configuration
-const IS_DEBUG = _config.envConfig.getLogConfig().level === 'debug';
+const logConfig = _config.envConfig.getLogConfig();
+const IS_DEBUG = logConfig.level === 'debug';
+const DISABLE_HTTP_LOGGING = logConfig.disableHttpLogging;
 const TENANT_ID_HEADER = 'x-tenant-id';
 const EXCLUDED_PATHS = [
     '/health',
     '/metrics',
     '/favicon.ico'
 ];
-const EXCLUDED_HEADERS = [
-    'authorization',
-    'cookie',
-    'x-api-key'
-];
 const MAX_BODY_LOG_SIZE = 1000;
 const requestContext = new _async_hooks.AsyncLocalStorage();
 const getRequestId = ()=>requestContext.getStore()?.requestId;
 const getTenantId = ()=>requestContext.getStore()?.tenantId;
 const getUserId = ()=>requestContext.getStore()?.userId;
 const getCompanyId = ()=>requestContext.getStore()?.companyId;
-const setUserId = (userId)=>{
-    const store = requestContext.getStore();
-    if (store) store.userId = userId;
-};
-const setCompanyId = (companyId)=>{
-    const store = requestContext.getStore();
-    if (store) store.companyId = companyId;
-};
 // Helper Functions
-function sanitizeHeaders(headers) {
-    const sanitized = {};
-    for (const [key, value] of Object.entries(headers)){
-        sanitized[key] = EXCLUDED_HEADERS.includes(key.toLowerCase()) ? '[REDACTED]' : value;
+function summarizeRequestBody(body) {
+    if (!body) return undefined;
+    const parsed = typeof body === 'string' ? tryParseJson(body) : body;
+    if (!parsed || typeof parsed !== 'object') {
+        const str = String(body);
+        return str.length > MAX_BODY_LOG_SIZE ? str.substring(0, MAX_BODY_LOG_SIZE) + '...' : str;
     }
-    return sanitized;
+    // For API request bodies, provide a concise summary
+    const summary = {};
+    // Pagination info
+    if (parsed.pagination) {
+        summary.page = parsed.pagination.currentPage;
+        summary.pageSize = parsed.pagination.pageSize;
+    }
+    // Filter keys only (not values - may contain sensitive data)
+    if (parsed.filter && typeof parsed.filter === 'object') {
+        const filterKeys = Object.keys(parsed.filter);
+        if (filterKeys.length > 0) summary.filterKeys = filterKeys;
+    }
+    // Select fields count
+    if (Array.isArray(parsed.select) && parsed.select.length > 0) {
+        summary.selectCount = parsed.select.length;
+    }
+    // Sort keys
+    if (parsed.sort && typeof parsed.sort === 'object') {
+        const sortKeys = Object.keys(parsed.sort);
+        if (sortKeys.length > 0) summary.sortKeys = sortKeys;
+    }
+    // ID for single item operations
+    if (parsed.id) summary.id = parsed.id;
+    // IDs for bulk operations
+    if (Array.isArray(parsed.ids)) summary.idsCount = parsed.ids.length;
+    return Object.keys(summary).length > 0 ? JSON.stringify(summary) : '{}';
 }
-function truncateBody(body) {
+function summarizeResponseBody(body) {
     if (!body) return undefined;
-    const str = typeof body === 'string' ? body : JSON.stringify(body);
-    return str.length > MAX_BODY_LOG_SIZE ? str.substring(0, MAX_BODY_LOG_SIZE) + '...' : body;
+    const parsed = typeof body === 'string' ? tryParseJson(body) : body;
+    if (!parsed || typeof parsed !== 'object') {
+        const str = String(body);
+        return str.length > MAX_BODY_LOG_SIZE ? str.substring(0, MAX_BODY_LOG_SIZE) + '...' : str;
+    }
+    const summary = {};
+    if ('success' in parsed) summary.success = parsed.success;
+    if ('message' in parsed) summary.message = parsed.message;
+    if ('code' in parsed) summary.code = parsed.code;
+    if (Array.isArray(parsed.data)) {
+        summary.dataCount = parsed.data.length;
+    } else if (parsed.data && typeof parsed.data === 'object') {
+        summary.hasData = true;
+    }
+    if (parsed.meta) {
+        summary.total = parsed.meta.total;
+        summary.page = parsed.meta.page;
+    }
+    if (parsed.errors) {
+        summary.errorsCount = Array.isArray(parsed.errors) ? parsed.errors.length : 1;
+    }
+    return JSON.stringify(summary);
+}
+function tryParseJson(str) {
+    try {
+        return JSON.parse(str);
+    } catch  {
+        return null;
+    }
 }
 function getClientIp(req) {
     return req.headers['x-forwarded-for']?.split(',')[0] || req.socket?.remoteAddress || 'unknown';
@@ -107,136 +144,117 @@ let LoggerMiddleware = class LoggerMiddleware {
         const requestId = req.headers[_constants.REQUEST_ID_HEADER] || (0, _uuid.v4)();
         const tenantId = req.headers[TENANT_ID_HEADER];
         const startTime = Date.now();
-        // Set response header
         res.setHeader(_constants.REQUEST_ID_HEADER, requestId);
-        // Create context
         const context = {
             requestId,
             tenantId,
             startTime
         };
-        // Run in AsyncLocalStorage context
         requestContext.run(context, ()=>{
-            // Check if we should skip logging
-            const shouldSkipLogging = EXCLUDED_PATHS.some((path)=>req.originalUrl.startsWith(path));
+            const shouldSkipLogging = DISABLE_HTTP_LOGGING || EXCLUDED_PATHS.some((path)=>req.originalUrl.startsWith(path));
             if (!shouldSkipLogging) {
                 this.logRequest(req, requestId, tenantId);
-                // Track if response was already logged
-                let responseLogged = false;
-                // Capture response using multiple hooks to ensure we catch it
-                const originalSend = res.send;
-                const originalJson = res.json;
-                const originalEnd = res.end;
-                // Store reference to this for use in callbacks
-                const self = this;
-                // Override res.send
-                res.send = function(body) {
-                    if (!responseLogged) {
-                        responseLogged = true;
-                        self.logResponse(req, res, startTime, body, requestId, tenantId);
-                    }
-                    return originalSend.call(this, body);
-                };
-                // Override res.json
-                res.json = function(body) {
-                    if (!responseLogged) {
-                        responseLogged = true;
-                        self.logResponse(req, res, startTime, body, requestId, tenantId);
-                    }
-                    return originalJson.call(this, body);
-                };
-                // Override res.end as fallback
-                res.end = function(...args) {
-                    if (!responseLogged) {
-                        responseLogged = true;
-                        self.logResponse(req, res, startTime, args[0], requestId, tenantId);
-                    }
-                    return originalEnd.apply(this, args);
-                };
-                // Handle errors
-                res.on('error', (error)=>{
-                    this.logger.error('Response error', {
-                        context: 'HTTP',
-                        requestId,
-                        tenantId,
-                        method: req.method,
-                        url: req.originalUrl,
-                        path: req.path,
-                        error: error.message,
-                        stack: error.stack
-                    });
-                });
+                this.setupResponseLogging(req, res, startTime, requestId, tenantId);
             }
             next();
         });
     }
+    setupResponseLogging(req, res, startTime, requestId, tenantId) {
+        let responseLogged = false;
+        const originalSend = res.send;
+        const originalJson = res.json;
+        const originalEnd = res.end;
+        const self = this;
+        const logOnce = (body)=>{
+            if (!responseLogged) {
+                responseLogged = true;
+                self.logResponse(req, res, startTime, body, requestId, tenantId);
+            }
+        };
+        res.send = function(body) {
+            logOnce(body);
+            return originalSend.call(this, body);
+        };
+        res.json = function(body) {
+            logOnce(body);
+            return originalJson.call(this, body);
+        };
+        res.end = function(...args) {
+            logOnce(args[0]);
+            return originalEnd.apply(this, args);
+        };
+        res.on('error', (error)=>{
+            this.logger.error('Response error', {
+                ...this.buildBaseLogData(req, requestId, tenantId),
+                error: error.message,
+                stack: error.stack
+            });
+        });
+    }
     logRequest(req, requestId, tenantId) {
+        const ip = getClientIp(req);
+        const contentType = req.headers['content-type'] || 'none';
+        // Build descriptive message like: Started processing request "POST" "/api/users" from "192.168.1.1"
+        const message = `Started processing request "${req.method}" "${req.originalUrl}" from "${ip}"`;
         const logData = {
-            context: 'HTTP',
-            requestId,
-            tenantId,
-            method: req.method,
-            url: req.originalUrl,
-            path: req.path,
+            ...this.buildBaseLogData(req, requestId, tenantId),
             query: Object.keys(req.query).length > 0 ? req.query : undefined,
-            ip: getClientIp(req),
+            ip,
             userAgent: req.headers['user-agent'],
-            contentType: req.headers['content-type'],
+            contentType,
             contentLength: req.headers['content-length']
         };
-        // Add debug details if enabled
         if (IS_DEBUG) {
-            logData.headers = sanitizeHeaders(req.headers);
-            logData.body = truncateBody(req.body);
-            logData.params = Object.keys(req.params).length > 0 ? req.params : undefined;
+            logData.body = summarizeRequestBody(req.body);
         }
-        this.logger.info('Incoming request', logData);
+        this.logger.info(message, logData);
     }
     logResponse(req, res, startTime, body, requestId, tenantId) {
         const duration = Date.now() - startTime;
         const statusCode = res.statusCode;
         const level = statusCode >= 500 ? 'error' : statusCode >= 400 ? 'warn' : 'info';
+        const userId = getUserId();
+        const companyId = getCompanyId();
+        const contentType = res.getHeader('content-type') || 'none';
+        const contentLength = res.getHeader('content-length') || 'null';
+        // Build descriptive message like: Request finished "HTTP/1.1" "POST" "/api/users" - 200 "application/json" 534.29ms
+        const message = `Request finished "HTTP/1.1" "${req.method}" "${req.originalUrl}" - ${statusCode} ${contentLength} "${contentType}" ${duration.toFixed(2)}ms`;
         const logData = {
-            context: 'HTTP',
-            requestId,
-            tenantId,
-            method: req.method,
-            url: req.originalUrl,
-            path: req.path,
+            ...this.buildBaseLogData(req, requestId, tenantId),
+            userId,
+            companyId,
             statusCode,
             statusMessage: res.statusMessage,
             duration: `${duration}ms`,
             durationMs: duration,
-            contentType: res.getHeader('content-type'),
-            contentLength: res.getHeader('content-length')
+            contentType,
+            contentLength
         };
-        // Add user context if available
-        const userId = getUserId();
-        const companyId = getCompanyId();
-        if (userId) logData.userId = userId;
-        if (companyId) logData.companyId = companyId;
-        // Add response body for errors or debug mode
         if (statusCode >= 400 || IS_DEBUG) {
-            logData.responseBody = truncateBody(body);
+            logData.responseBody = summarizeResponseBody(body);
         }
-        this.logger.log(level, `Response [${statusCode}]`, logData);
-        // Log slow requests separately
+        this.logger.log(level, message, logData);
         if (duration > 3000 && statusCode < 400) {
-            this.logger.warn('Slow request detected', {
-                context: 'HTTP',
-                requestId,
-                tenantId,
+            this.logger.warn(`Slow request detected: "${req.method}" "${req.originalUrl}" took ${duration}ms (threshold: 3000ms)`, {
+                ...this.buildBaseLogData(req, requestId, tenantId),
                 userId,
                 companyId,
-                method: req.method,
-                url: req.originalUrl,
-                path: req.path,
                 duration: `${duration}ms`,
                 durationMs: duration,
                 threshold: '3000ms'
             });
         }
     }
+    buildBaseLogData(req, requestId, tenantId) {
+        return {
+            context: 'HTTP',
+            requestId,
+            tenantId,
+            method: req.method,
+            url: req.originalUrl,
+            path: req.path
+        };
+    }
     constructor(){
         _define_property(this, "logger", _winstonloggerclass.instance);
     }

package/cjs/modules/cache/cache.module.js

@@ -8,8 +8,8 @@ Object.defineProperty(exports, "CacheModule", {
         return CacheModule;
     }
 });
-const _classes = require("@flusys/nestjs-shared/classes");
-const _constants = require("@flusys/nestjs-shared/constants");
+const _hybridcacheclass = require("../../classes/hybrid-cache.class");
+const _constants = require("../../constants");
 const _common = require("@nestjs/common");
 function _ts_decorate(decorators, target, key, desc) {
     var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
@@ -25,7 +25,7 @@ let CacheModule = class CacheModule {
             providers: [
                 {
                     provide: _constants.CACHE_INSTANCE,
-                    useFactory: ()=>new _classes.HybridCache(memoryTtl, memorySize)
+                    useFactory: ()=>new _hybridcacheclass.HybridCache(memoryTtl, memorySize)
                 }
             ],
             exports: [

package/cjs/modules/datasource/index.js

@@ -2,7 +2,6 @@
 Object.defineProperty(exports, "__esModule", {
     value: true
 });
-_export_star(require("./datasource.module"), exports);
 _export_star(require("./multi-tenant-datasource.service"), exports);
 function _export_star(from, to) {
     Object.keys(from).forEach(function(k) {