node package manager
Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »



Node.js Seneca Versioned Caching module

This module is a plugin for the Seneca framework. It provides a data caching mechanism for Seneca data entities. Using this module will give your Seneca app a big performance boost.

The caching mechanism goes beyond simple key-based caching using memcached. In addition, a smaller "hot" cache is maintained within the Node process. Data entities are given transient version numbers, and these are used to synchronize the hot cache with memcached.

This plays nicely with multiple memcached instances, and allows Seneca apps to scale.

(See chapter 8 of my book for details, or read How key-based cache expiration works)


If you're using this module, feel free to contact me on twitter if you have any questions! :) @rjrodger

Build Status

Quick example

This module works by wrapping the data entity actions (role:entity, cmd:save, ... etc). You just need to register it:

var seneca = require('seneca')()

Then just use data entities as normal. Except things will be a lot faster.


npm install seneca
npm install seneca-memcached-cache
npm install seneca-vcache

You'll need the seneca-memcached-cache plugin as a dependency.

You'll also need memcached

Or... you can use redis: seneca-redis-cache.


plugin:vcache, cmd:stats

Returns a JSON object containing the current hit/miss counts of the cache.


Here's how to set the options (the values shown are the defaults):

  prefix:  'seneca-vcache',
  maxhot:  1111,
  expires: 3600


  • prefix: prefix string to namespace your cache (useful if your cache is used by other things)
  • maxhot: the maximum number of hot items to store in the running node process memory
  • expires: how long to store items (in seconds)


cd test
mocha *.test.js --seneca.log.print


cd test
memcached -vv
mongod --dbpath=db
node n1.js --seneca.log=type:plugin
node n2.js --seneca.log=type:plugin