async-fetch 0.3.8 → 0.4.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nameer
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,19 +1,18 @@
-# useAsyncFetch
+# async-fetch
 
-Use async fetch hook for requests within React components.
+A React hook for async fetch requests with built-in state management, cancellation, and polling.
 
 ## Installation
 
-```console
-npm i async-fetch
+```bash
+npm install async-fetch
+# or
+yarn add async-fetch
 ```
 
 ## Usage
 
-Provide a url and handle the request.
-
 ```javascript
-import React from "react";
 import useAsyncFetch from "async-fetch";
 
 function App() {
@@ -23,14 +22,10 @@ function App() {
 
   return (
     <React.Fragment>
-      <button onClick={sendRequest}>Send request.</button>
-      <br />
-      <br />
+      <button onClick={sendRequest}>Send request</button>
       <button onClick={cancelRequest} disabled={!pending}>
-        Cancel request.
+        Cancel request
       </button>
-      <br />
-      <br />
       {pending
         ? "Loading..."
         : data
@@ -41,39 +36,82 @@ function App() {
     </React.Fragment>
   );
 }
+```
+
+### Auto-fetch on mount
+
+By default the hook fires on mount. Set `auto: false` to disable:
+
+```javascript
+const { pending, data, sendRequest } = useAsyncFetch(url, { auto: false });
+```
 
-export default App;
+### POST with JSON body
+
+```javascript
+const { pending, data, error } = useAsyncFetch("/api/submit", {
+  method: "POST",
+  data: { name: "foo" },
+});
 ```
 
-### Available IN Props And Definitions
-
-The minimum requirement for the hook is a url string as the first argument. The second argument has the following available options, while anything else that is provided is passed to the fetch request:
-
-| Key            | Type     | Definition                                                                                                      | Default |
-| -------------- | -------- | --------------------------------------------------------------------------------------------------------------- | ------- |
-| initialPending | Boolean  | Initial state for the pending constant.                                                                         | false   |
-| initialError   | E or Any | Initial state for the error constant.                                                                           |         |
-| initialData    | T or Any | Initial state for the data constant.                                                                            |         |
-| auto           | Boolean  | Whether or not the request should send on mount.                                                                | true    |
-| poll           | Number   | Number of milliseconds to wait for polling requests.                                                            |         |
-| timeout        | Number   | Number of milliseconds to wait before canceling the request.                                                    | 30000   |
-| ignoreRequest  | Boolean  | Whether or not the request should send.                                                                         |         |
-| ignoreCleanup  | Boolean  | Whether or not the hook should cleanup on component unmount.                                                    |         |
-| query          | Object   | JSON object to append to the url as search params.                                                              |         |
-| params         | Object   | JSON object to append to the url as search params.                                                              |         |
-| data           | Any      | JSON object to send in the request body.                                                                        |         |
-| parser         | String   | Method used to parse the response. Options: json, text, blob, formData, arrayBuffer.                            | "json"  |
-| onStart        | Function | Callback function to call when the request starts.                                                              |         |
-| onSuccess      | Function | Callback function to call when the response has been received. The response is available as the first argument. |         |
-| onFail         | Function | Callback function to call when the request has failed. The error is available as the first argument.            |         |
-| onFinish       | Function | Callback function to call when the request has finished.                                                        |         |
-
-### Available OUT Props And Definitions
-
-| Key           | Type     | Definition                               |
-| ------------- | -------- | ---------------------------------------- |
-| pending       | Boolean  | Whether or not the request is active.    |
-| error         | E or Any | The response error.                      |
-| data          | T or Any | The response data.                       |
-| sendRequest   | Function | Function to send the request manually.   |
-| cancelRequest | Function | Function to cancel the request manually. |
+### Polling
+
+```javascript
+const { data } = useAsyncFetch("/api/status", { poll: 5000 });
+```
+
+### Callbacks
+
+```javascript
+useAsyncFetch("/api/user/1", {
+  onStart: () => console.log("started"),
+  onSuccess: (data) => console.log(data),
+  onFail: (error) => console.error(error),
+  onFinish: () => console.log("finished"),
+});
+```
+
+### Cancel on demand
+
+```javascript
+const { cancelRequest } = useAsyncFetch("/api/user/1");
+<button onClick={cancelRequest}>Cancel</button>;
+```
+
+## Request options
+
+The minimum requirement is a URL string as the first argument. The second argument accepts the following options — anything else is passed directly to the underlying `fetch` call.
+
+| Option           | Type                                                        | Default  | Description                                          |
+| ---------------- | ----------------------------------------------------------- | -------- | ---------------------------------------------------- |
+| `initialPending` | `boolean`                                                   | `false`  | Initial state for `pending`                          |
+| `initialError`   | `E`                                                         |          | Initial state for `error`                            |
+| `initialData`    | `T`                                                         |          | Initial state for `data`                             |
+| `auto`           | `boolean`                                                   | `true`   | Whether to auto-send the request on mount            |
+| `poll`           | `number`                                                    |          | Milliseconds between polling requests                |
+| `timeout`        | `number`                                                    | `30000`  | Milliseconds before the request is cancelled         |
+| `ignoreRequest`  | `boolean`                                                   |          | Skips sending the request when `true`                |
+| `ignoreCleanup`  | `boolean`                                                   |          | Skips cancelling the request on unmount when `true`  |
+| `query`          | `object`                                                    |          | Key-value pairs appended to the URL as search params |
+| `params`         | `object`                                                    |          | Key-value pairs appended to the URL as search params |
+| `data`           | `unknown`                                                   |          | Value to send as the request body                    |
+| `parser`         | `"json" \| "text" \| "blob" \| "formData" \| "arrayBuffer"` | `"json"` | Method used to parse the response                    |
+| `onStart`        | `() => void`                                                |          | Called when the request starts                       |
+| `onSuccess`      | `(data: T) => void`                                         |          | Called with the response data on success             |
+| `onFail`         | `(error: E) => void`                                        |          | Called with the error on failure                     |
+| `onFinish`       | `() => void`                                                |          | Called when the request finishes                     |
+
+## Response
+
+| Property        | Type                  | Description                   |
+| --------------- | --------------------- | ----------------------------- |
+| `pending`       | `boolean`             | Whether the request is active |
+| `error`         | `E`                   | The response error            |
+| `data`          | `T`                   | The response data             |
+| `sendRequest`   | `() => Promise<void>` | Sends the request manually    |
+| `cancelRequest` | `() => void`          | Cancels the active request    |
+
+## License
+
+MIT

package/dist/cjs/index.js

@@ -0,0 +1,145 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const react_1 = require("react");
+const useInterval_js_1 = __importDefault(require("./useInterval.js"));
+const normalizeError_js_1 = __importDefault(require("./normalizeError.js"));
+/**
+ * A React hook for managing async fetch requests with built-in state, cancellation, and polling.
+ * @example
+ * // Auto-fetch on mount:
+ * const { pending, error, data } = useAsyncFetch<User>("/api/user/1");
+ *
+ * // Manual trigger:
+ * const { pending, error, data, sendRequest } = useAsyncFetch<User>("/api/user/1", { auto: false });
+ * <button onClick={sendRequest}>Fetch</button>
+ *
+ * // With polling:
+ * const { data } = useAsyncFetch<Status>("/api/status", { poll: 5000 });
+ *
+ * // POST with JSON body:
+ * const { pending, error, data } = useAsyncFetch<Response>("/api/submit", {
+ *   method: "POST",
+ *   data: { name: "foo" },
+ * });
+ *
+ * // With callbacks:
+ * useAsyncFetch<User>("/api/user/1", {
+ *   onStart: () => console.log("started"),
+ *   onSuccess: (data) => console.log(data),
+ *   onFail: (error) => console.error(error),
+ *   onFinish: () => console.log("finished"),
+ * });
+ *
+ * // Cancel on demand:
+ * const { cancelRequest } = useAsyncFetch<User>("/api/user/1");
+ * <button onClick={cancelRequest}>Cancel</button>
+ */
+function useAsyncFetch(urlString, props = {}) {
+    const { initialPending = false, initialError, initialData, auto = true, poll, timeout = 30000, ignoreRequest, ignoreCleanup, query, params, data: body, parser = "json", onStart, onSuccess, onFail, onFinish, ...fetchOptions } = props;
+    const [pending, setPending] = (0, react_1.useState)(initialPending);
+    const [error, setError] = (0, react_1.useState)(initialError);
+    const [data, setData] = (0, react_1.useState)(initialData);
+    const fetchOptionsRef = (0, react_1.useRef)(fetchOptions);
+    const controllerRef = (0, react_1.useRef)(null);
+    const requestIdRef = (0, react_1.useRef)(0);
+    fetchOptionsRef.current = fetchOptions;
+    const cancelRequest = (0, react_1.useCallback)(() => {
+        controllerRef.current?.abort();
+        controllerRef.current = null;
+    }, []);
+    const sendRequest = (0, react_1.useCallback)(async () => {
+        if (ignoreRequest === true)
+            return;
+        cancelRequest();
+        setPending(true);
+        setError(undefined);
+        if (onStart)
+            onStart();
+        const controller = new AbortController();
+        controllerRef.current = controller;
+        const timeoutId = setTimeout(() => controller.abort(), timeout);
+        const requestId = ++requestIdRef.current;
+        try {
+            const url = new URL(urlString, window.location.origin);
+            if (query ?? params) {
+                url.search = new URLSearchParams({ ...query, ...params }).toString();
+            }
+            const headers = new Headers(fetchOptionsRef.current.headers);
+            let resolvedBody;
+            if (headers.get("content-type") === "application/x-www-form-urlencoded") {
+                resolvedBody = new URLSearchParams(body ?? {});
+            }
+            else if (body instanceof FormData || body instanceof Blob) {
+                resolvedBody = body;
+            }
+            else if (body !== undefined) {
+                resolvedBody = JSON.stringify(body);
+            }
+            const response = await fetch(url, {
+                ...fetchOptionsRef.current,
+                headers,
+                body: resolvedBody ?? fetchOptionsRef.current.body,
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                throw Object.assign(new Error(response.statusText), {
+                    status: response.status,
+                    statusText: response.statusText,
+                    response: await response.text(),
+                });
+            }
+            const parsedResponse = (await response[parser]());
+            setData(parsedResponse);
+            if (onSuccess)
+                onSuccess(parsedResponse);
+        }
+        catch (err) {
+            if (err?.name !== "AbortError") {
+                const normalizedError = (0, normalizeError_js_1.default)(err);
+                setError(normalizedError);
+                if (onFail)
+                    onFail(normalizedError);
+            }
+        }
+        finally {
+            clearTimeout(timeoutId);
+            if (requestId === requestIdRef.current) {
+                setPending(false);
+                if (onFinish)
+                    onFinish();
+            }
+        }
+    }, [
+        ignoreRequest,
+        cancelRequest,
+        timeout,
+        urlString,
+        query,
+        params,
+        body,
+        parser,
+        onStart,
+        onSuccess,
+        onFail,
+        onFinish,
+    ]);
+    (0, react_1.useEffect)(() => {
+        if (auto === true)
+            void sendRequest();
+    }, [auto, sendRequest]);
+    (0, useInterval_js_1.default)(() => {
+        void sendRequest();
+    }, poll);
+    (0, react_1.useEffect)(() => {
+        return () => {
+            if (ignoreCleanup !== true)
+                cancelRequest();
+        };
+    }, [ignoreCleanup, cancelRequest]);
+    return { pending, error, data, cancelRequest, sendRequest };
+}
+exports.default = useAsyncFetch;
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/dist/cjs/interfaces.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=interfaces.js.map

package/dist/cjs/interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../../src/interfaces.ts"],"names":[],"mappings":""}

package/dist/cjs/normalizeError.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Normalizes an unknown thrown value into a `FetchError`-shaped object.
+ * Handles `Error` instances, error-like objects, and primitive values.
+ * @example
+ * normalizeError(new Error("oops"))                                      // { status: 500, statusText: "oops", response: "<stack>" }
+ * normalizeError({ status: 404, statusText: "Not Found", response: "" }) // { status: 404, statusText: "Not Found", response: "" }
+ * normalizeError({ status: 403 })                                        // { status: 403, statusText: "", response: "" }
+ * normalizeError("something went wrong")                                 // { status: 500, statusText: "something went wrong", response: "" }
+ * normalizeError(null)                                                   // { status: 500, statusText: "null", response: "" }
+ */
+function normalizeError(err) {
+    if (err instanceof Error) {
+        return {
+            status: 500,
+            statusText: err.message,
+            response: err.stack ?? "",
+        };
+    }
+    if (typeof err === "object" && err !== null) {
+        const e = err;
+        return {
+            status: e.status ?? 500,
+            statusText: e.statusText ?? "",
+            response: e.response ?? "",
+        };
+    }
+    return {
+        status: 500,
+        statusText: String(err),
+        response: "",
+    };
+}
+exports.default = normalizeError;
+//# sourceMappingURL=normalizeError.js.map

package/dist/cjs/normalizeError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeError.js","sourceRoot":"","sources":["../../src/normalizeError.ts"],"names":[],"mappings":";;AAEA;;;;;;;;;GASG;AACH,SAAS,cAAc,CAAiB,GAAY;IAClD,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QACzB,OAAO;YACL,MAAM,EAAE,GAAG;YACX,UAAU,EAAE,GAAG,CAAC,OAAO;YACvB,QAAQ,EAAE,GAAG,CAAC,KAAK,IAAI,EAAE;SACrB,CAAC;IACT,CAAC;IAED,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QAC5C,MAAM,CAAC,GAAG,GAA0B,CAAC;QACrC,OAAO;YACL,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,GAAG;YACvB,UAAU,EAAE,CAAC,CAAC,UAAU,IAAI,EAAE;YAC9B,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,EAAE;SACtB,CAAC;IACT,CAAC;IAED,OAAO;QACL,MAAM,EAAE,GAAG;QACX,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC;QACvB,QAAQ,EAAE,EAAE;KACR,CAAC;AACT,CAAC;AAED,kBAAe,cAAc,CAAC"}

package/dist/cjs/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

package/dist/cjs/types/index.d.ts

@@ -0,0 +1,35 @@
+import { type FetchError, type RequestProps, type ResponseProps } from "./interfaces.js";
+/**
+ * A React hook for managing async fetch requests with built-in state, cancellation, and polling.
+ * @example
+ * // Auto-fetch on mount:
+ * const { pending, error, data } = useAsyncFetch<User>("/api/user/1");
+ *
+ * // Manual trigger:
+ * const { pending, error, data, sendRequest } = useAsyncFetch<User>("/api/user/1", { auto: false });
+ * <button onClick={sendRequest}>Fetch</button>
+ *
+ * // With polling:
+ * const { data } = useAsyncFetch<Status>("/api/status", { poll: 5000 });
+ *
+ * // POST with JSON body:
+ * const { pending, error, data } = useAsyncFetch<Response>("/api/submit", {
+ *   method: "POST",
+ *   data: { name: "foo" },
+ * });
+ *
+ * // With callbacks:
+ * useAsyncFetch<User>("/api/user/1", {
+ *   onStart: () => console.log("started"),
+ *   onSuccess: (data) => console.log(data),
+ *   onFail: (error) => console.error(error),
+ *   onFinish: () => console.log("finished"),
+ * });
+ *
+ * // Cancel on demand:
+ * const { cancelRequest } = useAsyncFetch<User>("/api/user/1");
+ * <button onClick={cancelRequest}>Cancel</button>
+ */
+declare function useAsyncFetch<T = unknown, E = FetchError>(urlString: string, props?: RequestProps<T, E>): ResponseProps<T, E>;
+export default useAsyncFetch;
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,aAAa,EACnB,MAAM,iBAAiB,CAAC;AAKzB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,iBAAS,aAAa,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,UAAU,EAChD,SAAS,EAAE,MAAM,EACjB,KAAK,GAAE,YAAY,CAAC,CAAC,EAAE,CAAC,CAAM,GAC7B,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CA+IrB;AAED,eAAe,aAAa,CAAC"}

package/dist/{interfaces.d.ts → cjs/types/interfaces.d.ts}

@@ -12,9 +12,9 @@ export interface RequestProps<T, E> extends RequestInit {
     timeout?: number;
     ignoreRequest?: boolean;
     ignoreCleanup?: boolean;
-    query?: Record<string, any>;
-    params?: Record<string, any>;
-    data?: any;
+    query?: Record<string, string>;
+    params?: Record<string, string>;
+    data?: unknown;
     parser?: "json" | "text" | "blob" | "formData" | "arrayBuffer";
     onStart?: () => void;
     onSuccess?: (data: T) => void;
@@ -28,3 +28,4 @@ export interface ResponseProps<T, E> {
     sendRequest: () => Promise<void>;
     cancelRequest: () => void;
 }
+//# sourceMappingURL=interfaces.d.ts.map

package/dist/cjs/types/interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../../src/interfaces.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY,CAAC,CAAC,EAAE,CAAC,CAAE,SAAQ,WAAW;IACrD,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,CAAC,CAAC;IACjB,WAAW,CAAC,EAAE,CAAC,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,aAAa,CAAC;IAC/D,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;IAC9B,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,aAAa,CAAC,CAAC,EAAE,CAAC;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,CAAC,CAAC;IACV,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,aAAa,EAAE,MAAM,IAAI,CAAC;CAC3B"}

package/dist/cjs/types/normalizeError.d.ts

@@ -0,0 +1,14 @@
+import { type FetchError } from "./interfaces.js";
+/**
+ * Normalizes an unknown thrown value into a `FetchError`-shaped object.
+ * Handles `Error` instances, error-like objects, and primitive values.
+ * @example
+ * normalizeError(new Error("oops"))                                      // { status: 500, statusText: "oops", response: "<stack>" }
+ * normalizeError({ status: 404, statusText: "Not Found", response: "" }) // { status: 404, statusText: "Not Found", response: "" }
+ * normalizeError({ status: 403 })                                        // { status: 403, statusText: "", response: "" }
+ * normalizeError("something went wrong")                                 // { status: 500, statusText: "something went wrong", response: "" }
+ * normalizeError(null)                                                   // { status: 500, statusText: "null", response: "" }
+ */
+declare function normalizeError<E = FetchError>(err: unknown): E;
+export default normalizeError;
+//# sourceMappingURL=normalizeError.d.ts.map

package/dist/cjs/types/normalizeError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeError.d.ts","sourceRoot":"","sources":["../../../src/normalizeError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD;;;;;;;;;GASG;AACH,iBAAS,cAAc,CAAC,CAAC,GAAG,UAAU,EAAE,GAAG,EAAE,OAAO,GAAG,CAAC,CAuBvD;AAED,eAAe,cAAc,CAAC"}

package/dist/cjs/types/useInterval.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Sets up a polling interval that calls a callback on a given delay.
+ * The callback ref is kept up to date so stale closures are avoided.
+ * No interval is created if `poll` is not a valid integer.
+ * @see https://github.com/Hermanya/use-interval/blob/master/src/index.tsx
+ * @example
+ * useInterval(() => fetchData(), 5000) // calls fetchData every 5 seconds
+ * useInterval(() => fetchData())       // no interval created
+ */
+declare function useInterval(callback: () => void, poll?: number): void;
+export default useInterval;
+//# sourceMappingURL=useInterval.d.ts.map

package/dist/cjs/types/useInterval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useInterval.d.ts","sourceRoot":"","sources":["../../../src/useInterval.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,iBAAS,WAAW,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAc9D;AAED,eAAe,WAAW,CAAC"}

package/dist/cjs/useInterval.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const react_1 = require("react");
+/**
+ * Sets up a polling interval that calls a callback on a given delay.
+ * The callback ref is kept up to date so stale closures are avoided.
+ * No interval is created if `poll` is not a valid integer.
+ * @see https://github.com/Hermanya/use-interval/blob/master/src/index.tsx
+ * @example
+ * useInterval(() => fetchData(), 5000) // calls fetchData every 5 seconds
+ * useInterval(() => fetchData())       // no interval created
+ */
+function useInterval(callback, poll) {
+    const callbackRef = (0, react_1.useRef)(callback);
+    (0, react_1.useEffect)(() => {
+        callbackRef.current = callback;
+    }, [callback]);
+    (0, react_1.useEffect)(() => {
+        if (!Number.isInteger(poll))
+            return;
+        const id = setInterval(() => callbackRef.current(), poll);
+        return () => clearInterval(id);
+    }, [poll]);
+}
+exports.default = useInterval;
+//# sourceMappingURL=useInterval.js.map

package/dist/cjs/useInterval.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useInterval.js","sourceRoot":"","sources":["../../src/useInterval.ts"],"names":[],"mappings":";;AAAA,iCAA0C;AAE1C;;;;;;;;GAQG;AACH,SAAS,WAAW,CAAC,QAAoB,EAAE,IAAa;IACtD,MAAM,WAAW,GAAG,IAAA,cAAM,EAAa,QAAQ,CAAC,CAAC;IAEjD,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,WAAW,CAAC,OAAO,GAAG,QAAQ,CAAC;IACjC,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEf,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC;YAAE,OAAO;QAEpC,MAAM,EAAE,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,EAAE,IAAI,CAAC,CAAC;QAE1D,OAAO,GAAG,EAAE,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;IACjC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;AACb,CAAC;AAED,kBAAe,WAAW,CAAC"}

package/dist/{index.js → esm/index.js}

@@ -1,6 +1,37 @@
 import { useState, useRef, useCallback, useEffect } from "react";
 import useInterval from "./useInterval.js";
 import normalizeError from "./normalizeError.js";
+/**
+ * A React hook for managing async fetch requests with built-in state, cancellation, and polling.
+ * @example
+ * // Auto-fetch on mount:
+ * const { pending, error, data } = useAsyncFetch<User>("/api/user/1");
+ *
+ * // Manual trigger:
+ * const { pending, error, data, sendRequest } = useAsyncFetch<User>("/api/user/1", { auto: false });
+ * <button onClick={sendRequest}>Fetch</button>
+ *
+ * // With polling:
+ * const { data } = useAsyncFetch<Status>("/api/status", { poll: 5000 });
+ *
+ * // POST with JSON body:
+ * const { pending, error, data } = useAsyncFetch<Response>("/api/submit", {
+ *   method: "POST",
+ *   data: { name: "foo" },
+ * });
+ *
+ * // With callbacks:
+ * useAsyncFetch<User>("/api/user/1", {
+ *   onStart: () => console.log("started"),
+ *   onSuccess: (data) => console.log(data),
+ *   onFail: (error) => console.error(error),
+ *   onFinish: () => console.log("finished"),
+ * });
+ *
+ * // Cancel on demand:
+ * const { cancelRequest } = useAsyncFetch<User>("/api/user/1");
+ * <button onClick={cancelRequest}>Cancel</button>
+ */
 function useAsyncFetch(urlString, props = {}) {
     const { initialPending = false, initialError, initialData, auto = true, poll, timeout = 30000, ignoreRequest, ignoreCleanup, query, params, data: body, parser = "json", onStart, onSuccess, onFail, onFinish, ...fetchOptions } = props;
     const [pending, setPending] = useState(initialPending);
@@ -28,7 +59,9 @@ function useAsyncFetch(urlString, props = {}) {
         const requestId = ++requestIdRef.current;
         try {
             const url = new URL(urlString, window.location.origin);
-            url.search = new URLSearchParams({ ...query, ...params }).toString();
+            if (query ?? params) {
+                url.search = new URLSearchParams({ ...query, ...params }).toString();
+            }
             const headers = new Headers(fetchOptionsRef.current.headers);
             let resolvedBody;
             if (headers.get("content-type") === "application/x-www-form-urlencoded") {
@@ -47,22 +80,24 @@ function useAsyncFetch(urlString, props = {}) {
                 signal: controller.signal,
             });
             if (!response.ok) {
-                throw {
+                throw Object.assign(new Error(response.statusText), {
                     status: response.status,
                     statusText: response.statusText,
                     response: await response.text(),
-                };
+                });
             }
             const parsedResponse = (await response[parser]());
             setData(parsedResponse);
-            onSuccess?.(parsedResponse);
+            if (onSuccess)
+                onSuccess(parsedResponse);
         }
         catch (err) {
-            if (err?.name === "AbortError")
-                return;
-            const normalized = normalizeError(err);
-            setError(normalized);
-            onFail?.(normalized);
+            if (err?.name !== "AbortError") {
+                const normalizedError = normalizeError(err);
+                setError(normalizedError);
+                if (onFail)
+                    onFail(normalizedError);
+            }
         }
         finally {
             clearTimeout(timeoutId);
@@ -87,11 +122,11 @@ function useAsyncFetch(urlString, props = {}) {
         onFinish,
     ]);
     useEffect(() => {
-        if (auto)
-            sendRequest();
+        if (auto === true)
+            void sendRequest();
     }, [auto, sendRequest]);
     useInterval(() => {
-        sendRequest();
+        void sendRequest();
     }, poll);
     useEffect(() => {
         return () => {
@@ -99,12 +134,7 @@ function useAsyncFetch(urlString, props = {}) {
                 cancelRequest();
         };
     }, [ignoreCleanup, cancelRequest]);
-    return {
-        pending,
-        error,
-        data,
-        cancelRequest,
-        sendRequest,
-    };
+    return { pending, error, data, cancelRequest, sendRequest };
 }
 export default useAsyncFetch;
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/dist/esm/interfaces.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=interfaces.js.map

package/dist/esm/interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../../src/interfaces.ts"],"names":[],"mappings":""}

package/dist/esm/normalizeError.js

@@ -0,0 +1,34 @@
+/**
+ * Normalizes an unknown thrown value into a `FetchError`-shaped object.
+ * Handles `Error` instances, error-like objects, and primitive values.
+ * @example
+ * normalizeError(new Error("oops"))                                      // { status: 500, statusText: "oops", response: "<stack>" }
+ * normalizeError({ status: 404, statusText: "Not Found", response: "" }) // { status: 404, statusText: "Not Found", response: "" }
+ * normalizeError({ status: 403 })                                        // { status: 403, statusText: "", response: "" }
+ * normalizeError("something went wrong")                                 // { status: 500, statusText: "something went wrong", response: "" }
+ * normalizeError(null)                                                   // { status: 500, statusText: "null", response: "" }
+ */
+function normalizeError(err) {
+    if (err instanceof Error) {
+        return {
+            status: 500,
+            statusText: err.message,
+            response: err.stack ?? "",
+        };
+    }
+    if (typeof err === "object" && err !== null) {
+        const e = err;
+        return {
+            status: e.status ?? 500,
+            statusText: e.statusText ?? "",
+            response: e.response ?? "",
+        };
+    }
+    return {
+        status: 500,
+        statusText: String(err),
+        response: "",
+    };
+}
+export default normalizeError;
+//# sourceMappingURL=normalizeError.js.map

package/dist/esm/normalizeError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeError.js","sourceRoot":"","sources":["../../src/normalizeError.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,SAAS,cAAc,CAAiB,GAAY;IAClD,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QACzB,OAAO;YACL,MAAM,EAAE,GAAG;YACX,UAAU,EAAE,GAAG,CAAC,OAAO;YACvB,QAAQ,EAAE,GAAG,CAAC,KAAK,IAAI,EAAE;SACrB,CAAC;IACT,CAAC;IAED,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QAC5C,MAAM,CAAC,GAAG,GAA0B,CAAC;QACrC,OAAO;YACL,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,GAAG;YACvB,UAAU,EAAE,CAAC,CAAC,UAAU,IAAI,EAAE;YAC9B,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,EAAE;SACtB,CAAC;IACT,CAAC;IAED,OAAO;QACL,MAAM,EAAE,GAAG;QACX,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC;QACvB,QAAQ,EAAE,EAAE;KACR,CAAC;AACT,CAAC;AAED,eAAe,cAAc,CAAC"}

package/dist/esm/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "module"
+}

package/dist/esm/types/index.d.ts

@@ -0,0 +1,35 @@
+import { type FetchError, type RequestProps, type ResponseProps } from "./interfaces.js";
+/**
+ * A React hook for managing async fetch requests with built-in state, cancellation, and polling.
+ * @example
+ * // Auto-fetch on mount:
+ * const { pending, error, data } = useAsyncFetch<User>("/api/user/1");
+ *
+ * // Manual trigger:
+ * const { pending, error, data, sendRequest } = useAsyncFetch<User>("/api/user/1", { auto: false });
+ * <button onClick={sendRequest}>Fetch</button>
+ *
+ * // With polling:
+ * const { data } = useAsyncFetch<Status>("/api/status", { poll: 5000 });
+ *
+ * // POST with JSON body:
+ * const { pending, error, data } = useAsyncFetch<Response>("/api/submit", {
+ *   method: "POST",
+ *   data: { name: "foo" },
+ * });
+ *
+ * // With callbacks:
+ * useAsyncFetch<User>("/api/user/1", {
+ *   onStart: () => console.log("started"),
+ *   onSuccess: (data) => console.log(data),
+ *   onFail: (error) => console.error(error),
+ *   onFinish: () => console.log("finished"),
+ * });
+ *
+ * // Cancel on demand:
+ * const { cancelRequest } = useAsyncFetch<User>("/api/user/1");
+ * <button onClick={cancelRequest}>Cancel</button>
+ */
+declare function useAsyncFetch<T = unknown, E = FetchError>(urlString: string, props?: RequestProps<T, E>): ResponseProps<T, E>;
+export default useAsyncFetch;
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,aAAa,EACnB,MAAM,iBAAiB,CAAC;AAKzB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,iBAAS,aAAa,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,UAAU,EAChD,SAAS,EAAE,MAAM,EACjB,KAAK,GAAE,YAAY,CAAC,CAAC,EAAE,CAAC,CAAM,GAC7B,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CA+IrB;AAED,eAAe,aAAa,CAAC"}

package/dist/esm/types/interfaces.d.ts

@@ -0,0 +1,31 @@
+export interface FetchError {
+    status: number;
+    statusText: string;
+    response: string;
+}
+export interface RequestProps<T, E> extends RequestInit {
+    initialPending?: boolean;
+    initialError?: E;
+    initialData?: T;
+    auto?: boolean;
+    poll?: number;
+    timeout?: number;
+    ignoreRequest?: boolean;
+    ignoreCleanup?: boolean;
+    query?: Record<string, string>;
+    params?: Record<string, string>;
+    data?: unknown;
+    parser?: "json" | "text" | "blob" | "formData" | "arrayBuffer";
+    onStart?: () => void;
+    onSuccess?: (data: T) => void;
+    onFail?: (error: E) => void;
+    onFinish?: () => void;
+}
+export interface ResponseProps<T, E> {
+    pending: boolean;
+    error?: E;
+    data?: T;
+    sendRequest: () => Promise<void>;
+    cancelRequest: () => void;
+}
+//# sourceMappingURL=interfaces.d.ts.map

package/dist/esm/types/interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../../src/interfaces.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY,CAAC,CAAC,EAAE,CAAC,CAAE,SAAQ,WAAW;IACrD,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,CAAC,CAAC;IACjB,WAAW,CAAC,EAAE,CAAC,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,aAAa,CAAC;IAC/D,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;IAC9B,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,aAAa,CAAC,CAAC,EAAE,CAAC;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,CAAC,CAAC;IACV,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,aAAa,EAAE,MAAM,IAAI,CAAC;CAC3B"}

package/dist/esm/types/normalizeError.d.ts

@@ -0,0 +1,14 @@
+import { type FetchError } from "./interfaces.js";
+/**
+ * Normalizes an unknown thrown value into a `FetchError`-shaped object.
+ * Handles `Error` instances, error-like objects, and primitive values.
+ * @example
+ * normalizeError(new Error("oops"))                                      // { status: 500, statusText: "oops", response: "<stack>" }
+ * normalizeError({ status: 404, statusText: "Not Found", response: "" }) // { status: 404, statusText: "Not Found", response: "" }
+ * normalizeError({ status: 403 })                                        // { status: 403, statusText: "", response: "" }
+ * normalizeError("something went wrong")                                 // { status: 500, statusText: "something went wrong", response: "" }
+ * normalizeError(null)                                                   // { status: 500, statusText: "null", response: "" }
+ */
+declare function normalizeError<E = FetchError>(err: unknown): E;
+export default normalizeError;
+//# sourceMappingURL=normalizeError.d.ts.map

package/dist/esm/types/normalizeError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeError.d.ts","sourceRoot":"","sources":["../../../src/normalizeError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD;;;;;;;;;GASG;AACH,iBAAS,cAAc,CAAC,CAAC,GAAG,UAAU,EAAE,GAAG,EAAE,OAAO,GAAG,CAAC,CAuBvD;AAED,eAAe,cAAc,CAAC"}

package/dist/esm/types/useInterval.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Sets up a polling interval that calls a callback on a given delay.
+ * The callback ref is kept up to date so stale closures are avoided.
+ * No interval is created if `poll` is not a valid integer.
+ * @see https://github.com/Hermanya/use-interval/blob/master/src/index.tsx
+ * @example
+ * useInterval(() => fetchData(), 5000) // calls fetchData every 5 seconds
+ * useInterval(() => fetchData())       // no interval created
+ */
+declare function useInterval(callback: () => void, poll?: number): void;
+export default useInterval;
+//# sourceMappingURL=useInterval.d.ts.map

package/dist/esm/types/useInterval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useInterval.d.ts","sourceRoot":"","sources":["../../../src/useInterval.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,iBAAS,WAAW,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAc9D;AAED,eAAe,WAAW,CAAC"}

package/dist/esm/useInterval.js

@@ -0,0 +1,24 @@
+import { useRef, useEffect } from "react";
+/**
+ * Sets up a polling interval that calls a callback on a given delay.
+ * The callback ref is kept up to date so stale closures are avoided.
+ * No interval is created if `poll` is not a valid integer.
+ * @see https://github.com/Hermanya/use-interval/blob/master/src/index.tsx
+ * @example
+ * useInterval(() => fetchData(), 5000) // calls fetchData every 5 seconds
+ * useInterval(() => fetchData())       // no interval created
+ */
+function useInterval(callback, poll) {
+    const callbackRef = useRef(callback);
+    useEffect(() => {
+        callbackRef.current = callback;
+    }, [callback]);
+    useEffect(() => {
+        if (!Number.isInteger(poll))
+            return;
+        const id = setInterval(() => callbackRef.current(), poll);
+        return () => clearInterval(id);
+    }, [poll]);
+}
+export default useInterval;
+//# sourceMappingURL=useInterval.js.map

package/dist/esm/useInterval.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useInterval.js","sourceRoot":"","sources":["../../src/useInterval.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAE1C;;;;;;;;GAQG;AACH,SAAS,WAAW,CAAC,QAAoB,EAAE,IAAa;IACtD,MAAM,WAAW,GAAG,MAAM,CAAa,QAAQ,CAAC,CAAC;IAEjD,SAAS,CAAC,GAAG,EAAE;QACb,WAAW,CAAC,OAAO,GAAG,QAAQ,CAAC;IACjC,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEf,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC;YAAE,OAAO;QAEpC,MAAM,EAAE,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,EAAE,IAAI,CAAC,CAAC;QAE1D,OAAO,GAAG,EAAE,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;IACjC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;AACb,CAAC;AAED,eAAe,WAAW,CAAC"}

package/package.json

@@ -1,35 +1,70 @@
 {
   "name": "async-fetch",
-  "version": "0.3.8",
-  "description": "Use async fetch hook for requests within React components.",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "type": "module",
-  "scripts": {
-    "build": "npx rimraf dist && tsc",
-    "test-esm": "yarn build && node test/test-esm.mjs"
-  },
+  "packageManager": "yarn@4.13.0",
+  "version": "0.4.0",
+  "description": "A React hook for async fetch requests.",
+  "author": "Nameer Rizvi (https://github.com/nameer-rizvi)",
+  "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/nameer-rizvi/useAsyncFetch.git"
+    "url": "git+https://github.com/nameer-rizvi/async-fetch.git"
+  },
+  "homepage": "https://github.com/nameer-rizvi/async-fetch#readme",
+  "bugs": {
+    "url": "https://github.com/nameer-rizvi/async-fetch/issues"
   },
   "keywords": [
-    "react",
-    "hooks",
-    "fetch",
-    "async"
+    "typescript",
+    "utils",
+    "utilities",
+    "esm",
+    "cjs"
   ],
-  "author": "Nameer Rizvi (https://github.com/nameer-rizvi)",
-  "license": "ISC",
-  "bugs": {
-    "url": "https://github.com/nameer-rizvi/useAsyncFetch/issues"
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/cjs/types/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/esm/types/index.d.ts",
+        "default": "./dist/esm/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/types/index.d.ts",
+        "default": "./dist/cjs/index.js"
+      }
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "update": "yarn && node scripts/updateDeps.js",
+    "clean": "rimraf dist",
+    "lint": "eslint src/**/*",
+    "lint:fix": "eslint src/**/* --fix",
+    "build:cjs": "tsc -p tsconfig.cjs.json",
+    "build:esm": "tsc -p tsconfig.esm.json",
+    "build": "yarn clean && yarn lint && yarn build:cjs && yarn build:esm && node scripts/postbuild.mjs && echo '✅ Build complete! CJS and ESM outputs ready in dist/'",
+    "test:cjs": "node tests/test.cjs",
+    "test:esm": "node tests/test.mjs",
+    "test": "yarn build && yarn test:cjs && yarn test:esm",
+    "prepublishOnly": "yarn build"
   },
-  "homepage": "https://github.com/nameer-rizvi/useAsyncFetch#readme",
   "devDependencies": {
-    "@types/node": "^25.0.3",
-    "@types/react": "^19.2.7",
-    "react": "^19.2.3",
-    "ts-node": "^10.9.2",
-    "typescript": "^5.9.3"
+    "@eslint/js": "^10.0.1",
+    "@types/react": "^19.2.14",
+    "eslint": "^10.2.0",
+    "react": "^19.2.5",
+    "rimraf": "^6.1.3",
+    "typescript": "^6.0.2",
+    "typescript-eslint": "^8.58.0"
+  },
+  "peerDependencies": {
+    "react": ">=16"
   }
 }

package/dist/index.d.ts

@@ -1,3 +0,0 @@
-import { FetchError, RequestProps, ResponseProps } from "./interfaces";
-declare function useAsyncFetch<T = any, E = FetchError>(urlString: string, props?: RequestProps<T, E>): ResponseProps<T, E>;
-export default useAsyncFetch;

package/dist/interfaces.js

@@ -1 +0,0 @@
-export {};

package/dist/normalizeError.d.ts

@@ -1,3 +0,0 @@
-import { FetchError } from "./interfaces";
-declare function normalizeError<E = FetchError>(err: unknown): E;
-export default normalizeError;

package/dist/normalizeError.js

@@ -1,22 +0,0 @@
-function normalizeError(err) {
-    if (err instanceof Error) {
-        return {
-            status: 500,
-            statusText: err.message,
-            response: err.stack ?? "",
-        };
-    }
-    if (typeof err === "object" && err !== null) {
-        return {
-            status: err.status ?? 500,
-            statusText: err.statusText ?? "",
-            response: err.response ?? "",
-        };
-    }
-    return {
-        status: 500,
-        statusText: String(err),
-        response: "",
-    };
-}
-export default normalizeError;

package/dist/useInterval.d.ts

@@ -1,2 +0,0 @@
-declare function useInterval(callback: () => void, poll?: number): void;
-export default useInterval;

package/dist/useInterval.js

@@ -1,17 +0,0 @@
-import { useRef, useEffect } from "react";
-function useInterval(callback, poll) {
-    const callbackRef = useRef(() => { });
-    useEffect(() => {
-        callbackRef.current = callback;
-    }, [callback]);
-    useEffect(() => {
-        if (!Number.isInteger(poll))
-            return;
-        const id = setInterval(() => {
-            callbackRef.current?.();
-        }, poll);
-        return () => clearInterval(id);
-    }, [poll]);
-}
-export default useInterval;
-// https://github.com/Hermanya/use-interval/blob/master/src/index.tsx

package/tsconfig.json

@@ -1,112 +0,0 @@
-{
-  "compilerOptions": {
-    /* Visit https://aka.ms/tsconfig to read more about this file */
-
-    /* Projects */
-    // "incremental": true,                              /* Save .tsbuildinfo files to allow for incremental compilation of projects. */
-    // "composite": true,                                /* Enable constraints that allow a TypeScript project to be used with project references. */
-    // "tsBuildInfoFile": "./.tsbuildinfo",              /* Specify the path to .tsbuildinfo incremental compilation file. */
-    // "disableSourceOfProjectReferenceRedirect": true,  /* Disable preferring source files instead of declaration files when referencing composite projects. */
-    // "disableSolutionSearching": true,                 /* Opt a project out of multi-project reference checking when editing. */
-    // "disableReferencedProjectLoad": true,             /* Reduce the number of projects loaded automatically by TypeScript. */
-
-    /* Language and Environment */
-    "target": "ESNext" /* Set the JavaScript language version for emitted JavaScript and include compatible library declarations. */,
-    // "lib": [],                                        /* Specify a set of bundled library declaration files that describe the target runtime environment. */
-    "jsx": "react-jsx" /* Specify what JSX code is generated. */,
-    // "experimentalDecorators": true,                   /* Enable experimental support for legacy experimental decorators. */
-    // "emitDecoratorMetadata": true,                    /* Emit design-type metadata for decorated declarations in source files. */
-    // "jsxFactory": "",                                 /* Specify the JSX factory function used when targeting React JSX emit, e.g. 'React.createElement' or 'h'. */
-    // "jsxFragmentFactory": "",                         /* Specify the JSX Fragment reference used for fragments when targeting React JSX emit e.g. 'React.Fragment' or 'Fragment'. */
-    // "jsxImportSource": "",                            /* Specify module specifier used to import the JSX factory functions when using 'jsx: react-jsx*'. */
-    // "reactNamespace": "",                             /* Specify the object invoked for 'createElement'. This only applies when targeting 'react' JSX emit. */
-    // "noLib": true,                                    /* Disable including any library files, including the default lib.d.ts. */
-    // "useDefineForClassFields": true,                  /* Emit ECMAScript-standard-compliant class fields. */
-    // "moduleDetection": "auto",                        /* Control what method is used to detect module-format JS files. */
-
-    /* Modules */
-    "module": "ESNext" /* Specify what module code is generated. */,
-    // "rootDir": "./",                                  /* Specify the root folder within your source files. */
-    "moduleResolution": "node" /* Specify how TypeScript looks up a file from a given module specifier. */,
-    // "baseUrl": "./",                                  /* Specify the base directory to resolve non-relative module names. */
-    // "paths": {},                                      /* Specify a set of entries that re-map imports to additional lookup locations. */
-    // "rootDirs": [],                                   /* Allow multiple folders to be treated as one when resolving modules. */
-    // "typeRoots": [],                                  /* Specify multiple folders that act like './node_modules/@types'. */
-    // "types": [],                                      /* Specify type package names to be included without being referenced in a source file. */
-    // "allowUmdGlobalAccess": true,                     /* Allow accessing UMD globals from modules. */
-    // "moduleSuffixes": [],                             /* List of file name suffixes to search when resolving a module. */
-    // "allowImportingTsExtensions": true,               /* Allow imports to include TypeScript file extensions. Requires '--moduleResolution bundler' and either '--noEmit' or '--emitDeclarationOnly' to be set. */
-    // "resolvePackageJsonExports": true,                /* Use the package.json 'exports' field when resolving package imports. */
-    // "resolvePackageJsonImports": true,                /* Use the package.json 'imports' field when resolving imports. */
-    // "customConditions": [],                           /* Conditions to set in addition to the resolver-specific defaults when resolving imports. */
-    // "noUncheckedSideEffectImports": true,             /* Check side effect imports. */
-    // "resolveJsonModule": true,                        /* Enable importing .json files. */
-    // "allowArbitraryExtensions": true,                 /* Enable importing files with any extension, provided a declaration file is present. */
-    // "noResolve": true,                                /* Disallow 'import's, 'require's or '<reference>'s from expanding the number of files TypeScript should add to a project. */
-
-    /* JavaScript Support */
-    // "allowJs": true,                                  /* Allow JavaScript files to be a part of your program. Use the 'checkJS' option to get errors from these files. */
-    // "checkJs": true,                                  /* Enable error reporting in type-checked JavaScript files. */
-    // "maxNodeModuleJsDepth": 1,                        /* Specify the maximum folder depth used for checking JavaScript files from 'node_modules'. Only applicable with 'allowJs'. */
-
-    /* Emit */
-    "declaration": true /* Generate .d.ts files from TypeScript and JavaScript files in your project. */,
-    // "declarationMap": true,                           /* Create sourcemaps for d.ts files. */
-    // "emitDeclarationOnly": true,                      /* Only output d.ts files and not JavaScript files. */
-    // "sourceMap": true,                                /* Create source map files for emitted JavaScript files. */
-    // "inlineSourceMap": true,                          /* Include sourcemap files inside the emitted JavaScript. */
-    // "noEmit": true,                                   /* Disable emitting files from a compilation. */
-    // "outFile": "./",                                  /* Specify a file that bundles all outputs into one JavaScript file. If 'declaration' is true, also designates a file that bundles all .d.ts output. */
-    "outDir": "./dist" /* Specify an output folder for all emitted files. */,
-    // "removeComments": true,                           /* Disable emitting comments. */
-    // "importHelpers": true,                            /* Allow importing helper functions from tslib once per project, instead of including them per-file. */
-    // "downlevelIteration": true,                       /* Emit more compliant, but verbose and less performant JavaScript for iteration. */
-    // "sourceRoot": "",                                 /* Specify the root path for debuggers to find the reference source code. */
-    // "mapRoot": "",                                    /* Specify the location where debugger should locate map files instead of generated locations. */
-    // "inlineSources": true,                            /* Include source code in the sourcemaps inside the emitted JavaScript. */
-    // "emitBOM": true,                                  /* Emit a UTF-8 Byte Order Mark (BOM) in the beginning of output files. */
-    // "newLine": "crlf",                                /* Set the newline character for emitting files. */
-    // "stripInternal": true,                            /* Disable emitting declarations that have '@internal' in their JSDoc comments. */
-    // "noEmitHelpers": true,                            /* Disable generating custom helper functions like '__extends' in compiled output. */
-    // "noEmitOnError": true,                            /* Disable emitting files if any type checking errors are reported. */
-    // "preserveConstEnums": true,                       /* Disable erasing 'const enum' declarations in generated code. */
-    // "declarationDir": "./",                           /* Specify the output directory for generated declaration files. */
-
-    /* Interop Constraints */
-    // "isolatedModules": true,                          /* Ensure that each file can be safely transpiled without relying on other imports. */
-    // "verbatimModuleSyntax": true,                     /* Do not transform or elide any imports or exports not marked as type-only, ensuring they are written in the output file's format based on the 'module' setting. */
-    // "isolatedDeclarations": true,                     /* Require sufficient annotation on exports so other tools can trivially generate declaration files. */
-    // "allowSyntheticDefaultImports": true,             /* Allow 'import x from y' when a module doesn't have a default export. */
-    "esModuleInterop": true /* Emit additional JavaScript to ease support for importing CommonJS modules. This enables 'allowSyntheticDefaultImports' for type compatibility. */,
-    // "preserveSymlinks": true,                         /* Disable resolving symlinks to their realpath. This correlates to the same flag in node. */
-    "forceConsistentCasingInFileNames": true /* Ensure that casing is correct in imports. */,
-
-    /* Type Checking */
-    "strict": true /* Enable all strict type-checking options. */,
-    // "noImplicitAny": true,                            /* Enable error reporting for expressions and declarations with an implied 'any' type. */
-    // "strictNullChecks": true,                         /* When type checking, take into account 'null' and 'undefined'. */
-    // "strictFunctionTypes": true,                      /* When assigning functions, check to ensure parameters and the return values are subtype-compatible. */
-    // "strictBindCallApply": true,                      /* Check that the arguments for 'bind', 'call', and 'apply' methods match the original function. */
-    // "strictPropertyInitialization": true,             /* Check for class properties that are declared but not set in the constructor. */
-    // "strictBuiltinIteratorReturn": true,              /* Built-in iterators are instantiated with a 'TReturn' type of 'undefined' instead of 'any'. */
-    // "noImplicitThis": true,                           /* Enable error reporting when 'this' is given the type 'any'. */
-    // "useUnknownInCatchVariables": true,               /* Default catch clause variables as 'unknown' instead of 'any'. */
-    // "alwaysStrict": true,                             /* Ensure 'use strict' is always emitted. */
-    // "noUnusedLocals": true,                           /* Enable error reporting when local variables aren't read. */
-    // "noUnusedParameters": true,                       /* Raise an error when a function parameter isn't read. */
-    // "exactOptionalPropertyTypes": true,               /* Interpret optional property types as written, rather than adding 'undefined'. */
-    // "noImplicitReturns": true,                        /* Enable error reporting for codepaths that do not explicitly return in a function. */
-    // "noFallthroughCasesInSwitch": true,               /* Enable error reporting for fallthrough cases in switch statements. */
-    // "noUncheckedIndexedAccess": true,                 /* Add 'undefined' to a type when accessed using an index. */
-    // "noImplicitOverride": true,                       /* Ensure overriding members in derived classes are marked with an override modifier. */
-    // "noPropertyAccessFromIndexSignature": true,       /* Enforces using indexed accessors for keys declared using an indexed type. */
-    // "allowUnusedLabels": true,                        /* Disable error reporting for unused labels. */
-    // "allowUnreachableCode": true,                     /* Disable error reporting for unreachable code. */
-
-    /* Completeness */
-    // "skipDefaultLibCheck": true,                      /* Skip type checking .d.ts files that are included with TypeScript. */
-    "skipLibCheck": true /* Skip type checking all .d.ts files. */
-  },
-  "include": ["src/**/*"], // Include all files in the src folder
-  "exclude": ["node_modules", "dist"] // Exclude node_modules and dist from the build
-}