@superutils/fetch 1.2.3 → 1.4.1

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as _superutils_promise from '@superutils/promise';
-import { RetryOptions, RetryIfFunc, DeferredAsyncOptions, IPromisE } from '@superutils/promise';
+import { RetryOptions, RetryIfFunc, TimeoutOptions, DeferredAsyncOptions, IPromisE_Timeout } from '@superutils/promise';
 export { DeferredAsyncOptions, ResolveError, ResolveIgnored } from '@superutils/promise';
 import { ValueOrPromise } from '@superutils/core';
 
@@ -19,16 +19,6 @@ declare const ContentType: {
     readonly TEXT_PLAIN: "text/plain";
     readonly VIDEO_MP4: "video/mp4";
 };
-type ExcludeOptions<Target, // options to exclude
-Options extends FetchOptions = FetchOptions> = Target extends FetchOptions ? {
-    headers?: Options['headers'];
-} & Omit<Options, 'headers' | keyof Target> & Partial<Record<Exclude<keyof Target, 'headers'>, never>> : Options;
-type ExcludePostOptions<Target> = ExcludeOptions<Target, PostOptions>;
-type FetchArgs = [url: string | URL, options?: FetchOptions];
-type FetchArgsInterceptor = [
-    url: string | URL,
-    options: FetchOptionsInterceptor
-];
 declare enum FetchAs {
     arrayBuffer = "arrayBuffer",
     blob = "blob",
@@ -38,53 +28,18 @@ declare enum FetchAs {
     response = "response",
     text = "text"
 }
-/** Extract `FetchAs` from `FetchOptions` */
-type FetchAsFromOptions<TOptions, TFallback = FetchAs.json> = TOptions extends {
-    as: infer As;
-} ? As extends FetchAs ? As : TFallback : TFallback;
-/** Custom fetch options (not used by built-in `fetch()`*/
-type FetchCustomOptions = {
-    /**
-     * Specify how the parse the result. To get raw response use {@link FetchAs.response}.
-     * Default: 'json'
-     */
-    as?: FetchAs;
-    abortCtrl?: AbortController;
-    body?: PostBody | (() => PostBody);
-    errMsgs?: FetchErrMsgs;
-    interceptors?: FetchInterceptors;
-    /** Request timeout in milliseconds. */
-    timeout?: number;
-    validateUrl?: boolean;
-} & FetchRetryOptions;
-/** Default args */
-type FetchDeferredArgs<OmitMethod extends boolean = false> = [
-    url?: string | URL,
-    options?: Omit<FetchOptions, 'abortCtrl' | (OmitMethod extends true ? 'method' : never)>
-];
-type FetchErrMsgs = {
-    invalidUrl?: string;
-    parseFailed?: string;
-    reqTimedout?: string;
-    requestFailed?: string;
-};
-/** Custom error message for fetch requests with more detailed info about the request URL, fetch options and response */
-declare class FetchError extends Error {
-    options: FetchOptions;
-    response?: Response;
-    url: string | URL;
-    constructor(message: string, options: {
-        cause?: unknown;
-        options: FetchOptions;
-        response?: Response;
-        url: string | URL;
-    });
-    clone: (newMessage: string) => FetchError;
-}
+
+/**
+ * Generic definition for interceptor and transformer callbacks used throughout the fetch lifecycle.
+ */
+type Interceptor<T, TArgs extends unknown[]> = (...args: [value: T, ...TArgs]) => ValueOrPromise<void> | ValueOrPromise<T>;
 /**
  * Fetch error interceptor to be invoked whenever an exception occurs.
  * This interceptor can also be used as the error transformer by returning {@link FetchError}.
  *
+ * Note: The error interceptor is only triggered if the request ultimately fails. If retries are enabled (`retry > 0`)
+ * and a subsequent attempt succeeds, this interceptor will not be invoked for the intermediate failures.
+ *
  * @param	{FetchError}	fetchError custom error that also contain URL, options & response
  *
  * @returns returning undefined or not returning anything will not override the error
@@ -217,10 +172,10 @@ type FetchInterceptorResult<Args extends unknown[] = FetchArgsInterceptor> = Int
 /**
  * All valid interceptors for fetch requests are:
  * ---
- * 1. error,
+ * 1. error
  * 2. request
  * 3. response
- * 4. result.
+ * 4. result
  *
  * An interceptor can be any of the following:
  * ---
@@ -239,10 +194,9 @@ type FetchInterceptorResult<Args extends unknown[] = FetchArgsInterceptor> = Int
  * 1. Any exception thrown by interceptors will gracefully ignored.
  * 2. Interceptors will be executed in the sequence they're given.
  * 3. Execution priority: global interceptors will always be executed before local interceptors.
+ * 4. The following options cannot be modified using interceptors: abortCtrl, as, signal, timeout
  *
- *
- *
- * More info & examples:
+ * More info about specific interceptor types & examples:
  * ---
  * See the following for more details and examples:
  *
@@ -252,24 +206,107 @@ type FetchInterceptorResult<Args extends unknown[] = FetchArgsInterceptor> = Int
  * - `result`: {@link FetchInterceptorResult}
  */
 type FetchInterceptors = {
+    /** Request error interceptors/transformers. See {@link FetchInterceptorError} for more details. */
     error?: FetchInterceptorError[];
+    /** Request request interceptors/transformers. See {@link FetchInterceptorRequest} for more details. */
     request?: FetchInterceptorRequest[];
+    /** Request response interceptors/transformers. See {@link FetchInterceptorResponse} for more details. */
     response?: FetchInterceptorResponse[];
+    /** Request result interceptors/transformers. See {@link FetchInterceptorResult} for more details. */
     result?: FetchInterceptorResult[];
 };
+
+type ExcludeOptions<Target, // options to exclude
+Options extends FetchOptions = FetchOptions> = Target extends FetchOptions ? {
+    headers?: Options['headers'];
+} & Omit<Options, 'headers' | keyof Target> & Partial<Record<Exclude<keyof Target, 'headers'>, never>> : Options;
+type ExcludePostOptions<Target> = ExcludeOptions<Target, PostOptions>;
+type FetchArgs = [url: string | URL, options?: FetchOptions];
+type FetchArgsInterceptor = [
+    url: string | URL,
+    options: FetchOptionsInterceptor
+];
+/** Extract `FetchAs` from `FetchOptions` */
+type FetchAsFromOptions<TOptions, TFallback = FetchAs.json> = TOptions extends {
+    as: infer As;
+} ? As extends FetchAs ? As : TFallback : TFallback;
+/** Custom fetch options (not used by built-in `fetch()`*/
+type FetchCustomOptions = {
+    /**
+     * Specify how the parse the result. To get raw response use {@link FetchAs.response}.
+     * Default: 'json'
+     */
+    as?: FetchAs;
+    /**
+     * An `AbortController` instance to control the request.
+     *
+     * If not provided, a new instance is automatically created internally.
+     *
+     * It is supported in addition to the standard `signal`. If both are provided, `abortCtrl` will be aborted
+     * when the `signal` aborts or when the request times out.
+     *
+     * Recommendation:
+     * - For request timeout purposes, setting a timeout duration will be sufficient.
+     * Abort controller/signal is not needed.
+     * - Use `abortCtrl` instead of `signal` to prevent creating internal `AbortController` instance.
+     */
+    abortCtrl?: AbortController;
+    body?: PostBody | (() => PostBody);
+    /**
+     * Custom fetch function to use instead of the global `fetch`.
+     * Useful for testing or using a different fetch implementation (e.g. `node-fetch` in older Node versions).
+     *
+     * Default: `globalThis.fetch`
+     */
+    fetchFunc?: FetchFunc;
+    errMsgs?: FetchErrMsgs;
+    /**
+     * Interceptor/transformer callback executed at different stages of the request.
+     * See {@link FetchInterceptors} for more details.
+     */
+    interceptors?: FetchInterceptors;
+    /** Whether to validate URL before making the request. Default: `true` */
+    validateUrl?: boolean;
+} & FetchRetryOptions & TimeoutOptions<[]>;
+/** Default args */
+type FetchDeferredArgs<OmitMethod extends boolean = false> = [
+    url?: string | URL,
+    options?: Omit<FetchOptions, 'abortCtrl' | (OmitMethod extends true ? 'method' : never)>
+];
+type FetchErrMsgs = {
+    /** Error message to be used when request is aborted without specifying a message */
+    aborted?: string;
+    /** Error message to be use when URL validation fails */
+    invalidUrl?: string;
+    /** Error message to be used when request parse failes */
+    parseFailed?: string;
+    /** Error message to be used when request times out */
+    timedout?: string;
+    /** Error message to be used when request fails */
+    requestFailed?: string;
+};
+type FetchFunc = (...args: FetchArgs) => Promise<Response>;
 /**
  * Fetch request options
  */
 type FetchOptions = Omit<RequestInit, 'body'> & FetchCustomOptions;
-type FetchOptionsDefaults = Omit<FetchOptionsInterceptor, 'as' | 'method'>;
+/** Default fetch options */
+type FetchOptionsDefault = Omit<FetchOptionsInterceptor, 'abortCtrl' | 'as' | 'method' | 'signal' | 'timeout'> & {
+    /** Request timeout duration in milliseconds. Default: `30_000` (30 seconds) */
+    timeout: number;
+};
 /**
- * Fetch options available to interceptors
+ * Fetch options available to interceptors.
+ *
  */
-type FetchOptionsInterceptor = Omit<FetchOptions, 'as' | 'errMsgs' | 'interceptors' | 'headers' | keyof FetchRetryOptions> & {
+type FetchOptionsInterceptor = Omit<FetchOptions, 'as' | 'errMsgs' | 'interceptors' | 'headers' | 'timeout' | keyof FetchRetryOptions> & {
     as: FetchAs;
+    /** Error messages */
     errMsgs: Required<FetchErrMsgs>;
     headers: Headers;
+    /** Interceptors/transformers for fetch requests. See {@link FetchInterceptors} for more details. */
     interceptors: Required<FetchInterceptors>;
+    timeout: number;
 } & FetchRetryOptions;
 /**
  * Result types for specific parsers ("as": FetchAs)
@@ -297,10 +334,6 @@ type FetchRetryOptions = Omit<Partial<RetryOptions>, 'retry' | 'retryIf'> & {
     retry?: number;
     retryIf?: RetryIfFunc<Response>;
 };
-/**
- * Generic fetch interceptor type
- */
-type Interceptor<T, TArgs extends unknown[]> = (...args: [value: T, ...TArgs]) => ValueOrPromise<void> | ValueOrPromise<T>;
 type PostBody = Record<string, unknown> | BodyInit | null;
 type PostArgs<OmitMethod = false> = [
     url: string | URL,
@@ -356,6 +389,21 @@ type PostOptions = {
     method?: 'post' | 'put' | 'patch' | 'delete' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
 } & Omit<FetchOptions, 'method'>;
 
+/** Custom error message for fetch requests with more detailed info about the request URL, fetch options and response */
+declare class FetchError extends Error {
+    /** Create a new `FetchError` with a new `message` while preserving all metadata */
+    clone: (newMessage: string) => FetchError;
+    options: FetchOptions;
+    response: Response | undefined;
+    url: string | URL;
+    constructor(message: string, options: {
+        cause?: unknown;
+        options: FetchOptions;
+        response?: Response;
+        url: string | URL;
+    });
+}
+
 /**
  * Create a reusable fetch client with shared options. The returned function comes attached with a
  * `.deferred()` function for debounce and throttle behavior.
@@ -412,13 +460,17 @@ type PostOptions = {
  * 	.then(console.log, console.warn)
  * ```
  */
-declare const createClient: <FixedOpts extends FetchOptions | undefined, CommonOpts extends ExcludeOptions<FixedOpts> | undefined, FixedAs extends FetchAs | undefined = FetchAsFromOptions<FixedOpts, undefined>>(
+declare const createClient: <FixedOpts extends FetchOptions | undefined, CommonOpts extends ExcludeOptions<FixedOpts> | undefined, FixedAs extends FetchAs | undefined = FetchAsFromOptions<FixedOpts, undefined>, CommonDelay extends number = number>(
 /** Mandatory fetch options that cannot be overriden by individual request */
 fixedOptions?: FixedOpts, 
 /** Common fetch options that can be overriden by individual request */
-commonOptions?: FetchOptions & CommonOpts, commonDeferOptions?: DeferredAsyncOptions<unknown, unknown>) => {
-    <T, TOptions extends ExcludeOptions<FixedOpts> | undefined = ExcludeOptions<FixedOpts> | undefined, TAs extends FetchAs = FixedAs extends FetchAs ? FixedAs : FetchAsFromOptions<TOptions, FetchAsFromOptions<CommonOpts>>, TReturn = FetchResult<T>[TAs]>(url: FetchArgs[0], options?: TOptions): IPromisE<TReturn>;
-    deferred<ThisArg = unknown, Delay extends number = number, DefaultUrl extends FetchArgs[0] | undefined = string | URL | undefined, DefaultOptions extends ExcludeOptions<FixedOpts> | undefined = ExcludeOptions<FixedOpts> | undefined>(deferOptions?: DeferredAsyncOptions<ThisArg, Delay>, defaultUrl?: DefaultUrl, defaultOptions?: DefaultOptions): <TResult = unknown, TOptions_1 extends ExcludeOptions<FixedOpts> | undefined = ExcludeOptions<FixedOpts> | undefined, TAs_1 extends FetchAs = FixedAs extends FetchAs ? FixedAs : FetchAsFromOptions<TOptions_1, FetchAsFromOptions<CommonOpts>>, TReturn_1 = FetchResult<TResult>[TAs_1]>(...args: DefaultUrl extends undefined ? [url: FetchArgs[0], options?: TOptions_1] : [options?: TOptions_1]) => IPromisE<TReturn_1>;
+commonOptions?: FetchOptions & CommonOpts, commonDeferOptions?: DeferredAsyncOptions<unknown, CommonDelay>) => {
+    <T = unknown, TOptions extends ExcludeOptions<FixedOpts> | undefined = ExcludeOptions<FixedOpts> | undefined, TAs extends FetchAs = FixedAs extends FetchAs ? FixedAs : FetchAsFromOptions<TOptions, FetchAsFromOptions<CommonOpts>>, TReturn = FetchResult<T>[TAs]>(url: FetchArgs[0], options?: TOptions): Omit<_superutils_promise.IPromisE_Timeout<TReturn>, "abortCtrl"> & {
+        abortCtrl: AbortController;
+    };
+    deferred<ThisArg, Delay extends CommonDelay | number, DefaultUrl extends FetchArgs[0] | undefined = string | URL | undefined, DefaultOptions extends ExcludeOptions<FixedOpts> | undefined = ExcludeOptions<FixedOpts> | undefined>(deferOptions?: DeferredAsyncOptions<ThisArg, Delay>, defaultUrl?: DefaultUrl, defaultOptions?: DefaultOptions): <TResult = unknown, TOptions_1 extends ExcludeOptions<FixedOpts> | undefined = ExcludeOptions<FixedOpts> | undefined, TAs_1 extends FetchAs = FixedAs extends FetchAs ? FixedAs : FetchAsFromOptions<TOptions_1, FetchAsFromOptions<CommonOpts>>, TReturn_1 = FetchResult<TResult>[TAs_1]>(...args: DefaultUrl extends undefined ? [url: FetchArgs[0], options?: TOptions_1] : [options?: TOptions_1]) => Omit<_superutils_promise.IPromisE_Timeout<TReturn_1>, "abortCtrl"> & {
+        abortCtrl: AbortController;
+    };
 };
 
 /**
@@ -455,8 +507,9 @@ commonOptions?: FetchOptions & CommonOpts, commonDeferOptions?: DeferredAsyncOpt
  * const updateProduct = postClient.deferred(
  * 	{
  * 		delayMs: 300, // debounce duration
+ * 		onResult: console.log, // prints only successful results
  * 	},
- * 	'https://dummyjson.com/products/1',
+ * 	'https://dummyjson.com/products/add',
  * 	{
  * 		method: 'patch',
  * 		timeout: 3000,
@@ -466,29 +519,21 @@ commonOptions?: FetchOptions & CommonOpts, commonDeferOptions?: DeferredAsyncOpt
  * updateProduct({ title: 'New title 2' }) // executed
  * ```
  */
-declare const createPostClient: <FixedOpts extends PostOptions | undefined, CommonOpts extends ExcludePostOptions<FixedOpts> | undefined, FixedAs extends FetchAs | undefined = FetchAsFromOptions<FixedOpts, undefined>>(
+declare const createPostClient: <FixedOpts extends PostOptions | undefined, CommonOpts extends ExcludePostOptions<FixedOpts> | undefined, FixedAs extends FetchAs | undefined = FetchAsFromOptions<FixedOpts, undefined>, CommonDelay extends number = number>(
 /** Mandatory fetch options that cannot be overriden by individual request */
 fixedOptions?: FixedOpts, 
 /** Common fetch options that can be overriden by individual request */
-commonOptions?: PostOptions & CommonOpts, commonDeferOptions?: DeferredAsyncOptions<unknown, unknown>) => {
-    <T = unknown, TOptions extends ExcludePostOptions<FixedOpts> | undefined = ExcludePostOptions<FixedOpts> | undefined, TAs extends FetchAs = FixedAs extends FetchAs ? FixedAs : FetchAsFromOptions<TOptions, FetchAsFromOptions<CommonOpts>>, TReturn = FetchResult<T>[TAs]>(url: PostArgs[0], data?: PostArgs[1], options?: TOptions): IPromisE<TReturn>;
-    deferred<ThisArg, Delay extends number, DefaultUrl extends PostArgs[0] | undefined, DefaultData extends PostArgs[1] = undefined, DefaultOptions extends ExcludePostOptions<FixedOpts> | undefined = undefined>(deferOptions?: DeferredAsyncOptions<ThisArg, Delay>, defaultUrl?: DefaultUrl, defaultData?: DefaultData, defaultOptions?: DefaultOptions): <TResult = unknown, TOptions_1 extends ExcludePostOptions<FixedOpts> | undefined = ExcludePostOptions<FixedOpts>, TAs_1 extends FetchAs = FixedAs extends FetchAs ? FixedAs : FetchAsFromOptions<TOptions_1, FetchAsFromOptions<CommonOpts>>, TReturn_1 = FetchResult<TResult>[TAs_1]>(...args: PostDeferredCbArgs<DefaultUrl, DefaultData, TOptions_1>) => IPromisE<TReturn_1>;
+commonOptions?: PostOptions & CommonOpts, commonDeferOptions?: DeferredAsyncOptions<unknown, CommonDelay>) => {
+    <T = unknown, TOptions extends ExcludePostOptions<FixedOpts> | undefined = ExcludePostOptions<FixedOpts> | undefined, TAs extends FetchAs = FixedAs extends FetchAs ? FixedAs : FetchAsFromOptions<TOptions, FetchAsFromOptions<CommonOpts>>, TReturn = FetchResult<T>[TAs]>(url: PostArgs[0], data?: PostArgs[1], options?: TOptions): Omit<_superutils_promise.IPromisE_Timeout<TReturn>, "abortCtrl"> & {
+        abortCtrl: AbortController;
+    };
+    deferred<ThisArg, Delay extends CommonDelay | number, DefaultOptions extends ExcludePostOptions<FixedOpts> | undefined = ExcludePostOptions<FixedOpts> | undefined, DefaultUrl extends PostArgs[0] | undefined = string | URL | undefined, DefaultData extends PostArgs[1] = PostBody | (() => PostBody) | undefined>(deferOptions?: DeferredAsyncOptions<ThisArg, Delay>, defaultUrl?: DefaultUrl, defaultData?: DefaultData, defaultOptions?: DefaultOptions): <TResult = unknown, TOptions_1 extends ExcludePostOptions<FixedOpts> | undefined = ExcludePostOptions<FixedOpts> | undefined, TAs_1 extends FetchAs = FixedAs extends FetchAs ? FixedAs : FetchAsFromOptions<TOptions_1, FetchAsFromOptions<CommonOpts>>, TReturn_1 = FetchResult<TResult>[TAs_1]>(...args: PostDeferredCbArgs<DefaultUrl, DefaultData, TOptions_1>) => Omit<_superutils_promise.IPromisE_Timeout<TReturn_1>, "abortCtrl"> & {
+        abortCtrl: AbortController;
+    };
 };
 
-/**
- * Gracefully executes interceptors and returns the processed value.
- * If the value is not transformed (by returning a new value) by the interceptors,
- * the original value is returned.
- *
- * @param	value value to be passed to the interceptors
- * @param	interceptors interceptor callbacks
- * @param	args (optional) common arguments to be supplied to all the interceptors in addition to
- * the `value' which will always be the first argument.
- *
- * Interceptor arguments: `[value, ...args]`
- */
-declare const executeInterceptors: <T, TArgs extends unknown[]>(value: T, interceptors?: Interceptor<T, TArgs>[], ...args: TArgs) => Promise<T>;
-
+/** Node.js setTimeout limit is 2147483647 (2^31-1). Larger values fire immediately. */
+declare const MAX_TIMEOUT = 2147483647;
 /**
  * Extended `fetch` with timeout, retry, and other options. Automatically parses as JSON by default on success.
  *
@@ -508,9 +553,12 @@ declare const executeInterceptors: <T, TArgs extends unknown[]>(value: T, interc
  * ```
  */
 declare const fetch: {
-    <T, TOptions extends FetchOptions = FetchOptions, TAs extends FetchAs = TOptions["as"] extends FetchAs ? TOptions["as"] : FetchAs.json, TReturn = FetchResult<T>[TAs]>(url: string | URL, options?: FetchOptions & TOptions): IPromisE<TReturn>;
+    <T, TOptions extends FetchOptions = FetchOptions, TAs extends FetchAs = TOptions["as"] extends FetchAs ? TOptions["as"] : FetchAs.json, TReturn = FetchResult<T>[TAs]>(url: string | URL, options?: FetchOptions & TOptions): Omit<IPromisE_Timeout<TReturn>, "abortCtrl"> & {
+        /** An `AbortController` instance to control the request.  */
+        abortCtrl: AbortController;
+    };
     /** Default fetch options */
-    defaults: FetchOptionsDefaults;
+    defaults: FetchOptionsDefault;
 };
 
 /**
@@ -528,17 +576,24 @@ declare const fetch: {
  *     .then(console.log, console.error)
  * ```
  */
-declare const fetchResponse: <T = Response, TOptions extends FetchOptions = FetchOptions, TAs extends FetchAs = TOptions["as"] extends FetchAs ? TOptions["as"] : FetchAs.response, TReturn = FetchResult<T>[TAs]>(url: FetchArgs[0], options: Parameters<typeof fetch<T, TOptions, TAs, TReturn>>[1]) => IPromisE<TReturn>;
+declare const fetchResponse: {
+    <T = Response, TOptions extends FetchOptions = FetchOptions, TAs extends FetchAs = TOptions["as"] extends FetchAs ? TOptions["as"] : FetchAs.response, TReturn = FetchResult<T>[TAs]>(url: FetchArgs[0], options?: Parameters<typeof fetch<T, TOptions, TAs, TReturn>>[1]): Omit<_superutils_promise.IPromisE_Timeout<TReturn>, "abortCtrl"> & {
+        abortCtrl: AbortController;
+    };
+    defaults: FetchOptionsDefault;
+};
 
 declare const methods: {
     /** Make HTTP requests with method GET */
     get: {
-        <T, TOptions extends ({
+        <T = unknown, TOptions extends ({
             headers?: HeadersInit | undefined;
         } & Omit<FetchOptions, "headers" | "method"> & Partial<Record<"method", never>>) | undefined = ({
             headers?: HeadersInit | undefined;
-        } & Omit<FetchOptions, "headers" | "method"> & Partial<Record<"method", never>>) | undefined, TAs extends FetchAs = FetchAsFromOptions<TOptions, FetchAs.json>, TReturn = FetchResult<T>[TAs]>(url: FetchArgs[0], options?: TOptions | undefined): _superutils_promise.IPromisE<TReturn>;
-        deferred<ThisArg = unknown, Delay extends number = number, DefaultUrl extends FetchArgs[0] | undefined = string | URL | undefined, DefaultOptions extends ({
+        } & Omit<FetchOptions, "headers" | "method"> & Partial<Record<"method", never>>) | undefined, TAs extends FetchAs = FetchAsFromOptions<TOptions, FetchAs.json>, TReturn = FetchResult<T>[TAs]>(url: FetchArgs[0], options?: TOptions | undefined): Omit<_superutils_promise.IPromisE_Timeout<TReturn>, "abortCtrl"> & {
+            abortCtrl: AbortController;
+        };
+        deferred<ThisArg, Delay extends number, DefaultUrl extends FetchArgs[0] | undefined = string | URL | undefined, DefaultOptions extends ({
             headers?: HeadersInit | undefined;
         } & Omit<FetchOptions, "headers" | "method"> & Partial<Record<"method", never>>) | undefined = ({
             headers?: HeadersInit | undefined;
@@ -546,16 +601,20 @@ declare const methods: {
             headers?: HeadersInit | undefined;
         } & Omit<FetchOptions, "headers" | "method"> & Partial<Record<"method", never>>) | undefined = ({
             headers?: HeadersInit | undefined;
-        } & Omit<FetchOptions, "headers" | "method"> & Partial<Record<"method", never>>) | undefined, TAs extends FetchAs = FetchAsFromOptions<TOptions, FetchAs.json>, TReturn = FetchResult<TResult>[TAs]>(...args: DefaultUrl extends undefined ? [url: string | URL, options?: TOptions | undefined] : [options?: TOptions | undefined]) => _superutils_promise.IPromisE<TReturn>;
+        } & Omit<FetchOptions, "headers" | "method"> & Partial<Record<"method", never>>) | undefined, TAs extends FetchAs = FetchAsFromOptions<TOptions, FetchAs.json>, TReturn = FetchResult<TResult>[TAs]>(...args: DefaultUrl extends undefined ? [url: string | URL, options?: TOptions | undefined] : [options?: TOptions | undefined]) => Omit<_superutils_promise.IPromisE_Timeout<TReturn>, "abortCtrl"> & {
+            abortCtrl: AbortController;
+        };
     };
     /** Make HTTP requests with method HEAD */
     head: {
-        <T, TOptions extends ({
+        <T = unknown, TOptions extends ({
             headers?: HeadersInit | undefined;
         } & Omit<FetchOptions, "headers" | "method"> & Partial<Record<"method", never>>) | undefined = ({
             headers?: HeadersInit | undefined;
-        } & Omit<FetchOptions, "headers" | "method"> & Partial<Record<"method", never>>) | undefined, TAs extends FetchAs = FetchAsFromOptions<TOptions, FetchAs.json>, TReturn = FetchResult<T>[TAs]>(url: FetchArgs[0], options?: TOptions | undefined): _superutils_promise.IPromisE<TReturn>;
-        deferred<ThisArg = unknown, Delay extends number = number, DefaultUrl extends FetchArgs[0] | undefined = string | URL | undefined, DefaultOptions extends ({
+        } & Omit<FetchOptions, "headers" | "method"> & Partial<Record<"method", never>>) | undefined, TAs extends FetchAs = FetchAsFromOptions<TOptions, FetchAs.json>, TReturn = FetchResult<T>[TAs]>(url: FetchArgs[0], options?: TOptions | undefined): Omit<_superutils_promise.IPromisE_Timeout<TReturn>, "abortCtrl"> & {
+            abortCtrl: AbortController;
+        };
+        deferred<ThisArg, Delay extends number, DefaultUrl extends FetchArgs[0] | undefined = string | URL | undefined, DefaultOptions extends ({
             headers?: HeadersInit | undefined;
         } & Omit<FetchOptions, "headers" | "method"> & Partial<Record<"method", never>>) | undefined = ({
             headers?: HeadersInit | undefined;
@@ -563,16 +622,20 @@ declare const methods: {
             headers?: HeadersInit | undefined;
         } & Omit<FetchOptions, "headers" | "method"> & Partial<Record<"method", never>>) | undefined = ({
             headers?: HeadersInit | undefined;
-        } & Omit<FetchOptions, "headers" | "method"> & Partial<Record<"method", never>>) | undefined, TAs extends FetchAs = FetchAsFromOptions<TOptions, FetchAs.json>, TReturn = FetchResult<TResult>[TAs]>(...args: DefaultUrl extends undefined ? [url: string | URL, options?: TOptions | undefined] : [options?: TOptions | undefined]) => _superutils_promise.IPromisE<TReturn>;
+        } & Omit<FetchOptions, "headers" | "method"> & Partial<Record<"method", never>>) | undefined, TAs extends FetchAs = FetchAsFromOptions<TOptions, FetchAs.json>, TReturn = FetchResult<TResult>[TAs]>(...args: DefaultUrl extends undefined ? [url: string | URL, options?: TOptions | undefined] : [options?: TOptions | undefined]) => Omit<_superutils_promise.IPromisE_Timeout<TReturn>, "abortCtrl"> & {
+            abortCtrl: AbortController;
+        };
     };
     /** Make HTTP requests with method OPTIONS */
     options: {
-        <T, TOptions extends ({
+        <T = unknown, TOptions extends ({
             headers?: HeadersInit | undefined;
         } & Omit<FetchOptions, "headers" | "method"> & Partial<Record<"method", never>>) | undefined = ({
             headers?: HeadersInit | undefined;
-        } & Omit<FetchOptions, "headers" | "method"> & Partial<Record<"method", never>>) | undefined, TAs extends FetchAs = FetchAsFromOptions<TOptions, FetchAs.json>, TReturn = FetchResult<T>[TAs]>(url: FetchArgs[0], options?: TOptions | undefined): _superutils_promise.IPromisE<TReturn>;
-        deferred<ThisArg = unknown, Delay extends number = number, DefaultUrl extends FetchArgs[0] | undefined = string | URL | undefined, DefaultOptions extends ({
+        } & Omit<FetchOptions, "headers" | "method"> & Partial<Record<"method", never>>) | undefined, TAs extends FetchAs = FetchAsFromOptions<TOptions, FetchAs.json>, TReturn = FetchResult<T>[TAs]>(url: FetchArgs[0], options?: TOptions | undefined): Omit<_superutils_promise.IPromisE_Timeout<TReturn>, "abortCtrl"> & {
+            abortCtrl: AbortController;
+        };
+        deferred<ThisArg, Delay extends number, DefaultUrl extends FetchArgs[0] | undefined = string | URL | undefined, DefaultOptions extends ({
             headers?: HeadersInit | undefined;
         } & Omit<FetchOptions, "headers" | "method"> & Partial<Record<"method", never>>) | undefined = ({
             headers?: HeadersInit | undefined;
@@ -580,7 +643,9 @@ declare const methods: {
             headers?: HeadersInit | undefined;
         } & Omit<FetchOptions, "headers" | "method"> & Partial<Record<"method", never>>) | undefined = ({
             headers?: HeadersInit | undefined;
-        } & Omit<FetchOptions, "headers" | "method"> & Partial<Record<"method", never>>) | undefined, TAs extends FetchAs = FetchAsFromOptions<TOptions, FetchAs.json>, TReturn = FetchResult<TResult>[TAs]>(...args: DefaultUrl extends undefined ? [url: string | URL, options?: TOptions | undefined] : [options?: TOptions | undefined]) => _superutils_promise.IPromisE<TReturn>;
+        } & Omit<FetchOptions, "headers" | "method"> & Partial<Record<"method", never>>) | undefined, TAs extends FetchAs = FetchAsFromOptions<TOptions, FetchAs.json>, TReturn = FetchResult<TResult>[TAs]>(...args: DefaultUrl extends undefined ? [url: string | URL, options?: TOptions | undefined] : [options?: TOptions | undefined]) => Omit<_superutils_promise.IPromisE_Timeout<TReturn>, "abortCtrl"> & {
+            abortCtrl: AbortController;
+        };
     };
     /** Make HTTP requests with method DELETE */
     delete: {
@@ -588,14 +653,20 @@ declare const methods: {
             headers?: HeadersInit | undefined;
         } & Omit<PostOptions, "headers" | "method"> & Partial<Record<"method", never>>) | undefined = ({
             headers?: HeadersInit | undefined;
-        } & Omit<PostOptions, "headers" | "method"> & Partial<Record<"method", never>>) | undefined, TAs extends FetchAs = FetchAsFromOptions<TOptions, FetchAs.json>, TReturn = FetchResult<T>[TAs]>(url: PostArgs[0], data?: PostArgs[1], options?: TOptions | undefined): _superutils_promise.IPromisE<TReturn>;
-        deferred<ThisArg, Delay extends number, DefaultUrl extends PostArgs[0] | undefined, DefaultData extends PostArgs[1] = undefined, DefaultOptions extends ({
+        } & Omit<PostOptions, "headers" | "method"> & Partial<Record<"method", never>>) | undefined, TAs extends FetchAs = FetchAsFromOptions<TOptions, FetchAs.json>, TReturn = FetchResult<T>[TAs]>(url: PostArgs[0], data?: PostArgs[1], options?: TOptions | undefined): Omit<_superutils_promise.IPromisE_Timeout<TReturn>, "abortCtrl"> & {
+            abortCtrl: AbortController;
+        };
+        deferred<ThisArg, Delay extends number, DefaultOptions extends ({
+            headers?: HeadersInit | undefined;
+        } & Omit<PostOptions, "headers" | "method"> & Partial<Record<"method", never>>) | undefined = ({
             headers?: HeadersInit | undefined;
-        } & Omit<PostOptions, "headers" | "method"> & Partial<Record<"method", never>>) | undefined = undefined>(deferOptions?: _superutils_promise.DeferredAsyncOptions<ThisArg, Delay>, defaultUrl?: DefaultUrl | undefined, defaultData?: DefaultData | undefined, defaultOptions?: DefaultOptions | undefined): <TResult = unknown, TOptions extends ({
+        } & Omit<PostOptions, "headers" | "method"> & Partial<Record<"method", never>>) | undefined, DefaultUrl extends PostArgs[0] | undefined = string | URL | undefined, DefaultData extends PostArgs[1] = PostBody | (() => PostBody) | undefined>(deferOptions?: _superutils_promise.DeferredAsyncOptions<ThisArg, Delay>, defaultUrl?: DefaultUrl | undefined, defaultData?: DefaultData | undefined, defaultOptions?: DefaultOptions | undefined): <TResult = unknown, TOptions extends ({
             headers?: HeadersInit | undefined;
-        } & Omit<PostOptions, "headers" | "method"> & Partial<Record<"method", never>>) | undefined = {
+        } & Omit<PostOptions, "headers" | "method"> & Partial<Record<"method", never>>) | undefined = ({
             headers?: HeadersInit | undefined;
-        } & Omit<PostOptions, "headers" | "method"> & Partial<Record<"method", never>>, TAs extends FetchAs = FetchAsFromOptions<TOptions, FetchAs.json>, TReturn = FetchResult<TResult>[TAs]>(...args: PostDeferredCbArgs<DefaultUrl, DefaultData, TOptions, [url: string | URL, data: PostBody | (() => PostBody), options: PostOptions]>) => _superutils_promise.IPromisE<TReturn>;
+        } & Omit<PostOptions, "headers" | "method"> & Partial<Record<"method", never>>) | undefined, TAs extends FetchAs = FetchAsFromOptions<TOptions, FetchAs.json>, TReturn = FetchResult<TResult>[TAs]>(...args: PostDeferredCbArgs<DefaultUrl, DefaultData, TOptions, [url: string | URL, data: PostBody | (() => PostBody), options: PostOptions]>) => Omit<_superutils_promise.IPromisE_Timeout<TReturn>, "abortCtrl"> & {
+            abortCtrl: AbortController;
+        };
     };
     /** Make HTTP requests with method PATCH */
     patch: {
@@ -603,14 +674,20 @@ declare const methods: {
             headers?: HeadersInit | undefined;
         } & Omit<PostOptions, "headers" | "method"> & Partial<Record<"method", never>>) | undefined = ({
             headers?: HeadersInit | undefined;
-        } & Omit<PostOptions, "headers" | "method"> & Partial<Record<"method", never>>) | undefined, TAs extends FetchAs = FetchAsFromOptions<TOptions, FetchAs.json>, TReturn = FetchResult<T>[TAs]>(url: PostArgs[0], data?: PostArgs[1], options?: TOptions | undefined): _superutils_promise.IPromisE<TReturn>;
-        deferred<ThisArg, Delay extends number, DefaultUrl extends PostArgs[0] | undefined, DefaultData extends PostArgs[1] = undefined, DefaultOptions extends ({
+        } & Omit<PostOptions, "headers" | "method"> & Partial<Record<"method", never>>) | undefined, TAs extends FetchAs = FetchAsFromOptions<TOptions, FetchAs.json>, TReturn = FetchResult<T>[TAs]>(url: PostArgs[0], data?: PostArgs[1], options?: TOptions | undefined): Omit<_superutils_promise.IPromisE_Timeout<TReturn>, "abortCtrl"> & {
+            abortCtrl: AbortController;
+        };
+        deferred<ThisArg, Delay extends number, DefaultOptions extends ({
             headers?: HeadersInit | undefined;
-        } & Omit<PostOptions, "headers" | "method"> & Partial<Record<"method", never>>) | undefined = undefined>(deferOptions?: _superutils_promise.DeferredAsyncOptions<ThisArg, Delay>, defaultUrl?: DefaultUrl | undefined, defaultData?: DefaultData | undefined, defaultOptions?: DefaultOptions | undefined): <TResult = unknown, TOptions extends ({
+        } & Omit<PostOptions, "headers" | "method"> & Partial<Record<"method", never>>) | undefined = ({
             headers?: HeadersInit | undefined;
-        } & Omit<PostOptions, "headers" | "method"> & Partial<Record<"method", never>>) | undefined = {
+        } & Omit<PostOptions, "headers" | "method"> & Partial<Record<"method", never>>) | undefined, DefaultUrl extends PostArgs[0] | undefined = string | URL | undefined, DefaultData extends PostArgs[1] = PostBody | (() => PostBody) | undefined>(deferOptions?: _superutils_promise.DeferredAsyncOptions<ThisArg, Delay>, defaultUrl?: DefaultUrl | undefined, defaultData?: DefaultData | undefined, defaultOptions?: DefaultOptions | undefined): <TResult = unknown, TOptions extends ({
             headers?: HeadersInit | undefined;
-        } & Omit<PostOptions, "headers" | "method"> & Partial<Record<"method", never>>, TAs extends FetchAs = FetchAsFromOptions<TOptions, FetchAs.json>, TReturn = FetchResult<TResult>[TAs]>(...args: PostDeferredCbArgs<DefaultUrl, DefaultData, TOptions, [url: string | URL, data: PostBody | (() => PostBody), options: PostOptions]>) => _superutils_promise.IPromisE<TReturn>;
+        } & Omit<PostOptions, "headers" | "method"> & Partial<Record<"method", never>>) | undefined = ({
+            headers?: HeadersInit | undefined;
+        } & Omit<PostOptions, "headers" | "method"> & Partial<Record<"method", never>>) | undefined, TAs extends FetchAs = FetchAsFromOptions<TOptions, FetchAs.json>, TReturn = FetchResult<TResult>[TAs]>(...args: PostDeferredCbArgs<DefaultUrl, DefaultData, TOptions, [url: string | URL, data: PostBody | (() => PostBody), options: PostOptions]>) => Omit<_superutils_promise.IPromisE_Timeout<TReturn>, "abortCtrl"> & {
+            abortCtrl: AbortController;
+        };
     };
     /** Make HTTP requests with method POST */
     post: {
@@ -618,14 +695,20 @@ declare const methods: {
             headers?: HeadersInit | undefined;
         } & Omit<PostOptions, "headers" | "method"> & Partial<Record<"method", never>>) | undefined = ({
             headers?: HeadersInit | undefined;
-        } & Omit<PostOptions, "headers" | "method"> & Partial<Record<"method", never>>) | undefined, TAs extends FetchAs = FetchAsFromOptions<TOptions, FetchAs.json>, TReturn = FetchResult<T>[TAs]>(url: PostArgs[0], data?: PostArgs[1], options?: TOptions | undefined): _superutils_promise.IPromisE<TReturn>;
-        deferred<ThisArg, Delay extends number, DefaultUrl extends PostArgs[0] | undefined, DefaultData extends PostArgs[1] = undefined, DefaultOptions extends ({
+        } & Omit<PostOptions, "headers" | "method"> & Partial<Record<"method", never>>) | undefined, TAs extends FetchAs = FetchAsFromOptions<TOptions, FetchAs.json>, TReturn = FetchResult<T>[TAs]>(url: PostArgs[0], data?: PostArgs[1], options?: TOptions | undefined): Omit<_superutils_promise.IPromisE_Timeout<TReturn>, "abortCtrl"> & {
+            abortCtrl: AbortController;
+        };
+        deferred<ThisArg, Delay extends number, DefaultOptions extends ({
+            headers?: HeadersInit | undefined;
+        } & Omit<PostOptions, "headers" | "method"> & Partial<Record<"method", never>>) | undefined = ({
             headers?: HeadersInit | undefined;
-        } & Omit<PostOptions, "headers" | "method"> & Partial<Record<"method", never>>) | undefined = undefined>(deferOptions?: _superutils_promise.DeferredAsyncOptions<ThisArg, Delay>, defaultUrl?: DefaultUrl | undefined, defaultData?: DefaultData | undefined, defaultOptions?: DefaultOptions | undefined): <TResult = unknown, TOptions extends ({
+        } & Omit<PostOptions, "headers" | "method"> & Partial<Record<"method", never>>) | undefined, DefaultUrl extends PostArgs[0] | undefined = string | URL | undefined, DefaultData extends PostArgs[1] = PostBody | (() => PostBody) | undefined>(deferOptions?: _superutils_promise.DeferredAsyncOptions<ThisArg, Delay>, defaultUrl?: DefaultUrl | undefined, defaultData?: DefaultData | undefined, defaultOptions?: DefaultOptions | undefined): <TResult = unknown, TOptions extends ({
             headers?: HeadersInit | undefined;
-        } & Omit<PostOptions, "headers" | "method"> & Partial<Record<"method", never>>) | undefined = {
+        } & Omit<PostOptions, "headers" | "method"> & Partial<Record<"method", never>>) | undefined = ({
             headers?: HeadersInit | undefined;
-        } & Omit<PostOptions, "headers" | "method"> & Partial<Record<"method", never>>, TAs extends FetchAs = FetchAsFromOptions<TOptions, FetchAs.json>, TReturn = FetchResult<TResult>[TAs]>(...args: PostDeferredCbArgs<DefaultUrl, DefaultData, TOptions, [url: string | URL, data: PostBody | (() => PostBody), options: PostOptions]>) => _superutils_promise.IPromisE<TReturn>;
+        } & Omit<PostOptions, "headers" | "method"> & Partial<Record<"method", never>>) | undefined, TAs extends FetchAs = FetchAsFromOptions<TOptions, FetchAs.json>, TReturn = FetchResult<TResult>[TAs]>(...args: PostDeferredCbArgs<DefaultUrl, DefaultData, TOptions, [url: string | URL, data: PostBody | (() => PostBody), options: PostOptions]>) => Omit<_superutils_promise.IPromisE_Timeout<TReturn>, "abortCtrl"> & {
+            abortCtrl: AbortController;
+        };
     };
     /** Make HTTP requests with method PUT */
     put: {
@@ -633,14 +716,20 @@ declare const methods: {
             headers?: HeadersInit | undefined;
         } & Omit<PostOptions, "headers" | "method"> & Partial<Record<"method", never>>) | undefined = ({
             headers?: HeadersInit | undefined;
-        } & Omit<PostOptions, "headers" | "method"> & Partial<Record<"method", never>>) | undefined, TAs extends FetchAs = FetchAsFromOptions<TOptions, FetchAs.json>, TReturn = FetchResult<T>[TAs]>(url: PostArgs[0], data?: PostArgs[1], options?: TOptions | undefined): _superutils_promise.IPromisE<TReturn>;
-        deferred<ThisArg, Delay extends number, DefaultUrl extends PostArgs[0] | undefined, DefaultData extends PostArgs[1] = undefined, DefaultOptions extends ({
+        } & Omit<PostOptions, "headers" | "method"> & Partial<Record<"method", never>>) | undefined, TAs extends FetchAs = FetchAsFromOptions<TOptions, FetchAs.json>, TReturn = FetchResult<T>[TAs]>(url: PostArgs[0], data?: PostArgs[1], options?: TOptions | undefined): Omit<_superutils_promise.IPromisE_Timeout<TReturn>, "abortCtrl"> & {
+            abortCtrl: AbortController;
+        };
+        deferred<ThisArg, Delay extends number, DefaultOptions extends ({
             headers?: HeadersInit | undefined;
-        } & Omit<PostOptions, "headers" | "method"> & Partial<Record<"method", never>>) | undefined = undefined>(deferOptions?: _superutils_promise.DeferredAsyncOptions<ThisArg, Delay>, defaultUrl?: DefaultUrl | undefined, defaultData?: DefaultData | undefined, defaultOptions?: DefaultOptions | undefined): <TResult = unknown, TOptions extends ({
+        } & Omit<PostOptions, "headers" | "method"> & Partial<Record<"method", never>>) | undefined = ({
             headers?: HeadersInit | undefined;
-        } & Omit<PostOptions, "headers" | "method"> & Partial<Record<"method", never>>) | undefined = {
+        } & Omit<PostOptions, "headers" | "method"> & Partial<Record<"method", never>>) | undefined, DefaultUrl extends PostArgs[0] | undefined = string | URL | undefined, DefaultData extends PostArgs[1] = PostBody | (() => PostBody) | undefined>(deferOptions?: _superutils_promise.DeferredAsyncOptions<ThisArg, Delay>, defaultUrl?: DefaultUrl | undefined, defaultData?: DefaultData | undefined, defaultOptions?: DefaultOptions | undefined): <TResult = unknown, TOptions extends ({
             headers?: HeadersInit | undefined;
-        } & Omit<PostOptions, "headers" | "method"> & Partial<Record<"method", never>>, TAs extends FetchAs = FetchAsFromOptions<TOptions, FetchAs.json>, TReturn = FetchResult<TResult>[TAs]>(...args: PostDeferredCbArgs<DefaultUrl, DefaultData, TOptions, [url: string | URL, data: PostBody | (() => PostBody), options: PostOptions]>) => _superutils_promise.IPromisE<TReturn>;
+        } & Omit<PostOptions, "headers" | "method"> & Partial<Record<"method", never>>) | undefined = ({
+            headers?: HeadersInit | undefined;
+        } & Omit<PostOptions, "headers" | "method"> & Partial<Record<"method", never>>) | undefined, TAs extends FetchAs = FetchAsFromOptions<TOptions, FetchAs.json>, TReturn = FetchResult<TResult>[TAs]>(...args: PostDeferredCbArgs<DefaultUrl, DefaultData, TOptions, [url: string | URL, data: PostBody | (() => PostBody), options: PostOptions]>) => Omit<_superutils_promise.IPromisE_Timeout<TReturn>, "abortCtrl"> & {
+            abortCtrl: AbortController;
+        };
     };
 };
 /**
@@ -688,16 +777,29 @@ declare const methods: {
  * @param url
  * @param options (optional) Standard `fetch` options extended with {@link FetchCustomOptions}
  * @param options.abortCtrl (optional) if not provided `AbortController` will be instantiated when `timeout` used.
- * @param options.as (optional) (optional) specify how to parse the result. Default: {@link FetchAs.json}
+ *
+ * Default: `new AbortController()`
+ * @param options.as (optional) (optional) specify how to parse the result.
  * For raw `Response` use {@link FetchAs.response}
+ *
+ * Default: {@link FetchAs.json}
  * @param options.headers (optional) request headers
- * Default: `{ 'content-type': 'application/json' }` (or whaterver is set in the `fetch.defaults`).
- * @param options.interceptors (optional) request interceptor callbacks.  See {@link FetchInterceptors} for details.
- * @param options.method (optional) fetch method. Default: `'get'`
- * @param options.timeout (optional) duration in milliseconds to abort the request if it takes longer.
  *
+ * Default: `{ 'content-type': 'application/json' }`
+ * @param options.interceptors (optional) request interceptor/transformer callbacks.
+ * See {@link FetchInterceptors} for details.
+ * @param options.method (optional) fetch method.
+ *
+ * Default: `'get'`
+ * @param options.timeout (optional) duration in milliseconds to abort the request.
+ * This duration includes the execution of all interceptors/transformers.
+ *
+ * Default: `30_000`
+ *
+ * ---
  *
  * @example Drop-in replacement for built-in fetch
+ *
  * ```javascript
  * import fetch from '@superutils/fetch'
  *
@@ -729,44 +831,60 @@ declare const methods: {
  * ```typescript
  * import fetch from '@superutils/fetch'
  *
- * fetch.defaults = {
- *     errMsgs: {
- *        invalidUrl: 'Invalid URL',
- *        parseFailed: 'Failed to parse response as',
- *        reqTimedout: 'Request timed out',
- *        requestFailed: 'Request failed with status code:',
- *     },
- *     headers: new Headers([['content-type', 'application/json']]),
- * 	   // Global/application-wide Interceptor & Transfermers
- *     interceptors: {
- *     	   error: [],
- *     	   request: [],
- *     	   response: [],
- *     	   result: [],
- *     },
- *     timeout: 0,
- *     //........
- * }
+ * const { defaults, errorMsgs, interceptors } = fetch
+ *
+ * // set default request timeout duration in milliseconds
+ * defaults.timeout = 40_000
+ *
+ * // default headers
+ * defaults.headers = { 'content-type': 'text/plain' }
+ *
+ * // override error messages
+ * errorMsgs.invalidUrl = 'URL is not valid'
+ * errorMsgs.timedout = 'Request took longer than expected'
+ *
+ * // add an interceptor to log all request failures.
+ * const fetchLogger = (fetchErr, url, options) => console.log('Fetch error log', fetchErr)
+ * interceptors.error.push(fetchLogger)
+ *
+ * // add an interceptor to conditionally include header before making requests
+ * interceptors.request.push((url, options) => {
+ * 		// ignore login requests
+ *     if (`${url}`.includes('/login')) return
+ *
+ *     options.headers.set('x-auth-token', 'my-auth-token')
+ * })
  * ```
  */
