TF-3707 Implement clear mailbox method in data and domain layer

Signed-off-by: dab246 <tdvu@linagora.com>

lib/features/mailbox/data/datasource/mailbox_datasource.dart

@@ -9,6 +9,7 @@ import 'package:jmap_dart_client/jmap/core/id.dart';
 import 'package:jmap_dart_client/jmap/core/properties/properties.dart';
 import 'package:jmap_dart_client/jmap/core/session/session.dart';
 import 'package:jmap_dart_client/jmap/core/state.dart';
+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/mailbox/mailbox.dart';
@@ -59,4 +60,6 @@ abstract class MailboxDataSource {
   Future<GetMailboxByRoleResponse> getMailboxByRole(Session session, AccountId accountId, Role role);
 
   Future<void> clearAllMailboxCache(AccountId accountId, UserName userName);
+
+  Future<UnsignedInt> clearMailbox(Session session, AccountId accountId, MailboxId mailboxId);
 }

lib/features/mailbox/data/datasource_impl/mailbox_cache_datasource_impl.dart

@@ -161,4 +161,9 @@ class MailboxCacheDataSourceImpl extends MailboxDataSource {
       return await _mailboxCacheManager.clearAll(accountId, userName);
     }).catchError(_exceptionThrower.throwException);
   }
+
+  @override
+  Future<UnsignedInt> clearMailbox(Session session, AccountId accountId, MailboxId mailboxId) {
+    throw UnimplementedError();
+  }
 }

lib/features/mailbox/data/datasource_impl/mailbox_datasource_impl.dart

@@ -154,4 +154,11 @@ class MailboxDataSourceImpl extends MailboxDataSource {
   Future<void> clearAllMailboxCache(AccountId accountId, UserName userName) {
     throw UnimplementedError();
   }
+
+  @override
+  Future<UnsignedInt> clearMailbox(Session session, AccountId accountId, MailboxId mailboxId) {
+    return Future.sync(() async {
+      return await mailboxAPI.clearMailbox(session, accountId, mailboxId);
+    }).catchError(_exceptionThrower.throwException);
+  }
 }

lib/features/mailbox/data/network/mailbox_api.dart

@@ -20,6 +20,8 @@ import 'package:jmap_dart_client/jmap/core/unsigned_int.dart';
 import 'package:jmap_dart_client/jmap/jmap_request.dart';
 import 'package:jmap_dart_client/jmap/mail/mailbox/changes/changes_mailbox_method.dart';
 import 'package:jmap_dart_client/jmap/mail/mailbox/changes/changes_mailbox_response.dart';
+import 'package:jmap_dart_client/jmap/mail/mailbox/clear/clear_mailbox_method.dart';
+import 'package:jmap_dart_client/jmap/mail/mailbox/clear/clear_mailbox_response.dart';
 import 'package:jmap_dart_client/jmap/mail/mailbox/get/get_mailbox_method.dart';
 import 'package:jmap_dart_client/jmap/mail/mailbox/get/get_mailbox_response.dart';
 import 'package:jmap_dart_client/jmap/mail/mailbox/mailbox.dart';
@@ -607,4 +609,32 @@ class MailboxAPI with HandleSetErrorMixin {
       throw NotFoundMailboxException();
     }
   }
+
+  Future<UnsignedInt> clearMailbox(
+    Session session,
+    AccountId accountId,
+    MailboxId mailboxId,
+  ) async {
+    final clearMailboxMethod = ClearMailboxMethod(accountId, mailboxId);
+    final requestBuilder = JmapRequestBuilder(httpClient, ProcessingInvocation());
+    final invocation = requestBuilder.invocation(clearMailboxMethod);
+
+    final response = await (requestBuilder
+        ..usings(clearMailboxMethod.requiredCapabilities))
+      .build()
+      .execute();
+
+    final clearMailboxResponse = response.parse<ClearMailboxResponse>(
+      invocation.methodCallId,
+      ClearMailboxResponse.deserialize,
+    );
+
+    if (clearMailboxResponse?.totalDeletedMessagesCount != null) {
+      return clearMailboxResponse!.totalDeletedMessagesCount!;
+    } else if (clearMailboxResponse?.notCleared != null) {
+      throw clearMailboxResponse!.notCleared!;
+    } else {
+      throw NotFoundClearMailboxResponseException();
+    }
+  }
 }

lib/features/mailbox/data/repository/mailbox_repository_impl.dart

@@ -300,4 +300,9 @@ class MailboxRepositoryImpl extends MailboxRepository {
   Future<GetMailboxByRoleResponse> getMailboxByRole(Session session, AccountId accountId, Role role, {UnsignedInt? limit}) {
     return mapDataSource[DataSourceType.network]!.getMailboxByRole(session, accountId, role);
   }
+
+  @override
+  Future<UnsignedInt> clearMailbox(Session session, AccountId accountId, MailboxId mailboxId) {
+    return mapDataSource[DataSourceType.network]!.clearMailbox(session, accountId, mailboxId);
+  }
 }