undici 6.19.8 → 7.0.0-alpha.1

package/types/errors.d.ts

@@ -1,24 +1,24 @@
-import { IncomingHttpHeaders } from "./header";
+import { IncomingHttpHeaders } from './header'
 import Client from './client'
 
 export default Errors
 
 declare namespace Errors {
   export class UndiciError extends Error {
-    name: string;
-    code: string;
+    name: string
+    code: string
   }
 
   /** Connect timeout error. */
   export class ConnectTimeoutError extends UndiciError {
-    name: 'ConnectTimeoutError';
-    code: 'UND_ERR_CONNECT_TIMEOUT';
+    name: 'ConnectTimeoutError'
+    code: 'UND_ERR_CONNECT_TIMEOUT'
   }
 
   /** A header exceeds the `headersTimeout` option. */
   export class HeadersTimeoutError extends UndiciError {
-    name: 'HeadersTimeoutError';
-    code: 'UND_ERR_HEADERS_TIMEOUT';
+    name: 'HeadersTimeoutError'
+    code: 'UND_ERR_HEADERS_TIMEOUT'
   }
 
   /** Headers overflow error. */
@@ -29,8 +29,8 @@ declare namespace Errors {
 
   /** A body exceeds the `bodyTimeout` option. */
   export class BodyTimeoutError extends UndiciError {
-    name: 'BodyTimeoutError';
-    code: 'UND_ERR_BODY_TIMEOUT';
+    name: 'BodyTimeoutError'
+    code: 'UND_ERR_BODY_TIMEOUT'
   }
 
   export class ResponseStatusCodeError extends UndiciError {
@@ -39,91 +39,91 @@ declare namespace Errors {
       statusCode?: number,
       headers?: IncomingHttpHeaders | string[] | null,
       body?: null | Record<string, any> | string
-    );
-    name: 'ResponseStatusCodeError';
-    code: 'UND_ERR_RESPONSE_STATUS_CODE';
+    )
+    name: 'ResponseStatusCodeError'
+    code: 'UND_ERR_RESPONSE_STATUS_CODE'
     body: null | Record<string, any> | string
     status: number
     statusCode: number
-    headers: IncomingHttpHeaders | string[] | null;
+    headers: IncomingHttpHeaders | string[] | null
   }
 
   /** Passed an invalid argument. */
   export class InvalidArgumentError extends UndiciError {
-    name: 'InvalidArgumentError';
-    code: 'UND_ERR_INVALID_ARG';
+    name: 'InvalidArgumentError'
+    code: 'UND_ERR_INVALID_ARG'
   }
 
   /** Returned an invalid value. */
   export class InvalidReturnValueError extends UndiciError {
-    name: 'InvalidReturnValueError';
-    code: 'UND_ERR_INVALID_RETURN_VALUE';
+    name: 'InvalidReturnValueError'
+    code: 'UND_ERR_INVALID_RETURN_VALUE'
   }
 
   /** The request has been aborted by the user. */
   export class RequestAbortedError extends UndiciError {
-    name: 'AbortError';
-    code: 'UND_ERR_ABORTED';
+    name: 'AbortError'
+    code: 'UND_ERR_ABORTED'
   }
 
   /** Expected error with reason. */
   export class InformationalError extends UndiciError {
-    name: 'InformationalError';
-    code: 'UND_ERR_INFO';
+    name: 'InformationalError'
+    code: 'UND_ERR_INFO'
   }
 
   /** Request body length does not match content-length header. */
   export class RequestContentLengthMismatchError extends UndiciError {
-    name: 'RequestContentLengthMismatchError';
-    code: 'UND_ERR_REQ_CONTENT_LENGTH_MISMATCH';
+    name: 'RequestContentLengthMismatchError'
+    code: 'UND_ERR_REQ_CONTENT_LENGTH_MISMATCH'
   }
 
   /** Response body length does not match content-length header. */
   export class ResponseContentLengthMismatchError extends UndiciError {
-    name: 'ResponseContentLengthMismatchError';
-    code: 'UND_ERR_RES_CONTENT_LENGTH_MISMATCH';
+    name: 'ResponseContentLengthMismatchError'
+    code: 'UND_ERR_RES_CONTENT_LENGTH_MISMATCH'
   }
 
   /** Trying to use a destroyed client. */
   export class ClientDestroyedError extends UndiciError {
-    name: 'ClientDestroyedError';
-    code: 'UND_ERR_DESTROYED';
+    name: 'ClientDestroyedError'
+    code: 'UND_ERR_DESTROYED'
   }
 
   /** Trying to use a closed client. */
   export class ClientClosedError extends UndiciError {
-    name: 'ClientClosedError';
-    code: 'UND_ERR_CLOSED';
+    name: 'ClientClosedError'
+    code: 'UND_ERR_CLOSED'
   }
 
   /** There is an error with the socket. */
   export class SocketError extends UndiciError {
-    name: 'SocketError';
-    code: 'UND_ERR_SOCKET';
+    name: 'SocketError'
+    code: 'UND_ERR_SOCKET'
     socket: Client.SocketInfo | null
   }
 
   /** Encountered unsupported functionality. */
   export class NotSupportedError extends UndiciError {
-    name: 'NotSupportedError';
-    code: 'UND_ERR_NOT_SUPPORTED';
+    name: 'NotSupportedError'
+    code: 'UND_ERR_NOT_SUPPORTED'
   }
 
   /** No upstream has been added to the BalancedPool. */
   export class BalancedPoolMissingUpstreamError extends UndiciError {
-    name: 'MissingUpstreamError';
-    code: 'UND_ERR_BPL_MISSING_UPSTREAM';
+    name: 'MissingUpstreamError'
+    code: 'UND_ERR_BPL_MISSING_UPSTREAM'
   }
 
   export class HTTPParserError extends UndiciError {
-    name: 'HTTPParserError';
-    code: string;
+    name: 'HTTPParserError'
+    code: string
   }
 
   /** The response exceed the length allowed. */
   export class ResponseExceededMaxSizeError extends UndiciError {
-    name: 'ResponseExceededMaxSizeError';
-    code: 'UND_ERR_RES_EXCEEDED_MAX_SIZE';
+    name: 'ResponseExceededMaxSizeError'
+    code: 'UND_ERR_RES_EXCEEDED_MAX_SIZE'
   }
 
   export class RequestRetryError extends UndiciError {
@@ -132,18 +132,24 @@ declare namespace Errors {
       statusCode: number,
       headers?: IncomingHttpHeaders | string[] | null,
       body?: null | Record<string, any> | string
-    );
-    name: 'RequestRetryError';
-    code: 'UND_ERR_REQ_RETRY';
-    statusCode: number;
+    )
+    name: 'RequestRetryError'
+    code: 'UND_ERR_REQ_RETRY'
+    statusCode: number
     data: {
       count: number;
-    };
-    headers: Record<string, string | string[]>;
+    }
+
+    headers: Record<string, string | string[]>
   }
 
   export class SecureProxyConnectionError extends UndiciError {
-    name: 'SecureProxyConnectionError';
-    code: 'UND_ERR_PRX_TLS';
+    constructor (
+      cause?: Error,
+      message?: string,
+      options?: Record<any, any>
+    )
+    name: 'SecureProxyConnectionError'
+    code: 'UND_ERR_PRX_TLS'
   }
 }

