namespace Zentient.Results

Provides extension methods for IResult and IResult<T> enabling fluent conversions and introspection of result state, error data, and metadata. Facilitates seamless transformations between non-generic and generic results and extraction of diagnostic information.

public static IResult<bool> ToBoolResult(this IResult result)

Converts a non-generic IResult into a generic IResult<bool>:

• Success maps to true
• Failure maps to false

Preserves all error information and messages.

Throws ArgumentNullException if result is null.

public static string ToErrorString(this IResult result, string separator = "; ")

Concatenates all error messages from a failure result into a single string separated by the specified delimiter.

Throws ArgumentNullException if result is null.

public static string? FirstErrorMessage(this IResult result)

Retrieves the message from the first error in a failure result, or null if none exists.

Throws ArgumentNullException if result is null.

These extension methods improve developer ergonomics for common operations:

• Bridging non-generic and generic results seamlessly (ToBoolResult)
• Generating human-readable error diagnostics (ToErrorString, FirstErrorMessage)
• Ensuring consistent handling across logging, telemetry, and transport layers

var operationResult = someService.PerformAction();

IResult<bool> boolResult = operationResult.ToBoolResult();

if (boolResult.IsFailure)
{
    logger.LogWarning("Operation failed with errors: " + operationResult.ToErrorString());
}