refactoring

lib/data/repositories/friends_repository.dart

@@ -0,0 +1,48 @@
+import 'package:afterwork/domain/entities/friend.dart';
+
+/// Interface [FriendsRepository] définissant les méthodes pour gérer les amis.
+/// Cette interface permet de séparer la logique métier des appels API et de la gestion des données.
+/// Elle est implémentée par [FriendsRepositoryImpl], qui contient les détails d'implémentation.
+abstract class FriendsRepository {
+
+  /// Récupère la liste paginée des amis pour un utilisateur donné via l'API.
+  ///
+  /// [userId] : Identifiant unique de l'utilisateur pour lequel récupérer la liste d'amis.
+  /// [currentPage] : Indique la page actuelle pour la pagination.
+  /// [friendsPerPage] : Nombre d'amis à récupérer par page.
+  ///
+  /// Retourne une liste d'objets [Friend] correspondant aux amis de l'utilisateur.
+  /// En cas d'échec, une liste vide peut être retournée par l'implémentation.
+  Future<List<Friend>> fetchFriends(String userId, int currentPage, int friendsPerPage);
+
+  /// Envoie une demande pour ajouter un nouvel ami via l'API.
+  ///
+  /// [friend] : Objet [Friend] représentant l'ami à ajouter.
+  ///
+  /// Retourne un `Future<void>`. En cas d'erreur, l'implémentation peut lancer une exception.
+  Future<void> addFriend(Friend friend);
+
+  /// Supprime un ami existant via l'API.
+  ///
+  /// [friendId] : Identifiant unique de l'ami à supprimer.
+  ///
+  /// Retourne un `Future<void>`. En cas d'erreur, l'implémentation peut lancer une exception.
+  Future<void> removeFriend(String friendId);
+
+  /// Récupère les détails d'un ami en utilisant son identifiant `friendId`.
+  ///
+  /// [userId] : Identifiant unique de l'utilisateur connecté (facultatif selon le contexte).
+  /// [friendId] : Identifiant unique de l'ami pour lequel récupérer les détails.
+  ///
+  /// Retourne un `Future<Friend?>` contenant les informations de l'ami si trouvées,
+  /// ou `null` si aucun ami correspondant n'est trouvé ou en cas d'échec.
+  Future<Friend?> getFriendDetails(String friendId, String userId);
+
+  /// Met à jour le statut d'un ami dans le système (par exemple, accepter, bloquer).
+  ///
+  /// [friendId] : Identifiant unique de l'ami.
+  /// [status] : Nouveau statut de l'ami sous forme de chaîne de caractères.
+  ///
+  /// Retourne un `Future<void>`. En cas d'erreur, l'implémentation peut lancer une exception.
+  Future<void> updateFriendStatus(String friendId, String status);
+}