worker/lib/core/errors/failures.dart

/// Failure classes for error handling in the Worker app
///
/// Failures represent domain-level errors that can be returned from use cases
/// and repositories. They wrap exceptions and provide user-friendly error messages.
library;

/// Base failure class
sealed class Failure {
  const Failure({required this.message});

  /// Network-related failure
  const factory Failure.network({required String message, int? statusCode}) =
      NetworkFailure;

  /// Server error failure (5xx errors)
  const factory Failure.server({required String message, int? statusCode}) =
      ServerFailure;

  /// Authentication failure
  const factory Failure.authentication({
    required String message,
    int? statusCode,
  }) = AuthenticationFailure;

  /// Validation failure
  const factory Failure.validation({
    required String message,
    Map<String, List<String>>? errors,
  }) = ValidationFailure;

  /// Not found failure (404)
  const factory Failure.notFound({required String message}) = NotFoundFailure;

  /// Conflict failure (409)
  const factory Failure.conflict({required String message}) = ConflictFailure;

  /// Rate limit exceeded failure (429)
  const factory Failure.rateLimit({required String message, int? retryAfter}) =
      RateLimitFailure;

  /// Payment failure
  const factory Failure.payment({
    required String message,
    String? transactionId,
  }) = PaymentFailure;

  /// Cache failure
  const factory Failure.cache({required String message}) = CacheFailure;

  /// Storage failure
  const factory Failure.storage({required String message}) = StorageFailure;

  /// Parse failure
  const factory Failure.parse({required String message}) = ParseFailure;

  /// No internet connection failure
  const factory Failure.noInternet() = NoInternetFailure;

  /// Timeout failure
  const factory Failure.timeout() = TimeoutFailure;

  /// Unknown failure
  const factory Failure.unknown({required String message}) = UnknownFailure;

  final String message;

  /// Check if this is a critical failure that requires immediate attention
  bool get isCritical {
    return switch (this) {
      ServerFailure() => true,
      AuthenticationFailure() => true,
      PaymentFailure() => true,
      UnknownFailure() => true,
      _ => false,
    };
  }

  /// Check if this failure can be retried
  bool get canRetry {
    return switch (this) {
      NetworkFailure() => true,
      ServerFailure(:final statusCode) => statusCode == 503,
      AuthenticationFailure(:final statusCode) => statusCode == 401,
      RateLimitFailure() => true,
      CacheFailure() => true,
      NoInternetFailure() => true,
      TimeoutFailure() => true,
      _ => false,
    };
  }

  /// Get HTTP status code if available
  int? get statusCode {
    return switch (this) {
      NetworkFailure(:final statusCode) => statusCode,
      ServerFailure(:final statusCode) => statusCode,
      AuthenticationFailure(:final statusCode) => statusCode,
      _ => null,
    };
  }

  /// Get user-friendly error message
  String getUserMessage() {
    return switch (this) {
      ValidationFailure(:final message, :final errors) =>
        _formatValidationMessage(message, errors),
      RateLimitFailure(:final message, :final retryAfter) =>
        _formatRateLimitMessage(message, retryAfter),
      NoInternetFailure() =>
        'Không có kết nối internet. Vui lòng kiểm tra kết nối của bạn.',
      TimeoutFailure() => 'Kết nối quá lâu. Vui lòng thử lại.',
      _ => message,
    };
  }

  String _formatValidationMessage(
    String message,
    Map<String, List<String>>? errors,
  ) {
    if (errors != null && errors.isNotEmpty) {
      final firstError = errors.values.first.first;
      return '$message: $firstError';
    }
    return message;
  }

  String _formatRateLimitMessage(String message, int? retryAfter) {
    if (retryAfter != null) {
      return '$message Thử lại sau $retryAfter giây.';
    }
    return message;
  }
}

/// Network-related failure
final class NetworkFailure extends Failure {
  const NetworkFailure({required super.message, this.statusCode});

  @override
  final int? statusCode;
}

/// Server error failure (5xx errors)
final class ServerFailure extends Failure {
  const ServerFailure({required super.message, this.statusCode});

  @override
  final int? statusCode;
}

/// Authentication failure
final class AuthenticationFailure extends Failure {
  const AuthenticationFailure({required super.message, this.statusCode});

  @override
  final int? statusCode;
}

/// Validation failure
final class ValidationFailure extends Failure {
  const ValidationFailure({required super.message, this.errors});

  final Map<String, List<String>>? errors;
}

/// Not found failure (404)
final class NotFoundFailure extends Failure {
  const NotFoundFailure({required super.message});
}

/// Conflict failure (409)
final class ConflictFailure extends Failure {
  const ConflictFailure({required super.message});
}

/// Rate limit exceeded failure (429)
final class RateLimitFailure extends Failure {
  const RateLimitFailure({required super.message, this.retryAfter});

  final int? retryAfter;
}

/// Payment failure
final class PaymentFailure extends Failure {
  const PaymentFailure({required super.message, this.transactionId});

  final String? transactionId;
}

/// Cache failure
final class CacheFailure extends Failure {
  const CacheFailure({required super.message});
}

/// Storage failure
final class StorageFailure extends Failure {
  const StorageFailure({required super.message});
}

/// Parse failure
final class ParseFailure extends Failure {
  const ParseFailure({required super.message});
}

/// No internet connection failure
final class NoInternetFailure extends Failure {
  const NoInternetFailure() : super(message: 'Không có kết nối internet');
}

/// Timeout failure
final class TimeoutFailure extends Failure {
  const TimeoutFailure() : super(message: 'Kết nối quá lâu');
}

/// Unknown failure
final class UnknownFailure extends Failure {
  const UnknownFailure({required super.message});
}