rafa/docs/Stream-until.md

Rafa.js is a Javascript framework for building concurrent applications.

Emit values from an outer stream until the inner stream emits a value. Once
the inner stream produces a value, convert it to a done message and detach
from the outer and inner streams.

<aside>
```js
// until(Stream): Stream
var outer = Rafa.stream();
var inner = Rafa.stream();
var values = [];
var done;

outer.until(inner)
  .each(value => values.push(value))
  .done(value => done = value);

outer.write(1).write(2);
inner.write(3);
outer.write(4); // won't go through

// values: [1,2,3];
// done: 3
```
</aside>