dad v1.3.3
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.
Installation
$ npm i --save dad
References
Overview
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
});
API
dad(name)
Create a named store.
var dad = require('dad');
var store = dad('books');
.schema = schema
Define the schema for the store.
store.schema = {
title: {type: 'string', required: true},
author: {type: 'string', required: true},
pages: {type: 'number'}
};
.adapters = adapters
Define the adapters to be called.
var localStorage = require('dad-localStorage');
var rest = require('dad-rest');
store.adapters = [
localStorage,
rest
];
Validation
.validate(key, value)
Validate a value against a key in the schema.
store.validate({
title: 'bar',
author: 'bin'
});
.allAccountedFor(record)
Check if an object accounts for all properties demanded by the schema.
store.allAccountedFor({
title: 'bar',
author: 'bin'
});
Transactions
.add(record)
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()
Get all records from the store. Also calls all registered adapters.
store.get();
.update(record)
Update a record. Also calls all registered adapters.
Emits a change
event when done.
store.update({
title: 'Fatherly jokes',
author: 'Tobi',
pages: 12
});
.remove(record)
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
});
Persistance
.fetch(config)
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'
});