stower

Stower is a simple disk backed key/value store for node.

Why? For lightweight, disposable state without running a database. stower keeps data in memory and syncs to a readable JSON file in the background (defaulting to your system cache folder). It uses atomic writes, file locks, and corrupt-file recovery across processes, but treat it as a convenience cache, not a source of truth for critical data.

Install

npm install stower

Usage

var stower = require('stower');

// persist (optional JSON file path)
stower.persist('./stow.json');

// enable debugging (console logs)
stower.debug = true;

// store some data
stower.set('token', { id: '123', key: 'abc' });

// store with a TTL (expires after 60 seconds)
stower.set('session', { user: 'alice' }, 60);

// retrieve it
var token = stower.get('token');

// check it exists
if (stower.exists('token')) {
    console.log('token exists');
}

// remove it
stower.remove('token');

// view all keys
console.log(stower.keys());

// view all values
console.log(stower.values());

// get the JSON file name and path
console.log(stower.filename);

// clear everything
stower.clear();

Properties

Property | Description :----------|:--------------------------------------------- filename | Returns filename used so store data on disk debug | Get/set debug status (enables console logs)

Methods

Method | Description :-----------------------------------|:-------------------------------------------------------------------------------------------------------------------------- get(key) | Retrieves a value by key, returns null if the key doesn't exist set(key, value, expiresInSeconds) | Stores a value and schedules it to be saved to disk. Pass an optional expiresInSeconds to automatically expire the entry remove(key) | Deletes a key from the store and schedules the update to disk exists(key) | Checks if a key exists keys() | Returns an array of all stored keys values() | Returns an array of all stored values clear() | Deletes all stored data and schedules a save to disk persist(filename) | Loads previously saved values from disk and auto saves changes (optional filename)

Note: if persist() is not called, values only exist in memory.

Contributing

As always, pull requests are welcomed - but please ensure you provide a test where necesssary.

Tests

You can run the tests using npm test

To run tests with coverage and enforce thresholds, use npm run test:coverage

Star

If you find this useful please star the repo, it helps us prioritise Open Source work.

History

For change-log, check releases.

License

MIT License © Orca Scan - a barcode app with simple barcode tracking APIs.