import 'package:lunchpick/domain/entities/restaurant.dart';

abstract class RestaurantRepository {
  /// 모든 맛집 목록을 가져옵니다
  Future<List<Restaurant>> getAllRestaurants();

  /// 특정 맛집을 ID로 가져옵니다
  Future<Restaurant?> getRestaurantById(String id);

  /// 새로운 맛집을 추가합니다
  Future<void> addRestaurant(Restaurant restaurant);

  /// 맛집 정보를 업데이트합니다
  Future<void> updateRestaurant(Restaurant restaurant);

  /// 맛집을 삭제합니다
  Future<void> deleteRestaurant(String id);

  /// 카테고리별로 맛집을 가져옵니다
  Future<List<Restaurant>> getRestaurantsByCategory(String category);

  /// 모든 카테고리 목록을 가져옵니다
  Future<List<String>> getAllCategories();

  /// 맛집 목록을 스트림으로 감시합니다
  Stream<List<Restaurant>> watchRestaurants();

  /// 맛집 방문일을 업데이트합니다
  Future<void> updateLastVisitDate(String restaurantId, DateTime visitDate);

  /// 거리 내의 맛집을 가져옵니다
  Future<List<Restaurant>> getRestaurantsWithinDistance({
    required double userLatitude,
    required double userLongitude,
    required double maxDistanceInMeters,
  });

  /// 최근 n일 이내에 방문하지 않은 맛집을 가져옵니다
  Future<List<Restaurant>> getRestaurantsNotVisitedInDays(int days);

  /// 검색어로 맛집을 검색합니다
  Future<List<Restaurant>> searchRestaurants(String query);

  /// 네이버 지도 URL로부터 맛집을 추가합니다
  Future<Restaurant> addRestaurantFromUrl(String url);

  /// 네이버 지도 URL로부터 식당 정보를 미리보기로 가져옵니다
  Future<Restaurant> previewRestaurantFromUrl(String url);

  /// 네이버 로컬 검색에서 식당을 검색합니다
  Future<List<Restaurant>> searchRestaurantsFromNaver({
    required String query,
    double? latitude,
    double? longitude,
  });

  /// 네이버 Place ID로 맛집을 찾습니다
  Future<Restaurant?> getRestaurantByNaverPlaceId(String naverPlaceId);
}
