groupsBy
Live groups as they open: a key and an inner stream of every later value that shares it.
Lecture
The pull layer's groupBy is a
terminal: it pulls everything and hands you a Map.
groupsBy is the live version. The first value of each
key emits a GroupedEvents — a record of that
key and an inner events stream — and every
later value with the same key is forwarded to that inner. Groups
appear in first-seen key order, as they open, not
after the source has closed.
That is the same nested-FxEvents idea as
window*, keyed by value
instead of by time. A widget can subscribe to one group's inner the
moment it appears and see later values as they arrive; it does not
have to wait for a batch.
If lastFor is set, the first event (or completion) of
lastFor(key) completes that group. A
later value with the same key opens a new one — an idle timeout per
user, a "session ended" signal per room. Without
lastFor, groups stay open until the source completes
(or errors; an error is forwarded to every live group, then to the outer
stream).
Cancelling the outer completes live groups silently, the same RxJS 9
rule the window family follows. This is part of fxdart's events layer,
modeled on Rx's groupBy.
Demo 1 · Groups as they open
Demo 2 · lastFor closing a group
Try it yourself
Exercise: group SKUs by department prefix.