import 'package:flutter/material.dart'; import 'package:logger/logger.dart'; import '../../domain/entities/friend.dart'; import '../../data/repositories/friends_repository_impl.dart'; /// [FriendsProvider] est un `ChangeNotifier` qui gère la logique de gestion des amis. /// Il interagit avec le [FriendsRepositoryImpl] pour effectuer des appels API et gérer /// la liste des amis de l'utilisateur, avec une gestion avancée de la pagination, /// du statut des amis et de la gestion des erreurs. class FriendsProvider with ChangeNotifier { final FriendsRepositoryImpl friendsRepository; final Logger _logger = Logger(); // Utilisation du logger pour une traçabilité complète des actions. // Liste des amis List _friendsList = []; bool _isLoading = false; // Indicateur de chargement bool _hasMore = true; // Indicateur de pagination int _currentPage = 0; // Numéro de la page actuelle pour la pagination final int _friendsPerPage = 10; // Nombre d'amis à récupérer par page /// Constructeur de [FriendsProvider] qui nécessite l'instance d'un [FriendsRepositoryImpl]. FriendsProvider({required this.friendsRepository}); // Getters pour accéder à l'état actuel des données bool get isLoading => _isLoading; bool get hasMore => _hasMore; List get friendsList => _friendsList; /// Récupère la liste des amis pour un utilisateur donné avec pagination. /// /// [userId] : L'identifiant unique de l'utilisateur connecté. /// [loadMore] : Si vrai, charge plus d'amis, sinon recharge la liste depuis le début. /// /// Cette méthode gère : /// - La pagination de la liste d'amis. /// - L'exclusion de l'utilisateur lui-même. /// - Les erreurs et les logs pour une traçabilité complète. Future fetchFriends(String userId, {bool loadMore = false}) async { if (_isLoading) { _logger.w('[LOG] Une opération de chargement est déjà en cours. Annulation de la nouvelle requête.'); return; } _isLoading = true; notifyListeners(); _logger.i('[LOG] Début du chargement des amis pour l\'utilisateur $userId.'); // Réinitialisation de la pagination si ce n'est pas un chargement supplémentaire if (!loadMore) { _friendsList = []; _currentPage = 0; _hasMore = true; _logger.i('[LOG] Réinitialisation de la pagination et de la liste des amis.'); } try { _logger.i('[LOG] Chargement de la page $_currentPage des amis pour l\'utilisateur $userId.'); final newFriends = await friendsRepository.fetchFriends(userId, _currentPage, _friendsPerPage); // Gestion de l'absence de nouveaux amis if (newFriends.isEmpty) { _hasMore = false; _logger.i('[LOG] Plus d\'amis à charger.'); } else { // Ajout des amis à la liste, en excluant l'utilisateur connecté for (var friend in newFriends) { if (friend.friendId != userId) { _friendsList.add(friend); _logger.i("[LOG] Ami ajouté : ID = ${friend.friendId}, Nom = ${friend.friendFirstName} ${friend.friendLastName}"); } else { _logger.w("[WARN] L'utilisateur connecté est exclu de la liste des amis : ${friend.friendId}"); } } _currentPage++; _logger.i('[LOG] Préparation de la page suivante : $_currentPage'); } } catch (e) { _logger.e('[ERROR] Erreur lors du chargement des amis : $e'); } finally { _isLoading = false; _logger.i('[LOG] Fin du chargement des amis.'); notifyListeners(); } } /// Supprime un ami de la liste locale et de l'API. /// /// [friendId] : Identifiant unique de l'ami à supprimer. /// /// Cette méthode : /// - Loggue chaque étape. /// - Enlève l'ami de la liste locale. Future removeFriend(String friendId) async { try { _logger.i('[LOG] Suppression de l\'ami avec l\'ID : $friendId'); await friendsRepository.removeFriend(friendId); // Appel API pour supprimer l'ami _friendsList.removeWhere((friend) => friend.friendId == friendId); // Suppression locale _logger.i('[LOG] Ami supprimé localement avec succès : $friendId'); } catch (e) { _logger.e('[ERROR] Erreur lors de la suppression de l\'ami : $e'); } finally { notifyListeners(); } } /// Récupère les détails d'un ami via l'API. /// /// [userId] : Identifiant de l'utilisateur connecté. /// [friendId] : Identifiant de l'ami dont on souhaite récupérer les détails. /// /// Retourne un `Future` contenant les détails de l'ami ou `null` en cas d'erreur. Future fetchFriendDetails(String userId, String friendId) async { try { _logger.i('[LOG] Récupération des détails de l\'ami avec l\'ID : $friendId'); final friendDetails = await friendsRepository.getFriendDetails(friendId, userId); if (friendDetails != null) { _logger.i('[LOG] Détails de l\'ami récupérés avec succès : ${friendDetails.friendId}'); } else { _logger.w('[WARN] Détails de l\'ami introuvables pour l\'ID : $friendId'); } return friendDetails; } catch (e) { _logger.e('[ERROR] Erreur lors de la récupération des détails de l\'ami : $e'); return null; } } /// Convertit un statut sous forme de chaîne en [FriendStatus]. /// /// [status] : Le statut sous forme de chaîne (par exemple, 'pending', 'accepted'). /// /// Retourne un [FriendStatus] correspondant, ou `FriendStatus.unknown` si non reconnu. FriendStatus _convertToFriendStatus(String status) { switch (status.toLowerCase()) { case 'pending': return FriendStatus.pending; case 'accepted': return FriendStatus.accepted; case 'blocked': return FriendStatus.blocked; default: return FriendStatus.unknown; } } /// Met à jour le statut d'un ami (ex. accepter, bloquer). /// /// [friendId] : Identifiant de l'ami dont on souhaite mettre à jour le statut. /// [status] : Nouveau statut sous forme de chaîne de caractères. /// /// Loggue l'action, met à jour le statut en local et appelle l'API pour mettre à jour le statut. Future updateFriendStatus(String friendId, String status) async { try { _logger.i('[LOG] Mise à jour du statut de l\'ami avec l\'ID : $friendId'); // Conversion du statut sous forme de chaîne en statut spécifique final friendStatus = _convertToFriendStatus(status); await friendsRepository.updateFriendStatus(friendId, status); // Mise à jour dans l'API // Mise à jour locale de la liste des amis avec le nouveau statut final friendIndex = _friendsList.indexWhere((friend) => friend.friendId == friendId); if (friendIndex != -1) { _friendsList[friendIndex] = _friendsList[friendIndex].copyWith(status: friendStatus); _logger.i('[LOG] Statut de l\'ami mis à jour localement pour l\'ID : $friendId'); } } catch (e) { _logger.e('[ERROR] Erreur lors de la mise à jour du statut de l\'ami : $e'); } finally { notifyListeners(); } } }