@repo/safe

@repo/safe is a Go-inspired result type used throughout the stack for explicit error handling. It exports discriminated union types Safe<T>, SafeSuccess<T>, and SafeError, along with the safe() wrapper function (handles sync and async), safeSuccess(), safeError(), and unwrap().

Dependencies

graph TD
  safe["@repo/safe"] --> errors["@repo/errors"]
  safe -.-> typescript_config["@repo/typescript-config"]
  safe -.-> vitest_config["@repo/vitest-config"]

Usage

import { safe, unwrap, type Safe } from "@repo/safe";

// Wrap any function call
const result = await safe(async () => {
  return await fetchData();
});

if (result.error) {
  console.error(result.error.message);
  return;
}

console.log(result.data);

// Or unwrap to throw on error
const data = unwrap(result);
Copy

Scripts