bloc 8.0.2

A predictable state management library that helps implement the BLoC (Business Logic Component) design pattern.

8.0.2

• fix: make onChange and addError protected (#3071)
• refactor: use late keyword for internal state controller (#3100)
• refactor: add isClosed to Closable (#3066)
• refactor: add core interfaces (#3012)
• refactor: internal reorganization (#3011)
• docs: update example to follow naming conventions (#3029)

8.0.1

• fix: allow emit usage within tests (#2982)

8.0.0

• BREAKING: feat: introduce BlocOverrides API (#2932)
  • Bloc.observer removed in favor of BlocOverrides.runZoned and BlocOverrides.current.blocObserver
  • Bloc.transformer removed in favor of BlocOverrides.runZoned and BlocOverrides.current.eventTransformer
• BREAKING: refactor: make BlocObserver an abstract class
• BREAKING: feat: add throws StateError when bloc is closed (#2912)
• BREAKING: feat: emit throws StateError when bloc is closed (#2913)
• BREAKING: feat: improve error handling/reporting
  • BlocUnhandledErrorException is removed
  • Uncaught exceptions are always reported to onError and rethrown
  • addError reports error to onError but does not propagate as an uncaught exception
• BREAKING: feat: restrict scope of emit in Bloc and Cubit
  • In Cubit, emit is protected so it can only be used within the Cubit instance.
  • In Bloc, emit is internal so it cannot be used outside of the internal package implementation.
• BREAKING: refactor: remove deprecated TransitionFunction
• BREAKING: refactor: remove deprecated transformEvents
• BREAKING: refactor: remove deprecated mapEventToState
• BREAKING: refactor: remove deprecated transformTransitions
• BREAKING: refactor: remove deprecated listen on BlocBase
• feat: throw StateError if an event is added without a registered event handler

8.0.0-dev.5

• BREAKING: feat: introduce BlocOverrides API (#2932)
  • Bloc.observer removed in favor of BlocOverrides.runZoned and BlocOverrides.current.blocObserver
  • Bloc.transformer removed in favor of BlocOverrides.runZoned and BlocOverrides.current.eventTransformer
• BREAKING: refactor: make BlocObserver an abstract class
• BREAKING: feat: add throws StateError when bloc is closed (#2912)
• BREAKING: feat: emit throws StateError when bloc is closed (#2913)

8.0.0-dev.4

• BREAKING: feat: improve error handling/reporting
  • BlocUnhandledErrorException is removed
  • Uncaught exceptions are always reported to onError and rethrown
  • addError reports error to onError but does not propagate as an uncaught exception

8.0.0-dev.3

• BREAKING: feat: restrict scope of emit in Bloc and Cubit
  • In Cubit, emit is protected so it can only be used within the Cubit instance.
  • In Bloc, emit is internal so it cannot be used outside of the internal package implementation.

8.0.0-dev.2

• BREAKING: refactor: remove deprecated listen on BlocBase

8.0.0-dev.1

• BREAKING: refactor: remove deprecated TransitionFunction
• BREAKING: refactor: remove deprecated transformEvents
• BREAKING: refactor: remove deprecated mapEventToState
• BREAKING: refactor: remove deprecated transformTransitions
• feat: throw StateError if an event is added without a registered event handler

7.2.1

• fix: on<E extends Event> should have an EventTransformer<E> instead of EventTransformer<Event>

7.2.0

• feat: introduce on<Event> API to register event handlers
  • by default events are processed concurrently
• feat: introduce Bloc.transformer API to configure the default EventTransformer
• feat: introduce Emitter<State> to trigger state changes
  • call to trigger a state change (alignment with Cubit)
  • forEach as an analogue for await for
  • onEach to simplify subscription management
  • isDone to abort expensive async operations
• feat: throw StateError if mapEventToState is used in conjunction with on<Event>
• feat: throw StateError if duplicate event handlers are registered
• feat: throw AssertionError when emit is called in a completed EventHandler
• feat: throw AssertionError when emit.onEach and emit.forEach are unawaited
• DEPRECATE: fix: mapEventToState deprecated in favor of on<Event>
• DEPRECATE: fix: transformEvents deprecated in favor of EventTransformer
  • use a built in EventTransformer or define your own
• DEPRECATE: fix: transformTransitions deprecated
  • override Stream<State> get stream to modify the outbound stream

7.2.0-dev.3

• BREAKING: refactor: require emit.forEach onData to be synchronous
• refactor: minor internal optimizations in on<Event> implementation

7.2.0-dev.2

• BREAKING: refactor!: make onData callback in emit.onEach and emit.forEach named
• BREAKING: feat!: rename emit.isCanceled to emit.isDone to encapsulate completion and cancelation
• feat: introduce optional onError in emit.onEach and emit.forEach
• feat: throw AssertionError when emit is called in a completed EventHandler
• feat: throw AssertionError when emit.onEach and emit.forEach are unawaited
• fix: emit.onEach and emit.forEach error propagation when stream emits an error

7.2.0-dev.1

• feat: introduce on<Event> API to register event handlers
  • by default events are processed concurrently
• feat: introduce Bloc.transformer API to configure the default EventTransformer
• feat: introduce Emitter<State> to trigger state changes
  • call to trigger a state change (alignment with Cubit)
  • forEach as an analogue for await for
  • onEach to simplify subscription management
  • isCanceled to abort expensive async operations
• feat: throw StateError if mapEventToState is used in conjunction with on<Event>
• feat: throw StateError if duplicate event handlers are registered
• DEPRECATE: fix: mapEventToState deprecated in favor of on<Event>
• DEPRECATE: fix: transformEvents deprecated in favor of EventTransformer
  • use a built in EventTransformer or define your own
• DEPRECATE: fix: transformTransitions deprecated
  • override Stream<State> get stream to modify the outbound stream

7.1.0

• feat: expose isClosed getter on BlocBase
• refactor: simplify internal event controller initialization
• docs: update onChange description in README
• docs: update GetStream sponsorship urls

7.0.0

• BREAKING: refactor: Bloc and Cubit extend BlocBase
  • refactor: void onError(Cubit cubit, Object error, StackTrace stackTrace) -> void onError(BlocBase bloc, Object error, StackTrace stackTrace)
  • refactor: void onCreate(Cubit cubit) -> void onCreate(BlocBase bloc)
  • refactor: void onClose(Cubit cubit) -> void onClose(BlocBase bloc)
• BREAKING: refactor: Bloc and Cubit do not extend Stream and implement Sink
  • refactor: use bloc.stream or cubit.stream to access Stream<State>
    • myBloc.map(...) -> myBloc.stream.map(...)
  • refactor: deprecate bloc.listen in favor of bloc.stream.listen
• BREAKING: refactor: CubitUnhandledErrorException -> BlocUnhandledErrorException
• BREAKING: opt into null safety
  • feat!: upgrade Dart SDK constraints to >=2.12.0-0 <3.0.0
• fix: transformEvents multiple subscriptions issue
• test: improve testing for advanced transformEvents behavior
• chore: bump to meta: ^1.3.0

7.0.0-nullsafety.4

• BREAKING: refactor: Bloc and Cubit extend BlocBase
  • refactor: void onError(Bloc bloc, Object error, StackTrace stackTrace) -> void onError(BlocBase bloc, Object error, StackTrace stackTrace)
  • refactor: void onCreate(Bloc bloc) -> void onCreate(BlocBase bloc)
  • refactor: void onClose(Bloc bloc) -> void onClose(BlocBase bloc)
• BREAKING: refactor: Bloc and Cubit do not extend Stream and implement Sink
  • refactor: use bloc.stream or cubit.stream to access Stream<State>
    • myBloc.map(...) -> myBloc.stream.map(...)
  • refactor: deprecate bloc.listen in favor of bloc.stream.listen
• BREAKING: revert: refactor: Change and onChange removed in favor of Transition and onTransition

7.0.0-nullsafety.3

• fix: transformEvents multiple subscriptions issue
• test: improve testing for advanced transformEvents behavior

7.0.0-nullsafety.2

• chore: bump to meta: ^1.3.0

7.0.0-nullsafety.1

• BREAKING: refactor: Cubit extends Bloc
  • refactor: Change and onChange removed in favor of Transition and onTransition
  • refactor: void onError(Cubit cubit, Object error, StackTrace stackTrace) -> void onError(Bloc bloc, Object error, StackTrace stackTrace)
  • refactor: void onCreate(Cubit cubit) -> void onCreate(Bloc bloc)
  • refactor: void onClose(Cubit cubit) -> void onClose(Bloc bloc)
  • refactor: CubitUnhandledErrorException -> BlocUnhandledErrorException

7.0.0-nullsafety.0

• BREAKING: opt into null safety
• feat!: upgrade Dart SDK constraints to >=2.12.0-0 <3.0.0

6.1.3

• fix: transformEvents multiple subscriptions issue due to v6.1.2

6.1.2

• fix: bloc memory leak due to internal event stream being a broadcast stream

6.1.1

• fix: close should always emit done

6.1.0

• feat: add onCreate and onClose to BlocObserver

6.0.3

• docs: README updates to include flow diagrams for Bloc and Cubit.

6.0.2

• refactor: cubit internal memory and performance optimizations

6.0.1

• docs: minor documentation fixes and improvements

6.0.0

• BREAKING: do not emit current state on subscription
• BREAKING: onError in BlocObserver takes a Cubit as first parameter
• BREAKING: allow blocs and cubits to emit the initial state
• feat: include cubit and remove external dependency on package:cubit
  • exports class Cubit
  • exports class Change (Transition for Cubit)
• feat: onChange added to BlocObserver
• refactor: apply additional lint rules
• fix: add @visibleForTesting to emit on class Cubit
• docs: fix inline documentation references

6.0.0-dev.2

• fix: add @visibleForTesting to emit on class Cubit

6.0.0-dev.1

• BREAKING: do not emit current state on subscription
• BREAKING: onError in BlocObserver takes a Cubit as first parameter
• BREAKING: allow blocs and cubits to emit the initial state
• feat: include cubit and remove external dependency on package:cubit
  • exports class Cubit
  • exports class Change (Transition for Cubit)
• feat: onChange added to BlocObserver
• refactor: apply additional lint rules
• docs: fix inline documentation references

5.0.1

• fix: upgrade to cubit ^0.1.2
• docs: minor documentation updates

5.0.0

• BREAKING: remove initialState override in favor of providing the initial state via super (#1304).
• BREAKING: Remove BlocSupervisor and rename BlocDelegate to BlocObserver.
• feat: support null states (#1312).
• refactor: bloc to extend cubit rather than Stream.
• feat: ignore newly added events after bloc is closed (#1236).
• feat: add addError to conform to EventSink interface.
• feat: mark onError, onTransition, onEvent as protected.
• docs: documentation improvements
• docs: logo updates

5.0.0-dev.11

• feat: add addError to conform to EventSink interface.
• feat: mark onError, onTransition, onEvent as protected.

5.0.0-dev.10

• docs: additional minor improvement to bloc logo alignment

5.0.0-dev.9

• docs: minor improvement to bloc logo alignment

5.0.0-dev.8

• BREAKING: Remove BlocSupervisor and rename BlocDelegate to BlocObserver.

5.0.0-dev.7

• Ignore newly added events after bloc is closed (#1236).

5.0.0-dev.6

• Additional documentation optimizations.

5.0.0-dev.5

• Optimize documentation assets for smaller viewports.

5.0.0-dev.4

• Update to cubit ^0.0.13
• Update documentation and static assets.

5.0.0-dev.3

• Update documentation and static assets.

5.0.0-dev.2

• BREAKING: update initialState to be a required positional parameter (related issue).

5.0.0-dev.1

• BREAKING: remove initialState override in favor of providing the initial state via super (#1304).
• feat: support null states (#1312).
• refactor: bloc to extend cubit rather than Stream.

4.0.0

• Remove rxdart dependency (#821)
• Replace transformStates with transformTransitions (#840)
• Fix null stackTrace in onError (#963)
• Fix remove duplicate terminating state
• Add mustCallSuper to onEvent, onTransition, and onError
• Surface Unhandled Bloc Errors in Debug Mode
• Internal testing improvements

4.0.0-dev.4

• Surface Unhandled Bloc Errors in Debug Mode
• Internal testing improvements

4.0.0-dev.3

• Add mustCallSuper to onEvent, onTransition, and onError

4.0.0-dev.2

• Fix remove duplicate terminating state

4.0.0-dev.1

• Remove rxdart dependency (#821)
• Replace transformStates with transformTransitions (#840)
• Fix null stackTrace in onError (#963)

3.0.0

• Upgrade to rxdart ^0.23.0
• Upgrade to Dart >= 2.6.0

3.0.0-dev.1

• Upgrade to rxdart ^0.23.0

2.0.0

• Allow blocs to finish processing pending events on close (#639)
• Documentation Updates

1.0.1

• Bugfix: Exceptions thrown in onTransition are passed to onError and should not break bloc functionality (#641)
• Adhere to effective dart (#561)
• Documentation and Example Updates

1.0.0

• dispatch and dispose removed
• Documentation Updates

0.16.1

• Minor Documentation Updates

0.16.0

• Bloc extends Stream<State> (#558)
  • bloc.state.listen -> bloc.listen
  • bloc.currentState -> bloc.state
• Bloc implements Sink<Event> (#558)
  • dispatch deprecated in favor of add
  • dispose deprecated in favor of close
• Documentation and Example Updates

0.15.0

• Removed Bloc event Stream (#326)
• Renamed transform to transformEvents
• Added transformStates (#382)

0.14.4

Additional Dependency and Documentation Updates.

0.14.3

Dependency and Documentation Updates.

0.14.2

• Deprecated Bloc event Stream (#326)
• Documentation Updates

0.14.1

Internal BlocDelegate update and Documentation Updates.

0.14.0

BlocDelegate initialization improvements and Documentation Updates.

• BlocSupervisor().delegate = ... is now BlocSupervisor.delegate = ... (#304).

0.13.0

Bloc and BlocDelegate Improvements, new Features, and Documentation Updates.

• Improved dispose to ignore pending events (#257).
• Exposed event stream on Bloc similar to state stream to expose a Stream of dispatched events (#259).
• Update to use rxdart version ^0.22.0 (#265).
• BlocDelegate methods include a reference to the Bloc instance (#259).
• Added onEvent to Bloc and BlocDelegate (#259).

0.12.0

Updated transform to enable advanced event filtering and processing and Documentation Updates.

0.11.2

Added BlocDelegate onError and onTransition mustCallSuper and Documentation Updates

0.11.1

Added dispose mustCallSuper and Documentation Updates

0.11.0

Update mapEventToState to remove unnecessary argument for currentState

• Stream<S> mapEventToState(S currentState, E event) -> Stream<S> mapEventToState(E event)
• Documentation Updates
• Example Updates

0.10.0

Updated to rxdart ^0.21.0 and Documentation Updates

0.9.5

Minor Enhancements to Code Style and Documentation.

0.9.4

Calls to dispatch after dispose has been called trigger onError in the Bloc and BlocDelegate.

0.9.3

Restrict rxdart to ">=0.18.1 <0.21.0" due to breaking changes.

0.9.2

Additional Minor Updates to Documentation

0.9.1

Minor Updates to Documentation

0.9.0

Bloc and BlocDelegate Error Handling

• Added onError to Bloc for local error handling.
• Added onError to BlocDelegate for global error handling.

0.8.4

Blocs handle exceptions thrown in mapEventToState and documentation updates.

0.8.3

Minor Internal Improvements and Documentation Updates

0.8.2

Additional Minor Updates to Documentation

0.8.1

Minor Updates to Documentation

0.8.0

Blocs ignore duplicate states

0.7.8

Additional Minor Updates to Documentation

0.7.7

Additional Minor Updates to Documentation

0.7.6

Minor Updates to Documentation

0.7.5

Exposed currentState in Bloc

• Updates to Documentation.

0.7.4

Updated mapEventToState parameter name

• Stream<S> mapEventToState(S state, E event) -> Stream<S> mapEventToState(S currentState, E event)
• Updates to Documentation.
• Updates to Example.

0.7.3

Minor Updates to Documentation

0.7.2

Transition Fix

• Bloc with mapEventToState which returns multiple states per event will now correctly report the Transitions.

0.7.1

Improvements to Bloc usage in pure Dart applications.

• Bloc state is seeded with initialState automatically

0.7.0

Added BlocSupervisor and BlocDelegate.

• BlocSupervisor notifies BlocDelegate of Transitions
• BlocDelegate exposes onTransition which is invoked for all Bloc Transitions.

0.6.0

Transitions and initialState updates.

• Added Transitions and onTransition
• Made initialState required

0.5.2

Additional minor Updates to Documentation.

0.5.1

Minor Updates to Documentation

0.5.0

Moved Flutter Widgets to flutter_bloc package

0.4.2

Additional minor Updates to Documentation.

0.4.1

Minor Updates to Documentation.

0.4.0

Added BlocProvider.

• BlocProvider.of(context)
• Updates to Documentation.
• Updates to Example.

0.3.0

Updated mapEventToState to take current state as an argument.

• Stream<S> mapEventToState(E event) -> Stream<S> mapEventToState(S state, E event)
• Updates to Documentation.
• Updates to Example.

0.2.5

Additional Minor Updates to Documentation.

0.2.4

Additional Minor Updates to Documentation.

0.2.3

Additional Minor Updates to Documentation.

0.2.2

Additional Minor Updates to Documentation.

0.2.1

Minor Updates to Documentation.

0.2.0

Added Support for Stream Transformation

• Includes Stream<E> transform(Stream<E> events)
• Updates to Documentation

0.1.2

Additional Minor Updates to Documentation.

0.1.1

Minor Updates to Documentation.

0.1.0

Initial Version of the library.

• Includes the ability to create a custom Bloc by extending Bloc class.
• Includes the ability to connect presentation layer to Bloc by using the BlocBuilder Widget.