@flusys/nestjs-auth 1.0.0-beta → 1.1.0-beta

package/controllers/user.controller.d.ts

@@ -1,5 +1,6 @@
 import { ILoggedUserInfo } from '@flusys/nestjs-shared/interfaces';
 import { CreateUserDto, UpdateUserDto, UserResponseDto } from '../dtos/user.dto';
+import { IUser } from '../interfaces/user.interface';
 import { UserService } from '../services/user.service';
 declare const UserController_base: abstract new (service: UserService) => {
     service: UserService;
@@ -14,6 +15,13 @@ declare const UserController_base: abstract new (service: UserService) => {
 export declare class UserController extends UserController_base {
     service: UserService;
     constructor(service: UserService);
+    getProfileWithExtras(id: string, user: ILoggedUserInfo): Promise<{
+        success: boolean;
+        data: {
+            user: IUser;
+            extras?: import("..").IProfileExtras;
+        };
+    }>;
     verifyEmail(id: string): Promise<{
         message: string;
     }>;
@@ -24,8 +32,27 @@ export declare class UserController extends UserController_base {
         message: string;
     }>;
     profile(dto: UpdateUserDto, user: ILoggedUserInfo): Promise<{
+        success: boolean;
         message: string;
         data: string;
     }>;
+    getProfileSections(): Promise<{
+        success: boolean;
+        data: import("..").IProfileSection[];
+    }>;
+    getProfileSectionData(id: string, sectionId: string, user: ILoggedUserInfo): Promise<{
+        success: boolean;
+        data: import("..").IProfileSectionData;
+    }>;
+    updateProfileSection(id: string, sectionId: string, data: Record<string, any>, user: ILoggedUserInfo): Promise<{
+        success: boolean;
+        message: string;
+    }>;
+    getProfileCompletion(id: string, user: ILoggedUserInfo): Promise<{
+        success: boolean;
+        data: {
+            completionPercentage: number;
+        };
+    }>;
 }
 export {};

package/dtos/authentication.dto.d.ts

@@ -71,12 +71,13 @@ export declare class LoginResponseDto {
     companyFeatureEnabled?: boolean;
 }
 export declare class RegistrationResponseDto {
-    accessToken: string;
-    refreshToken: string;
+    accessToken?: string;
+    refreshToken?: string;
     user: UserInfoDto;
     company?: CompanyInfoDto;
     branch?: BranchInfoDto;
-    companyFeatureEnabled: boolean;
+    companyFeatureEnabled?: boolean;
+    requiresEmailVerification?: boolean;
 }
 export declare class MeResponseDto {
     user: UserInfoDto;
@@ -90,3 +91,20 @@ export declare class CompanySelectionResponseDto {
     user: UserInfoDto;
     companies: CompanyWithBranchesDto[];
 }
+export declare class LoginResponseRequiresEmailVerificationDto {
+    requiresEmailVerification: true;
+    email: string;
+    message: string;
+}
+export declare class ForgotPasswordDto {
+    email: string;
+}
+export declare class ResetPasswordDto {
+    token: string;
+    newPassword: string;
+}
+export declare class VerifyEmailDto {
+    token: string;
+}
+export declare class ResendVerificationDto extends ForgotPasswordDto {
+}

package/dtos/user.dto.d.ts

@@ -11,6 +11,7 @@ export declare class CreateUserDto {
     additionalFields?: Record<string, any>;
 }
 export declare class UpdateUserDto {
+    [key: string]: unknown;
     id: string;
     name?: string;
     phone?: string;

package/entities/index.d.ts

@@ -1,12 +1,16 @@
 export * from './company-branch.entity';
 export * from './company.entity';
+export * from './pending-registration.entity';
 export { PermissionType, UserCompanyPermission } from './user-company-permission.entity';
 export * from './user.entity';
+export * from './user-token.entity';
 import { CompanyBranch } from './company-branch.entity';
 import { Company } from './company.entity';
+import { PendingRegistration } from './pending-registration.entity';
 import { UserCompanyPermission } from './user-company-permission.entity';
 import { User } from './user.entity';
-export declare const CoreEntities: (typeof User)[];
+import { UserToken } from './user-token.entity';
+export declare const CoreEntities: (typeof PendingRegistration | typeof User | typeof UserToken)[];
 export declare const CompanyEntities: (typeof Company | typeof CompanyBranch | typeof UserCompanyPermission)[];
-export declare const AllEntities: (typeof Company | typeof CompanyBranch | typeof User | typeof UserCompanyPermission)[];
-export declare function getEntitiesByConfig(enableCompanyFeature: boolean): (typeof Company | typeof CompanyBranch | typeof User | typeof UserCompanyPermission)[];
+export declare const AllEntities: (typeof Company | typeof CompanyBranch | typeof PendingRegistration | typeof User | typeof UserCompanyPermission | typeof UserToken)[];
+export declare function getEntitiesByConfig(enableCompanyFeature: boolean): (typeof Company | typeof CompanyBranch | typeof PendingRegistration | typeof User | typeof UserCompanyPermission | typeof UserToken)[];

package/entities/pending-registration.entity.d.ts

@@ -0,0 +1,17 @@
+export declare class PendingRegistration {
+    id: string;
+    email: string;
+    name: string | null;
+    phone: string | null;
+    passwordHash: string;
+    token: string;
+    expiresAt: Date;
+    companyData: {
+        companySlug?: string;
+        branchSlug?: string;
+        newCompanyName?: string;
+        newCompanyPhone?: string;
+        newCompanyAddress?: string;
+    } | null;
+    createdAt: Date;
+}

package/entities/user-token.entity.d.ts

@@ -0,0 +1,15 @@
+export declare enum TokenType {
+    PASSWORD_RESET = "password_reset",
+    EMAIL_VERIFICATION = "email_verification",
+    EMAIL_CHANGE = "email_change"
+}
+export declare class UserToken {
+    id: string;
+    userId: string;
+    type: TokenType;
+    token: string;
+    expiresAt: Date;
+    usedAt: Date | null;
+    metadata: string | null;
+    createdAt: Date;
+}

package/fesm/config/auth.constants.js

@@ -1,5 +1,16 @@
 // Injection Tokens
 export const AUTH_MODULE_OPTIONS = 'AUTH_MODULE_OPTIONS';
+/**
+ * User Enricher Provider Token
+ *
+ * Optional provider for extending user list and profile.
+ * Consuming apps can provide their own implementation.
+ *
+ * @example
+ * providers: [
+ *   { provide: USER_ENRICHER, useClass: MyUserEnricher },
+ * ]
+ */ export const USER_ENRICHER = 'USER_ENRICHER';
 // Security Configuration
 /** Bcrypt salt rounds (12 = ~250ms hashing time) */ export const BCRYPT_SALT_ROUNDS = 12;
 // Cache Key Prefixes

package/fesm/controllers/authentication.controller.js

@@ -31,12 +31,18 @@ import { ILoggedUserInfo } from '@flusys/nestjs-shared/interfaces';
 import { Body, Controller, Get, HttpCode, HttpStatus, Inject, Optional, Post, Req, UnauthorizedException, UseGuards, UseInterceptors } from '@nestjs/common';
 import { ApiBearerAuth, ApiBody, ApiOperation, ApiResponse, ApiTags } from '@nestjs/swagger';
 import { Request } from 'express';
-import { ChangePasswordDto, CompanySelectionResponseDto, LoginDto, LoginResponseDto, MeResponseDto, RefreshTokenDto, RegistrationDto, RegistrationResponseDto } from '../dtos/authentication.dto';
+import { ChangePasswordDto, CompanySelectionResponseDto, ForgotPasswordDto, LoginDto, LoginResponseDto, MeResponseDto, RefreshTokenDto, RegistrationDto, RegistrationResponseDto, ResendVerificationDto, ResetPasswordDto, VerifyEmailDto } from '../dtos/authentication.dto';
+import { MessageResponseDto } from '@flusys/nestjs-shared/dtos';
 import { ClearToken } from '../interceptors/clear-token.interceptor';
 import { SetToken } from '../interceptors/set-token.interceptor';
 import { AuthConfigService } from '../services/auth-config.service';
+import { AuthEmailService } from '../services/auth-email.service';
 import { AuthenticationService } from '../services/authentication.service';
 export class AuthenticationController {
+    /** Build auth URL for email links */ buildAuthUrl(req, path) {
+        const frontendUrl = this.authConfig?.getFrontendUrl();
+        return frontendUrl ? `${frontendUrl}${path}` : `${req.protocol}://${req.get('host')}${path}`;
+    }
     // Core Endpoints
     /** Login - Returns tokens or company/branch selection requirement */ async login(loginDto) {
         const result = await this.authService.login(loginDto.email, loginDto.password);
@@ -45,8 +51,9 @@ export class AuthenticationController {
         }
         return result;
     }
-    /** Register new user. If company feature enabled, can join/create company. */ async register(registrationDto) {
-        const result = await this.authService.register(registrationDto);
+    /** Register new user. If company feature enabled, can join/create company. */ async register(req, registrationDto) {
+        const verifyUrlBase = this.buildAuthUrl(req, '/auth/verify-email');
+        const result = await this.authService.register(registrationDto, verifyUrlBase);
         return {
             ...result,
             companyFeatureEnabled: this.authConfig?.isCompanyFeatureEnabled() ?? false
@@ -67,21 +74,74 @@ export class AuthenticationController {
     /** Logout - Clears refresh token cookie for browsers */ async logout(userId) {
         await this.authService.logout(userId);
         return {
+            success: true,
             message: 'Logged out successfully'
         };
     }
     /** Change password */ async changePassword(userId, dto) {
         await this.authService.changePassword(userId, dto.currentPassword, dto.newPassword);
         return {
+            success: true,
             message: 'Password changed successfully'
         };
     }
+    // Email Auth Endpoints
+    /** Forgot password - Request password reset email */ async forgotPassword(req, dto) {
+        if (!this.authEmailService) {
+            return {
+                success: false,
+                message: 'Email service is not configured'
+            };
+        }
+        return this.authEmailService.forgotPassword(dto.email, this.buildAuthUrl(req, '/auth/reset-password'));
+    }
+    /** Reset password - Reset password using token */ async resetPassword(dto) {
+        if (!this.authEmailService) {
+            return {
+                success: false,
+                message: 'Email service is not configured'
+            };
+        }
+        return this.authEmailService.resetPassword(dto.token, dto.newPassword);
+    }
+    /** Resend verification email - For unauthenticated users (handles both pending registration and existing users) */ async resendVerification(req, dto) {
+        if (!this.authEmailService) {
+            return {
+                success: false,
+                message: 'Email service is not configured'
+            };
+        }
+        return this.authEmailService.resendVerificationEmail(dto.email, this.buildAuthUrl(req, '/auth/verify-email'));
+    }
+    /** Verify email - Verify email using token. Handles both pending registration and existing user verification. */ async verifyEmail(dto) {
+        if (!this.authEmailService) {
+            return {
+                success: false,
+                message: 'Email service is not configured'
+            };
+        }
+        const result = await this.authEmailService.verifyEmail(dto.token);
+        if (result.type === 'pending') {
+            // Create user from pending registration
+            const registrationResult = await this.authService.createUserFromPendingRegistration(result.pending);
+            return {
+                ...registrationResult,
+                companyFeatureEnabled: this.authConfig?.isCompanyFeatureEnabled() ?? false
+            };
+        }
+        return {
+            success: true,
+            message: result.message
+        };
+    }
     // NOTE: @Inject() required for bundled code - type metadata may be lost during esbuild
-    constructor(authService, authConfig){
+    constructor(authService, authConfig, authEmailService){
         _define_property(this, "authService", void 0);
         _define_property(this, "authConfig", void 0);
+        _define_property(this, "authEmailService", void 0);
         this.authService = authService;
         this.authConfig = authConfig;
+        this.authEmailService = authEmailService;
     }
 }
 _ts_decorate([
@@ -123,9 +183,11 @@ _ts_decorate([
         status: 201,
         type: RegistrationResponseDto
     }),
-    _ts_param(0, Body()),
+    _ts_param(0, Req()),
+    _ts_param(1, Body()),
     _ts_metadata("design:type", Function),
     _ts_metadata("design:paramtypes", [
+        typeof Request === "undefined" ? Object : Request,
         typeof RegistrationDto === "undefined" ? Object : RegistrationDto
     ]),
     _ts_metadata("design:returntype", Promise)
@@ -175,6 +237,10 @@ _ts_decorate([
     ApiOperation({
         summary: 'Logout user'
     }),
+    ApiResponse({
+        status: 200,
+        type: MessageResponseDto
+    }),
     _ts_param(0, CurrentUser('id')),
     _ts_metadata("design:type", Function),
     _ts_metadata("design:paramtypes", [
@@ -193,6 +259,10 @@ _ts_decorate([
     ApiBody({
         type: ChangePasswordDto
     }),
+    ApiResponse({
+        status: 200,
+        type: MessageResponseDto
+    }),
     _ts_param(0, CurrentUser('id')),
     _ts_param(1, Body()),
     _ts_metadata("design:type", Function),
@@ -202,15 +272,107 @@ _ts_decorate([
     ]),
     _ts_metadata("design:returntype", Promise)
 ], AuthenticationController.prototype, "changePassword", null);
+_ts_decorate([
+    Post('forgot-password'),
+    HttpCode(HttpStatus.OK),
+    ApiOperation({
+        summary: 'Request password reset email'
+    }),
+    ApiBody({
+        type: ForgotPasswordDto
+    }),
+    ApiResponse({
+        status: 200,
+        type: MessageResponseDto
+    }),
+    _ts_param(0, Req()),
+    _ts_param(1, Body()),
+    _ts_metadata("design:type", Function),
+    _ts_metadata("design:paramtypes", [
+        typeof Request === "undefined" ? Object : Request,
+        typeof ForgotPasswordDto === "undefined" ? Object : ForgotPasswordDto
+    ]),
+    _ts_metadata("design:returntype", Promise)
+], AuthenticationController.prototype, "forgotPassword", null);
+_ts_decorate([
+    Post('reset-password'),
+    HttpCode(HttpStatus.OK),
+    ApiOperation({
+        summary: 'Reset password using token'
+    }),
+    ApiBody({
+        type: ResetPasswordDto
+    }),
+    ApiResponse({
+        status: 200,
+        type: MessageResponseDto
+    }),
+    _ts_param(0, Body()),
+    _ts_metadata("design:type", Function),
+    _ts_metadata("design:paramtypes", [
+        typeof ResetPasswordDto === "undefined" ? Object : ResetPasswordDto
+    ]),
+    _ts_metadata("design:returntype", Promise)
+], AuthenticationController.prototype, "resetPassword", null);
+_ts_decorate([
+    Post('resend-verification'),
+    HttpCode(HttpStatus.OK),
+    ApiOperation({
+        summary: 'Resend email verification link'
+    }),
+    ApiBody({
+        type: ResendVerificationDto
+    }),
+    ApiResponse({
+        status: 200,
+        type: MessageResponseDto
+    }),
+    _ts_param(0, Req()),
+    _ts_param(1, Body()),
+    _ts_metadata("design:type", Function),
+    _ts_metadata("design:paramtypes", [
+        typeof Request === "undefined" ? Object : Request,
+        typeof ResendVerificationDto === "undefined" ? Object : ResendVerificationDto
+    ]),
+    _ts_metadata("design:returntype", Promise)
+], AuthenticationController.prototype, "resendVerification", null);
+_ts_decorate([
+    Post('verify-email'),
+    HttpCode(HttpStatus.OK),
+    UseInterceptors(SetToken),
+    ApiOperation({
+        summary: 'Verify email using token'
+    }),
+    ApiBody({
+        type: VerifyEmailDto
+    }),
+    ApiResponse({
+        status: 200,
+        type: MessageResponseDto
+    }),
+    ApiResponse({
+        status: 200,
+        type: RegistrationResponseDto
+    }),
+    _ts_param(0, Body()),
+    _ts_metadata("design:type", Function),
+    _ts_metadata("design:paramtypes", [
+        typeof VerifyEmailDto === "undefined" ? Object : VerifyEmailDto
+    ]),
+    _ts_metadata("design:returntype", Promise)
+], AuthenticationController.prototype, "verifyEmail", null);
 AuthenticationController = _ts_decorate([
     ApiTags('Authentication'),
     Controller('auth'),
     _ts_param(0, Inject(AuthenticationService)),
     _ts_param(1, Optional()),
     _ts_param(1, Inject(AuthConfigService)),
+    _ts_param(2, Optional()),
+    _ts_param(2, Inject(AuthEmailService)),
     _ts_metadata("design:type", Function),
     _ts_metadata("design:paramtypes", [
         typeof AuthenticationService === "undefined" ? Object : AuthenticationService,
-        typeof AuthConfigService === "undefined" ? Object : AuthConfigService
+        typeof AuthConfigService === "undefined" ? Object : AuthConfigService,
+        typeof AuthEmailService === "undefined" ? Object : AuthEmailService
     ])
 ], AuthenticationController);

package/fesm/controllers/user.controller.js

@@ -37,6 +37,13 @@ export class UserController extends createApiController(CreateUserDto, UpdateUse
     security: 'jwt'
 }) {
     // Custom Endpoints
+    /** Get user profile with extras (roles, permissions, etc.) from enricher */ async getProfileWithExtras(id, user) {
+        const data = await this.service.getProfileWithExtras(id, user);
+        return {
+            success: true,
+            data
+        };
+    }
     /** Verify user email */ async verifyEmail(id) {
         await this.service.verifyEmail(id);
         return {
@@ -58,14 +65,69 @@ export class UserController extends createApiController(CreateUserDto, UpdateUse
     /** Update user profile */ async profile(dto, user) {
         const data = await this.service.profile(dto, user);
         return {
+            success: true,
             message: 'Profile updated successfully',
             data
         };
     }
+    // ============================================
+    // Multi-Step Profile Endpoints (via Enricher)
+    // ============================================
+    /** Get profile section definitions */ async getProfileSections() {
+        const sections = await this.service.getProfileSections();
+        return {
+            success: true,
+            data: sections
+        };
+    }
+    /** Get specific profile section data */ async getProfileSectionData(id, sectionId, user) {
+        const data = await this.service.getProfileSectionData(id, sectionId, user);
+        return {
+            success: true,
+            data
+        };
+    }
+    /** Update specific profile section */ async updateProfileSection(id, sectionId, data, user) {
+        await this.service.updateProfileSection(id, sectionId, data, user);
+        return {
+            success: true,
+            message: 'Section updated successfully'
+        };
+    }
+    /** Get profile completion percentage */ async getProfileCompletion(id, user) {
+        const percentage = await this.service.getProfileCompletion(id, user);
+        return {
+            success: true,
+            data: {
+                completionPercentage: percentage
+            }
+        };
+    }
     constructor(service){
         super(service), _define_property(this, "service", void 0), this.service = service;
     }
 }
+_ts_decorate([
+    Post(':id/profile-extras'),
+    UseGuards(JwtAuthGuard),
+    ApiBearerAuth(),
+    ApiOperation({
+        summary: 'Get user profile with extras',
+        description: 'Returns user profile along with extra data (roles, permissions, etc.) if UserEnricher is provided.'
+    }),
+    ApiParam({
+        name: 'id',
+        description: 'User ID'
+    }),
+    _ts_param(0, Param('id')),
+    _ts_param(1, CurrentUser()),
+    _ts_metadata("design:type", Function),
+    _ts_metadata("design:paramtypes", [
+        String,
+        typeof ILoggedUserInfo === "undefined" ? Object : ILoggedUserInfo
+    ]),
+    _ts_metadata("design:returntype", Promise)
+], UserController.prototype, "getProfileWithExtras", null);
 _ts_decorate([
     Post(':id/verify-email'),
     UseGuards(JwtAuthGuard),
@@ -151,6 +213,95 @@ _ts_decorate([
     ]),
     _ts_metadata("design:returntype", Promise)
 ], UserController.prototype, "profile", null);
+_ts_decorate([
+    Post('profile-sections'),
+    UseGuards(JwtAuthGuard),
+    ApiBearerAuth(),
+    ApiOperation({
+        summary: 'Get profile section definitions',
+        description: 'Returns available profile sections for multi-step profile (if enricher configured).'
+    }),
+    _ts_metadata("design:type", Function),
+    _ts_metadata("design:paramtypes", []),
+    _ts_metadata("design:returntype", Promise)
+], UserController.prototype, "getProfileSections", null);
+_ts_decorate([
+    Post(':id/profile-section/:sectionId'),
+    UseGuards(JwtAuthGuard),
+    ApiBearerAuth(),
+    ApiOperation({
+        summary: 'Get profile section data',
+        description: 'Returns data for a specific profile section.'
+    }),
+    ApiParam({
+        name: 'id',
+        description: 'User ID'
+    }),
+    ApiParam({
+        name: 'sectionId',
+        description: 'Section identifier'
+    }),
+    _ts_param(0, Param('id')),
+    _ts_param(1, Param('sectionId')),
+    _ts_param(2, CurrentUser()),
+    _ts_metadata("design:type", Function),
+    _ts_metadata("design:paramtypes", [
+        String,
+        String,
+        typeof ILoggedUserInfo === "undefined" ? Object : ILoggedUserInfo
+    ]),
+    _ts_metadata("design:returntype", Promise)
+], UserController.prototype, "getProfileSectionData", null);
+_ts_decorate([
+    Post(':id/profile-section/:sectionId/update'),
+    UseGuards(JwtAuthGuard),
+    ApiBearerAuth(),
+    ApiOperation({
+        summary: 'Update profile section',
+        description: 'Updates a specific profile section data.'
+    }),
+    ApiParam({
+        name: 'id',
+        description: 'User ID'
+    }),
+    ApiParam({
+        name: 'sectionId',
+        description: 'Section identifier'
+    }),
+    _ts_param(0, Param('id')),
+    _ts_param(1, Param('sectionId')),
+    _ts_param(2, Body()),
+    _ts_param(3, CurrentUser()),
+    _ts_metadata("design:type", Function),
+    _ts_metadata("design:paramtypes", [
+        String,
+        String,
+        typeof Record === "undefined" ? Object : Record,
+        typeof ILoggedUserInfo === "undefined" ? Object : ILoggedUserInfo
+    ]),
+    _ts_metadata("design:returntype", Promise)
+], UserController.prototype, "updateProfileSection", null);
+_ts_decorate([
+    Post(':id/profile-completion'),
+    UseGuards(JwtAuthGuard),
+    ApiBearerAuth(),
+    ApiOperation({
+        summary: 'Get profile completion percentage',
+        description: 'Returns overall profile completion percentage.'
+    }),
+    ApiParam({
+        name: 'id',
+        description: 'User ID'
+    }),
+    _ts_param(0, Param('id')),
+    _ts_param(1, CurrentUser()),
+    _ts_metadata("design:type", Function),
+    _ts_metadata("design:paramtypes", [
+        String,
+        typeof ILoggedUserInfo === "undefined" ? Object : ILoggedUserInfo
+    ]),
+    _ts_metadata("design:returntype", Promise)
+], UserController.prototype, "getProfileCompletion", null);
 UserController = _ts_decorate([
     ApiTags('Users'),
     Controller('administration/users'),