got 12.6.1 → 14.0.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.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';
@@ -127,20 +97,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

@@ -3,11 +3,11 @@
 /// <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 { Duplex } from 'node:stream';
-import { URL } from 'node:url';
-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';
@@ -107,7 +107,7 @@ export default class Request extends Duplex implements RequestEvents<Request> {
     private _isFromCache?;
     private _cannotHaveBody;
     private _triggerRead;
-    private _jobs;
+    private readonly _jobs;
     private _cancelTimeouts;
     private readonly _removeListeners;
     private _nativeResponse?;

package/dist/source/core/index.js

@@ -1,13 +1,12 @@
 import process from 'node:process';
 import { Buffer } from 'node:buffer';
 import { Duplex } from 'node:stream';
-import { URL, URLSearchParams } from 'node:url';
 import http, { ServerResponse } from 'node:http';
 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';
@@ -21,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: getBuffer } = getStream;
 const supportsBrotli = is.string(process.versions.brotli);
 const methodsWithoutBody = new Set(['GET', 'HEAD']);
 const cacheableStore = new WeakableMap();
@@ -35,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
@@ -42,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;
@@ -268,7 +141,7 @@ export default class Request extends Duplex {
             else {
                 this.options.signal.addEventListener('abort', abort);
                 this._removeListeners = () => {
-                    this.options.signal.removeEventListener('abort', abort);
+                    this.options.signal?.removeEventListener('abort', abort);
                 };
             }
         }
@@ -314,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`.
@@ -631,76 +504,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)) {
@@ -750,7 +626,10 @@ export default class Request extends Duplex {
         }
         try {
             // Errors are emitted via the `error` event
-            const rawBody = await getBuffer(from);
+            const rawBody = await getStreamAsBuffer(from);
+            // TODO: Switch to this:
+            // let rawBody = await from.toArray();
+            // rawBody = Buffer.concat(rawBody);
             // On retry Request is destroyed with no error, therefore the above will successfully resolve.
             // So in order to check if this was really successfull, we need to check if it has been properly ended.
             if (!this.isAborted) {
@@ -844,7 +723,6 @@ export default class Request extends Duplex {
                     // We only need to implement the error handler in order to support HTTP2 caching.
                     // The result will be a promise anyway.
                     // @ts-expect-error ignore
-                    // eslint-disable-next-line @typescript-eslint/promise-function-async
                     result.once = (event, handler) => {
                         if (event === 'error') {
                             (async () => {

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

@@ -8,18 +8,14 @@
 /// <reference types="node" resolution-mode="require"/>
 /// <reference types="node" resolution-mode="require"/>
 import type { Buffer } from 'node:buffer';
-import { URL, URLSearchParams } from 'node:url';
-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';
@@ -567,7 +563,7 @@ export type OptionsInit = Except<Partial<InternalsType>, 'hooks' | 'retry'> & {
 };
 export default class Options {
     private _unixOptions?;
-    private _internals;
+    private readonly _internals;
     private _merging;
     private readonly _init;
     constructor(input?: string | URL | OptionsInit, options?: OptionsInit, defaults?: Options);
@@ -741,8 +737,6 @@ export default class Options {
     /**
     You can abort the `request` using [`AbortController`](https://developer.mozilla.org/en-US/docs/Web/API/AbortController).
 
-    *Requires Node.js 16 or later.*
-
     @example
     ```
     import got from 'got';
@@ -758,8 +752,8 @@ export default class Options {
     }, 100);
     ```
     */
-    get signal(): any | undefined;
-    set signal(value: any | undefined);
+    get signal(): AbortSignal | undefined;
+    set signal(value: AbortSignal | undefined);
     /**
     Ignore invalid cookies instead of throwing an error.
     Only useful when the `cookieJar` option has been set. Not recommended.
@@ -844,15 +838,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);
     /**
@@ -1138,6 +1134,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;
@@ -1147,7 +1144,7 @@ export default class Options {
         form: Record<string, any> | undefined;
         url: string | URL | undefined;
         cookieJar: PromiseCookieJar | ToughCookieJar | undefined;
-        signal: any;
+        signal: AbortSignal | undefined;
         ignoreInvalidCookies: boolean;
         searchParams: string | SearchParameters | URLSearchParams | undefined;
         dnsLookup: {
@@ -1161,7 +1158,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;
@@ -1212,7 +1208,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;
@@ -1236,6 +1232,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

@@ -1,10 +1,9 @@
 import process from 'node:process';
 import { promisify, inspect } from 'node:util';
-import { URL, URLSearchParams } from 'node:url';
 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';
@@ -181,7 +180,7 @@ const defaultInternals = {
     setHost: true,
     maxHeaderSize: undefined,
     signal: undefined,
-    enableUnixSockets: true,
+    enableUnixSockets: false,
 };
 const cloneInternals = (internals) => {
     const { hooks, retry } = internals;
@@ -296,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);
@@ -408,7 +387,12 @@ export default class Options {
                     throw new Error(`Unexpected option: ${key}`);
                 }
                 // @ts-expect-error Type 'unknown' is not assignable to type 'never'.
-                this[key] = options[key];
+                const value = options[key];
+                if (value === undefined) {
+                    continue;
+                }
+                // @ts-expect-error Type 'unknown' is not assignable to type 'never'.
+                this[key] = value;
                 push = true;
             }
             if (push) {
@@ -764,8 +748,6 @@ export default class Options {
     /**
     You can abort the `request` using [`AbortController`](https://developer.mozilla.org/en-US/docs/Web/API/AbortController).
 
-    *Requires Node.js 16 or later.*
-
     @example
     ```
     import got from 'got';
