@flusys/nestjs-shared 3.0.1 → 4.0.0-lts

package/fesm/utils/query-helpers.util.js

@@ -1,4 +1,5 @@
 import { BadRequestException } from '@nestjs/common';
+import { AUTH_MESSAGES } from '../constants';
 /**
  * Apply company filter to a query builder if company feature is enabled.
  * Centralizes the common pattern of filtering by user's company.
@@ -72,7 +73,13 @@ import { BadRequestException } from '@nestjs/common';
  */ export function validateCompanyOwnership(entity, user, isCompanyFeatureEnabled, entityName) {
     if (isCompanyFeatureEnabled && user?.companyId && hasCompanyId(entity)) {
         if (entity.companyId && entity.companyId !== user.companyId) {
-            throw new BadRequestException(`${entityName} belongs to another company`);
+            throw new BadRequestException({
+                message: `${entityName} belongs to another company`,
+                messageKey: AUTH_MESSAGES.COMPANY_NO_ACCESS,
+                messageParams: {
+                    entity: entityName
+                }
+            });
         }
     }
 }

package/filters/global-exception.filter.d.ts

@@ -0,0 +1,10 @@
+import { ArgumentsHost, ExceptionFilter } from '@nestjs/common';
+export declare class GlobalExceptionFilter implements ExceptionFilter {
+    private readonly logger;
+    catch(exception: unknown, host: ArgumentsHost): void;
+    private buildErrorResponse;
+    private extractHttpExceptionDetails;
+    private getStatusCode;
+    private getStack;
+    private buildLogMessage;
+}

package/filters/index.d.ts

@@ -0,0 +1 @@
+export * from './global-exception.filter';

package/guards/permission.guard.d.ts

@@ -1,14 +1,12 @@
 import { CanActivate, ExecutionContext } from '@nestjs/common';
 import { Reflector } from '@nestjs/core';
 import { HybridCache } from '../classes/hybrid-cache.class';
