events_emitter 0.5.2

An intuitive Event-based system, inspired by NodeJS's Event Emitter. Allows for multiple data types with type safety events. Based on JavaScript and suitable for Dart and Flutter.

0.5.2

Added:

• RestrictedEventEmitter for better control by allowing or disallowing specific event types, and the max listeners limit.
• ListCallback.args1() to get the first argument of the list in a callback, added for consistency

Changed:

• Data property in .emit() is optional, if no data is given the event will be of type Event<Null> which can still be caught by EventCallback<dynamic>

Fixed:

• Replaced lint developer dependency with lints

0.5.1

Added:

• ListCallback, a helper class that when appended on .on() lets you have multiple arguments. Essentially splitting a list event Event<List<dynamic>> into arguments, it's a workaround for the fact that Dart can't handle spread syntax. See [ListCallback] documentation.

0.5.0

[!] Removed:

• Redundant listener reference of itself, in EventListener callbacks: onAdd, onRemove, onCall and onCancel. For simplicity and to avoid dynamic listener's type issues. Use this if possible, or a reference of the listener instead.

Fixed:

• EventListener callbacks documentation
• Main example

0.4.5

Fixed:

• .emit() returns satisfaction

0.4.4

Added:

• EventListener property dataType

Fixed:

• Improved data type validation for dynamic data

0.4.3

Added:

• StreamEventListener, it's useful for having a streaming alternative to the default EventEmitter class

Fixed:

• Documentation with old property topic naming
• EventListener callbacks would throw an exception in some cases when using dynamic

0.4.2

Added:

• cancelAdded parameter to EventListener, tells the listener to automatically remove itself from the added EventEmitter when the .cancel() method is called. This is used in case you want to add your own canceling method. It essentially appends callbacks to the onCancel callbacks.

• .appendCallback() method to EventListener

[!] Changed:

• Typedef EventAddedCallback renamed to EventCallbackAdd
• Typedef EventRemoveCallback renamed to EventCallbackRemove
• Typedef EventCancelCallback renamed to EventCallbackCancel

Fixed:

• lint dependency moved to developer dependency

0.4.1

Changed:

• rxdart dependency updated from 0.27.3 to 0.27.5

Fixed:

• Type matching in .off()
• [!] Positional parameters in .off() changed to named parameters, as it was intended

0.4.0

Added:

• EventListener properties once and protected added
• EventListener callbacks onAdd, onRemove and onCancel
• EventListener handles custom events, they can also act like normal events. This is used to add context to an event if needed.
• EventEmitter .on() can catch the data as well as the Event<T> of the data

[!] Changed:

• EventStreamEmitter was renamed to StreamEventEmitter
• Event property topic renamed to type, to match JavaScript events
• Event property message renamed to data
• StreamEventEmitter's stream controller is now public

[!] Removed:

• EventEmitter sync
• EventListener property stream, subscription and messageType

Massive BREAKING CHANGES:

• EventEmitter was refactored to not depend on Streams, which means it now manages the callbacks itself. The emitter can have more complex listener logic. Before it would depend on StreamEventEmitter.

• File structure was changed to be more organized. This means you might need to update your imports.

• Sync is no longer a thing in the EventEmitter, it's a StreamEventEmitter only thing now.

• Other changes: [!]

0.3.1

Added:

• shield.io badges

Changed:

• ChangeLog's format

0.3.0

Changed:

• .onAny in EventEmitter now returns an EventListener

Fixed:

• In some cases, canceled listeners didn't get removed, now it's more accurate

0.2.1

Fixed:

• Make package only dart dependant

0.2.0

Added:

• .emitEvent() emits an existing event, without having to create a new one

0.1.0

Added:

• rxdart package dependency, for better-implemented streams

Fixed:

• Cast with dynamic type would break unexpectedly

0.0.7

Fixed:

• .onAny return type (Still has errors)

0.0.6

Changed:

• Filter .onAny<T>() by type

Fixed:

• pubspec.yaml clean up
• Example with final

0.0.5+2

Changed:

• Package description and documentation for type safety promotion

0.0.5+1

Added:

• More documentation (Why is this package different?)

Fixed:

• Documentation typos

0.0.5

Changed:

• once in EventEmitter now returns a Future with the message, allowing to await (still needs a callback)
• Separated EventEmitter and EventStreamEmitter classes into different files
• Internal variable names for simplification

Removed:

• send for simplification, the same could be achieved with emit

0.0.4

Removed:

• Package dependency flutter_lints

0.0.3

Fixed:

• StreamSubscription, cancel instances

0.0.2

Changed:

• on to return an EventListener, instead of a StreamSubscription

Fixed:

• Package description (was too long)

0.0.1

Initial release: EventEmitter