celerity

celerity uses redis to do centralized rate limiting for applications running on multiple heroku dynos

Usage no npm install needed!

<script type="module">
  import celerity from 'https://cdn.skypack.dev/celerity';
</script>

README

celerity

Build Status

celerity uses redis to do centralized rate limiting for applications running on multiple heroku dynos (or processes).

install

npm install celerity

example

see example.js for a simple rate limited webserver using celerity

use

require
var celerity = require('celerity');

var redis = require('redis');
configure
var config = {
    redis: redis.createClient(),
    timespan: 10 * 1000,
    bucketCount: 10
};

celerity keeps the rate for the last timespan milliseconds.

timespan is divided into bucketCount buckets. the rate is stored in the buckets. buckets older than timespan expire every timespan / bucketCount milliseconds.

a higher bucketCount increases the frequency and accuracy of the expires but uses more memory and results in slower read operations. if timespan is several seconds long it is usually enough to have a bucket for every second.

use the prefix property to set a prefix for all redis keys used by celerity. the default prefix is celerity:.

increment(config, event, n, cb)
celerity.increment(config, 'event', 1, function(err) {
});

atomic. complexity: O(1).

read(config, event, cb)
celerity.read(config, 'event', function(err, rate) {
});

atomic. complexity: O(n) where n is bucketCount.

incrementAndRead(config, event, n, cb)
celerity.incrementAndRead(config, 'event', 1, function(err, rate) {
});

atomic. complexity: O(n) where n is bucketCount.

license: MIT