@flusys/nestjs-shared 0.1.0-beta.2 → 1.0.0-beta

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

@@ -21,12 +21,7 @@ function _ts_metadata(k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
 import { ApiExtraModels, ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
-// =============================================================================
-// REQUEST METADATA (for tracking)
-// =============================================================================
-/**
- * Request metadata - automatically added by interceptor
- */ export class RequestMetaDto {
+export class RequestMetaDto {
     constructor(){
         _define_property(this, "requestId", void 0);
         _define_property(this, "timestamp", void 0);
@@ -35,22 +30,19 @@ import { ApiExtraModels, ApiProperty, ApiPropertyOptional } from '@nestjs/swagge
 }
 _ts_decorate([
     ApiPropertyOptional({
-        example: 'req_abc123',
-        description: 'Unique request ID'
+        example: 'req_abc123'
     }),
     _ts_metadata("design:type", String)
 ], RequestMetaDto.prototype, "requestId", void 0);
 _ts_decorate([
     ApiPropertyOptional({
-        example: '2024-12-19T10:30:00.000Z',
-        description: 'Request timestamp'
+        example: '2024-12-19T10:30:00.000Z'
     }),
     _ts_metadata("design:type", String)
 ], RequestMetaDto.prototype, "timestamp", void 0);
 _ts_decorate([
     ApiPropertyOptional({
-        example: 45,
-        description: 'Response time in milliseconds'
+        example: 45
     }),
     _ts_metadata("design:type", Number)
 ], RequestMetaDto.prototype, "responseTime", void 0);
@@ -64,40 +56,30 @@ export class SingleResponseDto {
 }
 _ts_decorate([
     ApiProperty({
-        example: true,
-        description: 'Whether the operation was successful'
+        example: true
     }),
     _ts_metadata("design:type", Boolean)
 ], SingleResponseDto.prototype, "success", void 0);
 _ts_decorate([
     ApiProperty({
-        example: 'Operation successful',
-        description: 'Response message'
+        example: 'Operation successful'
     }),
     _ts_metadata("design:type", String)
 ], SingleResponseDto.prototype, "message", void 0);
 _ts_decorate([
-    ApiPropertyOptional({
-        description: 'Response data (single item)'
-    }),
+    ApiPropertyOptional(),
     _ts_metadata("design:type", typeof T === "undefined" ? Object : T)
 ], SingleResponseDto.prototype, "data", void 0);
 _ts_decorate([
     ApiPropertyOptional({
-        type: RequestMetaDto,
-        description: 'Request metadata'
+        type: RequestMetaDto
     }),
     _ts_metadata("design:type", typeof RequestMetaDto === "undefined" ? Object : RequestMetaDto)
 ], SingleResponseDto.prototype, "_meta", void 0);
 SingleResponseDto = _ts_decorate([
     ApiExtraModels()
 ], SingleResponseDto);
-// =============================================================================
-// LIST RESPONSE WITH PAGINATION (get-all)
-// =============================================================================
-/**
- * Pagination metadata for list responses
- */ export class PaginationMetaDto {
+export class PaginationMetaDto {
     constructor(){
         _define_property(this, "total", void 0);
         _define_property(this, "page", void 0);
@@ -109,43 +91,37 @@ SingleResponseDto = _ts_decorate([
 }
 _ts_decorate([
     ApiProperty({
-        example: 100,
-        description: 'Total records in database'
+        example: 100
     }),
     _ts_metadata("design:type", Number)
 ], PaginationMetaDto.prototype, "total", void 0);
 _ts_decorate([
     ApiProperty({
-        example: 0,
-        description: 'Current page number (0-based)'
+        example: 0
     }),
     _ts_metadata("design:type", Number)
 ], PaginationMetaDto.prototype, "page", void 0);
 _ts_decorate([
     ApiProperty({
-        example: 10,
-        description: 'Items per page'
+        example: 10
     }),
     _ts_metadata("design:type", Number)
 ], PaginationMetaDto.prototype, "pageSize", void 0);
 _ts_decorate([
     ApiProperty({
-        example: 10,
-        description: 'Number of items in current response'
+        example: 10
     }),
     _ts_metadata("design:type", Number)
 ], PaginationMetaDto.prototype, "count", void 0);
 _ts_decorate([
     ApiPropertyOptional({
-        example: true,
-        description: 'Whether there are more pages'
+        example: true
     }),
     _ts_metadata("design:type", Boolean)
 ], PaginationMetaDto.prototype, "hasMore", void 0);
 _ts_decorate([
     ApiPropertyOptional({
-        example: 10,
-        description: 'Total number of pages'
+        example: 10
     }),
     _ts_metadata("design:type", Number)
 ], PaginationMetaDto.prototype, "totalPages", void 0);
@@ -160,48 +136,38 @@ export class ListResponseDto {
 }
 _ts_decorate([
     ApiProperty({
-        example: true,
-        description: 'Whether the operation was successful'
+        example: true
     }),
     _ts_metadata("design:type", Boolean)
 ], ListResponseDto.prototype, "success", void 0);
 _ts_decorate([
     ApiProperty({
-        example: 'Data retrieved successfully',
-        description: 'Response message'
+        example: 'Data retrieved successfully'
     }),
     _ts_metadata("design:type", String)
 ], ListResponseDto.prototype, "message", void 0);
 _ts_decorate([
     ApiPropertyOptional({
-        description: 'Response data (array of items)',
         isArray: true
     }),
     _ts_metadata("design:type", Array)
 ], ListResponseDto.prototype, "data", void 0);
 _ts_decorate([
     ApiProperty({
-        type: PaginationMetaDto,
-        description: 'Pagination metadata'
+        type: PaginationMetaDto
     }),
     _ts_metadata("design:type", typeof PaginationMetaDto === "undefined" ? Object : PaginationMetaDto)
 ], ListResponseDto.prototype, "meta", void 0);
 _ts_decorate([
     ApiPropertyOptional({
-        type: RequestMetaDto,
-        description: 'Request metadata'
+        type: RequestMetaDto
     }),
     _ts_metadata("design:type", typeof RequestMetaDto === "undefined" ? Object : RequestMetaDto)
 ], ListResponseDto.prototype, "_meta", void 0);
 ListResponseDto = _ts_decorate([
     ApiExtraModels()
 ], ListResponseDto);
-// =============================================================================
-// BULK OPERATION RESPONSE (insert-many, update-many)
-// =============================================================================
-/**
- * Metadata for bulk operations
- */ export class BulkMetaDto {
+export class BulkMetaDto {
     constructor(){
         _define_property(this, "count", void 0);
         _define_property(this, "failed", void 0);
@@ -210,22 +176,19 @@ ListResponseDto = _ts_decorate([
 }
 _ts_decorate([
     ApiProperty({
-        example: 5,
-        description: 'Number of items successfully processed'
+        example: 5
     }),
     _ts_metadata("design:type", Number)
 ], BulkMetaDto.prototype, "count", void 0);
 _ts_decorate([
     ApiPropertyOptional({
-        example: 0,
-        description: 'Number of items that failed'
+        example: 0
     }),
     _ts_metadata("design:type", Number)
 ], BulkMetaDto.prototype, "failed", void 0);
 _ts_decorate([
     ApiPropertyOptional({
-        example: 5,
-        description: 'Total items in request'
+        example: 5
     }),
     _ts_metadata("design:type", Number)
 ], BulkMetaDto.prototype, "total", void 0);
@@ -240,36 +203,31 @@ export class BulkResponseDto {
 }
 _ts_decorate([
     ApiProperty({
-        example: true,
-        description: 'Whether the operation was successful'
+        example: true
     }),
     _ts_metadata("design:type", Boolean)
 ], BulkResponseDto.prototype, "success", void 0);
 _ts_decorate([
     ApiProperty({
-        example: 'Items processed successfully',
-        description: 'Response message'
+        example: 'Items processed successfully'
     }),
     _ts_metadata("design:type", String)
 ], BulkResponseDto.prototype, "message", void 0);
 _ts_decorate([
     ApiPropertyOptional({
-        description: 'Response data (array of items)',
         isArray: true
     }),
     _ts_metadata("design:type", Array)
 ], BulkResponseDto.prototype, "data", void 0);
 _ts_decorate([
     ApiProperty({
-        type: BulkMetaDto,
-        description: 'Bulk operation metadata'
+        type: BulkMetaDto
     }),
     _ts_metadata("design:type", typeof BulkMetaDto === "undefined" ? Object : BulkMetaDto)
 ], BulkResponseDto.prototype, "meta", void 0);
 _ts_decorate([
     ApiPropertyOptional({
-        type: RequestMetaDto,
-        description: 'Request metadata'
+        type: RequestMetaDto
     }),
     _ts_metadata("design:type", typeof RequestMetaDto === "undefined" ? Object : RequestMetaDto)
 ], BulkResponseDto.prototype, "_meta", void 0);
@@ -285,34 +243,26 @@ export class MessageResponseDto {
 }
 _ts_decorate([
     ApiProperty({
-        example: true,
-        description: 'Whether the operation was successful'
+        example: true
     }),
     _ts_metadata("design:type", Boolean)
 ], MessageResponseDto.prototype, "success", void 0);
 _ts_decorate([
     ApiProperty({
-        example: 'Operation completed successfully',
-        description: 'Response message'
+        example: 'Operation completed successfully'
     }),
     _ts_metadata("design:type", String)
 ], MessageResponseDto.prototype, "message", void 0);
 _ts_decorate([
     ApiPropertyOptional({
-        type: RequestMetaDto,
-        description: 'Request metadata'
+        type: RequestMetaDto
     }),
     _ts_metadata("design:type", typeof RequestMetaDto === "undefined" ? Object : RequestMetaDto)
 ], MessageResponseDto.prototype, "_meta", void 0);
 MessageResponseDto = _ts_decorate([
     ApiExtraModels()
 ], MessageResponseDto);
-// =============================================================================
-// ERROR RESPONSE (for consistent error handling)
-// =============================================================================
-/**
- * Error detail for validation errors
- */ export class ValidationErrorDto {
+export class ValidationErrorDto {
     constructor(){
         _define_property(this, "field", void 0);
         _define_property(this, "message", void 0);
@@ -321,22 +271,19 @@ MessageResponseDto = _ts_decorate([
 }
 _ts_decorate([
     ApiProperty({
-        example: 'email',
-        description: 'Field that failed validation'
+        example: 'email'
     }),
     _ts_metadata("design:type", String)
 ], ValidationErrorDto.prototype, "field", void 0);
 _ts_decorate([
     ApiProperty({
-        example: 'Invalid email format',
-        description: 'Error message'
+        example: 'Invalid email format'
     }),
     _ts_metadata("design:type", String)
 ], ValidationErrorDto.prototype, "message", void 0);
 _ts_decorate([
     ApiPropertyOptional({
-        example: 'isEmail',
-        description: 'Validation constraint that failed'
+        example: 'isEmail'
     }),
     _ts_metadata("design:type", String)
 ], ValidationErrorDto.prototype, "constraint", void 0);
@@ -351,22 +298,19 @@ export class ErrorResponseDto {
 }
 _ts_decorate([
     ApiProperty({
-        example: false,
-        description: 'Always false for errors'
+        example: false
     }),
     _ts_metadata("design:type", Boolean)
 ], ErrorResponseDto.prototype, "success", void 0);
 _ts_decorate([
     ApiProperty({
-        example: 'Validation failed',
-        description: 'Error message'
+        example: 'Validation failed'
     }),
     _ts_metadata("design:type", String)
 ], ErrorResponseDto.prototype, "message", void 0);
 _ts_decorate([
     ApiPropertyOptional({
-        example: 'VALIDATION_ERROR',
-        description: 'Error code'
+        example: 'VALIDATION_ERROR'
     }),
     _ts_metadata("design:type", String)
 ], ErrorResponseDto.prototype, "code", void 0);
@@ -374,15 +318,13 @@ _ts_decorate([
     ApiPropertyOptional({
         type: [
             ValidationErrorDto
-        ],
-        description: 'Validation errors (for 400 responses)'
+        ]
     }),
     _ts_metadata("design:type", Array)
 ], ErrorResponseDto.prototype, "errors", void 0);
 _ts_decorate([
     ApiPropertyOptional({
-        type: RequestMetaDto,
-        description: 'Request metadata'
+        type: RequestMetaDto
     }),
     _ts_metadata("design:type", typeof RequestMetaDto === "undefined" ? Object : RequestMetaDto)
 ], ErrorResponseDto.prototype, "_meta", void 0);
@@ -400,34 +342,27 @@ export class ResponsePayloadDto {
 }
 _ts_decorate([
     ApiProperty({
-        example: true,
-        description: 'Whether the operation was successful'
+        example: true
     }),
     _ts_metadata("design:type", Boolean)
 ], ResponsePayloadDto.prototype, "success", void 0);
 _ts_decorate([
     ApiProperty({
-        example: 'Operation successful',
-        description: 'Response message'
+        example: 'Operation successful'
     }),
     _ts_metadata("design:type", String)
 ], ResponsePayloadDto.prototype, "message", void 0);
 _ts_decorate([
-    ApiPropertyOptional({
-        description: 'Response data'
-    }),
+    ApiPropertyOptional(),
     _ts_metadata("design:type", typeof T === "undefined" ? Object : T)
 ], ResponsePayloadDto.prototype, "data", void 0);
 _ts_decorate([
-    ApiPropertyOptional({
-        description: 'Response metadata'
-    }),
+    ApiPropertyOptional(),
     _ts_metadata("design:type", Object)
 ], ResponsePayloadDto.prototype, "meta", void 0);
 _ts_decorate([
     ApiPropertyOptional({
-        type: RequestMetaDto,
-        description: 'Request metadata'
+        type: RequestMetaDto
     }),
     _ts_metadata("design:type", typeof RequestMetaDto === "undefined" ? Object : RequestMetaDto)
 ], ResponsePayloadDto.prototype, "_meta", void 0);

package/fesm/interfaces/logged-user-info.interface.js

@@ -1,4 +1,3 @@
 /**
- * Interface representing the logged-in user information
- * This is extracted from the JWT token payload
+ * Logged-in user information from JWT token payload
  */ export { };

package/fesm/interfaces/permission.interface.js

@@ -1,15 +1,3 @@
-/**
- * Permission-related interfaces and types
- */ // =============================================================================
-// PERMISSION OPERATORS
-// =============================================================================
-/**
- * Permission operator type
- * - 'and': User must have ALL permissions
- * - 'or': User must have at least ONE permission
- */ // =============================================================================
-// PERMISSION GUARD CONFIG
-// =============================================================================
 /**
  * Configuration for the permission guard
  */ export { };

package/fesm/middlewares/logger.middleware.js

@@ -23,9 +23,7 @@ import { AsyncLocalStorage } from 'async_hooks';
 import { v4 as uuidv4 } from 'uuid';
 import { instance as winstonLogger } from '../classes/winston.logger.class';
 import { REQUEST_ID_HEADER } from '../constants';
-// =============================================================================
-// CONFIGURATION
-// =============================================================================
+// Configuration
 const IS_DEBUG = envConfig.getLogConfig().level === 'debug';
 const TENANT_ID_HEADER = 'x-tenant-id';
 const EXCLUDED_PATHS = [
@@ -53,9 +51,7 @@ export const setCompanyId = (companyId)=>{
     const store = requestContext.getStore();
     if (store) store.companyId = companyId;
 };
-// =============================================================================
-// HELPER FUNCTIONS
-// =============================================================================
+// Helper Functions
 function sanitizeHeaders(headers) {
     const sanitized = {};
     for (const [key, value] of Object.entries(headers)){

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

@@ -32,7 +32,7 @@ import { Request } from 'express';
 import { DataSource } from 'typeorm';
 import { SnakeNamingStrategy } from 'typeorm-naming-strategies';
 export class MultiTenantDataSourceService {
-    // ==================== Initialization ====================
+    // Initialization
     initializeFromOptions() {
         if (!this.options) return;
         if (!MultiTenantDataSourceService.initialized) {
@@ -45,7 +45,7 @@ export class MultiTenantDataSourceService {
             MultiTenantDataSourceService.tenantsRegistry.set(tenant.id, tenant);
         });
     }
-    // ==================== Public API ====================
+    // Public API
     /**
    * Set custom tenant header name
    */ setTenantHeader(header) {
@@ -61,7 +61,7 @@ export class MultiTenantDataSourceService {
    */ isMultiTenant() {
         return this.getDatabaseMode() === 'multi-tenant';
     }
-    // ==================== Tenant Resolution ====================
+    // Tenant Resolution
     /**
    * Get current tenant ID from request header
    * Validates tenant ID format for security (alphanumeric, hyphens, underscores only)
@@ -96,7 +96,7 @@ export class MultiTenantDataSourceService {
    */ getActiveTenants() {
         return this.getAllTenants();
     }
-    // ==================== DataSource Access ====================
+    // DataSource Access
     /**
    * Get DataSource for current context (tenant or single)
    */ async getDataSource() {
@@ -116,7 +116,7 @@ export class MultiTenantDataSourceService {
    */ setDataSource(dataSource) {
         MultiTenantDataSourceService.singleDataSource = dataSource;
     }
-    // ==================== Repository Access ====================
+    // Repository Access
     /**
    * Get repository for entity in current context
    */ async getRepository(entity) {
@@ -129,7 +129,7 @@ export class MultiTenantDataSourceService {
         const dataSource = await this.getDataSourceForTenant(tenantId);
         return dataSource.getRepository(entity);
     }
-    // ==================== Multi-Tenant Operations ====================
+    // Multi-Tenant Operations
     /**
    * Execute callback with specific tenant's DataSource
    */ async withTenant(tenantId, callback) {
@@ -150,7 +150,7 @@ export class MultiTenantDataSourceService {
         }
         return results;
     }
-    // ==================== Tenant Management ====================
+    // Tenant Management
     /**
    * Register a new tenant at runtime
    */ registerTenant(tenant) {
@@ -162,7 +162,7 @@ export class MultiTenantDataSourceService {
         await this.closeTenantConnection(tenantId);
         MultiTenantDataSourceService.tenantsRegistry.delete(tenantId);
     }
-    // ==================== Connection Lifecycle ====================
+    // Connection Lifecycle
     /**
    * Close specific tenant connection
    */ async closeTenantConnection(tenantId) {
@@ -190,7 +190,7 @@ export class MultiTenantDataSourceService {
         MultiTenantDataSourceService.tenantsRegistry.clear();
         MultiTenantDataSourceService.connectionLocks.clear();
     }
-    // ==================== Protected Methods (for subclasses) ====================
+    // Protected Methods (for subclasses)
     /**
    * Get single database DataSource with connection locking to prevent race conditions
    */ async getSingleDataSource() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flusys/nestjs-shared",
-  "version": "0.1.0-beta.2",
+  "version": "1.0.0-beta",
   "description": "Common shared utilities for Flusys NestJS applications",
   "main": "cjs/index.js",
   "module": "fesm/index.js",
@@ -105,6 +105,6 @@
     "winston-daily-rotate-file": "^5.0.0"
   },
   "dependencies": {
-    "@flusys/nestjs-core": "0.1.0-beta.2"
+    "@flusys/nestjs-core": "1.0.0-beta"
   }
 }