afterwork/lib/data/services/preferences_helper.dart

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<SharedPreferences> _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<void> 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<String?> 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<void> 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<void> 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<String?> 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<void> 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<String?> 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<void> 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<String?> 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<void> 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');
  }
}