/** * Type-safe Result pattern implementation. * * Implements functional Ok and Err discriminated unions to avoid uncaught runtime exceptions * and enforce explicit error handling in TypeScript. * * Notable: Zero runtime dependencies; provides lightweight helpers (ok, err, isOk, isErr, unwrap). */ export type Ok = { readonly ok: true; readonly value: T }; export type Err = { readonly ok: false; readonly error: E }; export type Result = Ok | Err; export function ok(value: T): Ok { return { ok: true, value }; } export function err(error: E): Err { return { ok: false, error }; } export function isOk(result: Result): result is Ok { return result.ok; } export function isErr(result: Result): result is Err { return !result.ok; } export function unwrap(result: Result): T { if (result.ok) { return result.value; } throw result.error instanceof Error ? result.error : new Error(String(result.error)); } export function unwrapOr(result: Result, fallback: T): T { return result.ok ? result.value : fallback; }