@flusys/nestjs-auth 1.0.0-beta → 1.0.0

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

@@ -25,30 +25,43 @@ function _ts_param(paramIndex, decorator) {
         decorator(target, key, paramIndex);
     };
 }
-import { Inject, Injectable, Optional } from '@nestjs/common';
-import { AuthModuleOptions } from '../interfaces/auth-module-options.interface';
+import { Inject, Injectable, InternalServerErrorException, Logger, Optional } from '@nestjs/common';
 import { AUTH_MODULE_OPTIONS } from '../config/auth.constants';
+import { AuthModuleOptions } from '../interfaces/auth-module-options.interface';
 export 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;
     }
     // JWT Configuration
     /** Get JWT secret key */ getJwtSecret() {
-        return this.config.jwtSecret ?? 'default-secret-change-in-production';
+        if (!this.config.jwtSecret) {
+            throw new InternalServerErrorException('[AuthModule] JWT_SECRET is required - set via environment or module config');
+        }
+        return this.config.jwtSecret;
     }
     /** Get JWT expiration time */ getJwtExpiration() {
         return this.config.jwtExpiration ?? '1h';
     }
     /** Get refresh token secret key */ getRefreshTokenSecret() {
-        return this.config.refreshTokenSecret ?? this.getJwtSecret();
+        if (this.config.refreshTokenSecret) {
+            return this.config.refreshTokenSecret;
+        }
+        if (process.env.NODE_ENV === 'production') {
+            throw new 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();
     }
     /** Get refresh token expiration time */ getRefreshTokenExpiration() {
         return this.config.refreshTokenExpiration ?? '7d';
@@ -56,30 +69,15 @@ export class AuthConfigService {
     /** Get refresh token cookie name */ getRefreshTokenCookieName() {
         return this.config.refreshTokenCookieName ?? 'fsn_refresh_token';
     }
-    // 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
-        };
+    // Frontend Configuration
+    /** Get frontend URL for email links */ getFrontendUrl() {
+        return this.config.frontendUrl;
     }
     constructor(injectedOptions){
+        _define_property(this, "logger", new 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

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

@@ -26,7 +26,7 @@ function _ts_param(paramIndex, decorator) {
     };
 }
 import { MultiTenantDataSourceService } from '@flusys/nestjs-shared/modules';
-import { Inject, Injectable, Logger, Optional, Scope } from '@nestjs/common';
+import { Inject, Injectable, InternalServerErrorException, Logger, Optional, Scope } from '@nestjs/common';
 import { REQUEST } from '@nestjs/core';
 import { Request } from 'express';
 import { AuthModuleOptions } from '../interfaces/auth-module-options.interface';
@@ -41,7 +41,7 @@ export class AuthDataSourceProvider extends MultiTenantDataSourceService {
             const lockPromise = (async ()=>{
                 const config = this.getDefaultDatabaseConfig();
                 if (!config) {
-                    throw new Error('Default database config is not available');
+                    throw new InternalServerErrorException('Default database config is not available');
                 }
                 const ds = await this.createDataSourceFromConfig(config);
                 AuthDataSourceProvider.singleDataSource = ds;
@@ -90,38 +90,28 @@ export class AuthDataSourceProvider extends MultiTenantDataSourceService {
         };
     }
     // 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. */ getEnableCompanyFeatureForTenant(tenant) {
-        return tenant?.enableCompanyFeature ?? this.getEnableCompanyFeature();
-    }
-    /** Get enable company feature for current request context */ getEnableCompanyFeatureForCurrentTenant() {
-        return this.getEnableCompanyFeatureForTenant(this.getCurrentTenant() ?? undefined);
+    /** Check if company feature is enabled (tenant-specific or global fallback) */ isCompanyFeatureEnabled(tenant) {
+        const effectiveTenant = tenant ?? this.getCurrentTenant();
+        return effectiveTenant?.enableCompanyFeature ?? this.authOptions.bootstrapAppConfig?.enableCompanyFeature ?? false;
     }
     // 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');
+    /** Get auth entities based on company feature flag */ async getAuthEntities() {
+        const { Company, CompanyBranch, User, UserCompanyPermission, UserToken, PendingRegistration } = await import('../entities');
         const coreEntities = [
-            User
+            User,
+            UserToken,
+            PendingRegistration
         ];
-        const companyEntities = enable ? [
+        return this.isCompanyFeatureEnabled() ? [
+            ...coreEntities,
             Company,
             CompanyBranch,
             UserCompanyPermission
-        ] : [];
-        return [
-            ...coreEntities,
-            ...companyEntities
-        ];
+        ] : coreEntities;
     }
     // 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);
-        return super.createDataSourceFromConfig(config, entities);
+        return super.createDataSourceFromConfig(config, await this.getAuthEntities());
     }
     constructor(authOptions, request){
         super(AuthDataSourceProvider.buildParentOptions(authOptions), request), _define_property(this, "authOptions", void 0), _define_property(this, "logger", void 0), this.authOptions = authOptions, this.logger = new Logger(AuthDataSourceProvider.name);

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

@@ -0,0 +1,405 @@
+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 _ts_decorate(decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for(var i = decorators.length - 1; i >= 0; i--)if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+function _ts_metadata(k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+function _ts_param(paramIndex, decorator) {
+    return function(target, key) {
+        decorator(target, key, paramIndex);
+    };
+}
+import { BadRequestException, Inject, Injectable, InternalServerErrorException, Logger, Optional, Scope } from '@nestjs/common';
+import * as bcrypt from 'bcrypt';
+import * as crypto from 'crypto';
+import { LessThan } from 'typeorm';
+import { BCRYPT_SALT_ROUNDS } from '../config';
+import { PendingRegistration } from '../entities/pending-registration.entity';
+import { TokenType, UserToken } from '../entities/user-token.entity';
+import { User } from '../entities/user.entity';
+import { AUTH_EMAIL_PROVIDER, IAuthEmailProvider } from '../interfaces';
+import { AuthDataSourceProvider } from './auth-datasource.provider';
+export class AuthEmailService {
+    isEmailEnabled() {
+        return !!this.emailProvider;
+    }
+    // ============================================
+    // Private Helpers
+    // ============================================
+    async getRepository(entity) {
+        if (!this.dataSourceProvider) {
+            throw new InternalServerErrorException(`${String(entity)} repository not available`);
+        }
+        return this.dataSourceProvider.getRepository(entity);
+    }
+    generateToken() {
+        return crypto.randomBytes(32).toString('hex');
+    }
+    /** Hash token for secure storage - prevents token theft if database is compromised */ hashToken(token) {
+        return crypto.createHash('sha256').update(token).digest('hex');
+    }
+    getErrorMessage(error) {
+        return error instanceof Error ? error.message : 'Unknown error';
+    }
+    assertEmailEnabled() {
+        if (!this.emailProvider) {
+            throw new BadRequestException('Email service is not configured');
+        }
+    }
+    async sendVerificationEmailSafe(email, token, verifyUrl, logContext) {
+        try {
+            await this.emailProvider.sendVerificationEmail(email, token, verifyUrl);
+            this.logger.log(`${logContext} verification email sent to: ${email}`);
+        } catch (error) {
+            this.logger.error(`Failed to send verification email: ${this.getErrorMessage(error)}`);
+            throw new BadRequestException('Failed to send verification email. Please try again.');
+        }
+    }
+    validateTokenNotExpiredOrUsed(token, expiredMessage, usedMessage) {
+        if (token.expiresAt < new Date()) {
+            throw new BadRequestException(expiredMessage);
+        }
+        if (usedMessage && token.usedAt) {
+            throw new BadRequestException(usedMessage);
+        }
+    }
+    // ============================================
+    // Pending Registration (New Users)
+    // ============================================
+    async hasPendingRegistration(email) {
+        if (!this.isEmailEnabled()) return false;
+        const pendingRepository = await this.getRepository(PendingRegistration);
+        const pending = await pendingRepository.findOne({
+            where: {
+                email
+            }
+        });
+        return !!pending && pending.expiresAt > new Date();
+    }
+    async createPendingRegistration(data) {
+        this.assertEmailEnabled();
+        const userRepository = await this.getRepository(User);
+        const pendingRepository = await this.getRepository(PendingRegistration);
+        // Check if user already exists
+        const existingUser = await userRepository.findOne({
+            where: {
+                email: data.email
+            }
+        });
+        if (existingUser) {
+            throw new BadRequestException('Registration failed. Please try again or contact support.');
+        }
+        // Delete any existing pending registration for this email
+        await pendingRepository.delete({
+            email: data.email
+        });
+        // Create pending registration with hashed token for secure storage
+        const token = this.generateToken();
+        const tokenHash = this.hashToken(token);
+        const passwordHash = await bcrypt.hash(data.password, BCRYPT_SALT_ROUNDS);
+        const expiresAt = new Date(Date.now() + this.EMAIL_VERIFICATION_EXPIRY);
+        const pending = pendingRepository.create({
+            email: data.email,
+            name: data.name ?? null,
+            phone: data.phone ?? null,
+            passwordHash,
+            token: tokenHash,
+            expiresAt,
+            companyData: data.companyData ?? null
+        });
+        await pendingRepository.save(pending);
+        // Send verification email with raw token (user receives this)
+        const verifyUrl = `${data.verifyUrlBase}?token=${token}`;
+        await this.sendVerificationEmailSafe(data.email, token, verifyUrl, 'Registration');
+        return {
+            success: true,
+            message: 'Please check your email to verify your registration.'
+        };
+    }
+    // ============================================
+    // Password Reset (Existing Users)
+    // ============================================
+    /**
+   * Request password reset - sends reset email
+   */ async forgotPassword(email, resetUrlBase) {
+        this.assertEmailEnabled();
+        const userRepository = await this.getRepository(User);
+        const tokenRepository = await this.getRepository(UserToken);
+        const user = await userRepository.findOne({
+            where: {
+                email
+            }
+        });
+        // Always return success to prevent email enumeration
+        if (!user || !user.isActive) {
+            this.logger.warn(`Password reset requested for non-existent/inactive email: ${email}`);
+            return {
+                success: true,
+                message: 'If the email exists, a password reset link has been sent.'
+            };
+        }
+        // Invalidate existing password reset tokens for this user
+        await tokenRepository.delete({
+            userId: user.id,
+            type: TokenType.PASSWORD_RESET
+        });
+        // Create new token with hashed storage
+        const token = this.generateToken();
+        const tokenHash = this.hashToken(token);
+        const userToken = tokenRepository.create({
+            userId: user.id,
+            type: TokenType.PASSWORD_RESET,
+            token: tokenHash,
+            expiresAt: new Date(Date.now() + this.PASSWORD_RESET_EXPIRY)
+        });
+        await tokenRepository.save(userToken);
+        // Send email with raw token
+        const resetUrl = `${resetUrlBase}?token=${token}`;
+        try {
+            await this.emailProvider.sendPasswordResetEmail(email, token, resetUrl);
+            this.logger.log(`Password reset email sent to: ${email}`);
+        } catch (error) {
+            this.logger.error(`Failed to send password reset email: ${this.getErrorMessage(error)}`);
+            throw new BadRequestException('Failed to process request. Please try again later.');
+        }
+        return {
+            success: true,
+            message: 'If the email exists, a password reset link has been sent.'
+        };
+    }
+    /**
+   * Reset password using token
+   */ async resetPassword(token, newPassword) {
+        const userRepository = await this.getRepository(User);
+        const tokenRepository = await this.getRepository(UserToken);
+        // Hash the incoming token to compare with stored hash
+        const tokenHash = this.hashToken(token);
+        const userToken = await tokenRepository.findOne({
+            where: {
+                token: tokenHash,
+                type: TokenType.PASSWORD_RESET
+            }
+        });
+        if (!userToken) {
+            throw new BadRequestException('Invalid or expired reset token');
+        }
+        this.validateTokenNotExpiredOrUsed(userToken, 'Reset token has expired. Please request a new one.', 'This reset token has already been used.');
+        const user = await userRepository.findOne({
+            where: {
+                id: userToken.userId
+            }
+        });
+        if (!user) {
+            throw new BadRequestException('User not found');
+        }
+        // Update password
+        user.password = await bcrypt.hash(newPassword, BCRYPT_SALT_ROUNDS);
+        await userRepository.save(user);
+        // Mark token as used
+        userToken.usedAt = new Date();
+        await tokenRepository.save(userToken);
+        this.logger.log(`Password reset successful for user: ${user.email}`);
+        return {
+            success: true,
+            message: 'Password has been reset successfully.'
+        };
+    }
+    // ============================================
+    // Email Verification
+    // ============================================
+    /**
+   * Verify email using token
+   * Handles both pending registration and existing user verification
+   */ async verifyEmail(token) {
+        const pendingRepository = await this.getRepository(PendingRegistration);
+        const userRepository = await this.getRepository(User);
+        const tokenRepository = await this.getRepository(UserToken);
+        // Hash the incoming token to compare with stored hash
+        const tokenHash = this.hashToken(token);
+        // Check for pending registration first
+        const pending = await pendingRepository.findOne({
+            where: {
+                token: tokenHash
+            }
+        });
+        if (pending) {
+            if (pending.expiresAt < new Date()) {
+                await pendingRepository.delete({
+                    id: pending.id
+                });
+                throw new BadRequestException('Verification token has expired. Please register again.');
+            }
+            // Delete pending registration (will be consumed by caller to create user)
+            await pendingRepository.delete({
+                id: pending.id
+            });
+            return {
+                type: 'pending',
+                pending
+            };
+        }
+        // Check for existing user email verification token
+        const userToken = await tokenRepository.findOne({
+            where: {
+                token: tokenHash,
+                type: TokenType.EMAIL_VERIFICATION
+            }
+        });
+        if (!userToken) {
+            throw new BadRequestException('Invalid or expired verification token');
+        }
+        if (userToken.expiresAt < new Date()) {
+            await tokenRepository.delete({
+                id: userToken.id
+            });
+            throw new BadRequestException('Verification token has expired. Please request a new one.');
+        }
+        if (userToken.usedAt) {
+            return {
+                type: 'verified',
+                message: 'Email has already been verified.'
+            };
+        }
+        const user = await userRepository.findOne({
+            where: {
+                id: userToken.userId
+            }
+        });
+        if (!user) {
+            throw new BadRequestException('User not found');
+        }
+        // Mark email as verified
+        user.emailVerified = true;
+        await userRepository.save(user);
+        // Mark token as used
+        userToken.usedAt = new Date();
+        await tokenRepository.save(userToken);
+        this.logger.log(`Email verified for user: ${user.email}`);
+        return {
+            type: 'verified',
+            message: 'Email has been verified successfully.'
+        };
+    }
+    /**
+   * Resend verification email - handles both pending registrations and existing users
+   */ async resendVerificationEmail(email, verifyUrlBase) {
+        this.assertEmailEnabled();
+        const pendingRepository = await this.getRepository(PendingRegistration);
+        const userRepository = await this.getRepository(User);
+        const tokenRepository = await this.getRepository(UserToken);
+        // Check pending registration first
+        const pending = await pendingRepository.findOne({
+            where: {
+                email
+            }
+        });
+        if (pending) {
+            const token = this.generateToken();
+            pending.token = this.hashToken(token);
+            pending.expiresAt = new Date(Date.now() + this.EMAIL_VERIFICATION_EXPIRY);
+            await pendingRepository.save(pending);
+            const verifyUrl = `${verifyUrlBase}?token=${token}`;
+            await this.sendVerificationEmailSafe(email, token, verifyUrl, 'Re-sent registration');
+            return {
+                success: true,
+                message: 'If the email requires verification, a link has been sent.'
+            };
+        }
+        // Check existing user
+        const user = await userRepository.findOne({
+            where: {
+                email
+            }
+        });
+        if (!user || user.emailVerified) {
+            return {
+                success: true,
+                message: 'If the email requires verification, a link has been sent.'
+            };
+        }
+        // Invalidate existing tokens and create new one
+        await tokenRepository.delete({
+            userId: user.id,
+            type: TokenType.EMAIL_VERIFICATION
+        });
+        const token = this.generateToken();
+        const userToken = tokenRepository.create({
+            userId: user.id,
+            type: TokenType.EMAIL_VERIFICATION,
+            token: this.hashToken(token),
+            expiresAt: new Date(Date.now() + this.EMAIL_VERIFICATION_EXPIRY)
+        });
+        await tokenRepository.save(userToken);
+        const verifyUrl = `${verifyUrlBase}?token=${token}`;
+        await this.sendVerificationEmailSafe(user.email, token, verifyUrl, 'Verification');
+        return {
+            success: true,
+            message: 'If the email requires verification, a link has been sent.'
+        };
+    }
+    // ============================================
+    // Cleanup
+    // ============================================
+    /**
+   * Clean up expired tokens and pending registrations
+   */ async cleanupExpired() {
+        const tokenRepository = await this.getRepository(UserToken);
+        const pendingRepository = await this.getRepository(PendingRegistration);
+        const now = new Date();
+        const tokenResult = await tokenRepository.delete({
+            expiresAt: LessThan(now)
+        });
+        const pendingResult = await pendingRepository.delete({
+            expiresAt: LessThan(now)
+        });
+        const deletedTokens = tokenResult.affected ?? 0;
+        const deletedPending = pendingResult.affected ?? 0;
+        this.logger.log(`Cleaned up ${deletedTokens} expired tokens and ${deletedPending} expired pending registrations`);
+        return {
+            deletedTokens,
+            deletedPending
+        };
+    }
+    constructor(dataSourceProvider, emailProvider){
+        _define_property(this, "dataSourceProvider", void 0);
+        _define_property(this, "emailProvider", void 0);
+        _define_property(this, "logger", void 0);
+        _define_property(this, "PASSWORD_RESET_EXPIRY", void 0); // 1 hour
+        _define_property(this, "EMAIL_VERIFICATION_EXPIRY", void 0); // 24 hours
+        this.dataSourceProvider = dataSourceProvider;
+        this.emailProvider = emailProvider;
+        this.logger = new Logger(AuthEmailService.name);
+        this.PASSWORD_RESET_EXPIRY = 60 * 60 * 1000;
+        this.EMAIL_VERIFICATION_EXPIRY = 24 * 60 * 60 * 1000;
+    }
+}
+AuthEmailService = _ts_decorate([
+    Injectable({
+        scope: Scope.REQUEST
+    }),
+    _ts_param(0, Optional()),
+    _ts_param(0, Inject(AuthDataSourceProvider)),
+    _ts_param(1, Optional()),
+    _ts_param(1, Inject(AUTH_EMAIL_PROVIDER)),
+    _ts_metadata("design:type", Function),
+    _ts_metadata("design:paramtypes", [
+        typeof AuthDataSourceProvider === "undefined" ? Object : AuthDataSourceProvider,
+        typeof IAuthEmailProvider === "undefined" ? Object : IAuthEmailProvider
+    ])
+], AuthEmailService);