> [Agent navigation index](/llms.txt)

# Typed results

Use `brix/result` for expected failures callers can handle. Choose the synchronous `Result` workflow or Brix's awaitable `ResultPromise` workflow.

If you arrived here from an API call, begin with [asynchronous outcomes](/docs/results-async.md):
`executeApi` returns a `ResultPromise`, and awaiting it gives you a success or failure to handle.
Use the synchronous guide when designing your own validation or business operation that can fail
without throwing an exception. Neither guide requires converting every function into a Result.

## Handle synchronous outcomes

[Model tagged errors, narrow or match branches, transform values, and chain synchronous work.](/docs/results-synchronous.md)

## Compose asynchronous outcomes

[Consume and adapt `ResultPromise`, use its fluent operations, and test both branches.](/docs/results-async.md)
