@flusys/nestjs-shared 3.0.0 → 4.0.0-rc

package/cjs/interceptors/idempotency.interceptor.js

@@ -61,7 +61,7 @@ let IdempotencyInterceptor = class IdempotencyInterceptor {
                 throw new _common.ConflictException({
                     success: false,
                     message: 'Request is already being processed',
-                    code: 'DUPLICATE_REQUEST_IN_PROGRESS'
+                    messageKey: _constants.SYSTEM_MESSAGES.DUPLICATE_REQUEST
                 });
             }
             // Return cached response

package/cjs/interceptors/index.js

@@ -4,7 +4,6 @@ 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-user-field-on-body.interceptor"), exports);
 _export_star(require("./slug.interceptor"), exports);

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

@@ -4,10 +4,12 @@ Object.defineProperty(exports, "__esModule", {
 });
 _export_star(require("./api.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/logger.interface.js

@@ -1,7 +1,4 @@
-/**
- * Logger interface for dependency injection
- * Compatible with Winston, NestJS Logger, and console
- */ "use strict";
+"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/middlewares/logger.middleware.js

@@ -54,18 +54,15 @@ 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;
@@ -73,17 +70,71 @@ const getTenantId = ()=>requestContext.getStore()?.tenantId;
 const getUserId = ()=>requestContext.getStore()?.userId;
 const getCompanyId = ()=>requestContext.getStore()?.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;
+    }
+    // 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;
     }
-    return sanitized;
+    // 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';
@@ -100,7 +151,7 @@ let LoggerMiddleware = class LoggerMiddleware {
             startTime
         };
         requestContext.run(context, ()=>{
-            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);
                 this.setupResponseLogging(req, res, startTime, requestId, tenantId);
@@ -141,20 +192,22 @@ let LoggerMiddleware = class LoggerMiddleware {
         });
     }
     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 = {
             ...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']
         };
         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;