-import { ILogger } from '../interfaces/logger.interface';
 import { PermissionGuardConfig } from '../interfaces/permission.interface';
 export declare class PermissionGuard implements CanActivate {
     private readonly reflector;
     private readonly cache?;
     private readonly config;
-    private readonly logger;
-    constructor(reflector: Reflector, cache?: HybridCache, config?: PermissionGuardConfig, logger?: ILogger);
+    constructor(reflector: Reflector, cache?: HybridCache, config?: PermissionGuardConfig);
     canActivate(context: ExecutionContext): Promise<boolean>;
     private normalizeToLogicNode;
     private evaluateLogicNode;

package/index.d.ts

@@ -5,6 +5,7 @@ export * from './dtos';
 export * from './entities';
 export * from './enums';
 export * from './exceptions';
+export * from './filters';
 export * from './guards';
 export * from './interceptors';
 export * from './interfaces';

package/interceptors/index.d.ts

@@ -1,6 +1,5 @@
 export * from './delete-empty-id-from-body.interceptor';
 export * from './idempotency.interceptor';
-export * from './query-performance.interceptor';
 export * from './response-meta.interceptor';
 export * from './set-user-field-on-body.interceptor';
 export * from './slug.interceptor';

package/interfaces/logger.interface.d.ts

@@ -1,7 +1,7 @@
 export interface ILogger {
-    log(message: string, context?: string, ...args: any[]): void;
-    error(message: string, trace?: string, context?: string, ...args: any[]): void;
-    warn(message: string, context?: string, ...args: any[]): void;
-    debug(message: string, context?: string, ...args: any[]): void;
-    verbose(message: string, context?: string, ...args: any[]): void;
+    log(message: string, context?: string, ...args: unknown[]): void;
+    error(message: string, trace?: string, context?: string, ...args: unknown[]): void;
+    warn(message: string, context?: string, ...args: unknown[]): void;
+    debug(message: string, context?: string, ...args: unknown[]): void;
+    verbose(message: string, context?: string, ...args: unknown[]): void;
 }

package/modules/datasource/multi-tenant-datasource.service.d.ts

@@ -1,11 +1,10 @@
 import { DatabaseMode, IDatabaseConfig, IDataSourceServiceOptions, ITenantDatabaseConfig } from '@flusys/nestjs-core';
-import { Logger, OnModuleDestroy } from '@nestjs/common';
+import { OnModuleDestroy } from '@nestjs/common';
 import { Request } from 'express';
 import { DataSource, EntityTarget, ObjectLiteral, Repository } from 'typeorm';
 export declare class MultiTenantDataSourceService implements OnModuleDestroy {
     protected readonly options?: IDataSourceServiceOptions;
     protected readonly request?: Request;
-    protected readonly logger: Logger;
     protected static readonly tenantConnections: Map<string, DataSource>;
     protected static singleDataSource: DataSource | null;
     protected static readonly tenantsRegistry: Map<string, ITenantDatabaseConfig>;

package/modules/utils/utils.service.d.ts

@@ -1,6 +1,5 @@
 import { HybridCache } from '../../classes/hybrid-cache.class';
 export declare class UtilsService {
-    private readonly logger;
     getCacheKey(entityName: string, params: any, entityId?: string, tenantId?: string): string;
     trackCacheKey(cacheKey: string, entityName: string, cacheManager: HybridCache, entityId?: string, tenantId?: string): Promise<void>;
     clearCache(entityName: string, cacheManager: HybridCache, entityId?: string, tenantId?: string): Promise<void>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flusys/nestjs-shared",
-  "version": "3.0.1",
+  "version": "4.0.0-lts",
   "description": "Common shared utilities for Flusys NestJS applications",
   "main": "cjs/index.js",
   "module": "fesm/index.js",
@@ -107,9 +107,11 @@
     "keyv": "^5.0.0",
     "typeorm": "^0.3.0",
     "winston": "^3.0.0",
-    "winston-daily-rotate-file": "^5.0.0"
+    "winston-daily-rotate-file": "^5.0.0",
+    "express": "^4.18.0",
+    "rxjs": "^7.8.0"
   },
   "dependencies": {
-    "@flusys/nestjs-core": "3.0.1"
+    "@flusys/nestjs-core": "4.0.0-lts"
   }
 }

package/utils/index.d.ts

@@ -1,4 +1,3 @@
-export * from './error-handler.util';
 export * from './html-sanitizer.util';
 export * from './query-helpers.util';
 export * from './request.util';

package/cjs/interceptors/query-performance.interceptor.js

@@ -1,66 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "QueryPerformanceInterceptor", {
-    enumerable: true,
-    get: function() {
-        return QueryPerformanceInterceptor;
-    }
-});
-const _common = require("@nestjs/common");
-const _operators = require("rxjs/operators");
-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 QueryPerformanceInterceptor = class QueryPerformanceInterceptor {
-    intercept(context, next) {
-        const request = context.switchToHttp().getRequest();
-        const { method, url } = request;
-        const handler = context.getHandler().name;
-        const controller = context.getClass().name;
-        const startTime = Date.now();
-        return next.handle().pipe((0, _operators.tap)(()=>{
-            const executionTime = Date.now() - startTime;
-            if (executionTime > this.threshold) {
-                this.logger.warn(`Slow request detected: ${method} ${url} | ` + `Controller: ${controller}.${handler} | ` + `Execution time: ${executionTime}ms`);
-            } else {
-                // Optional: Log all requests in debug mode
-                this.logger.debug(`${method} ${url} | ${controller}.${handler} | ${executionTime}ms`);
-            }
-        }));
-    }
-    /**
-   * @param threshold - Time threshold in milliseconds (default: 1000ms)
-   */ constructor(threshold = 1000){
-        _define_property(this, "logger", new _common.Logger(QueryPerformanceInterceptor.name));
-        _define_property(this, "threshold", void 0);
-        this.threshold = threshold;
-    }
-};
-QueryPerformanceInterceptor = _ts_decorate([
-    (0, _common.Injectable)(),
-    _ts_metadata("design:type", Function),
-    _ts_metadata("design:paramtypes", [
-        Number
-    ])
-], QueryPerformanceInterceptor);

package/cjs/utils/error-handler.util.js

