anthropic-client/src/AnthropicClient/Models/AnthropicResult.cs

using AnthropicClient.Models;

/// <summary>
/// Represents the result of an Anthropic API operation.
/// </summary>
/// <typeparam name="T">The type of the result value.</typeparam>
public class AnthropicResult<T>
{
  /// <summary>
  /// The value of the result.
  /// </summary>
  public T Value { get; }

  /// <summary>
  /// The error of the result.
  /// </summary>
  public AnthropicError Error { get; }

  /// <summary>
  /// Indicates whether the operation was successful.
  /// </summary>
  public bool IsSuccess { get; }

  /// <summary>
  /// The request ID of the operation.
  /// </summary>
  public AnthropicHeaders Headers { get; }

  /// <summary>
  /// Initializes a new instance of the <see cref="AnthropicResult{T}"/> class.
  /// </summary>
  /// <param name="value">The value of the result.</param>
  /// <param name="error">The error of the result.</param>
  /// <param name="isSuccess">Indicates whether the operation was successful.</param>
  /// <param name="headers">The Anthropic headers for the result.</param>
  /// <returns>A new instance of the <see cref="AnthropicResult{T}"/> class.</returns>
  protected AnthropicResult(T value, AnthropicError error, bool isSuccess, AnthropicHeaders headers)
  {
    Value = value;
    Error = error;
    IsSuccess = isSuccess;
    Headers = headers;
  }

  /// <summary>
  /// Creates a successful result.
  /// </summary>
  /// <param name="value">The value of the result.</param>
  /// <param name="headers">The Anthropic headers for the result.</param>
  /// <returns>A new instance of the <see cref="AnthropicResult{T}"/> class.</returns>
  public static AnthropicResult<T> Success(T value, AnthropicHeaders headers)
  {
    return new AnthropicResult<T>(value, null!, true, headers);
  }

  /// <summary>
  /// Creates a failed result.
  /// </summary>
  /// <param name="error">The error of the result.</param>
  /// <param name="headers">The Anthropic headers for the result.</param>
  /// <returns>A new instance of the <see cref="AnthropicResult{T}"/> class.</returns>
  public static AnthropicResult<T> Failure(AnthropicError error, AnthropicHeaders headers)
  {
    return new AnthropicResult<T>(default!, error, false, headers);
  }
}