@flusys/nestjs-auth 1.1.0-beta → 1.1.0

package/cjs/interceptors/clear-token.interceptor.js

@@ -8,8 +8,10 @@ Object.defineProperty(exports, "ClearToken", {
         return ClearToken;
     }
 });
+const _utils = require("@flusys/nestjs-shared/utils");
 const _common = require("@nestjs/common");
 const _rxjs = require("rxjs");
+const _config = require("../config");
 const _authconfigservice = require("../services/auth-config.service");
 function _define_property(obj, key, value) {
     if (key in obj) {
@@ -38,39 +40,24 @@ function _ts_param(paramIndex, decorator) {
         decorator(target, key, paramIndex);
     };
 }
-const DEFAULT_COOKIE_NAME = 'fsn_refresh_token';
 let ClearToken = class ClearToken {
     get cookieName() {
-        return this.authConfig?.getRefreshTokenCookieName() ?? DEFAULT_COOKIE_NAME;
+        return this.authConfig?.getRefreshTokenCookieName() ?? _config.DEFAULT_COOKIE_NAME;
     }
     intercept(context, next) {
         const req = context.switchToHttp().getRequest();
         const res = context.switchToHttp().getResponse();
         return next.handle().pipe((0, _rxjs.map)((value)=>{
-            // Clear the refresh token cookie
-            this.clearRefreshTokenCookie(req, res);
+            if ((0, _utils.isBrowserRequest)(req)) {
+                res.clearCookie(this.cookieName, {
+                    httpOnly: true,
+                    path: '/',
+                    ...(0, _utils.buildCookieOptions)(req)
+                });
+            }
             return value;
         }));
     }
-    /**
-   * Clear refresh token cookie
-   */ clearRefreshTokenCookie(req, res) {
-        const origin = req.headers.origin || '';
-        const hostname = req.hostname || '';
-        const isHttps = origin.startsWith('https://') || req.secure;
-        let cookieDomain = hostname;
-        const domainParts = hostname.split('.');
-        if (domainParts.length > 2) {
-            cookieDomain = '.' + domainParts.slice(-2).join('.');
-        }
-        res.clearCookie(this.cookieName, {
-            httpOnly: true,
-            secure: isHttps,
-            sameSite: isHttps ? 'strict' : 'lax',
-            domain: cookieDomain,
-            path: '/'
-        });
-    }
     constructor(authConfig){
         _define_property(this, "authConfig", void 0);
         this.authConfig = authConfig;

package/cjs/interceptors/set-token.interceptor.js

@@ -8,9 +8,11 @@ Object.defineProperty(exports, "SetToken", {
         return SetToken;
     }
 });
+const _utils = require("@flusys/nestjs-shared/utils");
 const _common = require("@nestjs/common");
 const _buffer = require("buffer");
 const _rxjs = require("rxjs");
+const _config = require("../config");
 const _authconfigservice = require("../services/auth-config.service");
 function _define_property(obj, key, value) {
     if (key in obj) {
@@ -39,80 +41,37 @@ function _ts_param(paramIndex, decorator) {
         decorator(target, key, paramIndex);
     };
 }
-const DEFAULT_COOKIE_NAME = 'fsn_refresh_token';
-const MAX_COOKIE_BYTES = 3500;
 let SetToken = class SetToken {
     get cookieName() {
-        return this.authConfig?.getRefreshTokenCookieName() ?? DEFAULT_COOKIE_NAME;
+        return this.authConfig?.getRefreshTokenCookieName() ?? _config.DEFAULT_COOKIE_NAME;
+    }
+    get maxAgeMs() {
+        return (0, _utils.parseDurationToMs)(this.authConfig?.getRefreshTokenExpiration() ?? '7d');
     }
     intercept(context, next) {
         const req = context.switchToHttp().getRequest();
         const res = context.switchToHttp().getResponse();
         return next.handle().pipe((0, _rxjs.map)((value)=>{
-            // Skip if no refreshToken in response
-            if (!value || !value.refreshToken) {
-                return value;
-            }
-            const isBrowser = this.isBrowserRequest(req);
-            const tokenValue = value.refreshToken;
-            if (isBrowser) {
-                // Browser: Set cookie and remove from response body
-                this.setRefreshTokenCookie(req, res, tokenValue);
-                // Return response without refreshToken for browsers
+            if (!value?.refreshToken) return value;
+            if ((0, _utils.isBrowserRequest)(req)) {
+                this.setRefreshTokenCookie(req, res, value.refreshToken);
                 const { refreshToken, ...responseWithoutToken } = value;
                 return responseWithoutToken;
             }
-            // API/Mobile: Keep refreshToken in response body
             return value;
         }), (0, _rxjs.catchError)((err)=>(0, _rxjs.throwError)(()=>err)));
     }
-    /**
-   * Detect if request is from a browser
-   * Checks Accept header and custom X-Client-Type header
-   */ isBrowserRequest(req) {
-        // Check custom header first (allows explicit client identification)
-        const clientType = req.headers['x-client-type'];
-        if (clientType) {
-            return clientType.toLowerCase() === 'browser' || clientType.toLowerCase() === 'web';
-        }
-        // Check Accept header - browsers typically include text/html
-        const accept = req.headers['accept'] || '';
-        if (accept.includes('text/html')) {
-            return true;
-        }
-        // Check User-Agent for common browsers
-        const userAgent = req.headers['user-agent'] || '';
-        const browserPatterns = /mozilla|chrome|safari|firefox|edge|opera|msie/i;
-        if (browserPatterns.test(userAgent) && !userAgent.includes('Postman')) {
-            return true;
-        }
-        return false;
-    }
-    /**
-   * Set refresh token in HTTP-only cookie
-   */ setRefreshTokenCookie(req, res, tokenValue) {
-        const origin = req.headers.origin || '';
-        const hostname = req.hostname || '';
-        const isHttps = origin.startsWith('https://') || req.secure;
-        let cookieDomain = hostname;
-        const domainParts = hostname.split('.');
-        if (domainParts.length > 2) {
-            cookieDomain = '.' + domainParts.slice(-2).join('.');
-        }
-        // Check cookie size
-        const rawCookieString = `${this.cookieName}=${tokenValue}; HttpOnly; Domain=${cookieDomain}`;
+    setRefreshTokenCookie(req, res, tokenValue) {
+        const rawCookieString = `${this.cookieName}=${tokenValue}; HttpOnly`;
         const estimatedBytes = _buffer.Buffer.byteLength(rawCookieString, 'utf8');
-        if (estimatedBytes > MAX_COOKIE_BYTES) {
+        if (estimatedBytes > _config.MAX_COOKIE_BYTES) {
             throw new _common.PayloadTooLargeException(`Refresh token too large (≈${estimatedBytes} bytes)`);
         }
-        // Set HTTP-only secure cookie
         res.cookie(this.cookieName, tokenValue, {
             httpOnly: true,
-            secure: isHttps,
-            sameSite: isHttps ? 'strict' : 'lax',
-            domain: cookieDomain,
             path: '/',
-            maxAge: 7 * 24 * 60 * 60 * 1000
+            maxAge: this.maxAgeMs,
+            ...(0, _utils.buildCookieOptions)(req)
         });
     }
     constructor(authConfig){
@@ -123,6 +82,7 @@ let SetToken = class SetToken {
 SetToken = _ts_decorate([
     (0, _common.Injectable)(),
     _ts_param(0, (0, _common.Optional)()),
+    _ts_param(0, (0, _common.Inject)(_authconfigservice.AuthConfigService)),
     _ts_metadata("design:type", Function),
     _ts_metadata("design:paramtypes", [
         typeof _authconfigservice.AuthConfigService === "undefined" ? Object : _authconfigservice.AuthConfigService

package/cjs/interfaces/auth-email-provider.interface.js

@@ -1,5 +1,5 @@
 /**
- * Auth Email Provider Interface
+ * Auth Email  Provider Interface
  *
  * This interface defines the contract for email sending in the auth module.
  * It allows auth to work independently of the email module.

package/cjs/modules/auth.module.js

@@ -12,16 +12,15 @@ const _modules = require("@flusys/nestjs-shared/modules");
 const _common = require("@nestjs/common");
 const _jwt = require("@nestjs/jwt");
 const _passport = require("@nestjs/passport");
-const _typeorm = require("@nestjs/typeorm");
-const _authconfigservice = require("../services/auth-config.service");
-const _authdatasourceprovider = require("../services/auth-datasource.provider");
+const _guards = require("@flusys/nestjs-shared/guards");
 const _authconstants = require("../config/auth.constants");
 const _controllers = require("../controllers");
 const _entities = require("../entities");
-const _guards = require("@flusys/nestjs-shared/guards");
 const _cleartokeninterceptor = require("../interceptors/clear-token.interceptor");
 const _settokeninterceptor = require("../interceptors/set-token.interceptor");
 const _services = require("../services");
+const _authconfigservice = require("../services/auth-config.service");
+const _authdatasourceprovider = require("../services/auth-datasource.provider");
 const _jwtstrategy = require("../strategies/jwt.strategy");
 function _ts_decorate(decorators, target, key, desc) {
     var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
@@ -31,82 +30,48 @@ function _ts_decorate(decorators, target, key, desc) {
 }
 let AuthModule = class AuthModule {
     static forRoot(options) {
-        return this.buildDynamicModule(options);
+        const optionsProvider = {
+            provide: _authconstants.AUTH_MODULE_OPTIONS,
+            useValue: options
+        };
+        return this.buildModule(options, [
+            optionsProvider,
+            ...options.providers ?? []
+        ]);
     }
-    static forRootAsync(asyncOptions) {
-        const { global = false, includeController = true, bootstrapAppConfig: { enableCompanyFeature } = {}, imports: externalImports = [], providers: additionalProviders = [] } = asyncOptions;
-        const asyncProviders = this.createAsyncProviders(asyncOptions);
-        // Build imports
-        const imports = [
-            ...externalImports,
-            _passport.PassportModule.register({
-                defaultStrategy: 'jwt'
-            }),
-            _jwt.JwtModule.register({}),
-            _modules.CacheModule,
-            _modules.UtilsModule
-        ];
-        // Build controllers based on configuration
-        const controllers = [];
-        if (includeController) {
-            // Core authentication controller (always included)
-            controllers.push(_controllers.AuthenticationController);
-            // User controller (always included)
-            controllers.push(_controllers.UserController);
-            // Company feature controllers (conditional)
-            if (enableCompanyFeature) {
-                controllers.push(_controllers.CompanySelectionController, _controllers.CompanyController, _controllers.BranchController, _controllers.UserPermissionController);
-            }
-        }
-        // Build providers
-        const providers = [
+    static forRootAsync(options) {
+        const asyncProviders = this.createAsyncProviders(options);
+        return this.buildModule(options, [
             ...asyncProviders,
-            ...additionalProviders,
-            // Config & Infrastructure
-            _authconfigservice.AuthConfigService,
-            _authdatasourceprovider.AuthDataSourceProvider,
-            // Auth core
-            _jwtstrategy.JwtStrategy,
-            _guards.JwtAuthGuard,
-            _services.AuthenticationService,
-            _services.AuthEmailService,
-            // Interceptors
-            _settokeninterceptor.SetToken,
-            _cleartokeninterceptor.ClearToken,
-            // Core services (always included)
-            _services.UserService
-        ];
-        // Company feature services (conditional)
-        if (enableCompanyFeature) {
-            providers.push(_services.CompanySelectionSessionService, _services.CompanyService, _services.BranchService, _services.UserPermissionService);
-        }
-        // Build exports
-        const exports1 = [
-            _passport.PassportModule,
-            _authconstants.AUTH_MODULE_OPTIONS,
-            _authconfigservice.AuthConfigService,
-            _authdatasourceprovider.AuthDataSourceProvider,
-            _jwtstrategy.JwtStrategy,
-            _guards.JwtAuthGuard,
-            _services.AuthenticationService,
-            _services.AuthEmailService,
-            _services.UserService
-        ];
-        if (enableCompanyFeature) {
-            exports1.push(_services.CompanySelectionSessionService, _services.CompanyService, _services.BranchService, _services.UserPermissionService);
-        }
+            ...options.providers ?? []
+        ], options.imports);
+    }
+    static buildModule(options, providers, externalImports = []) {
+        const { global = false, includeController = true, bootstrapAppConfig } = options;
+        const featureFlags = this.getFeatureFlags(bootstrapAppConfig);
         return {
             module: AuthModule,
             global,
-            imports,
-            controllers,
-            providers,
-            exports: exports1
+            imports: [
+                ...externalImports,
+                ...this.buildImports()
+            ],
+            controllers: this.buildControllers(includeController, featureFlags),
+            providers: [
+                ...providers,
+                ...this.buildProviders(featureFlags)
+            ],
+            exports: this.buildExports(featureFlags)
+        };
+    }
+    static getFeatureFlags(bootstrapAppConfig) {
+        return {
+            enableCompanyFeature: bootstrapAppConfig?.enableCompanyFeature ?? false,
+            enableEmailVerification: bootstrapAppConfig?.enableEmailVerification ?? true
         };
     }
-    static buildDynamicModule(options) {
-        const { bootstrapAppConfig: { enableCompanyFeature } = {}, includeController = true, global = false, providers: additionalProviders = [] } = options;
-        const imports = [
+    static buildImports() {
+        return [
             _passport.PassportModule.register({
                 defaultStrategy: 'jwt'
             }),
@@ -114,42 +79,41 @@ let AuthModule = class AuthModule {
             _modules.CacheModule,
             _modules.UtilsModule
         ];
-        // Build controllers based on configuration
-        const controllers = [];
-        if (includeController) {
-            // Core authentication controller (always included)
-            controllers.push(_controllers.AuthenticationController);
-            // User controller (always included)
-            controllers.push(_controllers.UserController);
-            // Company feature controllers (conditional)
-            if (enableCompanyFeature) {
-                controllers.push(_controllers.CompanySelectionController, _controllers.CompanyController, _controllers.BranchController, _controllers.UserPermissionController);
-            }
+    }
+    static buildControllers(includeController, flags) {
+        if (!includeController) return [];
+        const controllers = [
+            _controllers.AuthenticationController,
+            _controllers.UserController
+        ];
+        if (flags.enableEmailVerification) {
+            controllers.push(_controllers.EmailVerificationController);
         }
+        if (flags.enableCompanyFeature) {
+            controllers.push(_controllers.CompanySelectionController, _controllers.CompanyController, _controllers.BranchController, _controllers.UserPermissionController);
+        }
+        return controllers;
+    }
+    static buildProviders(flags) {
         const providers = [
-            {
-                provide: _authconstants.AUTH_MODULE_OPTIONS,
-                useValue: options
-            },
-            ...additionalProviders,
-            // Config & Infrastructure
             _authconfigservice.AuthConfigService,
             _authdatasourceprovider.AuthDataSourceProvider,
-            // Auth core
             _jwtstrategy.JwtStrategy,
             _guards.JwtAuthGuard,
             _services.AuthenticationService,
-            _services.AuthEmailService,
-            // Interceptors
             _settokeninterceptor.SetToken,
             _cleartokeninterceptor.ClearToken,
-            // Core services (always included)
             _services.UserService
         ];
-        // Company feature services (conditional)
-        if (enableCompanyFeature) {
+        if (flags.enableEmailVerification) {
+            providers.push(_services.AuthEmailService);
+        }
+        if (flags.enableCompanyFeature) {
             providers.push(_services.CompanySelectionSessionService, _services.CompanyService, _services.BranchService, _services.UserPermissionService);
         }
+        return providers;
+    }
+    static buildExports(flags) {
         const exports1 = [
             _passport.PassportModule,
             _authconstants.AUTH_MODULE_OPTIONS,
@@ -158,20 +122,15 @@ let AuthModule = class AuthModule {
             _jwtstrategy.JwtStrategy,
             _guards.JwtAuthGuard,
             _services.AuthenticationService,
-            _services.AuthEmailService,
             _services.UserService
         ];
-        if (enableCompanyFeature) {
+        if (flags.enableEmailVerification) {
+            exports1.push(_services.AuthEmailService);
+        }
+        if (flags.enableCompanyFeature) {
             exports1.push(_services.CompanySelectionSessionService, _services.CompanyService, _services.BranchService, _services.UserPermissionService);
         }
-        return {
-            module: AuthModule,
-            global,
-            imports,
-            controllers,
-            providers,
-            exports: exports1
-        };
+        return exports1;
     }
     static createAsyncProviders(options) {
         const staticOptions = {
@@ -183,13 +142,10 @@ let AuthModule = class AuthModule {
             return [
                 {
                     provide: _authconstants.AUTH_MODULE_OPTIONS,
-                    useFactory: async (...args)=>{
-                        const config = await options.useFactory(...args);
-                        return {
+                    useFactory: async (...args)=>({
                             ...staticOptions,
-                            config
-                        };
-                    },
+                            config: await options.useFactory(...args)
+                        }),
                     inject: options.inject || []
                 }
             ];
@@ -202,13 +158,10 @@ let AuthModule = class AuthModule {
                 },
                 {
                     provide: _authconstants.AUTH_MODULE_OPTIONS,
-                    useFactory: async (factory)=>{
-                        const config = await factory.createAuthOptions();
-                        return {
+                    useFactory: async (factory)=>({
                             ...staticOptions,
-                            config
-                        };
-                    },
+                            config: await factory.createAuthOptions()
+                        }),
                     inject: [
                         options.useClass
                     ]
@@ -219,13 +172,10 @@ let AuthModule = class AuthModule {
             return [
                 {
                     provide: _authconstants.AUTH_MODULE_OPTIONS,
-                    useFactory: async (factory)=>{
-                        const config = await factory.createAuthOptions();
-                        return {
+                    useFactory: async (factory)=>({
                             ...staticOptions,
-                            config
-                        };
-                    },
+                            config: await factory.createAuthOptions()
+                        }),
                     inject: [
                         options.useExisting
                     ]
@@ -239,36 +189,11 @@ let AuthModule = class AuthModule {
             }
         ];
     }
-    /**
-   * Create repository providers that use AuthDataSourceProvider
-   * This replaces TypeOrmModule.forFeature() functionality
-   * Note: Must be REQUEST-scoped since AuthDataSourceProvider is REQUEST-scoped
-   */ static getRepositoryProviders(enableCompanyFeature) {
-        const entities = this.getEntities(enableCompanyFeature);
-        return entities.map((entity)=>({
-                provide: (0, _typeorm.getRepositoryToken)(entity),
-                scope: _common.Scope.REQUEST,
-                useFactory: async (dataSourceProvider)=>{
-                    return await dataSourceProvider.getRepository(entity);
-                },
-                inject: [
-                    _authdatasourceprovider.AuthDataSourceProvider
-                ]
-            }));
-    }
-    static getEntities(enableCompanyFeature = false) {
-        const coreEntities = [
-            _entities.User
-        ];
-        const companyEntities = enableCompanyFeature ? [
-            _entities.Company,
-            _entities.CompanyBranch,
-            _entities.UserCompanyPermission
-        ] : [];
-        return [
-            ...coreEntities,
-            ...companyEntities
-        ];
+    static getEntities(config) {
+        return (0, _entities.getEntitiesByConfig)({
+            enableCompanyFeature: config.enableCompanyFeature ?? false,
+            enableEmailVerification: config.enableEmailVerification ?? true
+        });
     }
 };
 AuthModule = _ts_decorate([

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

@@ -8,9 +8,10 @@ Object.defineProperty(exports, "AuthConfigService", {
         return AuthConfigService;
     }
 });
+const _config = require("@flusys/nestjs-core/config");
 const _common = require("@nestjs/common");
-const _authmoduleoptionsinterface = require("../interfaces/auth-module-options.interface");
 const _authconstants = require("../config/auth.constants");
+const _authmoduleoptionsinterface = require("../interfaces/auth-module-options.interface");
 function _define_property(obj, key, value) {
     if (key in obj) {
         Object.defineProperty(obj, key, {
@@ -39,61 +40,58 @@ function _ts_param(paramIndex, decorator) {
     };
 }
 let AuthConfigService = class AuthConfigService {
-    // Database Mode
-    /** Get database mode (single or multi-tenant) */ getDatabaseMode() {
+    // Database Mode (required by IModuleConfigService)
+    getDatabaseMode() {
         return this.options.bootstrapAppConfig?.databaseMode ?? 'single';
     }
-    /** Check if running in multi-tenant mode */ isMultiTenant() {
+    isMultiTenant() {
         return this.getDatabaseMode() === 'multi-tenant';
     }
     // Feature Flags
-    /** Check if company feature is enabled */ isCompanyFeatureEnabled() {
+    isCompanyFeatureEnabled() {
         return this.options.bootstrapAppConfig?.enableCompanyFeature ?? false;
     }
+    isEmailVerificationEnabled() {
+        return this.options.bootstrapAppConfig?.enableEmailVerification ?? true;
+    }
     // JWT Configuration
-    /** Get JWT secret key */ getJwtSecret() {
-        return this.config.jwtSecret ?? 'default-secret-change-in-production';
+    getJwtSecret() {
+        if (!this.config.jwtSecret) {
+            throw new _common.InternalServerErrorException('[AuthModule] JWT_SECRET is required - set via environment or module config');
+        }
+        return this.config.jwtSecret;
     }
-    /** Get JWT expiration time */ getJwtExpiration() {
+    getJwtExpiration() {
         return this.config.jwtExpiration ?? '1h';
     }
-    /** Get refresh token secret key */ getRefreshTokenSecret() {
-        return this.config.refreshTokenSecret ?? this.getJwtSecret();
-    }
-    /** Get refresh token expiration time */ getRefreshTokenExpiration() {
+    getRefreshTokenSecret() {
+        if (this.config.refreshTokenSecret) {
+            return this.config.refreshTokenSecret;
+        }
+        if (_config.envConfig.isProduction()) {
+            throw new _common.InternalServerErrorException('[AuthModule] REFRESH_TOKEN_SECRET is required in production - ' + 'using the same secret for access and refresh tokens is a security risk');
+        }
+        if (!this.refreshTokenSecretWarned) {
+            this.refreshTokenSecretWarned = true;
+            this.logger.warn('REFRESH_TOKEN_SECRET not configured - using JWT_SECRET as fallback. ' + 'For better security, configure a separate refresh token secret.');
+        }
+        return this.getJwtSecret();
+    }
+    getRefreshTokenExpiration() {
         return this.config.refreshTokenExpiration ?? '7d';
     }
-    /** Get refresh token cookie name */ getRefreshTokenCookieName() {
+    getRefreshTokenCookieName() {
         return this.config.refreshTokenCookieName ?? 'fsn_refresh_token';
     }
     // Frontend Configuration
-    /** Get frontend URL for email links */ getFrontendUrl() {
+    getFrontendUrl() {
         return this.config.frontendUrl;
     }
-    // Database Configuration
-    /** Get default database config */ getDefaultDatabaseConfig() {
-        return this.config.defaultDatabaseConfig ?? this.config.tenantDefaultDatabaseConfig;
-    }
-    /** Get tenant default database config (for multi-tenant) */ getTenantDefaultDatabaseConfig() {
-        return this.config.tenantDefaultDatabaseConfig;
-    }
-    /** Get registered tenants */ getTenants() {
-        return this.config.tenants ?? [];
-    }
-    // Raw Options
-    /** Get full module options */ getOptions() {
-        return {
-            ...this.options
-        };
-    }
-    /** Get runtime config */ getConfig() {
-        return {
-            ...this.config
-        };
-    }
     constructor(injectedOptions){
+        _define_property(this, "logger", new _common.Logger(AuthConfigService.name));
         _define_property(this, "options", void 0);
         _define_property(this, "config", void 0);
+        _define_property(this, "refreshTokenSecretWarned", false);
         this.options = injectedOptions ?? {
             global: false,
             includeController: true