Result<T extends Object?, E extends Object> class sealed

A type-safe way to handle operations that may fail.

Instead of throwing exceptions or returning null, Result represents either a successful value (Ok) or a failure (Err). This makes error handling explicit and composable.

Use Result when:

• You need explicit error handling
• You want to chain operations that might fail
• You need to distinguish between different error types

Example:

Result<int, String> safeDivide(int a, int b) {
  if (b == 0) return Result.err('Cannot divide by zero');
  return Result.ok(a ~/ b);
}

// Usage:
final result = safeDivide(10, 2);
final value = result.unwrapOr(0); // Get value or default