import '../entities/postal_code.dart';

/// 우편번호 검색 기능을 추상화한 저장소 인터페이스.
abstract class PostalSearchRepository {
  /// 키워드를 기반으로 우편번호 목록을 검색한다.
  ///
  /// [keyword]는 우편번호/도로명/건물번호 중 하나의 문자열을 전달한다.
  /// [limit]은 페이지 크기(`page_size`)에 대응한다.
  /// [page]를 지정하면 서버 페이지네이션을 제어한다.
  Future<List<PostalCode>> search({
    required String keyword,
    int limit = 20,
    int page = 1,
  });
}
