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

package/fesm/middlewares/logger.middleware.js

@@ -24,18 +24,15 @@ import { v4 as uuidv4 } from 'uuid';
 import { instance as winstonLogger } from '../classes/winston.logger.class';
 import { REQUEST_ID_HEADER } from '../constants';
 // Configuration
-const IS_DEBUG = envConfig.getLogConfig().level === 'debug';
+const logConfig = 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;
 export const requestContext = new AsyncLocalStorage();
 // Context accessors
@@ -44,17 +41,71 @@ export const getTenantId = ()=>requestContext.getStore()?.tenantId;
 export const getUserId = ()=>requestContext.getStore()?.userId;
 export 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';
@@ -71,7 +122,7 @@ export 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);
@@ -112,20 +163,22 @@ export 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;
@@ -133,6 +186,10 @@ export 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,
@@ -141,15 +198,15 @@ export 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/fesm/modules/datasource/index.js

@@ -1,2 +1 @@
-export * from './datasource.module';
 export * from './multi-tenant-datasource.service';

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

@@ -26,27 +26,28 @@ function _ts_param(paramIndex, decorator) {
     };
 }
 import { DEFAULT_TENANT_HEADER, IDataSourceServiceOptions, MODULE_OPTIONS } from '@flusys/nestjs-core';