@@ -1,90 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "ErrorHandler", {
-    enumerable: true,
-    get: function() {
-        return ErrorHandler;
-    }
-});
-/** Sensitive keys that should be redacted from logs */ const SENSITIVE_KEYS = [
-    'password',
-    'secret',
-    'token',
-    'apiKey',
-    'credential',
-    'authorization'
-];
-let ErrorHandler = class ErrorHandler {
-    /**
-   * Safely extract error message from unknown error.
-   */ static getErrorMessage(error) {
-        if (error instanceof Error) {
-            return error.message;
-        }
-        if (typeof error === 'string') {
-            return error;
-        }
-        return 'Unknown error occurred';
-    }
-    /**
-   * Sanitize context data to redact sensitive fields from logs.
-   */ static sanitizeContextForLogging(context) {
-        const sanitized = {};
-        for (const [key, value] of Object.entries(context)){
-            const isSensitive = SENSITIVE_KEYS.some((sk)=>key.toLowerCase().includes(sk.toLowerCase()));
-            if (isSensitive) {
-                sanitized[key] = '[REDACTED]';
-            } else if (Array.isArray(value)) {
-                sanitized[key] = value.map((item)=>typeof item === 'object' && item !== null ? this.sanitizeContextForLogging(item) : item);
-            } else if (typeof value === 'object' && value !== null) {
-                sanitized[key] = this.sanitizeContextForLogging(value);
-            } else {
-                sanitized[key] = value;
-            }
-        }
-        return sanitized;
-    }
-    /**
-   * Create error context object for internal logging.
-   */ static createErrorContext(error, context) {
-        const errorContext = {
-            error: {
-                message: this.getErrorMessage(error)
-            }
-        };
-        if (error instanceof Error) {
-            errorContext.error.stack = error.stack;
-            errorContext.error.name = error.name;
-        }
-        if (context && Object.keys(context).length > 0) {
-            errorContext.context = this.sanitizeContextForLogging(context);
-        }
-        return errorContext;
-    }
-    /**
-   * Log error with consistent format.
-   */ static logError(logger, error, operation, context) {
-        const errorContext = this.createErrorContext(error, {
-            operation,
-            ...context
-        });
-        const errorMessage = `Failed to ${operation}: ${errorContext.error.message}`;
-        logger.error(errorMessage, errorContext.error.stack, errorContext);
-    }
-    /**
-   * Re-throw error with proper type checking.
-   */ static rethrowError(error) {
-        if (error instanceof Error) {
-            throw error;
-        }
-        throw new Error(`Unexpected error: ${String(error)}`);
-    }
-    /**
-   * Log error and re-throw (common pattern).
-   */ static logAndRethrow(logger, error, operation, context) {
-        this.logError(logger, error, operation, context);
-        this.rethrowError(error);
-    }
-};

package/fesm/interceptors/query-performance.interceptor.js

@@ -1,56 +0,0 @@
-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);
-}
-import { Injectable, Logger } from '@nestjs/common';
-import { tap } from 'rxjs/operators';
-export class QueryPerformanceInterceptor {
-    intercept(context, next) {
-        const request = context.switchToHttp().getRequest();
-        const { method, url } = request;
-        const handler = context.getHandler().name;
-        const controller = context.getClass().name;
-        const startTime = Date.now();
-        return next.handle().pipe(tap(()=>{
-            const executionTime = Date.now() - startTime;
-            if (executionTime > this.threshold) {
-                this.logger.warn(`Slow request detected: ${method} ${url} | ` + `Controller: ${controller}.${handler} | ` + `Execution time: ${executionTime}ms`);
-            } else {
-                // Optional: Log all requests in debug mode
-                this.logger.debug(`${method} ${url} | ${controller}.${handler} | ${executionTime}ms`);
-            }
-        }));
-    }
-    /**
-   * @param threshold - Time threshold in milliseconds (default: 1000ms)
-   */ constructor(threshold = 1000){
-        _define_property(this, "logger", new Logger(QueryPerformanceInterceptor.name));
-        _define_property(this, "threshold", void 0);
-        this.threshold = threshold;
-    }
-}
-QueryPerformanceInterceptor = _ts_decorate([
-    Injectable(),
-    _ts_metadata("design:type", Function),
-    _ts_metadata("design:paramtypes", [
-        Number
-    ])
-], QueryPerformanceInterceptor);

