pouchdb-hoodie-api

Hoodie-like API for PouchDB

Build Status Coverage Status Dependency Status devDependency Status

NPM

This plugin provides simple methods to add, find, update and remove data.

Usage

Initialisation

var db = new PouchDB('dbname')
var api = db.hoodieApi()

API

// Options
// emitter: Optionally pass an instance of EventEmitter for hoodieApi to use

var db = new PouchDB('dbname')
var api = db.hoodieApi({
  emitter: existingEventEmitter
})

// all methods return promises
api.add(object)
api.add([object1, id2])
api.find(id)
api.find(object) // with id property
api.findOrAdd(id, object)
api.findOrAdd(object)
api.findOrAdd([object1, id2])
api.findAll()
api.findAll(filterFunction)
api.update(id, changedProperties)
api.update(id, updateFunction)
api.update(object)
api.update([object1, id2])
api.updateOrAdd(id, object)
api.updateOrAdd(object)
api.updateOrAdd([object1, id2])
api.updateAll(changedProperties)
api.updateAll(updateFunction)
api.remove(id)
api.remove(object)
api.remove([object1, id2])
api.removeAll()
api.removeAll(filterFunction)
api.clear()

// events
api.on('add', function(object, options) {})
api.on('update', function(object, options) {})
api.on('remove', function(object, options) {})
api.on('change', function(eventName, object, options) {})
api.on('clear', function() {})
api.one(eventName, eventHandlerFunction)
api.off(eventName, eventHandlerFunction)

// original PouchDB (http://pouchdb.com/api.html) instance used for the store
api.db

Full API documentation is available at: http://hoodiehq.github.io/pouchdb-hoodie-api/

Installation

Install via npm

npm install pouchdb
npm install pouchdb-hoodie-api

Including the plugin

With browserify or on node.js/io.js

Attach this plugin to the PouchDB object:

var PouchDB = require('pouchdb')
PouchDB.plugin(require('pouchdb-hoodie-api'))

In the browser

Include this plugin after pouchdb.js in your HTML page:

<script src="node_modules/pouchdb/dist/pouchdb.js"></script>
<script src="node_modules/pouchdb-hoodie-api/dist/pouchdb-hoodie-api.js"></script>

Modular Usage

Every method is a PouchDB plugin of its own. If you only need certain ones you can require them individually:

PouchDB.plugin({
  add: require('pouchdb-hoodie-api/add')
})

Testing

Sauce Test Status

Tests are currently not running on >IE10 however once https://github.com/pouchdb/pouchdb/pull/4220 lands we can enable this.

In Node.js

Run all tests and validates JavaScript Code Style using standard

npm test

To run only the tests

npm run test:node

In the browser

test:browser:local

This will start a local server. All tests and coverage will be run at http://localhost:8080/__zuul

Contributing

Have a look at the Hoodie project's contribution guidelines. If you want to hang out you can join #hoodie-pouch on our Hoodie Community Slack.