got 13.0.0 → 14.1.0

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

@@ -3,7 +3,7 @@ import type { Buffer } from 'node:buffer';
 import type PCancelable from 'p-cancelable';
 import { RequestError } from '../core/errors.js';
 import type Request from '../core/index.js';
-import type { RequestEvents } from '../core/index.js';
+import { type RequestEvents } from '../core/index.js';
 import type { Response } from '../core/response.js';
 /**
 An error to be thrown when the request is aborted with `.cancel()`.

package/dist/source/core/errors.d.ts

@@ -9,12 +9,12 @@ type Error = NodeJS.ErrnoException;
 An error to be thrown when a request fails.
 Contains a `code` property with error class code, like `ECONNREFUSED`.
 */
-export declare class RequestError extends Error {
+export declare class RequestError<T = unknown> extends Error {
     input?: string;
     code: string;
     stack: string;
     readonly options: Options;
-    readonly response?: Response;
+    readonly response?: Response<T>;
     readonly request?: Request;
     readonly timings?: Timings;
     constructor(message: string, error: Partial<Error & {
@@ -35,8 +35,8 @@ export declare class MaxRedirectsError extends RequestError {
 An error to be thrown when the server response code is not 2xx nor 3xx if `options.followRedirect` is `true`, but always except for 304.
 Includes a `response` property.
 */
-export declare class HTTPError extends RequestError {
-    readonly response: Response;
+export declare class HTTPError<T = any> extends RequestError<T> {
+    readonly response: Response<T>;
     readonly request: Request;
     readonly timings: Timings;
     constructor(response: PlainResponse);

package/dist/source/core/errors.js

@@ -8,44 +8,14 @@ An error to be thrown when a request fails.
 Contains a `code` property with error class code, like `ECONNREFUSED`.
 */
 export class RequestError extends Error {
+    input;
+    code;
+    stack;
+    response;
+    request;
+    timings;
     constructor(message, error, self) {
         super(message);
-        Object.defineProperty(this, "input", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "code", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "stack", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "response", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "request", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "timings", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
         Error.captureStackTrace(this, this.constructor);
         this.name = 'RequestError';
         this.code = error.code ?? 'ERR_GOT_REQUEST_ERROR';
@@ -93,6 +63,7 @@ export class MaxRedirectsError extends RequestError {
 An error to be thrown when the server response code is not 2xx nor 3xx if `options.followRedirect` is `true`, but always except for 304.
 Includes a `response` property.
 */
+// TODO: Change `HTTPError<T = any>` to `HTTPError<T = unknown>` in the next major version to enforce type usage.
 // eslint-disable-next-line @typescript-eslint/naming-convention
 export class HTTPError extends RequestError {
     constructor(response) {
@@ -127,20 +98,10 @@ An error to be thrown when the request is aborted due to a timeout.
 Includes an `event` and `timings` property.
 */
 export class TimeoutError extends RequestError {
+    timings;
+    event;
     constructor(error, timings, request) {
         super(error.message, error, request);
-        Object.defineProperty(this, "timings", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "event", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
         this.name = 'TimeoutError';
         this.event = error.event;
         this.timings = timings;

package/dist/source/core/index.d.ts

@@ -4,9 +4,9 @@
 /// <reference types="node" resolution-mode="require"/>
 /// <reference types="node" resolution-mode="require"/>
 import { Duplex } from 'node:stream';
-import type { ClientRequest } from 'node:http';
+import { type ClientRequest } from 'node:http';
 import type { Socket } from 'node:net';
-import type { Timings } from '@szmarczak/http-timer';
+import { type Timings } from '@szmarczak/http-timer';
 import Options from './options.js';
 import { type PlainResponse, type Response } from './response.js';
 import { RequestError } from './errors.js';

package/dist/source/core/index.js

@@ -6,7 +6,7 @@ import timer from '@szmarczak/http-timer';
 import CacheableRequest, { CacheError as CacheableCacheError, } from 'cacheable-request';
 import decompressResponse from 'decompress-response';
 import is from '@sindresorhus/is';
-import getStream from 'get-stream';
+import { getStreamAsBuffer } from 'get-stream';
 import { FormDataEncoder, isFormData as isFormDataLike } from 'form-data-encoder';
 import getBodySize from './utils/get-body-size.js';
 import isFormData from './utils/is-form-data.js';
@@ -20,7 +20,6 @@ import { isResponseOk } from './response.js';
 import isClientRequest from './utils/is-client-request.js';
 import isUnixSocketURL from './utils/is-unix-socket-url.js';
 import { RequestError, ReadError, MaxRedirectsError, HTTPError, TimeoutError, UploadError, CacheError, AbortError, } from './errors.js';
-const { buffer: getStreamAsBuffer } = getStream;
 const supportsBrotli = is.string(process.versions.brotli);
 const methodsWithoutBody = new Set(['GET', 'HEAD']);
 const cacheableStore = new WeakableMap();
@@ -34,6 +33,34 @@ const proxiedRequestEvents = [
 ];
 const noop = () => { };
 export default class Request extends Duplex {
+    // @ts-expect-error - Ignoring for now.
+    ['constructor'];
+    _noPipe;
+    // @ts-expect-error https://github.com/microsoft/TypeScript/issues/9568
+    options;
+    response;
+    requestUrl;
+    redirectUrls;
+    retryCount;
+    _stopRetry;
+    _downloadedSize;
+    _uploadedSize;
+    _stopReading;
+    _pipedServerResponses;
+    _request;
+    _responseSize;
+    _bodySize;
+    _unproxyEvents;
+    _isFromCache;
+    _cannotHaveBody;
+    _triggerRead;
+    _cancelTimeouts;
+    _removeListeners;
+    _nativeResponse;
+    _flushed;
+    _aborted;
+    // We need this because `this._request` if `undefined` when using cache
+    _requestInitialized;
     constructor(url, options, defaults) {
         super({
             // Don't destroy immediately, as the error may be emitted on unsuccessful retry
@@ -41,159 +68,6 @@ export default class Request extends Duplex {
             // It needs to be zero because we're just proxying the data to another stream
             highWaterMark: 0,
         });
-        // @ts-expect-error - Ignoring for now.
-        Object.defineProperty(this, 'constructor', {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "_noPipe", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        // @ts-expect-error https://github.com/microsoft/TypeScript/issues/9568
-        Object.defineProperty(this, "options", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "response", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "requestUrl", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "redirectUrls", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "retryCount", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "_stopRetry", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "_downloadedSize", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "_uploadedSize", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "_stopReading", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "_pipedServerResponses", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "_request", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "_responseSize", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "_bodySize", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "_unproxyEvents", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "_isFromCache", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "_cannotHaveBody", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "_triggerRead", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "_cancelTimeouts", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "_removeListeners", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "_nativeResponse", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "_flushed", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "_aborted", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        // We need this because `this._request` if `undefined` when using cache
-        Object.defineProperty(this, "_requestInitialized", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
         this._downloadedSize = 0;
         this._uploadedSize = 0;
         this._stopReading = false;
@@ -313,7 +187,7 @@ export default class Request extends Duplex {
         void (async () => {
             // Node.js parser is really weird.
             // It emits post-request Parse Errors on the same instance as previous request. WTF.
-            // Therefore we need to check if it has been destroyed as well.
+            // Therefore, we need to check if it has been destroyed as well.
             //
             // Furthermore, Node.js 16 `response.destroy()` doesn't immediately destroy the socket,
             // but makes the response unreadable. So we additionally need to check `response.readable`.
@@ -611,6 +485,7 @@ export default class Request extends Duplex {
         if (is.object(options.cookieJar) && rawCookies) {
             let promises = rawCookies.map(async (rawCookie) => options.cookieJar.setCookie(rawCookie, url.toString()));
             if (options.ignoreInvalidCookies) {
+                // eslint-disable-next-line @typescript-eslint/no-floating-promises
                 promises = promises.map(async (promise) => {
                     try {
                         await promise;
@@ -630,76 +505,79 @@ export default class Request extends Duplex {
         if (this.isAborted) {
             return;
         }
-        if (options.followRedirect && response.headers.location && redirectCodes.has(statusCode)) {
+        if (response.headers.location && redirectCodes.has(statusCode)) {
             // We're being redirected, we don't care about the response.
             // It'd be best to abort the request, but we can't because
             // we would have to sacrifice the TCP connection. We don't want that.
-            response.resume();
-            this._cancelTimeouts();
-            this._unproxyEvents();
-            if (this.redirectUrls.length >= options.maxRedirects) {
-                this._beforeError(new MaxRedirectsError(this));
-                return;
-            }
-            this._request = undefined;
-            const updatedOptions = new Options(undefined, undefined, this.options);
-            const serverRequestedGet = statusCode === 303 && updatedOptions.method !== 'GET' && updatedOptions.method !== 'HEAD';
-            const canRewrite = statusCode !== 307 && statusCode !== 308;
-            const userRequestedGet = updatedOptions.methodRewriting && canRewrite;
-            if (serverRequestedGet || userRequestedGet) {
-                updatedOptions.method = 'GET';
-                updatedOptions.body = undefined;
-                updatedOptions.json = undefined;
-                updatedOptions.form = undefined;
-                delete updatedOptions.headers['content-length'];
-            }
-            try {
-                // We need this in order to support UTF-8
-                const redirectBuffer = Buffer.from(response.headers.location, 'binary').toString();
-                const redirectUrl = new URL(redirectBuffer, url);
-                if (!isUnixSocketURL(url) && isUnixSocketURL(redirectUrl)) {
-                    this._beforeError(new RequestError('Cannot redirect to UNIX socket', {}, this));
+            const shouldFollow = typeof options.followRedirect === 'function' ? options.followRedirect(typedResponse) : options.followRedirect;
+            if (shouldFollow) {
+                response.resume();
+                this._cancelTimeouts();
+                this._unproxyEvents();
+                if (this.redirectUrls.length >= options.maxRedirects) {
+                    this._beforeError(new MaxRedirectsError(this));
                     return;
                 }
-                // Redirecting to a different site, clear sensitive data.
-                if (redirectUrl.hostname !== url.hostname || redirectUrl.port !== url.port) {
-                    if ('host' in updatedOptions.headers) {
-                        delete updatedOptions.headers.host;
+                this._request = undefined;
+                const updatedOptions = new Options(undefined, undefined, this.options);
+                const serverRequestedGet = statusCode === 303 && updatedOptions.method !== 'GET' && updatedOptions.method !== 'HEAD';
+                const canRewrite = statusCode !== 307 && statusCode !== 308;
+                const userRequestedGet = updatedOptions.methodRewriting && canRewrite;
+                if (serverRequestedGet || userRequestedGet) {
+                    updatedOptions.method = 'GET';
+                    updatedOptions.body = undefined;
+                    updatedOptions.json = undefined;
+                    updatedOptions.form = undefined;
+                    delete updatedOptions.headers['content-length'];
+                }
+                try {
+                    // We need this in order to support UTF-8
+                    const redirectBuffer = Buffer.from(response.headers.location, 'binary').toString();
+                    const redirectUrl = new URL(redirectBuffer, url);
+                    if (!isUnixSocketURL(url) && isUnixSocketURL(redirectUrl)) {
+                        this._beforeError(new RequestError('Cannot redirect to UNIX socket', {}, this));
+                        return;
                     }
-                    if ('cookie' in updatedOptions.headers) {
-                        delete updatedOptions.headers.cookie;
+                    // Redirecting to a different site, clear sensitive data.
+                    if (redirectUrl.hostname !== url.hostname || redirectUrl.port !== url.port) {
+                        if ('host' in updatedOptions.headers) {
+                            delete updatedOptions.headers.host;
+                        }
+                        if ('cookie' in updatedOptions.headers) {
+                            delete updatedOptions.headers.cookie;
+                        }
+                        if ('authorization' in updatedOptions.headers) {
+                            delete updatedOptions.headers.authorization;
+                        }
+                        if (updatedOptions.username || updatedOptions.password) {
+                            updatedOptions.username = '';
+                            updatedOptions.password = '';
+                        }
                     }
-                    if ('authorization' in updatedOptions.headers) {
-                        delete updatedOptions.headers.authorization;
+                    else {
+                        redirectUrl.username = updatedOptions.username;
+                        redirectUrl.password = updatedOptions.password;
                     }
-                    if (updatedOptions.username || updatedOptions.password) {
-                        updatedOptions.username = '';
-                        updatedOptions.password = '';
+                    this.redirectUrls.push(redirectUrl);
+                    updatedOptions.prefixUrl = '';
+                    updatedOptions.url = redirectUrl;
+                    for (const hook of updatedOptions.hooks.beforeRedirect) {
+                        // eslint-disable-next-line no-await-in-loop
+                        await hook(updatedOptions, typedResponse);
                     }
+                    this.emit('redirect', updatedOptions, typedResponse);
+                    this.options = updatedOptions;
+                    await this._makeRequest();
                 }
-                else {
-                    redirectUrl.username = updatedOptions.username;
-                    redirectUrl.password = updatedOptions.password;
-                }
-                this.redirectUrls.push(redirectUrl);
-                updatedOptions.prefixUrl = '';
-                updatedOptions.url = redirectUrl;
-                for (const hook of updatedOptions.hooks.beforeRedirect) {
-                    // eslint-disable-next-line no-await-in-loop
-                    await hook(updatedOptions, typedResponse);
+                catch (error) {
+                    this._beforeError(error);
+                    return;
                 }
-                this.emit('redirect', updatedOptions, typedResponse);
-                this.options = updatedOptions;
-                await this._makeRequest();
-            }
-            catch (error) {
-                this._beforeError(error);
                 return;
             }
-            return;
         }
         // `HTTPError`s always have `error.response.body` defined.
-        // Therefore we cannot retry if `options.throwHttpErrors` is false.
+        // Therefore, we cannot retry if `options.throwHttpErrors` is false.
         // On the last retry, if `options.throwHttpErrors` is false, we would need to return the body,
         // but that wouldn't be possible since the body would be already read in `error.response.body`.
         if (options.isStream && options.throwHttpErrors && !isResponseOk(typedResponse)) {

package/dist/source/core/options.d.ts

@@ -6,19 +6,15 @@
 /// <reference types="node" resolution-mode="require"/>
 /// <reference types="node" resolution-mode="require"/>
 /// <reference types="node" resolution-mode="require"/>
-/// <reference types="node" resolution-mode="require"/>
 import type { Buffer } from 'node:buffer';
-import { checkServerIdentity } from 'node:tls';
-import http from 'node:http';
-import https from 'node:https';
+import { checkServerIdentity, type SecureContextOptions, type DetailedPeerCertificate } from 'node:tls';
+import https, { type RequestOptions as HttpsRequestOptions, type Agent as HttpsAgent } from 'node:https';
+import http, { type Agent as HttpAgent, type ClientRequest } from 'node:http';
 import type { Readable } from 'node:stream';
 import type { Socket } from 'node:net';
-import type { SecureContextOptions, DetailedPeerCertificate } from 'node:tls';
-import type { Agent as HttpAgent, ClientRequest } from 'node:http';
-import type { RequestOptions as HttpsRequestOptions, Agent as HttpsAgent } from 'node:https';
 import CacheableLookup from 'cacheable-lookup';
 import http2wrapper, { type ClientHttp2Session } from 'http2-wrapper';
-import type { FormDataLike } from 'form-data-encoder';
+import { type FormDataLike } from 'form-data-encoder';
 import type { StorageAdapter } from 'cacheable-request';
 import type ResponseLike from 'responselike';
 import type { IncomingMessageWithTimings } from '@szmarczak/http-timer';
@@ -841,15 +837,17 @@ export default class Options {
     get hooks(): Hooks;
     set hooks(value: Hooks);
     /**
-    Defines if redirect responses should be followed automatically.
+    Whether redirect responses should be followed automatically.
+
+    Optionally, pass a function to dynamically decide based on the response object.
 
     Note that if a `303` is sent by the server in response to any request type (`POST`, `DELETE`, etc.), Got will automatically request the resource pointed to in the location header via `GET`.
     This is in accordance with [the spec](https://tools.ietf.org/html/rfc7231#section-6.4.4). You can optionally turn on this behavior also for other redirect codes - see `methodRewriting`.
 
     @default true
     */
-    get followRedirect(): boolean;
-    set followRedirect(value: boolean);
+    get followRedirect(): boolean | ((response: PlainResponse) => boolean);
+    set followRedirect(value: boolean | ((response: PlainResponse) => boolean));
     get followRedirects(): unknown;
     set followRedirects(_value: unknown);
     /**
@@ -1135,6 +1133,7 @@ export default class Options {
         username: string;
         password: string;
         json: unknown;
+        followRedirect: boolean | ((response: PlainResponse) => boolean);
         retry: Partial<RetryOptions>;
         agent: Agents;
         h2session: http2wrapper.ClientHttp2Session | undefined;
@@ -1146,7 +1145,7 @@ export default class Options {
         cookieJar: PromiseCookieJar | ToughCookieJar | undefined;
         signal: AbortSignal | undefined;
         ignoreInvalidCookies: boolean;
-        searchParams: string | SearchParameters | URLSearchParams | undefined;
+        searchParams: string | URLSearchParams | SearchParameters | undefined;
         dnsLookup: {
             (hostname: string, family: import("cacheable-lookup").IPFamily, callback: (error: NodeJS.ErrnoException | null, address: string, family: import("cacheable-lookup").IPFamily) => void): void;
             (hostname: string, callback: (error: NodeJS.ErrnoException | null, address: string, family: import("cacheable-lookup").IPFamily) => void): void;
@@ -1158,7 +1157,6 @@ export default class Options {
         dnsCache: boolean | CacheableLookup | undefined;
         context: Record<string, unknown>;
         hooks: Hooks;
-        followRedirect: boolean;
         maxRedirects: number;
         cache: string | boolean | StorageAdapter | undefined;
         throwHttpErrors: boolean;
@@ -1209,7 +1207,7 @@ export default class Options {
             (hostname: string, options: import("cacheable-lookup").LookupOptions, callback: (error: NodeJS.ErrnoException | null, address: string, family: import("cacheable-lookup").IPFamily) => void): void;
         } | undefined;
         family: DnsLookupIpVersion;
-        agent: false | Agents | http.Agent | undefined;
+        agent: false | http.Agent | Agents | undefined;
         setHost: boolean;
         method: Method;
         maxHeaderSize: number | undefined;
@@ -1233,6 +1231,10 @@ export default class Options {
         socketPath?: string | undefined;
         uniqueHeaders?: (string | string[])[] | undefined;
         joinDuplicateHeaders?: boolean | undefined;
+        ALPNCallback?: ((arg: {
+            servername: string;
+            protocols: string[];
+        }) => string | undefined) | undefined;
         clientCertEngine?: string | undefined;
         privateKeyEngine?: string | undefined;
         privateKeyIdentifier?: string | undefined;

package/dist/source/core/options.js

@@ -2,8 +2,8 @@ import process from 'node:process';
 import { promisify, inspect } from 'node:util';
 import { checkServerIdentity } from 'node:tls';
 // DO NOT use destructuring for `https.request` and `http.request` as it's not compatible with `nock`.
-import http from 'node:http';
 import https from 'node:https';
+import http from 'node:http';
 import is, { assert } from '@sindresorhus/is';
 import lowercaseKeys from 'lowercase-keys';
 import CacheableLookup from 'cacheable-lookup';
@@ -295,31 +295,11 @@ const init = (options, withOptions, self) => {
     }
 };
 export default class Options {
+    _unixOptions;
+    _internals;
+    _merging;
+    _init;
     constructor(input, options, defaults) {
-        Object.defineProperty(this, "_unixOptions", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "_internals", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "_merging", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "_init", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
         assert.any([is.string, is.urlInstance, is.object, is.undefined], input);
         assert.any([is.object, is.undefined], options);
         assert.any([is.object, is.undefined], defaults);
@@ -1000,7 +980,9 @@ export default class Options {
         }
     }
     /**
-    Defines if redirect responses should be followed automatically.
+    Whether redirect responses should be followed automatically.
+
+    Optionally, pass a function to dynamically decide based on the response object.
 
     Note that if a `303` is sent by the server in response to any request type (`POST`, `DELETE`, etc.), Got will automatically request the resource pointed to in the location header via `GET`.
     This is in accordance with [the spec](https://tools.ietf.org/html/rfc7231#section-6.4.4). You can optionally turn on this behavior also for other redirect codes - see `methodRewriting`.
@@ -1011,7 +993,7 @@ export default class Options {
         return this._internals.followRedirect;
     }
     set followRedirect(value) {
-        assert.boolean(value);
+        assert.any([is.boolean, is.function_], value);
         this._internals.followRedirect = value;
     }
     get followRedirects() {

package/dist/source/core/parse-link-header.js

@@ -6,7 +6,7 @@ export default function parseLinkHeader(link) {
         const [rawUriReference, ...rawLinkParameters] = item.split(';');
         const trimmedUriReference = rawUriReference.trim();
         // eslint-disable-next-line @typescript-eslint/prefer-string-starts-ends-with
-        if (trimmedUriReference[0] !== '<' || trimmedUriReference[trimmedUriReference.length - 1] !== '>') {
+        if (trimmedUriReference[0] !== '<' || trimmedUriReference.at(-1) !== '>') {
             throw new Error(`Invalid format of the Link header reference: ${trimmedUriReference}`);
         }
         const reference = trimmedUriReference.slice(1, -1);

package/dist/source/core/response.d.ts

@@ -1,5 +1,4 @@
 /// <reference types="node" resolution-mode="require"/>
-/// <reference types="node" resolution-mode="require"/>
 import type { Buffer } from 'node:buffer';
 import type { IncomingMessageWithTimings, Timings } from '@szmarczak/http-timer';
 import { RequestError } from './errors.js';

package/dist/source/core/response.js

@@ -1,7 +1,9 @@
 import { RequestError } from './errors.js';
 export const isResponseOk = (response) => {
     const { statusCode } = response;
-    const limitStatusCode = response.request.options.followRedirect ? 299 : 399;
+    const { followRedirect } = response.request.options;
+    const shouldFollow = typeof followRedirect === 'function' ? followRedirect(response) : followRedirect;
+    const limitStatusCode = shouldFollow ? 299 : 399;
     return (statusCode >= 200 && statusCode <= limitStatusCode) || statusCode === 304;
 };
 /**

package/dist/source/core/timed-out.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="node" resolution-mode="require"/>
 import type { ClientRequest } from 'node:http';
 declare const reentry: unique symbol;
 type TimedOutOptions = {

package/dist/source/core/timed-out.js

@@ -3,20 +3,11 @@ import unhandler from './utils/unhandle.js';
 const reentry = Symbol('reentry');
 const noop = () => { };
 export class TimeoutError extends Error {
+    event;
+    code;
     constructor(threshold, event) {
         super(`Timeout awaiting '${event}' for ${threshold}ms`);
-        Object.defineProperty(this, "event", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: event
-        });
-        Object.defineProperty(this, "code", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
+        this.event = event;
         this.name = 'TimeoutError';
         this.code = 'ETIMEDOUT';
     }

package/dist/source/core/utils/is-client-request.d.ts

@@ -1,4 +1,5 @@
 /// <reference types="node" resolution-mode="require"/>
+/// <reference types="node" resolution-mode="require"/>
 import type { Writable, Readable } from 'node:stream';
 import type { ClientRequest } from 'node:http';
 declare function isClientRequest(clientRequest: Writable | Readable): clientRequest is ClientRequest;

package/dist/source/core/utils/is-unix-socket-url.d.ts

@@ -1,2 +1 @@
-/// <reference types="node" resolution-mode="require"/>
 export default function isUnixSocketURL(url: URL): boolean;

package/dist/source/core/utils/options-to-url.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="node" resolution-mode="require"/>
 export type URLOptions = {
     href?: string;
     protocol?: string;

package/dist/source/core/utils/weakable-map.js

@@ -1,17 +1,7 @@
 export default class WeakableMap {
+    weakMap;
+    map;
     constructor() {
-        Object.defineProperty(this, "weakMap", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "map", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
         this.weakMap = new WeakMap();
         this.map = new Map();
     }

package/dist/source/index.js

@@ -7,6 +7,7 @@ const defaults = {
 };
 const got = create(defaults);
 export default got;
+// TODO: Remove this in the next major version.
 export { got };
 export { default as Options } from './core/options.js';
 export * from './core/options.js';

package/dist/source/types.d.ts

@@ -1,10 +1,9 @@
 /// <reference types="node" resolution-mode="require"/>
-/// <reference types="node" resolution-mode="require"/>
 import type { Buffer } from 'node:buffer';
 import type { CancelableRequest } from './as-promise/types.js';
 import type { Response } from './core/response.js';
 import type Options from './core/options.js';
-import type { PaginationOptions, OptionsInit } from './core/options.js';
+import { type PaginationOptions, type OptionsInit } from './core/options.js';
 import type Request from './core/index.js';
 type Except<ObjectType, KeysType extends keyof ObjectType> = Pick<ObjectType, Exclude<keyof ObjectType, KeysType>>;
 type Merge<FirstType, SecondType> = Except<FirstType, Extract<keyof FirstType, keyof SecondType>> & SecondType;

package/license

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) Sindre Sorhus <sindresorhus@gmail.com> (sindresorhus.com)
+Copyright (c) Sindre Sorhus <sindresorhus@gmail.com> (https://sindresorhus.com)
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "got",
-	"version": "13.0.0",
+	"version": "14.1.0",
 	"description": "Human-friendly and powerful HTTP request library for Node.js",
 	"license": "MIT",
 	"repository": "sindresorhus/got",
@@ -10,11 +10,12 @@
 		"types": "./dist/source/index.d.ts",
 		"default": "./dist/source/index.js"
 	},
+	"sideEffects": false,
 	"engines": {
-		"node": ">=16"
+		"node": ">=20"
 	},
 	"scripts": {
-		"test": "xo && tsc --noEmit && ava",
+		"test": "xo && tsc --noEmit && NODE_OPTIONS='--import=tsx/esm' ava",
 		"release": "np",
 		"build": "del-cli dist && tsc",
 		"prepare": "npm run build"
@@ -47,64 +48,61 @@
 		"ky"
 	],
 	"dependencies": {
-		"@sindresorhus/is": "^5.2.0",
+		"@sindresorhus/is": "^6.1.0",
 		"@szmarczak/http-timer": "^5.0.1",
 		"cacheable-lookup": "^7.0.0",
-		"cacheable-request": "^10.2.8",
+		"cacheable-request": "^10.2.14",
 		"decompress-response": "^6.0.0",
-		"form-data-encoder": "^2.1.2",
-		"get-stream": "^6.0.1",
-		"http2-wrapper": "^2.1.10",
+		"form-data-encoder": "^4.0.2",
+		"get-stream": "^8.0.1",
+		"http2-wrapper": "^2.2.1",
 		"lowercase-keys": "^3.0.0",
-		"p-cancelable": "^3.0.0",
+		"p-cancelable": "^4.0.1",
 		"responselike": "^3.0.0"
 	},
 	"devDependencies": {
 		"@hapi/bourne": "^3.0.0",
-		"@sindresorhus/tsconfig": "^3.0.1",
-		"@sinonjs/fake-timers": "^10.0.2",
-		"@types/benchmark": "^2.1.2",
-		"@types/express": "^4.17.17",
-		"@types/node": "^18.14.5",
-		"@types/pem": "^1.9.6",
-		"@types/pify": "^5.0.1",
-		"@types/readable-stream": "^2.3.13",
-		"@types/request": "^2.48.8",
-		"@types/sinon": "^10.0.11",
-		"@types/sinonjs__fake-timers": "^8.1.1",
-		"@types/tough-cookie": "^4.0.1",
-		"ava": "^5.2.0",
-		"axios": "^0.27.2",
+		"@sindresorhus/tsconfig": "^5.0.0",
+		"@sinonjs/fake-timers": "^11.2.2",
+		"@types/benchmark": "^2.1.5",
+		"@types/express": "^4.17.21",
+		"@types/node": "^20.10.0",
+		"@types/pem": "^1.14.4",
+		"@types/readable-stream": "^4.0.9",
+		"@types/request": "^2.48.12",
+		"@types/sinon": "^17.0.2",
+		"@types/sinonjs__fake-timers": "^8.1.5",
+		"ava": "^5.3.1",
+		"axios": "^1.6.2",
 		"benchmark": "^2.1.4",
 		"bluebird": "^3.7.2",
 		"body-parser": "^1.20.2",
 		"create-cert": "^1.0.6",
 		"create-test-server": "^3.0.1",
-		"del-cli": "^5.0.0",
-		"delay": "^5.0.0",
-		"express": "^4.17.3",
+		"del-cli": "^5.1.0",
+		"delay": "^6.0.0",
+		"express": "^4.18.2",
 		"form-data": "^4.0.0",
-		"formdata-node": "^5.0.0",
-		"nock": "^13.3.0",
-		"node-fetch": "^3.2.3",
-		"np": "^7.6.0",
+		"formdata-node": "^6.0.3",
+		"nock": "^13.4.0",
+		"node-fetch": "^3.3.2",
+		"np": "^9.0.0",
 		"nyc": "^15.1.0",
-		"p-event": "^5.0.1",
-		"pem": "^1.14.6",
-		"pify": "^6.0.0",
-		"readable-stream": "^4.2.0",
+		"p-event": "^6.0.0",
+		"pem": "^1.14.8",
+		"pify": "^6.1.0",
+		"readable-stream": "^4.4.2",
 		"request": "^2.88.2",
-		"sinon": "^15.0.1",
+		"sinon": "^17.0.1",
 		"slow-stream": "0.0.4",
-		"tempy": "^3.0.0",
+		"tempy": "^3.1.0",
 		"then-busboy": "^5.2.1",
-		"tough-cookie": "4.1.2",
-		"ts-node": "^10.8.2",
-		"type-fest": "^3.6.1",
-		"typescript": "^5.0.4",
-		"xo": "^0.54.2"
+		"tough-cookie": "^4.1.3",
+		"tsx": "^4.6.0",
+		"type-fest": "^4.8.2",
+		"typescript": "^5.3.2",
+		"xo": "^0.56.0"
 	},
-	"sideEffects": false,
 	"ava": {
 		"files": [
 			"test/*"
@@ -113,9 +111,7 @@
 		"extensions": {
 			"ts": "module"
 		},
-		"nodeArguments": [
-			"--loader=ts-node/esm"
-		]
+		"workerThreads": false
 	},
 	"nyc": {
 		"reporter": [
@@ -148,7 +144,8 @@
 			"@typescript-eslint/no-unsafe-argument": "off",
 			"@typescript-eslint/promise-function-async": "off",
 			"no-lone-blocks": "off",
-			"unicorn/no-await-expression-member": "off"
+			"unicorn/no-await-expression-member": "off",
+			"unicorn/prefer-event-target": "off"
 		}
 	},
 	"runkitExampleFilename": "./documentation/examples/runkit-example.js"

package/readme.md

@@ -80,7 +80,7 @@
 
 ---
 
-For browser usage, we recommend [Ky](https://github.com/sindresorhus/ky) by the same people.
+**You probably want [Ky](https://github.com/sindresorhus/ky) instead, by the same people. It's smaller, works in the browser too, and is more stable since it's built upon [`Fetch`](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API).**
 
 ---
 
@@ -92,7 +92,7 @@ For browser usage, we recommend [Ky](https://github.com/sindresorhus/ky) by the
 npm install got
 ```
 
-**Warning:** This package is native [ESM](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules) and no longer provides a CommonJS export. If your project uses CommonJS, you will have to [convert to ESM](https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c) or use the [dynamic `import()`](https://v8.dev/features/dynamic-import) function. Please don't open issues for questions regarding CommonJS / ESM.
+**Warning:** This package is native [ESM](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules) and no longer provides a CommonJS export. If your project uses CommonJS, you will have to [convert to ESM](https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c). Please don't open issues for questions regarding CommonJS / ESM.
 
 **Got v11 is no longer maintained and we will not accept any backport requests.**
 
@@ -124,7 +124,7 @@ For advanced JSON usage, check out the [`parseJson`](documentation/2-options.md#
 
 ## Highlights
 
-- [Used by 8K+ packages and 4M+ repos](https://github.com/sindresorhus/got/network/dependents)
+- [Used by 10K+ packages and 5M+ repos](https://github.com/sindresorhus/got/network/dependents)
 - [Actively maintained](https://github.com/sindresorhus/got/graphs/contributors)
 - [Trusted by many companies](#widely-used)
 
@@ -187,11 +187,6 @@ By default, Got will retry on failure. To disable this option, set [`options.ret
 - [`got-scraping`](https://github.com/apify/got-scraping) - Got wrapper specifically designed for web scraping purposes
 - [`got-ssrf`](https://github.com/JaneJeon/got-ssrf) - Got wrapper to protect server-side requests against SSRF attacks
 
-### Legacy
-
-- [travis-got](https://github.com/samverschueren/travis-got) - Got convenience wrapper to interact with the Travis API
-- [graphql-got](https://github.com/kevva/graphql-got) - Got convenience wrapper to interact with GraphQL
-
 ## Comparison
 
 |                       | `got`               | [`node-fetch`][n0]   | [`ky`][k0]               | [`axios`][a0]      | [`superagent`][s0]     |
@@ -393,14 +388,6 @@ By default, Got will retry on failure. To disable this option, set [`options.ret
 ---|---
 [Sindre Sorhus](https://sindresorhus.com) | [Szymon Marczak](https://github.com/szmarczak)
 
-###### Former
-
-- [Vsevolod Strukchinsky](https://github.com/floatdrop)
-- [Alexander Tesfamichael](https://github.com/alextes)
-- [Brandon Smith](https://github.com/brandon93s)
-- [Luke Childs](https://github.com/lukechilds)
-- [Giovanni Minotti](https://github.com/Giotino)
-
 <a name="widely-used"></a>
 ## These amazing companies are using Got
 
@@ -519,9 +506,3 @@ By default, Got will retry on failure. To disable this option, set [`options.ret
 > Got has been a crucial component of Apify's scraping for years. We use it to extract data from billions of web pages every month, and we really appreciate the powerful API and extensibility, which allowed us to build our own specialized HTTP client on top of Got. The support has always been stellar too.
 >
 > — <a href="https://github.com/mnmkng">Ondra Urban</a>
-
-## For enterprise
-
-Available as part of the Tidelift Subscription.
-
-The maintainers of `got` and thousands of other packages are working with Tidelift to deliver commercial support and maintenance for the open source dependencies you use to build your applications. Save time, reduce risk, and improve code health, while paying the maintainers of the exact dependencies you use. [Learn more.](https://tidelift.com/subscription/pkg/npm-got?utm_source=npm-got&utm_medium=referral&utm_campaign=enterprise&utm_term=repo)