package/types/eventsource.d.ts

@@ -2,8 +2,6 @@ import { MessageEvent, ErrorEvent } from './websocket'
 import Dispatcher from './dispatcher'
 
 import {
-  EventTarget,
-  Event,
   EventListenerOptions,
   AddEventListenerOptions,
   EventListenerOrEventListenerObject

package/types/fetch.d.ts

@@ -6,7 +6,7 @@ import { Blob } from 'buffer'
 import { URL, URLSearchParams } from 'url'
 import { ReadableStream } from 'stream/web'
 import { FormData } from './formdata'
-
+import { HeaderRecord } from './header'
 import Dispatcher from './dispatcher'
 
 export type RequestInfo = string | URL | Request
@@ -36,17 +36,17 @@ export class BodyMixin {
   /**
    * @deprecated This method is not recommended for parsing multipart/form-data bodies in server environments.
    * It is recommended to use a library such as [@fastify/busboy](https://www.npmjs.com/package/@fastify/busboy) as follows:
-   * 
+   *
    * @example
    * ```js
    * import { Busboy } from '@fastify/busboy'
    * import { Readable } from 'node:stream'
-   * 
+   *
    * const response = await fetch('...')
    * const busboy = new Busboy({ headers: { 'content-type': response.headers.get('content-type') } })
-   * 
+   *
    * // handle events emitted from `busboy`
-   * 
+   *
    * Readable.fromWeb(response.body).pipe(busboy)
    * ```
    */
@@ -67,7 +67,7 @@ export interface SpecIterable<T> {
   [Symbol.iterator](): SpecIterator<T>;
 }
 
-export type HeadersInit = string[][] | Record<string, string | ReadonlyArray<string>> | Headers
+export type HeadersInit = [string, string][] | HeaderRecord | Headers
 
 export declare class Headers implements SpecIterable<[string, string]> {
   constructor (init?: HeadersInit)
@@ -144,7 +144,7 @@ export type ReferrerPolicy =
   | 'same-origin'
   | 'strict-origin'
   | 'strict-origin-when-cross-origin'
-  | 'unsafe-url';
+  | 'unsafe-url'
 
 export type RequestMode = 'cors' | 'navigate' | 'no-cors' | 'same-origin'
 
@@ -204,6 +204,6 @@ export declare class Response extends BodyMixin {
   readonly clone: () => Response
 
   static error (): Response
-  static json(data: any, init?: ResponseInit): Response
+  static json (data: any, init?: ResponseInit): Response
   static redirect (url: string | URL, status: ResponseRedirectStatus): Response
 }

package/types/formdata.d.ts

@@ -1,7 +1,7 @@
 // Based on https://github.com/octet-stream/form-data/blob/2d0f0dc371517444ce1f22cdde13f51995d0953a/lib/FormData.ts (MIT)
 /// <reference types="node" />
 
-import { File } from './file'
+import { File } from 'buffer'
 import { SpecIterableIterator } from './fetch'
 
 /**
@@ -24,7 +24,7 @@ export declare class FormData {
     or [`File`](https://developer.mozilla.org/en-US/docs/Web/API/File). If none of these are specified the value is converted to a string.
    * @param fileName The filename reported to the server, when a Blob or File is passed as the second parameter. The default filename for Blob objects is "blob". The default filename for File objects is the file's filename.
    */
-  append(name: string, value: unknown, fileName?: string): void
+  append (name: string, value: unknown, fileName?: string): void
 
   /**
    * Set a new value for an existing key inside FormData,
@@ -36,7 +36,7 @@ export declare class FormData {
    * @param fileName The filename reported to the server, when a Blob or File is passed as the second parameter. The default filename for Blob objects is "blob". The default filename for File objects is the file's filename.
    *
    */
-  set(name: string, value: unknown, fileName?: string): void
+  set (name: string, value: unknown, fileName?: string): void
 
   /**
    * Returns the first value associated with a given key from within a `FormData` object.
@@ -46,7 +46,7 @@ export declare class FormData {
    *
    * @returns A `FormDataEntryValue` containing the value. If the key doesn't exist, the method returns null.
    */
-  get(name: string): FormDataEntryValue | null
+  get (name: string): FormDataEntryValue | null
 
   /**
    * Returns all the values associated with a given key from within a `FormData` object.
@@ -55,7 +55,7 @@ export declare class FormData {
    *
    * @returns An array of `FormDataEntryValue` whose key matches the value passed in the `name` parameter. If the key doesn't exist, the method returns an empty list.
    */
-  getAll(name: string): FormDataEntryValue[]
+  getAll (name: string): FormDataEntryValue[]
 
   /**
    * Returns a boolean stating whether a `FormData` object contains a certain key.
@@ -64,14 +64,14 @@ export declare class FormData {
    *
    * @return A boolean value.
    */
-  has(name: string): boolean
+  has (name: string): boolean
 
   /**
    * Deletes a key and its value(s) from a `FormData` object.
    *
    * @param name The name of the key you want to delete.
    */
-  delete(name: string): void
+  delete (name: string): void
 
   /**
    * Executes given callback function for each field of the FormData instance

package/types/global-dispatcher.d.ts

@@ -1,9 +1,9 @@
-import Dispatcher from "./dispatcher";
+import Dispatcher from './dispatcher'
+
+declare function setGlobalDispatcher<DispatcherImplementation extends Dispatcher> (dispatcher: DispatcherImplementation): void
+declare function getGlobalDispatcher (): Dispatcher
 
 export {
   getGlobalDispatcher,
   setGlobalDispatcher
 }
-
-declare function setGlobalDispatcher<DispatcherImplementation extends Dispatcher>(dispatcher: DispatcherImplementation): void;
-declare function getGlobalDispatcher(): Dispatcher;

package/types/global-origin.d.ts

@@ -1,7 +1,7 @@
+declare function setGlobalOrigin (origin: string | URL | undefined): void
+declare function getGlobalOrigin (): URL | undefined
+
 export {
-	setGlobalOrigin,
-	getGlobalOrigin
+  setGlobalOrigin,
+  getGlobalOrigin
 }
-  
-declare function setGlobalOrigin(origin: string | URL | undefined): void;
-declare function getGlobalOrigin(): URL | undefined;

package/types/handlers.d.ts

@@ -1,15 +1,15 @@
-import Dispatcher from "./dispatcher";
+import Dispatcher from './dispatcher'
 
 export declare class RedirectHandler implements Dispatcher.DispatchHandlers {
-  constructor(
+  constructor (
     dispatch: Dispatcher,
     maxRedirections: number,
     opts: Dispatcher.DispatchOptions,
     handler: Dispatcher.DispatchHandlers,
     redirectionLimitReached: boolean
-  );
+  )
 }
 
 export declare class DecoratorHandler implements Dispatcher.DispatchHandlers {
-  constructor(handler: Dispatcher.DispatchHandlers);
+  constructor (handler: Dispatcher.DispatchHandlers)
 }

package/types/header.d.ts

@@ -1,4 +1,160 @@
+import { Autocomplete } from './utility'
+
 /**
  * The header type declaration of `undici`.
  */
-export type IncomingHttpHeaders = Record<string, string | string[] | undefined>;
+export type IncomingHttpHeaders = Record<string, string | string[] | undefined>
+
+type HeaderNames = Autocomplete<
+  | 'Accept'
+  | 'Accept-CH'
+  | 'Accept-Charset'
+  | 'Accept-Encoding'
+  | 'Accept-Language'
+  | 'Accept-Patch'
+  | 'Accept-Post'
+  | 'Accept-Ranges'
+  | 'Access-Control-Allow-Credentials'
+  | 'Access-Control-Allow-Headers'
+  | 'Access-Control-Allow-Methods'
+  | 'Access-Control-Allow-Origin'
+  | 'Access-Control-Expose-Headers'
+  | 'Access-Control-Max-Age'
+  | 'Access-Control-Request-Headers'
+  | 'Access-Control-Request-Method'
+  | 'Age'
+  | 'Allow'
+  | 'Alt-Svc'
+  | 'Alt-Used'
+  | 'Authorization'
+  | 'Cache-Control'
+  | 'Clear-Site-Data'
+  | 'Connection'
+  | 'Content-Disposition'
+  | 'Content-Encoding'
+  | 'Content-Language'
+  | 'Content-Length'
+  | 'Content-Location'
+  | 'Content-Range'
+  | 'Content-Security-Policy'
+  | 'Content-Security-Policy-Report-Only'
+  | 'Content-Type'
+  | 'Cookie'
+  | 'Cross-Origin-Embedder-Policy'
+  | 'Cross-Origin-Opener-Policy'
+  | 'Cross-Origin-Resource-Policy'
+  | 'Date'
+  | 'Device-Memory'
+  | 'ETag'
+  | 'Expect'
+  | 'Expect-CT'
+  | 'Expires'
+  | 'Forwarded'
+  | 'From'
+  | 'Host'
+  | 'If-Match'
+  | 'If-Modified-Since'
+  | 'If-None-Match'
+  | 'If-Range'
+  | 'If-Unmodified-Since'
+  | 'Keep-Alive'
+  | 'Last-Modified'
+  | 'Link'
+  | 'Location'
+  | 'Max-Forwards'
+  | 'Origin'
+  | 'Permissions-Policy'
+  | 'Priority'
+  | 'Proxy-Authenticate'
+  | 'Proxy-Authorization'
+  | 'Range'
+  | 'Referer'
+  | 'Referrer-Policy'
+  | 'Retry-After'
+  | 'Sec-Fetch-Dest'
+  | 'Sec-Fetch-Mode'
+  | 'Sec-Fetch-Site'
+  | 'Sec-Fetch-User'
+  | 'Sec-Purpose'
+  | 'Sec-WebSocket-Accept'
+  | 'Server'
+  | 'Server-Timing'
+  | 'Service-Worker-Navigation-Preload'
+  | 'Set-Cookie'
+  | 'SourceMap'
+  | 'Strict-Transport-Security'
+  | 'TE'
+  | 'Timing-Allow-Origin'
+  | 'Trailer'
+  | 'Transfer-Encoding'
+  | 'Upgrade'
+  | 'Upgrade-Insecure-Requests'
+  | 'User-Agent'
+  | 'Vary'
+  | 'Via'
+  | 'WWW-Authenticate'
+  | 'X-Content-Type-Options'
+  | 'X-Frame-Options'
+>
+
+type IANARegisteredMimeType = Autocomplete<
+  | 'audio/aac'
+  | 'video/x-msvideo'
+  | 'image/avif'
+  | 'video/av1'
+  | 'application/octet-stream'
+  | 'image/bmp'
+  | 'text/css'
+  | 'text/csv'
+  | 'application/vnd.ms-fontobject'
+  | 'application/epub+zip'
+  | 'image/gif'
+  | 'application/gzip'
+  | 'text/html'
+  | 'image/x-icon'
+  | 'text/calendar'
+  | 'image/jpeg'
+  | 'text/javascript'
+  | 'application/json'
+  | 'application/ld+json'
+  | 'audio/x-midi'
+  | 'audio/mpeg'
+  | 'video/mp4'
+  | 'video/mpeg'
+  | 'audio/ogg'
+  | 'video/ogg'
+  | 'application/ogg'
+  | 'audio/opus'
+  | 'font/otf'
+  | 'application/pdf'
+  | 'image/png'
+  | 'application/rtf'
+  | 'image/svg+xml'
+  | 'image/tiff'
+  | 'video/mp2t'
+  | 'font/ttf'
+  | 'text/plain'
+  | 'application/wasm'
+  | 'video/webm'
+  | 'audio/webm'
+  | 'image/webp'
+  | 'font/woff'
+  | 'font/woff2'
+  | 'application/xhtml+xml'
+  | 'application/xml'
+  | 'application/zip'
+  | 'video/3gpp'
+  | 'video/3gpp2'
+  | 'model/gltf+json'
+  | 'model/gltf-binary'
+>
+
+type KnownHeaderValues = {
+  'content-type': IANARegisteredMimeType
+}
+
+export type HeaderRecord = {
+  [K in HeaderNames | Lowercase<HeaderNames>]?: Lowercase<K> extends keyof KnownHeaderValues
+    ? KnownHeaderValues[Lowercase<K>]
+    : string
+}

package/types/index.d.ts

@@ -1,22 +1,22 @@
-import Dispatcher from'./dispatcher'
+import Dispatcher from './dispatcher'
 import { setGlobalDispatcher, getGlobalDispatcher } from './global-dispatcher'
 import { setGlobalOrigin, getGlobalOrigin } from './global-origin'
-import Pool from'./pool'
+import Pool from './pool'
 import { RedirectHandler, DecoratorHandler } from './handlers'
 
 import BalancedPool from './balanced-pool'
-import Client from'./client'
-import buildConnector from'./connector'
-import errors from'./errors'
-import Agent from'./agent'
-import MockClient from'./mock-client'
-import MockPool from'./mock-pool'
-import MockAgent from'./mock-agent'
-import mockErrors from'./mock-errors'
-import ProxyAgent from'./proxy-agent'
+import Client from './client'
+import buildConnector from './connector'
+import errors from './errors'
+import Agent from './agent'
+import MockClient from './mock-client'
+import MockPool from './mock-pool'
+import MockAgent from './mock-agent'
+import mockErrors from './mock-errors'
+import ProxyAgent from './proxy-agent'
 import EnvHttpProxyAgent from './env-http-proxy-agent'
-import RetryHandler from'./retry-handler'
-import RetryAgent from'./retry-agent'
+import RetryHandler from './retry-handler'
+import RetryAgent from './retry-agent'
 import { request, pipeline, stream, connect, upgrade } from './api'
 import interceptors from './interceptors'
 
@@ -24,8 +24,6 @@ export * from './util'
 export * from './cookies'
 export * from './eventsource'
 export * from './fetch'
-export * from './file'
-export * from './filereader'
 export * from './formdata'
 export * from './diagnostics-channel'
 export * from './websocket'
@@ -37,35 +35,33 @@ export { Dispatcher, BalancedPool, Pool, Client, buildConnector, errors, Agent,
 export default Undici
 
 declare namespace Undici {
-  var Dispatcher: typeof import('./dispatcher').default
-  var Pool: typeof import('./pool').default;
-  var RedirectHandler: typeof import ('./handlers').RedirectHandler
-  var DecoratorHandler: typeof import ('./handlers').DecoratorHandler
-  var RetryHandler: typeof import ('./retry-handler').default
-  var createRedirectInterceptor: typeof import ('./interceptors').default.createRedirectInterceptor
-  var BalancedPool: typeof import('./balanced-pool').default;
-  var Client: typeof import('./client').default;
-  var buildConnector: typeof import('./connector').default;
-  var errors: typeof import('./errors').default;
-  var Agent: typeof import('./agent').default;
-  var setGlobalDispatcher: typeof import('./global-dispatcher').setGlobalDispatcher;
-  var getGlobalDispatcher: typeof import('./global-dispatcher').getGlobalDispatcher;
-  var request: typeof import('./api').request;
-  var stream: typeof import('./api').stream;
-  var pipeline: typeof import('./api').pipeline;
-  var connect: typeof import('./api').connect;
-  var upgrade: typeof import('./api').upgrade;
-  var MockClient: typeof import('./mock-client').default;
-  var MockPool: typeof import('./mock-pool').default;
-  var MockAgent: typeof import('./mock-agent').default;
-  var mockErrors: typeof import('./mock-errors').default;
-  var fetch: typeof import('./fetch').fetch;
-  var Headers: typeof import('./fetch').Headers;
-  var Response: typeof import('./fetch').Response;
-  var Request: typeof import('./fetch').Request;
-  var FormData: typeof import('./formdata').FormData;
-  var File: typeof import('./file').File;
-  var FileReader: typeof import('./filereader').FileReader;
-  var caches: typeof import('./cache').caches;
-  var interceptors: typeof import('./interceptors').default;
+  const Dispatcher: typeof import('./dispatcher').default
+  const Pool: typeof import('./pool').default
+  const RedirectHandler: typeof import ('./handlers').RedirectHandler
+  const DecoratorHandler: typeof import ('./handlers').DecoratorHandler
+  const RetryHandler: typeof import ('./retry-handler').default
+  const createRedirectInterceptor: typeof import ('./interceptors').default.createRedirectInterceptor
+  const BalancedPool: typeof import('./balanced-pool').default
+  const Client: typeof import('./client').default
+  const buildConnector: typeof import('./connector').default
+  const errors: typeof import('./errors').default
+  const Agent: typeof import('./agent').default
+  const setGlobalDispatcher: typeof import('./global-dispatcher').setGlobalDispatcher
+  const getGlobalDispatcher: typeof import('./global-dispatcher').getGlobalDispatcher
+  const request: typeof import('./api').request
+  const stream: typeof import('./api').stream
+  const pipeline: typeof import('./api').pipeline
+  const connect: typeof import('./api').connect
+  const upgrade: typeof import('./api').upgrade
+  const MockClient: typeof import('./mock-client').default
+  const MockPool: typeof import('./mock-pool').default
+  const MockAgent: typeof import('./mock-agent').default
+  const mockErrors: typeof import('./mock-errors').default
+  const fetch: typeof import('./fetch').fetch
+  const Headers: typeof import('./fetch').Headers
+  const Response: typeof import('./fetch').Response
+  const Request: typeof import('./fetch').Request
+  const FormData: typeof import('./formdata').FormData
+  const caches: typeof import('./cache').caches
+  const interceptors: typeof import('./interceptors').default
 }

package/types/interceptors.d.ts

@@ -1,15 +1,17 @@
-import Dispatcher from "./dispatcher";
-import RetryHandler from "./retry-handler";
+import Dispatcher from './dispatcher'
+import RetryHandler from './retry-handler'
 
-export default Interceptors;
+export default Interceptors
 
 declare namespace Interceptors {
   export type DumpInterceptorOpts = { maxSize?: number }
   export type RetryInterceptorOpts = RetryHandler.RetryOptions
   export type RedirectInterceptorOpts = { maxRedirections?: number }
-  
-  export function createRedirectInterceptor(opts: RedirectInterceptorOpts): Dispatcher.DispatcherComposeInterceptor
-  export function dump(opts?: DumpInterceptorOpts): Dispatcher.DispatcherComposeInterceptor
-  export function retry(opts?: RetryInterceptorOpts): Dispatcher.DispatcherComposeInterceptor
-  export function redirect(opts?: RedirectInterceptorOpts): Dispatcher.DispatcherComposeInterceptor
+  export type ResponseErrorInterceptorOpts = { throwOnError: boolean }
+
+  export function createRedirectInterceptor (opts: RedirectInterceptorOpts): Dispatcher.DispatcherComposeInterceptor
+  export function dump (opts?: DumpInterceptorOpts): Dispatcher.DispatcherComposeInterceptor
+  export function retry (opts?: RetryInterceptorOpts): Dispatcher.DispatcherComposeInterceptor
+  export function redirect (opts?: RedirectInterceptorOpts): Dispatcher.DispatcherComposeInterceptor
+  export function responseError (opts?: ResponseErrorInterceptorOpts): Dispatcher.DispatcherComposeInterceptor
 }