stream implementor api WIP (see #13)