rekwest 2.3.6 → 2.4.0

package/README.md

@@ -130,7 +130,7 @@ console.log(res.body);
   * `h2` **{boolean}** `Default: false` Forces use of the HTTP2 protocol
   * `headers` **{Object}** Headers to add to the request
   * `parse` **{boolean}** `Default: true` Parse response body, or simply return a buffer
-  * `redirect` **{boolean | error | follow}** `Default: 'follow'` Controls redirect flow
+  * `redirect` **{error | follow | manual}** `Default: 'follow'` Controls redirect flow
   * `thenable` **{boolean}** `Default: false` Controls promise resolutions
 * **Returns:** Promise that resolves to
   extended [http.IncomingMessage](https://nodejs.org/api/http.html#http_class_http_incomingmessage)
@@ -168,6 +168,7 @@ Method with limited functionality to use with streams and pipes
 * No automata
 * No redirects
 * Pass `h2: true` in options to use the HTTP2 protocol
+  * Or use `ackn({ url: URL })` method in advance to probe the available protocols
 
 ---
 

package/dist/helpers.js

@@ -1,7 +1,7 @@
 "use strict";
 
 exports.__esModule = true;
-exports.premix = exports.preflight = exports.merge = exports.dispatch = exports.decompress = exports.compress = void 0;
+exports.redirects = exports.premix = exports.preflight = exports.merge = exports.dispatch = exports.decompress = exports.compress = void 0;
 exports.tap = tap;
 exports.transform = void 0;
 
@@ -179,7 +179,13 @@ const preflight = options => {
   };
   options.method ??= method;
   options.parse ??= true;
-  options.redirect ??= 'follow';
+  options.redirect ??= redirects.follow;
+
+  if (!Object.values(redirects).includes(options.redirect)) {
+    options.createConnection?.().destroy();
+    throw new TypeError(`Failed to read the 'redirect' property from 'options': The provided value '${options.redirect}' is not a valid enum value.`);
+  }
+
   options.redirected ??= false;
   options.thenable ??= false;
   return options;
@@ -230,7 +236,7 @@ const premix = (res, {
       enumerable: true,
       value: async function () {
         if (this.bodyUsed) {
-          throw new TypeError('Response stream already read');
+          throw new TypeError('Response stream already read.');
         }
 
         let spool = [];
@@ -276,6 +282,12 @@ const premix = (res, {
 };
 
 exports.premix = premix;
+const redirects = {
+  error: 'error',
+  follow: 'follow',
+  manual: 'manual'
+};
+exports.redirects = redirects;
 
 async function* tap(value) {
   if (Reflect.has(value, Symbol.asyncIterator)) {

package/dist/index.js

@@ -96,7 +96,7 @@ async function rekwest(url, options = {}) {
   }
 
   if (options.body && [HTTP2_METHOD_GET, HTTP2_METHOD_HEAD].includes(options.method)) {
-    throw new TypeError(`Request with ${HTTP2_METHOD_GET}/${HTTP2_METHOD_HEAD} method cannot have body`);
+    throw new TypeError(`Request with ${HTTP2_METHOD_GET}/${HTTP2_METHOD_HEAD} method cannot have body.`);
   }
 
   if (!options.follow) {
@@ -175,15 +175,15 @@ async function rekwest(url, options = {}) {
       });
 
       if (follow && /^3\d{2}$/.test(res.statusCode) && res.headers[HTTP2_HEADER_LOCATION]) {
-        if (redirect === 'error') {
-          res.emit('error', new _errors.RequestError(`Unexpected redirect, redirect mode is set to '${redirect}'`));
+        if (redirect === _helpers.redirects.error) {
+          res.emit('error', new _errors.RequestError(`Unexpected redirect, redirect mode is set to '${redirect}'.`));
         }
 
-        if (redirect === 'follow') {
+        if (redirect === _helpers.redirects.follow) {
           options.url = new URL(res.headers[HTTP2_HEADER_LOCATION], url).href;
 
           if (res.statusCode !== HTTP_STATUS_SEE_OTHER && body === Object(body) && body.pipe?.constructor === Function) {
-            res.emit('error', new _errors.RequestError(`Unable to ${redirect} redirect with body as readable stream`));
+            res.emit('error', new _errors.RequestError(`Unable to ${redirect} redirect with body as readable stream.`));
           }
 
           options.follow--;
@@ -262,7 +262,8 @@ Reflect.defineProperty(rekwest, 'stream', {
         headers: {
           [HTTP2_HEADER_CONTENT_TYPE]: _mediatypes.APPLICATION_OCTET_STREAM
         }
-      }, options)
+      }, options),
+      redirect: _helpers.redirects.manual
     });
 
     if (options.h2) {

package/package.json

@@ -13,8 +13,8 @@
     "@babel/eslint-parser": "^7.16.5",
     "@babel/preset-env": "^7.16.11",
     "c8": "^7.11.0",
-    "eslint": "^8.7.0",
-    "eslint-config-ultra-refined": "^2.3.0",
+    "eslint": "^8.8.0",
+    "eslint-config-ultra-refined": "^2.4.0",
     "mocha": "^9.2.0"
   },
   "description": "The robust request library that humanity deserves 🌐",
@@ -56,8 +56,9 @@
     "lint": "eslint . --ext .cjs,.js,.mjs",
     "prepack": "npm run build && sh pony.sh",
     "pretest": "rm -rf coverage && npm run cert:gen",
-    "test": "mocha --exit --recursive",
+    "test": "mocha",
+    "test:bail": "mocha --bail",
     "test:cover": "c8 --include=src --reporter=lcov --reporter=text npm test"
   },
-  "version": "2.3.6"
+  "version": "2.4.0"
 }

package/src/helpers.mjs

@@ -1,317 +1,331 @@
-import { Blob } from 'buffer';
-import http2 from 'http2';
-import {
-  PassThrough,
-  Readable,
-} from 'stream';
-import {
-  promisify,
-  types,
-} from 'util';
-import zlib from 'zlib';
-import { Cookies } from './cookies.mjs';
-import { File } from './file.mjs';
-import { FormData } from './formdata.mjs';
-import {
-  APPLICATION_FORM_URLENCODED,
-  APPLICATION_JSON,
-  APPLICATION_OCTET_STREAM,
-  TEXT_PLAIN,
-  WILDCARD,
-} from './mediatypes.mjs';
-
-const {
-  HTTP2_HEADER_ACCEPT,
-  HTTP2_HEADER_ACCEPT_ENCODING,
-  HTTP2_HEADER_AUTHORITY,
-  HTTP2_HEADER_CONTENT_ENCODING,
-  HTTP2_HEADER_CONTENT_LENGTH,
-  HTTP2_HEADER_CONTENT_TYPE,
-  HTTP2_HEADER_COOKIE,
-  HTTP2_HEADER_METHOD,
-  HTTP2_HEADER_PATH,
-  HTTP2_HEADER_SCHEME,
-  HTTP2_METHOD_GET,
-  HTTP2_METHOD_HEAD,
-} = http2.constants;
-
-const brotliCompress = promisify(zlib.brotliCompress);
-const brotliDecompress = promisify(zlib.brotliDecompress);
-const gzip = promisify(zlib.gzip);
-const gunzip = promisify(zlib.gunzip);
-const deflate = promisify(zlib.deflate);
-const inflate = promisify(zlib.inflate);
-
-export const compress = (buf, encoding, { async = false } = {}) => {
-  encoding &&= encoding.match(/(?<encoding>\bbr\b|\bdeflate\b|\bgzip\b)/i)?.groups.encoding.toLowerCase();
-  const compressor = {
-    br: async ? brotliCompress : zlib.brotliCompressSync,
-    deflate: async ? deflate : zlib.deflateSync,
-    gzip: async ? gzip : zlib.gzipSync,
-  }[encoding];
-
-  return compressor?.(buf) ?? (async ? Promise.resolve(buf) : buf);
-};
-
-export const decompress = (buf, encoding, { async = false } = {}) => {
-  encoding &&= encoding.match(/(?<encoding>\bbr\b|\bdeflate\b|\bgzip\b)/i)?.groups.encoding.toLowerCase();
-  const decompressor = {
-    br: async ? brotliDecompress : zlib.brotliDecompressSync,
-    deflate: async ? inflate : zlib.inflateSync,
-    gzip: async ? gunzip : zlib.gunzipSync,
-  }[encoding];
-
-  return decompressor?.(buf) ?? (async ? Promise.resolve(buf) : buf);
-};
-
-export const dispatch = (req, { body, headers }) => {
-  if (types.isUint8Array(body)) {
-    return req.end(body);
-  }
-
-  if (body === Object(body) && !Buffer.isBuffer(body)) {
-    if (body.pipe?.constructor !== Function
-      && (Reflect.has(body, Symbol.asyncIterator) || Reflect.has(body, Symbol.iterator))) {
-      body = Readable.from(body);
-    }
-
-    const compressor = {
-      br: zlib.createBrotliCompress,
-      deflate: zlib.createDeflate,
-      gzip: zlib.createGzip,
-    }[headers[HTTP2_HEADER_CONTENT_ENCODING]] ?? PassThrough;
-
-    body.pipe(compressor()).pipe(req);
-  } else {
-    req.end(body);
-  }
-};
-
-export const merge = (target = {}, ...rest) => {
-  target = JSON.parse(JSON.stringify(target));
-  if (!rest.length) {
-    return target;
-  }
-
-  rest.filter((it) => it === Object(it)).forEach((it) => {
-    Object.entries(it).reduce((acc, [key, val]) => {
-      if ([
-        acc[key]?.constructor,
-        val?.constructor,
-      ].every((it) => [
-        Array,
-        Object,
-      ].includes(it))) {
-        if (acc[key]?.constructor === val.constructor) {
-          acc[key] = merge(acc[key], val);
-        } else {
-          acc[key] = val;
-        }
-      } else {
-        acc[key] = val;
-      }
-
-      return acc;
-    }, target);
-  });
-
-  return target;
-};
-
-export const preflight = (options) => {
-  const url = options.url = new URL(options.url);
-  const { cookies, h2 = false, method = HTTP2_METHOD_GET, headers, redirected } = options;
-
-  if (h2) {
-    options.endStream = [
-      HTTP2_METHOD_GET,
-      HTTP2_METHOD_HEAD,
-    ].includes(method);
-  }
-
-  if (cookies !== false) {
-    let cookie = Cookies.jar.get(url.origin);
-
-    if (cookies === Object(cookies) && !redirected) {
-      if (cookie) {
-        new Cookies(cookies).forEach(function (val, key) {
-          this.set(key, val);
-        }, cookie);
-      } else {
-        cookie = new Cookies(cookies);
-        Cookies.jar.set(url.origin, cookie);
-      }
-    }
-
-    options.headers = {
-      ...cookie && { [HTTP2_HEADER_COOKIE]: cookie },
-      ...headers,
-    };
-  }
-
-  options.digest ??= true;
-  options.follow ??= 20;
-  options.h2 ??= h2;
-  options.headers = {
-    [HTTP2_HEADER_ACCEPT]: `${ APPLICATION_JSON }, ${ TEXT_PLAIN }, ${ WILDCARD }`,
-    [HTTP2_HEADER_ACCEPT_ENCODING]: 'br, deflate, gzip, identity',
-    ...Object.entries(options.headers ?? {})
-             .reduce((acc, [key, val]) => (acc[key.toLowerCase()] = val, acc), {}),
-    ...h2 && {
-      [HTTP2_HEADER_AUTHORITY]: url.host,
-      [HTTP2_HEADER_METHOD]: method,
-      [HTTP2_HEADER_PATH]: `${ url.pathname }${ url.search }`,
-      [HTTP2_HEADER_SCHEME]: url.protocol.replace(/\p{Punctuation}/gu, ''),
-    },
-  };
-
-  options.method ??= method;
-  options.parse ??= true;
-  options.redirect ??= 'follow';
-  options.redirected ??= false;
-  options.thenable ??= false;
-
-  return options;
-};
-
-export const premix = (res, { digest = false, parse = false } = {}) => {
-  if (!digest) {
-    Object.defineProperties(res, {
-      arrayBuffer: {
-        enumerable: true,
-        value: function () {
-          parse &&= false;
-
-          return this.body().then(({ buffer, byteLength, byteOffset }) => buffer.slice(
-            byteOffset,
-            byteOffset + byteLength,
-          ));
-        },
-      },
-      blob: {
-        enumerable: true,
-        value: function () {
-          return this.arrayBuffer().then((res) => new Blob([res]));
-        },
-      },
-      json: {
-        enumerable: true,
-        value: function () {
-          return this.text().then((res) => JSON.parse(res));
-        },
-      },
-      text: {
-        enumerable: true,
-        value: function () {
-          return this.blob().then((blob) => blob.text());
-        },
-      },
-    });
-  }
-
-  return Object.defineProperties(res, {
-    body: {
-      enumerable: true,
-      value: async function () {
-        if (this.bodyUsed) {
-          throw new TypeError('Response stream already read');
-        }
-
-        let spool = [];
-
-        for await (const chunk of this) {
-          spool.push(chunk);
-        }
-
-        spool = Buffer.concat(spool);
-
-        if (spool.length) {
-          spool = await decompress(spool, this.headers[HTTP2_HEADER_CONTENT_ENCODING], { async: true });
-        }
-
-        if (spool.length && parse) {
-          const contentType = this.headers[HTTP2_HEADER_CONTENT_TYPE] ?? '';
-          const charset = contentType.split(';')
-                                     .find((it) => /charset=/i.test(it))
-                                     ?.toLowerCase()
-                                     .replace('charset=', '')
-                                     .replace('iso-8859-1', 'latin1')
-                                     .trim() || 'utf-8';
-
-          if (/\bjson\b/i.test(contentType)) {
-            spool = JSON.parse(spool.toString(charset));
-          } else if (/\b(text|xml)\b/i.test(contentType)) {
-            if (/\b(latin1|ucs-2|utf-(8|16le))\b/.test(charset)) {
-              spool = spool.toString(charset);
-            } else {
-              spool = new TextDecoder(charset).decode(spool);
-            }
-          }
-        }
-
-        return spool;
-      },
-      writable: true,
-    },
-    bodyUsed: {
-      enumerable: true,
-      get: function () {
-        return this.readableEnded;
-      },
-    },
-  });
-};
-
-export async function* tap(value) {
-  if (Reflect.has(value, Symbol.asyncIterator)) {
-    yield* value;
-  } else if (value.stream) {
-    yield* value.stream();
-  } else {
-    yield await value.arrayBuffer();
-  }
-}
-
-export const transform = (body, options) => {
-  let headers = {};
-
-  if (File.alike(body)) {
-    headers = {
-      [HTTP2_HEADER_CONTENT_LENGTH]: body.size,
-      [HTTP2_HEADER_CONTENT_TYPE]: body.type || APPLICATION_OCTET_STREAM,
-    };
-    body = body.stream?.() ?? Readable.from(tap(body));
-  } else if (FormData.alike(body)) {
-    body = FormData.actuate(body);
-    headers = { [HTTP2_HEADER_CONTENT_TYPE]: body.contentType };
-  } else if (body === Object(body) && !Reflect.has(body, Symbol.asyncIterator)) {
-    if (body.constructor === URLSearchParams) {
-      headers = { [HTTP2_HEADER_CONTENT_TYPE]: APPLICATION_FORM_URLENCODED };
-      body = body.toString();
-    } else if (!Buffer.isBuffer(body)
-      && !(!Array.isArray(body) && Reflect.has(body, Symbol.iterator))) {
-      headers = { [HTTP2_HEADER_CONTENT_TYPE]: APPLICATION_JSON };
-      body = JSON.stringify(body);
-    }
-
-    if (types.isUint8Array(body) || Buffer.isBuffer(body) || body !== Object(body)) {
-      if (options.headers[HTTP2_HEADER_CONTENT_ENCODING]) {
-        body = compress(body, options.headers[HTTP2_HEADER_CONTENT_ENCODING]);
-      }
-
-      headers = {
-        ...headers,
-        [HTTP2_HEADER_CONTENT_LENGTH]: Buffer.byteLength(body),
-      };
-    }
-  }
-
-  Object.assign(options.headers, {
-    ...headers,
-    ...options.headers[HTTP2_HEADER_CONTENT_TYPE] && {
-      [HTTP2_HEADER_CONTENT_TYPE]: options.headers[HTTP2_HEADER_CONTENT_TYPE],
-    },
-  });
-
-  return body;
-};
+import { Blob } from 'buffer';
+import http2 from 'http2';
+import {
+  PassThrough,
+  Readable,
+} from 'stream';
+import {
+  promisify,
+  types,
+} from 'util';
+import zlib from 'zlib';
+import { Cookies } from './cookies.mjs';
+import { File } from './file.mjs';
+import { FormData } from './formdata.mjs';
+import {
+  APPLICATION_FORM_URLENCODED,
+  APPLICATION_JSON,
+  APPLICATION_OCTET_STREAM,
+  TEXT_PLAIN,
+  WILDCARD,
+} from './mediatypes.mjs';
+
+const {
+  HTTP2_HEADER_ACCEPT,
+  HTTP2_HEADER_ACCEPT_ENCODING,
+  HTTP2_HEADER_AUTHORITY,
+  HTTP2_HEADER_CONTENT_ENCODING,
+  HTTP2_HEADER_CONTENT_LENGTH,
+  HTTP2_HEADER_CONTENT_TYPE,
+  HTTP2_HEADER_COOKIE,
+  HTTP2_HEADER_METHOD,
+  HTTP2_HEADER_PATH,
+  HTTP2_HEADER_SCHEME,
+  HTTP2_METHOD_GET,
+  HTTP2_METHOD_HEAD,
+} = http2.constants;
+
+const brotliCompress = promisify(zlib.brotliCompress);
+const brotliDecompress = promisify(zlib.brotliDecompress);
+const gzip = promisify(zlib.gzip);
+const gunzip = promisify(zlib.gunzip);
+const deflate = promisify(zlib.deflate);
+const inflate = promisify(zlib.inflate);
+
+export const compress = (buf, encoding, { async = false } = {}) => {
+  encoding &&= encoding.match(/(?<encoding>\bbr\b|\bdeflate\b|\bgzip\b)/i)?.groups.encoding.toLowerCase();
+  const compressor = {
+    br: async ? brotliCompress : zlib.brotliCompressSync,
+    deflate: async ? deflate : zlib.deflateSync,
+    gzip: async ? gzip : zlib.gzipSync,
+  }[encoding];
+
+  return compressor?.(buf) ?? (async ? Promise.resolve(buf) : buf);
+};
+
+export const decompress = (buf, encoding, { async = false } = {}) => {
+  encoding &&= encoding.match(/(?<encoding>\bbr\b|\bdeflate\b|\bgzip\b)/i)?.groups.encoding.toLowerCase();
+  const decompressor = {
+    br: async ? brotliDecompress : zlib.brotliDecompressSync,
+    deflate: async ? inflate : zlib.inflateSync,
+    gzip: async ? gunzip : zlib.gunzipSync,
+  }[encoding];
+
+  return decompressor?.(buf) ?? (async ? Promise.resolve(buf) : buf);
+};
+
+export const dispatch = (req, { body, headers }) => {
+  if (types.isUint8Array(body)) {
+    return req.end(body);
+  }
+
+  if (body === Object(body) && !Buffer.isBuffer(body)) {
+    if (body.pipe?.constructor !== Function
+      && (Reflect.has(body, Symbol.asyncIterator) || Reflect.has(body, Symbol.iterator))) {
+      body = Readable.from(body);
+    }
+
+    const compressor = {
+      br: zlib.createBrotliCompress,
+      deflate: zlib.createDeflate,
+      gzip: zlib.createGzip,
+    }[headers[HTTP2_HEADER_CONTENT_ENCODING]] ?? PassThrough;
+
+    body.pipe(compressor()).pipe(req);
+  } else {
+    req.end(body);
+  }
+};
+
+export const merge = (target = {}, ...rest) => {
+  target = JSON.parse(JSON.stringify(target));
+  if (!rest.length) {
+    return target;
+  }
+
+  rest.filter((it) => it === Object(it)).forEach((it) => {
+    Object.entries(it).reduce((acc, [key, val]) => {
+      if ([
+        acc[key]?.constructor,
+        val?.constructor,
+      ].every((it) => [
+        Array,
+        Object,
+      ].includes(it))) {
+        if (acc[key]?.constructor === val.constructor) {
+          acc[key] = merge(acc[key], val);
+        } else {
+          acc[key] = val;
+        }
+      } else {
+        acc[key] = val;
+      }
+
+      return acc;
+    }, target);
+  });
+
+  return target;
+};
+
+export const preflight = (options) => {
+  const url = options.url = new URL(options.url);
+  const { cookies, h2 = false, method = HTTP2_METHOD_GET, headers, redirected } = options;
+
+  if (h2) {
+    options.endStream = [
+      HTTP2_METHOD_GET,
+      HTTP2_METHOD_HEAD,
+    ].includes(method);
+  }
+
+  if (cookies !== false) {
+    let cookie = Cookies.jar.get(url.origin);
+
+    if (cookies === Object(cookies) && !redirected) {
+      if (cookie) {
+        new Cookies(cookies).forEach(function (val, key) {
+          this.set(key, val);
+        }, cookie);
+      } else {
+        cookie = new Cookies(cookies);
+        Cookies.jar.set(url.origin, cookie);
+      }
+    }
+
+    options.headers = {
+      ...cookie && { [HTTP2_HEADER_COOKIE]: cookie },
+      ...headers,
+    };
+  }
+
+  options.digest ??= true;
+  options.follow ??= 20;
+  options.h2 ??= h2;
+  options.headers = {
+    [HTTP2_HEADER_ACCEPT]: `${ APPLICATION_JSON }, ${ TEXT_PLAIN }, ${ WILDCARD }`,
+    [HTTP2_HEADER_ACCEPT_ENCODING]: 'br, deflate, gzip, identity',
+    ...Object.entries(options.headers ?? {})
+             .reduce((acc, [key, val]) => (acc[key.toLowerCase()] = val, acc), {}),
+    ...h2 && {
+      [HTTP2_HEADER_AUTHORITY]: url.host,
+      [HTTP2_HEADER_METHOD]: method,
+      [HTTP2_HEADER_PATH]: `${ url.pathname }${ url.search }`,
+      [HTTP2_HEADER_SCHEME]: url.protocol.replace(/\p{Punctuation}/gu, ''),
+    },
+  };
+
+  options.method ??= method;
+  options.parse ??= true;
+  options.redirect ??= redirects.follow;
+
+  if (!Object.values(redirects).includes(options.redirect)) {
+    options.createConnection?.().destroy();
+    throw new TypeError(`Failed to read the 'redirect' property from 'options': The provided value '${
+      options.redirect
+    }' is not a valid enum value.`);
+  }
+
+  options.redirected ??= false;
+  options.thenable ??= false;
+
+  return options;
+};
+
+export const premix = (res, { digest = false, parse = false } = {}) => {
+  if (!digest) {
+    Object.defineProperties(res, {
+      arrayBuffer: {
+        enumerable: true,
+        value: function () {
+          parse &&= false;
+
+          return this.body().then(({ buffer, byteLength, byteOffset }) => buffer.slice(
+            byteOffset,
+            byteOffset + byteLength,
+          ));
+        },
+      },
+      blob: {
+        enumerable: true,
+        value: function () {
+          return this.arrayBuffer().then((res) => new Blob([res]));
+        },
+      },
+      json: {
+        enumerable: true,
+        value: function () {
+          return this.text().then((res) => JSON.parse(res));
+        },
+      },
+      text: {
+        enumerable: true,
+        value: function () {
+          return this.blob().then((blob) => blob.text());
+        },
+      },
+    });
+  }
+
+  return Object.defineProperties(res, {
+    body: {
+      enumerable: true,
+      value: async function () {
+        if (this.bodyUsed) {
+          throw new TypeError('Response stream already read.');
+        }
+
+        let spool = [];
+
+        for await (const chunk of this) {
+          spool.push(chunk);
+        }
+
+        spool = Buffer.concat(spool);
+
+        if (spool.length) {
+          spool = await decompress(spool, this.headers[HTTP2_HEADER_CONTENT_ENCODING], { async: true });
+        }
+
+        if (spool.length && parse) {
+          const contentType = this.headers[HTTP2_HEADER_CONTENT_TYPE] ?? '';
+          const charset = contentType.split(';')
+                                     .find((it) => /charset=/i.test(it))
+                                     ?.toLowerCase()
+                                     .replace('charset=', '')
+                                     .replace('iso-8859-1', 'latin1')
+                                     .trim() || 'utf-8';
+
+          if (/\bjson\b/i.test(contentType)) {
+            spool = JSON.parse(spool.toString(charset));
+          } else if (/\b(text|xml)\b/i.test(contentType)) {
+            if (/\b(latin1|ucs-2|utf-(8|16le))\b/.test(charset)) {
+              spool = spool.toString(charset);
+            } else {
+              spool = new TextDecoder(charset).decode(spool);
+            }
+          }
+        }
+
+        return spool;
+      },
+      writable: true,
+    },
+    bodyUsed: {
+      enumerable: true,
+      get: function () {
+        return this.readableEnded;
+      },
+    },
+  });
+};
+
+export const redirects = {
+  error: 'error',
+  follow: 'follow',
+  manual: 'manual',
+};
+
+export async function* tap(value) {
+  if (Reflect.has(value, Symbol.asyncIterator)) {
+    yield* value;
+  } else if (value.stream) {
+    yield* value.stream();
+  } else {
+    yield await value.arrayBuffer();
+  }
+}
+
+export const transform = (body, options) => {
+  let headers = {};
+
+  if (File.alike(body)) {
+    headers = {
+      [HTTP2_HEADER_CONTENT_LENGTH]: body.size,
+      [HTTP2_HEADER_CONTENT_TYPE]: body.type || APPLICATION_OCTET_STREAM,
+    };
+    body = body.stream?.() ?? Readable.from(tap(body));
+  } else if (FormData.alike(body)) {
+    body = FormData.actuate(body);
+    headers = { [HTTP2_HEADER_CONTENT_TYPE]: body.contentType };
+  } else if (body === Object(body) && !Reflect.has(body, Symbol.asyncIterator)) {
+    if (body.constructor === URLSearchParams) {
+      headers = { [HTTP2_HEADER_CONTENT_TYPE]: APPLICATION_FORM_URLENCODED };
+      body = body.toString();
+    } else if (!Buffer.isBuffer(body)
+      && !(!Array.isArray(body) && Reflect.has(body, Symbol.iterator))) {
+      headers = { [HTTP2_HEADER_CONTENT_TYPE]: APPLICATION_JSON };
+      body = JSON.stringify(body);
+    }
+
+    if (types.isUint8Array(body) || Buffer.isBuffer(body) || body !== Object(body)) {
+      if (options.headers[HTTP2_HEADER_CONTENT_ENCODING]) {
+        body = compress(body, options.headers[HTTP2_HEADER_CONTENT_ENCODING]);
+      }
+
+      headers = {
+        ...headers,
+        [HTTP2_HEADER_CONTENT_LENGTH]: Buffer.byteLength(body),
+      };
+    }
+  }
+
+  Object.assign(options.headers, {
+    ...headers,
+    ...options.headers[HTTP2_HEADER_CONTENT_TYPE] && {
+      [HTTP2_HEADER_CONTENT_TYPE]: options.headers[HTTP2_HEADER_CONTENT_TYPE],
+    },
+  });
+
+  return body;
+};

package/src/index.mjs

@@ -9,6 +9,7 @@ import {
   merge,
   preflight,
   premix,
+  redirects,
   transform,
 } from './helpers.mjs';
 import { APPLICATION_OCTET_STREAM } from './mediatypes.mjs';
@@ -44,7 +45,7 @@ export default async function rekwest(url, options = {}) {
     HTTP2_METHOD_GET,
     HTTP2_METHOD_HEAD,
   ].includes(options.method)) {
-    throw new TypeError(`Request with ${ HTTP2_METHOD_GET }/${ HTTP2_METHOD_HEAD } method cannot have body`);
+    throw new TypeError(`Request with ${ HTTP2_METHOD_GET }/${ HTTP2_METHOD_HEAD } method cannot have body.`);
   }
 
   if (!options.follow) {
@@ -122,16 +123,16 @@ export default async function rekwest(url, options = {}) {
       });
 
       if (follow && /^3\d{2}$/.test(res.statusCode) && res.headers[HTTP2_HEADER_LOCATION]) {
-        if (redirect === 'error') {
-          res.emit('error', new RequestError(`Unexpected redirect, redirect mode is set to '${ redirect }'`));
+        if (redirect === redirects.error) {
+          res.emit('error', new RequestError(`Unexpected redirect, redirect mode is set to '${ redirect }'.`));
         }
 
-        if (redirect === 'follow') {
+        if (redirect === redirects.follow) {
           options.url = new URL(res.headers[HTTP2_HEADER_LOCATION], url).href;
 
           if (res.statusCode !== HTTP_STATUS_SEE_OTHER
             && body === Object(body) && body.pipe?.constructor === Function) {
-            res.emit('error', new RequestError(`Unable to ${ redirect } redirect with body as readable stream`));
+            res.emit('error', new RequestError(`Unable to ${ redirect } redirect with body as readable stream.`));
           }
 
           options.follow--;
@@ -211,6 +212,7 @@ Reflect.defineProperty(rekwest, 'stream', {
       ...merge(rekwest.defaults, {
         headers: { [HTTP2_HEADER_CONTENT_TYPE]: APPLICATION_OCTET_STREAM },
       }, options),
+      redirect: redirects.manual,
     });
 
     if (options.h2) {