afterwork/lib/core/constants/urls.dart

import 'env_config.dart';

/// Classe utilitaire pour gérer toutes les URLs de l'API backend.
///
/// Cette classe centralise toutes les URLs de l'API pour faciliter
/// la maintenance et éviter la duplication de code.
///
/// **Usage:**
/// ```dart
/// // URL simple
/// final url = Urls.authenticateUser;
///
/// // URL avec paramètres dynamiques
/// final userUrl = Urls.getUserByIdWithId('123');
/// final eventUrl = Urls.getEventByIdWithId('456');
/// ```
class Urls {
  /// Constructeur privé pour empêcher l'instanciation
  Urls._();

  /// URL de base de l'API
  static String get baseUrl => EnvConfig.apiBaseUrl;

  // ============================================================================
  // AUTHENTIFICATION ET UTILISATEURS
  // ============================================================================

  /// Endpoint pour authentifier un utilisateur
  static String get authenticateUser => '$baseUrl/users/authenticate';

  /// Endpoint pour créer un nouvel utilisateur
  static String get createUser => '$baseUrl/users';

  /// Endpoint de base pour les opérations sur les utilisateurs
  static String get usersBase => '$baseUrl/users';

  /// Retourne l'URL pour obtenir un utilisateur par son ID
  ///
  /// [userId] L'ID de l'utilisateur
  static String getUserByIdWithId(String userId) => '$usersBase/$userId';

  /// Retourne l'URL pour rechercher un utilisateur par email
  ///
  /// [email] L'email de l'utilisateur à rechercher
  static String searchUserByEmail(String email) =>
      '$usersBase/search?email=${Uri.encodeComponent(email)}';

  /// Retourne l'URL pour supprimer un utilisateur par son ID
  ///
  /// [userId] L'ID de l'utilisateur
  static String deleteUserWithId(String userId) => '$usersBase/$userId';

  /// Retourne l'URL pour mettre à jour l'image de profil d'un utilisateur
  ///
  /// [userId] L'ID de l'utilisateur
  static String updateUserProfileImageWithId(String userId) =>
      '$usersBase/$userId/profile-image';

  /// Retourne l'URL pour mettre à jour un utilisateur
  ///
  /// [userId] L'ID de l'utilisateur
  static String updateUserWithId(String userId) => '$usersBase/$userId';

  // ============================================================================
  // ÉVÉNEMENTS
  // ============================================================================

  /// Endpoint de base pour les opérations sur les événements
  static String get eventsBase => '$baseUrl/events';

  /// Endpoint pour créer un nouvel événement
  static String get createEvent => eventsBase;

  /// Endpoint pour obtenir tous les événements
  static String get getAllEvents => eventsBase;

  /// Endpoint pour obtenir les événements créés par un utilisateur et ses amis
  static String get getEventsCreatedByUserAndFriends =>
      '$eventsBase/created-by-user-and-friends';

  /// Retourne l'URL pour obtenir un événement par son ID
  ///
  /// [eventId] L'ID de l'événement
  static String getEventByIdWithId(String eventId) => '$eventsBase/$eventId';

  /// Retourne l'URL pour supprimer un événement par son ID
  ///
  /// [eventId] L'ID de l'événement
  static String deleteEventWithId(String eventId) => '$eventsBase/$eventId';

  /// Retourne l'URL pour mettre à jour un événement
  ///
  /// [eventId] L'ID de l'événement
  static String updateEventWithId(String eventId) => '$eventsBase/$eventId';

  /// Retourne l'URL pour mettre à jour l'image d'un événement
  ///
  /// [eventId] L'ID de l'événement
  static String updateEventImageWithId(String eventId) =>
      '$eventsBase/$eventId/image';

  /// Retourne l'URL pour fermer un événement
  ///
  /// [eventId] L'ID de l'événement
  static String closeEventWithId(String eventId) => '$eventsBase/$eventId/close';

  /// Retourne l'URL pour rouvrir un événement
  ///
  /// [eventId] L'ID de l'événement
  static String reopenEventWithId(String eventId) =>
      '$eventsBase/$eventId/reopen';

  /// Retourne l'URL pour mettre à jour le statut d'un événement
  ///
  /// [eventId] L'ID de l'événement
  static String updateEventStatusWithId(String eventId) =>
      '$eventsBase/$eventId/status';

  /// Endpoint pour obtenir les événements après une date
  static String get getEventsAfterDate => '$eventsBase/after-date';

  /// Endpoint pour obtenir les événements entre deux dates
  static String get getEventsBetweenDates => '$eventsBase/between-dates';