package/fesm/utils/error-handler.util.js

@@ -1,82 +0,0 @@
-/** Sensitive keys that should be redacted from logs */ const SENSITIVE_KEYS = [
-    'password',
-    'secret',
-    'token',
-    'apiKey',
-    'credential',
-    'authorization'
-];
-/**
- * Error handling utility for consistent error logging and handling.
- */ export class ErrorHandler {
-    /**
-   * Safely extract error message from unknown error.
-   */ static getErrorMessage(error) {
-        if (error instanceof Error) {
-            return error.message;
-        }
-        if (typeof error === 'string') {
-            return error;
-        }
-        return 'Unknown error occurred';
-    }
-    /**
-   * Sanitize context data to redact sensitive fields from logs.
-   */ static sanitizeContextForLogging(context) {
-        const sanitized = {};
-        for (const [key, value] of Object.entries(context)){
-            const isSensitive = SENSITIVE_KEYS.some((sk)=>key.toLowerCase().includes(sk.toLowerCase()));
-            if (isSensitive) {
-                sanitized[key] = '[REDACTED]';
-            } else if (Array.isArray(value)) {
-                sanitized[key] = value.map((item)=>typeof item === 'object' && item !== null ? this.sanitizeContextForLogging(item) : item);
-            } else if (typeof value === 'object' && value !== null) {
-                sanitized[key] = this.sanitizeContextForLogging(value);
-            } else {
-                sanitized[key] = value;
-            }
-        }
-        return sanitized;
-    }
-    /**
-   * Create error context object for internal logging.
-   */ static createErrorContext(error, context) {
-        const errorContext = {
-            error: {
-                message: this.getErrorMessage(error)
-            }
-        };
-        if (error instanceof Error) {
-            errorContext.error.stack = error.stack;
-            errorContext.error.name = error.name;
-        }
-        if (context && Object.keys(context).length > 0) {
-            errorContext.context = this.sanitizeContextForLogging(context);
-        }
-        return errorContext;
-    }
-    /**
-   * Log error with consistent format.
-   */ static logError(logger, error, operation, context) {
-        const errorContext = this.createErrorContext(error, {
-            operation,
-            ...context
-        });
-        const errorMessage = `Failed to ${operation}: ${errorContext.error.message}`;
-        logger.error(errorMessage, errorContext.error.stack, errorContext);
-    }
-    /**
-   * Re-throw error with proper type checking.
-   */ static rethrowError(error) {
-        if (error instanceof Error) {
-            throw error;
-        }
-        throw new Error(`Unexpected error: ${String(error)}`);
-    }
-    /**
-   * Log error and re-throw (common pattern).
-   */ static logAndRethrow(logger, error, operation, context) {
-        this.logError(logger, error, operation, context);
-        this.rethrowError(error);
-    }
-}

package/interceptors/query-performance.interceptor.d.ts

@@ -1,8 +0,0 @@
-import { CallHandler, ExecutionContext, NestInterceptor } from '@nestjs/common';
-import { Observable } from 'rxjs';
-export declare class QueryPerformanceInterceptor implements NestInterceptor {
-    private readonly logger;
-    private readonly threshold;
-    constructor(threshold?: number);
-    intercept(context: ExecutionContext, next: CallHandler): Observable<any>;
-}

package/utils/error-handler.util.d.ts

@@ -1,19 +0,0 @@
-import { Logger } from '@nestjs/common';
-export interface IErrorContext {
-    operation?: string;
-    entity?: string;
-    userId?: string;
-    id?: string;
-    companyId?: string;
-    branchId?: string;
-    sectionId?: string;
-    data?: Record<string, unknown>;
-}
-export declare class ErrorHandler {
-    static getErrorMessage(error: unknown): string;
-    private static sanitizeContextForLogging;
-    private static createErrorContext;
-    static logError(logger: Logger, error: unknown, operation: string, context?: Omit<IErrorContext, 'operation'>): void;
-    static rethrowError(error: unknown): never;
-    static logAndRethrow(logger: Logger, error: unknown, operation: string, context?: Omit<IErrorContext, 'operation'>): never;
-}