rekwest 5.3.0 → 5.4.0

package/README.md

@@ -1,245 +1,245 @@
-The robust request library that humanity deserves 🌐
----
-This package provides highly likely functional and **easy-to-use** abstraction atop of
-native [http(s).request](https://nodejs.org/api/https.html#httpsrequesturl-options-callback)
-and [http2.request](https://nodejs.org/api/http2.html#clienthttp2sessionrequestheaders-options).
-
-## Abstract
-
-* Fetch-alike
-* Cool-beans 🫐 config options (with defaults)
-* Automatic HTTP/2 support (ALPN negotiation)
-* Automatic or opt-in body parse (with non-UTF-8 charset decoding)
-* Automatic and simplistic `Cookies` treatment (with built-in **jar** & **ttl**)
-* Automatic decompression (with opt-in body compression)
-* Built-in streamable `FormData` interface
-* Support redirects & retries with fine-grained tune-ups
-* Support all legit request body types (include blobs & streams)
-* Support both CJS and ESM module systems
-* Fully promise-able and pipe-able
-* Zero dependencies
-
-## Prerequisites
-
-* Node.js `>= 18.13.0`
-
-## Installation
-
-```bash
-npm install rekwest --save
-```
-
-### Usage
-
-```javascript
-import rekwest, { constants } from 'rekwest';
-
-const {
-  HTTP2_HEADER_AUTHORIZATION,
-  HTTP2_HEADER_CONTENT_ENCODING,
-  HTTP2_METHOD_POST,
-  HTTP_STATUS_OK,
-} = constants;
-
-const url = 'https://somewhe.re/somewhat/endpoint';
-
-const res = await rekwest(url, {
-  body: { celestial: 'payload' },
-  headers: {
-    [HTTP2_HEADER_AUTHORIZATION]: 'Bearer [token]',
-    [HTTP2_HEADER_CONTENT_ENCODING]: 'br',  // enables: body compression
-    /** [HTTP2_HEADER_CONTENT_TYPE]
-     * is undue for
-     * Array/Blob/File/FormData/Object/URLSearchParams body types
-     * and will be set automatically, with an option to override it here
-     */
-  },
-  method: HTTP2_METHOD_POST,
-});
-
-console.assert(res.statusCode === HTTP_STATUS_OK);
-console.info(res.headers);
-console.log(res.body);
-```
-
----
-
-```javascript
-import { Readable } from 'node:stream';
-import rekwest, {
-  constants,
-  Blob,
-  File,
-  FormData,
-} from 'rekwest';
-
-const {
-  HTTP2_HEADER_AUTHORIZATION,
-  HTTP2_HEADER_CONTENT_ENCODING,
-  HTTP2_METHOD_POST,
-  HTTP_STATUS_OK,
-} = constants;
-
-const blob = new Blob(['bits']);
-const file = new File(['bits'], 'file.dab');
-const readable = Readable.from('bits');
-
-const fd = new FormData({
-  aux: Date.now(),  // either [[key, value]] or kv sequenceable
-});
-
-fd.append('celestial', 'payload');
-fd.append('blob', blob, 'blob.dab');
-fd.append('file', file);
-fd.append('readable', readable, 'readable.dab');
-
-const url = 'https://somewhe.re/somewhat/endpoint';
-
-const res = await rekwest(url, {
-  body: fd,
-  headers: {
-    [HTTP2_HEADER_AUTHORIZATION]: 'Bearer [token]',
-    [HTTP2_HEADER_CONTENT_ENCODING]: 'br',  // enables: body compression
-  },
-  method: HTTP2_METHOD_POST,
-});
-
-console.assert(res.statusCode === HTTP_STATUS_OK);
-console.info(res.headers);
-console.log(res.body);
-```
-
-### API
-
-#### `rekwest(url[, options])`
-
-* `url` **{string | URL}** The URL to send the request to
-* `options` **{Object}**
-  Extends [http(s).RequestOptions](https://nodejs.org/api/https.html#httpsrequesturl-options-callback) along with
-  extra [http2.ClientSessionOptions](https://nodejs.org/api/http2.html#http2connectauthority-options-listener)
-  & [http2.ClientSessionRequestOptions](https://nodejs.org/api/http2.html#clienthttp2sessionrequestheaders-options)
-  and [tls.ConnectionOptions](https://nodejs.org/api/tls.html#tlsconnectoptions-callback)
-  for HTTP/2 attunes
-  * `baseURL` **{string | URL}** The base URL to use in cases where `url` is a relative URL
-  * `body` **{string | Array | ArrayBuffer | ArrayBufferView | AsyncIterator | Blob | Buffer | DataView | File |
-    FormData | Iterator | Object | Readable | ReadableStream | SharedArrayBuffer | URLSearchParams}** The body to send
-    with the request
-  * `cookies` **{boolean | Array<[k, v]> | Array<string\> | Cookies | Object | URLSearchParams}** `Default: true` The
-    cookies to add to
-    the request
-  * `cookiesTTL` **{boolean}** `Default: false` Controls enablement of TTL for the cookies cache
-  * `credentials` **{include | omit | same-origin}** `Default: same-origin` Controls credentials in case of cross-origin
-    redirects
-  * `digest` **{boolean}** `Default: true` Controls whether to read the response stream or simply add a mixin
-  * `follow` **{number}** `Default: 20` The number of redirects to follow
-  * `h2` **{boolean}** `Default: false` Forces the use of HTTP/2 protocol
-  * `headers` **{Object}** The headers to add to the request
-  * `maxRetryAfter` **{number}** The upper limit of `retry-after` header. If unset, it will use `timeout` value
-  * `parse` **{boolean}** `Default: true` Controls whether to parse response body or simply return a buffer
-  * `redirect` **{error | follow | manual}** `Default: follow` Controls the redirect flows
-  * `retry` **{Object}** Represents the retry options
-    * `attempts` **{number}** `Default: 0` The number of retry attempts
-    * `backoffStrategy` **{string}** `Default: interval * Math.log(Math.random() * (Math.E * Math.E - Math.E) + Math.E)`
-      The backoff strategy algorithm that increases logarithmically. To fixate set value to `interval * 1`
-    * `errorCodes` **{string[]}**
-      `Default: ['EAI_AGAIN', 'ECONNREFUSED', 'ECONNRESET', 'EHOSTDOWN', 'EHOSTUNREACH', 'ENETDOWN', 'ENETUNREACH', 'ENOTFOUND', 'EPIPE', 'ERR_HTTP2_STREAM_ERROR']`
-      The list of error codes to retry on
-    * `interval` **{number}** `Default: 1e3` The initial retry interval
-    * `retryAfter` **{boolean}** `Default: true` Controls `retry-after` header receptiveness
-    * `statusCodes` **{number[]}** `Default: [429, 500, 502, 503, 504]` The list of status codes to retry on
-  * `stripTrailingSlash` **{boolean}** `Default: false` Controls whether to strip trailing slash at the end of the URL
-  * `thenable` **{boolean}** `Default: false` Controls the promise resolutions
-  * `timeout` **{number}** `Default: 3e5` The number of milliseconds a request can take before termination
-  * `trimTrailingSlashes` **{boolean}** `Default: false` Controls whether to trim trailing slashes within the URL
-* **Returns:** Promise that resolves to
-  extended [http.IncomingMessage](https://nodejs.org/api/http.html#class-httpincomingmessage)
-  or [http2.ClientHttp2Stream](https://nodejs.org/api/http2.html#class-clienthttp2stream) which is respectively
-  readable and duplex streams
-  * if `digest: true` & `parse: true`
-    * `body` **{string | Array | Buffer | Object}** The body based on its content type
-  * if `digest: false`
-    * `arrayBuffer` **{AsyncFunction}** Reads the response and returns **ArrayBuffer**
-    * `blob` **{AsyncFunction}** Reads the response and returns **Blob**
-    * `body` **{AsyncFunction}** Reads the response and returns **Buffer** if `parse: false`
-    * `bytes` **{AsyncFunction}** Reads the response and returns **Uint8Array**
-    * `json` **{AsyncFunction}** Reads the response and returns **Object**
-    * `text` **{AsyncFunction}** Reads the response and returns **String**
-  * `bodyUsed` **{boolean}** Indicates whether the response were read or not
-  * `cookies` **{undefined | Cookies}** The cookies sent and received with the response
-  * `headers` **{Object}** The headers received with the response
-  * `httpVersion` **{string}** Indicates protocol version negotiated with the server
-  * `ok` **{boolean}** Indicates if the response was successful (statusCode: **200-299**)
-  * `redirected` **{boolean}** Indicates if the response is the result of a redirect
-  * `statusCode` **{number}** Indicates the status code of the response
-  * `trailers` **{undefined | Object}** The trailer headers received with the response
-
----
-
-#### `rekwest.defaults`
-
-The object to fulfill with default [options](#rekwesturl-options).
-
----
-
-#### `rekwest.extend(options)`
-
-The method to extend default [options](#rekwesturl-options) per instance.
-
-```javascript
-import rekwest, { constants } from 'rekwest';
-
-const {
-  HTTP_STATUS_OK,
-} = constants;
-
-const rk = rekwest.extend({
-  baseURL: 'https://somewhe.re',
-});
-
-const signal = AbortSignal.timeout(1e4);
-const url = '/somewhat/endpoint';
-
-const res = await rk(url, {
-  signal,
-});
-
-console.assert(res.statusCode === HTTP_STATUS_OK);
-console.info(res.headers);
-console.log(res.body);
-```
-
----
-
-#### `rekwest.stream(url[, options])`
-
-The method with limited functionality to use with streams and/or pipes.
-
-* No automata (redirects & retries)
-* Pass `h2: true` in options to use HTTP/2 protocol
-  * Use `ackn({ url: URL })` method in advance to check the available protocols
-
-```javascript
-import fs from 'node:fs';
-import { pipeline } from 'node:stream/promises';
-import rekwest, {
-  ackn,
-  constants,
-} from 'rekwest';
-
-const {
-  HTTP2_METHOD_POST,
-} = constants;
-
-const url = new URL('https://somewhe.re/somewhat/endpoint');
-const options = await ackn({ url });
-
-await pipeline(
-  fs.createReadStream('/path/to/read/inlet.xyz'),
-  rekwest.stream(url, { ...options, method: HTTP2_METHOD_POST }),
-  fs.createWriteStream('/path/to/write/outlet.xyz'),
-);
-```
-
----
-
-For more details, please check tests (coverage: **>97%**) in the repository.
+The robust request library that humanity deserves 🌐
+---
+This package provides highly likely functional and **easy-to-use** abstraction atop of
+native [http(s).request](https://nodejs.org/api/https.html#httpsrequesturl-options-callback)
+and [http2.request](https://nodejs.org/api/http2.html#clienthttp2sessionrequestheaders-options).
+
+## Abstract
+
+* Fetch-alike 🥏
+* Cool-beans 🫐 config options (with defaults)
+* Automatic HTTP/2 support (ALPN negotiation) 💼
+* Automatic or opt-in body parse (with non-UTF-8 charset decoding) 🉑
+* Automatic and simplistic `Cookies` treatment (with built-in **jar** & **ttl**) 🍪
+* Automatic decompression (with opt-in body compression) 🗜️
+* Built-in streamable `FormData` interface 🔌
+* Support redirects & retries with fine-grained tune-ups 🪛
+* Support all legit request body types (include blobs & streams) 📦
+* Support both CJS and ESM module systems 🧩
+* Fully promise-able and pipe-able 🔗
+* Zero dependencies 🗽
+
+## Prerequisites
+
+* Node.js `>= 18.13.0`
+
+## Installation
+
+```bash
+npm install rekwest --save
+```
+
+### Usage
+
+```javascript
+import rekwest, { constants } from 'rekwest';
+
+const {
+  HTTP2_HEADER_AUTHORIZATION,
+  HTTP2_HEADER_CONTENT_ENCODING,
+  HTTP2_METHOD_POST,
+  HTTP_STATUS_OK,
+} = constants;
+
+const url = 'https://somewhe.re/somewhat/endpoint';
+
+const res = await rekwest(url, {
+  body: { celestial: 'payload' },
+  headers: {
+    [HTTP2_HEADER_AUTHORIZATION]: 'Bearer [token]',
+    [HTTP2_HEADER_CONTENT_ENCODING]: 'br',  // enables: body compression
+    /** [HTTP2_HEADER_CONTENT_TYPE]
+     * is undue for
+     * Array/Blob/File/FormData/Object/URLSearchParams body types
+     * and will be set automatically, with an option to override it here
+     */
+  },
+  method: HTTP2_METHOD_POST,
+});
+
+console.assert(res.statusCode === HTTP_STATUS_OK);
+console.info(res.headers);
+console.log(res.body);
+```
+
+---
+
+```javascript
+import { Readable } from 'node:stream';
+import rekwest, {
+  constants,
+  Blob,
+  File,
+  FormData,
+} from 'rekwest';
+
+const {
+  HTTP2_HEADER_AUTHORIZATION,
+  HTTP2_HEADER_CONTENT_ENCODING,
+  HTTP2_METHOD_POST,
+  HTTP_STATUS_OK,
+} = constants;
+
+const blob = new Blob(['bits']);
+const file = new File(['bits'], 'file.dab');
+const readable = Readable.from('bits');
+
+const fd = new FormData({
+  aux: Date.now(),  // either [[key, value]] or kv sequenceable
+});
+
+fd.append('celestial', 'payload');
+fd.append('blob', blob, 'blob.dab');
+fd.append('file', file);
+fd.append('readable', readable, 'readable.dab');
+
+const url = 'https://somewhe.re/somewhat/endpoint';
+
+const res = await rekwest(url, {
+  body: fd,
+  headers: {
+    [HTTP2_HEADER_AUTHORIZATION]: 'Bearer [token]',
+    [HTTP2_HEADER_CONTENT_ENCODING]: 'zstd',  // enables: body compression
+  },
+  method: HTTP2_METHOD_POST,
+});
+
+console.assert(res.statusCode === HTTP_STATUS_OK);
+console.info(res.headers);
+console.log(res.body);
+```
+
+### API
+
+#### `rekwest(url[, options])`
+
+* `url` **{string | URL}** The URL to send the request to
+* `options` **{Object}**
+  Extends [http(s).RequestOptions](https://nodejs.org/api/https.html#httpsrequesturl-options-callback) along with
+  extra [http2.ClientSessionOptions](https://nodejs.org/api/http2.html#http2connectauthority-options-listener)
+  & [http2.ClientSessionRequestOptions](https://nodejs.org/api/http2.html#clienthttp2sessionrequestheaders-options)
+  and [tls.ConnectionOptions](https://nodejs.org/api/tls.html#tlsconnectoptions-callback)
+  for HTTP/2 attunes
+  * `baseURL` **{string | URL}** The base URL to use in cases where `url` is a relative URL
+  * `body` **{string | Array | ArrayBuffer | ArrayBufferView | AsyncIterator | Blob | Buffer | DataView | File |
+    FormData | Iterator | Object | Readable | ReadableStream | SharedArrayBuffer | URLSearchParams}** The body to send
+    with the request
+  * `cookies` **{boolean | Array<[k, v]> | Array<string\> | Cookies | Object | URLSearchParams}** `Default: true` The
+    cookies to add to
+    the request
+  * `cookiesTTL` **{boolean}** `Default: false` Controls enablement of TTL for the cookies cache
+  * `credentials` **{include | omit | same-origin}** `Default: same-origin` Controls credentials in case of cross-origin
+    redirects
+  * `digest` **{boolean}** `Default: true` Controls whether to read the response stream or simply add a mixin
+  * `follow` **{number}** `Default: 20` The number of redirects to follow
+  * `h2` **{boolean}** `Default: false` Forces the use of HTTP/2 protocol
+  * `headers` **{Object}** The headers to add to the request
+  * `maxRetryAfter` **{number}** The upper limit of `retry-after` header. If unset, it will use `timeout` value
+  * `parse` **{boolean}** `Default: true` Controls whether to parse response body or simply return a buffer
+  * `redirect` **{error | follow | manual}** `Default: follow` Controls the redirect flows
+  * `retry` **{Object}** Represents the retry options
+    * `attempts` **{number}** `Default: 0` The number of retry attempts
+    * `backoffStrategy` **{string}** `Default: interval * Math.log(Math.random() * (Math.E * Math.E - Math.E) + Math.E)`
+      The backoff strategy algorithm that increases logarithmically. To fixate set value to `interval * 1`
+    * `errorCodes` **{string[]}**
+      `Default: ['EAI_AGAIN', 'ECONNREFUSED', 'ECONNRESET', 'EHOSTDOWN', 'EHOSTUNREACH', 'ENETDOWN', 'ENETUNREACH', 'ENOTFOUND', 'EPIPE', 'ERR_HTTP2_STREAM_ERROR']`
+      The list of error codes to retry on
+    * `interval` **{number}** `Default: 1e3` The initial retry interval
+    * `retryAfter` **{boolean}** `Default: true` Controls `retry-after` header receptiveness
+    * `statusCodes` **{number[]}** `Default: [429, 500, 502, 503, 504]` The list of status codes to retry on
+  * `stripTrailingSlash` **{boolean}** `Default: false` Controls whether to strip trailing slash at the end of the URL
+  * `thenable` **{boolean}** `Default: false` Controls the promise resolutions
+  * `timeout` **{number}** `Default: 3e5` The number of milliseconds a request can take before termination
+  * `trimTrailingSlashes` **{boolean}** `Default: false` Controls whether to trim trailing slashes within the URL
+* **Returns:** Promise that resolves to
+  extended [http.IncomingMessage](https://nodejs.org/api/http.html#class-httpincomingmessage)
+  or [http2.ClientHttp2Stream](https://nodejs.org/api/http2.html#class-clienthttp2stream) which is respectively
+  readable and duplex streams
+  * if `digest: true` & `parse: true`
+    * `body` **{string | Array | Buffer | Object}** The body based on its content type
+  * if `digest: false`
+    * `arrayBuffer` **{AsyncFunction}** Reads the response and returns **ArrayBuffer**
+    * `blob` **{AsyncFunction}** Reads the response and returns **Blob**
+    * `body` **{AsyncFunction}** Reads the response and returns **Buffer** if `parse: false`
+    * `bytes` **{AsyncFunction}** Reads the response and returns **Uint8Array**
+    * `json` **{AsyncFunction}** Reads the response and returns **Object**
+    * `text` **{AsyncFunction}** Reads the response and returns **String**
+  * `bodyUsed` **{boolean}** Indicates whether the response were read or not
+  * `cookies` **{undefined | Cookies}** The cookies sent and received with the response
+  * `headers` **{Object}** The headers received with the response
+  * `httpVersion` **{string}** Indicates protocol version negotiated with the server
+  * `ok` **{boolean}** Indicates if the response was successful (statusCode: **200-299**)
+  * `redirected` **{boolean}** Indicates if the response is the result of a redirect
+  * `statusCode` **{number}** Indicates the status code of the response
+  * `trailers` **{undefined | Object}** The trailer headers received with the response
+
+---
+
+#### `rekwest.defaults`
+
+The object to fulfill with default [options](#rekwesturl-options).
+
+---
+
+#### `rekwest.extend(options)`
+
+The method to extend default [options](#rekwesturl-options) per instance.
+
+```javascript
+import rekwest, { constants } from 'rekwest';
+
+const {
+  HTTP_STATUS_OK,
+} = constants;
+
+const rk = rekwest.extend({
+  baseURL: 'https://somewhe.re',
+});
+
+const signal = AbortSignal.timeout(1e4);
+const url = '/somewhat/endpoint';
+
+const res = await rk(url, {
+  signal,
+});
+
+console.assert(res.statusCode === HTTP_STATUS_OK);
+console.info(res.headers);
+console.log(res.body);
+```
+
+---
+
+#### `rekwest.stream(url[, options])`
+
+The method with limited functionality to use with streams and/or pipes.
+
+* No automata (redirects & retries)
+* Pass `h2: true` in options to use HTTP/2 protocol
+  * Use `ackn({ url: URL })` method in advance to check the available protocols
+
+```javascript
+import fs from 'node:fs';
+import { pipeline } from 'node:stream/promises';
+import rekwest, {
+  ackn,
+  constants,
+} from 'rekwest';
+
+const {
+  HTTP2_METHOD_POST,
+} = constants;
+
+const url = new URL('https://somewhe.re/somewhat/endpoint');
+const options = await ackn({ url });
+
+await pipeline(
+  fs.createReadStream('/path/to/read/inlet.xyz'),
+  rekwest.stream(url, { ...options, method: HTTP2_METHOD_POST }),
+  fs.createWriteStream('/path/to/write/outlet.xyz'),
+);
+```
+
+---
+
+For more details, please check tests (coverage: **>97%**) in the repository.

package/dist/{defaults.js → config.js}

@@ -3,12 +3,16 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.default = void 0;
+exports.isZstdSupported = exports.default = void 0;
 var _nodeHttp = _interopRequireDefault(require("node:http2"));
+var _nodeZlib = _interopRequireDefault(require("node:zlib"));
 var _constants = require("./constants");
+var _mediatypes = require("./mediatypes");
 var _utils = require("./utils");
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 const {
+  HTTP2_HEADER_ACCEPT,
+  HTTP2_HEADER_ACCEPT_ENCODING,
   HTTP2_METHOD_GET,
   HTTP_STATUS_BAD_GATEWAY,
   HTTP_STATUS_GATEWAY_TIMEOUT,
@@ -16,12 +20,17 @@ const {
   HTTP_STATUS_SERVICE_UNAVAILABLE,
   HTTP_STATUS_TOO_MANY_REQUESTS
 } = _nodeHttp.default.constants;
-const stash = {
+const isZstdSupported = exports.isZstdSupported = !!_nodeZlib.default.constants.ZSTD_CLEVEL_DEFAULT;
+const defaults = {
   cookiesTTL: false,
   credentials: _constants.requestCredentials.sameOrigin,
   digest: true,
   follow: 20,
   h2: false,
+  headers: {
+    [HTTP2_HEADER_ACCEPT]: `${_mediatypes.APPLICATION_JSON}, ${_mediatypes.TEXT_PLAIN}, ${_mediatypes.WILDCARD}`,
+    [HTTP2_HEADER_ACCEPT_ENCODING]: `br, ${isZstdSupported ? 'zstd,' : ''} gzip, deflate, deflate-raw`
+  },
   get maxRetryAfter() {
     return this[_utils.maxRetryAfter] ?? this.timeout;
   },
@@ -46,5 +55,5 @@ const stash = {
   trimTrailingSlashes: false
 };
 var _default = exports.default = {
-  stash
+  defaults
 };

package/dist/index.js

@@ -32,6 +32,7 @@ exports.mediatypes = void 0;
 var _nodeHttp = _interopRequireDefault(require("node:http"));
 var _nodeHttp2 = _interopRequireWildcard(require("node:http2"));
 var _nodeHttps = _interopRequireDefault(require("node:https"));
+var _config = _interopRequireDefault(require("./config"));
 var _constants = require("./constants");
 Object.keys(_constants).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
@@ -44,7 +45,6 @@ Object.keys(_constants).forEach(function (key) {
     }
   });
 });
-var _defaults = _interopRequireDefault(require("./defaults"));
 var _mediatypes2 = _interopRequireWildcard(require("./mediatypes"));
 var _mediatypes = _mediatypes2;
 exports.mediatypes = _mediatypes2;
@@ -147,10 +147,10 @@ function rekwest(url, options) {
 Reflect.defineProperty(rekwest, 'defaults', {
   enumerable: true,
   get() {
-    return _defaults.default.stash;
+    return _config.default.defaults;
   },
   set(value) {
-    _defaults.default.stash = (0, _utils.copyWithMerge)(_defaults.default.stash, value);
+    _config.default.defaults = (0, _utils.copyWithMerge)(_config.default.defaults, value);
   }
 });
 Reflect.defineProperty(rekwest, 'extend', {

package/dist/preflight.js

@@ -5,12 +5,11 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.preflight = void 0;
 var _nodeHttp = _interopRequireDefault(require("node:http2"));
+var _config = require("./config");
 var _constants = require("./constants");
 var _cookies = require("./cookies");
-var _mediatypes = require("./mediatypes");
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 const {
-  HTTP2_HEADER_ACCEPT,
   HTTP2_HEADER_ACCEPT_ENCODING,
   HTTP2_HEADER_AUTHORITY,
   HTTP2_HEADER_AUTHORIZATION,
@@ -66,9 +65,16 @@ const preflight = options => {
     url.password = url.username = '';
   }
   options.headers = {
-    [HTTP2_HEADER_ACCEPT]: `${_mediatypes.APPLICATION_JSON}, ${_mediatypes.TEXT_PLAIN}, ${_mediatypes.WILDCARD}`,
-    [HTTP2_HEADER_ACCEPT_ENCODING]: 'br, deflate, deflate-raw, gzip, identity',
-    ...Object.entries(options.headers ?? {}).reduce((acc, [key, val]) => (acc[key.toLowerCase()] = val, acc), {}),
+    ...Object.entries(options.headers ?? {}).reduce((acc, [key, val]) => {
+      acc[key.toLowerCase()] = val;
+      if (acc[HTTP2_HEADER_ACCEPT_ENCODING]?.match(/\bzstd\b/i) && !_config.isZstdSupported) {
+        acc[HTTP2_HEADER_ACCEPT_ENCODING] = val.replace(/\s?zstd,?/i, '').trim();
+        if (!acc[HTTP2_HEADER_ACCEPT_ENCODING]) {
+          Reflect.deleteProperty(acc, HTTP2_HEADER_ACCEPT_ENCODING);
+        }
+      }
+      return acc;
+    }, {}),
     ...(h2 && {
       [HTTP2_HEADER_AUTHORITY]: url.host,
       [HTTP2_HEADER_METHOD]: method,

package/dist/utils.js

@@ -10,8 +10,10 @@ var _nodeBuffer = require("node:buffer");
 var _nodeHttp = _interopRequireDefault(require("node:http2"));
 var _nodeStream = require("node:stream");
 var _nodeZlib = _interopRequireDefault(require("node:zlib"));
-var _defaults = _interopRequireDefault(require("./defaults"));
+var _config = _interopRequireWildcard(require("./config"));
 var _errors = require("./errors");
+function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
+function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 const {
   HTTP2_HEADER_RETRY_AFTER,
@@ -75,6 +77,8 @@ const compress = (readable, encodings = '') => {
       encoders.push(_nodeZlib.default.createDeflateRaw());
     } else if (/\bgzip\b/i.test(encoding)) {
       encoders.push(_nodeZlib.default.createGzip());
+    } else if (_config.isZstdSupported && /\bzstd\b/i.test(encoding)) {
+      encoders.push(_nodeZlib.default.createZstdCompress());
     } else {
       return readable;
     }
@@ -102,6 +106,8 @@ const decompress = (readable, encodings = '') => {
       decoders.push(_nodeZlib.default.createInflateRaw());
     } else if (/\bgzip\b/i.test(encoding)) {
       decoders.push(_nodeZlib.default.createGunzip());
+    } else if (_config.isZstdSupported && /\bzstd\b/i.test(encoding)) {
+      decoders.push(_nodeZlib.default.createZstdDecompress());
     } else {
       return readable;
     }
@@ -148,7 +154,7 @@ const merge = (target, ...rest) => {
 exports.merge = merge;
 const normalize = (url, options = {}) => {
   if (!options.redirected) {
-    options = copyWithMerge(_defaults.default.stash, options);
+    options = copyWithMerge(_config.default.defaults, options);
   }
   if (options.trimTrailingSlashes) {
     url = `${url}`.replace(/(?<!:)\/+/g, '/');

package/package.json

@@ -9,14 +9,13 @@
   },
   "devDependencies": {
     "@babel/cli": "^7.26.4",
-    "@babel/core": "^7.26.0",
-    "@babel/eslint-parser": "^7.25.9",
-    "@babel/preset-env": "^7.26.0",
-    "@stylistic/eslint-plugin-js": "^2.12.1",
+    "@babel/core": "^7.26.9",
+    "@babel/eslint-parser": "^7.26.8",
+    "@babel/preset-env": "^7.26.9",
     "c8": "^10.1.3",
-    "eslint": "^9.17.0",
-    "eslint-config-ultra-refined": "^3.3.0",
-    "mocha": "^11.0.1"
+    "eslint": "^9.20.1",
+    "eslint-config-ultra-refined": "^3.4.2",
+    "mocha": "^11.1.0"
   },
   "description": "The robust request library that humanity deserves 🌐",
   "engines": {
@@ -37,6 +36,7 @@
     "brotli",
     "cookie",
     "deflate",
+    "deflate-raw",
     "fetch",
     "formdata",
     "gzip",
@@ -51,7 +51,8 @@
     "retry",
     "retry-after",
     "stream",
-    "upload"
+    "upload",
+    "zstd"
   ],
   "license": "MIT",
   "name": "rekwest",
@@ -70,5 +71,5 @@
     "test:bail": "mocha --bail",
     "test:cover": "c8 --include=src --reporter=lcov --reporter=text npm test"
   },
-  "version": "5.3.0"
+  "version": "5.4.0"
 }

package/src/{defaults.mjs → config.mjs}

@@ -1,11 +1,19 @@
 import http2 from 'node:http2';
+import zlib from 'node:zlib';
 import {
   requestCredentials,
   requestRedirect,
 } from './constants.mjs';
+import {
+  APPLICATION_JSON,
+  TEXT_PLAIN,
+  WILDCARD,
+} from './mediatypes.mjs';
 import { maxRetryAfter } from './utils.mjs';
 
 const {
+  HTTP2_HEADER_ACCEPT,
+  HTTP2_HEADER_ACCEPT_ENCODING,
   HTTP2_METHOD_GET,
   HTTP_STATUS_BAD_GATEWAY,
   HTTP_STATUS_GATEWAY_TIMEOUT,
@@ -14,12 +22,18 @@ const {
   HTTP_STATUS_TOO_MANY_REQUESTS,
 } = http2.constants;
 
-const stash = {
+export const isZstdSupported = !!zlib.constants.ZSTD_CLEVEL_DEFAULT;
+
+const defaults = {
   cookiesTTL: false,
   credentials: requestCredentials.sameOrigin,
   digest: true,
   follow: 20,
   h2: false,
+  headers: {
+    [HTTP2_HEADER_ACCEPT]: `${ APPLICATION_JSON }, ${ TEXT_PLAIN }, ${ WILDCARD }`,
+    [HTTP2_HEADER_ACCEPT_ENCODING]: `br, ${ isZstdSupported ? 'zstd,' : '' } gzip, deflate, deflate-raw`,
+  },
   get maxRetryAfter() {
     return this[maxRetryAfter] ?? this.timeout;
   },
@@ -62,5 +76,5 @@ const stash = {
 };
 
 export default {
-  stash,
+  defaults,
 };

package/src/formdata.mjs

@@ -1,244 +1,246 @@
-import { File } from 'node:buffer';
-import { randomBytes } from 'node:crypto';
-import http2 from 'node:http2';
-import { toUSVString } from 'node:util';
-import {
-  APPLICATION_OCTET_STREAM,
-  MULTIPART_FORM_DATA,
-} from './mediatypes.mjs';
-import {
-  brandCheck,
-  isFileLike,
-  tap,
-} from './utils.mjs';
-
-const CRLF = '\r\n';
-const {
-  HTTP2_HEADER_CONTENT_DISPOSITION,
-  HTTP2_HEADER_CONTENT_TYPE,
-} = http2.constants;
-
-export class FormData {
-
-  static actuate(fd) {
-    const boundary = randomBytes(24).toString('hex');
-    const contentType = `${ MULTIPART_FORM_DATA }; boundary=${ boundary }`;
-    const prefix = `--${ boundary }${ CRLF }${ HTTP2_HEADER_CONTENT_DISPOSITION }: form-data`;
-
-    const escape = (str) => str.replace(/\n/g, '%0A').replace(/\r/g, '%0D').replace(/"/g, '%22');
-    const redress = (str) => str.replace(/\r?\n|\r/g, CRLF);
-
-    return {
-      contentType,
-      async* [Symbol.asyncIterator]() {
-        const encoder = new TextEncoder();
-
-        for (const [name, value] of fd) {
-          if (value.constructor === String) {
-            yield encoder.encode(`${ prefix }; name="${
-              escape(redress(name))
-            }"${ CRLF.repeat(2) }${ redress(value) }${ CRLF }`);
-          } else {
-            yield encoder.encode(`${ prefix }; name="${
-              escape(redress(name))
-            }"${ value.name ? `; filename="${ escape(value.name) }"` : '' }${ CRLF }${
-              HTTP2_HEADER_CONTENT_TYPE
-            }: ${
-              value.type || APPLICATION_OCTET_STREAM
-            }${ CRLF.repeat(2) }`);
-            yield* tap(value);
-            yield new Uint8Array([
-              13,
-              10,
-            ]);
-          }
-        }
-
-        yield encoder.encode(`--${ boundary }--`);
-      },
-    };
-  }
-
-  static alike(instance) {
-    return FormData.name === instance?.[Symbol.toStringTag];
-  }
-
-  static #enfoldEntry(name, value, filename) {
-    name = toUSVString(name);
-    filename &&= toUSVString(filename);
-
-    if (isFileLike(value)) {
-      filename ??= value.name || 'blob';
-      value = new File([value], filename, value);
-    } else if (this.#ensureInstance(value)) {
-      value.name = filename;
-    } else {
-      value = toUSVString(value);
-    }
-
-    return {
-      name,
-      value,
-    };
-  }
-
-  static #ensureInstance(value) {
-    return isFileLike(value) || (value === Object(value) && Reflect.has(value, Symbol.asyncIterator));
-  }
-
-  #entries = [];
-
-  get [Symbol.toStringTag]() {
-    return this.constructor.name;
-  }
-
-  constructor(input) {
-    if (input === Object(input)
-      && (input?.constructor === Object || Reflect.has(input, Symbol.iterator))) {
-
-      if (input.constructor !== Object) {
-        input = Array.from(input);
-      }
-
-      if (Array.isArray(input)) {
-        if (!input.every((it) => Array.isArray(it))) {
-          throw new TypeError(`Failed to construct '${
-            this[Symbol.toStringTag]
-          }': The provided value cannot be converted to a sequence.`);
-        } else if (!input.every((it) => it.length === 2)) {
-          throw new TypeError(`Failed to construct '${
-            this[Symbol.toStringTag]
-          }': Sequence initializer must only contain pair elements.`);
-        }
-      }
-
-      if (input.constructor === Object) {
-        input = Object.entries(input);
-      }
-
-      for (const [key, value] of input) { this.append(key, value); }
-    }
-  }
-
-  #ensureArgs(args, expected, method) {
-    if (args.length < expected) {
-      throw new TypeError(`Failed to execute '${ method }' on '${
-        this[Symbol.toStringTag]
-      }': ${ expected } arguments required, but only ${ args.length } present.`);
-    }
-
-    if ([
-      'append',
-      'set',
-    ].includes(method)) {
-      if (args.length === 3 && !this.constructor.#ensureInstance(args[1])) {
-        throw new TypeError(`Failed to execute '${ method }' on '${
-          this[Symbol.toStringTag]
-        }': parameter ${ expected } is not of type 'Blob'.`);
-      }
-    }
-
-    if (method === 'forEach') {
-      if (args[0]?.constructor !== Function) {
-        throw new TypeError(`Failed to execute '${ method }' on '${
-          this[Symbol.toStringTag]
-        }': parameter ${ expected } is not of type 'Function'.`);
-      }
-    }
-  }
-
-  append(...args) {
-    brandCheck(this, FormData);
-    this.#ensureArgs(args, 2, 'append');
-    this.#entries.push(this.constructor.#enfoldEntry(...args));
-  }
-
-  delete(...args) {
-    brandCheck(this, FormData);
-    this.#ensureArgs(args, 1, 'delete');
-    const name = toUSVString(args[0]);
-
-    this.#entries = this.#entries.filter((it) => it.name !== name);
-  }
-
-  forEach(...args) {
-    brandCheck(this, FormData);
-    this.#ensureArgs(args, 1, 'forEach');
-    const [callback, thisArg] = args;
-
-    for (const entry of this) {
-      Reflect.apply(callback, thisArg, [
-        ...entry.reverse(),
-        this,
-      ]);
-    }
-  }
-
-  get(...args) {
-    brandCheck(this, FormData);
-    this.#ensureArgs(args, 1, 'get');
-    const name = toUSVString(args[0]);
-
-    return (this.#entries.find((it) => it.name === name) ?? {}).value ?? null;
-  }
-
-  getAll(...args) {
-    brandCheck(this, FormData);
-    this.#ensureArgs(args, 1, 'getAll');
-    const name = toUSVString(args[0]);
-
-    return this.#entries.filter((it) => it.name === name).map((it) => it.value);
-  }
-
-  has(...args) {
-    brandCheck(this, FormData);
-    this.#ensureArgs(args, 1, 'has');
-    const name = toUSVString(args[0]);
-
-    return !!this.#entries.find((it) => it.name === name);
-  }
-
-  set(...args) {
-    brandCheck(this, FormData);
-    this.#ensureArgs(args, 2, 'set');
-    const entry = this.constructor.#enfoldEntry(...args);
-    const idx = this.#entries.findIndex((it) => it.name === entry.name);
-
-    if (idx !== -1) {
-      this.#entries.splice(idx, 1, entry);
-    } else {
-      this.#entries.push(entry);
-    }
-  }
-
-  * entries() {
-    brandCheck(this, FormData);
-    for (const { name, value } of this.#entries) {
-      yield [
-        name,
-        value,
-      ];
-    }
-  }
-
-  * keys() {
-    brandCheck(this, FormData);
-    for (const [name] of this) {
-      yield name;
-    }
-  }
-
-  * values() {
-    brandCheck(this, FormData);
-    for (const [, value] of this) {
-      yield value;
-    }
-  }
-
-  [Symbol.iterator]() {
-    brandCheck(this, FormData);
-
-    return this.entries();
-  }
-
-}
+import { File } from 'node:buffer';
+import { randomBytes } from 'node:crypto';
+import http2 from 'node:http2';
+import { toUSVString } from 'node:util';
+import {
+  APPLICATION_OCTET_STREAM,
+  MULTIPART_FORM_DATA,
+} from './mediatypes.mjs';
+import {
+  brandCheck,
+  isFileLike,
+  tap,
+} from './utils.mjs';
+
+const CRLF = '\r\n';
+const {
+  HTTP2_HEADER_CONTENT_DISPOSITION,
+  HTTP2_HEADER_CONTENT_TYPE,
+} = http2.constants;
+
+export class FormData {
+
+  static actuate(fd) {
+    const boundary = randomBytes(24).toString('hex');
+    const contentType = `${ MULTIPART_FORM_DATA }; boundary=${ boundary }`;
+    const prefix = `--${ boundary }${ CRLF }${ HTTP2_HEADER_CONTENT_DISPOSITION }: form-data`;
+
+    const escape = (str) => str.replace(/\n/g, '%0A').replace(/\r/g, '%0D').replace(/"/g, '%22');
+    const redress = (str) => str.replace(/\r?\n|\r/g, CRLF);
+
+    return {
+      contentType,
+      async* [Symbol.asyncIterator]() {
+        const encoder = new TextEncoder();
+
+        for (const [name, value] of fd) {
+          if (value.constructor === String) {
+            yield encoder.encode(`${ prefix }; name="${
+              escape(redress(name))
+            }"${ CRLF.repeat(2) }${ redress(value) }${ CRLF }`);
+          } else {
+            yield encoder.encode(`${ prefix }; name="${
+              escape(redress(name))
+            }"${ value.name ? `; filename="${ escape(value.name) }"` : '' }${ CRLF }${
+              HTTP2_HEADER_CONTENT_TYPE
+            }: ${
+              value.type || APPLICATION_OCTET_STREAM
+            }${ CRLF.repeat(2) }`);
+            yield* tap(value);
+            yield new Uint8Array([
+              13,
+              10,
+            ]);
+          }
+        }
+
+        yield encoder.encode(`--${ boundary }--`);
+      },
+    };
+  }
+
+  static alike(instance) {
+    return FormData.name === instance?.[Symbol.toStringTag];
+  }
+
+  static #enfoldEntry(name, value, filename) {
+    name = toUSVString(name);
+    filename &&= toUSVString(filename);
+
+    if (isFileLike(value)) {
+      filename ??= value.name || 'blob';
+      value = new File([value], filename, value);
+    } else if (this.#ensureInstance(value)) {
+      value.name = filename;
+    } else {
+      value = toUSVString(value);
+    }
+
+    return {
+      name,
+      value,
+    };
+  }
+
+  static #ensureInstance(value) {
+    return isFileLike(value) || (value === Object(value) && Reflect.has(value, Symbol.asyncIterator));
+  }
+
+  #entries = [];
+
+  get [Symbol.toStringTag]() {
+    return this.constructor.name;
+  }
+
+  constructor(input) {
+    if (input === Object(input)
+      && (input?.constructor === Object || Reflect.has(input, Symbol.iterator))) {
+
+      if (input.constructor !== Object) {
+        input = Array.from(input);
+      }
+
+      if (Array.isArray(input)) {
+        if (!input.every((it) => Array.isArray(it))) {
+          throw new TypeError(`Failed to construct '${
+            this[Symbol.toStringTag]
+          }': The provided value cannot be converted to a sequence.`);
+        } else if (!input.every((it) => it.length === 2)) {
+          throw new TypeError(`Failed to construct '${
+            this[Symbol.toStringTag]
+          }': Sequence initializer must only contain pair elements.`);
+        }
+      }
+
+      if (input.constructor === Object) {
+        input = Object.entries(input);
+      }
+
+      for (const [key, value] of input) {
+        this.append(key, value);
+      }
+    }
+  }
+
+  #ensureArgs(args, expected, method) {
+    if (args.length < expected) {
+      throw new TypeError(`Failed to execute '${ method }' on '${
+        this[Symbol.toStringTag]
+      }': ${ expected } arguments required, but only ${ args.length } present.`);
+    }
+
+    if ([
+      'append',
+      'set',
+    ].includes(method)) {
+      if (args.length === 3 && !this.constructor.#ensureInstance(args[1])) {
+        throw new TypeError(`Failed to execute '${ method }' on '${
+          this[Symbol.toStringTag]
+        }': parameter ${ expected } is not of type 'Blob'.`);
+      }
+    }
+
+    if (method === 'forEach') {
+      if (args[0]?.constructor !== Function) {
+        throw new TypeError(`Failed to execute '${ method }' on '${
+          this[Symbol.toStringTag]
+        }': parameter ${ expected } is not of type 'Function'.`);
+      }
+    }
+  }
+
+  append(...args) {
+    brandCheck(this, FormData);
+    this.#ensureArgs(args, 2, 'append');
+    this.#entries.push(this.constructor.#enfoldEntry(...args));
+  }
+
+  delete(...args) {
+    brandCheck(this, FormData);
+    this.#ensureArgs(args, 1, 'delete');
+    const name = toUSVString(args[0]);
+
+    this.#entries = this.#entries.filter((it) => it.name !== name);
+  }
+
+  forEach(...args) {
+    brandCheck(this, FormData);
+    this.#ensureArgs(args, 1, 'forEach');
+    const [callback, thisArg] = args;
+
+    for (const entry of this) {
+      Reflect.apply(callback, thisArg, [
+        ...entry.reverse(),
+        this,
+      ]);
+    }
+  }
+
+  get(...args) {
+    brandCheck(this, FormData);
+    this.#ensureArgs(args, 1, 'get');
+    const name = toUSVString(args[0]);
+
+    return (this.#entries.find((it) => it.name === name) ?? {}).value ?? null;
+  }
+
+  getAll(...args) {
+    brandCheck(this, FormData);
+    this.#ensureArgs(args, 1, 'getAll');
+    const name = toUSVString(args[0]);
+
+    return this.#entries.filter((it) => it.name === name).map((it) => it.value);
+  }
+
+  has(...args) {
+    brandCheck(this, FormData);
+    this.#ensureArgs(args, 1, 'has');
+    const name = toUSVString(args[0]);
+
+    return !!this.#entries.find((it) => it.name === name);
+  }
+
+  set(...args) {
+    brandCheck(this, FormData);
+    this.#ensureArgs(args, 2, 'set');
+    const entry = this.constructor.#enfoldEntry(...args);
+    const idx = this.#entries.findIndex((it) => it.name === entry.name);
+
+    if (idx !== -1) {
+      this.#entries.splice(idx, 1, entry);
+    } else {
+      this.#entries.push(entry);
+    }
+  }
+
+  * entries() {
+    brandCheck(this, FormData);
+    for (const { name, value } of this.#entries) {
+      yield [
+        name,
+        value,
+      ];
+    }
+  }
+
+  * keys() {
+    brandCheck(this, FormData);
+    for (const [name] of this) {
+      yield name;
+    }
+  }
+
+  * values() {
+    brandCheck(this, FormData);
+    for (const [, value] of this) {
+      yield value;
+    }
+  }
+
+  [Symbol.iterator]() {
+    brandCheck(this, FormData);
+
+    return this.entries();
+  }
+
+}

package/src/index.mjs

@@ -1,8 +1,8 @@
 import http from 'node:http';
 import http2 from 'node:http2';
 import https from 'node:https';
+import config from './config.mjs';
 import { requestRedirect } from './constants.mjs';
-import defaults from './defaults.mjs';
 import { APPLICATION_OCTET_STREAM } from './mediatypes.mjs';
 import { preflight } from './preflight.mjs';
 import { transfer } from './transfer.mjs';
@@ -40,8 +40,8 @@ export default function rekwest(url, options) {
 
 Reflect.defineProperty(rekwest, 'defaults', {
   enumerable: true,
-  get() { return defaults.stash; },
-  set(value) { defaults.stash = copyWithMerge(defaults.stash, value); },
+  get() { return config.defaults; },
+  set(value) { config.defaults = copyWithMerge(config.defaults, value); },
 });
 
 Reflect.defineProperty(rekwest, 'extend', {

package/src/preflight.mjs

@@ -1,14 +1,9 @@
 import http2 from 'node:http2';
+import { isZstdSupported } from './config.mjs';
 import { requestCredentials } from './constants.mjs';
 import { Cookies } from './cookies.mjs';
-import {
-  APPLICATION_JSON,
-  TEXT_PLAIN,
-  WILDCARD,
-} from './mediatypes.mjs';
 
 const {
-  HTTP2_HEADER_ACCEPT,
   HTTP2_HEADER_ACCEPT_ENCODING,
   HTTP2_HEADER_AUTHORITY,
   HTTP2_HEADER_AUTHORIZATION,
@@ -71,10 +66,19 @@ export const preflight = (options) => {
   }
 
   options.headers = {
-    [HTTP2_HEADER_ACCEPT]: `${ APPLICATION_JSON }, ${ TEXT_PLAIN }, ${ WILDCARD }`,
-    [HTTP2_HEADER_ACCEPT_ENCODING]: 'br, deflate, deflate-raw, gzip, identity',
     ...Object.entries(options.headers ?? {})
-             .reduce((acc, [key, val]) => (acc[key.toLowerCase()] = val, acc), {}),
+             .reduce((acc, [key, val]) => {
+               acc[key.toLowerCase()] = val;
+
+               if (acc[HTTP2_HEADER_ACCEPT_ENCODING]?.match(/\bzstd\b/i) && !isZstdSupported) {
+                 acc[HTTP2_HEADER_ACCEPT_ENCODING] = val.replace(/\s?zstd,?/i, '').trim();
+                 if (!acc[HTTP2_HEADER_ACCEPT_ENCODING]) {
+                   Reflect.deleteProperty(acc, HTTP2_HEADER_ACCEPT_ENCODING);
+                 }
+               }
+
+               return acc;
+             }, {}),
     ...h2 && {
       [HTTP2_HEADER_AUTHORITY]: url.host,
       [HTTP2_HEADER_METHOD]: method,

package/src/utils.mjs

@@ -5,7 +5,7 @@ import {
 import http2 from 'node:http2';
 import { pipeline } from 'node:stream';
 import zlib from 'node:zlib';
-import defaults from './defaults.mjs';
+import config, { isZstdSupported } from './config.mjs';
 import {
   RequestError,
   TimeoutError,
@@ -79,6 +79,8 @@ export const compress = (readable, encodings = '') => {
       encoders.push(zlib.createDeflateRaw());
     } else if (/\bgzip\b/i.test(encoding)) {
       encoders.push(zlib.createGzip());
+    } else if (isZstdSupported && /\bzstd\b/i.test(encoding)) {
+      encoders.push(zlib.createZstdCompress());
     } else {
       return readable;
     }
@@ -110,6 +112,8 @@ export const decompress = (readable, encodings = '') => {
       decoders.push(zlib.createInflateRaw());
     } else if (/\bgzip\b/i.test(encoding)) {
       decoders.push(zlib.createGunzip());
+    } else if (isZstdSupported && /\bzstd\b/i.test(encoding)) {
+      decoders.push(zlib.createZstdDecompress());
     } else {
       return readable;
     }
@@ -165,7 +169,7 @@ export const merge = (target, ...rest) => {
 
 export const normalize = (url, options = {}) => {
   if (!options.redirected) {
-    options = copyWithMerge(defaults.stash, options);
+    options = copyWithMerge(config.defaults, options);
   }
 
   if (options.trimTrailingSlashes) {