Buffo NPM | npm.io

buffo

Binary encoding for Javascript objects.

Transcode all types of JSON values to and from a binary format, including Buffer, Date, RegExp and more. Originally created to stream worker commands over pipes between processes.

:warning: Early release, handle with care :sunglasses:

Supported types

String (utf8)
Boolean
Number (incl NaN, Infinity)
Object
Array
Buffer (fastest)
TypedArray (all types, very fast)
Date
RegExp
null
undefined
arguments (arrives as Array)

Array and Object can hold any of the other types. Serialisation of Object reads enumerable properties, but ignores functions.

Error (needs special case)
Set (like Array)
Map (keys would be tricky)

Install

$ npm install buffo

Usage

Single value

Write a value to a Buffer, later decode the Buffer back to a value.

var buffo = require('buffo');

var buffer = buffo.encode(sourceValue);
var outputValue = buffo.parse(buffer);

Stream

Create encoder and decoder Transform streams and connect them over some binary pipe. Then write or pipe JavaScript objects and they magically reappear at the other end.

Keep in mind that due to the nature of node's object-streams you cannot send null or undefined as root value as they will terminate the Transform stream (they work fine nested in Arrays or Objects).

var buffo = require('buffo');

// sender
var encoding = buffo.encodeStream();
encoding.pipe(process.stdout);
encoding.write(myValue);

// receiver
var decoding = buffo.decodeStream();
process.stdin.pipe(decoding).on('data', function(data) {
    // received a value
});

(note this stdin/stdout example is blocking on Linux, so from inter-process stream better use net or file-descriptor streams)