Package Exports

@momsfriendlydevco/cache

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@momsfriendlydevco/cache) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

@momsfriendlydevco/cache

Generic caching component.

This module is a very low-level caching component designed to store, retrieve, expire and cleanup a simple key-value storage.

var Cache = require('@momsfriendlydevco/cache');

var storage = new Cache({
    modules: ['memcached', 'mongo', 'memory'], // What modules to try to load (in order of preference)
});


// Set something (key, val, [expiry], [callback])
storage.set('myKey', 'myValue', moment().add(1, 'day'), (err, val) => ...)

// Get something (key, [fallback], callback)
storage.get('myKey', 'fallbackValue', (err, val) => ...)

// Forget something (key, [callback])
storage.unset('myKey', err => ...)

// Clean up storage, only supported by some modules ([callback])
storage.vacuume(err => ...)

// Hash something, objects also supported
storage.hash(complexObject, val => ...)

Supported Caching Drivers

Driver	Requires	Maximum object size	Vacuume Support
filesystem	Writable FS area	Infinite	No
memcached	MemcacheD daemon	1mb	No
memory	Nothing	Infinite	Yes
mongodb	MongoDB daemon	16mb	Yes

NOTES:

By default MemcacheD cahces 1mb slabs, see the documentation of the daemon to increase this
While memory storage is theoretically infinite Node has a memory limit of 1.4gb by default. See the node CLI for details on how to increase this
Some caching systems (notably MemcacheD) automatically vacuume entries

API

Cache([options]) (constructor)

Create a new cache handler and populate its default options.

cache.options(Object) or cache.options(key, val)

Set lots of options in the cache handler all at once or set a single key (dotted or array notation are supported).

Valid options are:

Option	Type	Default	Description
`init`	Boolean	`true`	Whether to automatically run cache.init() when constructing
`keyMangle`	Function	`key => key`	How to rewrite the requested key before get / set / unset operations
`modules`	Array	`['memory']`	What modules to attempt to load
`filesystem`	Object	See below	Filesystem module specific settings
`filesystem.path`	Function	os.tempdir + key + '.cache.json'	How to calculate the file path to save. Defaults to the OS temp dir
`filesystem.pathSwap`	Function	" + " + '.cache.swap.json'	How to calculate the swap path to save. Defaults to the OS temp dir
`memcached`	Object	See below	MemcacheD module specific settings
`memcached.server`	String	`'127.0.0.1:11211'`	The MemcacheD server address to use
`memcached.lifetime`	Number	`1000*60` (1h)	The default expiry time, unless otherwise specified
`memcached.options`	Object	`{retries:1,timeout:250}`	Additional options passed to the MemcacheD client
`mongodb`	Object	See below	MongoDB module specific options
`mongodb.uri`	String	`'mongodb://localhost/mfdc-cache'`	The MongoDB URI to connect to
`mongodb.collection`	String	`mfdcCaches`	The collection to store cache information within

cache.option()

Alias of cache.options().

cache.init([callback])

Initialize the cache handler and attempt to load the modules in preference order. This function is automatically executed in the constructor if cache.settings.init is truthy.

cache.set(Object, [expiry], [callback]) or cache.set(key, value, [expiry], [callback])

Set a collection of keys or a single key with the optional expiry.

cache.get(key, [fallback], callback)

Fetch a single value and call the callback. If the value does not exist the fallback value will be provided. Callback is called as (err, value).

cache.vacuume([callback])

Attempt to clean up any left over or expired cache entries. This is only supported by some modules.

Debugging

This module uses the debug NPM module for debugging. To enable set the environment variable to DEBUG=cache.

For example:

DEBUG=cache node myFile.js