import 'dart:collection';

import 'package:dio/dio.dart';

import 'api_error.dart';

/// 공통 API 클라이언트 (Dio 래퍼)
/// - 모든 HTTP 호출은 이 클래스를 통해 이루어진다.
/// - BaseURL/타임아웃/인증/로깅/에러 처리 등을 중앙집중화한다.
class ApiClient {
  ApiClient({required Dio dio, ApiErrorMapper? errorMapper})
    : _dio = dio,
      _errorMapper = errorMapper ?? const ApiErrorMapper();

  final Dio _dio;
  final ApiErrorMapper _errorMapper;
  static const _dataKey = 'data';

  /// 경로 세그먼트를 조합해 일관된 요청 경로를 생성한다.
  ///
  /// - 각 세그먼트의 선행/후행 `/`를 제거한 뒤 단일 슬래시로 결합한다.
  /// - 첫 번째 세그먼트가 `/`로 시작하면 결과 역시 `/`를 유지한다.
  static String buildPath(
    Object base, [
    Iterable<Object?> segments = const [],
  ]) {
    final joined = <String>[];
    var leadingSlash = false;

    void append(Object? value, {bool isFirst = false}) {
      if (value == null) {
        return;
      }
      var text = value.toString();
      if (text.isEmpty) {
        return;
      }
      if (isFirst && text.startsWith('/')) {
        leadingSlash = true;
      }
      text = text.replaceAll(RegExp(r'^/+'), '').replaceAll(RegExp(r'/+$'), '');
      if (text.isEmpty) {
        return;
      }
      joined.add(text);
    }

    append(base, isFirst: true);
    for (final segment in segments) {
      append(segment);
    }

    if (joined.isEmpty) {
      return leadingSlash ? '/' : '';
    }
    final path = joined.join('/');
    return leadingSlash ? '/$path' : path;
  }

  /// 페이지네이션/검색/필터 파라미터를 표준 규칙에 맞춰 구성한다.
  ///
  /// - 문자열은 trim 후 빈 값이면 제외한다.
  /// - `include`는 중복 제거 후 콤마로 연결한다.
  /// - `DateTime`은 UTC ISO8601 문자열로 직렬화한다.
  /// - [filters]가 동일 키를 포함하면 앞선 설정을 덮어쓴다.
  static Map<String, dynamic> buildQuery({
    int? page,
    int? pageSize,
    String? q,
    String? sort,
    String? order,
    Iterable<String>? include,
    DateTime? updatedSince,
    Map<String, dynamic>? filters,
  }) {
    final query = <String, dynamic>{};

    void put(String key, dynamic value) {
      if (value == null) {
        return;
      }
      if (value is String) {
        final trimmed = value.trim();
        if (trimmed.isEmpty) {
          return;
        }
        query[key] = trimmed;
        return;
      }
      if (value is DateTime) {
        query[key] = value.toUtc().toIso8601String();
        return;
      }
      if (value is Iterable) {
        final sanitized = <String>[];
        for (final element in value) {
          if (element == null) {
            continue;
          }
          final text = element.toString().trim();
          if (text.isEmpty) {
            continue;
          }
          sanitized.add(text);
        }
        if (sanitized.isEmpty) {
          return;
        }
        final unique = LinkedHashSet<String>.from(sanitized);
        query[key] = unique.join(',');
        return;
      }
      query[key] = value;
    }

    put('page', page);
    put('page_size', pageSize);
    put('q', q);
    put('sort', sort);
    put('order', order?.trim().toLowerCase());
    put('include', include);
    put('updated_since', updatedSince);

    filters?.forEach(put);

    return Map.unmodifiable(query);
  }

  /// 내부에서 사용하는 Dio 인스턴스
  /// 외부에서 Dio 직접 사용을 최소화하고, 가능하면 아래 헬퍼 메서드를 사용한다.
  Dio get dio => _dio;

  /// GET 요청 헬퍼
  Future<Response<T>> get<T>(
    String path, {
    Map<String, dynamic>? query,
    Options? options,
    CancelToken? cancelToken,
  }) {
    return _wrap(
      () => _dio.get<T>(
        path,
        queryParameters: query,
        options: options,
        cancelToken: cancelToken,
      ),
    );
  }

  /// POST 요청 헬퍼
  Future<Response<T>> post<T>(
    String path, {
    dynamic data,
    Map<String, dynamic>? query,
    Options? options,
    CancelToken? cancelToken,
  }) {
    return _wrap(
      () => _dio.post<T>(
        path,
        data: data,
        queryParameters: query,
        options: options,
        cancelToken: cancelToken,
      ),
    );
  }

  /// PATCH 요청 헬퍼
  Future<Response<T>> patch<T>(
    String path, {
    dynamic data,
    Map<String, dynamic>? query,
    Options? options,
    CancelToken? cancelToken,
  }) {
    return _wrap(
      () => _dio.patch<T>(
        path,
        data: data,
        queryParameters: query,
        options: options,
        cancelToken: cancelToken,
      ),
    );
  }

  /// DELETE 요청 헬퍼
  Future<Response<T>> delete<T>(
    String path, {
    dynamic data,
    Map<String, dynamic>? query,
    Options? options,
    CancelToken? cancelToken,
  }) {
    return _wrap(
      () => _dio.delete<T>(
        path,
        data: data,
        queryParameters: query,
        options: options,
        cancelToken: cancelToken,
      ),
    );
  }

  /// Dio 요청을 실행하고 `DioException`을 공통 예외 유형으로 변환한다.
  Future<Response<T>> _wrap<T>(Future<Response<T>> Function() request) async {
    try {
      return await request();
    } on DioException catch (error) {
      throw _errorMapper.map(error);
    }
  }

  /// `{ "data": ... }` 형태의 응답에서 내부 데이터를 추출한다.
  ///
  /// - `data` 키가 존재하면 해당 값을 반환한다.
  /// - `data`가 맵 타입이 아니거나 null이면 원본 본문을 그대로 돌려준다.
  /// - 최종적으로 맵이 아니면 빈 맵을 반환한다.
  Map<String, dynamic> unwrapAsMap(Response<dynamic> response) {
    final payload = _maybeUnwrap(response.data);
    if (payload is Map<String, dynamic>) {
      return payload;
    }
    final original = response.data;
    if (original is Map<String, dynamic>) {
      return original;
    }
    return const <String, dynamic>{};
  }

  /// 응답 본문에서 envelope을 제거해 반환한다.
  ///
  /// - `{ "data": [...] }`는 내부 리스트를 돌려준다.
  /// - `data` 구조가 아니면 원본을 그대로 반환한다.
  dynamic unwrap(Response<dynamic> response) => _maybeUnwrap(response.data);

  dynamic _maybeUnwrap(dynamic body) {
    if (body is Map<String, dynamic> && body.containsKey(_dataKey)) {
      final nested = body[_dataKey];
      if (nested != null) {
        return nested;
      }
    }
    return body;
  }
}
