fabrik_result 1.1.0

A lightweight toolkit for functional-style types like Either, built for clarity and real-world use.

Changelog

All notable changes to this package are documented in this file.

The format is based on Keep a Changelog, and this project adheres to semantic versioning.

---

1.1.0

A purely additive release. Nothing was removed or renamed, so upgrading from 1.0.x requires no code changes.

Either

• New: map — transform the success value, leaving a Left untouched
• New: mapLeft — transform the failure value, leaving a Right untouched
• New: flatMap / flatMapAsync — chain fallible operations without nesting fold calls
• New: getOrElse — read the success value with a fallback for the failure case
• New: swap — exchange the Left and Right sides
• New: Either.tryCatch / Either.tryCatchAsync — run throwing code and capture the exception as a Left, replacing hand-written try/catch at API and parsing boundaries

Option

• New: Option.fromNullable / toNullable — bridge between Option and Dart's nullable types, useful when reading JSON and other loosely typed data
• New: map, flatMap, getOrElse, where — the same ergonomics as Either
• New: toEither — convert a missing value into a typed failure

Tooling

• Switched dev dependencies from flutter_test to package:test and from flutter_lints to lints — the package is pure Dart and can now be developed and tested with the Dart SDK alone, no Flutter install required
• Tests now import the public package:fabrik_result/fabrik_result.dart rather than reaching into src/
• Test suite grown from 24 to 80 tests

---

1.0.1

• Fix: Added == and hashCode to Left, Right, Some, and None — value equality was broken (right(42) == right(42) previously returned false)
• Fix: Removed Flutter as a runtime dependency — fabrik_result is pure Dart and now works in any Dart project, not just Flutter apps
• Added equality test coverage for all four types

---

1.0.0

This is a major, stabilizing release that defines the long-term scope and philosophy of fabrik_result.

The package has been refined to provide a minimal, explicit, and predictable result-handling toolkit for Dart and Flutter applications, without introducing unnecessary functional abstractions.

Added

• Either<L, R> for explicit success and failure modeling
  • Left and Right sealed variants
  • fold for exhaustive handling
  • Convenience helpers for common access patterns:
    • onRight
    • onLeft
    • rightOrNull
    • leftOrNull
• Option<T> for modeling presence or absence of a value
  • Some and None sealed variants
  • fold, isSome, and isNone
  • Factory helpers some() and none()
• Unit type as a typed replacement for void
  • Singleton unit instance for ergonomic usage
• Comprehensive documentation and examples
• Full test coverage for all core types

---

0.1.1

• Fixed repository URL
• Minor documentation corrections

---

0.1.0

• Initial public release
• Introduced Either<L, R> with Left, Right, and fold
• Introduced Unit as a typed alternative to void