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

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/classes/request-scoped-api.service.d.ts

@@ -1,14 +0,0 @@
-import { DataSource, EntityTarget, Repository } from 'typeorm';
-import { Identity } from '../entities';
-import { IDataSourceProvider } from '../interfaces';
-import { ApiService } from './api-service.class';
-export declare abstract class RequestScopedApiService<CreateDtoT extends object, UpdateDtoT extends {
-    id: string;
-}, InterfaceT extends Identity, EntityT extends Identity, RepositoryT extends Repository<EntityT>> extends ApiService<CreateDtoT, UpdateDtoT, InterfaceT, EntityT, RepositoryT> {
-    private repositoryInitialized;
-    protected abstract resolveEntity(): EntityTarget<EntityT>;
-    protected abstract getDataSourceProvider(): IDataSourceProvider;
-    protected ensureRepositoryInitialized(): Promise<void>;
-    protected initializeAdditionalRepositories(entities: EntityTarget<any>[]): Promise<Repository<any>[]>;
-    protected getDataSourceForService(): Promise<DataSource>;
-}

package/classes/winston-logger-adapter.class.d.ts

@@ -1,22 +0,0 @@
-import { Logger } from '@nestjs/common';
-import { ILogger } from '../interfaces/logger.interface';
-export declare class WinstonLoggerAdapter implements ILogger {
-    private readonly context?;
-    constructor(context?: string);
-    private buildLogMeta;
-    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;
-}
-export declare class NestLoggerAdapter implements ILogger {
-    private readonly logger;
-    constructor(logger: Logger);
-    private formatMessage;
-    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;
-}

package/decorators/sanitize-html.decorator.d.ts

@@ -1,2 +0,0 @@
-export declare function SanitizeHtml(): PropertyDecorator;
-export declare function SanitizeAndTrim(): PropertyDecorator;

package/fesm/classes/request-scoped-api.service.js

@@ -1,51 +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;
-}
-import { Injectable, Scope } from '@nestjs/common';
-import { ApiService } from './api-service.class';
-export class RequestScopedApiService extends ApiService {
-    async ensureRepositoryInitialized() {
-        if (!this.repositoryInitialized) {
-            const entity = this.resolveEntity();
-            const provider = this.getDataSourceProvider();
-            this.repository = await provider.getRepository(entity);
-            this.repositoryInitialized = true;
-        }
-    }
-    /** Initialize additional repositories beyond the primary entity */ async initializeAdditionalRepositories(entities) {
-        const provider = this.getDataSourceProvider();
-        const repositories = [];
-        for (const entity of entities){
-            repositories.push(await provider.getRepository(entity));
-        }
-        return repositories;
-    }
-    /** Get DataSource for direct access (transactions, custom queries) */ async getDataSourceForService() {
-        const provider = this.getDataSourceProvider();
-        return await provider.getDataSource();
-    }
-    constructor(...args){
-        super(...args), _define_property(this, "repositoryInitialized", false);
-    }
-}
-RequestScopedApiService = _ts_decorate([
-    Injectable({
-        scope: Scope.REQUEST
-    })
-], RequestScopedApiService);

package/fesm/classes/winston-logger-adapter.class.js

