# vultix/ts-results

A typescript implementation of Rust's Result object.

Repository: https://github.com/vultix/ts-results
Canonical: https://ross.abutalabs.com/products/ts-results
Language: TypeScript
License: MIT
License Family: permissive
Last push: 2024-04-15T19:33:23+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 2759, "days_push": 870, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1407, forks 75 (observed 2026-08-28T04:04:38.461625+00:00)

## What it is
A TypeScript library implementing Rust's Result and Option types, bringing compile-time error checking and explicit optional values to TypeScript. It provides Ok/Err and Some/None variants with combinators like map, andThen, and Result.all, plus rxjs integration helpers.

## Use cases
- handle errors without exceptions in typescript
- make nullable values explicit with an Option type
- force callers to check for failure at compile time
- chain fallible operations with map and andThen
- combine multiple results with Result.all or Result.any
- replace string | undefined returns with typed optionals

## When to choose
- you want Rust-style explicit error handling in a TypeScript codebase
- your team wants compile-time enforcement of error and null checks
- you use rxjs and want result-aware operators

## When to avoid
- you prefer idiomatic TypeScript with exceptions and union types
- your project is very small and the extra abstraction adds overhead
- you need a full functional programming toolkit rather than just Result/Option

## Facets
- artifact type: library
- maturity: stable
- function: error-handling, type-system
- domain: developer-tools, programming-languages, web-development
- platform: cross-platform
- tags: rust-result, option-type, typescript, monad, typed-errors, functional-programming, nodejs

## Member repositories
- vultix/ts-results (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:38.461625+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:38:40.212688+00:00, confidence not recorded.
  - readme: https://github.com/vultix/ts-results (fetched 2026-08-28T04:04:38.461625+00:00, sha d246fc517810)
  - registry_npm: https://registry.npmjs.org/ts-results (fetched 2026-08-29T11:52:23.232956+00:00, sha 8bd4344e732e)
- Data as of 2026-08-30T08:39:29.467469+00:00.