// 어디서 예외가 발생할지 알 수 없음
int GetUserAge(string username)
{
    if (username == "john") return 25;
    throw new UserNotFoundException(username); // 숨겨진 제어 흐름
}

// 반환 타입에 오류 가능성이 명시됨
Errable<int> GetUserAge(string username)
{
    if (username == "john") return 25;
    return Errable.For<int>()
        .Code("USER_NOT_FOUND")
        .Error($"User '{username}' not found"); // 값으로 반환
}

// 사용자 나이를 반환하는 함수 (예외를 던지지 않고 오류를 값으로 반환)
Errable<int> GetUserAge(string username)
{
    if (username == "john")
        return 25; // ✅ 성공 시 값을 직접 반환 (암시적 변환)

    // ✅ 실패 시에도 예외를 던지지 않고 오류를 값으로 반환
    return Errable.For<int>()
        .Code("USER_NOT_FOUND")
        .With("username", username)
        .Errorf("User '{0}' not found", username);
}

// 함수 사용: 반환 타입을 보면 오류가 발생할 수 있음을 즉시 알 수 있음
var ageResult = GetUserAge("unknown");

// 패턴 매칭으로 성공/실패 케이스를 명시적으로 처리
var message = ageResult.Match(
    onSuccess: age => $"User's age is {age}.",
    onError: error => $"Operation failed: {error.Error()}"
);

// message: "Operation failed: User 'unknown' not found"

IError richError = Errable.Code("AUTH_FAILED")
    .In("auth-service")
    .Tags("security", "authentication")
    .With("userId", 123)
    .With("attemptCount", 3)
    .Public("Login failed. Please check your credentials.")
    .Errorf("Authentication failed for user {0}", "john");

// 생성된 오류는 다양한 인터페이스로 캐스팅하여 상세 정보에 접근할 수 있습니다.
var coder = (IErrorCoder)richError;
// coder.Code -> "AUTH_FAILED"

var contextProvider = (IErrorContextProvider)richError;
// contextProvider.Context["userId"] -> 123

// 데이터베이스 계층 - 예외를 값으로 변환
Errable<string> DatabaseQuery(string sql)
{
    var dbException = new InvalidOperationException("Connection timeout");
    // ✅ 예외를 Error as Value로 변환하여 반환
    return Errable.For<string>()
        .Code("DB_TIMEOUT")
        .Wrap(dbException, "Database query failed");
}

// 서비스 계층 - 오류를 명시적으로 체크하고 전파
Errable<string> ServiceCall(int userId)
{
    var dbResult = DatabaseQuery($"SELECT * FROM Users WHERE Id = {userId}");

    // ✅ 반환 타입으로 오류 가능성이 명시되므로 체크를 잊을 수 없음
    if (dbResult.IsError)
    {
        // 데이터베이스 오류를 감싸서 서비스 컨텍스트 추가
        return Errable.For<string>()
            .Code("SERVICE_ERROR")
            .With("userId", userId)
            .Cause(dbResult.Error) // 하위 오류를 원인으로 지정
            .Errorf("Failed to retrieve user {0}", userId);
    }
    return dbResult.Value;
}

var result = ServiceCall(123);

// 오류 체인을 통해 근본 원인까지 추적 가능
// result.Error.Cause를 통해 내부 오류에 접근 가능

// 복잡한 결제 시나리오 시뮬레이션
private Errable<PaymentResult> SimulatePaymentProcessing(string orderId, decimal amount)
{
    try
    {
        // 외부 게이트웨이 호출 실패 시뮬레이션
        throw new HttpRequestException("Gateway timeout");
    }
    catch (Exception ex)
    {
        // Errable.For<T>() 덕분에 반환 타입을 명시할 필요가 없습니다.
        return Errable.For<PaymentResult>()
            .Code("PAYMENT_GATEWAY_ERROR")
            .In("payment-processing")
            .Tags("payment", "gateway", "critical")
            .With("orderId", orderId)
            .With("amount", amount)
            .Public("Payment processing is temporarily unavailable")
            .Wrap(ex, $"Failed to process payment for order {orderId}");
    }
}