level-tb
v0.0.1
Published
A persistent implementation of the [token bucket algorhitm](http://en.wikipedia.org/wiki/Token_bucket) on top of [levelup](https://github.com/rvagg/node-levelup).
Downloads
3
Readme
A persistent implementation of the token bucket algorhitm on top of levelup.
Inspired by jhurliman/node-rate-limiter.
Install
npm i level-tb
Usage
var level = require('level');
var ttl = require('level-ttl');
var db = ttl(level(__dirname + '/test'));
var bucket = new TokenBucket({
db: db, // the levelup instance, can be a sublevel, needs to have ttl
name: 'buk1', // the name of the bucket, used as key
size: 100, // the max size of the bucket
tokensPerInterval: 10, // the amount of tokens added per interval
interval: 100 // the interval lenght in milliseconds
});
bucket.take(1, function (err, result, status) {
console.log(result); //true for conforming traffic, false for non-conforming
console.log(status); // the status of the bucket, lastDrip and content
});
How it works, implementation details
This implementation doesn't use system timers per bucket, every time you take tokens from the bucket, we drip first the difference of tokens since last time.
New buckets are full of tokens.
Unused full buckets are discarded automatically using level-ttl. This is important if you use a bucket per user or per client to prevent DDoS attacks filling the entire disk.
License
MIT