got 11.4.0 → 11.6.0

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "got",
-	"version": "11.4.0",
+	"version": "11.6.0",
 	"description": "Human-friendly and powerful HTTP request library for Node.js",
 	"license": "MIT",
 	"repository": "sindresorhus/got",
@@ -10,7 +10,7 @@
 		"node": ">=10.19.0"
 	},
 	"scripts": {
-		"test": "xo && tsc --noEmit && nyc --reporter=html --reporter=text ava",
+		"test": "xo && npm run build && nyc --reporter=html --reporter=text ava",
 		"release": "np",
 		"build": "del-cli dist && tsc",
 		"prepare": "npm run build"
@@ -43,14 +43,14 @@
 		"ky"
 	],
 	"dependencies": {
-		"@sindresorhus/is": "^2.1.1",
+		"@sindresorhus/is": "^3.1.1",
 		"@szmarczak/http-timer": "^4.0.5",
 		"@types/cacheable-request": "^6.0.1",
 		"@types/responselike": "^1.0.0",
 		"cacheable-lookup": "^5.0.3",
 		"cacheable-request": "^7.0.1",
 		"decompress-response": "^6.0.0",
-		"http2-wrapper": "^1.0.0-beta.4.5",
+		"http2-wrapper": "^1.0.0-beta.5.2",
 		"lowercase-keys": "^2.0.0",
 		"p-cancelable": "^2.0.0",
 		"responselike": "^2.0.0"
@@ -59,35 +59,39 @@
 		"@ava/typescript": "^1.1.1",
 		"@sindresorhus/tsconfig": "^0.7.0",
 		"@sinonjs/fake-timers": "^6.0.1",
-		"@types/benchmark": "^1.0.31",
-		"@types/express": "^4.17.6",
-		"@types/node": "^13.13.4",
-		"@types/node-fetch": "^2.5.5",
-		"@types/request": "^2.48.4",
-		"@types/sinon": "^9.0.0",
+		"@types/benchmark": "^1.0.33",
+		"@types/express": "^4.17.7",
+		"@types/node": "^14.6.0",
+		"@types/node-fetch": "^2.5.7",
+		"@types/pem": "^1.9.5",
+		"@types/pify": "^3.0.2",
+		"@types/request": "^2.48.5",
+		"@types/sinon": "^9.0.5",
 		"@types/tough-cookie": "^4.0.0",
-		"ava": "^3.6.0",
-		"axios": "^0.19.2",
+		"ava": "^3.11.1",
+		"axios": "^0.20.0",
 		"benchmark": "^2.1.4",
-		"coveralls": "^3.0.4",
+		"coveralls": "^3.1.0",
 		"create-test-server": "^3.0.1",
-		"del-cli": "^3.0.0",
-		"delay": "^4.3.0",
+		"del-cli": "^3.0.1",
+		"delay": "^4.4.0",
 		"express": "^4.17.1",
 		"form-data": "^3.0.0",
-		"get-stream": "^5.1.0",
-		"nock": "^12.0.0",
+		"get-stream": "^6.0.0",
+		"nock": "^13.0.4",
 		"node-fetch": "^2.6.0",
-		"np": "^6.0.0",
-		"nyc": "^15.0.1",
-		"p-event": "^4.1.0",
-		"sinon": "^9.0.2",
+		"np": "^6.4.0",
+		"nyc": "^15.1.0",
+		"p-event": "^4.2.0",
+		"pem": "^1.14.4",
+		"pify": "^5.0.0",
+		"sinon": "^9.0.3",
 		"slow-stream": "0.0.4",
-		"tempy": "^0.5.0",
+		"tempy": "^0.6.0",
 		"to-readable-stream": "^2.1.0",
 		"tough-cookie": "^4.0.0",
-		"typescript": "3.8.3",
-		"xo": "^0.30.0"
+		"typescript": "^4.0.2",
+		"xo": "^0.33.0"
 	},
 	"types": "dist/source",
 	"sideEffects": false,