@@ -162,6 +215,10 @@ let LoggerMiddleware = class LoggerMiddleware {
         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 = {
             ...this.buildBaseLogData(req, requestId, tenantId),
             userId,
@@ -170,15 +227,15 @@ let LoggerMiddleware = class LoggerMiddleware {
             statusMessage: res.statusMessage,
             duration: `${duration}ms`,
             durationMs: duration,
-            contentType: res.getHeader('content-type'),
-            contentLength: res.getHeader('content-length')
+            contentType,
+            contentLength
         };
         if (statusCode >= 400 || IS_DEBUG) {
-            logData.responseBody = truncateBody(body);
+            logData.responseBody = summarizeResponseBody(body);
         }
-        this.logger.log(level, `Response [${statusCode}]`, logData);
+        this.logger.log(level, message, logData);
         if (duration > 3000 && statusCode < 400) {
-            this.logger.warn('Slow request detected', {
+            this.logger.warn(`Slow request detected: "${req.method}" "${req.originalUrl}" took ${duration}ms (threshold: 3000ms)`, {
                 ...this.buildBaseLogData(req, requestId, tenantId),
                 userId,
                 companyId,

package/cjs/modules/datasource/multi-tenant-datasource.service.js

@@ -10,6 +10,7 @@ Object.defineProperty(exports, "MultiTenantDataSourceService", {
 });
 const _nestjscore = require("@flusys/nestjs-core");
 const _common = require("@nestjs/common");
+const _constants = require("../../constants");
 const _core = require("@nestjs/core");
 const _express = require("express");
 const _typeorm = require("typeorm");
@@ -68,7 +69,10 @@ let MultiTenantDataSourceService = class MultiTenantDataSourceService {
         const tenantId = this.request.headers[this.tenantHeader];
         if (!tenantId) return null;
         if (!/^[a-zA-Z0-9_-]+$/.test(tenantId)) {
-            throw new _common.BadRequestException('Invalid tenant ID format');
+            throw new _common.BadRequestException({
+                message: 'Invalid tenant ID format',
+                messageKey: _constants.SYSTEM_MESSAGES.INVALID_TENANT_ID
+            });
         }
         return tenantId;
     }
@@ -90,7 +94,15 @@ let MultiTenantDataSourceService = class MultiTenantDataSourceService {
     }
     async getDataSourceForTenant(tenantId) {
         const tenant = this.getTenant(tenantId);
-        if (!tenant) throw new Error(`Tenant '${tenantId}' not found`);
+        if (!tenant) {
+            throw new _common.BadRequestException({
+                message: `Tenant '${tenantId}' not found`,
+                messageKey: _constants.SYSTEM_MESSAGES.TENANT_NOT_FOUND,
+                messageParams: {
+                    tenantId
+                }
+            });
+        }
         return this.getOrCreateTenantConnection(tenant);
     }
     setDataSource(dataSource) {
@@ -110,8 +122,8 @@ let MultiTenantDataSourceService = class MultiTenantDataSourceService {
             try {
                 const dataSource = await this.getOrCreateTenantConnection(tenant);
                 results.set(tenant.id, await callback(tenant, dataSource));
-            } catch (error) {
-                this.logger.error(`Error processing tenant ${tenant.id}: ${error}`);
+            } catch  {
+            // Silent failure for individual tenant
             }
         }
         return results;
@@ -128,7 +140,6 @@ let MultiTenantDataSourceService = class MultiTenantDataSourceService {
         if (connection?.isInitialized) {
             await connection.destroy();
             MultiTenantDataSourceService.tenantConnections.delete(tenantId);
-            this.logger.log(`Closed connection for tenant: ${tenantId}`);
         }
     }
     async onModuleDestroy() {
@@ -158,7 +169,10 @@ let MultiTenantDataSourceService = class MultiTenantDataSourceService {
         }
         const config = this.getDefaultDatabaseConfig();
         if (!config) {
-            throw new Error('No database config available. Provide defaultDatabaseConfig or tenantDefaultDatabaseConfig.');
+            throw new _common.InternalServerErrorException({
+                message: 'No database config available. Provide defaultDatabaseConfig or tenantDefaultDatabaseConfig.',
+                messageKey: _constants.SYSTEM_MESSAGES.DATABASE_CONFIG_NOT_AVAILABLE
+            });
         }
         // Create connection with lock to prevent race conditions
         const connectionPromise = this.createDataSourceFromConfig(config);
@@ -176,7 +190,13 @@ let MultiTenantDataSourceService = class MultiTenantDataSourceService {
    */ async getTenantDataSource() {
         const tenant = this.getCurrentTenant();
         if (!tenant) {
-            throw new Error(`Tenant not found. Ensure '${this.tenantHeader}' header is set.`);
+            throw new _common.BadRequestException({
+                message: `Tenant not found. Ensure '${this.tenantHeader}' header is set.`,
+                messageKey: _constants.SYSTEM_MESSAGES.TENANT_HEADER_REQUIRED,
+                messageParams: {
+                    header: this.tenantHeader
+                }
+            });
         }
         return this.getOrCreateTenantConnection(tenant);
     }
@@ -191,7 +211,6 @@ let MultiTenantDataSourceService = class MultiTenantDataSourceService {
         try {
             const dataSource = await connectionPromise;
             MultiTenantDataSourceService.tenantConnections.set(tenant.id, dataSource);
-            this.logger.log(`Created connection for tenant: ${tenant.id}`);
             return dataSource;
         } finally{
             MultiTenantDataSourceService.connectionLocks.delete(tenant.id);
@@ -202,7 +221,12 @@ let MultiTenantDataSourceService = class MultiTenantDataSourceService {
     }
     buildTenantDatabaseConfig(tenant) {
         const defaultConfig = this.getDefaultDatabaseConfig();
-        if (!defaultConfig) throw new Error('No default database config for multi-tenant mode.');
+        if (!defaultConfig) {
+            throw new _common.InternalServerErrorException({
+                message: 'No default database config for multi-tenant mode.',
+                messageKey: _constants.SYSTEM_MESSAGES.DATABASE_CONFIG_NOT_AVAILABLE
+            });
+        }
         return {
             type: defaultConfig.type,
             host: tenant.host ?? defaultConfig.host,
@@ -230,11 +254,9 @@ let MultiTenantDataSourceService = class MultiTenantDataSourceService {
     constructor(options, request){
         _define_property(this, "options", void 0);
         _define_property(this, "request", void 0);
-        _define_property(this, "logger", void 0);
         _define_property(this, "tenantHeader", void 0);
         this.options = options;
         this.request = request;
-        this.logger = new _common.Logger(this.constructor.name);
         this.tenantHeader = _nestjscore.DEFAULT_TENANT_HEADER;
         this.initializeFromOptions();
     }

package/cjs/modules/utils/utils.service.js

@@ -9,19 +9,6 @@ Object.defineProperty(exports, "UtilsService", {
     }
 });
 const _common = require("@nestjs/common");
-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);
@@ -47,8 +34,8 @@ let UtilsService = class UtilsService {
             const keys = await cacheManager.get(trackingKey) || [];
             if (!keys.includes(cacheKey)) keys.push(cacheKey);
             await cacheManager.set(trackingKey, keys);
-        } catch (error) {
-            this.logger.error(`Cache tracking failed for ${entityName}`, error instanceof Error ? error.stack : String(error));
+        } catch  {
+        // Silent failure - cache tracking is non-critical
         }
     }
     /**
@@ -59,8 +46,8 @@ let UtilsService = class UtilsService {
             const keys = await cacheManager.get(trackingKey) || [];
             await Promise.allSettled(keys.map((key)=>cacheManager.del(key)));
             await cacheManager.del(trackingKey);
-        } catch (error) {
-            this.logger.error(`Cache invalidation failed for ${entityName}`, error instanceof Error ? error.stack : String(error));
+        } catch  {
+        // Silent failure - cache invalidation is non-critical
         }
     }
     // ---------------- STRING HELPERS ----------------
@@ -83,9 +70,6 @@ let UtilsService = class UtilsService {
         const prefix = this.buildTenantPrefix(tenantId);
         return entityId ? `${prefix}entity_${entityName}_id_${entityId}_keys` : `${prefix}entity_${entityName}_keys`;
     }
-    constructor(){
-        _define_property(this, "logger", new _common.Logger(UtilsService.name));
-    }
 };
 UtilsService = _ts_decorate([
     (0, _common.Injectable)()

package/cjs/utils/index.js

@@ -2,7 +2,6 @@
 Object.defineProperty(exports, "__esModule", {
     value: true
 });
-_export_star(require("./error-handler.util"), exports);
 _export_star(require("./html-sanitizer.util"), exports);
 _export_star(require("./query-helpers.util"), exports);
 _export_star(require("./request.util"), exports);

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

@@ -23,6 +23,7 @@ _export(exports, {
     }
 });
 const _common = require("@nestjs/common");
+const _constants = require("../constants");
 function applyCompanyFilter(query, config, user) {
     const columnName = config.columnName ?? 'companyId';
     if (config.isCompanyFeatureEnabled && user?.companyId) {
@@ -47,7 +48,13 @@ function hasCompanyId(entity) {
 function validateCompanyOwnership(entity, user, isCompanyFeatureEnabled, entityName) {
     if (isCompanyFeatureEnabled && user?.companyId && hasCompanyId(entity)) {
         if (entity.companyId && entity.companyId !== user.companyId) {
-            throw new _common.BadRequestException(`${entityName} belongs to another company`);
+            throw new _common.BadRequestException({
+                message: `${entityName} belongs to another company`,
+                messageKey: _constants.AUTH_MESSAGES.COMPANY_NO_ACCESS,
+                messageParams: {
+                    entity: entityName
+                }
+            });
         }
     }
 }

package/classes/api-controller.class.d.ts

@@ -15,6 +15,7 @@ export type ApiSecurityConfig = {
 };
 export interface ApiControllerOptions {
     security?: ApiSecurityConfig | EndpointSecurity | SecurityLevel;
+    entityName?: string;
 }
 export declare function createApiController<CreateDtoT extends object, UpdateDtoT extends {
     id: string;

package/classes/api-service.class.d.ts

@@ -2,7 +2,6 @@ import { DeleteDto, FilterAndPaginationDto } from '../dtos';
 import { Identity } from '../entities';
 import { ILoggedUserInfo, IService } from '../interfaces';
 import { UtilsService } from '../modules/utils/utils.service';
-import { Logger } from '@nestjs/common';
 import { QueryRunner, Repository, SelectQueryBuilder } from 'typeorm';
 import { HybridCache } from './hybrid-cache.class';
 export declare abstract class ApiService<CreateDtoT extends object, UpdateDtoT extends {
@@ -12,10 +11,10 @@ export declare abstract class ApiService<CreateDtoT extends object, UpdateDtoT e
     protected repository: RepositoryT;
     protected cacheManager: HybridCache;
     protected utilsService: UtilsService;
-    protected loggerName: string;
+    protected _loggerName: string;
     protected isCacheable: boolean;
-    protected logger: Logger;
-    constructor(entityName: string, repository: RepositoryT, cacheManager: HybridCache, utilsService: UtilsService, loggerName: string, isCacheable?: boolean);
+    protected moduleName?: string;
+    constructor(entityName: string, repository: RepositoryT, cacheManager: HybridCache, utilsService: UtilsService, _loggerName: string, isCacheable?: boolean, moduleName?: string);
     insert(dto: CreateDtoT, user: ILoggedUserInfo | null): Promise<InterfaceT>;
     insertMany(dtos: Array<CreateDtoT>, user: ILoggedUserInfo | null): Promise<InterfaceT[]>;
     update(dto: UpdateDtoT, user: ILoggedUserInfo | null): Promise<InterfaceT>;
@@ -41,15 +40,11 @@ export declare abstract class ApiService<CreateDtoT extends object, UpdateDtoT e
     protected afterDeleteOperation(_entity: Array<{
         id: string;
     }>, _user: ILoggedUserInfo | null, _queryRunner: QueryRunner): Promise<void>;
-    protected getFilterQuery(query: SelectQueryBuilder<EntityT>, filter: {
-        [key: string]: any;
-    }, _user: ILoggedUserInfo | null): Promise<{
+    protected getFilterQuery(query: SelectQueryBuilder<EntityT>, filter: Record<string, unknown>, _user: ILoggedUserInfo | null): Promise<{
         query: SelectQueryBuilder<EntityT>;
         isRaw: boolean;
     }>;
-    protected getSortQuery(query: SelectQueryBuilder<EntityT>, sort: {
-        [key: string]: 'ASC' | 'DESC';
-    }, _user: ILoggedUserInfo | null): Promise<{
+    protected getSortQuery(query: SelectQueryBuilder<EntityT>, sort: Record<string, 'ASC' | 'DESC'>, _user: ILoggedUserInfo | null): Promise<{
         query: SelectQueryBuilder<EntityT>;
         isRaw: boolean;
     }>;

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

@@ -2,21 +2,22 @@ import { Logger } from '@nestjs/common';
 import { ILogger } from '../interfaces/logger.interface';
 export declare class WinstonLoggerAdapter implements ILogger {
     private readonly context?;
-    constructor(context?: string);
+    private readonly logger;
+    constructor(context?: string, moduleName?: 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;
+    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;
 }
 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;
+    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/classes/winston.logger.class.d.ts

@@ -1,2 +1,3 @@
 import { Logger } from 'winston';
 export declare const instance: Logger;
+export declare function createModuleLogger(moduleName: string): Logger;

package/constants/index.d.ts

@@ -9,3 +9,4 @@ export declare const CLIENT_TYPE_HEADER = "x-client-type";
 export declare const PERMISSIONS_CACHE_PREFIX = "permissions";
 export declare const IDEMPOTENCY_CACHE_PREFIX = "idempotency";
 export * from './permissions';
+export * from './message-keys';

package/constants/message-keys.d.ts

@@ -0,0 +1,81 @@
+export declare const AUTH_MESSAGES: {
+    readonly TOKEN_REQUIRED: "auth.token.required";
+    readonly TOKEN_INVALID: "auth.token.invalid";
+    readonly TOKEN_EXPIRED: "auth.token.expired";
+    readonly COMPANY_NO_ACCESS: "auth.company.no.access";
+};
+export declare const ERROR_MESSAGES: {
+    readonly NOT_FOUND: "error.not.found";
+    readonly VALIDATION: "error.validation";
+    readonly UNAUTHORIZED: "error.unauthorized";
+    readonly FORBIDDEN: "error.forbidden";
+    readonly CONFLICT: "error.conflict";
+    readonly INTERNAL: "error.internal";
+    readonly SERVICE_UNAVAILABLE: "error.service.unavailable";
+    readonly UNKNOWN: "error.unknown";
+    readonly HTTP: "error.http";
+    readonly GENERIC: "error.generic";
+    readonly PERMISSION_SYSTEM_UNAVAILABLE: "error.permission.system.unavailable";
+    readonly INSUFFICIENT_PERMISSIONS: "error.insufficient.permissions";
+    readonly INSUFFICIENT_PERMISSIONS_OR: "error.insufficient.permissions.or";
+    readonly NO_PERMISSIONS_FOUND: "error.no.permissions.found";
+};
+export declare const SYSTEM_MESSAGES: {
+    readonly REPOSITORY_NOT_AVAILABLE: "system.repository.not.available";
+    readonly DATASOURCE_NOT_AVAILABLE: "system.datasource.not.available";
+    readonly DATABASE_CONFIG_NOT_AVAILABLE: "system.database.config.not.available";
+    readonly SERVICE_NOT_AVAILABLE: "system.service.not.available";
+    readonly CONFIG_REQUIRED: "system.config.required";
+    readonly INTERNAL_ERROR: "system.internal.error";
+    readonly NOT_FOUND: "system.not.found";
+    readonly DUPLICATE_REQUEST: "system.duplicate.request";
+    readonly INVALID_TENANT_ID: "system.invalid.tenant.id";
+    readonly TENANT_NOT_FOUND: "system.tenant.not.found";
+    readonly TENANT_HEADER_REQUIRED: "system.tenant.header.required";
+    readonly MISSING_PARAMETER: "system.missing.parameter";
+    readonly SDK_NOT_INSTALLED: "system.sdk.not.installed";
+    readonly PATH_TRAVERSAL_DETECTED: "system.path.traversal.detected";
+    readonly INVALID_FILE_KEY: "system.invalid.file.key";
+};
+export declare const MESSAGE_KEYS: {
+    readonly AUTH: {
+        readonly TOKEN_REQUIRED: "auth.token.required";
+        readonly TOKEN_INVALID: "auth.token.invalid";
+        readonly TOKEN_EXPIRED: "auth.token.expired";
+        readonly COMPANY_NO_ACCESS: "auth.company.no.access";
+    };
+    readonly ERROR: {
+        readonly NOT_FOUND: "error.not.found";
+        readonly VALIDATION: "error.validation";
+        readonly UNAUTHORIZED: "error.unauthorized";
+        readonly FORBIDDEN: "error.forbidden";
+        readonly CONFLICT: "error.conflict";
+        readonly INTERNAL: "error.internal";
+        readonly SERVICE_UNAVAILABLE: "error.service.unavailable";
+        readonly UNKNOWN: "error.unknown";
+        readonly HTTP: "error.http";
+        readonly GENERIC: "error.generic";
+        readonly PERMISSION_SYSTEM_UNAVAILABLE: "error.permission.system.unavailable";
+        readonly INSUFFICIENT_PERMISSIONS: "error.insufficient.permissions";
+        readonly INSUFFICIENT_PERMISSIONS_OR: "error.insufficient.permissions.or";
+        readonly NO_PERMISSIONS_FOUND: "error.no.permissions.found";
+    };
+    readonly SYSTEM: {
+        readonly REPOSITORY_NOT_AVAILABLE: "system.repository.not.available";
+        readonly DATASOURCE_NOT_AVAILABLE: "system.datasource.not.available";
+        readonly DATABASE_CONFIG_NOT_AVAILABLE: "system.database.config.not.available";
+        readonly SERVICE_NOT_AVAILABLE: "system.service.not.available";
+        readonly CONFIG_REQUIRED: "system.config.required";
+        readonly INTERNAL_ERROR: "system.internal.error";
+        readonly NOT_FOUND: "system.not.found";
+        readonly DUPLICATE_REQUEST: "system.duplicate.request";
+        readonly INVALID_TENANT_ID: "system.invalid.tenant.id";
+        readonly TENANT_NOT_FOUND: "system.tenant.not.found";
+        readonly TENANT_HEADER_REQUIRED: "system.tenant.header.required";
+        readonly MISSING_PARAMETER: "system.missing.parameter";
+        readonly SDK_NOT_INSTALLED: "system.sdk.not.installed";
+        readonly PATH_TRAVERSAL_DETECTED: "system.path.traversal.detected";
+        readonly INVALID_FILE_KEY: "system.invalid.file.key";
+    };
+};
+export type MessageKey = (typeof MESSAGE_KEYS)[keyof typeof MESSAGE_KEYS][keyof (typeof MESSAGE_KEYS)[keyof typeof MESSAGE_KEYS]];