feat: enhance KYC document upload and status management

- Added KYC document status handling in user summary mapping.
- Updated file upload state to include user data loading status.
- Improved UI interactions based on KYC document upload status, allowing re-upload for rejected files.
- Localized messages for KYC upload statuses, including a new message for rejected uploads.

Author: mocodesmo

lib/core/exchange/data/mappers/user_summary_mapper.dart

@@ -15,6 +15,9 @@ class UserSummaryMapper {
       dca: model.dca.toEntity(),
       autoBuy: _mapUserAutoBuy(model.autoBuy),
       emailNotificationsEnabled: model.emailNotificationsEnabled,
+      kycDocumentStatus: model.kycDocumentStatus != null
+          ? _mapKycDocumentStatus(model.kycDocumentStatus!)
+          : null,
     );
   }
 
@@ -42,4 +45,36 @@ class UserSummaryMapper {
       liquid: model.liquid,
     );
   }
+
+  static UserKycDocumentStatus _mapKycDocumentStatus(
+    UserKycDocumentStatusModel model,
+  ) {
+    return UserKycDocumentStatus(
+      secureFileUpload: _parseKycDocumentStatus(model.secureFileUpload),
+      documents: _mapKycDocuments(model.documents),
+    );
+  }
+
+  static UserKycDocuments _mapKycDocuments(UserKycDocumentsModel model) {
+    return UserKycDocuments(
+      id: _parseKycDocumentStatus(model.id),
+      proofOfResidence: _parseKycDocumentStatus(model.proofOfResidence),
+      selfie: _parseKycDocumentStatus(model.selfie),
+    );
+  }
+
+  /// Parse KYC document status string to enum
+  static KycDocumentStatus _parseKycDocumentStatus(String status) {
+    switch (status.toUpperCase()) {
+      case 'ACCEPTED':
+        return KycDocumentStatus.accepted;
+      case 'UNDER_REVIEW':
+        return KycDocumentStatus.underReview;
+      case 'REJECTED':
+        return KycDocumentStatus.rejected;
+      case 'NOT_UPLOADED':
+      default:
+        return KycDocumentStatus.notUploaded;
+    }
+  }
 }

lib/features/exchange_settings/presentation/file_upload_cubit.dart

