@flusys/nestjs-shared 4.1.1 → 5.0.1

package/fesm/filters/global-exception.filter.js

@@ -61,7 +61,7 @@ export class GlobalExceptionFilter {
                 success: false,
                 message: exception.message,
                 messageKey: exception.messageKey,
-                messageParams: exception.messageParams,
+                messageVariables: exception.messageVariables,
                 errors: exception.errors,
                 _meta: {
                     requestId,
@@ -72,12 +72,12 @@ export class GlobalExceptionFilter {
         }
         if (exception instanceof HttpException) {
             const response = exception.getResponse();
-            const { message, messageKey, messageParams, errors } = this.extractHttpExceptionDetails(response);
+            const { message, messageKey, messageVariables, errors } = this.extractHttpExceptionDetails(response);
             return {
                 success: false,
                 message,
                 messageKey,
-                messageParams,
+                messageVariables,
                 errors,
                 _meta: {
                     requestId,
@@ -124,7 +124,7 @@ export class GlobalExceptionFilter {
             return {
                 message: String(obj.message || 'Unknown error'),
                 messageKey: String(obj.messageKey || ERROR_MESSAGES.HTTP),
-                messageParams: obj.messageParams,
+                messageVariables: obj.messageVariables,
                 errors: obj.errors
             };
         }

package/fesm/interfaces/index.js

@@ -3,7 +3,6 @@ export * from './datasource.interface';
 export * from './event-manager-adapter.interface';
 export * from './identity.interface';
 export * from './logged-user-info.interface';
-export * from './logger.interface';
 export * from './module-config.interface';
 export * from './notification-adapter.interface';
 export * from './permission.interface';

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

@@ -88,7 +88,7 @@ export class MultiTenantDataSourceService {
             throw new BadRequestException({
                 message: `Tenant '${tenantId}' not found`,
                 messageKey: SYSTEM_MESSAGES.TENANT_NOT_FOUND,
-                messageParams: {
+                messageVariables: {
                     tenantId
                 }
             });
@@ -183,7 +183,7 @@ export class MultiTenantDataSourceService {
             throw new BadRequestException({
                 message: `Tenant not found. Ensure '${this.tenantHeader}' header is set.`,
                 messageKey: SYSTEM_MESSAGES.TENANT_HEADER_REQUIRED,
-                messageParams: {
+                messageVariables: {
                     header: this.tenantHeader
                 }
             });

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,3 +1,4 @@
+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

@@ -75,8 +75,8 @@ import { AUTH_MESSAGES } from '../constants';
         if (entity.companyId && entity.companyId !== user.companyId) {
             throw new BadRequestException({
                 message: `${entityName} belongs to another company`,
-                messageKey: AUTH_MESSAGES.COMPANY_NO_ACCESS,
-                messageParams: {
+                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/interfaces/event-manager-adapter.interface.d.ts

@@ -2,8 +2,6 @@ import { ParticipantStatus } from '../enums/participant-status.enum';
 import { RecurrenceType } from '../enums/recurrence-type.enum';
 export interface IEventManagerAdapter {
     createEvent(options: CreateEventOptions): Promise<EventResult>;
-    addParticipants(eventId: string, userIds: string[], companyId?: string): Promise<void>;
-    removeParticipant(eventId: string, userId: string): Promise<void>;
     updateParticipantStatus(participantId: string, status: ParticipantStatus): Promise<void>;
     getEventsForUser?(userId: string, startDate: Date, endDate: Date, companyId?: string): Promise<EventResult[]>;
     getEventById?(eventId: string): Promise<EventResult | null>;
@@ -11,14 +9,15 @@ export interface IEventManagerAdapter {
 export interface CreateEventOptions {
     title: string;
     description?: string;
-    meetingLink?: string;
-    startDateTime: Date;
-    endDateTime: Date;
+    eventDate: string;
+    startTime: string;
+    endTime: string;
     isAllDay?: boolean;
     recurrenceType?: RecurrenceType;
-    recurrenceEndDate?: Date;
+    recurrenceEndDate?: string | null;
+    weekDays?: string[] | null;
     color?: string;
-    metadata?: Record<string, unknown>;
+    meetingLink?: string | null;
     participantIds?: string[];
     organizerId?: string;
     companyId?: string;
@@ -27,15 +26,16 @@ export interface EventResult {
     id: string;
     title: string;
     description?: string | null;
-    meetingLink?: string | null;
-    startDateTime: Date;
-    endDateTime: Date;
+    eventDate: string;
+    startTime: string;
+    endTime: string;
     isAllDay: boolean;
     recurrenceType: string;
-    recurrenceEndDate?: Date | null;
+    recurrenceEndDate?: string | null;
+    weekDays?: string[] | null;
     color: string;
+    meetingLink?: string | null;
     isActive: boolean;
-    metadata?: Record<string, unknown> | null;
     companyId?: string | null;
     createdAt: Date;
     updatedAt: Date;

package/interfaces/index.d.ts

@@ -3,7 +3,6 @@ export * from './datasource.interface';
 export * from './event-manager-adapter.interface';
 export * from './identity.interface';
 export * from './logged-user-info.interface';
-export * from './logger.interface';
 export * from './module-config.interface';
 export * from './notification-adapter.interface';
 export * from './permission.interface';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flusys/nestjs-shared",
-  "version": "4.1.1",
+  "version": "5.0.1",
   "description": "Common shared utilities for Flusys NestJS applications",
   "main": "cjs/index.js",
   "module": "fesm/index.js",
@@ -93,7 +93,7 @@
     }
   },
   "peerDependencies": {
-    "@keyv/redis": "^5.0.0",
+    "@keyv/redis": "^5.0.1",
     "@nestjs/common": "^10.0.0 || ^11.0.0",
     "@nestjs/config": "^3.0.0 || ^4.0.0",
     "@nestjs/core": "^10.0.0 || ^11.0.0",
@@ -104,14 +104,14 @@
     "cacheable": "^2.0.0",
     "class-transformer": "^0.5.0",
     "class-validator": "^0.14.0",
-    "keyv": "^5.0.0",
+    "keyv": "^5.0.1",
     "typeorm": "^0.3.0",
     "winston": "^3.0.0",
-    "winston-daily-rotate-file": "^5.0.0",
+    "winston-daily-rotate-file": "^5.0.1",
     "express": "^4.18.0",
     "rxjs": "^7.8.0"
   },
   "dependencies": {
-    "@flusys/nestjs-core": "4.1.1"
+    "@flusys/nestjs-core": "5.0.1"
   }
 }

package/utils/date-time.util.d.ts

@@ -0,0 +1,8 @@
+export declare function localToUtc(dateStr: string, timeStr: string, timezone: string): Date;
+export declare function utcToLocal(utcDate: Date | string, timezone: string): {
+    date: string;
+    time: string;
+    display: string;
+};
+export declare function formatInTimezone(utcDate: Date | string, timezone: string, options?: Intl.DateTimeFormatOptions): string;
+export declare function getTodayInTimezone(timezone: string): string;

package/utils/index.d.ts

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

package/utils/request.util.d.ts

@@ -2,3 +2,5 @@ import { CookieOptions, Request } from 'express';
 export declare function isBrowserRequest(req: Request): boolean;
 export declare function buildCookieOptions(req: Request): Pick<CookieOptions, 'secure' | 'sameSite' | 'domain'>;
 export declare function parseDurationToMs(duration: string, defaultMs?: number): number;
+export declare function extractFrontendUrl(req: Request): string;
+export declare function buildFrontendUrl(req: Request, path: string): string;

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

@@ -1,99 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-function _export(target, all) {
-    for(var name in all)Object.defineProperty(target, name, {
-        enumerable: true,
-        get: Object.getOwnPropertyDescriptor(all, name).get
-    });
-}
-_export(exports, {
-    get NestLoggerAdapter () {
-        return NestLoggerAdapter;
-    },
-    get WinstonLoggerAdapter () {
-        return WinstonLoggerAdapter;
-    }
-});
-const _winstonloggerclass = require("./winston.logger.class");
-const _loggermiddleware = require("../middlewares/logger.middleware");
-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 getCorrelationMeta() {
-    return Object.fromEntries(Object.entries({
-        requestId: (0, _loggermiddleware.getRequestId)(),
-        userId: (0, _loggermiddleware.getUserId)(),
-        tenantId: (0, _loggermiddleware.getTenantId)(),
-        companyId: (0, _loggermiddleware.getCompanyId)()
-    }).filter(([, v])=>v != null));
-}
-let WinstonLoggerAdapter = 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) {
-        this.logger.info(message, this.buildLogMeta(context, args));
-    }
-    error(message, trace, context, ...args) {
-        this.logger.error(message, this.buildLogMeta(context, args, {
-            stack: trace
-        }));
-    }
-    warn(message, context, ...args) {
-        this.logger.warn(message, this.buildLogMeta(context, args));
-    }
-    debug(message, context, ...args) {
-        this.logger.debug(message, this.buildLogMeta(context, args));
-    }
-    verbose(message, context, ...args) {
-        this.logger.verbose(message, this.buildLogMeta(context, args));
-    }
-    constructor(context, moduleName){
-        _define_property(this, "context", void 0);
-        _define_property(this, "logger", void 0);
-        this.context = context;
-        this.logger = moduleName ? (0, _winstonloggerclass.createModuleLogger)(moduleName) : _winstonloggerclass.instance;
-    }
-};
-let NestLoggerAdapter = 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/cjs/decorators/sanitize-html.decorator.js

@@ -1,36 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-function _export(target, all) {
-    for(var name in all)Object.defineProperty(target, name, {
-        enumerable: true,
-        get: Object.getOwnPropertyDescriptor(all, name).get
-    });
-}
-_export(exports, {
-    get SanitizeAndTrim () {
-        return SanitizeAndTrim;
-    },
-    get SanitizeHtml () {
-        return SanitizeHtml;
-    }
-});
-const _classtransformer = require("class-transformer");
-const _htmlsanitizerutil = require("../utils/html-sanitizer.util");
-function SanitizeHtml() {
-    return (0, _classtransformer.Transform)(({ value })=>{
-        if (typeof value === 'string') {
-            return (0, _htmlsanitizerutil.escapeHtml)(value);
-        }
-        return value;
-    });
-}
-function SanitizeAndTrim() {
-    return (0, _classtransformer.Transform)(({ value })=>{
-        if (typeof value === 'string') {
-            return (0, _htmlsanitizerutil.escapeHtml)(value.trim());
-        }
-        return value;
-    });
-}

package/cjs/interfaces/logger.interface.js

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

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

@@ -1,23 +0,0 @@
-import { Logger } from '@nestjs/common';
-import { ILogger } from '../interfaces/logger.interface';
-export declare class WinstonLoggerAdapter implements ILogger {
-    private readonly context?;
-    private readonly logger;
-    constructor(context?: string, moduleName?: string);
-    private buildLogMeta;
-    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: 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/decorators/sanitize-html.decorator.d.ts

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

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

@@ -1,81 +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, createModuleLogger } from './winston.logger.class';
-import { getRequestId, getUserId, getTenantId, getCompanyId } from '../middlewares/logger.middleware';
-function getCorrelationMeta() {
-    return Object.fromEntries(Object.entries({
-        requestId: getRequestId(),
-        userId: getUserId(),
-        tenantId: getTenantId(),
-        companyId: getCompanyId()
-    }).filter(([, v])=>v != null));
-}
-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) {
-        this.logger.info(message, this.buildLogMeta(context, args));
-    }
-    error(message, trace, context, ...args) {
-        this.logger.error(message, this.buildLogMeta(context, args, {
-            stack: trace
-        }));
-    }
-    warn(message, context, ...args) {
-        this.logger.warn(message, this.buildLogMeta(context, args));
-    }
-    debug(message, context, ...args) {
-        this.logger.debug(message, this.buildLogMeta(context, args));
-    }
-    verbose(message, context, ...args) {
-        this.logger.verbose(message, this.buildLogMeta(context, args));
-    }
-    constructor(context, moduleName){
-        _define_property(this, "context", void 0);
-        _define_property(this, "logger", void 0);
-        this.context = context;
-        this.logger = moduleName ? createModuleLogger(moduleName) : winstonLogger;
-    }
-}
-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/interfaces/logger.interface.js

@@ -1 +0,0 @@
-export { };

package/interfaces/logger.interface.d.ts

@@ -1,7 +0,0 @@
-export interface ILogger {
-    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;
-}