dad

Data micro-framework

Dad

Composable data stores for node.js and the browser. Dad's small ~300 SLOC codebase implements only methods that are common in most datastores. This includes models, validation and persistance.

No assumptions about your backend are made. Through adapters you can synchronize your data with any backend. Official adapters are a WIP.

$ npm i --save dad
var rest = require('dad-rest');
var dad = require('dad');
var store = dad('books');
 
// Set the schema. 
store.schema = {
  title: {type: 'string', required: true},
  author: {type: 'string', required: true},
  pages: {type: 'number'}
};
 
// Set the adapters. 
 
store.adapters = [
  rest('localhost:1337/books')
];
 
// Start moving data around, and save it to 
// our REST backend. 
store.add({
  title: 'Ferrets',
  author: 'Tobi',
  pages: 12
});
 
store.update({
  title: 'Lizards',
  author: 'Tobi',
  pages: 12
});

Create a named store.

var dad = require('dad');
var store = dad('books');

Define the schema for the store.

store.schema = {
  title: {type: 'string', required: true},
  author: {type: 'string', required: true},
  pages: {type: 'number'}
};

Define the adapters to be called.

var localStorage = require('dad-localStorage');
var rest = require('dad-rest');
 
store.adapters = [
  localStorage,
  rest
];

Validate a value against a key in the schema.

store.validate({
  title: 'bar',
  author: 'bin'
});

Check if an object accounts for all properties demanded by the schema.

store.allAccountedFor({
  title: 'bar',
  author: 'bin'
});

Save a record or an array of records to the store. Also calls all registered adapters. Emits a change event when done.

store.add({
  title: 'Fatherly jokes',
  author: 'Tobi',
  pages: 12,
  chapters: [0]
});

Get all records from the store. Also calls all registered adapters.

store.get();

Update a record. Also calls all registered adapters. Emits a change event when done.

store.update({
  title: 'Fatherly jokes',
  author: 'Tobi',
  pages: 12
});

Remove a record from the store. Also calls all registered adapters. Emits a change event when done.

store.remove({
  title: 'Fatherly jokes',
  author: 'Tobi',
  pages: 12
});

Fetch records from the server over HTTP. Can be provided with optional HTTP headers. Emits a sync event when completed, else it emits an error event.

store.fetch({
  API_KEY: 'mysecretkey',
  ANOTHER_HEADER: 'some value'
});

MIT © Yoshua Wuyts