TF-4141 Add Action required folder to left menu

lib/features/mailbox/presentation/extensions/handle_action_required_tab_extension.dart

@@ -0,0 +1,91 @@
+import 'package:jmap_dart_client/jmap/core/unsigned_int.dart';
+import 'package:jmap_dart_client/jmap/mail/mailbox/mailbox.dart';
+import 'package:model/mailbox/presentation_mailbox.dart';
+import 'package:tmail_ui_user/features/base/base_mailbox_controller.dart';
+import 'package:tmail_ui_user/features/mailbox/presentation/extensions/list_mailbox_node_extension.dart';
+import 'package:tmail_ui_user/features/mailbox/presentation/extensions/presentation_mailbox_extension.dart';
+import 'package:tmail_ui_user/features/mailbox/presentation/model/mailbox_node.dart';
+import 'package:tmail_ui_user/features/mailbox/presentation/model/mailbox_tree.dart';
+import 'package:tmail_ui_user/features/mailbox_dashboard/presentation/controller/mailbox_dashboard_controller.dart';
+import 'package:tmail_ui_user/features/mailbox_dashboard/presentation/extensions/handle_ai_action_extension.dart';
+import 'package:tmail_ui_user/main/routes/route_navigation.dart';
+
+extension HandleActionRequiredTabExtension on BaseMailboxController {
+  void setUpActionRequiredFolder(
+    MailboxDashBoardController dashboardController,
+  ) {
+    if (!dashboardController.isAiCapabilitySupported) return;
+
+    dashboardController.actionRequiredFolderController.getCountEmails(
+      session: dashboardController.sessionCurrent,
+      accountId: dashboardController.accountId.value,
+    );
+  }
+
+  void onActionRequiredFolderCountChanged(int count) {
+    if (count > 0) {
+      _addActionRequiredFolder(count);
+    } else {
+      _removeActionRequiredFolder();
+    }
+  }
+
+  void _addActionRequiredFolder(int count) {
+    final folder = _buildActionRequiredFolder(count);
+
+    _addToDefaultMailboxTree(folder);
+    _addToAllMailboxes(folder);
+  }
+
+  PresentationMailbox _buildActionRequiredFolder(int count) {
+    final base = PresentationMailbox.actionRequiredFolder;
+
+    return base.copyWith(
+      displayName:
+          currentContext != null ? base.getDisplayName(currentContext!) : null,
+      totalEmails: TotalEmails(UnsignedInt(count)),
+      unreadEmails: UnreadEmails(UnsignedInt(count)),
+    );
+  }
+
+  void _addToDefaultMailboxTree(PresentationMailbox folder) {
+    final root = defaultMailboxTree.value.root;
+    final children = List<MailboxNode>.from(root.childrenItems ?? []);
+
+    children.insertAfterStarredOrInbox(MailboxNode(folder));
+
+    defaultMailboxTree.value = MailboxTree(
+      root.copyWith(children: children),
+    );
+  }
+
+  void _addToAllMailboxes(PresentationMailbox folder) {
+    if (_allMailboxesContains(folder.id)) return;
+    allMailboxes.add(folder);
+  }
+
+  void _removeActionRequiredFolder() {
+    final folder = PresentationMailbox.actionRequiredFolder;
+
+    _removeFromDefaultMailboxTree(folder.id);
+    _removeFromAllMailboxes(folder.id);
+  }
+
+  void _removeFromDefaultMailboxTree(MailboxId folderId) {
+    final root = defaultMailboxTree.value.root;
+    final children = List<MailboxNode>.from(root.childrenItems ?? [])
+      ..removeWhere((node) => node.item.id == folderId);
+
+    defaultMailboxTree.value = MailboxTree(
+      root.copyWith(children: children),
+    );
+  }
+
+  void _removeFromAllMailboxes(MailboxId folderId) {
+    allMailboxes.removeWhere((mailbox) => mailbox.id == folderId);
+  }
+
+  bool _allMailboxesContains(MailboxId id) {
+    return allMailboxes.any((mailbox) => mailbox.id == id);
+  }
+}

lib/features/mailbox/presentation/extensions/list_mailbox_node_extension.dart