@@ -116,13 +120,10 @@
 		],
 		"rules": {
 			"@typescript-eslint/no-empty-function": "off",
-			"@typescript-eslint/no-base-to-string": "off",
 			"node/prefer-global/url": "off",
 			"node/prefer-global/url-search-params": "off",
-			"@typescript-eslint/prefer-readonly-parameter-types": "off",
-			"@typescript-eslint/no-floating-promises": "off",
-			"@typescript-eslint/method-signature-style": "off",
-			"unicorn/no-fn-reference-in-iterator": "off"
+			"import/no-anonymous-default-export": "off",
+			"@typescript-eslint/no-invalid-void-type": "off"
 		}
 	},
 	"runkitExampleFilename": "./documentation/examples/runkit-example.js"

package/readme.md

@@ -40,7 +40,7 @@ For browser usage, we recommend [Ky](https://github.com/sindresorhus/ky) by the
 - [Errors with metadata](#errors)
 - [JSON mode](#json-mode)
 - [WHATWG URL support](#url)
-- [HTTPS API](#https)
+- [HTTPS API](#advanced-https-api)
 - [Hooks](#hooks)
 - [Instances with custom defaults](#instances)
 - [Types](#types)
@@ -120,6 +120,8 @@ const pipeline = promisify(stream.pipeline);
 
 **Tip:** `from.pipe(to)` doesn't forward errors. Instead, use [`stream.pipeline(from, ..., to, callback)`](https://nodejs.org/api/stream.html#stream_stream_pipeline_streams_callback).
 
+**Note:** While `got.post('https://example.com')` resolves, `got.stream.post('https://example.com')` will hang indefinitely until a body is provided. If there's no body on purpose, remember to `.end()` the stream or set the [`body`](#body) option to an empty string.
+
 ### API
 
 It's a `GET` request by default, but can be changed by using different methods or via [`options.method`](#method).
@@ -508,12 +510,10 @@ Default:
 
 An object representing `limit`, `calculateDelay`, `methods`, `statusCodes`, `maxRetryAfter` and `errorCodes` fields for maximum retry count, retry handler, allowed methods, allowed status codes, maximum [`Retry-After`](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After) time and allowed error codes.
 
-**Note:** When using streams, this option is ignored. If the connection is reset when downloading, you need to catch the error and clear the file you were writing into to prevent duplicated content.
-
 If `maxRetryAfter` is set to `undefined`, it will use `options.timeout`.\
 If [`Retry-After`](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After) header is greater than `maxRetryAfter`, it will cancel the request.
 
-Delays between retries counts with function `1000 * Math.pow(2, retry) + Math.random() * 100`, where `retry` is attempt number (starts from 1).
+Delays between retries counts with function `1000 * Math.pow(2, retry - 1) + Math.random() * 100`, where `retry` is attempt number (starts from 1).
 
 The `calculateDelay` property is a `function` that receives an object with `attemptCount`, `retryOptions`, `error` and `computedValue` properties for current retry count, the retry options, error and default computed value. The function must return a delay in milliseconds (or a Promise resolving with it) (`0` return value cancels retry).
 
@@ -527,6 +527,36 @@ By default, it retries *only* on the specified methods, status codes, and on the
 - `ENETUNREACH`: No internet connection.
 - `EAI_AGAIN`: DNS lookup timed out.
 
+<a name="retry-stream"></a>
+
+You can retry Got streams too. The implementation looks like this:
+
+```js
+const got = require('got');
+const fs = require('fs');
+
+let writeStream;
+
+const fn = (retryCount = 0) => {
+	const stream = got.stream('https://example.com');
+	stream.retryCount = retryCount;
+
+	if (writeStream) {
+		writeStream.destroy();
+	}
+
+	writeStream = fs.createWriteStream('example.com');
+
+	stream.pipe(writeStream);
+
+	// If you don't attach the listener, it will NOT make a retry.
+	// It automatically checks the listener count so it knows whether to retry or not :)
+	stream.once('retry', fn);
+};
+
+fn();
+```
+
 ###### followRedirect
 
 Type: `boolean`\
@@ -577,6 +607,13 @@ Default: `false`
 
 [Cache adapter instance](#cache-adapters) for storing cached response data.
 
+###### cacheOptions
+
+Type: `object | undefined`\
+Default: `{}`
+
+[Cache options](https://github.com/kornelski/http-cache-semantics#constructor-options) used for the specified request.
+
 ###### dnsCache
 
 Type: `CacheableLookup | false`\
@@ -697,7 +734,7 @@ Default: `[]`
 
 Called with [normalized](source/core/index.ts) [request options](#options). Got will make no further changes to the request before it is sent. This is especially useful in conjunction with [`got.extend()`](#instances) when you want to create an API client that, for example, uses HMAC-signing.
 
-See the [AWS section](#aws) for an example.
+**Tip:** You can override the `request` function by returning a [`ClientRequest`-like](https://nodejs.org/api/http.html#http_class_http_clientrequest) instance or a [`IncomingMessage`-like](https://nodejs.org/api/http.html#http_class_http_incomingmessage) instance. This is very useful when creating a custom cache mechanism.
 
 ###### hooks.beforeRedirect
 
@@ -908,6 +945,13 @@ Default: `Infinity`
 
 The maximum amount of items that should be emitted.
 
+###### pagination.backoff
+
+Type: `number`\
+Default: `0`
+
+Milliseconds to wait before the next request is triggered.
+
 ###### pagination.requestLimit
 
 Type: `number`\
@@ -1241,6 +1285,13 @@ If the `content-length` header is missing, `total` will be `undefined`.
 })();
 ```
 
+##### .once('retry', retryCount, error)
+
+To enable retrying on a Got stream, it is required to have a `retry` handler attached.\
+When this event is emitted, you should reset the stream you were writing to and prepare the body again.
+
+See the [`retry`](#retry-stream) option for an example implementation.
+
 ##### .ip
 
 Type: `string`
@@ -1563,13 +1614,13 @@ const addAccessToken = (accessToken: string): BeforeRequestHook => options => {
 Each error contains an `options` property which are the options Got used to create a request - just to make debugging easier.\
 Additionaly, the errors may have `request` (Got Stream) and `response` (Got Response) properties depending on which phase of the request failed.
 
-#### got.CacheError
+#### got.RequestError
 
-When a cache method fails, for example, if the database goes down or there's a filesystem error.
+When a request fails. Contains a `code` property with error class code, like `ECONNREFUSED`. All the errors below inherit this one.
 
-#### got.RequestError
+#### got.CacheError
 
-When a request fails. Contains a `code` property with error class code, like `ECONNREFUSED`.
+When a cache method fails, for example, if the database goes down or there's a filesystem error.
 
 #### got.ReadError
 
@@ -1579,6 +1630,10 @@ When reading from response stream fails.
 
 When server response code is 2xx, and parsing body fails. Includes a `response` property.
 
+#### got.UploadError
+
+When the request body is a stream and an error occurs while reading from that stream.
+
 #### got.HTTPError
 
 When the server response code is not 2xx nor 3xx if `options.followRedirect` is `true`, but always except for 304. Includes a `response` property.
@@ -1591,14 +1646,14 @@ When the server redirects you more than ten times. Includes a `response` propert
 
 When given an unsupported protocol.
 
-#### got.CancelError
-
-When the request is aborted with `.cancel()`.
-
 #### got.TimeoutError
 
 When the request is aborted due to a [timeout](#timeout). Includes an `event` and `timings` property.
 
+#### got.CancelError
+
+When the request is aborted with `.cancel()`.
+
 ## Aborting the request
 
 The promise returned by Got has a [`.cancel()`](https://github.com/sindresorhus/p-cancelable) method which when called, aborts the request.
@@ -1726,7 +1781,7 @@ const tunnel = require('tunnel');
 
 got('https://sindresorhus.com', {
 	agent: {
-		https: tunnel.httpOverHttp({
+		https: tunnel.httpsOverHttp({
 			proxy: {
 				host: 'localhost'
 			}
@@ -1735,8 +1790,30 @@ got('https://sindresorhus.com', {
 });
 ```
 
+Otherwise, you can use the [`hpagent`](https://github.com/delvedor/hpagent) package, which keeps the internal sockets alive to be reused.
+
+```js
+const got = require('got');
+const {HttpsProxyAgent} = require('hpagent');
+
+got('https://sindresorhus.com', {
+	agent: {
+		https: new HttpsProxyAgent({
+			keepAlive: true,
+			keepAliveMsecs: 1000,
+			maxSockets: 256,
+			maxFreeSockets: 256,
+			scheduling: 'lifo',
+			proxy: 'https://localhost:8080'
+		})
+	}
+});
+```
+
 Alternatively, use [`global-agent`](https://github.com/gajus/global-agent) to configure a global proxy for all HTTP/HTTPS traffic in your program.
 
+Read the [`http2-wrapper`](https://github.com/szmarczak/http2-wrapper/#proxy-support) docs to learn about proxying for HTTP/2.
+
 ## Cookies
 
 You can use the [`tough-cookie`](https://github.com/salesforce/tough-cookie) package:
@@ -1823,29 +1900,14 @@ got('unix:/var/run/docker.sock:/containers/json');
 
 ## AWS
 
-Requests to AWS services need to have their headers signed. This can be accomplished by using the [`aws4`](https://www.npmjs.com/package/aws4) package. This is an example for querying an ["API Gateway"](https://docs.aws.amazon.com/apigateway/api-reference/signing-requests/) with a signed request.
+Requests to AWS services need to have their headers signed. This can be accomplished by using the [`got4aws`](https://www.npmjs.com/package/got4aws) package. This is an example for querying an ["API Gateway"](https://docs.aws.amazon.com/apigateway/api-reference/signing-requests/) with a signed request.
 
 ```js
-const got = require('got');
-const AWS = require('aws-sdk');
-const aws4 = require('aws4');
+const got4aws = require('got4aws');;
 
-const chain = new AWS.CredentialProviderChain();
+const awsClient = got4aws();
 
-// Create a Got instance to use relative paths and signed requests
-const awsClient = got.extend({
-	prefixUrl: 'https://<api-id>.execute-api.<api-region>.amazonaws.com/<stage>/',
-	hooks: {
-		beforeRequest: [
-			async options => {
-				const credentials = await chain.resolvePromise();
-				aws4.sign(options, credentials);
-			}
-		]
-	}
-});
-
-const response = await awsClient('endpoint/path', {
+const response = await awsClient('https://<api-id>.execute-api.<api-region>.amazonaws.com/<stage>/endpoint/path', {
 	// Request-specific options
 });
 ```
@@ -1869,6 +1931,32 @@ nock('https://sindresorhus.com')
 })();
 ```
 
+Bear in mind, that by default `nock` mocks only one request. Got will [retry](#retry) on failed requests by default, causing a `No match for request ...` error. The solution is to either disable retrying (set `options.retry` to `0`) or call `.persist()` on the mocked request.
+
+```js
+const got = require('got');
+const nock = require('nock');
+
+const scope = nock('https://sindresorhus.com')
+	.get('/')
+	.reply(500, 'Internal server error')
+	.persist();
+
+(async () => {
+	try {
+		await got('https://sindresorhus.com')
+	} catch (error) {
+		console.log(error.response.body);
+		//=> 'Internal server error'
+
+		console.log(error.response.retryCount);
+		//=> 2
+	}
+
+	scope.persist(false);
+})();
+```
+
 For real integration testing we recommend using [`ava`](https://github.com/avajs/ava) with [`create-test-server`](https://github.com/lukechilds/create-test-server). We're using a macro so we don't have to `server.listen()` and `server.close()` every test. Take a look at one of our tests:
 
 ```js
@@ -2019,11 +2107,14 @@ The Electron `net` module is not consistent with the Node.js `http` module. See
 | Bugs                  | [![][gbg]][g6]     | [![][rbg]][r6]     | [![][nbg]][n6]       | [![][kbg]][k6]           | [![][abg]][a6]     | [![][sbg]][s6]         |
 | Dependents            | [![][gdp]][g7]     | [![][rdp]][r7]     | [![][ndp]][n7]       | [![][kdp]][k7]           | [![][adp]][a7]     | [![][sdp]][s7]         |
 | Install size          | [![][gis]][g8]     | [![][ris]][r8]     | [![][nis]][n8]       | [![][kis]][k8]           | [![][ais]][a8]     | [![][sis]][s8]         |
+| GitHub stars          | [![][gs]][g9]      | [![][rs]][r9]      | [![][ns]][n9]        | [![][ks]][k9]            | [![][as]][a9]      | [![][ss]][s9]          |
+| TypeScript support    | [![][gts]][g10]    | [![][rts]][r10]    | [![][nts]][n10]      | [![][kts]][k10]          | [![][ats]][a10]    | [![][sts]][s11]        |
+| Last commit           | [![][glc]][g11]    | [![][rlc]][r11]    | [![][nlc]][n11]      | [![][klc]][k11]          | [![][alc]][a11]    | [![][slc]][s11]        |
 
 \* It's almost API compatible with the browser `fetch` API.\
 \*\* Need to switch the protocol manually. Doesn't accept PUSH streams and doesn't reuse HTTP/2 sessions.\
 \*\*\* Currently, only `DownloadProgress` event is supported, `UploadProgress` event is not supported.\
-:sparkle: Almost-stable feature, but the API may change. Don't hestitate to try it out!\
+:sparkle: Almost-stable feature, but the API may change. Don't hesitate to try it out!\
 :grey_question: Feature in early stage of development. Very experimental.
 
 <!-- GITHUB -->
@@ -2153,9 +2244,54 @@ The Electron `net` module is not consistent with the Node.js `http` module. See
 [a8]: https://packagephobia.now.sh/result?p=axios
 [s8]: https://packagephobia.now.sh/result?p=superagent
 
+<!-- GITHUB STARS -->
+[gs]: https://badgen.net/github/stars/sindresorhus/got?label
+[ks]: https://badgen.net/github/stars/sindresorhus/ky?label
+[rs]: https://badgen.net/github/stars/request/request?label
+[ns]: https://badgen.net/github/stars/bitinn/node-fetch?label
+[as]: https://badgen.net/github/stars/axios/axios?label
+[ss]: https://badgen.net/github/stars/visionmedia/superagent?label
+
+[g9]: https://github.com/sindresorhus/got
+[k9]: https://github.com/sindresorhus/ky
+[r9]: https://github.com/request/request
+[n9]: https://github.com/node-fetch/node-fetch
+[a9]: https://github.com/axios/axios
+[s9]: https://github.com/visionmedia/superagent
+
+<!-- TYPESCRIPT SUPPORT -->
+[gts]: https://badgen.net/npm/types/got?label
+[kts]: https://badgen.net/npm/types/ky?label
+[rts]: https://badgen.net/npm/types/request?label
+[nts]: https://badgen.net/npm/types/node-fetch?label
+[ats]: https://badgen.net/npm/types/axios?label
+[sts]: https://badgen.net/npm/types/superagent?label
+
+[g10]: https://github.com/sindresorhus/got
+[k10]: https://github.com/sindresorhus/ky
+[r10]: https://github.com/request/request
+[n10]: https://github.com/node-fetch/node-fetch
+[a10]: https://github.com/axios/axios
+[s10]: https://github.com/visionmedia/superagent
+
+<!-- LAST COMMIT -->
+[glc]: https://badgen.net/github/last-commit/sindresorhus/got?label
+[klc]: https://badgen.net/github/last-commit/sindresorhus/ky?label
+[rlc]: https://badgen.net/github/last-commit/request/request?label
+[nlc]: https://badgen.net/github/last-commit/bitinn/node-fetch?label
+[alc]: https://badgen.net/github/last-commit/axios/axios?label
+[slc]: https://badgen.net/github/last-commit/visionmedia/superagent?label
+
+[g11]: https://github.com/sindresorhus/got/commits
+[k11]: https://github.com/sindresorhus/ky/commits
+[r11]: https://github.com/request/request/commits
+[n11]: https://github.com/node-fetch/node-fetch/commits
+[a11]: https://github.com/axios/axios/commits
+[s11]: https://github.com/visionmedia/superagent/commits
+
 [Click here][InstallSizeOfTheDependencies] to see the install size of the Got dependencies.
 
-[InstallSizeOfTheDependencies]: https://packagephobia.now.sh/result?p=@sindresorhus/is@1.0.0,@szmarczak/http-timer@3.1.0,@types/cacheable-request@6.0.1,cacheable-lookup@0.2.1,cacheable-request@7.0.0,decompress-response@5.0.0,duplexer3@0.1.4,get-stream@5.0.0,lowercase-keys@2.0.0,mimic-response@2.0.0,p-cancelable@2.0.0,responselike@2.0.0,to-readable-stream@2.0.0,type-fest@0.8.0
+[InstallSizeOfTheDependencies]: https://packagephobia.com/result?p=@sindresorhus/is@3.0.0,@szmarczak/http-timer@4.0.5,@types/cacheable-request@6.0.1,@types/responselike@1.0.0,cacheable-lookup@5.0.3,cacheable-request@7.0.1,decompress-response@6.0.0,http2-wrapper@1.0.0,lowercase-keys@2.0.0,p-cancelable@2.0.0,responselike@2.0.0
 
 ## Related
 

package/dist/source/as-promise/calculate-retry-delay.js

@@ -1,38 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const types_1 = require("./types");
-const retryAfterStatusCodes = new Set([413, 429, 503]);
-const isErrorWithResponse = (error) => (error instanceof types_1.HTTPError || error instanceof types_1.ParseError || error instanceof types_1.MaxRedirectsError);
-const calculateRetryDelay = ({ attemptCount, retryOptions, error }) => {
-    if (attemptCount > retryOptions.limit) {
-        return 0;
-    }
-    const hasMethod = retryOptions.methods.includes(error.options.method);
-    const hasErrorCode = retryOptions.errorCodes.includes(error.code);
-    const hasStatusCode = isErrorWithResponse(error) && retryOptions.statusCodes.includes(error.response.statusCode);
-    if (!hasMethod || (!hasErrorCode && !hasStatusCode)) {
-        return 0;
-    }
-    if (isErrorWithResponse(error)) {
-        const { response } = error;
-        if (response && 'retry-after' in response.headers && retryAfterStatusCodes.has(response.statusCode)) {
-            let after = Number(response.headers['retry-after']);
-            if (Number.isNaN(after)) {
-                after = Date.parse(response.headers['retry-after']) - Date.now();
-            }
-            else {
-                after *= 1000;
-            }
-            if (retryOptions.maxRetryAfter === undefined || after > retryOptions.maxRetryAfter) {
-                return 0;
-            }
-            return after;
-        }
-        if (response.statusCode === 413) {
-            return 0;
-        }
-    }
-    const noise = Math.random() * 100;
-    return ((2 ** (attemptCount - 1)) * 1000) + noise;
-};
-exports.default = calculateRetryDelay;

package/dist/source/as-promise/core.d.ts

@@ -1,13 +0,0 @@
-/// <reference types="node" />
-import { URL } from 'url';
-import { Options, NormalizedOptions, Defaults, ResponseType, Response } from './types';
-import Request, { ParseJsonFunction } from '../core';
-export declare const knownBodyTypes: string[];
-export declare const parseBody: (response: Response<unknown>, responseType: ResponseType, parseJson: ParseJsonFunction, encoding?: string | undefined) => unknown;
-export default class PromisableRequest extends Request {
-    ['constructor']: typeof PromisableRequest;
-    options: NormalizedOptions;
-    static normalizeArguments(url?: string | URL, nonNormalizedOptions?: Options, defaults?: Defaults): NormalizedOptions;
-    static mergeOptions(...sources: Options[]): NormalizedOptions;
-    _beforeError(error: Error): Promise<void>;
-}

package/dist/source/as-promise/core.js

@@ -1,124 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const is_1 = require("@sindresorhus/is");
-const types_1 = require("./types");
-const core_1 = require("../core");
-if (!core_1.knownHookEvents.includes('beforeRetry')) {
-    core_1.knownHookEvents.push('beforeRetry', 'afterResponse');
-}
-exports.knownBodyTypes = ['json', 'buffer', 'text'];
-// @ts-ignore The error is: Not all code paths return a value.
-exports.parseBody = (response, responseType, parseJson, encoding) => {
-    const { rawBody } = response;
-    try {
-        if (responseType === 'text') {
-            return rawBody.toString(encoding);
-        }
-        if (responseType === 'json') {
-            return rawBody.length === 0 ? '' : parseJson(rawBody.toString());
-        }
-        if (responseType === 'buffer') {
-            return Buffer.from(rawBody);
-        }
-        throw new types_1.ParseError({
-            message: `Unknown body type '${responseType}'`,
-            name: 'Error'
-        }, response);
-    }
-    catch (error) {
-        throw new types_1.ParseError(error, response);
-    }
-};
-class PromisableRequest extends core_1.default {
-    static normalizeArguments(url, nonNormalizedOptions, defaults) {
-        const options = super.normalizeArguments(url, nonNormalizedOptions, defaults);
-        if (is_1.default.null_(options.encoding)) {
-            throw new TypeError('To get a Buffer, set `options.responseType` to `buffer` instead');
-        }
-        is_1.assert.any([is_1.default.string, is_1.default.undefined], options.encoding);
-        is_1.assert.any([is_1.default.boolean, is_1.default.undefined], options.resolveBodyOnly);
-        is_1.assert.any([is_1.default.boolean, is_1.default.undefined], options.methodRewriting);
-        is_1.assert.any([is_1.default.boolean, is_1.default.undefined], options.isStream);
-        is_1.assert.any([is_1.default.string, is_1.default.undefined], options.responseType);
-        // `options.responseType`
-        if (options.responseType === undefined) {
-            options.responseType = 'text';
-        }
-        // `options.retry`
-        const { retry } = options;
-        if (defaults) {
-            options.retry = { ...defaults.retry };
-        }
-        else {
-            options.retry = {
-                calculateDelay: retryObject => retryObject.computedValue,
-                limit: 0,
-                methods: [],
-                statusCodes: [],
-                errorCodes: [],
-                maxRetryAfter: undefined
-            };
-        }
-        if (is_1.default.object(retry)) {
-            options.retry = {
-                ...options.retry,
-                ...retry
-            };
-            options.retry.methods = [...new Set(options.retry.methods.map(method => method.toUpperCase()))];
-            options.retry.statusCodes = [...new Set(options.retry.statusCodes)];
-            options.retry.errorCodes = [...new Set(options.retry.errorCodes)];
-        }
-        else if (is_1.default.number(retry)) {
-            options.retry.limit = retry;
-        }
-        if (is_1.default.undefined(options.retry.maxRetryAfter)) {
-            options.retry.maxRetryAfter = Math.min(...[options.timeout.request, options.timeout.connect].filter(is_1.default.number));
-        }
-        // `options.pagination`
-        if (is_1.default.object(options.pagination)) {
-            if (defaults) {
-                options.pagination = {
-                    ...defaults.pagination,
-                    ...options.pagination
-                };
-            }
-            const { pagination } = options;
-            if (!is_1.default.function_(pagination.transform)) {
-                throw new Error('`options.pagination.transform` must be implemented');
-            }
-            if (!is_1.default.function_(pagination.shouldContinue)) {
-                throw new Error('`options.pagination.shouldContinue` must be implemented');
-            }
-            if (!is_1.default.function_(pagination.filter)) {
-                throw new TypeError('`options.pagination.filter` must be implemented');
-            }
-            if (!is_1.default.function_(pagination.paginate)) {
-                throw new Error('`options.pagination.paginate` must be implemented');
-            }
-        }
-        // JSON mode
-        if (options.responseType === 'json' && options.headers.accept === undefined) {
-            options.headers.accept = 'application/json';
-        }
-        return options;
-    }
-    static mergeOptions(...sources) {
-        let mergedOptions;
-        for (const source of sources) {
-            mergedOptions = PromisableRequest.normalizeArguments(undefined, source, mergedOptions);
-        }
-        return mergedOptions;
-    }
-    async _beforeError(error) {
-        if (this.destroyed) {
-            return;
-        }
-        if (!(error instanceof core_1.RequestError)) {
-            error = new core_1.RequestError(error.message, error, this);
-        }
-        // Let the promise decide whether to abort or not
-        // It is also responsible for the `beforeError` hook
-        this.emit('error', error);
-    }
-}
-exports.default = PromisableRequest;