op_result 0.3.1

op_result: ^0.3.1 copied to clipboard

Maintenance #

• Fixed outdated samples previously in the README.
• Moved all README code samples into example/op_result_example.dart for easier maintenance.
• Added automated test test/op_result_example_test.dart to ensure examples stay valid and error-free.
• No functional changes to the library code.

Breaking Changes #

• Refactored OpResult<T> to remove E extends Enum

  • OpResult no longer requires an error type at the class level. Errors are now enforced as enums only at failure creation.
  • Before:

  OpResult<T, E extends Enum>
  

  • Now:

  OpResult<T>
  

  • This allows returning any error type (e.g., validation and API errors) in the result.

• Breaking change in failure() constructor

  • failure() only accepts a single error.
  • multipleFailures() must be used to pass a list of errors.
  • Before:

    OpResult.failure([error1, error2]); 
    

  • Now:

    OpResult.multipleFailures([error1, error2]); 
    

  • This ensures strong typing while allowing flexibility in OpResult.

• Breaking change: OpResultError has been renamed to OpError.

Maintenance #

• Bumped version to 0.2.2 for consistency and dependency updates.
• No functional changes.

Initial Public Release #

• Added support for nullable success values (T?) in OpResult.success()
• Improved failure handling by supporting both single and multiple errors
• Refactored OpResult.success() to use a positional argument instead of a named parameter

Breaking Changes #

• Refactored OpResult.success() to use a positional argument instead of data:
  • Now, call OpResult.success(value) instead of OpResult.success(data: value).
  • Example:
    • Before: OpResult.success(data: user);
    • Now: OpResult.success(user);
• Refactored OpResult to support multiple errors:
  • Replaced _error (single error) with _errors (list of errors).
  • OpResult.failure() now supports both single and multiple errors via a factory constructor:
    • OpResult.failure(singleError)
    • OpResult.failure([multipleErrors])

Improvements #

• Unified failure handling:
  • Removed OpResult.failure({required OpResultError<E> error}) in favor of a flexible factory constructor.
  • Supports passing either a single error or a list of errors dynamically.
• Ensured failure() cannot receive an empty list, preventing invalid states.
• Refactored error access:
  • error → Returns the first error (default for single-error scenarios).
  • errors → Provides full access to all errors when multiple exist.

• Initial version.