@@ -5,20 +5,60 @@ import 'package:tmail_ui_user/features/mailbox/presentation/model/mailbox_node.d
 extension ListMailboxNodeExtension on List<MailboxNode> {
   List<MailboxId> get mailboxIds => map((node) => node.item.id).toList();
 
+  /// Insert [newNode] after Inbox if present, otherwise at the beginning.
   void insertAfterInbox(MailboxNode newNode) {
-    final alreadyExists = any((node) => node.item.id == newNode.item.id);
-    if (alreadyExists) return;
-
-    final index = indexWhere(
-      (node) =>
-          node.item.role?.value == PresentationMailbox.inboxRole ||
-          node.item.name?.name.toLowerCase() == 'inbox',
+    insertAfterByPriority(
+      newNode,
+      [_isInbox],
     );
+  }
 
-    if (index != -1) {
-      insert(index + 1, newNode);
-    } else {
-      insert(0, newNode);
+  /// Insert [newNode] after Starred if present,
+  /// otherwise after Inbox, otherwise at the beginning.
+  void insertAfterStarredOrInbox(MailboxNode newNode) {
+    insertAfterByPriority(
+      newNode,
+      [
+        _isStarred,
+        _isInbox,
+      ],
+    );
+  }
+
+  /// Insert [newNode] after the first mailbox matching [priorities].
+  /// If none match, inserts at the beginning.
+  void insertAfterByPriority(
+    MailboxNode newNode,
+    List<bool Function(MailboxNode)> priorities,
+  ) {
+    if (_containsMailbox(newNode)) return;
+
+    for (final predicate in priorities) {
+      final index = indexWhere(predicate);
+      if (index != -1) {
+        insert(index + 1, newNode);
+        return;
+      }
     }
+
+    insert(0, newNode);
+  }
+
+  bool _isInbox(MailboxNode node) {
+    return node.item.role?.value == PresentationMailbox.inboxRole ||
+        _equalsIgnoreCase(node.item.name?.name, 'inbox');
+  }
+
+  bool _isStarred(MailboxNode node) {
+    return node.item.role?.value == PresentationMailbox.favoriteRole ||
+        _equalsIgnoreCase(node.item.name?.name, 'starred');
+  }
+
+  bool _containsMailbox(MailboxNode node) {
+    return any((e) => e.item.id == node.item.id);
+  }
+
+  bool _equalsIgnoreCase(String? value, String expected) {
+    return value != null && value.toLowerCase() == expected;
   }
 }

lib/features/mailbox/presentation/extensions/presentation_mailbox_extension.dart

@@ -17,6 +17,8 @@ extension PresentationMailboxExtension on PresentationMailbox {
           return AppLocalizations.of(context).inboxMailboxDisplayName;
         case PresentationMailbox.favoriteRole:
           return AppLocalizations.of(context).favoriteMailboxDisplayName;
+        case PresentationMailbox.actionRequiredRole:
+          return AppLocalizations.of(context).actionRequiredMailboxDisplayName;
         case PresentationMailbox.archiveRole:
           return AppLocalizations.of(context).archiveMailboxDisplayName;
         case PresentationMailbox.draftsRole:
@@ -44,6 +46,10 @@ extension PresentationMailboxExtension on PresentationMailbox {
       switch(role!.value.toLowerCase()) {
         case PresentationMailbox.inboxRole:
           return appLocalizations.inboxMailboxDisplayName;
+        case PresentationMailbox.favoriteRole:
+          return appLocalizations.favoriteMailboxDisplayName;
+        case PresentationMailbox.actionRequiredRole:
+          return appLocalizations.actionRequiredMailboxDisplayName;
         case PresentationMailbox.archiveRole:
           return appLocalizations.archiveMailboxDisplayName;
         case PresentationMailbox.draftsRole:
@@ -73,6 +79,8 @@ extension PresentationMailboxExtension on PresentationMailbox {
           return imagePaths.icMailboxInbox;
         case PresentationMailbox.favoriteRole:
           return imagePaths.icMailboxFavorite;
+        case PresentationMailbox.actionRequiredRole:
+          return imagePaths.icMailboxActionRequired;
         case PresentationMailbox.draftsRole:
           return imagePaths.icMailboxDrafts;
         case PresentationMailbox.outboxRole:

lib/features/mailbox/presentation/mailbox_controller.dart

@@ -69,6 +69,7 @@ import 'package:tmail_ui_user/features/mailbox/domain/usecases/subaddressing_int
 import 'package:tmail_ui_user/features/mailbox/domain/usecases/subscribe_mailbox_interactor.dart';
 import 'package:tmail_ui_user/features/mailbox/domain/usecases/subscribe_multiple_mailbox_interactor.dart';
 import 'package:tmail_ui_user/features/mailbox/presentation/action/mailbox_ui_action.dart';
+import 'package:tmail_ui_user/features/mailbox/presentation/extensions/handle_action_required_tab_extension.dart';
 import 'package:tmail_ui_user/features/mailbox/presentation/extensions/handle_favorite_tab_extension.dart';
 import 'package:tmail_ui_user/features/mailbox/presentation/extensions/presentation_mailbox_extension.dart';
 import 'package:tmail_ui_user/features/mailbox/presentation/mixin/mailbox_widget_mixin.dart';
@@ -264,6 +265,7 @@ class MailboxController extends BaseMailboxController
       (failure) {
         if (failure is GetAllMailboxFailure) {
           addFavoriteFolderToMailboxList();
+          setUpActionRequiredFolder(mailboxDashBoardController);
           mailboxDashBoardController.updateRefreshAllMailboxState(Left(RefreshAllMailboxFailure()));
           showRetryToast(failure);
         }
@@ -271,6 +273,7 @@ class MailboxController extends BaseMailboxController
       (success) {
         if (success is GetAllMailboxSuccess) {
           addFavoriteFolderToMailboxList();
+          setUpActionRequiredFolder(mailboxDashBoardController);
           mailboxDashBoardController.updateRefreshAllMailboxState(Right(RefreshAllMailboxSuccess()));
           _handleCreateDefaultFolderIfMissing(mailboxDashBoardController.mapDefaultMailboxIdByRole);
           _handleDataFromNavigationRouter();
@@ -280,6 +283,7 @@ class MailboxController extends BaseMailboxController
           }
         } else if (success is CreateDefaultMailboxAllSuccess) {
           addFavoriteFolderToMailboxList();
+          setUpActionRequiredFolder(mailboxDashBoardController);
         }
       });
   }
@@ -434,6 +438,11 @@ class MailboxController extends BaseMailboxController
         );
       }
     });
