@superutils/fetch 1.5.3 → 1.5.5

package/dist/index.cjs

@@ -76,14 +76,14 @@ var getResponse = (url, options = {}) => {
     {
       ...options,
       retryIf: async (res, count, error) => {
-        var _a;
+        var _a, _b;
         const { abortCtrl, retryIf, signal } = options;
-        if ((abortCtrl == null ? void 0 : abortCtrl.signal.aborted) || (signal == null ? void 0 : signal.aborted)) return false;
-        return !!((_a = await (0, import_core2.fallbackIfFails)(
+        if (((_a = abortCtrl == null ? void 0 : abortCtrl.signal) == null ? void 0 : _a.aborted) || (signal == null ? void 0 : signal.aborted)) return false;
+        return !!((_b = await (0, import_core2.fallbackIfFails)(
           retryIf,
           [res, count, error],
           void 0
-        )) != null ? _a : !!error || !(res == null ? void 0 : res.ok));
+        )) != null ? _b : !!error || !(res == null ? void 0 : res.ok));
       }
     }
   ).catch(
@@ -201,22 +201,20 @@ var FetchError = class _FetchError extends Error {
 };
 
 // src/fetch.ts
+var defaultErrorMsgs = Object.freeze({
+  aborted: "Request aborted",
+  invalidUrl: "Invalid URL",
+  parseFailed: "Failed to parse response as",
+  timedout: "Request timed out",
+  requestFailed: "Request failed with status code:"
+});
 var fetch = (url, options = {}) => {
   var _a, _b, _c;
   if (!(0, import_core4.isObj)(options)) options = {};
-  let fromPostClient = false;
-  if (options.fromPostClient) {
-    delete options.fromPostClient;
-    fromPostClient = true;
-  }
   let response;
   const opts = mergeOptions_default(
-    {
-      abortOnEarlyFinalize: fetch.defaults.abortOnEarlyFinalize,
-      errMsgs: fetch.defaults.errMsgs,
-      timeout: import_promise2.TIMEOUT_MAX,
-      validateUrl: false
-    },
+    { errMsgs: defaultErrorMsgs },
+    fetch.defaults,
     options
   );
   opts.abortCtrl = opts.abortCtrl instanceof AbortController ? opts.abortCtrl : new AbortController();
@@ -225,11 +223,7 @@ var fetch = (url, options = {}) => {
   (_c = opts.signal) != null ? _c : opts.signal = opts.abortCtrl.signal;
   const { abortCtrl, as: parseAs, headers, onAbort, onTimeout } = opts;
   opts.onAbort = async () => {
-    var _a2, _b2, _c2, _d, _e, _f;
-    const err = (_f = (_e = (_c2 = await (0, import_core4.fallbackIfFails)(onAbort, [], void 0)) != null ? _c2 : (_b2 = (_a2 = opts.abortCtrl) == null ? void 0 : _a2.signal) == null ? void 0 : _b2.reason) != null ? _e : (_d = opts.signal) == null ? void 0 : _d.reason) != null ? _f : opts.errMsgs.aborted;
-    if ((0, import_core4.isError)(err) && err.name === "AbortError") {
-      err.message = ["This operation was aborted"].includes(err.message) ? opts.errMsgs.aborted : err.message;
-    }
+    const err = await (0, import_core4.fallbackIfFails)(onAbort, [], void 0);
     return await interceptErr(
       (0, import_core4.isError)(err) ? err : new Error(err),
       url,
@@ -247,7 +241,7 @@ var fetch = (url, options = {}) => {
     );
   };
   return (0, import_promise2.timeout)(opts, async () => {
-    var _a2, _b2, _c2, _d, _e;
+    var _a2, _b2, _c2, _d;
     try {
       opts.body = await (0, import_core4.fallbackIfFails)(
         opts.body,
@@ -264,17 +258,10 @@ var fetch = (url, options = {}) => {
       (_b2 = opts.signal) != null ? _b2 : opts.signal = abortCtrl.signal;
       if (validateUrl && !(0, import_core4.isUrlValid)(url, false))
         throw new Error(errMsgs.invalidUrl);
-      if (fromPostClient) {
-        let contentType = headers.get("content-type");
-        if (!contentType) {
-          headers.set("content-type", ContentType.APPLICATION_JSON);
-          contentType = ContentType.APPLICATION_JSON;
-        }
-        const shouldStringifyBody = ["delete", "patch", "post", "put"].includes(
-          `${opts.method}`.toLowerCase()
-        ) && !["undefined", "string"].includes(typeof body) && (0, import_core4.isObj)(body, true) && contentType === ContentType.APPLICATION_JSON;
-        if (shouldStringifyBody) opts.body = JSON.stringify(opts.body);
-      }
+      const stringify = ["delete", "patch", "post", "put"].includes(
+        `${opts.method}`.toLowerCase()
+      ) && !["undefined", "string"].includes(typeof body) && (0, import_core4.isObj)(body, true) && headers.get("content-type") === ContentType.APPLICATION_JSON;
+      if (stringify) opts.body = JSON.stringify(opts.body);
       response = await getResponse_default(url, opts);
       response = await executeInterceptors_default(
         response,
@@ -283,7 +270,7 @@ var fetch = (url, options = {}) => {
         url,
         opts
       );
-      const status = (_d = response == null ? void 0 : response.status) != null ? _d : 0;
+      const status = response == null ? void 0 : response.status;
       const isSuccess = status >= 200 && status < 300;
       if (!isSuccess) {
         const jsonError = await (0, import_core4.fallbackIfFails)(
@@ -311,7 +298,7 @@ var fetch = (url, options = {}) => {
       result = await executeInterceptors_default(
         result,
         abortCtrl.signal,
-        (_e = opts.interceptors) == null ? void 0 : _e.result,
+        (_d = opts.interceptors) == null ? void 0 : _d.result,
         url,
         opts
       );
@@ -325,13 +312,7 @@ var fetch = (url, options = {}) => {
 };
 fetch.defaults = {
   abortOnEarlyFinalize: true,
-  errMsgs: {
-    aborted: "Request aborted",
-    invalidUrl: "Invalid URL",
-    parseFailed: "Failed to parse response as",
-    timedout: "Request timed out",
-    requestFailed: "Request failed with status code:"
-  },
+  errMsgs: { ...defaultErrorMsgs },
   // all error messages must be defined here
   headers: new Headers(),
   interceptors: {
@@ -379,17 +360,17 @@ var createClient = (fixedOptions, commonOptions, commonDeferOptions) => {
   client.deferred = (deferOptions, defaultUrl, defaultOptions) => {
     let _abortCtrl;
     const fetchCb = (...args) => {
-      var _a, _b, _c;
-      const mergedOptions = (_a = mergeOptions_default(
+      var _a, _b;
+      const mergedOptions = mergeOptions_default(
         fetch_default.defaults,
         commonOptions,
         defaultOptions,
         defaultUrl === void 0 ? args[1] : args[0],
         fixedOptions
         // fixed options will always override other options
-      )) != null ? _a : {};
-      (_b = mergedOptions.as) != null ? _b : mergedOptions.as = "json" /* json */;
-      (_c = _abortCtrl == null ? void 0 : _abortCtrl.abort) == null ? void 0 : _c.call(_abortCtrl);
+      );
+      (_a = mergedOptions.as) != null ? _a : mergedOptions.as = "json" /* json */;
+      (_b = _abortCtrl == null ? void 0 : _abortCtrl.abort) == null ? void 0 : _b.call(_abortCtrl);
       _abortCtrl = new AbortController();
       return fetch_default(
         defaultUrl != null ? defaultUrl : args[0],
@@ -411,7 +392,6 @@ var createPostClient = (fixedOptions, commonOptions, commonDeferOptions) => {
   function client(url, data, options) {
     var _a, _b;
     const mergedOptions = mergeOptions_default(
-      fetch_default.defaults,
       commonOptions,
       options,
       fixedOptions
@@ -420,29 +400,35 @@ var createPostClient = (fixedOptions, commonOptions, commonDeferOptions) => {
     (_a = mergedOptions.as) != null ? _a : mergedOptions.as = "json" /* json */;
     mergedOptions.body = data != null ? data : mergedOptions.body;
     (_b = mergedOptions.method) != null ? _b : mergedOptions.method = "post";
-    mergedOptions.fromPostClient = true;
+    const headers = mergedOptions.headers;
+    if (!headers.get("content-type")) {
+      headers.set("content-type", ContentType.APPLICATION_JSON);
+    }
     return fetch_default(url, mergedOptions);
   }
   client.deferred = (deferOptions, defaultUrl, defaultData, defaultOptions) => {
     let _abortCtrl;
     const postCb = (...args) => {
-      var _a, _b, _c, _d, _e;
+      var _a, _b, _c, _d;
       if (defaultUrl !== void 0) args.splice(0, 0, defaultUrl);
       if (defaultData !== void 0) args.splice(1, 0, defaultData);
-      const mergedOptions = (_a = mergeOptions_default(
+      const mergedOptions = mergeOptions_default(
         fetch_default.defaults,
         commonOptions,
         defaultOptions,
         args[2],
         fixedOptions
         // fixed options will always override other options
-      )) != null ? _a : {};
-      (_b = mergedOptions.as) != null ? _b : mergedOptions.as = "json" /* json */;
-      (_c = _abortCtrl == null ? void 0 : _abortCtrl.abort) == null ? void 0 : _c.call(_abortCtrl);
+      );
+      (_a = mergedOptions.as) != null ? _a : mergedOptions.as = "json" /* json */;
+      (_b = _abortCtrl == null ? void 0 : _abortCtrl.abort) == null ? void 0 : _b.call(_abortCtrl);
       _abortCtrl = new AbortController();
-      mergedOptions.body = (_d = args[1]) != null ? _d : mergedOptions.body;
-      (_e = mergedOptions.method) != null ? _e : mergedOptions.method = "post";
-      mergedOptions.fromPostClient = true;
+      mergedOptions.body = (_c = args[1]) != null ? _c : mergedOptions.body;
+      (_d = mergedOptions.method) != null ? _d : mergedOptions.method = "post";
+      const headers = mergedOptions.headers;
+      if (!headers.get("content-type")) {
+        headers.set("content-type", ContentType.APPLICATION_JSON);
+      }
       return fetch_default(args[0], mergedOptions);
     };
     return (0, import_promise4.deferredCallback)(postCb, {

package/dist/index.d.cts

@@ -52,7 +52,7 @@ type Interceptor<T, TArgs extends unknown[]> = (...args: [value: T, ...TArgs]) =
  *
  * // not returning anything or returning undefined will avoid transforming the error.
  * const logError = fetchErr => console.log(fetchErr)
- * const result = await fetch.get('https://dummyjson.com/http/400', {
+ * const result = await fetch.get('[DUMMYJSON-DOT-COM]/http/400', {
  *   interceptors: {
  *     error: [logError]
  *   }
@@ -71,7 +71,7 @@ type Interceptor<T, TArgs extends unknown[]> = (...args: [value: T, ...TArgs]) =
  *   fetchErr.message = 'Custom errormessage'
  * 	 return Promise.resolve(fetchErr)
  * }
- * const result = await fetch.get('https://dummyjson.com/http/400', {
+ * const result = await fetch.get('[DUMMYJSON-DOT-COM]/http/400', {
  *   interceptors: {
  *     error: [transformError]
  *   }
@@ -95,7 +95,7 @@ type FetchInterceptorError = Interceptor<FetchError, FetchArgsInterceptor>;
  * const includeAuthToken = (url, options) => {
  *   options.headers.set('x-auth-token', 'my-auth-token')
  * }
- * const result = await fetch.get('https://dummyjson.com/products', {
+ * const result = await fetch.get('[DUMMYJSON-DOT-COM]/products', {
  *   method: 'post',
  *   interceptors: {
  *       result: [apiV1ToV2, includeAuthToken]
@@ -121,12 +121,12 @@ type FetchInterceptorRequest = Interceptor<FetchArgs[0], [
  * // just a hypothetical scenario ;)
  * const getUser = async response => {
  * 	 const authResult = await response.json()
- *   const userDetails = await fetch.get('https://dummyjson.com/users/1')
+ *   const userDetails = await fetch.get('[DUMMYJSON-DOT-COM]/users/1')
  *   const userAuth = { ...userDetails, ...authResult }
  *   return new Response(JSON.stringify(userAuth))
  * }
  * const user = await fetch.post(
- * 	'https://dummyjson.com/user/login',
+ * 	'[DUMMYJSON-DOT-COM]/user/login',
  *  {  // data/request body
  *    username: 'emilys',
  *    password: 'emilyspass',
@@ -179,7 +179,7 @@ type FetchInterceptorResponse = Interceptor<Response, FetchArgsInterceptor>;
  *   )
  * }
  * // now we make the actaul fetch request
- * const result = await fetch.get('https://dummyjson.com/users/1', {
+ * const result = await fetch.get('[DUMMYJSON-DOT-COM]/users/1', {
  *   interceptors: {
  *     result: [
  * 	     ensureBalanceHex,
@@ -257,10 +257,8 @@ type ExtractAs<T extends unknown[], //FetchOptions/FetchAs/...
 Fallback = FetchAs.json> = T['length'] extends 0 ? Fallback : T[0] extends FetchAs ? T[0] : T[0] extends {
     as: infer OptAs;
 } ? OptAs extends FetchAs ? OptAs : ExtractAs<DropFirst<T>, Fallback> : ExtractAs<DropFirst<T>, Fallback>;
-type ExtractFetchAs<T, TFallback = FetchAs.json> = T extends FetchAs ? T : T extends {
-    as: infer As;
-} ? As extends FetchAs ? As : TFallback : TFallback;
 type FetchArgs = [url: string | URL, options?: FetchOptions];
+/** Additional arguments provided to interceptors */
 type FetchArgsInterceptor = [
     url: string | URL,
     options: FetchOptionsInterceptor
@@ -303,11 +301,6 @@ type FetchCustomOptions = {
     /** Whether to validate URL before making the request. Default: `false` */
     validateUrl?: boolean;
 } & FetchRetryOptions & TimeoutOptions<[]>;
-/** Default args */
-type FetchDeferredArgs = [
-    url?: string | URL,
-    options?: Omit<FetchOptions, 'abortCtrl'>
-];
 type FetchErrMsgs = {
     /** Error message to be used when request is aborted without specifying a message */
     aborted?: string;
@@ -320,6 +313,7 @@ type FetchErrMsgs = {
     /** Error message to be used when request fails */
     requestFailed?: string;
 };
+/** Optional, custom fetch function to replace the built-in `fetch` */
 type FetchFunc = (...args: FetchArgs) => Promise<Response>;
 /**
  * Fetch request options
@@ -332,17 +326,14 @@ type FetchOptionsDefault = Omit<FetchOptionsInterceptor, 'abortCtrl' | 'as' | 'b
      *
      * Deafult:
      * - No default content type set when `fetch()` is directly invoked.
-     * - `"content-type": "application/json"`: for `createPostClient()`, `fetch.post()`,
-     * `fetch.post.deferred()` and other method specific functions
+     * - Content type `"application/json"` is used as the default for all `createPostClient()`
+     * derived functions (eg: `fetch.post()`, `fetch.put()`...),
      */
     headers: HeadersInit;
     /**
      * Request timeout duration in milliseconds.
      *
-     * Default:
-     * - `30_000` for `createClient()`, `createPostClient()` and
-     * all method specific functions (`fetch.METHOD` & `fetch.METHOD.deferred()`
-     * - `2147483647` when `fetch()` invoked directly
+     * Default: `60_000`
      */
     timeout: number;
 };
@@ -352,7 +343,7 @@ type FetchOptionsDefault = Omit<FetchOptionsInterceptor, 'abortCtrl' | 'as' | 'b
  */
 type FetchOptionsInterceptor = Omit<FetchOptions, 'as' | 'body' | 'errMsgs' | 'interceptors' | 'headers' | 'timeout' | keyof FetchRetryOptions> & {
     as: FetchAs;
-    body: PostBody;
+    body?: PostBody;
     /** Error messages */
     errMsgs: Required<FetchErrMsgs>;
     headers: Headers;
@@ -452,7 +443,7 @@ type IPromise_Fetch<T = unknown> = Omit<IPromisE_Timeout<T>, 'abortCtrl'> & {
 /**
  * Defines client generic parameter T based on fixed options.
  *
- * If `fixedOptions.as` is defined and not `FetcAs.json`, then `T` will be `never`.
+ * If "fixedOptions.as" is defined and not `FetcAs.json`, then `T` will be `never`.
  */
 type ClientData<FixedOptions> = ExtractAs<[FixedOptions]> extends FetchAs.json ? unknown : never;
 /**
@@ -489,7 +480,7 @@ type ClientData<FixedOptions> = ExtractAs<[FixedOptions]> extends FetchAs.json ?
  * )
  *
  * // Use it just like the standard fetch
- * apiClient('https://dummyjson.com/products/1', {
+ * apiClient('[DUMMYJSON-DOT-COM]/products/1', {
  *   // The 'method' property cannot be overridden as it is used in the fixed options when creating the client.
  *   // In TypeScript, the compiler will not allow this property.
  *   // In Javascript, it will simply be ignored.
@@ -500,7 +491,7 @@ type ClientData<FixedOptions> = ExtractAs<[FixedOptions]> extends FetchAs.json ?
  * // create a deferred client using "apiClient"
  * const deferredClient = apiClient.deferred(
  *   { retry: 0 }, // disable retrying by overriding the `retry` defer option
- *   'https://dummyjson.com/products/1',
+ *   '[DUMMYJSON-DOT-COM]/products/1',
  *   { timeout: 3000 },
  * )
  * deferredClient({ timeout: 10000 }) // timeout is overridden by individual request
@@ -542,7 +533,7 @@ commonOptions?: FetchOptions & CommonOptions, commonDeferOptions?: DeferredAsync
  *
  * // Invoking `postClient()` automatically applies the pre-configured options
  * postClient(
- * 	 'https://dummyjson.com/products/add',
+ * 	 '[DUMMYJSON-DOT-COM]/products/add',
  * 	 { title: 'New Product' }, // data/body
  * 	 {}, // other options
  * ).then(console.log)
@@ -553,7 +544,7 @@ commonOptions?: FetchOptions & CommonOptions, commonDeferOptions?: DeferredAsync
  * 		delay: 300, // debounce duration
  * 		onResult: console.log, // prints only successful results
  * 	},
- * 	'https://dummyjson.com/products/add',
+ * 	'[DUMMYJSON-DOT-COM]/products/add',
  * 	{ method: 'patch', timeout: 3000 },
  * )
  * updateProduct({ title: 'New title 1' }) // ignored by debounce
@@ -586,25 +577,6 @@ commonOptions?: PostOptions & CommonOptions, commonDeferOptions?: DeferredAsyncO
  */
 declare const executeInterceptors: <T, TArgs extends unknown[]>(value: T, signal?: AbortSignal, interceptors?: Interceptor<T, TArgs>[], ...args: TArgs) => Promise<T>;
 
-/**
- * Extended `fetch` with timeout, retry, and other options. Automatically parses as JSON by default on success.
- *
- * @param url request URL
- * @param options (optional) Standard `fetch` options extended with {@link FetchCustomOptions}.
- * Default "content-type" header is 'application/json'.
- * @param options.as (optional) determines how to parse the result. Default: {@link FetchAs.json}
- * @param options.method (optional) fetch method. Default: `'get'`
- *
- * @example
- * #### Make a simple HTTP requests
- * ```javascript
- * import { fetch } from '@superutils/fetch'
- *
- * // no need for `response.json()` or `result.data.data` drilling
- * fetch.get('https://dummyjson.com/products/1')
- * 	   .then(product => console.log(product))
- * ```
- */
 declare const fetch$1: {
     <T = unknown, TOptions extends FetchOptions = FetchOptions, TAs extends FetchAs = TOptions["as"] extends FetchAs ? TOptions["as"] : FetchAs.response, TReturn = FetchResult<T>[TAs]>(url: string | URL, options?: FetchOptions & TOptions): IPromise_Fetch<TReturn>;
     /** Default fetch options */
@@ -865,9 +837,7 @@ declare const methods: {
  * @param options.timeout (optional) duration in milliseconds to abort the request.
  * This duration includes the execution of all interceptors/transformers.
  *
- * Default: `30_000`
- *
- *
+ * Default: `60_000`
  *
  * ---
  *
@@ -877,7 +847,7 @@ declare const methods: {
  * ```javascript
  * import fetch from '@superutils/fetch'
  *
- * fetch('https://dummyjson.com/products/1')
+ * fetch('[DUMMYJSON-DOT-COM]/products/1')
  *   .then(response => response.json())
  *   .then(console.log, console.error)
  * ```
@@ -887,14 +857,13 @@ declare const methods: {
  * ```javascript
  * import fetch from '@superutils/fetch'
  *
- * // no need for `response.json()` or `result.data.data` drilling
- * fetch.get('https://dummyjson.com/products/1')
+ * // no need for `response.json()` or "result.data.data" drilling
+ * fetch.get('[DUMMYJSON-DOT-COM]/products/1')
  *   .then(product => console.log(product))
- * fetch.post('https://dummyjson.com/products/add', { title: 'Product title' })
+ * fetch.post('[DUMMYJSON-DOT-COM]/products/add', { title: 'Product title' })
  *   .then(product => console.log(product))
  * ```
  *
- *
  * @example
  * #### Set default options.
  *
@@ -930,4 +899,4 @@ declare const methods: {
  */
 declare const fetch: typeof fetch$1 & typeof methods;
 
-export { type ClientData, ContentType, type ExcludeOptions, type ExcludePostOptions, type ExtractAs, type ExtractFetchAs, type FetchArgs, type FetchArgsInterceptor, FetchAs, type FetchCustomOptions, type FetchDeferredArgs, type FetchErrMsgs, FetchError, type FetchFunc, type FetchInterceptorError, type FetchInterceptorRequest, type FetchInterceptorResponse, type FetchInterceptorResult, type FetchInterceptors, type FetchInterceptorsMerged, type FetchOptions, type FetchOptionsDefault, type FetchOptionsInterceptor, type FetchResult, type FetchRetryOptions, type GetFetchResult, type IPromise_Fetch, type Interceptor, type PostArgs, type PostBody, type PostDeferredCbArgs, type PostOptions, createClient, createPostClient, fetch as default, executeInterceptors, fetch, mergeOptions };
+export { type ClientData, ContentType, type ExcludeOptions, type ExcludePostOptions, type ExtractAs, type FetchArgs, type FetchArgsInterceptor, FetchAs, type FetchCustomOptions, type FetchErrMsgs, FetchError, type FetchFunc, type FetchInterceptorError, type FetchInterceptorRequest, type FetchInterceptorResponse, type FetchInterceptorResult, type FetchInterceptors, type FetchInterceptorsMerged, type FetchOptions, type FetchOptionsDefault, type FetchOptionsInterceptor, type FetchResult, type FetchRetryOptions, type GetFetchResult, type IPromise_Fetch, type Interceptor, type PostArgs, type PostBody, type PostDeferredCbArgs, type PostOptions, createClient, createPostClient, fetch as default, executeInterceptors, fetch, mergeOptions };

package/dist/index.d.ts

@@ -52,7 +52,7 @@ type Interceptor<T, TArgs extends unknown[]> = (...args: [value: T, ...TArgs]) =
  *
  * // not returning anything or returning undefined will avoid transforming the error.
  * const logError = fetchErr => console.log(fetchErr)
- * const result = await fetch.get('https://dummyjson.com/http/400', {
+ * const result = await fetch.get('[DUMMYJSON-DOT-COM]/http/400', {
  *   interceptors: {
  *     error: [logError]
  *   }
@@ -71,7 +71,7 @@ type Interceptor<T, TArgs extends unknown[]> = (...args: [value: T, ...TArgs]) =
  *   fetchErr.message = 'Custom errormessage'
  * 	 return Promise.resolve(fetchErr)
  * }
- * const result = await fetch.get('https://dummyjson.com/http/400', {
+ * const result = await fetch.get('[DUMMYJSON-DOT-COM]/http/400', {
  *   interceptors: {
  *     error: [transformError]
  *   }
@@ -95,7 +95,7 @@ type FetchInterceptorError = Interceptor<FetchError, FetchArgsInterceptor>;
  * const includeAuthToken = (url, options) => {
  *   options.headers.set('x-auth-token', 'my-auth-token')
  * }
- * const result = await fetch.get('https://dummyjson.com/products', {
+ * const result = await fetch.get('[DUMMYJSON-DOT-COM]/products', {
  *   method: 'post',
  *   interceptors: {
  *       result: [apiV1ToV2, includeAuthToken]
@@ -121,12 +121,12 @@ type FetchInterceptorRequest = Interceptor<FetchArgs[0], [
  * // just a hypothetical scenario ;)
  * const getUser = async response => {
  * 	 const authResult = await response.json()
- *   const userDetails = await fetch.get('https://dummyjson.com/users/1')
+ *   const userDetails = await fetch.get('[DUMMYJSON-DOT-COM]/users/1')
  *   const userAuth = { ...userDetails, ...authResult }
  *   return new Response(JSON.stringify(userAuth))
  * }
  * const user = await fetch.post(
- * 	'https://dummyjson.com/user/login',
+ * 	'[DUMMYJSON-DOT-COM]/user/login',
  *  {  // data/request body
  *    username: 'emilys',
  *    password: 'emilyspass',
@@ -179,7 +179,7 @@ type FetchInterceptorResponse = Interceptor<Response, FetchArgsInterceptor>;
  *   )
  * }
  * // now we make the actaul fetch request
- * const result = await fetch.get('https://dummyjson.com/users/1', {
+ * const result = await fetch.get('[DUMMYJSON-DOT-COM]/users/1', {
  *   interceptors: {
  *     result: [
  * 	     ensureBalanceHex,
@@ -257,10 +257,8 @@ type ExtractAs<T extends unknown[], //FetchOptions/FetchAs/...
 Fallback = FetchAs.json> = T['length'] extends 0 ? Fallback : T[0] extends FetchAs ? T[0] : T[0] extends {
     as: infer OptAs;
 } ? OptAs extends FetchAs ? OptAs : ExtractAs<DropFirst<T>, Fallback> : ExtractAs<DropFirst<T>, Fallback>;
-type ExtractFetchAs<T, TFallback = FetchAs.json> = T extends FetchAs ? T : T extends {
-    as: infer As;
-} ? As extends FetchAs ? As : TFallback : TFallback;
 type FetchArgs = [url: string | URL, options?: FetchOptions];
+/** Additional arguments provided to interceptors */
 type FetchArgsInterceptor = [
     url: string | URL,
     options: FetchOptionsInterceptor
@@ -303,11 +301,6 @@ type FetchCustomOptions = {
     /** Whether to validate URL before making the request. Default: `false` */
     validateUrl?: boolean;
 } & FetchRetryOptions & TimeoutOptions<[]>;
-/** Default args */
-type FetchDeferredArgs = [
-    url?: string | URL,
-    options?: Omit<FetchOptions, 'abortCtrl'>
-];
 type FetchErrMsgs = {
     /** Error message to be used when request is aborted without specifying a message */
     aborted?: string;
@@ -320,6 +313,7 @@ type FetchErrMsgs = {
     /** Error message to be used when request fails */
     requestFailed?: string;
 };
+/** Optional, custom fetch function to replace the built-in `fetch` */
 type FetchFunc = (...args: FetchArgs) => Promise<Response>;
 /**
  * Fetch request options
@@ -332,17 +326,14 @@ type FetchOptionsDefault = Omit<FetchOptionsInterceptor, 'abortCtrl' | 'as' | 'b
      *
      * Deafult:
      * - No default content type set when `fetch()` is directly invoked.
-     * - `"content-type": "application/json"`: for `createPostClient()`, `fetch.post()`,
-     * `fetch.post.deferred()` and other method specific functions
+     * - Content type `"application/json"` is used as the default for all `createPostClient()`
+     * derived functions (eg: `fetch.post()`, `fetch.put()`...),
      */
     headers: HeadersInit;
     /**
      * Request timeout duration in milliseconds.
      *
-     * Default:
-     * - `30_000` for `createClient()`, `createPostClient()` and
-     * all method specific functions (`fetch.METHOD` & `fetch.METHOD.deferred()`
-     * - `2147483647` when `fetch()` invoked directly
+     * Default: `60_000`
      */
     timeout: number;
 };
@@ -352,7 +343,7 @@ type FetchOptionsDefault = Omit<FetchOptionsInterceptor, 'abortCtrl' | 'as' | 'b
  */
 type FetchOptionsInterceptor = Omit<FetchOptions, 'as' | 'body' | 'errMsgs' | 'interceptors' | 'headers' | 'timeout' | keyof FetchRetryOptions> & {
     as: FetchAs;
-    body: PostBody;
+    body?: PostBody;
     /** Error messages */
     errMsgs: Required<FetchErrMsgs>;
     headers: Headers;
@@ -452,7 +443,7 @@ type IPromise_Fetch<T = unknown> = Omit<IPromisE_Timeout<T>, 'abortCtrl'> & {
 /**
  * Defines client generic parameter T based on fixed options.
  *
- * If `fixedOptions.as` is defined and not `FetcAs.json`, then `T` will be `never`.
+ * If "fixedOptions.as" is defined and not `FetcAs.json`, then `T` will be `never`.
  */
 type ClientData<FixedOptions> = ExtractAs<[FixedOptions]> extends FetchAs.json ? unknown : never;
 /**
@@ -489,7 +480,7 @@ type ClientData<FixedOptions> = ExtractAs<[FixedOptions]> extends FetchAs.json ?
  * )
  *
  * // Use it just like the standard fetch
- * apiClient('https://dummyjson.com/products/1', {
+ * apiClient('[DUMMYJSON-DOT-COM]/products/1', {
  *   // The 'method' property cannot be overridden as it is used in the fixed options when creating the client.
  *   // In TypeScript, the compiler will not allow this property.
  *   // In Javascript, it will simply be ignored.
@@ -500,7 +491,7 @@ type ClientData<FixedOptions> = ExtractAs<[FixedOptions]> extends FetchAs.json ?
  * // create a deferred client using "apiClient"
  * const deferredClient = apiClient.deferred(
  *   { retry: 0 }, // disable retrying by overriding the `retry` defer option
- *   'https://dummyjson.com/products/1',
+ *   '[DUMMYJSON-DOT-COM]/products/1',
  *   { timeout: 3000 },
  * )
  * deferredClient({ timeout: 10000 }) // timeout is overridden by individual request
@@ -542,7 +533,7 @@ commonOptions?: FetchOptions & CommonOptions, commonDeferOptions?: DeferredAsync
  *
  * // Invoking `postClient()` automatically applies the pre-configured options
  * postClient(
- * 	 'https://dummyjson.com/products/add',
+ * 	 '[DUMMYJSON-DOT-COM]/products/add',
  * 	 { title: 'New Product' }, // data/body
  * 	 {}, // other options
  * ).then(console.log)
@@ -553,7 +544,7 @@ commonOptions?: FetchOptions & CommonOptions, commonDeferOptions?: DeferredAsync
  * 		delay: 300, // debounce duration
  * 		onResult: console.log, // prints only successful results
  * 	},
- * 	'https://dummyjson.com/products/add',
+ * 	'[DUMMYJSON-DOT-COM]/products/add',
  * 	{ method: 'patch', timeout: 3000 },
  * )
  * updateProduct({ title: 'New title 1' }) // ignored by debounce
@@ -586,25 +577,6 @@ commonOptions?: PostOptions & CommonOptions, commonDeferOptions?: DeferredAsyncO
  */
 declare const executeInterceptors: <T, TArgs extends unknown[]>(value: T, signal?: AbortSignal, interceptors?: Interceptor<T, TArgs>[], ...args: TArgs) => Promise<T>;
 
-/**
- * Extended `fetch` with timeout, retry, and other options. Automatically parses as JSON by default on success.
- *
- * @param url request URL
- * @param options (optional) Standard `fetch` options extended with {@link FetchCustomOptions}.
- * Default "content-type" header is 'application/json'.
- * @param options.as (optional) determines how to parse the result. Default: {@link FetchAs.json}
- * @param options.method (optional) fetch method. Default: `'get'`
- *
- * @example
- * #### Make a simple HTTP requests
- * ```javascript
- * import { fetch } from '@superutils/fetch'
- *
- * // no need for `response.json()` or `result.data.data` drilling
- * fetch.get('https://dummyjson.com/products/1')
- * 	   .then(product => console.log(product))
- * ```
- */
 declare const fetch$1: {
     <T = unknown, TOptions extends FetchOptions = FetchOptions, TAs extends FetchAs = TOptions["as"] extends FetchAs ? TOptions["as"] : FetchAs.response, TReturn = FetchResult<T>[TAs]>(url: string | URL, options?: FetchOptions & TOptions): IPromise_Fetch<TReturn>;
     /** Default fetch options */
@@ -865,9 +837,7 @@ declare const methods: {
  * @param options.timeout (optional) duration in milliseconds to abort the request.
  * This duration includes the execution of all interceptors/transformers.
  *
- * Default: `30_000`
- *
- *
+ * Default: `60_000`
  *
  * ---
  *
@@ -877,7 +847,7 @@ declare const methods: {
  * ```javascript
  * import fetch from '@superutils/fetch'
  *
- * fetch('https://dummyjson.com/products/1')
+ * fetch('[DUMMYJSON-DOT-COM]/products/1')
  *   .then(response => response.json())
  *   .then(console.log, console.error)
  * ```
@@ -887,14 +857,13 @@ declare const methods: {
  * ```javascript
  * import fetch from '@superutils/fetch'
  *
- * // no need for `response.json()` or `result.data.data` drilling
- * fetch.get('https://dummyjson.com/products/1')
+ * // no need for `response.json()` or "result.data.data" drilling
+ * fetch.get('[DUMMYJSON-DOT-COM]/products/1')
  *   .then(product => console.log(product))
- * fetch.post('https://dummyjson.com/products/add', { title: 'Product title' })
+ * fetch.post('[DUMMYJSON-DOT-COM]/products/add', { title: 'Product title' })
  *   .then(product => console.log(product))
  * ```
  *
- *
  * @example
  * #### Set default options.
  *
@@ -930,4 +899,4 @@ declare const methods: {
  */
 declare const fetch: typeof fetch$1 & typeof methods;
 
-export { type ClientData, ContentType, type ExcludeOptions, type ExcludePostOptions, type ExtractAs, type ExtractFetchAs, type FetchArgs, type FetchArgsInterceptor, FetchAs, type FetchCustomOptions, type FetchDeferredArgs, type FetchErrMsgs, FetchError, type FetchFunc, type FetchInterceptorError, type FetchInterceptorRequest, type FetchInterceptorResponse, type FetchInterceptorResult, type FetchInterceptors, type FetchInterceptorsMerged, type FetchOptions, type FetchOptionsDefault, type FetchOptionsInterceptor, type FetchResult, type FetchRetryOptions, type GetFetchResult, type IPromise_Fetch, type Interceptor, type PostArgs, type PostBody, type PostDeferredCbArgs, type PostOptions, createClient, createPostClient, fetch as default, executeInterceptors, fetch, mergeOptions };
+export { type ClientData, ContentType, type ExcludeOptions, type ExcludePostOptions, type ExtractAs, type FetchArgs, type FetchArgsInterceptor, FetchAs, type FetchCustomOptions, type FetchErrMsgs, FetchError, type FetchFunc, type FetchInterceptorError, type FetchInterceptorRequest, type FetchInterceptorResponse, type FetchInterceptorResult, type FetchInterceptors, type FetchInterceptorsMerged, type FetchOptions, type FetchOptionsDefault, type FetchOptionsInterceptor, type FetchResult, type FetchRetryOptions, type GetFetchResult, type IPromise_Fetch, type Interceptor, type PostArgs, type PostBody, type PostDeferredCbArgs, type PostOptions, createClient, createPostClient, fetch as default, executeInterceptors, fetch, mergeOptions };