@@ -26,29 +26,21 @@ class FileUploadCubit extends Cubit<FileUploadState> {
     try {
       final userSummary = await _getExchangeUserSummaryUsecase.execute();
 
-      // Determine server submitted count based on status
-      // If secureFileUpload is underReview, assume max files are submitted
-      // This is a simplification - ideally we'd query the actual KYC list
-      final status = userSummary.kycDocumentStatus?.secureFileUpload;
-      final serverCount =
-          status?.isUnderReview == true || status?.isAccepted == true
-              ? FileToUpload.maxFileCount
-              : 0;
-
       emit(
         state.copyWith(
           isLoadingUser: false,
+          isUserDataLoaded: true,
           userId: userSummary.userId,
           secureFileUploadStatus:
               userSummary.kycDocumentStatus?.secureFileUpload,
-          serverSubmittedCount: serverCount,
         ),
       );
     } catch (e) {
       log.severe('Error loading user data: $e');
       emit(
         state.copyWith(
           isLoadingUser: false,
+          isUserDataLoaded: false,
           error: 'Failed to load user data',
         ),
       );
@@ -97,31 +89,22 @@ class FileUploadCubit extends Cubit<FileUploadState> {
       }
 
       if (file.bytes == null) {
-        emit(
-          state.copyWith(
-            isUploading: false,
-            error: 'Failed to read file',
-          ),
-        );
+        emit(state.copyWith(isUploading: false, error: 'Failed to read file'));
         return;
       }
 
       // Generate standardized filename like BB-Exchange
-      final standardizedFileName =
-          state.userId != null ? 'doc-${state.userId}-ID' : file.name;
+      final standardizedFileName = state.userId != null
+          ? 'doc-${state.userId}-ID'
+          : file.name;
 
       final uploadResult = await _uploadKycDocumentUsecase.execute(
         fileBytes: file.bytes!,
         fileName: standardizedFileName,
       );
 
       if (uploadResult.isSuccess) {
-        emit(
-          state.copyWith(
-            isUploading: false,
-            uploadComplete: true,
-          ),
-        );
+        emit(state.copyWith(isUploading: false, uploadComplete: true));
         // Refresh user data to update the secure file upload status
         await refreshUserData();
       } else {
@@ -159,4 +142,3 @@ class FileUploadCubit extends Cubit<FileUploadState> {
     emit(state.copyWith(error: null));
   }
 }
-

lib/features/exchange_settings/presentation/file_upload_state.dart

@@ -1,4 +1,3 @@
-import 'package:bb_mobile/core/exchange/domain/entity/file_upload.dart';
 import 'package:bb_mobile/core/exchange/domain/entity/user_summary.dart';
 import 'package:freezed_annotation/freezed_annotation.dart';
 
@@ -14,6 +13,9 @@ enum SecureUploadStatus {
 
   /// Files have been accepted
   accepted,
+
+  /// Files were rejected - can re-upload
+  rejected,
 }
 
 @freezed
@@ -24,37 +26,49 @@ abstract class FileUploadState with _$FileUploadState {
     String? error,
     @Default(false) bool uploadComplete,
 
+    /// Whether user data was successfully loaded from the API
+    @Default(false) bool isUserDataLoaded,
+
     /// User ID for generating standardized filenames
     String? userId,
 
-    /// Secure file upload status from the API
+    /// Secure file upload status from the API (from UserSummary)
     KycDocumentStatus? secureFileUploadStatus,
-
-    /// Number of files already submitted on the server
-    @Default(0) int serverSubmittedCount,
   }) = _FileUploadState;
 
   const FileUploadState._();
 
-  /// Whether user can add more files (only 1 file allowed now)
+  /// Whether user can upload files
+  /// Only allowed when data is loaded and status permits uploading
   bool get canAddMoreFiles =>
-      serverSubmittedCount < FileToUpload.maxFileCount &&
-      secureUploadStatus == SecureUploadStatus.upload;
+      isUserDataLoaded &&
+      (secureUploadStatus == SecureUploadStatus.upload ||
+          secureUploadStatus == SecureUploadStatus.rejected);
 
   /// Get the UI status for the secure upload feature
+  /// Uses only the secureFileUploadStatus from UserSummary API response
   SecureUploadStatus get secureUploadStatus {
-    // If status from API indicates accepted, show accepted
-    if (secureFileUploadStatus == KycDocumentStatus.accepted) {
-      return SecureUploadStatus.accepted;
-    }
+    // Handle each status explicitly based on API response
+    switch (secureFileUploadStatus) {
+      case KycDocumentStatus.accepted:
+        // File was accepted - show accepted status
+        return SecureUploadStatus.accepted;
 
-    // If status from API indicates under review OR max files submitted, show in review
-    if (secureFileUploadStatus == KycDocumentStatus.underReview ||
-        serverSubmittedCount >= FileToUpload.maxFileCount) {
-      return SecureUploadStatus.inReview;
-    }
+      case KycDocumentStatus.underReview:
+        // File is under review - cannot upload new files
+        return SecureUploadStatus.inReview;
+
+      case KycDocumentStatus.notUploaded:
+        // No file uploaded yet - can upload
+        return SecureUploadStatus.upload;
 
-    // Otherwise, can upload
-    return SecureUploadStatus.upload;
+      case KycDocumentStatus.rejected:
+        // File was rejected - show rejected status with re-upload option
+        return SecureUploadStatus.rejected;
+
+      case null:
+        // Status is null - show upload button (loading state handled separately in UI)
+        return SecureUploadStatus.upload;
+    }
   }
 }