+
+    ever(
+      mailboxDashBoardController.actionRequiredFolderController.actionRequiredFolderCount,
+      onActionRequiredFolderCountChanged,
+    );
   }
 
   void _handleMarkEmailsAsReadOrUnread({

lib/features/mailbox_dashboard/presentation/bindings/action_required_interactor_bindings.dart

@@ -0,0 +1,79 @@
+import 'package:core/data/model/source_type/data_source_type.dart';
+import 'package:get/get.dart';
+import 'package:tmail_ui_user/features/base/interactors_bindings.dart';
+import 'package:tmail_ui_user/features/caching/caching_manager.dart';
+import 'package:tmail_ui_user/features/mailbox/data/datasource/state_datasource.dart';
+import 'package:tmail_ui_user/features/mailbox/data/datasource_impl/state_datasource_impl.dart';
+import 'package:tmail_ui_user/features/mailbox/data/local/state_cache_manager.dart';
+import 'package:tmail_ui_user/features/thread/data/datasource/thread_datasource.dart';
+import 'package:tmail_ui_user/features/thread/data/datasource_impl/local_thread_datasource_impl.dart';
+import 'package:tmail_ui_user/features/thread/data/datasource_impl/thread_datasource_impl.dart';
+import 'package:tmail_ui_user/features/thread/data/local/email_cache_manager.dart';
+import 'package:tmail_ui_user/features/thread/data/network/thread_api.dart';
+import 'package:tmail_ui_user/features/thread/data/network/thread_isolate_worker.dart';
+import 'package:tmail_ui_user/features/thread/data/repository/thread_repository_impl.dart';
+import 'package:tmail_ui_user/features/thread/domain/repository/thread_repository.dart';
+import 'package:tmail_ui_user/features/thread/domain/usecases/get_count_unread_emails_in_folder_interactor.dart';
+import 'package:tmail_ui_user/main/exceptions/cache_exception_thrower.dart';
+import 'package:tmail_ui_user/main/exceptions/remote_exception_thrower.dart';
+import 'package:tmail_ui_user/main/utils/ios_sharing_manager.dart';
+
+class ActionRequiredInteractorBindings extends InteractorsBindings {
+  @override
+  void bindingsDataSource() {
+    Get.lazyPut<ThreadDataSource>(() => Get.find<ThreadDataSourceImpl>());
+    Get.lazyPut<StateDataSource>(() => Get.find<StateDataSourceImpl>());
+  }
+
+  @override
+  void bindingsDataSourceImpl() {
+    Get.lazyPut(
+      () => ThreadDataSourceImpl(
+        Get.find<ThreadAPI>(),
+        Get.find<ThreadIsolateWorker>(),
+        Get.find<RemoteExceptionThrower>(),
+      ),
+    );
+    Get.lazyPut(
+      () => LocalThreadDataSourceImpl(
+        Get.find<EmailCacheManager>(),
+        Get.find<CachingManager>(),
+        Get.find<CacheExceptionThrower>(),
+      ),
+    );
+    Get.lazyPut(
+      () => StateDataSourceImpl(
+        Get.find<StateCacheManager>(),
+        Get.find<IOSSharingManager>(),
+        Get.find<CacheExceptionThrower>(),
+      ),
+    );
+  }
+
+  @override
+  void bindingsInteractor() {
+    Get.lazyPut(
+      () => GetCountUnreadEmailsInFolderInteractor(
+        Get.find<ThreadRepository>(),
+      ),
+    );
+  }
+
+  @override
+  void bindingsRepository() {
+    Get.lazyPut<ThreadRepository>(() => Get.find<ThreadRepositoryImpl>());
+  }
+
+  @override
+  void bindingsRepositoryImpl() {
+    Get.lazyPut(
+      () => ThreadRepositoryImpl(
+        {
+          DataSourceType.network: Get.find<ThreadDataSource>(),
+          DataSourceType.local: Get.find<LocalThreadDataSourceImpl>()
+        },
+        Get.find<StateDataSource>(),
+      ),
+    );
+  }
+}

lib/features/mailbox_dashboard/presentation/bindings/mailbox_dashboard_bindings.dart

@@ -106,6 +106,7 @@ import 'package:tmail_ui_user/features/mailbox_dashboard/domain/usecases/store_e
 import 'package:tmail_ui_user/features/mailbox_dashboard/domain/usecases/store_last_time_dismissed_spam_reported_interactor.dart';
 import 'package:tmail_ui_user/features/mailbox_dashboard/domain/usecases/store_spam_report_state_interactor.dart';
 import 'package:tmail_ui_user/features/download/presentation/bindings/download_interactor_bindings.dart';
+import 'package:tmail_ui_user/features/mailbox_dashboard/presentation/controller/action_required_folder_controller.dart';
 import 'package:tmail_ui_user/features/mailbox_dashboard/presentation/controller/advanced_filter_controller.dart';
 import 'package:tmail_ui_user/features/mailbox_dashboard/presentation/controller/app_grid_dashboard_controller.dart';
 import 'package:tmail_ui_user/features/download/presentation/controllers/download_controller.dart';
@@ -209,6 +210,8 @@ class MailboxDashBoardBindings extends BaseBindings {
 
     Get.lazyPut(() => ComposerManager());
 
+    Get.put(ActionRequiredFolderController());
+
     Get.put(MailboxDashBoardController(
       Get.find<MoveToMailboxInteractor>(),
       Get.find<DeleteEmailPermanentlyInteractor>(),

lib/features/mailbox_dashboard/presentation/controller/action_required_folder_controller.dart

@@ -0,0 +1,82 @@
+import 'package:core/presentation/state/failure.dart';
+import 'package:core/presentation/state/success.dart';
+import 'package:dartz/dartz.dart';
+import 'package:get/get.dart';
+import 'package:jmap_dart_client/jmap/account_id.dart';
+import 'package:jmap_dart_client/jmap/core/session/session.dart';
+import 'package:tmail_ui_user/features/base/base_controller.dart';
+import 'package:tmail_ui_user/features/home/data/exceptions/session_exceptions.dart';
+import 'package:tmail_ui_user/features/mailbox_dashboard/presentation/bindings/action_required_interactor_bindings.dart';
+import 'package:tmail_ui_user/features/thread/domain/exceptions/thread_exceptions.dart';
+import 'package:tmail_ui_user/features/thread/domain/state/get_count_emails_in_folder_state.dart';
+import 'package:tmail_ui_user/features/thread/domain/usecases/get_count_unread_emails_in_folder_interactor.dart';
+import 'package:tmail_ui_user/main/routes/route_navigation.dart';
+
+class ActionRequiredFolderController extends BaseController {
+  final actionRequiredFolderCount = RxInt(0);
+
+  GetCountUnreadEmailsInFolderInteractor?
+      _getCountUnreadEmailsInFolderInteractor;
+
+  void injectBinding() {
+    ActionRequiredInteractorBindings().dependencies();
+
+    _getCountUnreadEmailsInFolderInteractor =
+        getBinding<GetCountUnreadEmailsInFolderInteractor>();
+  }
+
+  Future<void> getCountEmails({
+    required Session? session,
+    required AccountId? accountId,
+  }) async {
+    if (_getCountUnreadEmailsInFolderInteractor == null) {
+      consumeState(Stream.value(
+        Left(GetCountUnreadEmailsInFolderFailure(InteractorIsNullException())),
+      ));
+      return;
+    }
+
+    if (session == null) {
+      consumeState(Stream.value(
+        Left(GetCountUnreadEmailsInFolderFailure(NotFoundSessionException())),
+      ));
+      return;
+    }
+
+    if (accountId == null) {
+      consumeState(Stream.value(
+        Left(GetCountUnreadEmailsInFolderFailure(NotFoundAccountIdException())),
+      ));
+      return;
+    }
+
+    consumeState(_getCountUnreadEmailsInFolderInteractor!.execute(
+      session: session,
+      accountId: accountId,
+    ));
+  }
+
+  @override
+  void handleSuccessViewState(Success success) {
+    if (success is GetCountUnreadEmailsInFolderSuccess) {
+      actionRequiredFolderCount.value = success.count;
+    } else {
+      super.handleSuccessViewState(success);
+    }
+  }
+
+  @override
+  void handleFailureViewState(Failure failure) {
+    if (failure is GetCountUnreadEmailsInFolderFailure) {
+      actionRequiredFolderCount.value = 0;
+    } else {
+      super.handleFailureViewState(failure);
+    }
+  }
+
+  @override
+  void onClose() {
+    _getCountUnreadEmailsInFolderInteractor = null;
+    super.onClose();
+  }
+}

lib/features/mailbox_dashboard/presentation/controller/mailbox_dashboard_controller.dart

@@ -117,6 +117,7 @@ import 'package:tmail_ui_user/features/mailbox_dashboard/domain/usecases/save_te
 import 'package:tmail_ui_user/features/mailbox_dashboard/domain/usecases/store_email_sort_order_interactor.dart';
 import 'package:tmail_ui_user/features/mailbox_dashboard/presentation/action/dashboard_action.dart';
 import 'package:tmail_ui_user/features/mailbox_dashboard/presentation/action/download_ui_action.dart';
+import 'package:tmail_ui_user/features/mailbox_dashboard/presentation/controller/action_required_folder_controller.dart';
 import 'package:tmail_ui_user/features/mailbox_dashboard/presentation/controller/app_grid_dashboard_controller.dart';
 import 'package:tmail_ui_user/features/mailbox_dashboard/presentation/controller/search_controller.dart' as search;
 import 'package:tmail_ui_user/features/mailbox_dashboard/presentation/controller/spam_report_controller.dart';
@@ -124,6 +125,7 @@ import 'package:tmail_ui_user/features/mailbox_dashboard/presentation/extensions
 import 'package:tmail_ui_user/features/mailbox_dashboard/presentation/extensions/cleanup_recent_search_extension.dart';
 import 'package:tmail_ui_user/features/mailbox_dashboard/presentation/extensions/delete_emails_in_mailbox_extension.dart';
 import 'package:tmail_ui_user/features/mailbox_dashboard/presentation/extensions/handle_action_type_for_email_selection.dart';
+import 'package:tmail_ui_user/features/mailbox_dashboard/presentation/extensions/handle_ai_action_extension.dart';
 import 'package:tmail_ui_user/features/mailbox_dashboard/presentation/extensions/handle_clear_mailbox_extension.dart';
 import 'package:tmail_ui_user/features/mailbox_dashboard/presentation/extensions/handle_create_new_rule_filter.dart';
 import 'package:tmail_ui_user/features/mailbox_dashboard/presentation/extensions/handle_preferences_setting_extension.dart';
@@ -237,6 +239,8 @@ class MailboxDashBoardController extends ReloadableController
   final getStoredOidcConfigurationInteractor =
       Get.find<GetStoredOidcConfigurationInteractor>();
   final getTokenOIDCInteractor = Get.find<GetTokenOIDCInteractor>();
+  final actionRequiredFolderController =
+      Get.find<ActionRequiredFolderController>();
 
   final MoveToMailboxInteractor _moveToMailboxInteractor;
   final DeleteEmailPermanentlyInteractor _deleteEmailPermanentlyInteractor;
@@ -874,6 +878,9 @@ class MailboxDashBoardController extends ReloadableController
     if (PlatformInfo.isMobile) {
       injectFCMBindings(session, currentAccountId);
     }
+    if (isAiCapabilitySupported) {
+      actionRequiredFolderController.injectBinding();
+    }
 
     _getVacationResponse();
     spamReportController.getSpamReportStateAction();

lib/features/search/mailbox/presentation/search_mailbox_controller.dart

@@ -58,6 +58,7 @@ import 'package:tmail_ui_user/features/mailbox/domain/usecases/subaddressing_int
 import 'package:tmail_ui_user/features/mailbox/domain/usecases/subscribe_mailbox_interactor.dart';
 import 'package:tmail_ui_user/features/mailbox/domain/usecases/subscribe_multiple_mailbox_interactor.dart';
 import 'package:tmail_ui_user/features/mailbox/presentation/action/mailbox_ui_action.dart';
+import 'package:tmail_ui_user/features/mailbox/presentation/extensions/handle_action_required_tab_extension.dart';
 import 'package:tmail_ui_user/features/mailbox/presentation/extensions/handle_favorite_tab_extension.dart';
 import 'package:tmail_ui_user/features/mailbox/presentation/extensions/presentation_mailbox_extension.dart';
 import 'package:tmail_ui_user/features/mailbox/presentation/model/mailbox_actions.dart';
@@ -253,6 +254,12 @@ class SearchMailboxController extends BaseMailboxController with MailboxActionHa
         );
       }
     });
+
+    ever(
+      dashboardController
+          .actionRequiredFolderController.actionRequiredFolderCount,
+      onActionRequiredFolderCountChanged,
+    );
   }
 
   void _registerInputFocusListener() {

lib/features/thread/data/repository/thread_repository_impl.dart

@@ -16,6 +16,7 @@ import 'package:jmap_dart_client/jmap/core/unsigned_int.dart';
 import 'package:jmap_dart_client/jmap/core/user_name.dart';
 import 'package:jmap_dart_client/jmap/mail/email/email.dart';
 import 'package:jmap_dart_client/jmap/mail/email/email_filter_condition.dart';
+import 'package:jmap_dart_client/jmap/mail/email/keyword_identifier.dart';
 import 'package:jmap_dart_client/jmap/mail/mailbox/mailbox.dart';
 import 'package:model/model.dart';
 import 'package:tmail_ui_user/features/mailbox/data/datasource/state_datasource.dart';
@@ -523,4 +524,22 @@ class ThreadRepositoryImpl extends ThreadRepository {
     );
     yield emailResponse;
   }
