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

package/fesm/services/user.service.js

@@ -28,30 +28,23 @@ function _ts_param(paramIndex, decorator) {
 import { RequestScopedApiService, HybridCache } from '@flusys/nestjs-shared/classes';
 import { UtilsService } from '@flusys/nestjs-shared/modules';
 import { ErrorHandler } from '@flusys/nestjs-shared/utils';
-import { BadRequestException, Inject, Injectable, Logger, NotFoundException, Scope } from '@nestjs/common';
+import { BadRequestException, ForbiddenException, Inject, Injectable, NotFoundException, Optional, Scope } from '@nestjs/common';
 import * as bcrypt from 'bcrypt';
 import { AuthConfigService } from './auth-config.service';
 import { AuthDataSourceProvider } from './auth-datasource.provider';
+import { BCRYPT_SALT_ROUNDS, USER_ENRICHER } from '../config';
 import { PermissionType } from '../enums';
+import { IUserEnricher } from '../interfaces/user-enricher.interface';
 import { UserCompanyPermission } from '../entities/user-company-permission.entity';
 import { User } from '../entities/user.entity';
 export class UserService extends RequestScopedApiService {
-    /**
-   * Resolve entity class for this service
-   * @returns User entity class
-   */ resolveEntity() {
+    resolveEntity() {
         return User;
     }
-    /**
-   * Get DataSource provider for this service
-   * @returns AuthDataSourceProvider instance
-   */ getDataSourceProvider() {
+    getDataSourceProvider() {
         return this.dataSourceProvider;
     }
-    /**
-   * Override ensureRepositoryInitialized to also initialize permission repository and dataSource
-   * CRITICAL: Also initializes permissionRepository and dataSource for company feature support
-   */ async ensureRepositoryInitialized() {
+    async ensureRepositoryInitialized() {
         await super.ensureRepositoryInitialized();
         // Initialize permission repository if company feature is enabled
         const isCompanyFeatureEnabled = this.authConfig.isCompanyFeatureEnabled();
@@ -65,26 +58,16 @@ export class UserService extends RequestScopedApiService {
             this.dataSource = await this.getDataSourceForService();
         }
     }
-    // ==========================================================================
-    // CUSTOM METHODS (Beyond RequestScopedApiService)
-    // ==========================================================================
+    // Custom Methods
     /**
-   * Update last login timestamp
-   */ async updateLastLogin(id) {
-        // Ensure repository is initialized for custom method
-        await this.ensureRepositoryInitialized();
-        await this.repository.update(id, {
-            lastLoginAt: new Date()
-        });
-        await this.clearCacheForId([
-            {
-                id
-            }
-        ]);
+   * Validate that the requesting user owns the target profile.
+   * Users can only access/modify their own profile data.
+   */ validateProfileOwnership(targetUserId, requestingUser) {
+        if (targetUserId !== requestingUser.id) {
+            throw new ForbiddenException('Cannot access another user\'s profile');
+        }
     }
-    /**
-   * Verify email
-   */ async verifyEmail(id) {
+    /** Verify email */ async verifyEmail(id) {
         // Ensure repository is initialized for custom method
         await this.ensureRepositoryInitialized();
         await this.repository.update(id, {
@@ -97,9 +80,7 @@ export class UserService extends RequestScopedApiService {
             }
         ]);
     }
-    /**
-   * Verify phone
-   */ async verifyPhone(id) {
+    /** Verify phone */ async verifyPhone(id) {
         // Ensure repository is initialized for custom method
         await this.ensureRepositoryInitialized();
         await this.repository.update(id, {
@@ -112,12 +93,7 @@ export class UserService extends RequestScopedApiService {
             }
         ]);
     }
-    /**
-   * Update user status
-   *
-   * When company feature is disabled: Updates User.isActive directly
-   * When company feature is enabled: Updates UserCompanyPermission.isActive for the logged user's company
-   */ async updateStatus(id, isActive, user) {
+    /** Update user status. When company feature enabled, updates permission isActive for logged user's company. */ async updateStatus(id, isActive, user) {
         // Ensure repository is initialized for custom method
         await this.ensureRepositoryInitialized();
         const isCompanyFeatureEnabled = this.authConfig.isCompanyFeatureEnabled();
@@ -148,50 +124,68 @@ export class UserService extends RequestScopedApiService {
             }
         ]);
     }
-    // ==========================================================================
-    // APISERVICE OVERRIDES (Customize behavior)
-    // ==========================================================================
-    /**
-   * Override: Convert DTO to entity (hash password before saving)
-   */ async convertSingleDtoToEntity(dto, user) {
+    // ApiService Overrides
+    /** Convert DTO to entity (hash password before saving) */ async convertSingleDtoToEntity(dto, user) {
         // Repository initialization is handled automatically by RequestScopedApiService
         const entity = await super.convertSingleDtoToEntity(dto, user);
-        // Hash password if provided
-        if (dto.password) {
-            entity.password = await bcrypt.hash(dto.password, 10);
+        // Hash password if provided (CreateUserDto has password field)
+        if ('password' in dto && dto.password) {
+            entity.password = await bcrypt.hash(dto.password, BCRYPT_SALT_ROUNDS);
         }
         return entity;
     }
-    /**
-   * Override: Convert entity to response DTO (remove password!)
-   *
-   * When company feature is enabled and raw mode is used, isActive comes from
-   * the permission table (user_companyIsActive). Otherwise, it comes from User entity.
-   */ convertEntityToResponseDto(entity, isRaw) {
+    /** Convert entity to response DTO (removes password). In raw mode with company feature, isActive comes from permission table. */ convertEntityToResponseDto(entity, isRaw) {
+        if (isRaw) {
+            return this.convertRawToResponseDto(entity);
+        }
+        return this.convertEntityToDto(entity);
+    }
+    /** Convert raw query result to response DTO */ convertRawToResponseDto(raw) {
         // When raw mode is used with company feature, isActive comes from computed field
-        const isActive = isRaw && entity.user_companyIsActive !== undefined ? Boolean(entity.user_companyIsActive) : entity.isActive;
+        const isActive = raw.user_companyIsActive !== undefined ? Boolean(raw.user_companyIsActive) : raw.user_is_active;
         return {
-            id: isRaw ? entity.user_id : entity.id,
-            name: isRaw ? entity.user_name : entity.name,
-            phone: isRaw ? entity.user_phone : entity.phone,
-            email: isRaw ? entity.user_email : entity.email,
-            profilePictureId: isRaw ? entity.user_profilePictureId : entity.profilePictureId,
+            id: raw.user_id,
+            name: raw.user_name,
+            phone: raw.user_phone,
+            email: raw.user_email,
+            profilePictureId: raw.user_profile_picture_id,
             isActive,
-            emailVerified: isRaw ? entity.user_emailVerified : entity.emailVerified,
-            phoneVerified: isRaw ? entity.user_phoneVerified : entity.phoneVerified,
-            lastLoginAt: isRaw ? entity.user_lastLoginAt : entity.lastLoginAt,
-            additionalFields: isRaw ? entity.user_additionalFields : entity.additionalFields,
-            createdAt: isRaw ? entity.user_createdAt : entity.createdAt,
-            updatedAt: isRaw ? entity.user_updatedAt : entity.updatedAt,
-            deletedAt: isRaw ? entity.user_deletedAt : entity.deletedAt,
-            createdById: isRaw ? entity.user_createdById : entity.createdById,
-            updatedById: isRaw ? entity.user_updatedById : entity.updatedById,
-            deletedById: isRaw ? entity.user_deletedById : entity.deletedById
+            emailVerified: raw.user_email_verified,
+            phoneVerified: raw.user_phone_verified,
+            lastLoginAt: raw.user_last_login_at,
+            additionalFields: raw.user_additional_fields,
+            createdAt: raw.user_created_at,
+            updatedAt: raw.user_updated_at,
+            deletedAt: raw.user_deleted_at,
+            createdById: raw.user_created_by_id,
+            updatedById: raw.user_updated_by_id,
+            deletedById: raw.user_deleted_by_id
         };
     }
-    /**
-   * Override: Global search - search by name, email, or phone
-   */ async getGlobalSearchQuery(query, search, _user) {
+    /** Convert entity to response DTO */ convertEntityToDto(entity) {
+        return {
+            id: entity.id,
+            name: entity.name,
+            phone: entity.phone,
+            email: entity.email,
+            profilePictureId: entity.profilePictureId,
+            isActive: entity.isActive,
+            emailVerified: entity.emailVerified,
+            phoneVerified: entity.phoneVerified,
+            lastLoginAt: entity.lastLoginAt,
+            additionalFields: entity.additionalFields,
+            createdAt: entity.createdAt,
+            updatedAt: entity.updatedAt,
+            deletedAt: entity.deletedAt,
+            createdById: entity.createdById,
+            updatedById: entity.updatedById,
+            deletedById: entity.deletedById
+        };
+    }
+    /** Convert entity list to response DTO list */ convertEntityListToResponseListDto(entities, isRaw) {
+        return entities.map((entity)=>this.convertEntityToResponseDto(entity, isRaw));
+    }
+    /** Global search - search by name, email, or phone */ async getGlobalSearchQuery(query, search, _user) {
         query.andWhere('(user.name LIKE :search OR user.email LIKE :search OR user.phone LIKE :search)', {
             search: `%${search}%`
         });
@@ -200,18 +194,13 @@ export class UserService extends RequestScopedApiService {
             isRaw: false
         };
     }
-    /**
-   * Override: getExtraManipulateQuery - Add company permission-based isActive check when company feature enabled
-   *
-   * Note: When company feature is disabled at bootstrap, this method returns without modifications.
-   * All company-related filtering is skipped, and users are returned normally with isActive from User entity.
-   *
-   * When company feature is enabled:
-   * - isActive is computed from UserCompanyPermission table
-   * - Returns isRaw: true to use raw query results
-   */ async getExtraManipulateQuery(query, filterAndPaginationDto, user) {
+    /** Add company permission-based isActive check when company feature enabled. Returns isRaw: true for computed fields. */ async getExtraManipulateQuery(query, filterAndPaginationDto, user) {
         // Repository initialization is handled automatically by RequestScopedApiService
-        const result = await super.getExtraManipulateQuery(query, filterAndPaginationDto, user);
+        let result = await super.getExtraManipulateQuery(query, filterAndPaginationDto, user);
+        // Apply user enricher query modifications if available
+        if (this.userEnricher?.enrichListQuery) {
+            await this.userEnricher.enrichListQuery(query, user);
+        }
         // Only apply company filtering if:
         // 1. Company feature is enabled at bootstrap
         // 2. User has company context
@@ -264,12 +253,7 @@ export class UserService extends RequestScopedApiService {
         }
         return result;
     }
-    /**
-   * Override: insert - Create company permission when company feature is enabled
-   *
-   * Note: When company feature is disabled at bootstrap, this method falls back to parent implementation.
-   * No company permissions are created, and user is inserted normally.
-   */ async insert(dto, user) {
+    /** Insert user. Creates company permission when company feature is enabled. */ async insert(dto, user) {
         // Repository initialization is handled automatically by RequestScopedApiService
         // Check if company feature is enabled
         const isCompanyFeatureEnabled = this.authConfig.isCompanyFeatureEnabled();
@@ -337,17 +321,143 @@ export class UserService extends RequestScopedApiService {
         }
     }
     /**
-   * Update user profile with password handling
-   */ async profile(dto, user) {
-        // Repository initialization is handled automatically by RequestScopedApiService
+   * Get user profile with extras from enricher
+   * Returns base user data plus any extra data provided by enricher (roles, permissions, etc.)
+   */ async getProfileWithExtras(userId, user) {
+        this.validateProfileOwnership(userId, user);
+        await this.ensureRepositoryInitialized();
+        const userEntity = await this.repository.findOne({
+            where: {
+                id: userId
+            }
+        });
+        if (!userEntity) {
+            throw new NotFoundException('User not found');
+        }
+        const userData = this.convertEntityToResponseDto(userEntity, false);
+        // Get extras from enricher if available
+        let extras;
+        if (this.userEnricher?.getProfileExtras) {
+            extras = await this.userEnricher.getProfileExtras(userId, user);
+        }
+        return {
+            user: userData,
+            extras
+        };
+    }
+    /**
+   * Get enriched user list
+   * Applies enricher transformations after query execution
+   */ async getEnrichedList(users, user) {
+        if (this.userEnricher?.enrichListItems) {
+            return this.userEnricher.enrichListItems(users, user);
+        }
+        return users;
+    }
+    // ============================================
+    // Multi-Step Profile Methods (via Enricher)
+    // ============================================
+    /**
+   * Get profile section definitions from enricher
+   */ async getProfileSections() {
+        if (this.userEnricher?.getProfileSections) {
+            return this.userEnricher.getProfileSections();
+        }
+        return [];
+    }
+    /**
+   * Get specific profile section data
+   */ async getProfileSectionData(userId, sectionId, user) {
+        this.validateProfileOwnership(userId, user);
+        await this.ensureRepositoryInitialized();
+        // Verify user exists
+        const userEntity = await this.repository.findOne({
+            where: {
+                id: userId
+            }
+        });
+        if (!userEntity) {
+            throw new NotFoundException('User not found');
+        }
+        if (this.userEnricher?.getProfileSectionData) {
+            return this.userEnricher.getProfileSectionData(userId, sectionId, user);
+        }
+        return null;
+    }
+    /**
+   * Update specific profile section
+   */ async updateProfileSection(userId, sectionId, data, user) {
+        this.validateProfileOwnership(userId, user);
+        await this.ensureRepositoryInitialized();
         if (!this.dataSource) {
             throw new BadRequestException('DataSource not available');
         }
+        // Verify user exists
+        const userEntity = await this.repository.findOne({
+            where: {
+                id: userId
+            }
+        });
+        if (!userEntity) {
+            throw new NotFoundException('User not found');
+        }
+        if (!this.userEnricher?.updateProfileSection) {
+            throw new BadRequestException('Profile sections not supported');
+        }
+        const queryRunner = this.dataSource.createQueryRunner();
+        await queryRunner.connect();
+        await queryRunner.startTransaction();
+        try {
+            await this.userEnricher.updateProfileSection(userId, sectionId, data, queryRunner);
+            await queryRunner.commitTransaction();
+            await this.clearCacheForId([
+                userEntity
+            ]);
+        } catch (error) {
+            await queryRunner.rollbackTransaction();
+            ErrorHandler.logError(this.logger, error, 'updateProfileSection', {
+                entity: this.entityName,
+                sectionId
+            });
+            ErrorHandler.rethrowError(error);
+        } finally{
+            await queryRunner.release();
+        }
+    }
+    /**
+   * Get profile completion percentage
+   */ async getProfileCompletion(userId, user) {
+        this.validateProfileOwnership(userId, user);
+        await this.ensureRepositoryInitialized();
+        // Verify user exists
+        const userEntity = await this.repository.findOne({
+            where: {
+                id: userId
+            }
+        });
+        if (!userEntity) {
+            throw new NotFoundException('User not found');
+        }
+        if (this.userEnricher?.calculateProfileCompletion) {
+            return this.userEnricher.calculateProfileCompletion(userId, user);
+        }
+        return 100; // Default to 100% if no enricher
+    }
+    /** Update user profile with password handling and extras */ async profile(dto, user) {
+        // Ensure repository and dataSource are initialized
+        await this.ensureRepositoryInitialized();
+        if (!this.dataSource) {
+            throw new BadRequestException('DataSource not available');
+        }
+        const userId = dto.id ?? user.id;
+        // Validate extras if enricher provides validation
+        if (dto.extras && this.userEnricher?.validateProfileExtras) {
+            await this.userEnricher.validateProfileExtras(userId, dto.extras, user);
+        }
         const queryRunner = this.dataSource.createQueryRunner();
         await queryRunner.connect();
         await queryRunner.startTransaction();
         try {
-            const userId = dto.id ?? user.id;
             const findUser = await queryRunner.manager.findOne(this.repository.target, {
                 where: {
                     id: userId
@@ -358,18 +468,28 @@ export class UserService extends RequestScopedApiService {
             }
             // Handle password update
             if (dto.password) {
-                // If updating own profile, require old password
-                if (!dto.id || dto.id === user.id) {
-                // This would need oldPassword in DTO - for now, skip if not provided
-                // In real implementation, add oldPassword to UpdateUserDto
+                // If updating own profile, require old password verification
+                const isOwnProfile = !dto.id || dto.id === user.id;
+                if (isOwnProfile) {
+                    if (!dto.oldPassword) {
+                        throw new BadRequestException('Current password is required to change your password');
+                    }
+                    const isPasswordValid = await bcrypt.compare(dto.oldPassword, findUser.password);
+                    if (!isPasswordValid) {
+                        throw new BadRequestException('Current password is incorrect');
+                    }
                 }
-                const salt = await bcrypt.genSalt();
-                findUser.password = await bcrypt.hash(dto.password, salt);
+                findUser.password = await bcrypt.hash(dto.password, BCRYPT_SALT_ROUNDS);
             }
-            // Merge other fields (excluding password)
-            const { password, ...restDto } = dto;
+            // Merge other fields (excluding password, oldPassword, extras, and sensitive flags)
+            // Users cannot self-modify emailVerified, phoneVerified, or isActive via profile update
+            const { password, oldPassword, extras, emailVerified, phoneVerified, isActive, ...restDto } = dto;
             Object.assign(findUser, restDto);
             await queryRunner.manager.save(this.repository.target, findUser);
+            // Handle extras update via enricher
+            if (extras && this.userEnricher?.updateProfileExtras) {
+                await this.userEnricher.updateProfileExtras(userId, extras, queryRunner);
+            }
             await queryRunner.commitTransaction();
             await this.clearCacheForId([
                 findUser
@@ -385,10 +505,8 @@ export class UserService extends RequestScopedApiService {
             await queryRunner.release();
         }
     }
-    // NOTE: @Inject() required for bundled code - type metadata may be lost during esbuild
-    constructor(cacheManager, utilsService, dataSourceProvider, authConfig){
-        // Repository will be set asynchronously by RequestScopedApiService
-        super('user', null, cacheManager, utilsService, UserService.name, true), _define_property(this, "cacheManager", void 0), _define_property(this, "utilsService", void 0), _define_property(this, "dataSourceProvider", void 0), _define_property(this, "authConfig", void 0), _define_property(this, "logger", void 0), _define_property(this, "permissionRepository", void 0), _define_property(this, "dataSource", void 0), this.cacheManager = cacheManager, this.utilsService = utilsService, this.dataSourceProvider = dataSourceProvider, this.authConfig = authConfig, this.logger = new Logger(UserService.name);
+    constructor(cacheManager, utilsService, dataSourceProvider, authConfig, userEnricher){
+        super('user', null, cacheManager, utilsService, UserService.name, true), _define_property(this, "cacheManager", void 0), _define_property(this, "utilsService", void 0), _define_property(this, "dataSourceProvider", void 0), _define_property(this, "authConfig", void 0), _define_property(this, "userEnricher", void 0), _define_property(this, "permissionRepository", void 0), _define_property(this, "dataSource", void 0), this.cacheManager = cacheManager, this.utilsService = utilsService, this.dataSourceProvider = dataSourceProvider, this.authConfig = authConfig, this.userEnricher = userEnricher;
     }
 }
 UserService = _ts_decorate([
@@ -399,11 +517,14 @@ UserService = _ts_decorate([
     _ts_param(1, Inject(UtilsService)),
     _ts_param(2, Inject(AuthDataSourceProvider)),
     _ts_param(3, Inject(AuthConfigService)),
+    _ts_param(4, Optional()),
+    _ts_param(4, Inject(USER_ENRICHER)),
     _ts_metadata("design:type", Function),
     _ts_metadata("design:paramtypes", [
         typeof HybridCache === "undefined" ? Object : HybridCache,
         typeof UtilsService === "undefined" ? Object : UtilsService,
         typeof AuthDataSourceProvider === "undefined" ? Object : AuthDataSourceProvider,
-        typeof AuthConfigService === "undefined" ? Object : AuthConfigService
+        typeof AuthConfigService === "undefined" ? Object : AuthConfigService,
+        typeof IUserEnricher === "undefined" ? Object : IUserEnricher
     ])
 ], UserService);

package/fesm/strategies/jwt.strategy.js

@@ -26,6 +26,7 @@ import { PassportStrategy } from '@nestjs/passport';
 import { ExtractJwt, Strategy } from 'passport-jwt';
 import { AuthConfigService } from '../services/auth-config.service';
 import { AuthDataSourceProvider } from '../services/auth-datasource.provider';
+import { AuthenticationService } from '../services/authentication.service';
 import { User } from '../entities/user.entity';
 /**
  * Type guard to check if payload includes company context
@@ -34,8 +35,9 @@ import { User } from '../entities/user.entity';
 }
 export class JwtStrategy extends PassportStrategy(Strategy, 'jwt') {
     async validate(_req, payload) {
-        // Resolve request-scoped AuthDataSourceProvider for this request
+        // Resolve request-scoped services for this request
         let userRepository = null;
+        let authService = null;
         try {
             const dataSourceProvider = await this.moduleRef.resolve(AuthDataSourceProvider, undefined, {
                 strict: false
@@ -43,12 +45,23 @@ export class JwtStrategy extends PassportStrategy(Strategy, 'jwt') {
             if (dataSourceProvider) {
                 userRepository = await dataSourceProvider.getRepository(User);
             }
+            // Resolve AuthenticationService for token revocation check
+            authService = await this.moduleRef.resolve(AuthenticationService, undefined, {
+                strict: false
+            });
         } catch (error) {
             throw new UnauthorizedException('Unable to access user data');
         }
         if (!userRepository) {
             throw new UnauthorizedException('User repository not available');
         }
+        // Check if token is revoked (logged out)
+        if (authService && payload.iat) {
+            const isRevoked = await authService.isTokenRevoked(payload.id, payload.iat);
+            if (isRevoked) {
+                throw new UnauthorizedException('Token has been revoked');
+            }
+        }
         // Find user and check if active
         const user = await userRepository.findOne({
             where: {

package/fesm/validators/password.validator.js

@@ -0,0 +1,48 @@
+import { registerDecorator } from 'class-validator';
+/**
+ * Strong password validation decorator.
+ * Validates that passwords meet complexity requirements to prevent weak passwords.
+ *
+ * @example
+ * ```typescript
+ * @IsStrongPassword()
+ * password!: string;
+ *
+ * // With custom options
+ * @IsStrongPassword({ minLength: 12, requireSpecialChar: false })
+ * password!: string;
+ * ```
+ */ export function IsStrongPassword(options = {}, validationOptions) {
+    const { minLength = 8, maxLength = 128, requireUppercase = true, requireLowercase = true, requireNumber = true, requireSpecialChar = true } = options;
+    return function(object, propertyName) {
+        registerDecorator({
+            name: 'isStrongPassword',
+            target: object.constructor,
+            propertyName: propertyName,
+            options: validationOptions,
+            validator: {
+                validate (value) {
+                    if (typeof value !== 'string') return false;
+                    const checks = [
+                        value.length >= minLength,
+                        value.length <= maxLength,
+                        !requireUppercase || /[A-Z]/.test(value),
+                        !requireLowercase || /[a-z]/.test(value),
+                        !requireNumber || /[0-9]/.test(value),
+                        !requireSpecialChar || /[!@#$%^&*()_+\-=\[\]{};':"\\|,.<>\/?~`]/.test(value)
+                    ];
+                    return checks.every(Boolean);
+                },
+                defaultMessage (args) {
+                    const requirements = [];
+                    if (minLength > 0) requirements.push(`at least ${minLength} characters`);
+                    if (requireUppercase) requirements.push('one uppercase letter');
+                    if (requireLowercase) requirements.push('one lowercase letter');
+                    if (requireNumber) requirements.push('one number');
+                    if (requireSpecialChar) requirements.push('one special character (!@#$%^&*...)');
+                    return `Password must contain ${requirements.join(', ')}`;
+                }
+            }
+        });
+    };
+}

package/guards/auth-throttler.guard.d.ts

@@ -0,0 +1,7 @@
+import { ExecutionContext } from '@nestjs/common';
+import { ThrottlerGuard } from '@nestjs/throttler';
+export declare class AuthThrottlerGuard extends ThrottlerGuard {
+    protected getTracker(req: Record<string, unknown>): Promise<string>;
+    protected throwThrottlingException(): Promise<void>;
+    protected shouldSkip(context: ExecutionContext): Promise<boolean>;
+}

package/interceptors/set-token.interceptor.d.ts

@@ -5,6 +5,7 @@ export declare class SetToken implements NestInterceptor {
     private readonly authConfig?;
     constructor(authConfig?: AuthConfigService);
     private get cookieName();
+    private getMaxAgeMs;
     intercept(context: ExecutionContext, next: CallHandler): Observable<unknown>;
     private isBrowserRequest;
     private setRefreshTokenCookie;

package/interfaces/auth-email-provider.interface.d.ts

@@ -0,0 +1,6 @@
+export interface IAuthEmailProvider {
+    sendPasswordResetEmail(email: string, token: string, resetUrl: string): Promise<void>;
+    sendVerificationEmail(email: string, token: string, verifyUrl: string): Promise<void>;
+    sendWelcomeEmail?(email: string, name: string): Promise<void>;
+}
+export declare const AUTH_EMAIL_PROVIDER = "AUTH_EMAIL_PROVIDER";

package/interfaces/auth-module-options.interface.d.ts

@@ -1,15 +1,17 @@
 import { IBootstrapAppConfig, IDataSourceServiceOptions, IDynamicModuleConfig, IModuleOptionsFactory } from '@flusys/nestjs-core';
-import { ModuleMetadata, Type } from '@nestjs/common';
+import { ModuleMetadata, Provider, Type } from '@nestjs/common';
 export interface IAuthModuleConfig extends IDataSourceServiceOptions {
     jwtSecret?: string;
     jwtExpiration?: string;
     refreshTokenSecret?: string;
     refreshTokenExpiration?: string;
     refreshTokenCookieName?: string;
+    frontendUrl?: string;
 }
 export interface AuthModuleOptions extends IDynamicModuleConfig {
     bootstrapAppConfig?: IBootstrapAppConfig;
     config?: IAuthModuleConfig;
+    providers?: Provider[];
 }
 export interface AuthOptionsFactory extends IModuleOptionsFactory<IAuthModuleConfig> {
     createAuthOptions(): Promise<IAuthModuleConfig> | IAuthModuleConfig;
@@ -21,4 +23,5 @@ export interface AuthModuleAsyncOptions extends Pick<ModuleMetadata, 'imports'>,
     inject?: any[];
     useClass?: Type<AuthOptionsFactory>;
     useExisting?: Type<AuthOptionsFactory>;
+    providers?: Provider[];
 }

package/interfaces/authentication.interface.d.ts

@@ -51,3 +51,17 @@ export interface LoginResponseRequiresSelection {
     user: IUserMini;
     companies: CompanyWithBranches[];
 }
+export interface RegistrationResponse {
+    accessToken?: string;
+    refreshToken?: string;
+    user: IUserMini;
+    company?: ICompanyMini;
+    branch?: ICompanyBranchMini;
+    companyFeatureEnabled?: boolean;
+    requiresEmailVerification?: boolean;
+}
+export interface LoginResponseRequiresEmailVerification {
+    requiresEmailVerification: true;
+    email: string;
+    message: string;
+}

package/interfaces/index.d.ts

@@ -1,5 +1,7 @@
 export * from './authentication.interface';
+export * from './auth-email-provider.interface';
 export * from './company-branch.interface';
 export * from './company.interface';
 export * from './user.interface';
+export * from './user-enricher.interface';
 export * from './auth-module-options.interface';