@@ -781,11 +763,9 @@ export default class Options {
     }, 100);
     ```
     */
-    // TODO: Replace `any` with `AbortSignal` when targeting Node 16.
     get signal() {
         return this._internals.signal;
     }
-    // TODO: Replace `any` with `AbortSignal` when targeting Node 16.
     set signal(value) {
         assert.object(value);
         this._internals.signal = value;
@@ -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,7 +1,6 @@
 /// <reference types="node" resolution-mode="require"/>
 /// <reference types="node" resolution-mode="require"/>
 import type { Buffer } from 'node:buffer';
-import type { URL } from 'node:url';
 import type { IncomingMessageWithTimings, Timings } from '@szmarczak/http-timer';
 import { RequestError } from './errors.js';
 import type { ParseJsonFunction, ResponseType } from './options.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';
     }
@@ -55,13 +46,13 @@ export default function timedOut(request, delays, options) {
             throw error;
         }
     });
-    if (typeof delays.request !== 'undefined') {
+    if (delays.request !== undefined) {
         const cancelTimeout = addTimeout(delays.request, timeoutHandler, 'request');
         once(request, 'response', (response) => {
             once(response, 'end', cancelTimeout);
         });
     }
-    if (typeof delays.socket !== 'undefined') {
+    if (delays.socket !== undefined) {
         const { socket } = delays;
         const socketTimeoutHandler = () => {
             timeoutHandler(socket, 'socket');
@@ -74,17 +65,17 @@ export default function timedOut(request, delays, options) {
             request.removeListener('timeout', socketTimeoutHandler);
         });
     }
-    const hasLookup = typeof delays.lookup !== 'undefined';
-    const hasConnect = typeof delays.connect !== 'undefined';
-    const hasSecureConnect = typeof delays.secureConnect !== 'undefined';
-    const hasSend = typeof delays.send !== 'undefined';
+    const hasLookup = delays.lookup !== undefined;
+    const hasConnect = delays.connect !== undefined;
+    const hasSecureConnect = delays.secureConnect !== undefined;
+    const hasSend = delays.send !== undefined;
     if (hasLookup || hasConnect || hasSecureConnect || hasSend) {
         once(request, 'socket', (socket) => {
             const { socketPath } = request;
             /* istanbul ignore next: hard to test */
             if (socket.connecting) {
                 const hasPath = Boolean(socketPath ?? net.isIP(hostname ?? host ?? '') !== 0);
-                if (hasLookup && !hasPath && typeof socket.address().address === 'undefined') {
+                if (hasLookup && !hasPath && socket.address().address === undefined) {
                     const cancelTimeout = addTimeout(delays.lookup, timeoutHandler, 'lookup');
                     once(socket, 'lookup', cancelTimeout);
                 }
@@ -122,13 +113,13 @@ export default function timedOut(request, delays, options) {
             }
         });
     }
-    if (typeof delays.response !== 'undefined') {
+    if (delays.response !== undefined) {
         once(request, 'upload-complete', () => {
             const cancelTimeout = addTimeout(delays.response, timeoutHandler, 'response');
             once(request, 'response', cancelTimeout);
         });
     }
-    if (typeof delays.read !== 'undefined') {
+    if (delays.read !== undefined) {
         once(request, 'response', (response) => {
             const cancelTimeout = addTimeout(delays.read, timeoutHandler, 'read');
             once(response, 'end', cancelTimeout);

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,3 +1,2 @@
 /// <reference types="node" resolution-mode="require"/>
-import type { URL } from 'url';
 export default function isUnixSocketURL(url: URL): boolean;

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

@@ -1,5 +1,4 @@
 /// <reference types="node" resolution-mode="require"/>
-import { URL } from 'node:url';
 export type URLOptions = {
     href?: string;
     protocol?: string;

package/dist/source/core/utils/options-to-url.js

@@ -1,5 +1,3 @@
-/* istanbul ignore file: deprecated */
-import { URL } from 'node:url';
 const keys = [
     'protocol',
     'host',

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

@@ -1,5 +1,5 @@
 /// <reference types="node" resolution-mode="require"/>
-import type { URL, UrlWithStringQuery } from 'node:url';
+import type { UrlWithStringQuery } from 'node:url';
 export type LegacyUrlOptions = {
     protocol: string;
     hostname: 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,11 +1,10 @@
 /// <reference types="node" resolution-mode="require"/>
 /// <reference types="node" resolution-mode="require"/>
 import type { Buffer } from 'node:buffer';
-import type { URL } from 'node:url';
 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,18 +1,21 @@
 {
 	"name": "got",
-	"version": "12.6.1",
+	"version": "14.0.0",
 	"description": "Human-friendly and powerful HTTP request library for Node.js",
 	"license": "MIT",
 	"repository": "sindresorhus/got",
 	"funding": "https://github.com/sindresorhus/got?sponsor=1",
 	"type": "module",
-	"exports": "./dist/source/index.js",
-	"types": "./dist/source/index.d.ts",
+	"exports": {
+		"types": "./dist/source/index.d.ts",
+		"default": "./dist/source/index.js"
+	},
+	"sideEffects": false,
 	"engines": {
-		"node": ">=14.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"
@@ -45,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": "~4.9.5",
-		"xo": "^0.53.1"
+		"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/*"
@@ -111,9 +111,7 @@
 		"extensions": {
 			"ts": "module"
 		},
-		"nodeArguments": [
-			"--loader=ts-node/esm"
-		]
+		"workerThreads": false
 	},
 	"nyc": {
 		"reporter": [
@@ -135,10 +133,7 @@
 		"rules": {
 			"@typescript-eslint/no-empty-function": "off",
 			"n/no-deprecated-api": "off",
-			"n/prefer-global/url": "off",
-			"n/prefer-global/url-search-params": "off",
 			"@typescript-eslint/no-implicit-any-catch": "off",
-			"unicorn/prefer-node-protocol": "off",
 			"ava/assertion-arguments": "off",
 			"@typescript-eslint/no-unsafe-member-access": "off",
 			"@typescript-eslint/no-unsafe-return": "off",
@@ -146,8 +141,11 @@
 			"@typescript-eslint/no-unsafe-call": "off",
 			"@typescript-eslint/await-thenable": "off",
 			"@typescript-eslint/no-redundant-type-constituents": "off",
+			"@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,9 +92,9 @@ 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 (the previous major version) is no longer maintained and we will not accept any backport requests.**
+**Got v11 is no longer maintained and we will not accept any backport requests.**
 
 ## Take a peek
 
@@ -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]     |
@@ -203,7 +198,7 @@ By default, Got will retry on failure. To disable this option, set [`options.ret
 | Pagination API        | :heavy_check_mark:  | :x:                  | :x:                      | :x:                | :x:                    |
 | Request cancelation   | :heavy_check_mark:  | :heavy_check_mark:   | :heavy_check_mark:       | :heavy_check_mark: | :heavy_check_mark:     |
 | RFC compliant caching | :heavy_check_mark:  | :x:                  | :x:                      | :x:                | :x:                    |
