Seneca data store plugin that uses plain JSON files

Downloads in past


1351.1.05 years ago11 years agoMinified + gzip package size for seneca-jsonfile-store in KB


A Seneca.js data storage plugin
!npm versionnpm-badgenpm-url !Build Statustravis-badgetravis-url !Dependency Statusdavid-badgedavid-url !Gittergitter-badgegitter-url


This module is a plugin for Seneca.js. It provides a storage engine that uses JSON files to persist data. This module is not appropriate for production usage, it is intended for very low workloads, and as a example of a storage plugin code base.
For a gentle introduction to Seneca itself, see the senecajs.orgseneca.js site.

Seneca compatibility

Supports Seneca versions 1.x - 3.x

Supported functionality

All Seneca data store supported functionality is implemented in seneca-store-test as a test suite. The tests represent the store functionality specifications.


To install, simply use npm. Remember you will need to install Seneca.js separately.
npm install seneca
npm install seneca-jsonfile-store


You don't use this module directly. It provides an underlying data storage engine for the Seneca entity API:
var entity = seneca.make$('typename')
entity.someproperty = "something"
entity.anotherproperty = 100$(function (err, entity) { ... })
entity.load$({ id: ... }, function (err, entity) { ... })
entity.list$({ property: ... }, function (err, entity) { ... })
entity.remove$({ id: ... }, function (err, entity) { ... })

Quick Example

var seneca = require('seneca')()
seneca.use('jsonfile-store', {

var apple = seneca.make$('fruit')  = 'Pink Lady'
apple.price = 0.99$(function (err, apple) {
  console.log(" = " + )

Query Support

The standard Seneca query format is supported:
  • .list$({f1:v1, f2:v2, ...}) implies pseudo-query f1==v1 AND f2==v2, ....

  • .list$({f1:v1,...}, {sort$:{field1:1}}) means sort by f1, ascending.

  • .list$({f1:v1,...}, {sort$:{field1:-1}}) means sort by f1, descending.

  • .list$({f1:v1,...}, {limit$:10}) means only return 10 results.

  • .list$({f1:v1,...}, {skip$:5}) means skip the first 5.

  • .list$({f1:v1,...}, {fields$:['fd1','f2']}) means only return the listed fields.

Note: you can use sort$, limit$, skip$ and fields$ together.


The Senecajs org encourages open participation. If you feel you can help in any way, be it with documentation, examples, extra testing, or new features please get in touch.


To run tests, simply use npm:
npm run test


Copyright (c) 2012-2016, Richard Rodger and other contributors. Licensed under MIT.