# Now Storage

Use Now static deployments to upload and store files.

## Usage

Install it with yarn

```bash
yarn add now-storage
```

Or with npm

```bash
npm i now-storage
```

Then load it inside your app.

```js
const { upload } = require('now-storage');
```

And call the `upload` function with your [the Now token](https://zeit.co/account/tokens) and the file to upload.

```js
const { url } = await upload(process.env.NOW_TOKEN, {
  name: 'my-file.txt',
  content: 'This is a file uploaded with now-storage.'
});
```

The `url` is going to be a string similar to
[http://now-storage-bmjowtcani.now.sh/](http://now-storage-bmjowtcani.now.sh/).

### Configuration

All the deployments are going to have the name `now-storage` and the `upload`
function is going to retry maximum 3 times to upload the file and another 3
times to create the deployment.

That could be configured passing a third argument to the `upload method` with an
object using the following format.

```js
await upload(process.env.NOW_TOKEN, {
  name: 'my-file.txt',
  content: 'This is a file uploaded with now-storage.'
}, {
  deploymentName: 'now-storage',
  retry: {
    retries: 3
  }
});
```

That's the default configuration, the `retry` key could receive any
configuration from `async-retry`.

To deploy to a team account instead of your personal account add `teamId` to the
config.

```js
await upload(process.env.NOW_TOKEN, {
  name: 'my-file.txt',
  content: 'This is a file uploaded with now-storage.'
}, { teamId: 'my-awsm-team' });
```