-| Cookies (out-of-box)  | :heavy_check_mark:  | :x:                  | :x:                      | :x:                | :x:                    |
+| Cookies (out-of-the-box)  | :heavy_check_mark:  | :x:                  | :x:                      | :x:                | :x:                    |
 | Follows redirects     | :heavy_check_mark:  | :heavy_check_mark:   | :heavy_check_mark:       | :heavy_check_mark: | :heavy_check_mark:     |
 | Retries on failure    | :heavy_check_mark:  | :x:                  | :heavy_check_mark:       | :x:                | :heavy_check_mark:     |
 | Progress events       | :heavy_check_mark:  | :x:                  | :heavy_check_mark:\*\*\* | Browser only       | :heavy_check_mark:     |
@@ -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
 
@@ -436,7 +423,7 @@ By default, Got will retry on failure. To disable this option, set [`options.ret
 		</td>
 		<td align="center">
 			<a href="https://github.com/renovatebot/renovate">
-				<img width="150" valign="middle" src="https://camo.githubusercontent.com/206d470ac709b9a702a97b0c08d6f389a086793d/68747470733a2f2f72656e6f76617465626f742e636f6d2f696d616765732f6c6f676f2e737667">
+				<img width="150" valign="middle" src="https://camo.githubusercontent.com/7c2dc41a8407d4cfa700f762a1abf46b232858ae7e3a2bf5aee7d9f36416127c/68747470733a2f2f6170702e72656e6f76617465626f742e636f6d2f696d616765732f72656e6f766174655f3636305f3232302e6a7067">
 			</a>
 		</td>
 		<td align="center">
@@ -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)