-import { BadRequestException, Inject, Injectable, Logger, Optional, Scope } from '@nestjs/common';
+import { BadRequestException, Inject, Injectable, InternalServerErrorException, Optional, Scope } from '@nestjs/common';
+import { SYSTEM_MESSAGES } from '../../constants';
 import { REQUEST } from '@nestjs/core';
 import { Request } from 'express';
 import { DataSource } from 'typeorm';
 import { SnakeNamingStrategy } from 'typeorm-naming-strategies';
 export class MultiTenantDataSourceService {
+    get self() {
+        return this.constructor;
+    }
     initializeFromOptions() {
         if (!this.options) return;
-        if (!MultiTenantDataSourceService.initialized) {
+        if (!this.self.initialized) {
             this.registerTenants();
-            MultiTenantDataSourceService.initialized = true;
+            this.self.initialized = true;
         }
     }
     registerTenants() {
         this.options?.tenants?.forEach((tenant)=>{
-            MultiTenantDataSourceService.tenantsRegistry.set(tenant.id, tenant);
+            this.self.tenantsRegistry.set(tenant.id, tenant);
         });
     }
-    setTenantHeader(header) {
-        this.tenantHeader = header;
-    }
     getDatabaseMode() {
         return this.options?.bootstrapAppConfig?.databaseMode ?? 'single';
     }
@@ -58,7 +59,10 @@ export class MultiTenantDataSourceService {
         const tenantId = this.request.headers[this.tenantHeader];
         if (!tenantId) return null;
         if (!/^[a-zA-Z0-9_-]+$/.test(tenantId)) {
-            throw new BadRequestException('Invalid tenant ID format');
+            throw new BadRequestException({
+                message: 'Invalid tenant ID format',
+                messageKey: SYSTEM_MESSAGES.INVALID_TENANT_ID
+            });
         }
         return tenantId;
     }
@@ -67,124 +71,78 @@ export class MultiTenantDataSourceService {
         return tenantId ? this.getTenant(tenantId) : null;
     }
     getTenant(tenantId) {
-        return MultiTenantDataSourceService.tenantsRegistry.get(tenantId) ?? null;
-    }
-    getAllTenants() {
-        return Array.from(MultiTenantDataSourceService.tenantsRegistry.values());
-    }
-    getActiveTenants() {
-        return this.getAllTenants();
+        return this.self.tenantsRegistry.get(tenantId) ?? null;
     }
     async getDataSource() {
         return this.isMultiTenant() ? this.getTenantDataSource() : this.getSingleDataSource();
     }
-    async getDataSourceForTenant(tenantId) {
-        const tenant = this.getTenant(tenantId);
-        if (!tenant) throw new Error(`Tenant '${tenantId}' not found`);
-        return this.getOrCreateTenantConnection(tenant);
-    }
-    setDataSource(dataSource) {
-        MultiTenantDataSourceService.singleDataSource = dataSource;
-    }
     async getRepository(entity) {
         const dataSource = await this.getDataSource();
         return dataSource.getRepository(entity);
     }
-    async withTenant(tenantId, callback) {
-        const dataSource = await this.getDataSourceForTenant(tenantId);
-        return callback(dataSource);
-    }
-    async forAllTenants(callback) {
-        const results = new Map();
-        for (const tenant of this.getActiveTenants()){
-            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}`);
-            }
-        }
-        return results;
-    }
-    registerTenant(tenant) {
-        MultiTenantDataSourceService.tenantsRegistry.set(tenant.id, tenant);
-    }
-    async removeTenant(tenantId) {
-        await this.closeTenantConnection(tenantId);
-        MultiTenantDataSourceService.tenantsRegistry.delete(tenantId);
-    }
     async closeTenantConnection(tenantId) {
-        const connection = MultiTenantDataSourceService.tenantConnections.get(tenantId);
+        const connection = this.self.tenantConnections.get(tenantId);
         if (connection?.isInitialized) {
             await connection.destroy();
-            MultiTenantDataSourceService.tenantConnections.delete(tenantId);
-            this.logger.log(`Closed connection for tenant: ${tenantId}`);
+            this.self.tenantConnections.delete(tenantId);
         }
     }
     async onModuleDestroy() {
-        for (const [tenantId] of MultiTenantDataSourceService.tenantConnections){
+        for (const [tenantId] of this.self.tenantConnections){
             await this.closeTenantConnection(tenantId);
         }
     }
-    static reset() {
-        MultiTenantDataSourceService.initialized = false;
-        MultiTenantDataSourceService.singleDataSource = null;
-        MultiTenantDataSourceService.singleConnectionLock = null;
-        MultiTenantDataSourceService.tenantConnections.clear();
-        MultiTenantDataSourceService.tenantsRegistry.clear();
-        MultiTenantDataSourceService.connectionLocks.clear();
-    }
-    // Protected Methods (for subclasses)
-    /**
-   * Get single database DataSource with connection locking to prevent race conditions
-   */ async getSingleDataSource() {
-        // Return existing initialized connection
-        if (MultiTenantDataSourceService.singleDataSource?.isInitialized) {
-            return MultiTenantDataSourceService.singleDataSource;
+    async getSingleDataSource() {
+        if (this.self.singleDataSource?.isInitialized) {
+            return this.self.singleDataSource;
         }
-        // If another request is creating the connection, wait for it
-        if (MultiTenantDataSourceService.singleConnectionLock) {
-            return MultiTenantDataSourceService.singleConnectionLock;
+        if (this.self.singleConnectionLock) {
+            return this.self.singleConnectionLock;
         }
         const config = this.getDefaultDatabaseConfig();
         if (!config) {
-            throw new Error('No database config available. Provide defaultDatabaseConfig or tenantDefaultDatabaseConfig.');
+            throw new InternalServerErrorException({
+                message: 'No database config available. Provide defaultDatabaseConfig or tenantDefaultDatabaseConfig.',
+                messageKey: SYSTEM_MESSAGES.DATABASE_CONFIG_NOT_AVAILABLE
+            });
         }
-        // Create connection with lock to prevent race conditions
         const connectionPromise = this.createDataSourceFromConfig(config);
-        MultiTenantDataSourceService.singleConnectionLock = connectionPromise;
+        this.self.singleConnectionLock = connectionPromise;
         try {
             const dataSource = await connectionPromise;
-            MultiTenantDataSourceService.singleDataSource = dataSource;
+            this.self.singleDataSource = dataSource;
             return dataSource;
         } finally{
-            MultiTenantDataSourceService.singleConnectionLock = null;
+            this.self.singleConnectionLock = null;
         }
     }
-    /**
-   * Get tenant-specific DataSource
-   */ async getTenantDataSource() {
+    async getTenantDataSource() {
         const tenant = this.getCurrentTenant();
         if (!tenant) {
-            throw new Error(`Tenant not found. Ensure '${this.tenantHeader}' header is set.`);
+            throw new BadRequestException({
+                message: `Tenant not found. Ensure '${this.tenantHeader}' header is set.`,
+                messageKey: SYSTEM_MESSAGES.TENANT_HEADER_REQUIRED,
+                messageVariables: {
+                    header: this.tenantHeader
+                }
+            });
         }
         return this.getOrCreateTenantConnection(tenant);
     }
     async getOrCreateTenantConnection(tenant) {
-        const existing = MultiTenantDataSourceService.tenantConnections.get(tenant.id);
+        const existing = this.self.tenantConnections.get(tenant.id);
         if (existing?.isInitialized) return existing;
-        const pendingConnection = MultiTenantDataSourceService.connectionLocks.get(tenant.id);
+        const pendingConnection = this.self.connectionLocks.get(tenant.id);
         if (pendingConnection) return pendingConnection;
         const config = this.buildTenantDatabaseConfig(tenant);
         const connectionPromise = this.createDataSourceFromConfig(config);
-        MultiTenantDataSourceService.connectionLocks.set(tenant.id, connectionPromise);
+        this.self.connectionLocks.set(tenant.id, connectionPromise);
         try {
             const dataSource = await connectionPromise;
-            MultiTenantDataSourceService.tenantConnections.set(tenant.id, dataSource);
-            this.logger.log(`Created connection for tenant: ${tenant.id}`);
+            this.self.tenantConnections.set(tenant.id, dataSource);
             return dataSource;
         } finally{
-            MultiTenantDataSourceService.connectionLocks.delete(tenant.id);
+            this.self.connectionLocks.delete(tenant.id);
         }
     }
     getDefaultDatabaseConfig() {
@@ -192,7 +150,12 @@ export 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 InternalServerErrorException({
+                message: 'No default database config for multi-tenant mode.',
+                messageKey: SYSTEM_MESSAGES.DATABASE_CONFIG_NOT_AVAILABLE
+            });
+        }
         return {
             type: defaultConfig.type,
             host: tenant.host ?? defaultConfig.host,
@@ -220,11 +183,9 @@ export 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 Logger(this.constructor.name);
         this.tenantHeader = DEFAULT_TENANT_HEADER;
         this.initializeFromOptions();
     }

package/fesm/modules/utils/utils.service.js

@@ -1,23 +1,10 @@
-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, Logger } from '@nestjs/common';
+import { Injectable } from '@nestjs/common';
 export class UtilsService {
     // ---------------- CACHE HELPERS ----------------
     /**
@@ -37,8 +24,8 @@ export 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
         }
     }
     /**
@@ -49,8 +36,8 @@ export 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 ----------------
@@ -73,9 +60,6 @@ export 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 Logger(UtilsService.name));
-    }
 }
 UtilsService = _ts_decorate([
     Injectable()

package/fesm/utils/date-time.util.js

@@ -0,0 +1,70 @@
+function getOffsetMinutes(utcDate, timezone) {
+    const extract = (tz)=>{
+        const parts = new Intl.DateTimeFormat('en-US', {
+            timeZone: tz,
+            year: 'numeric',
+            month: '2-digit',
+            day: '2-digit',
+            hour: '2-digit',
+            minute: '2-digit',
+            second: '2-digit',
+            hour12: false
+        }).formatToParts(utcDate);
+        const p = Object.fromEntries(parts.filter((x)=>x.type !== 'literal').map((x)=>[
+                x.type,
+                parseInt(x.value)
+            ]));
+        return Date.UTC(p['year'], p['month'] - 1, p['day'], p['hour'], p['minute'], p['second']);
+    };
+    return (extract(timezone) - extract('UTC')) / 60_000;
+}
+export function localToUtc(dateStr, timeStr, timezone) {
+    const [year, month, day] = dateStr.split('-').map(Number);
+    const [hours, minutes] = timeStr.split(':').map(Number);
+    const approx = new Date(Date.UTC(year, month - 1, day, hours, minutes, 0));
+    const offset = getOffsetMinutes(approx, timezone);
+    const utcDate = new Date(approx.getTime() - offset * 60_000);
+    // DST boundary guard: re-check offset after adjustment
+    const finalOffset = getOffsetMinutes(utcDate, timezone);
+    return finalOffset !== offset ? new Date(approx.getTime() - finalOffset * 60_000) : utcDate;
+}
+export function utcToLocal(utcDate, timezone) {
+    const d = typeof utcDate === 'string' ? new Date(utcDate) : utcDate;
+    const parts = new Intl.DateTimeFormat('en-CA', {
+        timeZone: timezone,
+        year: 'numeric',
+        month: '2-digit',
+        day: '2-digit',
+        hour: '2-digit',
+        minute: '2-digit',
+        hour12: false
+    }).formatToParts(d);
+    const p = Object.fromEntries(parts.filter((x)=>x.type !== 'literal').map((x)=>[
+            x.type,
+            x.value
+        ]));
+    // en-CA formats midnight hour as '24' — normalize to '00'
+    const hour = p['hour'] === '24' ? '00' : p['hour'];
+    return {
+        date: `${p['year']}-${p['month']}-${p['day']}`,
+        time: `${hour}:${p['minute']}`,
+        display: new Intl.DateTimeFormat('en-US', {
+            timeZone: timezone,
+            dateStyle: 'medium',
+            timeStyle: 'short'
+        }).format(d)
+    };
+}
+export function formatInTimezone(utcDate, timezone, options = {
+    dateStyle: 'medium',
+    timeStyle: 'short'
+}) {
+    const d = typeof utcDate === 'string' ? new Date(utcDate) : utcDate;
+    return new Intl.DateTimeFormat('en-US', {
+        ...options,
+        timeZone: timezone
+    }).format(d);
+}
+export function getTodayInTimezone(timezone) {
+    return utcToLocal(new Date(), timezone).date;
+}

package/fesm/utils/index.js

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

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.ENTITY_BELOG_ANOTHER_COMPANY,
+                messageVariables: {
+                    entity: entityName
+                }
+            });
         }
     }
 }

package/fesm/utils/request.util.js

@@ -57,3 +57,25 @@ import { CLIENT_TYPE_HEADER } from '../constants';
     const unit = match[2];
     return value * (TIME_UNIT_MS[unit] ?? TIME_UNIT_MS.d);
 }
+/**
+ * Determine the frontend base URL for auth-related links.
+ * Uses allowed origins from envConfig first, then falls back to request host.
+ */ export function extractFrontendUrl(req) {
+    const allowedOrigins = envConfig.getOrigins();
+    const origin = (req.get('origin') ?? req.get('referer') ?? '').trim();
+    if (origin && allowedOrigins.length) {
+        const matched = allowedOrigins.find((u)=>origin.startsWith(u));
+        if (matched) {
+            return matched;
+        }
+    }
+    const host = req.get('host');
+    if (!host) {
+        throw new Error('Unable to determine frontend URL from request');
+    }
+    return `${req.protocol}://${host}`;
+}
+export function buildFrontendUrl(req, path) {
+    const baseUrl = extractFrontendUrl(req);
+    return `${baseUrl}${path}`;
+}

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

@@ -0,0 +1,9 @@
+import { ArgumentsHost, ExceptionFilter } from '@nestjs/common';
+export declare class GlobalExceptionFilter implements ExceptionFilter {
+    private readonly logger;
+    catch(exception: unknown, host: ArgumentsHost): void;
+    private resolveException;
+    private resolveHttpException;
+    private resolveQueryFailedError;
+    private toHumanReadable;
+}

package/filters/index.d.ts

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

package/guards/permission.guard.d.ts

@@ -1,19 +1,15 @@
 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 | undefined, config?: PermissionGuardConfig);
     canActivate(context: ExecutionContext): Promise<boolean>;
-    private normalizePermissionConfig;
-    private validateSimplePermissions;
-    private isNestedCondition;
-    private evaluateCondition;
+    private normalizeToLogicNode;
+    private evaluateLogicNode;
     private getUserPermissions;
     private buildPermissionCacheKey;
     private hasPermission;

package/index.d.ts

@@ -3,7 +3,9 @@ export * from './constants';
 export * from './decorators';
 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/idempotency.interceptor.d.ts

@@ -5,6 +5,6 @@ export declare class IdempotencyInterceptor implements NestInterceptor {
     private readonly cache?;
     private readonly CACHE_TTL;
     private readonly PROCESSING_MARKER;
-    constructor(cache?: HybridCache);
+    constructor(cache?: HybridCache | undefined);
     intercept<T = any>(context: ExecutionContext, next: CallHandler<T>): Promise<Observable<T>>;
 }

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