pull-crypto

pull-stream wrapper for node's crypto module.

hash

a Sink stream that will callback the hash of a stream (i.e. a file)

var pc = require('pull-crypto')
var pull = require('pull-stream')

pull(
  pull.values(['a', 'b', 'c']),
  pc.hash(function (err, sum) {
    if(err) throw err
    console.log(sum)
  })
)

which will output: a9993e364706816aba3e25717850c26c9cd0d89d

encrypt

a Through stream that takes an options object and returns encrypted data in callback (if callback is supplied) or stream so it can be piped to a consumer.

Below has no callback and returns a stream so you pipe to another stream.

var pc = require('pull-crypto')
var pull = require('pull-stream')

var pass = 'secret'
var alg = 'aes-256-cbc'
var encryptOpts : {
  inputEncoding : 'ascii',
  encoding : 'base64'
}

encryptOpts.password = pass
encryptOpts.algorithm = alg
   
pull(
  pull.values(['a', 'b', 'c']),
  pc.encrypt(encryptOpts),
  pull.log()
)

Note : options object is intentionally verbose in above example to show all properties. The only thing you are required to pass in is the password property. This will ensure your data is not encrypted with any default password. If no password is supplied it will throw!

####Options Object defaults :

• algorithm : aes-256-cbc
• inputEncoding : buffer
• encoding : buffer

decrypt

this is the same as encrypt. It can either be piped down stream or take a callback. Below we take encrypted hex data and pipe it to decrypt and then print out the decrypted data to the console, which yields abc.

var pc = require('pull-crypto')
var pull = require('pull-stream')
var pass = 'secret'

pull(
  pull.values(['9f6199ceee0c2a6f36137fa80eeb2a59']),
  pc.decrypt({
    password : pass,
    inputEncoding : 'hex',
    encoding : 'ascii'
  }),
  pull.log()
)

You can also pass a callback to decrypt.

Below is same example as above with Callback supplied. It also has a slimmed down options object.

var pc = require('pull-crypto')
var pull = require('pull-stream')
var pass = 'secret'
   
pull(
  pull.values(['2ad16d51e86e596f274c00c1674563eb', 'b4d45754b6c12f8f780b8245cefa3b60', 'eba7bdc73915a45cbd7e45b0b2dd2d29']),
  pc.decrypt({
    password : pass,
    inputEncoding : 'hex',
    encoding : 'ascii'
  }, function(err, encrypted) {
    if (err) throw err
    console.log(encrypted.join(''))
  })
)

Note that when using the callback style as above this function will not stream! It will buffer all data until upstream calls cb(true) indicating there is no more data and then it will call your callback with all of the transformed data. The returned data will be in the form of an array. Since the data has been encrypted chunk by chunk you will have to decrypt it chunk by chunk. So the callback style is better suited for decryption. When you don't need to stream and you want all the data back at the same time. All you have to do is call join('') on the returned data to concatinate the decrypted result as shown above (call join() on string data, of course...buffers need to be handled differently).

algorithms

You can choose any algorithm that is available through node's crypto.getCiphers() method. Check out the tests folder, you'll find the most common algorithms tested.

encoding

If you encrypt data as a string please remember you must set opts.inputEncoding in the decrypt options to the same value that the data was originally encrypted or you will not be able to decrypt the data.

See node's crypto module for more details on encoding.

License

MIT