-declare const fetchDefault: typeof fetchResponse & typeof methods;
+declare const defaultFetch: typeof fetchResponse & typeof methods;
 
 /**
- * Add AbortController to options if not present and propagate external abort signal if provided.
+ * Gracefully executes interceptors and returns the processed value.
+ * If the value is not transformed (by returning a new value) by the interceptors,
+ * the original value is returned.
  *
- * @param options The fetch options object.
+ * @param	value value to be passed to the interceptors
+ * @param	signal The AbortController used to monitor the request status. If the signal is aborted (e.g. due to
+ * timeout or manual cancellation), the interceptor chain halts immediately. Note: This does not interrupt the
+ * currently executing interceptor, but prevents subsequent ones from running.
+ * @param	interceptors interceptor/transformer callbacks
+ * @param	args (optional) common arguments to be supplied to all the interceptors in addition to
+ * the `value' which will always be the first argument.
  *
- * @returns The AbortController instance associated with the options.
+ * Interceptor arguments: `[value, ...args]`
  */
-declare const getAbortCtrl: (options: Partial<FetchOptions>) => AbortController;
+declare const executeInterceptors: <T, TArgs extends unknown[]>(value: T, signal?: AbortSignal, interceptors?: Interceptor<T, TArgs>[], ...args: TArgs) => Promise<T>;
 
 /**
- * Execute built-in `fetch()` and retry if request fails and `options.retry > 0`.
+ * Executes the built-in `fetch()` (or a custom `fetchFunc` if provided) with support for automatic retries.
  *
- * @param url request URL
- * @param options (optional)
+ * If `options.retry` is greater than 0, the request will be retried if it fails or if the response is not OK,
+ * unless overridden by `options.retryIf`.
+ *
+ * @param url The request URL.
+ * @param options (optional) Fetch options, including retry settings.
  *
- * @returns response
+ * @returns A promise resolving to the Response.
  */
 declare const getResponse: (url: FetchArgs[0], options?: FetchArgs[1]) => Promise<Response>;
 
