token-boy

0.0.4 • Public • Published

Build Status

token-boy

Serves a token of given bit length with given encoding, digested by default.

Collision detection logic is left out as it should be specific to your application.

Install

For node

npm install token-boy --save

For browsers

bower install token-boy

or

git clone git@github.com:zeusdeux/token-boy.git

If you plan to use it with browserify, then just require index.js.
If you plan to use it directly in the browser, then include browser/token-boy.min.js. This will export a global require function.
You can then do:

<script>
  var tokenBoy = require('token-boy')();
  var token = tokenBoy().token; //returns a 128 bit, base64 encoded, digested token
</script> 

Usage

Simple usage

var tokenBoy = require('token-boy')()
var token = tokenBoy().token //returns a 128 bit, base64 encoded, digested token

Advanced usage

var tokenBoy = require('token-boy')('hex') //specifying default encoding to be hex
var token
 
token = tokenBoy().token //returns a 128 bit, hex encoded, digested token
token = tokenBoy(256,'base64').token //returns a 256 bit, base64 encoded, digested token
token = tokenBoy(128,'base64', false).token //returns a 128 bit, base64 encoded, non-digested token
token = tokenBoy(512, 'ascii', false).token //returns a 512 bit, ascii encoded, non-digested token
 
//note:
//both of these return a 512 bit, default encoding ('hex' in this case) encoded, digested token
//this is because ascii is not a valid digest encoding type as of node v0.10.29
token = tokenBoy(512, 'ascii', true).token
token = tokenBoy(512, 'ascii').token

As of Node v0.10.29
Encodings supported are:

  • ascii
  • utf8
  • utf16le
  • ucs2
  • base64
  • binary
  • hex

Default encodings supported are:

  • binary
  • base64
  • hex

The default encodings supported are only a subset of encodings as the digest() method documentation asks us to only use these. If it is needed, I shall add support for all encodings to be used as default encodings but I don't see the need for it right now.

Changelog

  • 0.0.4
    • bugfixes and documentation fixes
    • fixed the broken 0.0.3 version
  • 0.0.3 (do not use this version)
    • bugfixes

Readme

Keywords

Package Sidebar

Install

npm i token-boy

Weekly Downloads

10

Version

0.0.4

License

MIT

Last publish

Collaborators

  • zeusdeux