+
+  @override
+  Future<int> getCountUnreadEmailsInFolder({
+    required Session session,
+    required AccountId accountId,
+  }) async {
+    final networkDataSource = mapDataSource[DataSourceType.network]!;
+    final emailResponse = await networkDataSource.getAllEmail(
+      session,
+      accountId,
+      filter: EmailFilterCondition(
+        hasKeyword: KeyWordIdentifierExtension.needActionMail.value,
+        notKeyword: KeyWordIdentifier.emailSeen.value,
+      ),
+      properties: Properties({EmailProperty.id}),
+    );
+    return emailResponse.emailList?.length ?? 0;
+  }
 }

lib/features/thread/domain/exceptions/thread_exceptions.dart

@@ -1,2 +1,3 @@
+class NotFoundEmailsDeletedException implements Exception {}
 
-class NotFoundEmailsDeletedException implements Exception {}
+class InteractorIsNullException implements Exception {}

lib/features/thread/domain/repository/thread_repository.dart

@@ -93,4 +93,9 @@ abstract class ThreadRepository {
   );
 
   Future<void> clearEmailCacheAndStateCache(AccountId accountId, Session session);
+
+  Future<int> getCountUnreadEmailsInFolder({
+    required Session session,
+    required AccountId accountId,
+  });
 }

