volos-quota-memory

In-memory provider for Quota enforcement in the Volos system.

npm install volos-quota-memory
8 downloads in the last day
8 downloads in the last week
15 downloads in the last month

volos-quota-memory

This is a memory-backed implementation of quota support for Volos.

Once initialized, the interface to the module is exactly what is in the "volos-quota-common" module. See that module for detailed docs.

Initialization

To initialize a quota, you call "create" on the exported module and pass a single "options" object. It can contain the following parameters:

  • timeUnit: How often the quota resets -- may be in minutes, hours, days, or weeks
  • interval: Works with the timeUnit to determine how often the quota resets. For instance, every 5 days or 2 weeks.
  • startTime: A time at which the quota calculations should begin. For instance, if there is no start time then a quota set to reset in "one day" will reset 24 hours after the first message is receiver, but if the start time is set to the top of the hour on some day, then the quota will always reset at the top of the hour.
  • allow: The maximum number of requests to allow. This may be overridden on each "apply" call if desired.

Once the quota has been initialized, the module that is returned has the programming interface defined by the "volos-quota-common" module.

Example

var quotaModule = require('volos-quota-memory');
var quota = quotaModule.create({
  timeUnit: 'day',
  interval: 1,
  allow: 10
  });

quota.apply({ identifier: 'Foo', weight: 1 }, function(err, result) {
  if (err) {
    throw err;
  } else {
    console.log('Quota status: %s', result.isAllowed);
  }
});
npm loves you