@flusys/nestjs-auth 0.1.0-beta.3 → 1.0.0-beta

package/fesm/dtos/authentication.dto.js

@@ -22,15 +22,8 @@ function _ts_metadata(k, v) {
 }
 import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
 import { IsEmail, IsNotEmpty, IsOptional, IsString, IsUUID, MaxLength, MinLength, ValidateIf } from 'class-validator';
-// =============================================================================
-// REQUEST DTOs (Following Controller Endpoint Order)
-// =============================================================================
-// -----------------------------------------------------------------------------
-// 1. LOGIN
-// -----------------------------------------------------------------------------
-/**
- * Login Request DTO
- */ export class LoginDto {
+// Request DTOs
+/** Login Request DTO */ export class LoginDto {
     constructor(){
         _define_property(this, "email", void 0);
         _define_property(this, "password", void 0);
@@ -55,13 +48,7 @@ _ts_decorate([
     MinLength(6),
     _ts_metadata("design:type", String)
 ], LoginDto.prototype, "password", void 0);
-// -----------------------------------------------------------------------------
-// 2. REGISTER
-// -----------------------------------------------------------------------------
-/**
- * Registration Request DTO
- * Supports both simple registration and company-based registration
- */ export class RegistrationDto {
+/** Registration Request DTO - Supports simple and company-based registration */ export class RegistrationDto {
     constructor(){
         _define_property(this, "name", void 0);
         _define_property(this, "email", void 0);
@@ -166,13 +153,7 @@ _ts_decorate([
     IsString(),
     _ts_metadata("design:type", String)
 ], RegistrationDto.prototype, "newCompanyAddress", void 0);
-// -----------------------------------------------------------------------------
-// 3. REFRESH TOKEN
-// -----------------------------------------------------------------------------
-/**
- * Refresh Token Request DTO
- * Note: refreshToken is optional in body - browsers send it via HTTP-only cookie
- */ export class RefreshTokenDto {
+/** Refresh Token Request DTO - refreshToken optional in body (browsers use HTTP-only cookie) */ export class RefreshTokenDto {
     constructor(){
         _define_property(this, "refreshToken", void 0);
     }
@@ -186,12 +167,7 @@ _ts_decorate([
     IsString(),
     _ts_metadata("design:type", String)
 ], RefreshTokenDto.prototype, "refreshToken", void 0);
-// -----------------------------------------------------------------------------
-// 4. CHANGE PASSWORD
-// -----------------------------------------------------------------------------
-/**
- * Change Password Request DTO
- */ export class ChangePasswordDto {
+/** Change Password Request DTO */ export class ChangePasswordDto {
     constructor(){
         _define_property(this, "currentPassword", void 0);
         _define_property(this, "newPassword", void 0);
@@ -216,14 +192,7 @@ _ts_decorate([
     MinLength(6),
     _ts_metadata("design:type", String)
 ], ChangePasswordDto.prototype, "newPassword", void 0);
-// -----------------------------------------------------------------------------
-// 5. SELECT COMPANY & BRANCH (Step 2 - after login with multiple options)
-// -----------------------------------------------------------------------------
-/**
- * Select Company & Branch Request DTO
- * Used after login when user needs to select company and branch
- * Frontend receives all companies with their branches, user selects both
- */ export class SelectDto {
+/** Select Company & Branch Request DTO - Used after login when user needs to select company and branch */ export class SelectDto {
     constructor(){
         _define_property(this, "sessionId", void 0);
         _define_property(this, "companyId", void 0);
@@ -257,13 +226,7 @@ _ts_decorate([
     IsNotEmpty(),
     _ts_metadata("design:type", String)
 ], SelectDto.prototype, "branchId", void 0);
-// -----------------------------------------------------------------------------
-// 7. SWITCH COMPANY/BRANCH (after already logged in)
-// -----------------------------------------------------------------------------
-/**
- * Switch Company Request DTO
- * Used to switch company/branch after login
- */ export class SwitchCompanyDto {
+/** Switch Company Request DTO - Used to switch company/branch after login */ export class SwitchCompanyDto {
     constructor(){
         _define_property(this, "companyId", void 0);
         _define_property(this, "branchId", void 0);
@@ -287,15 +250,8 @@ _ts_decorate([
     IsNotEmpty(),
     _ts_metadata("design:type", String)
 ], SwitchCompanyDto.prototype, "branchId", void 0);
-// =============================================================================
-// RESPONSE DTOs
-// =============================================================================
-// -----------------------------------------------------------------------------
-// NESTED/HELPER DTOs (Used in Response DTOs)
-// -----------------------------------------------------------------------------
-/**
- * User Info DTO (used in responses)
- */ export class UserInfoDto {
+// Response DTOs
+/** User Info DTO (used in responses) */ export class UserInfoDto {
     constructor(){
         _define_property(this, "id", void 0);
         _define_property(this, "email", void 0);
@@ -329,9 +285,7 @@ _ts_decorate([
     }),
     _ts_metadata("design:type", Object)
 ], UserInfoDto.prototype, "profilePictureId", void 0);
-/**
- * Company Info DTO (used in responses)
- */ export class CompanyInfoDto {
+/** Company Info DTO (used in responses) */ export class CompanyInfoDto {
     constructor(){
         _define_property(this, "id", void 0);
         _define_property(this, "name", void 0);
@@ -365,9 +319,7 @@ _ts_decorate([
     }),
     _ts_metadata("design:type", Object)
 ], CompanyInfoDto.prototype, "logoId", void 0);
-/**
- * Branch Info DTO (used in responses)
- */ export class BranchInfoDto {
+/** Branch Info DTO (used in responses) */ export class BranchInfoDto {
     constructor(){
         _define_property(this, "id", void 0);
         _define_property(this, "name", void 0);
@@ -401,9 +353,7 @@ _ts_decorate([
     }),
     _ts_metadata("design:type", Object)
 ], BranchInfoDto.prototype, "logoId", void 0);
-/**
- * Branch Info for Selection (with additional fields)
- */ export class BranchSelectionInfoDto {
+/** Branch Info for Selection (with additional fields) */ export class BranchSelectionInfoDto {
     constructor(){
         _define_property(this, "id", void 0);
         _define_property(this, "name", void 0);
@@ -444,9 +394,7 @@ _ts_decorate([
     }),
     _ts_metadata("design:type", Object)
 ], BranchSelectionInfoDto.prototype, "logoId", void 0);
-/**
- * Company with Branches DTO (for selection response)
- */ export class CompanyWithBranchesDto {
+/** Company with Branches DTO (for selection response) */ export class CompanyWithBranchesDto {
     constructor(){
         _define_property(this, "id", void 0);
         _define_property(this, "name", void 0);
@@ -497,13 +445,7 @@ _ts_decorate([
     }),
     _ts_metadata("design:type", Array)
 ], CompanyWithBranchesDto.prototype, "branches", void 0);
-// -----------------------------------------------------------------------------
-// LOGIN RESPONSE
-// -----------------------------------------------------------------------------
-/**
- * Login Response DTO
- * Returned on successful login with tokens
- */ export class LoginResponseDto {
+/** Login Response DTO - Returned on successful login with tokens */ export class LoginResponseDto {
     constructor(){
         _define_property(this, "accessToken", void 0);
         _define_property(this, "refreshToken", void 0);
@@ -553,13 +495,7 @@ _ts_decorate([
     }),
     _ts_metadata("design:type", Boolean)
 ], LoginResponseDto.prototype, "companyFeatureEnabled", void 0);
-// -----------------------------------------------------------------------------
-// REGISTRATION RESPONSE
-// -----------------------------------------------------------------------------
-/**
- * Registration Response DTO
- * Returned on successful registration
- */ export class RegistrationResponseDto {
+/** Registration Response DTO - Returned on successful registration */ export class RegistrationResponseDto {
     constructor(){
         _define_property(this, "accessToken", void 0);
         _define_property(this, "refreshToken", void 0);
@@ -609,16 +545,7 @@ _ts_decorate([
     }),
     _ts_metadata("design:type", Boolean)
 ], RegistrationResponseDto.prototype, "companyFeatureEnabled", void 0);
-// -----------------------------------------------------------------------------
-// ME (GET CURRENT USER INFO) RESPONSE
-// -----------------------------------------------------------------------------
-/**
- * Me Response DTO
- * Returned by GET /auth/me endpoint
- * Does NOT include accessToken or refreshToken - only user data
- * Company and branch are optional - only present when company feature is enabled
- * These fields are automatically hidden in Swagger when company feature is disabled
- */ export class MeResponseDto {
+/** Me Response DTO - Returned by GET /auth/me (user data only, no tokens) */ export class MeResponseDto {
     constructor(){
         _define_property(this, "user", void 0);
         _define_property(this, "company", void 0);
@@ -646,14 +573,7 @@ _ts_decorate([
     }),
     _ts_metadata("design:type", typeof BranchInfoDto === "undefined" ? Object : BranchInfoDto)
 ], MeResponseDto.prototype, "branch", void 0);
-// -----------------------------------------------------------------------------
-// COMPANY/BRANCH SELECTION RESPONSE
-// -----------------------------------------------------------------------------
-/**
- * Company Selection Response DTO
- * Returned when user has multiple companies/branches to choose from
- * Frontend displays selection UI and calls /select with chosen company + branch
- */ export class CompanySelectionResponseDto {
+/** Company Selection Response DTO - Returned when user has multiple companies/branches to choose from */ export class CompanySelectionResponseDto {
     constructor(){
         _define_property(this, "requiresSelection", void 0);
         _define_property(this, "sessionId", void 0);

package/fesm/interfaces/authentication.interface.js

@@ -1,7 +1 @@
-// =============================================================================
-// TOKEN INTERFACES
-// =============================================================================
-/**
- * Login Response when company/branch selection is required
- * Frontend shows selection UI and calls /select endpoint with chosen company + branch
- */ export { };
+/** Login Response when company/branch selection is required */ export { };

package/fesm/services/auth-config.service.js

@@ -29,76 +29,50 @@ import { Inject, Injectable, Optional } from '@nestjs/common';
 import { AuthModuleOptions } from '../interfaces/auth-module-options.interface';
 import { AUTH_MODULE_OPTIONS } from '../config/auth.constants';
 export class AuthConfigService {
-    // ==================== Database Mode ====================
-    /**
-   * Get database mode (single or multi-tenant)
-   */ getDatabaseMode() {
+    // Database Mode
+    /** Get database mode (single or multi-tenant) */ getDatabaseMode() {
         return this.options.bootstrapAppConfig?.databaseMode ?? 'single';
     }
-    /**
-   * Check if running in multi-tenant mode
-   */ isMultiTenant() {
+    /** Check if running in multi-tenant mode */ isMultiTenant() {
         return this.getDatabaseMode() === 'multi-tenant';
     }
-    // ==================== Feature Flags ====================
-    /**
-   * Check if company feature is enabled
-   */ isCompanyFeatureEnabled() {
+    // Feature Flags
+    /** Check if company feature is enabled */ isCompanyFeatureEnabled() {
         return this.options.bootstrapAppConfig?.enableCompanyFeature ?? false;
     }
-    // ==================== JWT Configuration ====================
-    /**
-   * Get JWT secret key
-   */ getJwtSecret() {
+    // JWT Configuration
+    /** Get JWT secret key */ getJwtSecret() {
         return this.config.jwtSecret ?? 'default-secret-change-in-production';
     }
-    /**
-   * Get JWT expiration time
-   */ getJwtExpiration() {
+    /** Get JWT expiration time */ getJwtExpiration() {
         return this.config.jwtExpiration ?? '1h';
     }
-    /**
-   * Get refresh token secret key
-   */ getRefreshTokenSecret() {
+    /** Get refresh token secret key */ getRefreshTokenSecret() {
         return this.config.refreshTokenSecret ?? this.getJwtSecret();
     }
-    /**
-   * Get refresh token expiration time
-   */ getRefreshTokenExpiration() {
+    /** Get refresh token expiration time */ getRefreshTokenExpiration() {
         return this.config.refreshTokenExpiration ?? '7d';
     }
-    /**
-   * Get refresh token cookie name
-   */ getRefreshTokenCookieName() {
+    /** Get refresh token cookie name */ getRefreshTokenCookieName() {
         return this.config.refreshTokenCookieName ?? 'fsn_refresh_token';
     }
-    // ==================== Database Configuration ====================
-    /**
-   * Get default database config
-   */ getDefaultDatabaseConfig() {
+    // Database Configuration
+    /** Get default database config */ getDefaultDatabaseConfig() {
         return this.config.defaultDatabaseConfig ?? this.config.tenantDefaultDatabaseConfig;
     }
-    /**
-   * Get tenant default database config (for multi-tenant)
-   */ getTenantDefaultDatabaseConfig() {
+    /** Get tenant default database config (for multi-tenant) */ getTenantDefaultDatabaseConfig() {
         return this.config.tenantDefaultDatabaseConfig;
     }
-    /**
-   * Get registered tenants
-   */ getTenants() {
+    /** Get registered tenants */ getTenants() {
         return this.config.tenants ?? [];
     }
-    // ==================== Raw Options ====================
-    /**
-   * Get full module options
-   */ getOptions() {
+    // Raw Options
+    /** Get full module options */ getOptions() {
         return {
             ...this.options
         };
     }
-    /**
-   * Get runtime config
-   */ getConfig() {
+    /** Get runtime config */ getConfig() {
         return {
             ...this.config
         };

package/fesm/services/auth-datasource.provider.js

@@ -32,11 +32,8 @@ import { Request } from 'express';
 import { AuthModuleOptions } from '../interfaces/auth-module-options.interface';
 import { AUTH_MODULE_OPTIONS } from '../config/auth.constants';
 export class AuthDataSourceProvider extends MultiTenantDataSourceService {
-    // ==================== Override Static Cache Access Methods ====================
-    /**
-   * CRITICAL: Override to access Auth-specific static properties
-   * Without this, parent class methods would access parent's static properties
-   */ async getSingleDataSource() {
+    // Override Static Cache Access Methods
+    /** Override to access Auth-specific static properties */ async getSingleDataSource() {
         if (!AuthDataSourceProvider.singleDataSource) {
             if (AuthDataSourceProvider.singleConnectionLock) {
                 return AuthDataSourceProvider.singleConnectionLock;
@@ -60,9 +57,7 @@ export class AuthDataSourceProvider extends MultiTenantDataSourceService {
         }
         return AuthDataSourceProvider.singleDataSource;
     }
-    /**
-   * CRITICAL: Override to use Auth-specific static cache for tenant connections
-   */ async getOrCreateTenantConnection(tenant) {
+    /** Override to use Auth-specific static cache for tenant connections */ async getOrCreateTenantConnection(tenant) {
         // Return existing initialized connection from Auth-specific cache
         const existing = AuthDataSourceProvider.tenantConnections.get(tenant.id);
         if (existing?.isInitialized) {
@@ -85,10 +80,8 @@ export class AuthDataSourceProvider extends MultiTenantDataSourceService {
             AuthDataSourceProvider.connectionLocks.delete(tenant.id);
         }
     }
-    // ==================== Factory Methods ====================
-    /**
-   * Build parent options from AuthModuleOptions
-   */ static buildParentOptions(options) {
+    // Factory Methods
+    /** Build parent options from AuthModuleOptions */ static buildParentOptions(options) {
         return {
             bootstrapAppConfig: options.bootstrapAppConfig,
             defaultDatabaseConfig: options.config?.defaultDatabaseConfig,
@@ -96,27 +89,18 @@ export class AuthDataSourceProvider extends MultiTenantDataSourceService {
             tenants: options.config?.tenants
         };
     }
-    // ==================== Feature Flags ====================
-    /**
-   * Get global enable company feature flag
-   */ getEnableCompanyFeature() {
+    // Feature Flags
+    /** Get global enable company feature flag */ getEnableCompanyFeature() {
         return this.authOptions.bootstrapAppConfig?.enableCompanyFeature ?? false;
     }
-    /**
-   * Get enable company feature for specific tenant
-   * Falls back to global setting if not specified per-tenant
-   */ getEnableCompanyFeatureForTenant(tenant) {
+    /** Get enable company feature for specific tenant. Falls back to global setting. */ getEnableCompanyFeatureForTenant(tenant) {
         return tenant?.enableCompanyFeature ?? this.getEnableCompanyFeature();
     }
-    /**
-   * Get enable company feature for current request context
-   */ getEnableCompanyFeatureForCurrentTenant() {
+    /** Get enable company feature for current request context */ getEnableCompanyFeatureForCurrentTenant() {
         return this.getEnableCompanyFeatureForTenant(this.getCurrentTenant() ?? undefined);
     }
-    // ==================== Entity Management ====================
-    /**
-   * Get auth entities based on company feature flag
-   */ async getAuthEntities(enableCompanyFeature) {
+    // Entity Management
+    /** Get auth entities based on company feature flag */ async getAuthEntities(enableCompanyFeature) {
         const enable = enableCompanyFeature ?? this.getEnableCompanyFeature();
         const { Company, CompanyBranch, User, UserCompanyPermission } = await import('../entities');
         const coreEntities = [
@@ -132,10 +116,8 @@ export class AuthDataSourceProvider extends MultiTenantDataSourceService {
             ...companyEntities
         ];
     }
-    // ==================== Overrides ====================
-    /**
-   * Override to dynamically set entities based on tenant config
-   */ async createDataSourceFromConfig(config) {
+    // Overrides
+    /** Override to dynamically set entities based on tenant config */ async createDataSourceFromConfig(config) {
         const currentTenant = this.getCurrentTenant();
         const enableCompanyFeature = this.getEnableCompanyFeatureForTenant(currentTenant ?? undefined);
         const entities = await this.getAuthEntities(enableCompanyFeature);