Consider deprecating or removing `StreamIterator`.

The `StreamIterator` class isn't very well designed. The `StreamQueue` in `package:async` is superior as a way to access events using (async) pull.

The `StreamIterator` has simplicity going for it. It's unclear whether it pauses the stream or not (it currently does if you don't call `moveNext` again during the callback from the previous one).
