async-fetch 0.3.7 → 0.3.9

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.                                                                         |         |
-| initialData    | Any      | Initial state for the data constant.                                                                            |         |
-| initialError   | Any      | Initial state for the error constant.                                                                           |         |
-| deps           | Array    | List of dependencies to run the request on.                                                                     |         |
-| poll           | Number   | Number of milliseconds to wait for polling requests.                                                            |         |
-| timeout        | Number   | Number of milliseconds to wait before canceling the request.                                                    | 30000   |
-| ignoreCleanup  | Boolean  | Whether or not the hook should cleanup on component unmount.                                                    |         |
-| ignoreRequest  | Boolean  | Whether or not the request should send.                                                                         |         |
-| 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           | Object   | JSON object to send in the request body.                                                                        |         |
-| parser         | String   | Method used to parse the response.                                                                              | "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         | Any      | The response error.                      |
-| data          | 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/cjs/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/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"}