@flusys/nestjs-shared 1.0.0-rc → 2.0.0

package/cjs/utils/request.util.js

@@ -0,0 +1,70 @@
+"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 buildCookieOptions () {
+        return buildCookieOptions;
+    },
+    get isBrowserRequest () {
+        return isBrowserRequest;
+    },
+    get parseDurationToMs () {
+        return parseDurationToMs;
+    }
+});
+const _constants = require("../constants");
+/** Time unit multipliers in milliseconds */ const TIME_UNIT_MS = {
+    s: 1000,
+    m: 60 * 1000,
+    h: 60 * 60 * 1000,
+    d: 24 * 60 * 60 * 1000,
+    w: 7 * 24 * 60 * 60 * 1000
+};
+/** Get normalized client type from request header */ function getClientType(req) {
+    const clientType = req.headers[_constants.CLIENT_TYPE_HEADER];
+    return clientType ? clientType.toLowerCase() : null;
+}
+function isBrowserRequest(req) {
+    const clientType = getClientType(req);
+    if (clientType) {
+        return clientType === 'browser' || clientType === 'web';
+    }
+    const accept = req.headers['accept'] || '';
+    if (accept.includes('text/html')) return true;
+    const userAgent = req.headers['user-agent'] || '';
+    const browserPatterns = /mozilla|chrome|safari|firefox|edge|opera|msie/i;
+    return browserPatterns.test(userAgent) && !userAgent.includes('Postman');
+}
+function buildCookieOptions(req) {
+    const hostname = req.hostname || '';
+    const origin = req.headers.origin || '';
+    const isProduction = process.env.NODE_ENV === 'production';
+    const forwardedProto = req.headers['x-forwarded-proto'];
+    const isHttps = isProduction || forwardedProto === 'https' || origin.startsWith('https://') || req.secure;
+    let domain;
+    const domainParts = hostname.split('.');
+    if (domainParts.length > 2 && !hostname.includes('localhost')) {
+        domain = '.' + domainParts.slice(-2).join('.');
+    }
+    return {
+        secure: isHttps,
+        sameSite: isHttps ? 'strict' : 'lax',
+        ...domain && {
+            domain
+        }
+    };
+}
+function parseDurationToMs(duration, defaultMs = TIME_UNIT_MS.w) {
+    const match = duration.match(/^(\d+)(s|m|h|d|w)$/);
+    if (!match) return defaultMs;
+    const value = parseInt(match[1], 10);
+    const unit = match[2];
+    return value * (TIME_UNIT_MS[unit] ?? TIME_UNIT_MS.d);
+}

package/cjs/utils/string.util.js

@@ -0,0 +1,63 @@
+/**
+ * String utility functions
+ */ /**
+ * Generate URL-friendly slug from a string
+ * @param text - The text to convert to slug
+ * @param maxLength - Maximum length of the slug (default: 100)
+ * @returns URL-friendly slug
+ *
+ * @example
+ * generateSlug('My Company Name') // 'my-company-name'
+ * generateSlug('Hello World!') // 'hello-world'
+ */ "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 generateSlug () {
+        return generateSlug;
+    },
+    get generateUniqueSlug () {
+        return generateUniqueSlug;
+    }
+});
+function generateSlug(text, maxLength = 100) {
+    return text.toLowerCase().trim().replace(/[^a-z0-9\s-]/g, '') // Remove special characters
+    .replace(/\s+/g, '-') // Replace spaces with hyphens
+    .replace(/-+/g, '-') // Replace multiple hyphens with single
+    .replace(/^-+|-+$/g, '') // Remove leading/trailing hyphens
+    .substring(0, maxLength);
+}
+async function generateUniqueSlug(text, findMatchingSlugs, maxLength = 100) {
+    const baseSlug = generateSlug(text, maxLength);
+    // Single query to get all matching slugs
+    const existingSlugs = await findMatchingSlugs(baseSlug);
+    // No collisions - base slug is available
+    if (existingSlugs.length === 0) {
+        return baseSlug;
+    }
+    // Build set for O(1) lookup
+    const existingSet = new Set(existingSlugs);
+    // Base slug not taken (only suffixed versions exist)
+    if (!existingSet.has(baseSlug)) {
+        return baseSlug;
+    }
+    // Find next available suffix in memory (fast)
+    let counter = 1;
+    while(counter < 10000){
+        const slugWithSuffix = `${baseSlug}-${counter}`;
+        if (!existingSet.has(slugWithSuffix)) {
+            return slugWithSuffix;
+        }
+        counter++;
+    }
+    // Fallback: append random string (extremely rare edge case)
+    const randomSuffix = Math.random().toString(36).substring(2, 8);
+    return `${baseSlug}-${randomSuffix}`;
+}

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