lib/features/thread/domain/state/get_count_emails_in_folder_state.dart

@@ -0,0 +1,18 @@
+import 'package:core/presentation/state/failure.dart';
+import 'package:core/presentation/state/success.dart';
+
+class GettingCountUnreadEmailsInFolder extends LoadingState {}
+
+class GetCountUnreadEmailsInFolderSuccess extends UIState {
+  final int count;
+
+  GetCountUnreadEmailsInFolderSuccess({required this.count});
+
+  @override
+  List<Object> get props => [count];
+}
+
+class GetCountUnreadEmailsInFolderFailure extends FeatureFailure {
+  GetCountUnreadEmailsInFolderFailure(dynamic exception)
+      : super(exception: exception);
+}

lib/features/thread/domain/usecases/get_count_unread_emails_in_folder_interactor.dart

@@ -0,0 +1,29 @@
+import 'package:core/presentation/state/failure.dart';
+import 'package:core/presentation/state/success.dart';
+import 'package:dartz/dartz.dart';
+import 'package:jmap_dart_client/jmap/account_id.dart';
+import 'package:jmap_dart_client/jmap/core/session/session.dart';
+import 'package:tmail_ui_user/features/thread/domain/repository/thread_repository.dart';
+import 'package:tmail_ui_user/features/thread/domain/state/get_count_emails_in_folder_state.dart';
+
+class GetCountUnreadEmailsInFolderInteractor {
+  final ThreadRepository _threadRepository;
+
+  GetCountUnreadEmailsInFolderInteractor(this._threadRepository);
+
+  Stream<Either<Failure, Success>> execute({
+    required Session session,
+    required AccountId accountId,
+  }) async* {
+    try {
+      yield Right(GettingCountUnreadEmailsInFolder());
+      final count = await _threadRepository.getCountUnreadEmailsInFolder(
+        session: session,
+        accountId: accountId,
+      );
+      yield Right(GetCountUnreadEmailsInFolderSuccess(count: count));
+    } catch (e) {
+      yield Left(GetCountUnreadEmailsInFolderFailure(e));
+    }
+  }
+}

lib/l10n/intl_messages.arb

@@ -1,5 +1,5 @@
 {
-  "@@last_modified": "2025-12-16T11:52:06.406969",
+  "@@last_modified": "2025-12-16T15:21:10.099014",
   "initializing_data": "Initializing data...",
   "@initializing_data": {
     "type": "text",
@@ -5141,5 +5141,11 @@
     "type": "text",
     "placeholders_order": [],
     "placeholders": {}
+  },
+  "actionRequiredMailboxDisplayName": "Action required",
+  "@actionRequiredMailboxDisplayName": {
+    "type": "text",
+    "placeholders_order": [],
+    "placeholders": {}
   }
 }

lib/main/localizations/app_localizations.dart

@@ -5464,4 +5464,11 @@ class AppLocalizations {
       name: 'actionRequired',
     );
   }
+
+  String get actionRequiredMailboxDisplayName {
+    return Intl.message(
+      'Action required',
+      name: 'actionRequiredMailboxDisplayName',
+    );
+  }
 }