haro-localstorage/README.md

localStorage persistent storage adapter for Harō

# haro-localstorage

[![Join the chat at https://gitter.im/avoidwork/haro-localstorage](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/avoidwork/haro-localstorage?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)

[![build status](https://secure.travis-ci.org/avoidwork/haro-localstorage.svg)](http://travis-ci.org/avoidwork/haro-localstorage)

[Harō](http://haro.rocks) is a modern immutable DataStore built with ES6 features, which can be wired to an API for a 
complete feedback loop. It is un-opinionated, and offers a plug'n'play solution to modeling, searching, & managing data 
on the client, or server (in RAM). It is a [partially persistent data structure](https://en.wikipedia.org/wiki/Persistent_data_structure), by maintaining version sets of records in `versions` ([MVCC](https://en.wikipedia.org/wiki/Multiversion_concurrency_control)).

***haro-localstorage*** is a persistent storage adapter, providing 'auto saving' behavior, as well as the ability to 
`save()`, `load()` & `unload()` the entire DataStore.

### How to use
Require the adapter & register it with `haro.register(key, fn)`. The key must match the `store.adapters` key. The prefix 
will be used if set, otherwise `store.id` will be the prefix for localStorage items. Records will have localStorage keys as `prefix_key`.

If loaded as from a `<script></script>` the adapter will be available as `haroLocalStorage`.

```javascript
var haro = require('haro'),
    store;

// Configure a store to utilize the adapter
store = haro(null, {
  adapters: {
    local: "myData"
  }
});

// Register the adapter
store.register('local', require('haro-localstorage'));

// Ready to `load()`, `batch()` or `set()`!
```

## License
Copyright (c) 2015 Jason Mulligan
Licensed under the BSD-3 license