@@ -30,6 +30,8 @@ export declare abstract class ApiService<CreateDtoT extends object, UpdateDtoT e
     clearCacheForAll(): Promise<void>;
     clearCacheForId(entities: EntityT[]): Promise<void>;
     private handleError;
+    private ensureArray;
+    private executeInTransaction;
     protected ensureRepositoryInitialized(): Promise<void>;
     protected beforeInsertOperation(_dto: CreateDtoT | Array<CreateDtoT>, _user: ILoggedUserInfo | null, _queryRunner: QueryRunner): Promise<void>;
     protected afterInsertOperation(_entity: EntityT[], _user: ILoggedUserInfo | null, _queryRunner: QueryRunner): Promise<void>;

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

@@ -3,6 +3,7 @@ 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;
@@ -12,6 +13,7 @@ export declare class WinstonLoggerAdapter implements ILogger {
 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;

package/constants/permissions.d.ts

@@ -80,6 +80,12 @@ export declare const FORM_PERMISSIONS: {
     readonly UPDATE: "form.update";
     readonly DELETE: "form.delete";
 };
+export declare const FORM_RESULT_PERMISSIONS: {
+    readonly CREATE: "form-result.create";
+    readonly READ: "form-result.read";
+    readonly UPDATE: "form-result.update";
+    readonly DELETE: "form-result.delete";
+};
 export declare const PERMISSIONS: {
     readonly USER: {
         readonly CREATE: "user.create";
@@ -163,5 +169,11 @@ export declare const PERMISSIONS: {
         readonly UPDATE: "form.update";
         readonly DELETE: "form.delete";
     };
+    readonly FORM_RESULT: {
+        readonly CREATE: "form-result.create";
+        readonly READ: "form-result.read";
+        readonly UPDATE: "form-result.update";
+        readonly DELETE: "form-result.delete";
+    };
 };
 export type PermissionCode = (typeof PERMISSIONS)[keyof typeof PERMISSIONS][keyof (typeof PERMISSIONS)[keyof typeof PERMISSIONS]];

package/dtos/delete.dto.d.ts

@@ -1,4 +1,5 @@
 export declare class DeleteDto {
     id: string | string[];
     type: 'delete' | 'restore' | 'permanent';
+    deletedById?: string;
 }

package/dtos/response-payload.dto.d.ts

@@ -41,16 +41,3 @@ export declare class MessageResponseDto {
     message: string;
     _meta?: RequestMetaDto;
 }
-export declare class ValidationErrorDto {
-    field: string;
-    message: string;
-    constraint?: string;
-}
-export declare class ErrorResponseDto {
-    success: false;
-    message: string;
-    code?: string;
-    errors?: ValidationErrorDto[];
-    _meta?: RequestMetaDto;
-}
-export type ApiResponse<T> = SingleResponseDto<T> | ListResponseDto<T> | BulkResponseDto<T> | MessageResponseDto | ErrorResponseDto;

package/fesm/classes/api-service.class.js

@@ -16,116 +16,52 @@ import { Logger, NotFoundException } from '@nestjs/common';
 import { In } from 'typeorm';
 /** Generic API service with CRUD operations and caching support */ export class ApiService {
     async insert(dto, user) {
-        await this.ensureRepositoryInitialized();
-        const qr = this.repository.manager.connection.createQueryRunner();
-        await qr.connect();
-        await qr.startTransaction();
-        try {
+        return this.executeInTransaction('insert', async (qr)=>{
             await this.beforeInsertOperation(dto, user, qr);
             const entities = await this.convertRequestDtoToEntity(dto, user);
             const saved = await qr.manager.save(this.repository.target, entities);
-            await this.afterInsertOperation(saved, user, qr);
-            await qr.commitTransaction();
-            if (this.isCacheable) await Promise.all([
-                this.clearCacheForAll(),
-                this.clearCacheForId(Array.isArray(saved) ? saved : [
-                    saved
-                ])
-            ]);
-            const first = Array.isArray(saved) ? saved[0] : saved;
-            return this.convertEntityToResponseDto(first, false);
-        } catch (error) {
-            await qr.rollbackTransaction();
-            this.handleError(error, 'insert');
-        } finally{
-            await qr.release();
-        }
+            await this.afterInsertOperation(this.ensureArray(saved), user, qr);
+            return {
+                saved,
+                returnFirst: true
+            };
+        });
     }
     async insertMany(dtos, user) {
-        await this.ensureRepositoryInitialized();
-        const qr = this.repository.manager.connection.createQueryRunner();
-        await qr.connect();
-        await qr.startTransaction();
-        try {
+        return this.executeInTransaction('insertMany', async (qr)=>{
             await this.beforeInsertOperation(dtos, user, qr);
             const entities = await this.convertRequestDtoToEntity(dtos, user);
             const saved = await qr.manager.save(this.repository.target, entities);
-            await this.afterInsertOperation(Array.isArray(saved) ? saved : [
-                saved
-            ], user, qr);
-            await qr.commitTransaction();
-            if (this.isCacheable) await Promise.all([
-                this.clearCacheForAll(),
-                this.clearCacheForId(Array.isArray(saved) ? saved : [
-                    saved
-                ])
-            ]);
-            const list = (Array.isArray(saved) ? saved : [
-                saved
-            ]).map((e)=>this.convertEntityToResponseDto(e, false));
-            return list;
-        } catch (error) {
-            await qr.rollbackTransaction();
-            this.handleError(error, 'insertMany');
-        } finally{
-            await qr.release();
-        }
+            await this.afterInsertOperation(this.ensureArray(saved), user, qr);
+            return {
+                saved,
+                returnFirst: false
+            };
+        });
     }
     async update(dto, user) {
-        await this.ensureRepositoryInitialized();
-        const qr = this.repository.manager.connection.createQueryRunner();
-        await qr.connect();
-        await qr.startTransaction();
-        try {
+        return this.executeInTransaction('update', async (qr)=>{
             await this.beforeUpdateOperation(dto, user, qr);
             const entities = await this.convertRequestDtoToEntity(dto, user);
             const saved = await qr.manager.save(this.repository.target, entities);
-            await this.afterUpdateOperation(saved, user, qr);
-            await qr.commitTransaction();
-            if (this.isCacheable) await Promise.all([
-                this.clearCacheForAll(),
-                this.clearCacheForId(Array.isArray(saved) ? saved : [
-                    saved
-                ])
-            ]);
-            const first = Array.isArray(saved) ? saved[0] : saved;
-            return this.convertEntityToResponseDto(first, false);
-        } catch (error) {
-            await qr.rollbackTransaction();
-            this.handleError(error, 'update');
-        } finally{
-            await qr.release();
-        }
+            await this.afterUpdateOperation(this.ensureArray(saved), user, qr);
+            return {
+                saved,
+                returnFirst: true
+            };
+        });
     }
     async updateMany(dtos, user) {
-        await this.ensureRepositoryInitialized();
-        const qr = this.repository.manager.connection.createQueryRunner();
-        await qr.connect();
-        await qr.startTransaction();
-        try {
+        return this.executeInTransaction('updateMany', async (qr)=>{
             await this.beforeUpdateOperation(dtos, user, qr);
             const entities = await this.convertRequestDtoToEntity(dtos, user);
             const saved = await qr.manager.save(this.repository.target, entities);
-            await this.afterUpdateOperation(Array.isArray(saved) ? saved : [
-                saved
-            ], user, qr);
-            await qr.commitTransaction();
-            if (this.isCacheable) await Promise.all([
-                this.clearCacheForAll(),
-                this.clearCacheForId(Array.isArray(saved) ? saved : [
-                    saved
-                ])
-            ]);
-            const list = (Array.isArray(saved) ? saved : [
-                saved
-            ]).map((e)=>this.convertEntityToResponseDto(e, false));
-            return list;
-        } catch (error) {
-            await qr.rollbackTransaction();
-            this.handleError(error, 'updateMany');
-        } finally{
-            await qr.release();
-        }
+            await this.afterUpdateOperation(this.ensureArray(saved), user, qr);
+            return {
+                saved,
+                returnFirst: false
+            };
+        });
     }
     async findByIds(ids, user) {
         await this.ensureRepositoryInitialized();
@@ -344,6 +280,37 @@ import { In } from 'typeorm';
         });
         ErrorHandler.rethrowError(error);
     }
+    /** Ensures value is always an array */ ensureArray(value) {
+        return Array.isArray(value) ? value : [
+            value
+        ];
+    }
+    /** Executes operation in transaction with automatic cache clearing */ async executeInTransaction(operation, fn) {
+        await this.ensureRepositoryInitialized();
+        const qr = this.repository.manager.connection.createQueryRunner();
+        await qr.connect();
+        await qr.startTransaction();
+        try {
+            const { saved, returnFirst } = await fn(qr);
+            await qr.commitTransaction();
+            const savedArray = this.ensureArray(saved);
+            if (this.isCacheable) {
+                await Promise.all([
+                    this.clearCacheForAll(),
+                    this.clearCacheForId(savedArray)
+                ]);
+            }
+            if (returnFirst) {
+                return this.convertEntityToResponseDto(savedArray[0], false);
+            }
+            return savedArray.map((e)=>this.convertEntityToResponseDto(e, false));
+        } catch (error) {
+            await qr.rollbackTransaction();
+            this.handleError(error, operation);
+        } finally{
+            await qr.release();
+        }
+    }
     // Hooks (override in child classes)
     async ensureRepositoryInitialized() {}
     async beforeInsertOperation(_dto, _user, _queryRunner) {}

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

@@ -44,46 +44,31 @@ import { getRequestId, getUserId, getTenantId, getCompanyId } from '../middlewar
  * // Output: { requestId: 'uuid', userId: 'user-id', context: 'MyService', message: 'Operation completed', orderId: '123' }
  * ```
  */ export class WinstonLoggerAdapter {
-    log(message, context, ...args) {
-        const meta = args.length > 0 && typeof args[0] === 'object' ? args[0] : {};
-        winstonLogger.info(message, {
+    buildLogMeta(context, args, extra) {
+        const meta = args?.length && typeof args[0] === 'object' ? args[0] : {};
+        return {
             context: context || this.context,
             ...getCorrelationMeta(),
-            ...meta
-        });
+            ...meta,
+            ...extra
+        };
+    }
+    log(message, context, ...args) {
+        winstonLogger.info(message, this.buildLogMeta(context, args));
     }
     error(message, trace, context, ...args) {
-        const meta = args.length > 0 && typeof args[0] === 'object' ? args[0] : {};
-        winstonLogger.error(message, {
-            context: context || this.context,
-            stack: trace,
-            ...getCorrelationMeta(),
-            ...meta
-        });
+        winstonLogger.error(message, this.buildLogMeta(context, args, {
+            stack: trace
+        }));
     }
     warn(message, context, ...args) {
-        const meta = args.length > 0 && typeof args[0] === 'object' ? args[0] : {};
-        winstonLogger.warn(message, {
-            context: context || this.context,
-            ...getCorrelationMeta(),
-            ...meta
-        });
+        winstonLogger.warn(message, this.buildLogMeta(context, args));
     }
     debug(message, context, ...args) {
-        const meta = args.length > 0 && typeof args[0] === 'object' ? args[0] : {};
-        winstonLogger.debug(message, {
-            context: context || this.context,
-            ...getCorrelationMeta(),
-            ...meta
-        });
+        winstonLogger.debug(message, this.buildLogMeta(context, args));
     }
     verbose(message, context, ...args) {
-        const meta = args.length > 0 && typeof args[0] === 'object' ? args[0] : {};
-        winstonLogger.verbose(message, {
-            context: context || this.context,
-            ...getCorrelationMeta(),
-            ...meta
-        });
+        winstonLogger.verbose(message, this.buildLogMeta(context, args));
     }
     constructor(context){
         _define_property(this, "context", void 0);
@@ -97,25 +82,23 @@ import { getRequestId, getUserId, getTenantId, getCompanyId } from '../middlewar
  * 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) {
-        const logMessage = args.length > 0 ? `${message} ${JSON.stringify(args)}` : message;
-        this.logger.log(logMessage, context);
+        this.logger.log(this.formatMessage(message, args), context);
     }
     error(message, trace, context, ...args) {
-        const logMessage = args.length > 0 ? `${message} ${JSON.stringify(args)}` : message;
-        this.logger.error(logMessage, trace, context);
+        this.logger.error(this.formatMessage(message, args), trace, context);
     }
     warn(message, context, ...args) {
-        const logMessage = args.length > 0 ? `${message} ${JSON.stringify(args)}` : message;
-        this.logger.warn(logMessage, context);
+        this.logger.warn(this.formatMessage(message, args), context);
     }
     debug(message, context, ...args) {
-        const logMessage = args.length > 0 ? `${message} ${JSON.stringify(args)}` : message;
-        this.logger.debug(logMessage, context);
+        this.logger.debug(this.formatMessage(message, args), context);
     }
     verbose(message, context, ...args) {
-        const logMessage = args.length > 0 ? `${message} ${JSON.stringify(args)}` : message;
-        this.logger.verbose(logMessage, context);
+        this.logger.verbose(this.formatMessage(message, args), context);
     }
     constructor(logger){
         _define_property(this, "logger", void 0);

package/fesm/constants/permissions.js

@@ -94,6 +94,12 @@ export const FORM_PERMISSIONS = {
     UPDATE: 'form.update',
     DELETE: 'form.delete'
 };
+export const FORM_RESULT_PERMISSIONS = {
+    CREATE: 'form-result.create',
+    READ: 'form-result.read',
+    UPDATE: 'form-result.update',
+    DELETE: 'form-result.delete'
+};
 // ==================== AGGREGATED EXPORTS ====================
 /**
  * All permission codes grouped by module
@@ -117,5 +123,6 @@ export const FORM_PERMISSIONS = {
     EMAIL_CONFIG: EMAIL_CONFIG_PERMISSIONS,
     EMAIL_TEMPLATE: EMAIL_TEMPLATE_PERMISSIONS,
     // Form Builder
-    FORM: FORM_PERMISSIONS
+    FORM: FORM_PERMISSIONS,
+    FORM_RESULT: FORM_RESULT_PERMISSIONS
 };

package/fesm/dtos/delete.dto.js

@@ -20,12 +20,13 @@ function _ts_decorate(decorators, target, key, desc) {
 function _ts_metadata(k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
-import { ApiProperty } from '@nestjs/swagger';
-import { IsIn, IsNotEmpty } from 'class-validator';
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { IsIn, IsNotEmpty, IsOptional, IsUUID } from 'class-validator';
 export class DeleteDto {
     constructor(){
         _define_property(this, "id", void 0);
         _define_property(this, "type", void 0);
+        _define_property(this, "deletedById", void 0);
     }
 }
 _ts_decorate([
@@ -70,3 +71,12 @@ _ts_decorate([
     ]),
     _ts_metadata("design:type", String)
 ], DeleteDto.prototype, "type", void 0);
+_ts_decorate([
+    ApiPropertyOptional({
+        description: 'User ID who initiated the deletion (auto-set by interceptor)',
+        example: 'f2e9c8d0-7a2a-11eb-9439-0242ac130002'
+    }),
+    IsOptional(),
+    IsUUID(),
+    _ts_metadata("design:type", String)
+], DeleteDto.prototype, "deletedById", void 0);

package/fesm/dtos/response-payload.dto.js

@@ -262,72 +262,3 @@ _ts_decorate([
 MessageResponseDto = _ts_decorate([
     ApiExtraModels()
 ], MessageResponseDto);
-export class ValidationErrorDto {
-    constructor(){
-        _define_property(this, "field", void 0);
-        _define_property(this, "message", void 0);
-        _define_property(this, "constraint", void 0);
-    }
-}
-_ts_decorate([
-    ApiProperty({
-        example: 'email'
-    }),
-    _ts_metadata("design:type", String)
-], ValidationErrorDto.prototype, "field", void 0);
-_ts_decorate([
-    ApiProperty({
-        example: 'Invalid email format'
-    }),
-    _ts_metadata("design:type", String)
-], ValidationErrorDto.prototype, "message", void 0);
-_ts_decorate([
-    ApiPropertyOptional({
-        example: 'isEmail'
-    }),
-    _ts_metadata("design:type", String)
-], ValidationErrorDto.prototype, "constraint", void 0);
-export class ErrorResponseDto {
-    constructor(){
-        _define_property(this, "success", void 0);
-        _define_property(this, "message", void 0);
-        _define_property(this, "code", void 0);
-        _define_property(this, "errors", void 0);
-        _define_property(this, "_meta", void 0);
-    }
-}
-_ts_decorate([
-    ApiProperty({
-        example: false
-    }),
-    _ts_metadata("design:type", Boolean)
-], ErrorResponseDto.prototype, "success", void 0);
-_ts_decorate([
-    ApiProperty({
-        example: 'Validation failed'
-    }),
-    _ts_metadata("design:type", String)
-], ErrorResponseDto.prototype, "message", void 0);
-_ts_decorate([
-    ApiPropertyOptional({
-        example: 'VALIDATION_ERROR'
-    }),
-    _ts_metadata("design:type", String)
-], ErrorResponseDto.prototype, "code", void 0);
-_ts_decorate([
-    ApiPropertyOptional({
-        type: [
-            ValidationErrorDto
-        ]
-    }),
-    _ts_metadata("design:type", Array)
-], ErrorResponseDto.prototype, "errors", void 0);
-_ts_decorate([
-    ApiPropertyOptional({
-        type: RequestMetaDto
-    }),
-    _ts_metadata("design:type", typeof RequestMetaDto === "undefined" ? Object : RequestMetaDto)
-], ErrorResponseDto.prototype, "_meta", void 0);
-ErrorResponseDto = _ts_decorate([
-    ApiExtraModels()
-], ErrorResponseDto);