memo-storage/README.md

Storage based cache service

# memo-storage

Storage based cache service

### API

- `configure(options: ConfigureOptions): void` - set initial options for the instance
- `ms(parameters: Parameters): Result` - memo storage instance

### Types

```typescript
type Parameters {
  method: Function; // method the results of which will be cached
  params?: Array<any>; // list of method arguments
  key?: string; // default method name
  expire?: number; // time in milliseconds after which the cache will be cleared
  invalidate?: boolean; // flag to delete data from cache
}

type ConfigureOptions = {
  logger?: Function;
  onSave?: (key: string, value: any) => any; // handle on set the data in the storage
  onReceive?: (key: string) => any; // handle on receive the data from the storage
  onInvalidate?: (key: string) => any; // handle on delete the data from the storage
  responseParser?: (response: any) => any; // // process the result returned by the method from the passed parameters
};

type Result {
  data: any;
  expire: number;
}

```

### Quick start

```
npm install memo-storage
```

```js
// storage.js

export default {
  set: function(key, value) {
    this.data[key] = value;
  },
  get: function(key) {
    return this.data[key];
  },
  remove: function(key) {
    delete this.data[key];
  },
  data: {},
};
```

```js
// example.js
import Storage from 'storage';
import ms, { configure } from 'memo-storage';

configure({
  onSave: Storage.set,
  onReceive: Storage.get,
  onInvalidate: Storage.remove,
});

const foo = params =>
  ms({
    method: v => Promise.resolve(v),
    params: [params],
    expire: 1000,
  });

foo(1).then(console.log); // { data: 1, expire: 1572288209544 } from promise
foo(1).then(console.log); // { data: 1, expire: 1572288209544 } from cache
```