@@ -788,4 +906,4 @@ declare const mergeFetchOptions: (...allOptions: FetchOptions[]) => FetchOptions
 /** Merges partial fetch options ignoring empty or undefined. Otherwise, will return the first argument. */
 declare const mergePartialOptions: (...optionsAr: (Partial<FetchOptions> | undefined)[]) => Partial<FetchOptions> | undefined;
 
-export { ContentType, type ExcludeOptions, type ExcludePostOptions, type FetchArgs, type FetchArgsInterceptor, FetchAs, type FetchAsFromOptions, type FetchCustomOptions, type FetchDeferredArgs, type FetchErrMsgs, FetchError, type FetchInterceptorError, type FetchInterceptorRequest, type FetchInterceptorResponse, type FetchInterceptorResult, type FetchInterceptors, type FetchOptions, type FetchOptionsDefaults, type FetchOptionsInterceptor, type FetchResult, type FetchRetryOptions, type Interceptor, type PostArgs, type PostBody, type PostDeferredCbArgs, type PostOptions, createClient, createPostClient, fetchDefault as default, executeInterceptors, fetch, fetchResponse, getAbortCtrl, getResponse, mergeFetchOptions, mergePartialOptions };
+export { ContentType, type ExcludeOptions, type ExcludePostOptions, type FetchArgs, type FetchArgsInterceptor, FetchAs, type FetchAsFromOptions, type FetchCustomOptions, type FetchDeferredArgs, type FetchErrMsgs, FetchError, type FetchFunc, type FetchInterceptorError, type FetchInterceptorRequest, type FetchInterceptorResponse, type FetchInterceptorResult, type FetchInterceptors, type FetchOptions, type FetchOptionsDefault, type FetchOptionsInterceptor, type FetchResult, type FetchRetryOptions, type Interceptor, MAX_TIMEOUT, type PostArgs, type PostBody, type PostDeferredCbArgs, type PostOptions, createClient, createPostClient, defaultFetch as default, executeInterceptors, fetch, fetchResponse, getResponse, mergeFetchOptions, mergePartialOptions };