Result vs Either (fpdart)

// ══════ RESULT (rəsmi pattern) ══════
abstract interface class OrderRepository {
  Future<Result<List<Order>>> fetchMine();
}

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());
    }
  }
}

// Notifier-də:
state = switch (await _repository.fetchMine()) {
  Ok(:final value) => OrdersState.loaded(value),
  Error(:final error) => OrdersState.failed(error),
};


// ══════ EITHER (fpdart) ══════
import 'package:fpdart/fpdart.dart';

abstract interface class OrderRepository {
  // Left = Failure, Right = uğur. Sıra konvensiyadır.
  Future<Either<Failure, List<Order>>> fetchMine();
}

class OrderRepositoryRemote implements OrderRepository {
  @override
  Future<Either<Failure, List<Order>>> fetchMine() async {
    try {
      final dtos = await _api.getOrders();
      // `Either.of` Right (uğur) yaradır.
      return Either.of(dtos.map((d) => d.toDomain()).toList());
    } on SocketException {
      return Either.left(const NetworkFailure());
    }
  }
}

// Notifier-də, variant 1 — fpdart-ın `match`-i:
state = (await _repository.fetchMine()).match(
  (failure) => OrdersState.failed(failure),
  (orders) => OrdersState.loaded(orders),
);

// Notifier-də, variant 2 — Dart-ın öz pattern-ləri:
state = switch (await _repository.fetchMine()) {
  Left(value: final failure) => OrdersState.failed(failure),
  Right(value: final orders) => OrdersState.loaded(orders),
};


// ══════ EITHER-in əsl gücü: kompozisiya ══════
// Ardıcıl əməliyyatlar `flatMap` ilə zəncirlənir; ilk uğursuzluqda
// zəncir dayanır və `Left` dəyəri sona qədər daşınır.
Future<Either<Failure, Receipt>> checkout(Cart cart) async {
  final reserved = await _inventory.reserve(cart);

  return reserved.flatMap((reservation) {
    // Bu blok yalnız `reserved` Right olduqda işləyir.
    return _pricing
        .quote(reservation)
        .map((quote) => Receipt(reservation: reservation, quote: quote));
  });
}

// Müqayisə üçün: `mapLeft` xətanı çevirir, dəyərə toxunmur.
final Either<String, List<Order>> forLogging =
    (await _repository.fetchMine()).mapLeft((f) => f.runtimeType.toString());