token-interceptor/readme.md

<p align="center"> <img alt="token-interceptor" title="token-interceptor" src="logo.svg" width="450"> </p>

<p align="center">
  <img alt="token-interceptor" title="token-interceptor" src="logo.svg" width="450">
</p>

<p align="center">
  <a href="https://expressjs.com/">Express</a> Middleware to Intercept token and make stuff, like refresh it.
</p>

## Install

```
yarn add token-interceptor
```

## Usage

```js
const express = require('express')
const intercept = require('svgson-next').default
const app = express()

app.use('/refresh', intercept({ url: 'https://api.service.io' }))
```

## API

intercept([options])

#### options

Type: `Object`

##### url

Endpoint where to forward token as `Bearer`

Type: `String`

##### handler

Asyncronous Function to process `token`

Type: `Function`

```js
{
  handler: async token => Promise.resolve(token)
}
```

##### getToken

Get input token from `req`

Type: `Function`

Required: true

```js
{
  getToken: req => req.body.token,
}
```

##### key

Key to search when catching token if no `getToken` passed

After check token as Authorization Bearer, will check as `query[key]`, `cookies[key]` and `body[key]`. That automatich checks will berun if no `getToken` option is passed.

Type: `String`

Default: `refreshToken`

##### errorHandler

If passed has `err` as argument, otherwise `next(err)`

```js
{
  errorHandler: err => console.log(err)
}
```

Type: `Function`