Failure hierarxiyası: tipli xətalar

// ══ lib/domain/failures/failure.dart ══

/// Tətbiqin bütün gözlənilən uğursuzluqları.
/// `sealed` → UI-da switch tam yoxlanılır.
/// `implements Exception` → `Result.error(...)` içində işləyir.
sealed class Failure implements Exception {
  const Failure();
}

// ── Şəbəkə və server ──
final class NetworkFailure extends Failure {
  const NetworkFailure();
}

final class TimeoutFailure extends Failure {
  const TimeoutFailure();
}

final class ServerFailure extends Failure {
  const ServerFailure(this.statusCode);
  final int statusCode;       // diaqnostika üçün saxlanılır
}

// ── Autentifikasiya ──
final class AuthFailure extends Failure {
  const AuthFailure();        // token bitib / etibarsızdır → login
}

final class ForbiddenFailure extends Failure {
  const ForbiddenFailure();   // giriş var, icazə yoxdur → login DEYİL
}

// ── Məlumat ──
final class NotFoundFailure extends Failure {
  const NotFoundFailure();
}

final class InvalidResponseFailure extends Failure {
  const InvalidResponseFailure();   // backend gözlənilməz format göndərdi
}

// ── Biznes qaydaları (sahəyə bağlı ola bilər) ──
final class ValidationFailure extends Failure {
  const ValidationFailure(this.fieldErrors);
  /// sahə adı → xəta açarı (mesaj deyil!)
  final Map<String, String> fieldErrors;
}

final class InsufficientPointsFailure extends Failure {
  const InsufficientPointsFailure({required this.missing});
  final int missing;
}

// ── Bilinməyən: BU VARİANT MƏCBURİDİR ──
final class UnexpectedFailure extends Failure {
  const UnexpectedFailure();
}


// ══ Repository: texniki exception → domain Failure ══
class OrderRepositoryRemote implements OrderRepository {
  @override
  Future<Result<List<Order>>> fetchMine() async {
    try {
      final dtos = await _api.getOrders();
      return Result.ok(dtos.map((d) => d.toDomain()).toList());
    } on SocketException {
      return const Result.error(NetworkFailure());
    } on TimeoutException {
      return const Result.error(TimeoutFailure());
    } on UnauthorizedException {
      return const Result.error(AuthFailure());
    } on ForbiddenException {
      return const Result.error(ForbiddenFailure());
    } on NotFoundException {
      return const Result.error(NotFoundFailure());
    } on ServerException catch (e) {
      return Result.error(ServerFailure(e.statusCode));
    } on FormatException catch (e, st) {
      // Gözlənilən (bizim baqımız deyil), lakin LOQLANMALIDIR.
      _logger.warning('Cavab formatı gözlənilməzdir', e, st);
      return const Result.error(InvalidResponseFailure());
    }
    // `Error` tipləri (RangeError, TypeError) TUTULMUR — onlar baqdır
    // və qlobal xəta tutucusuna qədər qalxmalıdır.
  }
}