ng-vault 

===========
ng-vault wraps over angular's $cacheFactory to provide few nifty ways to save and retrieve data. ng-vault contains these two parts:
* $vault factory which has methods for storing and retrieving data.
* $vaultConfigProvider for configuring the behaviour of $vault factory.

Installation

###Via yarn or npm:
``shell

yarn (recommended)

$ yarn add ng-vault

#npm
$ npm install ng-vault --save
`
Then use it as:
`javascript
var angular = require('angular');
angular.module('mainApp', [ require('ng-vault') ]);
`
###Via bower:
`
$ bower install ng-augment-native-scroll --save
`
Then use it as:
`javascript
var angular = require('angular');
var ngAugmentNativeScroll = require('./bower_components/ng-vault/src');

angular.module('mainApp', ['ng-vault']);
`
You can also include it in the old fashion way as:
`html



`

Provider Configuration

Normally we may not need to configure the behaviour of $vault. Still he is an example of how we can do it:
`javascript
angular.module('mainApp')
.config(function ($vaultConfigProvider) {
$vaultConfigProvider.set({
id: 'starwars',
limitTypes: {
isArray: true,
isDate: true,
isFunction: true,
isNumber: true,
isObject: true,
isString: true
},
putUptoMins: 5
});
});
`

$3

The unique name with which the internal store of ng-vault will be created.

$3

By default we can save any type of data into $cacheFactory, $vault can be configured to accept only the configured types. This can be help control $vault usage. Skip this to allow $vault to save all type of data. The key names in options, isArray, isDate... are the same methods available on angular. Internally $vault uses angular. to check types. Using plain typeof type === typeof vaule can produce inconsistent results.

$3

Using when we put some data in, it will be retained as long as it's not removed. But sometime we may want to retain data only for a short while. It should be removed once the time is up. We can use putUpto method to put data with an additional mins argument. Here putUptoMins can be set as the default value to be used, in case putUpto is not provided with an additional mins argument.

Usage

Now we can inject $vault into any other part of our code to put and get values. Here are the list of all methods that $vault packs:

$3

To put data in, only defined data. It will check the data type with the set limitTypes. If it passed it will saved. If not it will display a console warn.

Param | Type | Required | Details
--- | :--- | :--- | :---
key | String | yes | Name of the key
value | Any | yes | Value to be saved

`javascript
$vault.put('episode-4', 'A New Hope');
`

$3

Put for certain time, after which it will be removed

Param | Type | Required | Details
--- | :--- | :--- | :---
key | String | yes | Name of the key
value | Any | yes | Value to be saved
mins | Number | no | Mins after which the data should be removed

`javascript
$vault.putUpto('episode-5', 'The Empire Strikes Back', 5);

// after 5 mins (5 1000 60)
$vault.has('episode-5');
// false
`

$3

Put value and remove once it's retrieved.

Param | Type | Required | Details
--- | :--- | :--- | :---
key | String | yes | Name of the key
value | Any | yes | Value to be saved

`javascript
$vault.putOnce('episode-6', 'Return of the Jedi');

$vault.get('episode-6');
// Return of the Jedi

$vault.has('episode-6');
// false
`

$3

Get a stored data. If not found it will return undefined.

Param | Type | Required | Details
--- | :--- | :--- | :---
key | String | yes | Name of the key

`javascript
$vault.get('episode-2');
// Attack of the Clones
`

$3

Check if a particular key exist. Returns true or false.

Param | Type | Required | Details
--- | :--- | :--- | :---
key | String | yes | Name of the key

`javascript
$vault.has('episode-3');
// true
`

$3

Remove a key from $vault

Param | Type | Required | Details
--- | :--- | :--- | :---
key | String | yes | Name of the key

`javascript
$vault.remove('episode-1');
`

$3

Retrieve information regarding the store - id and size

`javascript
$vault.info();
// {
// id: 'starwars',
// size: 5
// }
`

$3

Remove everything from $vault

`javascript
$vault.removeAll();
`

TODO

Testing and code-coverage


#Future
Data is still stored in memory. Add methods to save them to localStorage or indexedDB`.