Result

A lightweight, type-safe Result pattern implementation for robust error handling in TypeScript.

• 🚀 Zero dependencies
• 🛡️ Type-safe error handling
• 🔄 Functional piping (sync/async)
• 🛠️ Rich utility set (map, chain, combine, etc.)
• 🌐 Boundary-safe check for cross-context results

Installation

npm install @collidor/result

Basic Usage

import { Result } from "@collidor/result";

function divide(a: number, b: number): Result<number, string> {
  if (b === 0) {
    return Result.err("Division by zero");
  }
  return Result.ok(a / b);
}

const res = divide(10, 2);
if (res.success) {
  console.log(res.value); // 5
} else {
  console.error(res.error); // "Division by zero"
}

Features

Creating Results

• Result.ok(value): Creates a successful result.
• Result.err(error): Creates a failure result.
• Result.none(): Shortcut for a failed result with null error.
• Result.try(() => ...): Wraps a function that might throw.
• Result.from(value | Error): Converts a value or Error object to a Result.
• Result.fromPromise(promise): Wraps a promise, catching rejections into a Result.

Working with Results

• Result.isResult(thing): Boundary-safe check if a value is a Result object.
• Result.unwrap(result): Returns the value or throws a re-hydrated Error.
• Result.getOrElse(result, defaultValue): Returns value or a default.
• Result.map(result, fn): Transforms the value if successful.
• Result.chain(result, fn): Chains another Result-returning function.
• Result.combine(results[]): Combines multiple results into one (all-or-nothing).

Functional Piping

Piping allows you to chain operations cleanly:

const result = Result.pipe(
  Result.ok(10),
  (n) => n * 2,
  (n) => Result.ok(n + 5),
  (n) => n.toString()
);
// Result.ok("25")

For asynchronous operations:

const result = await Result.pipeAsync(
  Result.ok(10),
  async (n) => n * 2,
  (n) => Promise.resolve(Result.ok(n + 5))
);

API Documentation

Types

• Result<T, E>: The main type, union of Ok<T, E> and Err<E, T>.
• Unwrap<T>: Helper type to infer the value type from a Result or Promise<Result>.

Result Static Methods

Contribution

1. Fork repository
2. Create feature branch
3. Commit changes
4. Push to branch
5. Create new Pull Request

License

MIT © Alykam Burdzaki