got4aws !CI

> Convenience wrapper for Got to interact with AWS v4 signed APIs

Install

``
$ npm install got4aws
`

Usage

Instead of:

`ts
import got from 'got';
import * as aws4 from 'aws4';
import * as url from 'url';

(async () => {
const {protocol, host, path} = url.parse('https://12abc34.execute-api.us-east-1.amazonaws.com/v0');

const request = {
protocol,
host,
path,
responseType: 'json'
};

aws4.sign(request);

const {body} = await got.get(request);

console.log(body);
//=> {status: 'ok'}
})();
`

You can do:

`ts
import got4aws from 'got4aws';

const got = got4aws();

(async () => {
const {body} = await got.get('https://12abc34.execute-api.us-east-1.amazonaws.com/v0');

console.log(body);
//=> {status: 'ok'}
})();
`

If you want to load credentials from somewhere else, you can provide extra options to the factory function.

`ts
import got4aws from 'got4aws';

// Load credentials from ~/.aws/credentials
const got = got4aws({
providers: new AWS.SharedIniFileCredentials({profile: 'myProfile'})
});

(async () => {
const {body} = await got.get('https://12abc34.execute-api.us-east-1.amazonaws.com/v0');

console.log(body);
//=> {status: 'ok'}
})();
`

If you want to invoke an API Gateway endpoint with a custom domain, you will have to set the service and region as well because they can't be inferred.

`ts
import got4aws from 'got4aws';

const got = got4aws({
providers: new AWS.SharedIniFileCredentials({profile: 'myProfile'}),
service: 'execute-api',
region: 'eu-west-1'
});

(async () => {
const {body} = await got.get('https://api.unicorn.com/v0');

console.log(body);
//=> {status: 'ok'}
})();
`

API

$3

Returns a Got instance with a default responseType set to json.

#### options

##### providers

Type: [Credentials | Credentials[]](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/Credentials.html)

Default: EnvironmentCredentials

A provider or a list of providers used to search for AWS credentials. If no providers are provided, it will use the EnvironmentCredentials provider.

See the CredentialProviderChain documentation for more information.

##### service

Type: string

Default: inferred through URL

The AWS service the request is being signed for. Will try to be inferred by the URL if not provided.

For example, when signing a request for API Gateway with a custom domain, this should be execute-api.

##### region

Type: string

Default: inferred through URL

The region of the service being invoked. If it could not be inferred through the URL, it will default to us-east-1`.