v8.0.0

Breaking changes:

• Update node-buffer to v9.0.0 (#48 by @JordanMartinez)

• Reimplement event handlers using eventNameH-style API (#49 by @JordanMartinez)

  Previously, one would write something like the following, and be unable to remove
  the resulting listener.

  Stream.onData stream \buffer -> do
    ...

  Now, one writes such a thing via on (or a similar function) from node-event-emitter:

  -- if the listener should be removed later, use `on`.
  removeListener <- stream # on dataH \buffer -> do
    ...
  -- if it doesn't need to be removed, use `on_`.
  stream # on_ dataH \buffer -> do
    ...

• Renamed functions to better adhere to naming consistency (#50 by @JordanMartinez)

  All functions that take an optional callback are now
  named using the following schema:

  • no callback: functionName
  • with callback: functionName'

  Thus, the following were renamed:

  • write was renamed to write'
  • writeString was renamed to writeString'
  • end was renamed to end'
  • destroyWithError was renamed to destroy'

  write, writeString, and end now refer to their non-callback versions.

New features:

• Added event handlers for Writeable streams (#49 by @JordanMartinez)

• Added missing APIs (#51, #53 by @JordanMartinez)

  • readable, readableEnded, readableFlowing, readableHighWaterMark, readableLength
  • pipe'
  • writeable, writeableEnded, writeableCorked, errored, writeableFinished, writeableHighWaterMark, writeableLength, writeableNeedDrain
  • closed, destroyed
  • allowHalfOpen
  • pipeline
  • readableFromString, readableFromBuffer
  • newPassThrough

• Integrated node-streams-aff into library (#52 by @JordanMartinez)

  Convenience APIs added for readable streams in "paused" mode:

  • readSome
  • readAll
  • readN

  Convenience APIs for writeable streams:

  • write
  • end

  Convenience APIs for converting Strings from/to Array Buffer

  • toStringUTF8
  • fromStringUTF8

  The only APIs from the library not added were newReadable and push.

• Added convenience API for converting Readable to String or Buffer (#53 by @JordanMartinez)

  • readableToStringUtf8
  • readableToString
  • readableToBuffers

Bugfixes:

• Drop misleading comment for setEncoding (#51 by @JordanMartinez)

  For context, see #37.

Other improvements:

• Bumped CI's node version to lts/* (#48 by @JordanMartinez)

• Updated CI actions/checkout and actions/setup-nodee to v3 (#48 by @JordanMartinez)

• Format code via purs-tidy; enforce formatting via CI (#48 by @JordanMartinez)

• Refactor tests using passThrough streams (#49 by @JordanMartinez)

• Updated FFI to use uncurried functions (#50 by @JordanMartinez)

• Relocated setEncoding, Read, and Write for better locality in docs (#51 by @JordanMartinez)

• Added node-streams-aff tests (#52 by @JordanMartinez)

• Updated spec to v7.5.3 to address bower dep issue (#54 by @JordanMartinez)

  See purescript-spec/purescript-spec#142 for more context.