@@ -1,107 +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;
-}
-import { instance as winstonLogger } from './winston.logger.class';
-import { getRequestId, getUserId, getTenantId, getCompanyId } from '../middlewares/logger.middleware';
-/**
- * Get correlation context for logging
- * Automatically includes requestId, userId, tenantId, companyId if available
- */ function getCorrelationMeta() {
-    const meta = {};
-    const requestId = getRequestId();
-    const userId = getUserId();
-    const tenantId = getTenantId();
-    const companyId = getCompanyId();
-    if (requestId) meta.requestId = requestId;
-    if (userId) meta.userId = userId;
-    if (tenantId) meta.tenantId = tenantId;
-    if (companyId) meta.companyId = companyId;
-    return meta;
-}
-/**
- * Winston Logger Adapter
- * Adapts Winston logger to ILogger interface for dependency injection
- *
- * Features:
- * - Automatic correlation ID injection
- * - User ID tracking
- * - Structured metadata logging
- *
- * Usage:
- * ```typescript
- * const logger = new WinstonLoggerAdapter('MyService');
- * logger.log('Operation completed', undefined, { orderId: '123' });
- * // Output: { requestId: 'uuid', userId: 'user-id', context: 'MyService', message: 'Operation completed', orderId: '123' }
- * ```
- */ export class WinstonLoggerAdapter {
-    buildLogMeta(context, args, extra) {
-        const meta = args?.length && typeof args[0] === 'object' ? args[0] : {};
-        return {
-            context: context || this.context,
-            ...getCorrelationMeta(),
-            ...meta,
-            ...extra
-        };
-    }
-    log(message, context, ...args) {
-        winstonLogger.info(message, this.buildLogMeta(context, args));
-    }
-    error(message, trace, context, ...args) {
-        winstonLogger.error(message, this.buildLogMeta(context, args, {
-            stack: trace
-        }));
-    }
-    warn(message, context, ...args) {
-        winstonLogger.warn(message, this.buildLogMeta(context, args));
-    }
-    debug(message, context, ...args) {
-        winstonLogger.debug(message, this.buildLogMeta(context, args));
-    }
-    verbose(message, context, ...args) {
-        winstonLogger.verbose(message, this.buildLogMeta(context, args));
-    }
-    constructor(context){
-        _define_property(this, "context", void 0);
-        this.context = context;
-    }
-}
-/**
- * NestJS Logger Adapter
- * Adapts NestJS Logger to ILogger interface
- *
- * Use this when you need to use NestJS's built-in logger
- * instead of Winston (e.g., for testing)
- */ export class NestLoggerAdapter {
-    formatMessage(message, args) {
-        return args?.length ? `${message} ${JSON.stringify(args)}` : message;
-    }
-    log(message, context, ...args) {
-        this.logger.log(this.formatMessage(message, args), context);
-    }
-    error(message, trace, context, ...args) {
-        this.logger.error(this.formatMessage(message, args), trace, context);
-    }
-    warn(message, context, ...args) {
-        this.logger.warn(this.formatMessage(message, args), context);
-    }
-    debug(message, context, ...args) {
-        this.logger.debug(this.formatMessage(message, args), context);
-    }
-    verbose(message, context, ...args) {
-        this.logger.verbose(this.formatMessage(message, args), context);
-    }
-    constructor(logger){
-        _define_property(this, "logger", void 0);
-        this.logger = logger;
-    }
-}

package/fesm/decorators/sanitize-html.decorator.js

@@ -1,45 +0,0 @@
-import { Transform } from 'class-transformer';
-import { escapeHtml } from '../utils/html-sanitizer.util';
-/**
- * Decorator that sanitizes HTML content in string fields to prevent XSS attacks.
- * Applies HTML escaping during transformation (when class-transformer processes the DTO).
- *
- * @example
- * ```typescript
- * class CreateCommentDto {
- *   @SanitizeHtml()
- *   @IsString()
- *   content: string;
- * }
- * ```
- *
- * Input: '<script>alert("xss")</script>'
- * Output: '&lt;script&gt;alert(&quot;xss&quot;)&lt;/script&gt;'
- */ export function SanitizeHtml() {
-    return Transform(({ value })=>{
-        if (typeof value === 'string') {
-            return escapeHtml(value);
-        }
-        return value;
-    });
-}
-/**
- * Decorator that sanitizes HTML and trims whitespace from string fields.
- * Combines sanitization with trimming for cleaner input handling.
- *
- * @example
- * ```typescript
- * class CreatePostDto {
- *   @SanitizeAndTrim()
- *   @IsString()
- *   title: string;
- * }
- * ```
- */ export function SanitizeAndTrim() {
-    return Transform(({ value })=>{
-        if (typeof value === 'string') {
-            return escapeHtml(value.trim());
-        }
-        return value;
-    });
-}

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/interfaces/logger.interface.js

@@ -1,4 +0,0 @@
-/**
- * Logger interface for dependency injection
- * Compatible with Winston, NestJS Logger, and console
- */ export { };