  /// Retourne l'URL pour obtenir les événements par catégorie
  ///
  /// [category] La catégorie des événements
  static String getEventsByCategoryWithCategory(String category) =>
      '$eventsBase/category/$category';

  /// Retourne l'URL pour obtenir les événements par statut
  ///
  /// [status] Le statut des événements (ouvert, fermé, etc.)
  static String getEventsByStatusWithStatus(String status) =>
      '$eventsBase/status/$status';

  /// Retourne l'URL pour obtenir les événements d'un utilisateur
  ///
  /// [userId] L'ID de l'utilisateur
  static String getEventsByUserWithUserId(String userId) =>
      '$eventsBase/user/$userId';

  /// Endpoint pour rechercher des événements
  ///
  /// **Note:** Utilisez des paramètres de requête pour le mot-clé
  static String get searchEvents => '$eventsBase/search';

  // ============================================================================
  // PARTICIPANTS AUX ÉVÉNEMENTS
  // ============================================================================

  /// Retourne l'URL pour ajouter un participant à un événement
  ///
  /// [eventId] L'ID de l'événement
  static String addParticipantWithEventId(String eventId) =>
      '$eventsBase/$eventId/participants';

  /// Retourne l'URL pour retirer un participant d'un événement
  ///
  /// [eventId] L'ID de l'événement
  /// [userId] L'ID de l'utilisateur à retirer
  static String removeParticipantWithIds(String eventId, String userId) =>
      '$eventsBase/$eventId/participants/$userId';

  /// Retourne l'URL pour obtenir le nombre de participants d'un événement
  ///
  /// [eventId] L'ID de l'événement
  static String getNumberOfParticipantsWithEventId(String eventId) =>
      '$eventsBase/$eventId/participants/count';

  /// Retourne l'URL pour réagir à un événement (utilise favorite)
  ///
  /// [eventId] L'ID de l'événement
  /// [userId] L'ID de l'utilisateur
  static String reactToEventWithId(String eventId, String userId) =>
      '$eventsBase/$eventId/favorite?userId=$userId';

  /// Retourne l'URL pour participer à un événement (utilise participants)
  ///
  /// [eventId] L'ID de l'événement
  static String participateInEventWithId(String eventId) =>
      '$eventsBase/$eventId/participants';

  // ============================================================================
  // AMIS ET RELATIONS SOCIALES
  // ============================================================================

  /// Endpoint de base pour les opérations sur les amis
  static String get friendsBase => '$baseUrl/friends';

  /// Retourne l'URL pour obtenir les amis d'un utilisateur
  ///
  /// [userId] L'ID de l'utilisateur
  static String getFriendsWithUserId(String userId) =>
      '$friendsBase/user/$userId';

  /// Retourne l'URL pour ajouter un ami
  ///
  /// [userId] L'ID de l'utilisateur
  /// [friendId] L'ID de l'ami à ajouter
  static String addFriendWithIds(String userId, String friendId) =>
      '$friendsBase/$userId/$friendId';

  /// Retourne l'URL pour supprimer un ami
  ///
  /// [userId] L'ID de l'utilisateur
  /// [friendId] L'ID de l'ami à supprimer
  static String removeFriendWithIds(String userId, String friendId) =>
      '$friendsBase/$userId/$friendId';

  /// Retourne l'URL pour récupérer les demandes d'amitié en attente
  ///
  /// [userId] L'ID de l'utilisateur
  /// [page] Le numéro de la page (optionnel, par défaut 0)
  /// [size] La taille de la page (optionnel, par défaut 10)
  static String getPendingFriendRequestsWithUserId(String userId, {int page = 0, int size = 10}) =>
      '$friendsBase/pending/$userId?page=$page&size=$size';

  /// Retourne l'URL pour récupérer les demandes d'amitié envoyées
  ///
  /// [userId] L'ID de l'utilisateur
  /// [page] Le numéro de la page (optionnel, par défaut 0)
  /// [size] La taille de la page (optionnel, par défaut 10)
  static String getSentFriendRequestsWithUserId(String userId, {int page = 0, int size = 10}) =>
      '$friendsBase/sent/$userId?page=$page&size=$size';

  /// Retourne l'URL pour récupérer les demandes d'amitié reçues
  ///
  /// [userId] L'ID de l'utilisateur
  /// [page] Le numéro de la page (optionnel, par défaut 0)
  /// [size] La taille de la page (optionnel, par défaut 10)
  static String getReceivedFriendRequestsWithUserId(String userId, {int page = 0, int size = 10}) =>
      '$friendsBase/received/$userId?page=$page&size=$size';

  /// Retourne l'URL pour accepter une demande d'amitié
  ///
  /// [friendshipId] L'ID de la relation d'amitié
  static String acceptFriendRequestWithId(String friendshipId) =>
      '$friendsBase/$friendshipId/accept';

