Fixed #

• Fixed bug in runSafetyStream where errors were not properly thrown to the stream
• Stream errors are now correctly propagated and can be intercepted by the when extension method

Improvements #

• Error logs now print the stack trace for improved traceability

Updates #

• Error logs now print the stack trace for improved traceability

Documentation Updates #

• Enhanced documentation for synchronous error handling utilities
• Added detailed examples for runSafetySync and runSafetySyncNullable functions
• Added practical code examples for SyncOperationFunction usage
• Improved clarity and completeness of API documentation

Fixed #

• Fixed type error in FutureExtension.when where a Future was incorrectly used as a CustomError

• Fixed critical bug in error handling and renamed genericFromException to fromThrowable for clarity

• Modified error handling to properly handle both Exception and Error types

• Improved robustness of error conversion in the error handling pipeline

Documentation Enhancements #

• Improved documentation for error handling functions in error_catcher.dart
• Added comprehensive examples for CustomErrorAdapter, onErrorHandler, and errorToNullHandler
• Enhanced API documentation with practical use cases and implementation examples

Documentation Improvements #

• Improved documentation for the StreamExtension class
• Added detailed examples to the when method documentation
• Enhanced API documentation with more context and use cases

Enhanced #

• Improved documentation for the CustomError class and its subclasses
• Added comprehensive examples to class documentation

Changes #

• Updated package dependencies
• Minor code improvements

Added #

• First stable release of the catch_and_flow package
• Core CustomError class with GenericError and ErrorFromException implementations
• Result type for functional error handling with success/error pattern
• Safety handlers for different operation types:
  • runSafetyFuture and runSafetyFutureNullable for async operations
  • runSafetyStream and runSafetyStreamNullable for reactive streams
  • runSafetySync and runSafetySyncNullable for synchronous operations
• Extension methods:
  • Future.when() for callback-based future handling with progress, success, and error callbacks
  • Stream.when() for simplified stream subscription with progress, success, and error callbacks
  • Result.when() for functional pattern matching
• Configurable logging system with:
  • Multiple log levels (debug, info, warning, error, none)
  • Custom logger interface for easy integration with existing logging solutions
  • Helper functions for context-aware logging
• Complete API documentation with comprehensive examples
• Optimized error handling with minimal boilerplate code
• Full compatibility with Flutter and Dart projects
• Reliable error transformation and propagation

Changed #

• Improved documentation with detailed usage examples for all components
• Enhanced type safety across all APIs
• Optimized internal error handling mechanisms

Removed #

• Removed experimental features to ensure stability for 1.0.0 release

Initial Release #

• Initial beta release of the catch_and_flow package
• Core CustomError class with GenericError and ErrorFromException implementations
• Result type for functional error handling with success/error pattern
• Basic safety handlers for different operation types
• Extension methods for Future, Stream and Result types
• Configurable logging system
• Initial API documentation with examples