package/fesm/modules/datasource/datasource.module.js

@@ -1,107 +0,0 @@
-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;
-}
-import { MODULE_OPTIONS } from '@flusys/nestjs-core';
-import { Module } from '@nestjs/common';
-import { MultiTenantDataSourceService } from './multi-tenant-datasource.service';
-export class DataSourceModule {
-    /**
-   * Register with static options
-   */ static forRoot(options) {
-        const { global = false, ...moduleOptions } = options;
-        return {
-            module: DataSourceModule,
-            global,
-            providers: [
-                {
-                    provide: MODULE_OPTIONS,
-                    useValue: moduleOptions
-                },
-                MultiTenantDataSourceService
-            ],
-            exports: [
-                MODULE_OPTIONS,
-                MultiTenantDataSourceService
-            ]
-        };
-    }
-    /**
-   * Register with async options
-   */ static forRootAsync(asyncOptions) {
-        const { global = false, imports = [] } = asyncOptions;
-        return {
-            module: DataSourceModule,
-            global,
-            imports,
-            providers: [
-                ...this.createAsyncProviders(asyncOptions),
-                MultiTenantDataSourceService
-            ],
-            exports: [
-                MODULE_OPTIONS,
-                MultiTenantDataSourceService
-            ]
-        };
-    }
-    /**
-   * Import for child modules (uses existing MODULE_OPTIONS)
-   */ static forFeature() {
-        return {
-            module: DataSourceModule,
-            providers: [
-                MultiTenantDataSourceService
-            ],
-            exports: [
-                MultiTenantDataSourceService
-            ]
-        };
-    }
-    /**
-   * Create async providers based on options
-   */ static createAsyncProviders(options) {
-        if (options.useFactory) {
-            return [
-                {
-                    provide: MODULE_OPTIONS,
-                    useFactory: options.useFactory,
-                    inject: options.inject || []
-                }
-            ];
-        }
-        if (options.useClass) {
-            return [
-                {
-                    provide: options.useClass,
-                    useClass: options.useClass
-                },
-                this.createFactoryProvider(options.useClass)
-            ];
-        }
-        if (options.useExisting) {
-            return [
-                this.createFactoryProvider(options.useExisting)
-            ];
-        }
-        return [
-            {
-                provide: MODULE_OPTIONS,
-                useValue: {}
-            }
-        ];
-    }
-    static createFactoryProvider(factoryClass) {
-        return {
-            provide: MODULE_OPTIONS,
-            useFactory: async (factory)=>factory.createOptions(),
-            inject: [
-                factoryClass
-            ]
-        };
-    }
-}
-DataSourceModule = _ts_decorate([
-    Module({})
-], DataSourceModule);

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/interfaces/logger.interface.d.ts

@@ -1,7 +0,0 @@
-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;
-}

package/modules/datasource/datasource.module.d.ts

@@ -1,19 +0,0 @@
-import { IAsyncModuleOptions, IDataSourceServiceOptions, IModuleOptionsFactory } from '@flusys/nestjs-core';
-import { DynamicModule, Type } from '@nestjs/common';
-export interface DataSourceModuleOptions extends IDataSourceServiceOptions {
-    global?: boolean;
-}
-export interface DataSourceOptionsFactory extends IModuleOptionsFactory<IDataSourceServiceOptions> {
-    createOptions(): Promise<IDataSourceServiceOptions> | IDataSourceServiceOptions;
-}
-export interface DataSourceModuleAsyncOptions extends IAsyncModuleOptions<IDataSourceServiceOptions> {
-    useClass?: Type<DataSourceOptionsFactory>;
-    useExisting?: Type<DataSourceOptionsFactory>;
-}
-export declare class DataSourceModule {
-    static forRoot(options: DataSourceModuleOptions): DynamicModule;
-    static forRootAsync(asyncOptions: DataSourceModuleAsyncOptions): DynamicModule;
-    static forFeature(): DynamicModule;
-    private static createAsyncProviders;
-    private static createFactoryProvider;
-}

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;
-}