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

package/fesm/controllers/company-selection.controller.js

@@ -26,42 +26,35 @@ function _ts_param(paramIndex, decorator) {
     };
 }
 import { CurrentUser } from '@flusys/nestjs-shared/decorators';
-import { Body, Controller, Get, HttpCode, HttpStatus, Inject, Param, Post, UseGuards, UseInterceptors } from '@nestjs/common';
+import { Body, Controller, HttpCode, HttpStatus, Inject, Post, UseGuards, UseInterceptors } from '@nestjs/common';
 import { ApiBearerAuth, ApiBody, ApiOperation, ApiResponse, ApiTags } from '@nestjs/swagger';
 import { LoginResponseDto, SelectDto, SwitchCompanyDto } from '../dtos/authentication.dto';
 import { JwtAuthGuard } from '@flusys/nestjs-shared/guards';
 import { SetToken } from '../interceptors/set-token.interceptor';
 import { AuthenticationService } from '../services/authentication.service';
 export class CompanySelectionController {
-    /**
-   * Select Company & Branch
-   * Used after login when user needs to select company and branch
-   */ async select(dto) {
+    async select(dto) {
         return this.authService.select(dto.sessionId, dto.companyId, dto.branchId);
     }
-    /**
-   * Switch Company/Branch
-   * Used to switch company/branch after already logged in
-   */ async switchCompany(userId, dto) {
+    async switchCompany(userId, dto) {
         return this.authService.switchCompany(userId, dto.companyId, dto.branchId);
     }
-    /**
-   * Get user's companies
-   */ async getUserCompanies(userId) {
+    async getUserCompanies(userId) {
         const companies = await this.authService.getUserCompanies(userId);
         return {
-            companies
+            success: true,
+            message: 'User companies retrieved successfully',
+            data: companies
         };
     }
-    /**
-   * Get branches for a specific company
-   */ async getUserBranches(userId, companyId) {
+    async getUserBranches(userId, companyId) {
         const branches = await this.authService.getUserBranches(userId, companyId);
         return {
-            branches
+            success: true,
+            message: 'Company branches retrieved successfully',
+            data: branches
         };
     }
-    // NOTE: @Inject() required for bundled code - type metadata may be lost during esbuild
     constructor(authService){
         _define_property(this, "authService", void 0);
         this.authService = authService;
@@ -117,7 +110,8 @@ _ts_decorate([
 ], CompanySelectionController.prototype, "switchCompany", null);
 _ts_decorate([
     UseGuards(JwtAuthGuard),
-    Get('companies'),
+    Post('get-companies'),
+    HttpCode(HttpStatus.OK),
     ApiBearerAuth(),
     ApiOperation({
         summary: "Get user's available companies",
@@ -132,14 +126,27 @@ _ts_decorate([
 ], CompanySelectionController.prototype, "getUserCompanies", null);
 _ts_decorate([
     UseGuards(JwtAuthGuard),
-    Get('companies/:companyId/branches'),
+    Post('get-company-branches'),
+    HttpCode(HttpStatus.OK),
     ApiBearerAuth(),
     ApiOperation({
         summary: 'Get branches for a company',
         description: 'Get list of branches for a specific company that the user has access to'
     }),
+    ApiBody({
+        schema: {
+            properties: {
+                companyId: {
+                    type: 'string'
+                }
+            },
+            required: [
+                'companyId'
+            ]
+        }
+    }),
     _ts_param(0, CurrentUser('id')),
-    _ts_param(1, Param('companyId')),
+    _ts_param(1, Body('companyId')),
     _ts_metadata("design:type", Function),
     _ts_metadata("design:paramtypes", [
         String,

package/fesm/controllers/company.controller.js

@@ -25,22 +25,64 @@ function _ts_param(paramIndex, decorator) {
         decorator(target, key, paramIndex);
     };
 }
-import { createApiController } from '@flusys/nestjs-shared/classes';
-import { Controller, Inject, UseGuards } from '@nestjs/common';
-import { ApiBearerAuth, ApiTags } from '@nestjs/swagger';
+import { createApiController, COMPANY_PERMISSIONS } from '@flusys/nestjs-shared/classes';
+import { Controller, Inject } from '@nestjs/common';
+import { ApiTags } from '@nestjs/swagger';
 import { CompanyResponseDto, CreateCompanyDto, UpdateCompanyDto } from '../dtos/company.dto';
-import { JwtAuthGuard } from '@flusys/nestjs-shared/guards';
 import { CompanyService } from '../services/company.service';
-export class CompanyController extends createApiController(CreateCompanyDto, UpdateCompanyDto, CompanyResponseDto) {
+export class CompanyController extends createApiController(CreateCompanyDto, UpdateCompanyDto, CompanyResponseDto, {
+    security: {
+        insert: {
+            level: 'permission',
+            permissions: [
+                COMPANY_PERMISSIONS.CREATE
+            ]
+        },
+        insertMany: {
+            level: 'permission',
+            permissions: [
+                COMPANY_PERMISSIONS.CREATE
+            ]
+        },
+        getById: {
+            level: 'permission',
+            permissions: [
+                COMPANY_PERMISSIONS.READ
+            ]
+        },
+        getAll: {
+            level: 'permission',
+            permissions: [
+                COMPANY_PERMISSIONS.READ
+            ]
+        },
+        update: {
+            level: 'permission',
+            permissions: [
+                COMPANY_PERMISSIONS.UPDATE
+            ]
+        },
+        updateMany: {
+            level: 'permission',
+            permissions: [
+                COMPANY_PERMISSIONS.UPDATE
+            ]
+        },
+        delete: {
+            level: 'permission',
+            permissions: [
+                COMPANY_PERMISSIONS.DELETE
+            ]
+        }
+    }
+}) {
     constructor(companyService){
         super(companyService), _define_property(this, "companyService", void 0), this.companyService = companyService;
     }
 }
 CompanyController = _ts_decorate([
     ApiTags('Companies'),
-    ApiBearerAuth(),
     Controller('administration/company'),
-    UseGuards(JwtAuthGuard),
     _ts_param(0, Inject(CompanyService)),
     _ts_metadata("design:type", Function),
     _ts_metadata("design:paramtypes", [

package/fesm/controllers/user-permission.controller.js

@@ -25,18 +25,13 @@ function _ts_param(paramIndex, decorator) {
         decorator(target, key, paramIndex);
     };
 }
-import { Body, Controller, Get, Inject, Post, Query, UseGuards } from '@nestjs/common';
-import { ApiBearerAuth, ApiBody, ApiOperation, ApiQuery, ApiResponse, ApiTags } from '@nestjs/swagger';
-import { JwtAuthGuard } from '@flusys/nestjs-shared/guards';
+import { Body, Controller, Inject, Post, UseGuards } from '@nestjs/common';
+import { ApiBearerAuth, ApiBody, ApiOperation, ApiResponse, ApiTags } from '@nestjs/swagger';
+import { JwtAuthGuard, RequirePermission, USER_PERMISSIONS } from '@flusys/nestjs-shared';
 import { AssignUserCompanyDto, AssignUserBranchDto, UserCompaniesResponseDto, UserBranchesResponseDto } from '../dtos/user-permission.dto';
 import { UserPermissionService } from '../services/user-permission.service';
 export class UserPermissionController {
-    // ========================================================================
-    // USER-COMPANY PERMISSIONS
-    // ========================================================================
-    /**
-   * Batch assign/revoke user-company permissions
-   */ async assignUserCompany(dto) {
+    async assignUserCompany(dto) {
         let addedCount = 0;
         let removedCount = 0;
         for (const item of dto.items){
@@ -56,11 +51,8 @@ export class UserPermissionController {
             message: `Processed ${addedCount} additions and ${removedCount} removals`
         };
     }
-    /**
-   * Get user's companies
-   */ async getUserCompanies(userId) {
+    async getUserCompanies(userId) {
         const permissions = await this.userPermissionService.findUserCompanies(userId);
-        // Map to DTO format with populated company details
         const data = permissions.map((permission)=>({
                 id: permission.id,
                 userId: permission.userId,
@@ -69,15 +61,12 @@ export class UserPermissionController {
                 companySlug: permission.company?.slug || ''
             }));
         return {
+            success: true,
+            message: 'User companies retrieved successfully',
             data
         };
     }
-    // ========================================================================
-    // USER-BRANCH PERMISSIONS
-    // ========================================================================
-    /**
-   * Batch assign/revoke user-branch permissions
-   */ async assignUserBranch(dto) {
+    async assignUserBranch(dto) {
         let addedCount = 0;
         let removedCount = 0;
         for (const item of dto.items){
@@ -97,11 +86,8 @@ export class UserPermissionController {
             message: `Processed ${addedCount} additions and ${removedCount} removals`
         };
     }
-    /**
-   * Get user's branches
-   */ async getUserBranches(userId) {
+    async getUserBranches(userId) {
         const permissions = await this.userPermissionService.findUserBranches(userId);
-        // Map to DTO format with populated branch details
         const data = permissions.map((permission)=>({
                 id: permission.id,
                 userId: permission.userId,
@@ -111,10 +97,11 @@ export class UserPermissionController {
                 companyId: permission.branch?.companyId || ''
             }));
         return {
+            success: true,
+            message: 'User branches retrieved successfully',
             data
         };
     }
-    // NOTE: @Inject() required for bundled code - type metadata may be lost during esbuild
     constructor(userPermissionService){
         _define_property(this, "userPermissionService", void 0);
         this.userPermissionService = userPermissionService;
@@ -122,6 +109,7 @@ export class UserPermissionController {
 }
 _ts_decorate([
     Post('user-company/assign'),
+    RequirePermission(USER_PERMISSIONS.UPDATE),
     ApiOperation({
         summary: 'Batch assign/revoke user-company permissions',
         description: `
@@ -176,22 +164,29 @@ Batch operation to assign or revoke user permissions to companies.
     _ts_metadata("design:returntype", Promise)
 ], UserPermissionController.prototype, "assignUserCompany", null);
 _ts_decorate([
-    Get('user-company'),
+    Post('get-user-company'),
+    RequirePermission(USER_PERMISSIONS.READ),
     ApiOperation({
         summary: 'Get user companies',
         description: 'Returns all companies the user has access to.'
     }),
-    ApiQuery({
-        name: 'userId',
-        required: true,
-        description: 'User ID to get companies for',
-        example: '550e8400-e29b-41d4-a716-446655440000'
+    ApiBody({
+        schema: {
+            properties: {
+                userId: {
+                    type: 'string'
+                }
+            },
+            required: [
+                'userId'
+            ]
+        }
     }),
     ApiResponse({
         status: 200,
         type: UserCompaniesResponseDto
     }),
-    _ts_param(0, Query('userId')),
+    _ts_param(0, Body('userId')),
     _ts_metadata("design:type", Function),
     _ts_metadata("design:paramtypes", [
         String
@@ -200,6 +195,7 @@ _ts_decorate([
 ], UserPermissionController.prototype, "getUserCompanies", null);
 _ts_decorate([
     Post('user-branch/assign'),
+    RequirePermission(USER_PERMISSIONS.UPDATE),
     ApiOperation({
         summary: 'Batch assign/revoke user-branch permissions',
         description: `
@@ -254,22 +250,29 @@ Batch operation to assign or revoke user permissions to branches.
     _ts_metadata("design:returntype", Promise)
 ], UserPermissionController.prototype, "assignUserBranch", null);
 _ts_decorate([
-    Get('user-branch'),
+    Post('get-user-branch'),
+    RequirePermission(USER_PERMISSIONS.READ),
     ApiOperation({
         summary: 'Get user branches',
         description: 'Returns all branches the user has access to.'
     }),
-    ApiQuery({
-        name: 'userId',
-        required: true,
-        description: 'User ID to get branches for',
-        example: '550e8400-e29b-41d4-a716-446655440000'
+    ApiBody({
+        schema: {
+            properties: {
+                userId: {
+                    type: 'string'
+                }
+            },
+            required: [
+                'userId'
+            ]
+        }
     }),
     ApiResponse({
         status: 200,
         type: UserBranchesResponseDto
     }),
-    _ts_param(0, Query('userId')),
+    _ts_param(0, Body('userId')),
     _ts_metadata("design:type", Function),
     _ts_metadata("design:paramtypes", [
         String

package/fesm/controllers/user.controller.js

@@ -25,60 +25,160 @@ function _ts_param(paramIndex, decorator) {
         decorator(target, key, paramIndex);
     };
 }
-import { createApiController } from '@flusys/nestjs-shared/classes';
-import { CurrentUser } from '@flusys/nestjs-shared/decorators';
+import { createApiController, USER_PERMISSIONS } from '@flusys/nestjs-shared/classes';
+import { CurrentUser, RequirePermission } from '@flusys/nestjs-shared/decorators';
+import { JwtAuthGuard } from '@flusys/nestjs-shared/guards';
 import { ILoggedUserInfo } from '@flusys/nestjs-shared/interfaces';
-import { Body, Controller, Inject, Param, Post, Put, UseGuards } from '@nestjs/common';
+import { Body, Controller, Inject, Param, Post, UseGuards } from '@nestjs/common';
 import { ApiBearerAuth, ApiBody, ApiOperation, ApiParam, ApiTags } from '@nestjs/swagger';
 import { CreateUserDto, UpdateUserDto, UserResponseDto } from '../dtos/user.dto';
-import { JwtAuthGuard } from '@flusys/nestjs-shared/guards';
 import { UserService } from '../services/user.service';
-export class UserController extends createApiController(CreateUserDto, UpdateUserDto, UserResponseDto) {
-    // ==========================================================================
-    // CUSTOM ENDPOINTS (Beyond standard CRUD)
-    // ==========================================================================
-    /**
-   * Verify user email
-   */ async verifyEmail(id) {
+export class UserController extends createApiController(CreateUserDto, UpdateUserDto, UserResponseDto, {
+    security: {
+        insert: {
+            level: 'permission',
+            permissions: [
+                USER_PERMISSIONS.CREATE
+            ]
+        },
+        insertMany: {
+            level: 'permission',
+            permissions: [
+                USER_PERMISSIONS.CREATE
+            ]
+        },
+        getById: {
+            level: 'permission',
+            permissions: [
+                USER_PERMISSIONS.READ
+            ]
+        },
+        getAll: {
+            level: 'permission',
+            permissions: [
+                USER_PERMISSIONS.READ
+            ]
+        },
+        update: {
+            level: 'permission',
+            permissions: [
+                USER_PERMISSIONS.UPDATE
+            ]
+        },
+        updateMany: {
+            level: 'permission',
+            permissions: [
+                USER_PERMISSIONS.UPDATE
+            ]
+        },
+        delete: {
+            level: 'permission',
+            permissions: [
+                USER_PERMISSIONS.DELETE
+            ]
+        }
+    }
+}) {
+    async getProfileWithExtras(id, user) {
+        const data = await this.service.getProfileWithExtras(id, user);
+        return {
+            success: true,
+            data
+        };
+    }
+    async verifyEmail(id) {
         await this.service.verifyEmail(id);
         return {
+            success: true,
             message: 'Email verified successfully'
         };
     }
-    /**
-   * Verify user phone
-   */ async verifyPhone(id) {
+    async verifyPhone(id) {
         await this.service.verifyPhone(id);
         return {
+            success: true,
             message: 'Phone verified successfully'
         };
     }
-    /**
-   * Update user active status
-   *
-   * When company feature is disabled: Updates User.isActive directly
-   * When company feature is enabled: Updates UserCompanyPermission.isActive for logged user's company
-   */ async updateStatus(id, isActive, user) {
+    async updateStatus(id, isActive, user) {
         await this.service.updateStatus(id, isActive, user);
         return {
+            success: true,
             message: 'Status updated successfully'
         };
     }
-    /**
-   * Update user profile
-   */ async profile(dto, user) {
+    async profile(dto, user) {
         const data = await this.service.profile(dto, user);
         return {
+            success: true,
             message: 'Profile updated successfully',
             data
         };
     }
+    async getProfileSections() {
+        const sections = await this.service.getProfileSections();
+        return {
+            success: true,
+            message: 'Profile sections retrieved successfully',
+            data: sections
+        };
+    }
+    async getProfileSectionData(id, sectionId, user) {
+        const data = await this.service.getProfileSectionData(id, sectionId, user);
+        return {
+            success: true,
+            message: 'Profile section data retrieved successfully',
+            data
+        };
+    }
+    async updateProfileSection(id, sectionId, data, user) {
+        await this.service.updateProfileSection(id, sectionId, data, user);
+        return {
+            success: true,
+            message: 'Section updated successfully'
+        };
+    }
+    async getProfileCompletion(id, user) {
+        const percentage = await this.service.getProfileCompletion(id, user);
+        return {
+            success: true,
+            message: 'Profile completion retrieved successfully',
+            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(),
+    RequirePermission(USER_PERMISSIONS.READ),
+    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),
+    ApiBearerAuth(),
+    RequirePermission(USER_PERMISSIONS.UPDATE),
     ApiOperation({
         summary: 'Verify user email'
     }),
@@ -95,6 +195,9 @@ _ts_decorate([
 ], UserController.prototype, "verifyEmail", null);
 _ts_decorate([
     Post(':id/verify-phone'),
+    UseGuards(JwtAuthGuard),
+    ApiBearerAuth(),
+    RequirePermission(USER_PERMISSIONS.UPDATE),
     ApiOperation({
         summary: 'Verify user phone'
     }),
@@ -110,7 +213,10 @@ _ts_decorate([
     _ts_metadata("design:returntype", Promise)
 ], UserController.prototype, "verifyPhone", null);
 _ts_decorate([
-    Put(':id/status'),
+    Post(':id/status'),
+    UseGuards(JwtAuthGuard),
+    ApiBearerAuth(),
+    RequirePermission(USER_PERMISSIONS.UPDATE),
     ApiOperation({
         summary: 'Update user active status',
         description: 'Updates user active status. When company feature is enabled, updates the status for the current company context.'
@@ -139,6 +245,8 @@ _ts_decorate([
 ], UserController.prototype, "updateStatus", null);
 _ts_decorate([
     Post('profile'),
+    UseGuards(JwtAuthGuard),
+    ApiBearerAuth(),
     ApiOperation({
         summary: 'Update user profile'
     }),
@@ -154,11 +262,102 @@ _ts_decorate([
     ]),
     _ts_metadata("design:returntype", Promise)
 ], UserController.prototype, "profile", null);
+_ts_decorate([
+    Post('profile-sections'),
+    UseGuards(JwtAuthGuard),
+    ApiBearerAuth(),
+    RequirePermission(USER_PERMISSIONS.READ),
+    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(),
+    RequirePermission(USER_PERMISSIONS.READ),
+    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(),
+    RequirePermission(USER_PERMISSIONS.UPDATE),
+    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(),
+    RequirePermission(USER_PERMISSIONS.READ),
+    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'),
-    ApiBearerAuth(),
     Controller('administration/users'),
-    UseGuards(JwtAuthGuard),
     _ts_param(0, Inject(UserService)),
     _ts_metadata("design:type", Function),
     _ts_metadata("design:paramtypes", [