Versioned caching plugin for seneca

Usage no npm install needed!

<script type="module">
  import senecaEntityCache from 'https://cdn.skypack.dev/@seneca/entity-cache';



Seneca plugin providing simple id-based distributed entity caching.

Npm Travis Coveralls Maintainability DeepScan grade dependencies Status Gitter

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)

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/entity-cache

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

You'll also need memcached

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


The unit tests require a running memcached and redis.


  • prefix : string "SE"
  • maxhot : number 1111
  • maxage : number 22222
  • expires : number 3600
  • hot : boolean true

Set plugin options when loading with:

seneca.use('entity-cache', { name: value, ... })

Note: foo.bar in the list above means { foo: { bar: ... } }

Action Patterns

Action Descriptions

« clear:hot-keys,plugin:entity-cache »

No description provided.

« get:stats,plugin:entity-cache »

No description provided.

« list:hot-keys,plugin:entity-cache »

No description provided.


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

  prefix:  '@seneca/entity-cache',
  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