namespace Zentient.Results

Provides fluent, expressive side-effect extension methods for IResult and IResult<T>. These enable conditional execution of actions—such as logging, metrics, or notifications—without mutating the result or disrupting the functional chain.

var result = DoSomething()
    .OnSuccess(() => Log.Information("Success!"))
    .OnFailure(errors => Log.Error("Failure: {Errors}", errors));

var result = GetUser()
    .OnSuccess(user => Audit(user))
    .OnFailure(errs => AlertAdmin(errs));

Executes onSuccess only if the non-generic IResult is successful.

🔒 Throws ArgumentNullException if result or onSuccess is null.

Executes onSuccess only if the generic result is successful, passing the success value.

🔒 Throws ArgumentNullException if any argument is null.

Executes onFailure only if the result indicates failure, passing the full error list.

🔒 Throws ArgumentNullException if any argument is null.

Executes onFailure only if the generic result is failure, passing the error list.

🔒 Throws ArgumentNullException if any argument is null.

return SomeOperation()
    .OnSuccess(() => logger.Log("All good"))
    .OnFailure(errors => logger.Warn("Failed: {0}", string.Join(", ", errors)));