  /// Retourne l'URL pour rejeter une demande d'amitié
  ///
  /// [friendshipId] L'ID de la relation d'amitié
  static String rejectFriendRequestWithId(String friendshipId) =>
      '$friendsBase/$friendshipId/reject';

  // ============================================================================
  // NOTIFICATIONS
  // ============================================================================

  /// Endpoint de base pour les opérations sur les notifications
  static String get notificationsBase => '$baseUrl/notifications';

  /// Retourne l'URL pour obtenir les notifications d'un utilisateur
  ///
  /// [userId] L'ID de l'utilisateur
  static String getNotificationsWithUserId(String userId) =>
      '$notificationsBase/user/$userId';

  /// Retourne l'URL pour marquer une notification comme lue
  ///
  /// [notificationId] L'ID de la notification
  static String markNotificationAsReadWithId(String notificationId) =>
      '$notificationsBase/$notificationId/read';

  /// Retourne l'URL pour marquer toutes les notifications comme lues
  ///
  /// [userId] L'ID de l'utilisateur
  static String markAllNotificationsAsReadWithUserId(String userId) =>
      '$notificationsBase/user/$userId/mark-all-read';

  /// Retourne l'URL pour supprimer une notification
  ///
  /// [notificationId] L'ID de la notification
  static String deleteNotificationWithId(String notificationId) =>
      '$notificationsBase/$notificationId';

  // ============================================================================
  // POSTS SOCIAUX
  // ============================================================================

  /// Endpoint de base pour les opérations sur les posts sociaux
  static String get postsBase => '$baseUrl/posts';

  /// Retourne l'URL pour obtenir tous les posts (avec pagination)
  static String get getAllPosts => postsBase;

  /// Retourne l'URL pour créer un nouveau post
  static String get createSocialPost => postsBase;

  /// Retourne l'URL pour obtenir un post par son ID
  ///
  /// [postId] L'ID du post
  static String getSocialPostByIdWithId(String postId) => '$postsBase/$postId';

  /// Retourne l'URL pour mettre à jour un post
  ///
  /// [postId] L'ID du post
  static String updateSocialPostWithId(String postId) => '$postsBase/$postId';

  /// Retourne l'URL pour supprimer un post
  ///
  /// [postId] L'ID du post
  static String deleteSocialPostWithId(String postId) => '$postsBase/$postId';

  /// Retourne l'URL pour rechercher des posts
  ///
  /// [query] Le terme de recherche
  static String searchSocialPostsWithQuery(String query) =>
      '$postsBase/search?q=${Uri.encodeComponent(query)}';

  /// Retourne l'URL pour liker un post
  ///
  /// [postId] L'ID du post
  static String likeSocialPostWithId(String postId) => '$postsBase/$postId/like';

  /// Retourne l'URL pour commenter un post
  ///
  /// [postId] L'ID du post
  static String commentSocialPostWithId(String postId) =>
      '$postsBase/$postId/comment';

  /// Retourne l'URL pour partager un post
  ///
  /// [postId] L'ID du post
  static String shareSocialPostWithId(String postId) => '$postsBase/$postId/share';

  /// Retourne l'URL pour obtenir les posts d'un utilisateur
  ///
  /// [userId] L'ID de l'utilisateur
  static String getSocialPostsByUserId(String userId) =>
      '$postsBase/user/$userId';

  // ============================================================================
  // MÉTHODES UTILITAIRES
  // ============================================================================

  /// Construit une URL avec des paramètres de requête
  ///
  /// [baseUrl] L'URL de base
  /// [params] Les paramètres de requête (clé-valeur)
  ///
  /// **Exemple:**
  /// ```dart
  /// final url = Urls.buildUrlWithParams(
  ///   Urls.searchEvents,
  ///   {'keyword': 'concert', 'category': 'music'},
  /// );
  /// // Résultat: 'http://api.com/events/search?keyword=concert&category=music'
  /// ```
  static String buildUrlWithParams(String baseUrl, Map<String, String> params) {
    if (params.isEmpty) return baseUrl;

    final queryString = params.entries
        .map((e) => '${Uri.encodeComponent(e.key)}=${Uri.encodeComponent(e.value)}')
        .join('&');

    return '$baseUrl?$queryString';
  }

  /// Valide qu'une URL est bien formée
  ///
  /// [url] L'URL à valider
  ///
  /// Returns `true` si l'URL est valide, `false` sinon
  static bool isValidUrl(String url) {
    try {
      final uri = Uri.parse(url);
      return uri.hasScheme && uri.hasAuthority;
    } catch (e) {
      return false;
    }
  }
}