import 'package:shared_preferences/shared_preferences.dart'; import '../../core/utils/app_logger.dart'; /// Classe pour gérer les préférences utilisateur à l'aide de SharedPreferences. /// Permet de stocker et récupérer des informations de manière non sécurisée, /// contrairement au stockage sécurisé qui est utilisé pour des données sensibles. /// Chaque action est loguée pour assurer la traçabilité complète dans le terminal. class PreferencesHelper { // Initialisation de SharedPreferences en tant que Future final Future _prefs = SharedPreferences.getInstance(); /// Sauvegarde une chaîne de caractères (String) dans les préférences. /// Les actions sont loguées et les erreurs capturées pour garantir une sauvegarde correcte. Future setString(String key, String value) async { AppLogger.d('Sauvegarde dans les préférences : clé = $key, valeur = $value', tag: 'PreferencesHelper'); final prefs = await _prefs; final success = await prefs.setString(key, value); if (success) { AppLogger.d('Sauvegarde réussie pour la clé : $key', tag: 'PreferencesHelper'); } else { AppLogger.e('Échec de la sauvegarde pour la clé : $key', tag: 'PreferencesHelper'); } } /// Récupère une chaîne de caractères depuis les préférences. /// Retourne la valeur ou null si aucune donnée n'est trouvée. Future getString(String key) async { AppLogger.d('Récupération depuis les préférences pour la clé : $key', tag: 'PreferencesHelper'); final prefs = await _prefs; final value = prefs.getString(key); AppLogger.d('Valeur récupérée pour la clé $key : $value', tag: 'PreferencesHelper'); return value; } /// Supprime une entrée dans les préférences. /// Logue chaque étape de la suppression. Future remove(String key) async { AppLogger.d('Suppression dans les préférences pour la clé : $key', tag: 'PreferencesHelper'); final prefs = await _prefs; final success = await prefs.remove(key); if (success) { AppLogger.d('Suppression réussie pour la clé : $key', tag: 'PreferencesHelper'); } else { AppLogger.e('Échec de la suppression pour la clé : $key', tag: 'PreferencesHelper'); } } /// Sauvegarde l'identifiant utilisateur dans les préférences. /// Logue l'action et assure la robustesse de l'opération. Future saveUserId(String userId) async { AppLogger.d("Sauvegarde de l'userId dans les préférences : $userId", tag: 'PreferencesHelper'); await setString('user_id', userId); } /// Récupère l'identifiant utilisateur depuis les préférences. /// Retourne l'ID ou null en cas d'échec. Future getUserId() async { AppLogger.d("Récupération de l'userId depuis les préférences.", tag: 'PreferencesHelper'); return getString('user_id'); } /// Sauvegarde le nom d'utilisateur dans les préférences. /// Logue l'opération pour assurer un suivi complet. Future saveUserName(String userFirstName) async { AppLogger.d('Sauvegarde du userFirstName dans les préférences : $userFirstName', tag: 'PreferencesHelper'); await setString('user_name', userFirstName); } /// Récupère le nom d'utilisateur depuis les préférences. /// Retourne le nom ou null en cas d'échec. Future getUseFirstrName() async { AppLogger.d('Récupération du userFirstName depuis les préférences.', tag: 'PreferencesHelper'); return getString('user_name'); } /// Sauvegarde le prénom de l'utilisateur dans les préférences. /// Logue l'opération pour assurer un suivi complet. Future saveUserLastName(String userLastName) async { AppLogger.d('Sauvegarde du userLastName dans les préférences : $userLastName', tag: 'PreferencesHelper'); await setString('user_last_name', userLastName); } /// Récupère le prénom de l'utilisateur depuis les préférences. /// Retourne le prénom ou null en cas d'échec. Future getUserLastName() async { AppLogger.d('Récupération du userLastName depuis les préférences.', tag: 'PreferencesHelper'); return getString('user_last_name'); } /// Supprime toutes les informations utilisateur dans les préférences. /// Logue chaque étape de la suppression. Future clearUserInfo() async { AppLogger.d('Suppression des informations utilisateur (userId, userFirstName, userLastName) des préférences.', tag: 'PreferencesHelper'); await remove('user_id'); await remove('user_name'); await remove('user_last_name'); AppLogger.d('Suppression réussie des informations utilisateur.', tag: 'PreferencesHelper'); } }