dmmulroy/better-result

Health v2 · maintenance only

Adoption not part of the score

1931 stars · 42 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

A lightweight TypeScript library providing a typed Result<T, E> type that makes expected failures explicit in function signatures. It supports generator-based composition with yield* for writing multi-step workflows that short-circuit on the first error, plus tagged errors, async support, and retry utilities.

Use cases

• handle errors explicitly in TypeScript instead of try-catch
• write multi-step async workflows that stop on first failure
• define typed tagged error classes for domain failures
• validate input like parsing a port number with typed errors
• retry flaky async operations with error handling
• map and chain results with ok/err matching

When to choose

• you want Rust-style Result semantics in TypeScript with zero runtime dependencies
• you prefer explicit error types over thrown exceptions for expected failures
• you want generator-based do-notation for sequential error-prone steps
• you need an ESM-only, lightweight alternative to heavier effect libraries

When to avoid

• your codebase relies on exception-based error handling and cannot adopt Result patterns
• you need a full effect system with dependency injection, resources, or structured concurrency
• you target TypeScript older than 5.4 or need CommonJS support

Facets

library · maturity active

error-handling developer-tools web-development programming-languages bun cross-platform result-type typescript functional-programming generator-composition tagged-errors esm-only zero-dependencies nodejs deno

Member repositories

For agents

markdown · JSON · MCP: product_card(name="dmmulroy/better-result")