react-visibility-hooks 1.0.11 → 2.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Aniket Raj
+
+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,23 @@
 # react-visibility-hooks
 
-> Tiny, SSR-safe React hooks for page visibility, idle detection and smart polling
+> Tiny, SSR-safe React hooks for page visibility, idle detection, smart polling and auto-pause video
 
 [![npm version](https://img.shields.io/npm/v/react-visibility-hooks.svg)](https://www.npmjs.com/package/react-visibility-hooks)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Bundle Size](https://img.shields.io/bundlephobia/minzip/react-visibility-hooks)](https://bundlephobia.com/package/react-visibility-hooks)
+[![CI](https://github.com/exewhyz/react-visibility-hooks/actions/workflows/ci.yml/badge.svg)](https://github.com/exewhyz/react-visibility-hooks/actions/workflows/ci.yml)
 
-A collection of lightweight React hooks that help you build performance-conscious applications by detecting page visibility, user idle state, and managing smart polling strategies.
+A collection of lightweight React hooks that help you build performance-conscious applications by detecting page visibility, user idle state, auto-pausing video, and managing smart polling strategies.
 
 ## Features
 
-- 🪶 **Lightweight** - Zero dependencies (except peer dependencies)
-- 🔒 **SSR-safe** - Works seamlessly with Next.js, Remix, and other SSR frameworks
+- 🪶 **Lightweight** - ~822 B brotlied, zero dependencies
+- 🔒 **SSR-safe** - Works seamlessly with Next.js (App Router & Pages Router), Remix, and other SSR frameworks
 - 📦 **Tree-shakeable** - Import only what you need
-- 🎯 **TypeScript** - Fully typed with TypeScript
+- 🎯 **TypeScript** - Fully typed with exported interfaces
 - ⚡ **Performance-focused** - Pause expensive operations when users aren't looking
+- 🎬 **Auto-pause video** - Pause/resume `<video>` elements on tab visibility
+- 🔄 **Smart polling** - Visibility-aware data fetching with dedup
 
 ## Installation
 
@@ -28,6 +32,7 @@ npm install react-visibility-hooks
 Detect when the browser tab is visible or hidden using the [Page Visibility API](https://developer.mozilla.org/en-US/docs/Web/API/Page_Visibility_API).
 
 **Use cases:**
+
 - Pause animations when tab is hidden
 - Stop fetching data when user isn't viewing the page
 - Save battery and resources
@@ -48,9 +53,10 @@ function MyComponent() {
 
 ### `useIdleVisibility`
 
-Detect when the user is idle (no mouse movement or keyboard activity) combined with page visibility state.
+Detect when the user is idle (no mouse, keyboard, pointer, scroll, or touch activity) combined with page visibility state.
 
 **Use cases:**
+
 - Show "Are you still there?" prompts
 - Auto-pause media after inactivity
 - Reduce background activity when user is away
@@ -71,13 +77,15 @@ function MyComponent() {
 ```
 
 **Parameters:**
+
 - `timeout` (optional): Milliseconds of inactivity before user is considered idle (default: 60000)
 
 ### `useAutoPauseVideo`
 
-Automatically pause and resume videos based on page visibility.
+Automatically pause and resume videos based on page visibility. Only resumes playback if the video was actually playing before the tab was hidden — it won't override a user's manual pause.
 
 **Use cases:**
+
 - Auto-pause videos when user switches tabs
 - Better UX for video-heavy applications
 - Save bandwidth and resources
@@ -101,6 +109,7 @@ function VideoPlayer() {
 Visibility-aware polling built with plain React — no external dependencies. Automatically pauses when the tab is hidden, resumes when visible, and skips re-renders when data hasn't changed.
 
 **Use cases:**
+
 - Real-time dashboards
 - Live notifications
 - Auto-refresh data feeds
@@ -142,9 +151,10 @@ function Dashboard() {
 | `isLoading` | `boolean` | `true` until the first fetch completes |
 | `isError` | `boolean` | `true` if the last fetch threw |
 | `error` | `Error \| undefined` | The error object, if any |
-| `refetch` | `() => void` | Manually trigger a fetch |
+| `refetch` | `() => Promise<void>` | Manually trigger a fetch |
 
 **Optimizations:**
+
 - Skips re-renders when polled data is identical to the previous result
 - Prevents concurrent fetches from overlapping
 - Polling pauses automatically when the tab is hidden and resumes when visible
@@ -152,6 +162,7 @@ function Dashboard() {
 ## SSR Support
 
 All hooks are SSR-safe and will work correctly with:
+
 - Next.js (App Router & Pages Router)
 - Remix
 - Gatsby
@@ -166,8 +177,9 @@ This package is written in TypeScript and includes type definitions out of the b
 ## Browser Support
 
 Works in all modern browsers that support:
+
 - [Page Visibility API](https://caniuse.com/pagevisibility)
-- React 18+
+- React >=16.8.0 (hooks)
 
 ## Examples
 
@@ -215,7 +227,7 @@ function IdleWarning() {
 
 ## Contributing
 
-Contributions are welcome! Please feel free to submit a Pull Request.
+Contributions are welcome! Please read our [Contributing Guide](CONTRIBUTING.md) before submitting a Pull Request.
 
 ## License
 
@@ -226,3 +238,4 @@ MIT © [Aniket Raj](https://github.com/exewhyz)
 - [GitHub Repository](https://github.com/exewhyz/react-visibility-hooks)
 - [Issue Tracker](https://github.com/exewhyz/react-visibility-hooks/issues)
 - [NPM Package](https://www.npmjs.com/package/react-visibility-hooks)
+- [Changelog](CHANGELOG.md)

package/dist/index.cjs

@@ -1,2 +1,2 @@
-"use strict";var v=Object.defineProperty;var x=Object.getOwnPropertyDescriptor;var V=Object.getOwnPropertyNames;var I=Object.prototype.hasOwnProperty;var P=(t,e)=>{for(var r in e)v(t,r,{get:e[r],enumerable:!0})},D=(t,e,r,s)=>{if(e&&typeof e=="object"||typeof e=="function")for(let i of V(e))!I.call(t,i)&&i!==r&&v(t,i,{get:()=>e[i],enumerable:!(s=x(e,i))||s.enumerable});return t};var O=t=>D(v({},"__esModule",{value:!0}),t);var A={};P(A,{useAutoPauseVideo:()=>j,useDocVisible:()=>c,useIdleVisibility:()=>k,useSmartPolling:()=>J});module.exports=O(A);var f=require("react");function c(){let[t,e]=(0,f.useState)(typeof document=="undefined"||document.visibilityState==="visible");return(0,f.useEffect)(()=>{if(typeof document=="undefined")return;let r=()=>e(document.visibilityState==="visible");return document.addEventListener("visibilitychange",r),()=>document.removeEventListener("visibilitychange",r)},[]),t}var l=require("react");function k(t=6e4){let e=c(),[r,s]=(0,l.useState)(!1);return(0,l.useEffect)(()=>{let i,u=()=>{s(!1),clearTimeout(i),i=setTimeout(()=>s(!0),t)};return window.addEventListener("mousemove",u),window.addEventListener("keydown",u),u(),()=>{window.removeEventListener("mousemove",u),window.removeEventListener("keydown",u),clearTimeout(i)}},[t]),{visible:e,idle:r}}var R=require("react");function j(t){let e=c();(0,R.useEffect)(()=>{let r=t.current;r&&(e?r.play().catch(()=>{}):r.pause())},[e,t])}var n=require("react");function J(t,e){let{interval:r=5e3,enabled:s=!0}=e!=null?e:{},i=c(),[u,T]=(0,n.useState)(void 0),[h,L]=(0,n.useState)(!0),[b,y]=(0,n.useState)(void 0),E=(0,n.useRef)(t),d=(0,n.useRef)(void 0),m=(0,n.useRef)(!1),p=(0,n.useRef)(void 0);E.current=t;let a=(0,n.useCallback)(async()=>{if(!m.current){m.current=!0;try{let o=await E.current(),w=JSON.stringify(o);w!==p.current&&(p.current=w,T(o)),y(S=>S!==void 0?void 0:S)}catch(o){y(o instanceof Error?o:new Error(String(o)))}finally{m.current=!1,L(o=>o&&!1)}}},[]),g=(0,n.useRef)(!1);return(0,n.useEffect)(()=>{g.current||(g.current=!0,a())},[a]),(0,n.useEffect)(()=>{if(!s||!i){clearInterval(d.current);return}return d.current=setInterval(a,r),()=>clearInterval(d.current)},[i,s,r,a]),{data:u,isLoading:h,isError:!!b,error:b,refetch:a}}0&&(module.exports={useAutoPauseVideo,useDocVisible,useIdleVisibility,useSmartPolling});
+'use strict';var react=require('react');function u(){let[r,e]=react.useState(()=>typeof document=="undefined"?true:document.visibilityState==="visible"),t=react.useCallback(()=>{e(document.visibilityState==="visible");},[]);return react.useEffect(()=>{if(typeof document!="undefined")return t(),document.addEventListener("visibilitychange",t),()=>document.removeEventListener("visibilitychange",t)},[t]),r}function O(r=6e4){let e=u(),[t,n]=react.useState(false),s=react.useRef(void 0),o=react.useCallback(()=>{n(false),clearTimeout(s.current),s.current=setTimeout(()=>n(true),r);},[r]);return react.useEffect(()=>{if(typeof window=="undefined")return;let m=["mousemove","keydown","pointerdown","scroll","touchstart"];return m.forEach(f=>window.addEventListener(f,o,{passive:true})),o(),()=>{m.forEach(f=>window.removeEventListener(f,o)),clearTimeout(s.current);}},[o]),react.useEffect(()=>{e&&o();},[e,o]),{visible:e,idle:t}}function j(r){let e=u(),t=react.useRef(false);react.useEffect(()=>{let n=r.current;n&&(!e&&!n.paused?(n.pause(),t.current=true):e&&t.current&&(n.play().catch(()=>{}),t.current=false));},[e,r]);}function M(r,e){let{interval:t=5e3,enabled:n=true}=e!=null?e:{},s=u(),[o,m]=react.useState(void 0),[f,h]=react.useState(true),[y,R]=react.useState(void 0),E=react.useRef(r),a=react.useRef(void 0),b=react.useRef(false),g=react.useRef(void 0),d=react.useRef(true);E.current=r,react.useEffect(()=>(d.current=true,()=>{d.current=false;}),[]);let l=react.useCallback(async()=>{if(!b.current){b.current=true;try{let i=await E.current();if(!d.current)return;let V=JSON.stringify(i);V!==g.current&&(g.current=V,m(i)),R(x=>x!==void 0?void 0:x);}catch(i){if(!d.current)return;R(i instanceof Error?i:new Error(String(i)));}finally{b.current=false,d.current&&h(i=>i&&false);}}},[]),S=react.useRef(false);return react.useEffect(()=>{S.current||(S.current=true,l());},[l]),react.useEffect(()=>{if(!n||!s){clearInterval(a.current),a.current=void 0;return}return l(),a.current=setInterval(l,t),()=>{clearInterval(a.current),a.current=void 0;}},[s,n,t,l]),{data:o,isLoading:f,isError:y!==void 0,error:y,refetch:l}}exports.useAutoPauseVideo=j;exports.useDocVisible=u;exports.useIdleVisibility=O;exports.useSmartPolling=M;//# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/useDocVisible.ts","../src/useIdleVisibility.ts","../src/useAutoPauseVideo.ts","../src/useSmartPolling.ts"],"sourcesContent":["export * from \"./useDocVisible\";\nexport * from \"./useIdleVisibility\";\nexport * from \"./useAutoPauseVideo\";\nexport * from \"./useSmartPolling\";\n","import { useEffect, useState } from \"react\";\n\nexport function useDocVisible(): boolean {\n  const [visible, setVisible] = useState(\n    typeof document === \"undefined\" || document.visibilityState === \"visible\"\n  );\n\n  useEffect(() => {\n    if (typeof document === \"undefined\") return;\n    const handler = () => setVisible(document.visibilityState === \"visible\");\n    document.addEventListener(\"visibilitychange\", handler);\n    return () => document.removeEventListener(\"visibilitychange\", handler);\n  }, []);\n\n  return visible;\n}\n","import { useEffect, useState } from \"react\";\nimport { useDocVisible } from \"./useDocVisible\";\n\nexport function useIdleVisibility(timeout = 60000) {\n  const visible = useDocVisible();\n  const [idle, setIdle] = useState(false);\n\n  useEffect(() => {\n    let timer: any;\n\n    const reset = () => {\n      setIdle(false);\n      clearTimeout(timer);\n      timer = setTimeout(() => setIdle(true), timeout);\n    };\n\n    window.addEventListener(\"mousemove\", reset);\n    window.addEventListener(\"keydown\", reset);\n    reset();\n\n    return () => {\n      window.removeEventListener(\"mousemove\", reset);\n      window.removeEventListener(\"keydown\", reset);\n      clearTimeout(timer);\n    };\n  }, [timeout]);\n\n  return { visible, idle };\n}\n","import { useEffect } from \"react\";\nimport { useDocVisible } from \"./useDocVisible\";\n\nexport function useAutoPauseVideo(ref: React.RefObject<HTMLVideoElement>) {\n  const visible = useDocVisible();\n\n  useEffect(() => {\n    const video = ref.current;\n    if (!video) return;\n\n    if (!visible) video.pause();\n    else video.play().catch(() => {});\n  }, [visible, ref]);\n}\n","import { useState, useEffect, useRef, useCallback } from \"react\";\nimport { useDocVisible } from \"./useDocVisible\";\n\ninterface SmartPollingOptions {\n  interval?: number;\n  enabled?: boolean;\n}\n\ninterface SmartPollingResult<T> {\n  data: T | undefined;\n  isLoading: boolean;\n  isError: boolean;\n  error: Error | undefined;\n  refetch: () => void;\n}\n\nexport function useSmartPolling<T = any>(\n  fetchFn: () => Promise<T>,\n  options?: SmartPollingOptions,\n): SmartPollingResult<T> {\n  const { interval = 5000, enabled = true } = options ?? {};\n  const visible = useDocVisible();\n  const [data, setData] = useState<T | undefined>(undefined);\n  const [isLoading, setIsLoading] = useState(true);\n  const [error, setError] = useState<Error | undefined>(undefined);\n  const fetchRef = useRef(fetchFn);\n  const timerRef = useRef<ReturnType<typeof setInterval> | undefined>(\n    undefined,\n  );\n  const isFetchingRef = useRef(false);\n  const lastJsonRef = useRef<string | undefined>(undefined);\n\n  fetchRef.current = fetchFn;\n\n  const execute = useCallback(async () => {\n    // Prevent concurrent fetches from overlapping intervals\n    if (isFetchingRef.current) return;\n    isFetchingRef.current = true;\n\n    try {\n      const result = await fetchRef.current();\n\n      // Only update state if data actually changed (avoids unnecessary re-renders)\n      const json = JSON.stringify(result);\n      if (json !== lastJsonRef.current) {\n        lastJsonRef.current = json;\n        setData(result);\n      }\n      setError((prev) => (prev !== undefined ? undefined : prev));\n    } catch (err) {\n      setError(err instanceof Error ? err : new Error(String(err)));\n    } finally {\n      isFetchingRef.current = false;\n      setIsLoading((prev) => (prev ? false : prev));\n    }\n  }, []);\n\n  // Initial fetch — always runs once regardless of `enabled`\n  const hasFetchedRef = useRef(false);\n  useEffect(() => {\n    if (hasFetchedRef.current) return;\n    hasFetchedRef.current = true;\n    execute();\n  }, [execute]);\n\n  // Polling — only when visible and enabled\n  useEffect(() => {\n    if (!enabled || !visible) {\n      clearInterval(timerRef.current);\n      return;\n    }\n\n    timerRef.current = setInterval(execute, interval);\n    return () => clearInterval(timerRef.current);\n  }, [visible, enabled, interval, execute]);\n\n  return { data, isLoading, isError: !!error, error, refetch: execute };\n}\n"],"mappings":"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","names":["index_exports","__export","useAutoPauseVideo","useDocVisible","useIdleVisibility","useSmartPolling","__toCommonJS","import_react","useDocVisible","visible","setVisible","handler","import_react","useIdleVisibility","timeout","visible","useDocVisible","idle","setIdle","timer","reset","import_react","useAutoPauseVideo","ref","visible","useDocVisible","video","import_react","useSmartPolling","fetchFn","options","interval","enabled","visible","useDocVisible","data","setData","isLoading","setIsLoading","error","setError","fetchRef","timerRef","isFetchingRef","lastJsonRef","execute","result","json","prev","err","hasFetchedRef"]}
+{"version":3,"sources":["../src/useDocVisible.ts","../src/useIdleVisibility.ts","../src/useAutoPauseVideo.ts","../src/useSmartPolling.ts"],"names":["useDocVisible","visible","setVisible","useState","handler","useCallback","useEffect","useIdleVisibility","timeout","idle","setIdle","timerRef","useRef","reset","events","e","useAutoPauseVideo","ref","wasPausedByUs","video","useSmartPolling","fetchFn","options","interval","enabled","data","setData","isLoading","setIsLoading","error","setError","fetchRef","isFetchingRef","lastJsonRef","mountedRef","execute","result","json","prev","err","hasFetchedRef"],"mappings":"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","file":"index.cjs","sourcesContent":["import { useCallback, useEffect, useState } from \"react\";\n\n/**\n * Returns `true` when the page is visible, `false` when hidden.\n * SSR-safe — defaults to `true` on the server.\n */\nexport function useDocVisible(): boolean {\n  const [visible, setVisible] = useState(() =>\n    typeof document === \"undefined\" ? true : document.visibilityState === \"visible\",\n  );\n\n  const handler = useCallback(() => {\n    setVisible(document.visibilityState === \"visible\");\n  }, []);\n\n  useEffect(() => {\n    if (typeof document === \"undefined\") return;\n\n    // Sync in case value changed between SSR hydration and effect\n    handler();\n\n    document.addEventListener(\"visibilitychange\", handler);\n    return () => document.removeEventListener(\"visibilitychange\", handler);\n  }, [handler]);\n\n  return visible;\n}\n","import { useEffect, useRef, useState, useCallback } from \"react\";\nimport { useDocVisible } from \"./useDocVisible\";\n\nexport interface IdleVisibilityResult {\n  /** Whether the page is visible */\n  visible: boolean;\n  /** Whether the user is idle (no interaction for `timeout` ms) */\n  idle: boolean;\n}\n\n/**\n * Combines page-visibility with idle detection.\n *\n * @param timeout - Milliseconds of inactivity before the user is\n *                  considered idle (default `60_000`).\n */\nexport function useIdleVisibility(timeout = 60_000): IdleVisibilityResult {\n  const visible = useDocVisible();\n  const [idle, setIdle] = useState(false);\n  const timerRef = useRef<ReturnType<typeof setTimeout> | undefined>(undefined);\n\n  const reset = useCallback(() => {\n    setIdle(false);\n    clearTimeout(timerRef.current);\n    timerRef.current = setTimeout(() => setIdle(true), timeout);\n  }, [timeout]);\n\n  useEffect(() => {\n    if (typeof window === \"undefined\") return;\n\n    const events: Array<keyof WindowEventMap> = [\n      \"mousemove\",\n      \"keydown\",\n      \"pointerdown\",\n      \"scroll\",\n      \"touchstart\",\n    ];\n\n    events.forEach((e) => window.addEventListener(e, reset, { passive: true }));\n    reset();\n\n    return () => {\n      events.forEach((e) => window.removeEventListener(e, reset));\n      clearTimeout(timerRef.current);\n    };\n  }, [reset]);\n\n  // Reset idle timer when tab becomes visible again\n  useEffect(() => {\n    if (visible) reset();\n  }, [visible, reset]);\n\n  return { visible, idle };\n}\n","import { useEffect, useRef } from \"react\";\nimport { useDocVisible } from \"./useDocVisible\";\n\n/**\n * Automatically pauses a `<video>` when the page becomes hidden\n * and resumes playback when the page becomes visible again.\n *\n * Only resumes if the video was playing before it was paused by this hook.\n */\nexport function useAutoPauseVideo(ref: React.RefObject<HTMLVideoElement | null>): void {\n  const visible = useDocVisible();\n  const wasPausedByUs = useRef(false);\n\n  useEffect(() => {\n    const video = ref.current;\n    if (!video) return;\n\n    if (!visible && !video.paused) {\n      video.pause();\n      wasPausedByUs.current = true;\n    } else if (visible && wasPausedByUs.current) {\n      video.play().catch(() => {\n        /* autoplay may be blocked */\n      });\n      wasPausedByUs.current = false;\n    }\n  }, [visible, ref]);\n}\n","import { useState, useEffect, useRef, useCallback } from \"react\";\nimport { useDocVisible } from \"./useDocVisible\";\n\nexport interface SmartPollingOptions {\n  /** Polling interval in ms (default `5000`) */\n  interval?: number;\n  /** Enable / disable polling (default `true`). The initial fetch always fires. */\n  enabled?: boolean;\n}\n\nexport interface SmartPollingResult<T> {\n  data: T | undefined;\n  isLoading: boolean;\n  isError: boolean;\n  error: Error | undefined;\n  /** Manually trigger a fetch */\n  refetch: () => Promise<void>;\n}\n\n/**\n * Visibility-aware polling hook.\n *\n * - Pauses when the tab is hidden.\n * - Skips re-renders when data hasn't changed (shallow JSON comparison).\n * - Prevents overlapping fetches.\n *\n * @param fetchFn - Async function that returns data.\n * @param options - Optional configuration.\n */\nexport function useSmartPolling<T = unknown>(\n  fetchFn: () => Promise<T>,\n  options?: SmartPollingOptions,\n): SmartPollingResult<T> {\n  const { interval = 5000, enabled = true } = options ?? {};\n  const visible = useDocVisible();\n\n  const [data, setData] = useState<T | undefined>(undefined);\n  const [isLoading, setIsLoading] = useState(true);\n  const [error, setError] = useState<Error | undefined>(undefined);\n\n  const fetchRef = useRef(fetchFn);\n  const timerRef = useRef<ReturnType<typeof setInterval> | undefined>(undefined);\n  const isFetchingRef = useRef(false);\n  const lastJsonRef = useRef<string | undefined>(undefined);\n  const mountedRef = useRef(true);\n\n  // Always keep the latest fetchFn\n  fetchRef.current = fetchFn;\n\n  useEffect(() => {\n    mountedRef.current = true;\n    return () => {\n      mountedRef.current = false;\n    };\n  }, []);\n\n  const execute = useCallback(async () => {\n    if (isFetchingRef.current) return;\n    isFetchingRef.current = true;\n\n    try {\n      const result = await fetchRef.current();\n      if (!mountedRef.current) return;\n\n      const json = JSON.stringify(result);\n      if (json !== lastJsonRef.current) {\n        lastJsonRef.current = json;\n        setData(result);\n      }\n      setError((prev) => (prev !== undefined ? undefined : prev));\n    } catch (err) {\n      if (!mountedRef.current) return;\n      setError(err instanceof Error ? err : new Error(String(err)));\n    } finally {\n      isFetchingRef.current = false;\n      if (mountedRef.current) {\n        setIsLoading((prev) => (prev ? false : prev));\n      }\n    }\n  }, []);\n\n  // Initial fetch — always runs once regardless of `enabled`\n  const hasFetchedRef = useRef(false);\n  useEffect(() => {\n    if (hasFetchedRef.current) return;\n    hasFetchedRef.current = true;\n    execute();\n  }, [execute]);\n\n  // Polling — only when visible AND enabled\n  useEffect(() => {\n    if (!enabled || !visible) {\n      clearInterval(timerRef.current);\n      timerRef.current = undefined;\n      return;\n    }\n\n    // Immediately fetch when re-enabled / tab returns\n    execute();\n\n    timerRef.current = setInterval(execute, interval);\n    return () => {\n      clearInterval(timerRef.current);\n      timerRef.current = undefined;\n    };\n  }, [visible, enabled, interval, execute]);\n\n  return {\n    data,\n    isLoading,\n    isError: error !== undefined,\n    error,\n    refetch: execute,\n  };\n}\n"]}

package/dist/index.d.cts

@@ -1,14 +1,35 @@
+/**
+ * Returns `true` when the page is visible, `false` when hidden.
+ * SSR-safe — defaults to `true` on the server.
+ */
 declare function useDocVisible(): boolean;
 
-declare function useIdleVisibility(timeout?: number): {
+interface IdleVisibilityResult {
+    /** Whether the page is visible */
     visible: boolean;
+    /** Whether the user is idle (no interaction for `timeout` ms) */
     idle: boolean;
-};
+}
+/**
+ * Combines page-visibility with idle detection.
+ *
+ * @param timeout - Milliseconds of inactivity before the user is
+ *                  considered idle (default `60_000`).
+ */
+declare function useIdleVisibility(timeout?: number): IdleVisibilityResult;
 
-declare function useAutoPauseVideo(ref: React.RefObject<HTMLVideoElement>): void;
+/**
+ * Automatically pauses a `<video>` when the page becomes hidden
+ * and resumes playback when the page becomes visible again.
+ *
+ * Only resumes if the video was playing before it was paused by this hook.
+ */
+declare function useAutoPauseVideo(ref: React.RefObject<HTMLVideoElement | null>): void;
 
 interface SmartPollingOptions {
+    /** Polling interval in ms (default `5000`) */
     interval?: number;
+    /** Enable / disable polling (default `true`). The initial fetch always fires. */
     enabled?: boolean;
 }
 interface SmartPollingResult<T> {
@@ -16,8 +37,19 @@ interface SmartPollingResult<T> {
     isLoading: boolean;
     isError: boolean;
     error: Error | undefined;
-    refetch: () => void;
+    /** Manually trigger a fetch */
+    refetch: () => Promise<void>;
 }
-declare function useSmartPolling<T = any>(fetchFn: () => Promise<T>, options?: SmartPollingOptions): SmartPollingResult<T>;
+/**
+ * Visibility-aware polling hook.
+ *
+ * - Pauses when the tab is hidden.
+ * - Skips re-renders when data hasn't changed (shallow JSON comparison).
+ * - Prevents overlapping fetches.
+ *
+ * @param fetchFn - Async function that returns data.
+ * @param options - Optional configuration.
+ */
+declare function useSmartPolling<T = unknown>(fetchFn: () => Promise<T>, options?: SmartPollingOptions): SmartPollingResult<T>;
 
-export { useAutoPauseVideo, useDocVisible, useIdleVisibility, useSmartPolling };
+export { type IdleVisibilityResult, type SmartPollingOptions, type SmartPollingResult, useAutoPauseVideo, useDocVisible, useIdleVisibility, useSmartPolling };

package/dist/index.d.ts

@@ -1,14 +1,35 @@
+/**
+ * Returns `true` when the page is visible, `false` when hidden.
+ * SSR-safe — defaults to `true` on the server.
+ */
 declare function useDocVisible(): boolean;
 
-declare function useIdleVisibility(timeout?: number): {
+interface IdleVisibilityResult {
+    /** Whether the page is visible */
     visible: boolean;
+    /** Whether the user is idle (no interaction for `timeout` ms) */
     idle: boolean;
-};
+}
+/**
+ * Combines page-visibility with idle detection.
+ *
+ * @param timeout - Milliseconds of inactivity before the user is
+ *                  considered idle (default `60_000`).
+ */
+declare function useIdleVisibility(timeout?: number): IdleVisibilityResult;
 
-declare function useAutoPauseVideo(ref: React.RefObject<HTMLVideoElement>): void;
+/**
+ * Automatically pauses a `<video>` when the page becomes hidden
+ * and resumes playback when the page becomes visible again.
+ *
+ * Only resumes if the video was playing before it was paused by this hook.
+ */
+declare function useAutoPauseVideo(ref: React.RefObject<HTMLVideoElement | null>): void;
 
 interface SmartPollingOptions {
+    /** Polling interval in ms (default `5000`) */
     interval?: number;
+    /** Enable / disable polling (default `true`). The initial fetch always fires. */
     enabled?: boolean;
 }
 interface SmartPollingResult<T> {
@@ -16,8 +37,19 @@ interface SmartPollingResult<T> {
     isLoading: boolean;
     isError: boolean;
     error: Error | undefined;
-    refetch: () => void;
+    /** Manually trigger a fetch */
+    refetch: () => Promise<void>;
 }
-declare function useSmartPolling<T = any>(fetchFn: () => Promise<T>, options?: SmartPollingOptions): SmartPollingResult<T>;
+/**
+ * Visibility-aware polling hook.
+ *
+ * - Pauses when the tab is hidden.
+ * - Skips re-renders when data hasn't changed (shallow JSON comparison).
+ * - Prevents overlapping fetches.
+ *
+ * @param fetchFn - Async function that returns data.
+ * @param options - Optional configuration.
+ */
+declare function useSmartPolling<T = unknown>(fetchFn: () => Promise<T>, options?: SmartPollingOptions): SmartPollingResult<T>;
 
-export { useAutoPauseVideo, useDocVisible, useIdleVisibility, useSmartPolling };
+export { type IdleVisibilityResult, type SmartPollingOptions, type SmartPollingResult, useAutoPauseVideo, useDocVisible, useIdleVisibility, useSmartPolling };

package/dist/index.js

@@ -1,2 +1,2 @@
-import{useEffect as h,useState as L}from"react";function s(){let[t,r]=L(typeof document=="undefined"||document.visibilityState==="visible");return h(()=>{if(typeof document=="undefined")return;let e=()=>r(document.visibilityState==="visible");return document.addEventListener("visibilitychange",e),()=>document.removeEventListener("visibilitychange",e)},[]),t}import{useEffect as x,useState as V}from"react";function J(t=6e4){let r=s(),[e,u]=V(!1);return x(()=>{let o,i=()=>{u(!1),clearTimeout(o),o=setTimeout(()=>u(!0),t)};return window.addEventListener("mousemove",i),window.addEventListener("keydown",i),i(),()=>{window.removeEventListener("mousemove",i),window.removeEventListener("keydown",i),clearTimeout(o)}},[t]),{visible:r,idle:e}}import{useEffect as I}from"react";function H(t){let r=s();I(()=>{let e=t.current;e&&(r?e.play().catch(()=>{}):e.pause())},[r,t])}import{useState as d,useEffect as w,useRef as a,useCallback as P}from"react";function z(t,r){let{interval:e=5e3,enabled:u=!0}=r!=null?r:{},o=s(),[i,S]=d(void 0),[R,T]=d(!0),[m,v]=d(void 0),b=a(t),f=a(void 0),l=a(!1),y=a(void 0);b.current=t;let c=P(async()=>{if(!l.current){l.current=!0;try{let n=await b.current(),p=JSON.stringify(n);p!==y.current&&(y.current=p,S(n)),v(g=>g!==void 0?void 0:g)}catch(n){v(n instanceof Error?n:new Error(String(n)))}finally{l.current=!1,T(n=>n&&!1)}}},[]),E=a(!1);return w(()=>{E.current||(E.current=!0,c())},[c]),w(()=>{if(!u||!o){clearInterval(f.current);return}return f.current=setInterval(c,e),()=>clearInterval(f.current)},[o,u,e,c]),{data:i,isLoading:R,isError:!!m,error:m,refetch:c}}export{H as useAutoPauseVideo,s as useDocVisible,J as useIdleVisibility,z as useSmartPolling};
+import {useState,useCallback,useEffect,useRef}from'react';function u(){let[r,e]=useState(()=>typeof document=="undefined"?true:document.visibilityState==="visible"),t=useCallback(()=>{e(document.visibilityState==="visible");},[]);return useEffect(()=>{if(typeof document!="undefined")return t(),document.addEventListener("visibilitychange",t),()=>document.removeEventListener("visibilitychange",t)},[t]),r}function O(r=6e4){let e=u(),[t,n]=useState(false),s=useRef(void 0),o=useCallback(()=>{n(false),clearTimeout(s.current),s.current=setTimeout(()=>n(true),r);},[r]);return useEffect(()=>{if(typeof window=="undefined")return;let m=["mousemove","keydown","pointerdown","scroll","touchstart"];return m.forEach(f=>window.addEventListener(f,o,{passive:true})),o(),()=>{m.forEach(f=>window.removeEventListener(f,o)),clearTimeout(s.current);}},[o]),useEffect(()=>{e&&o();},[e,o]),{visible:e,idle:t}}function j(r){let e=u(),t=useRef(false);useEffect(()=>{let n=r.current;n&&(!e&&!n.paused?(n.pause(),t.current=true):e&&t.current&&(n.play().catch(()=>{}),t.current=false));},[e,r]);}function M(r,e){let{interval:t=5e3,enabled:n=true}=e!=null?e:{},s=u(),[o,m]=useState(void 0),[f,h]=useState(true),[y,R]=useState(void 0),E=useRef(r),a=useRef(void 0),b=useRef(false),g=useRef(void 0),d=useRef(true);E.current=r,useEffect(()=>(d.current=true,()=>{d.current=false;}),[]);let l=useCallback(async()=>{if(!b.current){b.current=true;try{let i=await E.current();if(!d.current)return;let V=JSON.stringify(i);V!==g.current&&(g.current=V,m(i)),R(x=>x!==void 0?void 0:x);}catch(i){if(!d.current)return;R(i instanceof Error?i:new Error(String(i)));}finally{b.current=false,d.current&&h(i=>i&&false);}}},[]),S=useRef(false);return useEffect(()=>{S.current||(S.current=true,l());},[l]),useEffect(()=>{if(!n||!s){clearInterval(a.current),a.current=void 0;return}return l(),a.current=setInterval(l,t),()=>{clearInterval(a.current),a.current=void 0;}},[s,n,t,l]),{data:o,isLoading:f,isError:y!==void 0,error:y,refetch:l}}export{j as useAutoPauseVideo,u as useDocVisible,O as useIdleVisibility,M as useSmartPolling};//# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/useDocVisible.ts","../src/useIdleVisibility.ts","../src/useAutoPauseVideo.ts","../src/useSmartPolling.ts"],"sourcesContent":["import { useEffect, useState } from \"react\";\n\nexport function useDocVisible(): boolean {\n  const [visible, setVisible] = useState(\n    typeof document === \"undefined\" || document.visibilityState === \"visible\"\n  );\n\n  useEffect(() => {\n    if (typeof document === \"undefined\") return;\n    const handler = () => setVisible(document.visibilityState === \"visible\");\n    document.addEventListener(\"visibilitychange\", handler);\n    return () => document.removeEventListener(\"visibilitychange\", handler);\n  }, []);\n\n  return visible;\n}\n","import { useEffect, useState } from \"react\";\nimport { useDocVisible } from \"./useDocVisible\";\n\nexport function useIdleVisibility(timeout = 60000) {\n  const visible = useDocVisible();\n  const [idle, setIdle] = useState(false);\n\n  useEffect(() => {\n    let timer: any;\n\n    const reset = () => {\n      setIdle(false);\n      clearTimeout(timer);\n      timer = setTimeout(() => setIdle(true), timeout);\n    };\n\n    window.addEventListener(\"mousemove\", reset);\n    window.addEventListener(\"keydown\", reset);\n    reset();\n\n    return () => {\n      window.removeEventListener(\"mousemove\", reset);\n      window.removeEventListener(\"keydown\", reset);\n      clearTimeout(timer);\n    };\n  }, [timeout]);\n\n  return { visible, idle };\n}\n","import { useEffect } from \"react\";\nimport { useDocVisible } from \"./useDocVisible\";\n\nexport function useAutoPauseVideo(ref: React.RefObject<HTMLVideoElement>) {\n  const visible = useDocVisible();\n\n  useEffect(() => {\n    const video = ref.current;\n    if (!video) return;\n\n    if (!visible) video.pause();\n    else video.play().catch(() => {});\n  }, [visible, ref]);\n}\n","import { useState, useEffect, useRef, useCallback } from \"react\";\nimport { useDocVisible } from \"./useDocVisible\";\n\ninterface SmartPollingOptions {\n  interval?: number;\n  enabled?: boolean;\n}\n\ninterface SmartPollingResult<T> {\n  data: T | undefined;\n  isLoading: boolean;\n  isError: boolean;\n  error: Error | undefined;\n  refetch: () => void;\n}\n\nexport function useSmartPolling<T = any>(\n  fetchFn: () => Promise<T>,\n  options?: SmartPollingOptions,\n): SmartPollingResult<T> {\n  const { interval = 5000, enabled = true } = options ?? {};\n  const visible = useDocVisible();\n  const [data, setData] = useState<T | undefined>(undefined);\n  const [isLoading, setIsLoading] = useState(true);\n  const [error, setError] = useState<Error | undefined>(undefined);\n  const fetchRef = useRef(fetchFn);\n  const timerRef = useRef<ReturnType<typeof setInterval> | undefined>(\n    undefined,\n  );\n  const isFetchingRef = useRef(false);\n  const lastJsonRef = useRef<string | undefined>(undefined);\n\n  fetchRef.current = fetchFn;\n\n  const execute = useCallback(async () => {\n    // Prevent concurrent fetches from overlapping intervals\n    if (isFetchingRef.current) return;\n    isFetchingRef.current = true;\n\n    try {\n      const result = await fetchRef.current();\n\n      // Only update state if data actually changed (avoids unnecessary re-renders)\n      const json = JSON.stringify(result);\n      if (json !== lastJsonRef.current) {\n        lastJsonRef.current = json;\n        setData(result);\n      }\n      setError((prev) => (prev !== undefined ? undefined : prev));\n    } catch (err) {\n      setError(err instanceof Error ? err : new Error(String(err)));\n    } finally {\n      isFetchingRef.current = false;\n      setIsLoading((prev) => (prev ? false : prev));\n    }\n  }, []);\n\n  // Initial fetch — always runs once regardless of `enabled`\n  const hasFetchedRef = useRef(false);\n  useEffect(() => {\n    if (hasFetchedRef.current) return;\n    hasFetchedRef.current = true;\n    execute();\n  }, [execute]);\n\n  // Polling — only when visible and enabled\n  useEffect(() => {\n    if (!enabled || !visible) {\n      clearInterval(timerRef.current);\n      return;\n    }\n\n    timerRef.current = setInterval(execute, interval);\n    return () => clearInterval(timerRef.current);\n  }, [visible, enabled, interval, execute]);\n\n  return { data, isLoading, isError: !!error, error, refetch: execute };\n}\n"],"mappings":"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","names":["useEffect","useState","useDocVisible","visible","setVisible","handler","useEffect","useState","useIdleVisibility","timeout","visible","useDocVisible","idle","setIdle","useState","useEffect","timer","reset","useEffect","useAutoPauseVideo","ref","visible","useDocVisible","useEffect","video","useState","useEffect","useRef","useCallback","useSmartPolling","fetchFn","options","interval","enabled","visible","useDocVisible","data","setData","useState","isLoading","setIsLoading","error","setError","fetchRef","useRef","timerRef","isFetchingRef","lastJsonRef","execute","useCallback","result","json","prev","err","hasFetchedRef","useEffect"]}
+{"version":3,"sources":["../src/useDocVisible.ts","../src/useIdleVisibility.ts","../src/useAutoPauseVideo.ts","../src/useSmartPolling.ts"],"names":["useDocVisible","visible","setVisible","useState","handler","useCallback","useEffect","useIdleVisibility","timeout","idle","setIdle","timerRef","useRef","reset","events","e","useAutoPauseVideo","ref","wasPausedByUs","video","useSmartPolling","fetchFn","options","interval","enabled","data","setData","isLoading","setIsLoading","error","setError","fetchRef","isFetchingRef","lastJsonRef","mountedRef","execute","result","json","prev","err","hasFetchedRef"],"mappings":"0DAMO,SAASA,CAAAA,EAAyB,CACvC,GAAM,CAACC,CAAAA,CAASC,CAAU,CAAA,CAAIC,QAAAA,CAAS,IACrC,OAAO,QAAA,EAAa,WAAA,CAAc,IAAA,CAAO,QAAA,CAAS,eAAA,GAAoB,SACxE,CAAA,CAEMC,CAAAA,CAAUC,WAAAA,CAAY,IAAM,CAChCH,CAAAA,CAAW,QAAA,CAAS,eAAA,GAAoB,SAAS,EACnD,CAAA,CAAG,EAAE,CAAA,CAEL,OAAAI,SAAAA,CAAU,IAAM,CACd,GAAI,OAAO,QAAA,EAAa,WAAA,CAGxB,OAAAF,CAAAA,EAAQ,CAER,QAAA,CAAS,gBAAA,CAAiB,kBAAA,CAAoBA,CAAO,CAAA,CAC9C,IAAM,QAAA,CAAS,mBAAA,CAAoB,kBAAA,CAAoBA,CAAO,CACvE,CAAA,CAAG,CAACA,CAAO,CAAC,CAAA,CAELH,CACT,CCVO,SAASM,CAAAA,CAAkBC,CAAAA,CAAU,GAAA,CAA8B,CACxE,IAAMP,CAAAA,CAAUD,CAAAA,EAAc,CACxB,CAACS,CAAAA,CAAMC,CAAO,CAAA,CAAIP,QAAAA,CAAS,KAAK,CAAA,CAChCQ,CAAAA,CAAWC,MAAAA,CAAkD,MAAS,CAAA,CAEtEC,CAAAA,CAAQR,WAAAA,CAAY,IAAM,CAC9BK,CAAAA,CAAQ,KAAK,CAAA,CACb,YAAA,CAAaC,CAAAA,CAAS,OAAO,CAAA,CAC7BA,CAAAA,CAAS,OAAA,CAAU,UAAA,CAAW,IAAMD,CAAAA,CAAQ,IAAI,CAAA,CAAGF,CAAO,EAC5D,CAAA,CAAG,CAACA,CAAO,CAAC,CAAA,CAEZ,OAAAF,SAAAA,CAAU,IAAM,CACd,GAAI,OAAO,MAAA,EAAW,WAAA,CAAa,OAEnC,IAAMQ,CAAAA,CAAsC,CAC1C,WAAA,CACA,SAAA,CACA,aAAA,CACA,QAAA,CACA,YACF,CAAA,CAEA,OAAAA,CAAAA,CAAO,OAAA,CAASC,CAAAA,EAAM,MAAA,CAAO,gBAAA,CAAiBA,CAAAA,CAAGF,CAAAA,CAAO,CAAE,OAAA,CAAS,IAAK,CAAC,CAAC,CAAA,CAC1EA,CAAAA,EAAM,CAEC,IAAM,CACXC,CAAAA,CAAO,OAAA,CAASC,CAAAA,EAAM,MAAA,CAAO,mBAAA,CAAoBA,CAAAA,CAAGF,CAAK,CAAC,CAAA,CAC1D,YAAA,CAAaF,CAAAA,CAAS,OAAO,EAC/B,CACF,CAAA,CAAG,CAACE,CAAK,CAAC,CAAA,CAGVP,SAAAA,CAAU,IAAM,CACVL,CAAAA,EAASY,CAAAA,GACf,CAAA,CAAG,CAACZ,CAAAA,CAASY,CAAK,CAAC,CAAA,CAEZ,CAAE,OAAA,CAAAZ,CAAAA,CAAS,IAAA,CAAAQ,CAAK,CACzB,CC5CO,SAASO,CAAAA,CAAkBC,CAAAA,CAAqD,CACrF,IAAMhB,CAAAA,CAAUD,CAAAA,EAAc,CACxBkB,CAAAA,CAAgBN,MAAAA,CAAO,KAAK,CAAA,CAElCN,SAAAA,CAAU,IAAM,CACd,IAAMa,CAAAA,CAAQF,CAAAA,CAAI,OAAA,CACbE,CAAAA,GAED,CAAClB,CAAAA,EAAW,CAACkB,CAAAA,CAAM,MAAA,EACrBA,CAAAA,CAAM,KAAA,EAAM,CACZD,CAAAA,CAAc,OAAA,CAAU,IAAA,EACfjB,CAAAA,EAAWiB,CAAAA,CAAc,OAAA,GAClCC,CAAAA,CAAM,IAAA,EAAK,CAAE,KAAA,CAAM,IAAM,CAEzB,CAAC,CAAA,CACDD,CAAAA,CAAc,OAAA,CAAU,KAAA,CAAA,EAE5B,CAAA,CAAG,CAACjB,CAAAA,CAASgB,CAAG,CAAC,EACnB,CCEO,SAASG,CAAAA,CACdC,CAAAA,CACAC,CAAAA,CACuB,CACvB,GAAM,CAAE,QAAA,CAAAC,CAAAA,CAAW,GAAA,CAAM,OAAA,CAAAC,CAAAA,CAAU,IAAK,CAAA,CAAIF,CAAAA,EAAA,IAAA,CAAAA,CAAAA,CAAW,EAAC,CAClDrB,CAAAA,CAAUD,CAAAA,EAAc,CAExB,CAACyB,CAAAA,CAAMC,CAAO,CAAA,CAAIvB,QAAAA,CAAwB,MAAS,CAAA,CACnD,CAACwB,CAAAA,CAAWC,CAAY,CAAA,CAAIzB,QAAAA,CAAS,IAAI,CAAA,CACzC,CAAC0B,CAAAA,CAAOC,CAAQ,CAAA,CAAI3B,QAAAA,CAA4B,MAAS,CAAA,CAEzD4B,CAAAA,CAAWnB,MAAAA,CAAOS,CAAO,CAAA,CACzBV,CAAAA,CAAWC,MAAAA,CAAmD,MAAS,CAAA,CACvEoB,CAAAA,CAAgBpB,MAAAA,CAAO,KAAK,CAAA,CAC5BqB,CAAAA,CAAcrB,MAAAA,CAA2B,MAAS,CAAA,CAClDsB,CAAAA,CAAatB,MAAAA,CAAO,IAAI,CAAA,CAG9BmB,CAAAA,CAAS,OAAA,CAAUV,CAAAA,CAEnBf,SAAAA,CAAU,KACR4B,CAAAA,CAAW,OAAA,CAAU,IAAA,CACd,IAAM,CACXA,CAAAA,CAAW,OAAA,CAAU,MACvB,CAAA,CAAA,CACC,EAAE,CAAA,CAEL,IAAMC,CAAAA,CAAU9B,WAAAA,CAAY,SAAY,CACtC,GAAI,CAAA2B,CAAAA,CAAc,OAAA,CAClB,CAAAA,CAAAA,CAAc,OAAA,CAAU,IAAA,CAExB,GAAI,CACF,IAAMI,CAAAA,CAAS,MAAML,CAAAA,CAAS,OAAA,EAAQ,CACtC,GAAI,CAACG,CAAAA,CAAW,OAAA,CAAS,OAEzB,IAAMG,CAAAA,CAAO,IAAA,CAAK,SAAA,CAAUD,CAAM,CAAA,CAC9BC,CAAAA,GAASJ,CAAAA,CAAY,OAAA,GACvBA,CAAAA,CAAY,OAAA,CAAUI,CAAAA,CACtBX,CAAAA,CAAQU,CAAM,CAAA,CAAA,CAEhBN,CAAAA,CAAUQ,CAAAA,EAAUA,CAAAA,GAAS,KAAA,CAAA,CAAY,KAAA,CAAA,CAAYA,CAAK,EAC5D,CAAA,MAASC,CAAAA,CAAK,CACZ,GAAI,CAACL,CAAAA,CAAW,OAAA,CAAS,OACzBJ,CAAAA,CAASS,CAAAA,YAAe,KAAA,CAAQA,CAAAA,CAAM,IAAI,KAAA,CAAM,MAAA,CAAOA,CAAG,CAAC,CAAC,EAC9D,CAAA,OAAE,CACAP,CAAAA,CAAc,OAAA,CAAU,KAAA,CACpBE,CAAAA,CAAW,OAAA,EACbN,CAAAA,CAAcU,CAAAA,EAAUA,CAAAA,EAAO,KAAa,EAEhD,CAAA,CACF,CAAA,CAAG,EAAE,CAAA,CAGCE,CAAAA,CAAgB5B,MAAAA,CAAO,KAAK,CAAA,CAClC,OAAAN,SAAAA,CAAU,IAAM,CACVkC,CAAAA,CAAc,OAAA,GAClBA,CAAAA,CAAc,OAAA,CAAU,IAAA,CACxBL,CAAAA,EAAQ,EACV,CAAA,CAAG,CAACA,CAAO,CAAC,CAAA,CAGZ7B,SAAAA,CAAU,IAAM,CACd,GAAI,CAACkB,CAAAA,EAAW,CAACvB,CAAAA,CAAS,CACxB,aAAA,CAAcU,CAAAA,CAAS,OAAO,CAAA,CAC9BA,CAAAA,CAAS,OAAA,CAAU,MAAA,CACnB,MACF,CAGA,OAAAwB,CAAAA,EAAQ,CAERxB,CAAAA,CAAS,OAAA,CAAU,WAAA,CAAYwB,CAAAA,CAASZ,CAAQ,CAAA,CACzC,IAAM,CACX,aAAA,CAAcZ,CAAAA,CAAS,OAAO,CAAA,CAC9BA,CAAAA,CAAS,OAAA,CAAU,OACrB,CACF,CAAA,CAAG,CAACV,CAAAA,CAASuB,CAAAA,CAASD,CAAAA,CAAUY,CAAO,CAAC,CAAA,CAEjC,CACL,IAAA,CAAAV,CAAAA,CACA,SAAA,CAAAE,CAAAA,CACA,OAAA,CAASE,CAAAA,GAAU,MAAA,CACnB,KAAA,CAAAA,CAAAA,CACA,OAAA,CAASM,CACX,CACF","file":"index.js","sourcesContent":["import { useCallback, useEffect, useState } from \"react\";\n\n/**\n * Returns `true` when the page is visible, `false` when hidden.\n * SSR-safe — defaults to `true` on the server.\n */\nexport function useDocVisible(): boolean {\n  const [visible, setVisible] = useState(() =>\n    typeof document === \"undefined\" ? true : document.visibilityState === \"visible\",\n  );\n\n  const handler = useCallback(() => {\n    setVisible(document.visibilityState === \"visible\");\n  }, []);\n\n  useEffect(() => {\n    if (typeof document === \"undefined\") return;\n\n    // Sync in case value changed between SSR hydration and effect\n    handler();\n\n    document.addEventListener(\"visibilitychange\", handler);\n    return () => document.removeEventListener(\"visibilitychange\", handler);\n  }, [handler]);\n\n  return visible;\n}\n","import { useEffect, useRef, useState, useCallback } from \"react\";\nimport { useDocVisible } from \"./useDocVisible\";\n\nexport interface IdleVisibilityResult {\n  /** Whether the page is visible */\n  visible: boolean;\n  /** Whether the user is idle (no interaction for `timeout` ms) */\n  idle: boolean;\n}\n\n/**\n * Combines page-visibility with idle detection.\n *\n * @param timeout - Milliseconds of inactivity before the user is\n *                  considered idle (default `60_000`).\n */\nexport function useIdleVisibility(timeout = 60_000): IdleVisibilityResult {\n  const visible = useDocVisible();\n  const [idle, setIdle] = useState(false);\n  const timerRef = useRef<ReturnType<typeof setTimeout> | undefined>(undefined);\n\n  const reset = useCallback(() => {\n    setIdle(false);\n    clearTimeout(timerRef.current);\n    timerRef.current = setTimeout(() => setIdle(true), timeout);\n  }, [timeout]);\n\n  useEffect(() => {\n    if (typeof window === \"undefined\") return;\n\n    const events: Array<keyof WindowEventMap> = [\n      \"mousemove\",\n      \"keydown\",\n      \"pointerdown\",\n      \"scroll\",\n      \"touchstart\",\n    ];\n\n    events.forEach((e) => window.addEventListener(e, reset, { passive: true }));\n    reset();\n\n    return () => {\n      events.forEach((e) => window.removeEventListener(e, reset));\n      clearTimeout(timerRef.current);\n    };\n  }, [reset]);\n\n  // Reset idle timer when tab becomes visible again\n  useEffect(() => {\n    if (visible) reset();\n  }, [visible, reset]);\n\n  return { visible, idle };\n}\n","import { useEffect, useRef } from \"react\";\nimport { useDocVisible } from \"./useDocVisible\";\n\n/**\n * Automatically pauses a `<video>` when the page becomes hidden\n * and resumes playback when the page becomes visible again.\n *\n * Only resumes if the video was playing before it was paused by this hook.\n */\nexport function useAutoPauseVideo(ref: React.RefObject<HTMLVideoElement | null>): void {\n  const visible = useDocVisible();\n  const wasPausedByUs = useRef(false);\n\n  useEffect(() => {\n    const video = ref.current;\n    if (!video) return;\n\n    if (!visible && !video.paused) {\n      video.pause();\n      wasPausedByUs.current = true;\n    } else if (visible && wasPausedByUs.current) {\n      video.play().catch(() => {\n        /* autoplay may be blocked */\n      });\n      wasPausedByUs.current = false;\n    }\n  }, [visible, ref]);\n}\n","import { useState, useEffect, useRef, useCallback } from \"react\";\nimport { useDocVisible } from \"./useDocVisible\";\n\nexport interface SmartPollingOptions {\n  /** Polling interval in ms (default `5000`) */\n  interval?: number;\n  /** Enable / disable polling (default `true`). The initial fetch always fires. */\n  enabled?: boolean;\n}\n\nexport interface SmartPollingResult<T> {\n  data: T | undefined;\n  isLoading: boolean;\n  isError: boolean;\n  error: Error | undefined;\n  /** Manually trigger a fetch */\n  refetch: () => Promise<void>;\n}\n\n/**\n * Visibility-aware polling hook.\n *\n * - Pauses when the tab is hidden.\n * - Skips re-renders when data hasn't changed (shallow JSON comparison).\n * - Prevents overlapping fetches.\n *\n * @param fetchFn - Async function that returns data.\n * @param options - Optional configuration.\n */\nexport function useSmartPolling<T = unknown>(\n  fetchFn: () => Promise<T>,\n  options?: SmartPollingOptions,\n): SmartPollingResult<T> {\n  const { interval = 5000, enabled = true } = options ?? {};\n  const visible = useDocVisible();\n\n  const [data, setData] = useState<T | undefined>(undefined);\n  const [isLoading, setIsLoading] = useState(true);\n  const [error, setError] = useState<Error | undefined>(undefined);\n\n  const fetchRef = useRef(fetchFn);\n  const timerRef = useRef<ReturnType<typeof setInterval> | undefined>(undefined);\n  const isFetchingRef = useRef(false);\n  const lastJsonRef = useRef<string | undefined>(undefined);\n  const mountedRef = useRef(true);\n\n  // Always keep the latest fetchFn\n  fetchRef.current = fetchFn;\n\n  useEffect(() => {\n    mountedRef.current = true;\n    return () => {\n      mountedRef.current = false;\n    };\n  }, []);\n\n  const execute = useCallback(async () => {\n    if (isFetchingRef.current) return;\n    isFetchingRef.current = true;\n\n    try {\n      const result = await fetchRef.current();\n      if (!mountedRef.current) return;\n\n      const json = JSON.stringify(result);\n      if (json !== lastJsonRef.current) {\n        lastJsonRef.current = json;\n        setData(result);\n      }\n      setError((prev) => (prev !== undefined ? undefined : prev));\n    } catch (err) {\n      if (!mountedRef.current) return;\n      setError(err instanceof Error ? err : new Error(String(err)));\n    } finally {\n      isFetchingRef.current = false;\n      if (mountedRef.current) {\n        setIsLoading((prev) => (prev ? false : prev));\n      }\n    }\n  }, []);\n\n  // Initial fetch — always runs once regardless of `enabled`\n  const hasFetchedRef = useRef(false);\n  useEffect(() => {\n    if (hasFetchedRef.current) return;\n    hasFetchedRef.current = true;\n    execute();\n  }, [execute]);\n\n  // Polling — only when visible AND enabled\n  useEffect(() => {\n    if (!enabled || !visible) {\n      clearInterval(timerRef.current);\n      timerRef.current = undefined;\n      return;\n    }\n\n    // Immediately fetch when re-enabled / tab returns\n    execute();\n\n    timerRef.current = setInterval(execute, interval);\n    return () => {\n      clearInterval(timerRef.current);\n      timerRef.current = undefined;\n    };\n  }, [visible, enabled, interval, execute]);\n\n  return {\n    data,\n    isLoading,\n    isError: error !== undefined,\n    error,\n    refetch: execute,\n  };\n}\n"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "react-visibility-hooks",
-  "version": "1.0.11",
-  "description": "Tiny, SSR-safe React hooks for page visibility, idle detection and smart polling",
+  "version": "2.0.0",
+  "description": "Tiny, SSR-safe React hooks for page visibility, idle detection, smart polling and auto-pause video",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -14,25 +14,43 @@
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "LICENSE",
+    "README.md"
   ],
   "sideEffects": false,
   "scripts": {
     "build": "tsup",
-    "test": "jest",
-    "prepare": "npm run build"
+    "test": "jest --coverage",
+    "test:watch": "jest --watch",
+    "lint": "eslint src __tests__",
+    "format": "prettier --write \"src/**/*.ts\" \"__tests__/**/*.ts\" \"*.json\" \"*.js\" \"*.ts\" \"*.mjs\"",
+    "prepare": "npm run build",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run lint && npm run format && npm run typecheck && npm run test && npm run build",
+    "size": "size-limit"
   },
   "keywords": [
     "react",
     "react-hooks",
+    "hooks",
     "visibility",
     "page-visibility",
+    "visibilitychange",
     "idle-detection",
+    "idle",
     "performance",
     "react-performance",
     "smart-polling",
+    "polling",
+    "auto-pause",
+    "video",
     "analytics",
-    "react-utils"
+    "react-utils",
+    "ssr",
+    "ssr-safe",
+    "nextjs",
+    "typescript"
   ],
   "author": "Aniket Raj",
   "license": "MIT",
@@ -45,17 +63,39 @@
     "url": "https://github.com/exewhyz/react-visibility-hooks/issues"
   },
   "peerDependencies": {
-    "react": ">=18"
+    "react": ">=16.8.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": false
+    }
   },
   "devDependencies": {
+    "@eslint/js": "^9.39.2",
+    "@size-limit/preset-small-lib": "^11.0.0",
     "@testing-library/react": "^16.3.2",
     "@types/jest": "^30.0.0",
     "@types/react": "^19.2.13",
+    "eslint": "^9.39.2",
     "jest": "^30.2.0",
     "jest-environment-jsdom": "^30.2.0",
     "jsdom": "^28.0.0",
+    "prettier": "^3.8.1",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "size-limit": "^11.0.0",
     "ts-jest": "^29.4.6",
     "tsup": "^8.5.1",
-    "typescript": "^5.9.3"
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.54.0"
+  },
+  "size-limit": [
+    {
+      "path": "dist/index.js",
+      "limit": "1.5 kB"
+    }
+  ],
+  "engines": {
+    "node": ">=16"
   }
 }