use-page-view 0.0.1 → 1.0.1

package/README.md

@@ -1,9 +1,10 @@
 # use-page-view
 
-A React hook for tracking page views and user engagement time. This hook provides real-time monitoring of user activity, page visibility, and time spent on pages.
+A React hook for tracking page views and user engagement time. This hook provides real-time tracking of how long users spend on a page, their activity status, and flexible callbacks for implementing custom persistence and analytics.
 
 [![npm version](https://img.shields.io/npm/v/use-page-view.svg)](https://www.npmjs.com/package/use-page-view)
 [![npm downloads](https://img.shields.io/npm/dm/use-page-view.svg)](https://www.npmjs.com/package/use-page-view)
+[![Bundle Size](https://img.shields.io/bundlephobia/minzip/use-page-view)](https://bundlephobia.com/package/use-page-view)
 [![License](https://img.shields.io/npm/l/use-page-view.svg)](https://github.com/christophersesugh/use-page-view/blob/main/LICENSE)
 [![CI Status](https://img.shields.io/github/actions/workflow/status/christophersesugh/use-page-view/ci.yml)](https://github.com/christophersesugh/use-page-view/actions)
 [![Coverage](https://img.shields.io/codecov/c/github/christophersesugh/use-page-view)](https://codecov.io/gh/christophersesugh/use-page-view)
@@ -12,10 +13,13 @@ A React hook for tracking page views and user engagement time. This hook provide
 
 - 📊 Track time spent on pages
 - 👀 Monitor user activity and page visibility
-- ⏱️ Configurable tracking intervals
-- 🔄 Real-time updates
-- 🎯 Support for both continuous and one-time tracking
-- 🛡️ TypeScript support
+- 🔄 Periodic updates through callback
+- ⏱️ Configurable thresholds and intervals
+- 🎯 Support for one-time tracking
+- 🔑 User identification support
+- 🚀 Lightweight with minimal overhead
+- 🌐 SSR/React Router/Next.js compatible
+- 🛠️ Flexible - implement your own persistence strategy
 
 ## Installation
 
@@ -27,7 +31,37 @@ yarn add use-page-view
 pnpm add use-page-view
 ```
 
-## Basic Usage
+## Quick Start
+
+```tsx
+import { usePageView } from 'use-page-view';
+
+function MyPage() {
+  const { timeSpent, isActive } = usePageView({
+    pageId: 'my-page',
+    onPageView: (data) => console.log('Page view:', data),
+  });
+
+  return (
+    <div>
+      <h1>My Page</h1>
+      <p>
+        Time spent: {timeSpent}s {isActive ? '🟢 Active' : '🔴 Inactive'}
+      </p>
+    </div>
+  );
+}
+```
+
+## Compatibility
+
+- **React**: 16.8+ (hooks support required)
+- **TypeScript**: Full TypeScript support included
+- **Browsers**: Modern browsers
+- **SSR**: Compatible with React Router, Next.js and other SSR frameworks
+- **React Native**: Not supported (web-only)
+
+## Usage
 
 ```tsx
 import { usePageView } from 'use-page-view';
@@ -35,174 +69,212 @@ import { usePageView } from 'use-page-view';
 function BlogPost() {
   const { timeSpent, isActive } = usePageView({
     pageId: 'blog-post-123',
-    onPageView: (data) => {
-      // Handle page view data
-      console.log(data);
+    userId: 'user-456', // Optional
+    minTimeThreshold: 10, // Minimum time before recording (seconds)
+    heartbeatInterval: 30, // How often to send updates (seconds)
+    inactivityThreshold: 60, // Time before user is considered inactive (seconds)
+    onPageView: async (data) => {
+      try {
+        await fetch('/api/track-page-view', {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify(data),
+        });
+      } catch (error) {
+        console.error('Failed to track page view:', error);
+      }
     },
   });
 
   return (
     <div>
       <div>
-        Time spent: {timeSpent}s {isActive ? '🟢' : '🔴'}
+        Time: {formatTime(timeSpent)} {isActive ? '🟢' : '🔴'}
       </div>
       <article>Your content here...</article>
     </div>
   );
 }
-```
 
-## API Reference
+// Helper function to format time
+function formatTime(seconds: number): string {
+  const mins = Math.floor(seconds / 60);
+  const secs = seconds % 60;
+  return `${mins}:${secs.toString().padStart(2, '0')}`;
+}
+```
 
-### Parameters
+## API
 
-The `usePageView` hook accepts an options object with the following properties:
+### usePageView(options)
 
-| Parameter             | Type                           | Required | Default | Description                                                            |
-| --------------------- | ------------------------------ | -------- | ------- | ---------------------------------------------------------------------- |
-| `pageId`              | `string`                       | Yes      | -       | Unique identifier for the page being tracked                           |
-| `userId`              | `string`                       | No       | -       | Optional user identifier if user is logged in                          |
-| `minTimeThreshold`    | `number`                       | No       | `5`     | Minimum time in seconds before recording a view                        |
-| `heartbeatInterval`   | `number`                       | No       | `30`    | How often to send updates in seconds                                   |
-| `inactivityThreshold` | `number`                       | No       | `30`    | Time in seconds before user is considered inactive                     |
-| `onPageView`          | `(data: PageViewData) => void` | No       | -       | Callback function to handle page view data                             |
-| `trackOnce`           | `boolean`                      | No       | `false` | Track only the initial view                                            |
-| `trackOnceDelay`      | `number`                       | No       | `0`     | Minimum time in seconds before recording a view when trackOnce is true |
+#### Options
 
-### Return Value
+| Option                | Type                           | Default  | Description                                                            |
+| --------------------- | ------------------------------ | -------- | ---------------------------------------------------------------------- |
+| `pageId`              | `string`                       | Required | Unique identifier for the page being tracked                           |
+| `userId`              | `string`                       | Optional | User identifier if user is logged in                                   |
+| `minTimeThreshold`    | `number`                       | `5`      | Minimum time in seconds before recording a view                        |
+| `heartbeatInterval`   | `number`                       | `30`     | How often to send updates in seconds                                   |
+| `inactivityThreshold` | `number`                       | `30`     | Time in seconds before user is considered inactive                     |
+| `onPageView`          | `(data: PageViewData) => void` | Optional | Callback function to handle page view data                             |
+| `trackOnce`           | `boolean`                      | `false`  | Track only the initial view                                            |
+| `trackOnceDelay`      | `number`                       | `0`      | Minimum time in seconds before recording a view when trackOnce is true |
 
-The hook returns an object with the following properties:
+#### Returns
 
 | Property    | Type      | Description                                      |
 | ----------- | --------- | ------------------------------------------------ |
 | `timeSpent` | `number`  | Total time spent on the page in seconds          |
 | `isActive`  | `boolean` | Whether the user is currently active on the page |
 
-### PageViewData Interface
-
-The `onPageView` callback receives a `PageViewData` object with the following structure:
+### PageViewData
 
 ```typescript
 interface PageViewData {
-  pageId: string; // The page identifier
-  userId?: string; // Optional user identifier
-  timeSpent: number; // Time spent in seconds
-  isActive: boolean; // Whether the user is active
+  pageId: string;
+  userId?: string;
+  timeSpent: number;
+  isActive: boolean;
 }
 ```
 
-## Advanced Usage
-
-### Tracking User-Specific Views
+## Examples
 
-```tsx
-function UserProfile() {
-  const { timeSpent, isActive } = usePageView({
-    pageId: 'user-profile',
-    userId: 'user-123', // Track for specific user
-    onPageView: (data) => {
-      // Send to your analytics service
-      analytics.trackPageView(data);
-    },
-  });
-}
-```
-
-### Custom Tracking Intervals
+### Basic Usage
 
 ```tsx
 function Article() {
   const { timeSpent, isActive } = usePageView({
-    pageId: 'article-456',
-    minTimeThreshold: 10, // Only track after 10 seconds
-    heartbeatInterval: 60, // Send updates every minute
-    inactivityThreshold: 120, // Consider user inactive after 2 minutes
+    pageId: 'article-789',
     onPageView: (data) => {
-      // Handle page view data
+      console.log('Article view:', data);
     },
   });
+
+  return (
+    <div>
+      <h1>Article Title</h1>
+      <div>Time spent: {formatTime(timeSpent)}</div>
+      <p>Article content...</p>
+    </div>
+  );
 }
 ```
 
-### One-Time Tracking
+### One-time Tracking
 
 ```tsx
 function LandingPage() {
   const { timeSpent, isActive } = usePageView({
     pageId: 'landing-page',
-    trackOnce: true, // Only track the initial view
-    trackOnceDelay: 5, // Wait 5 seconds before tracking
+    trackOnce: true,
+    trackOnceDelay: 30, // Track after 30 seconds
     onPageView: (data) => {
-      // Handle initial page view
+      analytics.track('landing_page_view', data);
     },
   });
+
+  return (
+    <div>
+      <h1>Welcome</h1>
+      <div>Time on page: {formatTime(timeSpent)}</div>
+    </div>
+  );
 }
 ```
 
-### Custom Time Formatting
+### Error Handling
 
 ```tsx
-function formatTime(seconds: number): string {
-  const mins = Math.floor(seconds / 60);
-  const secs = seconds % 60;
-  return `${mins}:${secs.toString().padStart(2, '0')}`;
-}
-
-function BlogPost() {
+function PageWithErrorHandling() {
   const { timeSpent, isActive } = usePageView({
-    pageId: 'blog-post-123',
-    onPageView: (data) => {
-      // Handle page view data
+    pageId: 'important-page',
+    onPageView: async (data) => {
+      try {
+        const response = await fetch('/api/analytics', {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify(data),
+        });
+
+        if (!response.ok) {
+          throw new Error(`HTTP error! status: ${response.status}`);
+        }
+      } catch (error) {
+        console.error('Analytics tracking failed:', error);
+        // Optionally queue for retry or use alternative tracking
+      }
     },
   });
 
-  return (
-    <div>
-      <div>
-        Time: {formatTime(timeSpent)} {isActive ? '🟢' : '🔴'}
-      </div>
-    </div>
-  );
+  return <div>Your page content</div>;
 }
 ```
 
-## Best Practices
+## Features in Detail
 
-1. **Unique Page IDs**: Always use unique identifiers for each page to ensure accurate tracking.
+### Time Tracking
 
-2. **User Identification**: Include `userId` when tracking authenticated users for better analytics.
+- Tracks total time spent on the page
+- Updates every second
+- Handles browser tab switching and page visibility changes
+- Supports custom initial time values for persistence scenarios
 
-3. **Performance**:
+### Activity Monitoring
 
-   - Use appropriate `heartbeatInterval` values to balance real-time updates with performance
-   - Consider using `trackOnce` for pages where continuous tracking isn't needed
+- Detects user activity through mouse, keyboard, and touch events
+- Monitors page visibility changes
+- Updates active status based on user engagement
+- Configurable inactivity threshold
 
-4. **Error Handling**: Always implement error handling in your `onPageView` callback:
+### Flexible Persistence
 
-```tsx
-const handlePageView = async (data: PageViewData) => {
-  try {
-    await analytics.trackPageView(data);
-  } catch (error) {
-    console.error('Failed to track page view:', error);
-    // Implement fallback or retry logic
-  }
-};
-```
+- No built-in persistence to keep the library lightweight
+- Easy to implement custom persistence strategies
+
+### Callback System
+
+- Periodic updates through `onPageView` callback
+- Configurable update interval with `heartbeatInterval`
+- Minimum time threshold with `minTimeThreshold`
+- One-time tracking option with `trackOnce`
+
+## Performance
+
+- **Minimal overhead**: Efficient event handling with automatic cleanup
+- **Memory efficient**: Uses `requestIdleCallback` when available
+- **Bundle size**: < 5KB minified + gzipped
+- **No dependencies**: Zero external dependencies for maximum compatibility
+- **Automatic cleanup**: All event listeners and timers are cleaned up on unmount
+
+## FAQ
+
+**Q: Does this work with SSR/React Router/Next.js?**
+A: Yes, the hook safely handles server-side rendering by checking for browser environment before initializing.
+
+**Q: How do I persist time tracking across page reloads?**
+A: Implement your own persistence strategy using the examples above. You can use localStorage, sessionStorage, databases, or any other storage method that fits your needs.
+
+**Q: How accurate is the time tracking?**
+A: Time tracking is updated every second and accounts for page visibility changes and user inactivity.
 
-## Browser Support
+**Q: Can I track multiple pages in the same app?**
+A: Yes, use different `pageId` values for each page or component you want to track separately.
 
-The hook uses the following browser APIs:
+**Q: Does this affect my app's performance?**
+A: No, the hook uses efficient event handling and cleanup. The bundle size is minimal (< 3KB).
 
-- `document.visibilitychange`
-- `window.addEventListener` for user activity events
+**Q: What events are considered "activity"?**
+A: Mouse movement, clicks, keyboard input, touch events, and scroll events are all considered user activity.
 
-It's compatible with all modern browsers that support these features.
+**Q: Why doesn't the hook include built-in localStorage support?**
+A: To keep the library lightweight and flexible. Different applications have different persistence needs, and this approach allows you to implement exactly what you need without bloating the core library.
 
 ## Contributing
 
-Contributions are welcome! Please feel free to submit a Pull Request.
+Please read [CONTRIBUTING.md](CONTRIBUTING.md) for details on our code of conduct and the process for submitting pull requests.
 
 ## License
 
-MIT © [Christopher S. Aondona](https://codingsimba.com)
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

package/dist/__tests__/use-page-view.test.js

@@ -179,4 +179,4 @@ Unable to find an `+(r===!1?`accessible `:``)+`element with the role "`+t+`"`+c+
 `+s).trim()},BT=Dw(FT,FT.name,`queryAll`),[VT,HT,UT,WT,GT]=Ow(FT,RT,zT),KT=()=>Q().testIdAttribute,qT=function(){for(var e=arguments.length,t=Array(e),n=0;n<e;n++)t[n]=arguments[n];return xC(t[0]),xw(KT(),...t)},JT=(e,t)=>`Found multiple elements by: [`+KT()+`="`+t+`"]`,YT=(e,t)=>`Unable to find an element by: [`+KT()+`="`+t+`"]`,XT=Dw(qT,qT.name,`queryAll`),[ZT,QT,$T,eE,tE]=Ow(qT,JT,YT);var nE=Object.freeze({__proto__:null,queryAllByLabelText:Vw,queryByLabelText:Fw,getAllByLabelText:zw,getByLabelText:Bw,findAllByLabelText:Lw,findByLabelText:Rw,queryByPlaceholderText:Kw,queryAllByPlaceholderText:Gw,getByPlaceholderText:Jw,getAllByPlaceholderText:qw,findAllByPlaceholderText:Yw,findByPlaceholderText:Xw,queryByText:tT,queryAllByText:eT,getByText:rT,getAllByText:nT,findAllByText:iT,findByText:aT,queryByDisplayValue:uT,queryAllByDisplayValue:lT,getByDisplayValue:fT,getAllByDisplayValue:dT,findAllByDisplayValue:pT,findByDisplayValue:mT,queryByAltText:bT,queryAllByAltText:yT,getByAltText:ST,getAllByAltText:xT,findAllByAltText:CT,findByAltText:wT,queryByTitle:AT,queryAllByTitle:kT,getByTitle:MT,getAllByTitle:jT,findAllByTitle:NT,findByTitle:PT,queryByRole:VT,queryAllByRole:BT,getAllByRole:HT,getByRole:UT,findAllByRole:WT,findByRole:GT,queryByTestId:ZT,queryAllByTestId:XT,getByTestId:$T,getAllByTestId:QT,findAllByTestId:eE,findByTestId:tE});function rE(e,t,n){return t===void 0&&(t=nE),n===void 0&&(n={}),Object.keys(t).reduce((n,r)=>{let i=t[r];return n[r]=i.bind(null,e),n},n)}const iE={copy:{EventType:`ClipboardEvent`,defaultInit:{bubbles:!0,cancelable:!0,composed:!0}},cut:{EventType:`ClipboardEvent`,defaultInit:{bubbles:!0,cancelable:!0,composed:!0}},paste:{EventType:`ClipboardEvent`,defaultInit:{bubbles:!0,cancelable:!0,composed:!0}},compositionEnd:{EventType:`CompositionEvent`,defaultInit:{bubbles:!0,cancelable:!0,composed:!0}},compositionStart:{EventType:`CompositionEvent`,defaultInit:{bubbles:!0,cancelable:!0,composed:!0}},compositionUpdate:{EventType:`CompositionEvent`,defaultInit:{bubbles:!0,cancelable:!0,composed:!0}},keyDown:{EventType:`KeyboardEvent`,defaultInit:{bubbles:!0,cancelable:!0,charCode:0,composed:!0}},keyPress:{EventType:`KeyboardEvent`,defaultInit:{bubbles:!0,cancelable:!0,charCode:0,composed:!0}},keyUp:{EventType:`KeyboardEvent`,defaultInit:{bubbles:!0,cancelable:!0,charCode:0,composed:!0}},focus:{EventType:`FocusEvent`,defaultInit:{bubbles:!1,cancelable:!1,composed:!0}},blur:{EventType:`FocusEvent`,defaultInit:{bubbles:!1,cancelable:!1,composed:!0}},focusIn:{EventType:`FocusEvent`,defaultInit:{bubbles:!0,cancelable:!1,composed:!0}},focusOut:{EventType:`FocusEvent`,defaultInit:{bubbles:!0,cancelable:!1,composed:!0}},change:{EventType:`Event`,defaultInit:{bubbles:!0,cancelable:!1}},input:{EventType:`InputEvent`,defaultInit:{bubbles:!0,cancelable:!1,composed:!0}},invalid:{EventType:`Event`,defaultInit:{bubbles:!1,cancelable:!0}},submit:{EventType:`Event`,defaultInit:{bubbles:!0,cancelable:!0}},reset:{EventType:`Event`,defaultInit:{bubbles:!0,cancelable:!0}},click:{EventType:`MouseEvent`,defaultInit:{bubbles:!0,cancelable:!0,button:0,composed:!0}},contextMenu:{EventType:`MouseEvent`,defaultInit:{bubbles:!0,cancelable:!0,composed:!0}},dblClick:{EventType:`MouseEvent`,defaultInit:{bubbles:!0,cancelable:!0,composed:!0}},drag:{EventType:`DragEvent`,defaultInit:{bubbles:!0,cancelable:!0,composed:!0}},dragEnd:{EventType:`DragEvent`,defaultInit:{bubbles:!0,cancelable:!1,composed:!0}},dragEnter:{EventType:`DragEvent`,defaultInit:{bubbles:!0,cancelable:!0,composed:!0}},dragExit:{EventType:`DragEvent`,defaultInit:{bubbles:!0,cancelable:!1,composed:!0}},dragLeave:{EventType:`DragEvent`,defaultInit:{bubbles:!0,cancelable:!1,composed:!0}},dragOver:{EventType:`DragEvent`,defaultInit:{bubbles:!0,cancelable:!0,composed:!0}},dragStart:{EventType:`DragEvent`,defaultInit:{bubbles:!0,cancelable:!0,composed:!0}},drop:{EventType:`DragEvent`,defaultInit:{bubbles:!0,cancelable:!0,composed:!0}},mouseDown:{EventType:`MouseEvent`,defaultInit:{bubbles:!0,cancelable:!0,composed:!0}},mouseEnter:{EventType:`MouseEvent`,defaultInit:{bubbles:!1,cancelable:!1,composed:!0}},mouseLeave:{EventType:`MouseEvent`,defaultInit:{bubbles:!1,cancelable:!1,composed:!0}},mouseMove:{EventType:`MouseEvent`,defaultInit:{bubbles:!0,cancelable:!0,composed:!0}},mouseOut:{EventType:`MouseEvent`,defaultInit:{bubbles:!0,cancelable:!0,composed:!0}},mouseOver:{EventType:`MouseEvent`,defaultInit:{bubbles:!0,cancelable:!0,composed:!0}},mouseUp:{EventType:`MouseEvent`,defaultInit:{bubbles:!0,cancelable:!0,composed:!0}},select:{EventType:`Event`,defaultInit:{bubbles:!0,cancelable:!1}},touchCancel:{EventType:`TouchEvent`,defaultInit:{bubbles:!0,cancelable:!1,composed:!0}},touchEnd:{EventType:`TouchEvent`,defaultInit:{bubbles:!0,cancelable:!0,composed:!0}},touchMove:{EventType:`TouchEvent`,defaultInit:{bubbles:!0,cancelable:!0,composed:!0}},touchStart:{EventType:`TouchEvent`,defaultInit:{bubbles:!0,cancelable:!0,composed:!0}},resize:{EventType:`UIEvent`,defaultInit:{bubbles:!1,cancelable:!1}},scroll:{EventType:`UIEvent`,defaultInit:{bubbles:!1,cancelable:!1}},wheel:{EventType:`WheelEvent`,defaultInit:{bubbles:!0,cancelable:!0,composed:!0}},abort:{EventType:`Event`,defaultInit:{bubbles:!1,cancelable:!1}},canPlay:{EventType:`Event`,defaultInit:{bubbles:!1,cancelable:!1}},canPlayThrough:{EventType:`Event`,defaultInit:{bubbles:!1,cancelable:!1}},durationChange:{EventType:`Event`,defaultInit:{bubbles:!1,cancelable:!1}},emptied:{EventType:`Event`,defaultInit:{bubbles:!1,cancelable:!1}},encrypted:{EventType:`Event`,defaultInit:{bubbles:!1,cancelable:!1}},ended:{EventType:`Event`,defaultInit:{bubbles:!1,cancelable:!1}},loadedData:{EventType:`Event`,defaultInit:{bubbles:!1,cancelable:!1}},loadedMetadata:{EventType:`Event`,defaultInit:{bubbles:!1,cancelable:!1}},loadStart:{EventType:`ProgressEvent`,defaultInit:{bubbles:!1,cancelable:!1}},pause:{EventType:`Event`,defaultInit:{bubbles:!1,cancelable:!1}},play:{EventType:`Event`,defaultInit:{bubbles:!1,cancelable:!1}},playing:{EventType:`Event`,defaultInit:{bubbles:!1,cancelable:!1}},progress:{EventType:`ProgressEvent`,defaultInit:{bubbles:!1,cancelable:!1}},rateChange:{EventType:`Event`,defaultInit:{bubbles:!1,cancelable:!1}},seeked:{EventType:`Event`,defaultInit:{bubbles:!1,cancelable:!1}},seeking:{EventType:`Event`,defaultInit:{bubbles:!1,cancelable:!1}},stalled:{EventType:`Event`,defaultInit:{bubbles:!1,cancelable:!1}},suspend:{EventType:`Event`,defaultInit:{bubbles:!1,cancelable:!1}},timeUpdate:{EventType:`Event`,defaultInit:{bubbles:!1,cancelable:!1}},volumeChange:{EventType:`Event`,defaultInit:{bubbles:!1,cancelable:!1}},waiting:{EventType:`Event`,defaultInit:{bubbles:!1,cancelable:!1}},load:{EventType:`Event`,defaultInit:{bubbles:!1,cancelable:!1}},error:{EventType:`Event`,defaultInit:{bubbles:!1,cancelable:!1}},animationStart:{EventType:`AnimationEvent`,defaultInit:{bubbles:!0,cancelable:!1}},animationEnd:{EventType:`AnimationEvent`,defaultInit:{bubbles:!0,cancelable:!1}},animationIteration:{EventType:`AnimationEvent`,defaultInit:{bubbles:!0,cancelable:!1}},transitionCancel:{EventType:`TransitionEvent`,defaultInit:{bubbles:!0,cancelable:!1}},transitionEnd:{EventType:`TransitionEvent`,defaultInit:{bubbles:!0,cancelable:!0}},transitionRun:{EventType:`TransitionEvent`,defaultInit:{bubbles:!0,cancelable:!1}},transitionStart:{EventType:`TransitionEvent`,defaultInit:{bubbles:!0,cancelable:!1}},pointerOver:{EventType:`PointerEvent`,defaultInit:{bubbles:!0,cancelable:!0,composed:!0}},pointerEnter:{EventType:`PointerEvent`,defaultInit:{bubbles:!1,cancelable:!1}},pointerDown:{EventType:`PointerEvent`,defaultInit:{bubbles:!0,cancelable:!0,composed:!0}},pointerMove:{EventType:`PointerEvent`,defaultInit:{bubbles:!0,cancelable:!0,composed:!0}},pointerUp:{EventType:`PointerEvent`,defaultInit:{bubbles:!0,cancelable:!0,composed:!0}},pointerCancel:{EventType:`PointerEvent`,defaultInit:{bubbles:!0,cancelable:!1,composed:!0}},pointerOut:{EventType:`PointerEvent`,defaultInit:{bubbles:!0,cancelable:!0,composed:!0}},pointerLeave:{EventType:`PointerEvent`,defaultInit:{bubbles:!1,cancelable:!1}},gotPointerCapture:{EventType:`PointerEvent`,defaultInit:{bubbles:!0,cancelable:!1,composed:!0}},lostPointerCapture:{EventType:`PointerEvent`,defaultInit:{bubbles:!0,cancelable:!1,composed:!0}},popState:{EventType:`PopStateEvent`,defaultInit:{bubbles:!0,cancelable:!1}},offline:{EventType:`Event`,defaultInit:{bubbles:!1,cancelable:!1}},online:{EventType:`Event`,defaultInit:{bubbles:!1,cancelable:!1}}},aE={doubleClick:`dblClick`};function oE(e,t){return Q().eventWrapper(()=>{if(!t)throw Error(`Unable to fire an event - please provide an event object.`);if(!e)throw Error(`Unable to fire a "`+t.type+`" event - please provide a DOM element.`);return e.dispatchEvent(t)})}function sE(e,t,n,r){let{EventType:i=`Event`,defaultInit:a={}}=r===void 0?{}:r;if(!t)throw Error(`Unable to fire a "`+e+`" event - please provide a DOM element.`);let o={...a,...n},{target:{value:s,files:c,...l}={}}=o;s!==void 0&&cE(t,s),c!==void 0&&Object.defineProperty(t,`files`,{configurable:!0,enumerable:!0,writable:!0,value:c}),Object.assign(t,l);let u=bC(t),d=u[i]||u.Event,f;if(typeof d==`function`)f=new d(e,o);else{f=u.document.createEvent(i);let{bubbles:t,cancelable:n,detail:r,...a}=o;f.initEvent(e,t,n,r),Object.keys(a).forEach(e=>{f[e]=a[e]})}let p=[`dataTransfer`,`clipboardData`];return p.forEach(e=>{let t=o[e];typeof t==`object`&&(typeof u.DataTransfer==`function`?Object.defineProperty(f,e,{value:Object.getOwnPropertyNames(t).reduce((e,n)=>(Object.defineProperty(e,n,{value:t[n]}),e),new u.DataTransfer)}):Object.defineProperty(f,e,{value:t}))}),f}Object.keys(iE).forEach(e=>{let{EventType:t,defaultInit:n}=iE[e],r=e.toLowerCase();sE[e]=(e,i)=>sE(r,e,i,{EventType:t,defaultInit:n}),oE[e]=(t,n)=>oE(t,sE[e](t,n))});function cE(e,t){let{set:n}=Object.getOwnPropertyDescriptor(e,`value`)||{},r=Object.getPrototypeOf(e),{set:i}=Object.getOwnPropertyDescriptor(r,`value`)||{};if(i&&n!==i)i.call(e,t);else if(n)n.call(e,t);else throw Error(`The given element does not have a value setter`)}Object.keys(aE).forEach(e=>{let t=aE[e];oE[e]=function(){return oE[t](...arguments)}});function lE(e){return e.replace(/[ \t]*[\n][ \t]*/g,`
 `)}function uE(e){return qS.default.compressToEncodedURIComponent(lE(e))}function dE(e){return`https://testing-playground.com/#markup=`+uE(e)}const fE=(e,t,n)=>Array.isArray(e)?e.forEach(e=>OC(e,t,n)):OC(e,t,n),pE=function(e){if(e===void 0&&(e=yC().body),!e||!(`innerHTML`in e)){console.log(`The element you're providing isn't a valid DOM element.`);return}if(!e.innerHTML){console.log(`The provided element doesn't have any children.`);return}let t=dE(e.innerHTML);return console.log(`Open this URL in your browser
 
-`+t),t},mE={debug:fE,logTestingPlaygroundURL:pE},hE=typeof document<`u`&&document.body?rE(document.body,nE,mE):Object.keys(nE).reduce((e,t)=>(e[t]=()=>{throw TypeError(`For queries bound to document.body a global document has to be available... Learn more: https://testing-library.com/s/screen-global-error`)},e),mE),gE=typeof i.act==`function`?i.act:o.act;function _E(){if(typeof globalThis<`u`)return globalThis;if(typeof self<`u`)return self;if(typeof window<`u`)return window;if(typeof global<`u`)return global;throw Error(`unable to locate global object`)}function vE(e){_E().IS_REACT_ACT_ENVIRONMENT=e}function yE(){return _E().IS_REACT_ACT_ENVIRONMENT}function bE(e){return t=>{let n=yE();vE(!0);try{let r=!1,i=e(()=>{let e=t();return typeof e==`object`&&e&&typeof e.then==`function`&&(r=!0),e});if(r){let e=i;return{then:(t,r)=>{e.then(e=>{vE(n),t(e)},e=>{vE(n),r(e)})}}}else return vE(n),i}catch(e){throw vE(n),e}}}const xE=bE(gE),$=function(){return oE(...arguments)};Object.keys(oE).forEach(e=>{$[e]=function(){return oE[e](...arguments)}});const SE=$.mouseEnter,CE=$.mouseLeave;$.mouseEnter=function(){return SE(...arguments),$.mouseOver(...arguments)},$.mouseLeave=function(){return CE(...arguments),$.mouseOut(...arguments)};const wE=$.pointerEnter,TE=$.pointerLeave;$.pointerEnter=function(){return wE(...arguments),$.pointerOver(...arguments)},$.pointerLeave=function(){return TE(...arguments),$.pointerOut(...arguments)};const EE=$.select;$.select=(e,t)=>{EE(e,t),e.focus(),$.keyUp(e,t)};const DE=$.blur,OE=$.focus;$.blur=function(){return $.focusOut(...arguments),DE(...arguments)},$.focus=function(){return $.focusIn(...arguments),OE(...arguments)};let kE={reactStrictMode:!1};function AE(){return{...Q(),...kE}}function jE(){return typeof jest<`u`&&jest!==null?setTimeout._isMockFunction===!0||Object.prototype.hasOwnProperty.call(setTimeout,`clock`):!1}jC({unstable_advanceTimersWrapper:e=>xE(e),asyncWrapper:async e=>{let t=yE();vE(!1);try{let t=await e();return await new Promise(e=>{setTimeout(()=>{e()},0),jE()&&jest.advanceTimersByTime(0)}),t}finally{vE(t)}},eventWrapper:e=>{let t;return xE(()=>{t=e()}),t}});const ME=new Set,NE=[];function PE(e){return AE().reactStrictMode?i.createElement(i.StrictMode,null,e):e}function FE(e,t){return t?i.createElement(t,null,e):e}function IE(e,t){let{hydrate:n,ui:r,wrapper:i}=t,a;return n?xE(()=>{a=c.hydrateRoot(e,PE(FE(r,i)))}):a=c.createRoot(e),{hydrate(){if(!n)throw Error("Attempted to hydrate a non-hydrateable root. This is a bug in `@testing-library/react`.")},render(e){a.render(e)},unmount(){a.unmount()}}}function LE(e){return{hydrate(t){s.hydrate(t,e)},render(t){s.render(t,e)},unmount(){s.unmountComponentAtNode(e)}}}function RE(e,t){let{baseElement:n,container:r,hydrate:i,queries:a,root:o,wrapper:s}=t;return xE(()=>{i?o.hydrate(PE(FE(e,s)),r):o.render(PE(FE(e,s)),r)}),{container:r,baseElement:n,debug:function(e,t,r){return e===void 0&&(e=n),Array.isArray(e)?e.forEach(e=>console.log(DC(e,t,r))):console.log(DC(e,t,r))},unmount:()=>{xE(()=>{o.unmount()})},rerender:e=>{RE(e,{container:r,baseElement:n,root:o,wrapper:s})},asFragment:()=>{if(typeof document.createRange==`function`)return document.createRange().createContextualFragment(r.innerHTML);{let e=document.createElement(`template`);return e.innerHTML=r.innerHTML,e.content}},...rE(n,a)}}function zE(e,t){let{container:n,baseElement:r=n,legacyRoot:i=!1,queries:a,hydrate:o=!1,wrapper:c}=t===void 0?{}:t;if(i&&typeof s.render!=`function`){let e=Error("`legacyRoot: true` is not supported in this version of React. Please use React 18 instead.");throw Error.captureStackTrace(e,zE),e}r||=document.body,n||=r.appendChild(document.createElement(`div`));let l;if(ME.has(n))NE.forEach(e=>{e.container===n&&(l=e.root)});else{let t=i?LE:IE;l=t(n,{hydrate:o,ui:e,wrapper:c}),NE.push({container:n,root:l}),ME.add(n)}return RE(e,{container:n,baseElement:r,queries:a,hydrate:o,wrapper:c,root:l})}function BE(){NE.forEach(e=>{let{root:t,container:n}=e;xE(()=>{t.unmount()}),n.parentNode===document.body&&document.body.removeChild(n)}),NE.length=0,ME.clear()}function VE(e,t){t===void 0&&(t={});let{initialProps:n,...r}=t;if(r.legacyRoot&&typeof s.render!=`function`){let e=Error("`legacyRoot: true` is not supported in this version of React. Please use React 18 instead.");throw Error.captureStackTrace(e,VE),e}let a=i.createRef();function o(t){let{renderCallbackProps:n}=t,r=e(n);return i.useEffect(()=>{a.current=r}),null}let{rerender:c,unmount:l}=zE(i.createElement(o,{renderCallbackProps:n}),r);function u(e){return c(i.createElement(o,{renderCallbackProps:e}))}return{result:a,rerender:u,unmount:l}}if((typeof process>`u`||!process.env?.RTL_SKIP_AUTO_CLEANUP)&&(typeof afterEach==`function`?afterEach(()=>{BE()}):typeof teardown==`function`&&teardown(()=>{BE()}),typeof beforeAll==`function`&&typeof afterAll==`function`)){let e=yE();beforeAll(()=>{e=yE(),vE(!0)}),afterAll(()=>{vE(e)})}window.IS_REACT_ACT_ENVIRONMENT=!0,ud(`usePageView`,()=>{let e=Hg.fn(),t={pageId:`test-page`,onPageView:e};cf(()=>{Hg.useFakeTimers(),e.mockClear(),Object.defineProperty(document,`hidden`,{configurable:!0,value:!1})}),lf(()=>{Hg.useRealTimers()}),dd(`should initialize with correct default values`,async()=>{let{result:e}=VE(()=>r(t));await a(async()=>{await Promise.resolve()}),wh(e.current.timeSpent).toBe(0),wh(e.current.isActive).toBe(!0)}),dd(`should track time spent correctly`,async()=>{let{result:e}=VE(()=>r(t));await a(async()=>{await Promise.resolve()}),await a(async()=>{Hg.advanceTimersByTime(5e3),await Promise.resolve()}),wh(e.current.timeSpent).toBe(5)}),dd(`should not call onPageView before minTimeThreshold`,async()=>{VE(()=>r({...t,minTimeThreshold:10})),await a(async()=>{await Promise.resolve()}),await a(async()=>{Hg.advanceTimersByTime(5e3),await Promise.resolve()}),wh(e).not.toHaveBeenCalled()}),dd(`should track user activity correctly`,async()=>{let{result:e}=VE(()=>r({...t,inactivityThreshold:5}));await a(async()=>{await Promise.resolve()}),await a(async()=>{document.dispatchEvent(new MouseEvent(`mousemove`)),Hg.advanceTimersByTime(2e3),await Promise.resolve()}),wh(e.current.isActive).toBe(!0),await a(async()=>{Hg.advanceTimersByTime(6e3),await Promise.resolve()}),wh(e.current.isActive).toBe(!1)}),dd(`should handle page visibility changes`,async()=>{let{result:e}=VE(()=>r(t));await a(async()=>{await Promise.resolve()}),await a(async()=>{Object.defineProperty(document,`hidden`,{configurable:!0,value:!0}),document.dispatchEvent(new Event(`visibilitychange`)),await Promise.resolve()}),wh(e.current.isActive).toBe(!1),await a(async()=>{Object.defineProperty(document,`hidden`,{configurable:!0,value:!1}),document.dispatchEvent(new Event(`visibilitychange`)),await Promise.resolve()}),wh(e.current.isActive).toBe(!0)}),dd(`should handle trackOnce option correctly`,async()=>{VE(()=>r({...t,trackOnce:!0,trackOnceDelay:5})),await a(async()=>{await Promise.resolve()}),wh(e).not.toHaveBeenCalled(),await a(async()=>{Hg.advanceTimersByTime(5e3),await Promise.resolve()}),wh(e).toHaveBeenCalledTimes(1),wh(e).toHaveBeenCalledWith({pageId:`test-page`,timeSpent:5,isActive:!0}),await a(async()=>{Hg.advanceTimersByTime(5e3),await Promise.resolve()}),wh(e).toHaveBeenCalledTimes(1)}),dd(`should send final data on unmount`,async()=>{let{unmount:n}=VE(()=>r({...t,minTimeThreshold:5}));await a(async()=>{await Promise.resolve()}),await a(async()=>{Hg.advanceTimersByTime(1e4),await Promise.resolve()}),n(),wh(e).toHaveBeenCalledWith({pageId:`test-page`,timeSpent:10,isActive:!1})})});
+`+t),t},mE={debug:fE,logTestingPlaygroundURL:pE},hE=typeof document<`u`&&document.body?rE(document.body,nE,mE):Object.keys(nE).reduce((e,t)=>(e[t]=()=>{throw TypeError(`For queries bound to document.body a global document has to be available... Learn more: https://testing-library.com/s/screen-global-error`)},e),mE),gE=typeof i.act==`function`?i.act:o.act;function _E(){if(typeof globalThis<`u`)return globalThis;if(typeof self<`u`)return self;if(typeof window<`u`)return window;if(typeof global<`u`)return global;throw Error(`unable to locate global object`)}function vE(e){_E().IS_REACT_ACT_ENVIRONMENT=e}function yE(){return _E().IS_REACT_ACT_ENVIRONMENT}function bE(e){return t=>{let n=yE();vE(!0);try{let r=!1,i=e(()=>{let e=t();return typeof e==`object`&&e&&typeof e.then==`function`&&(r=!0),e});if(r){let e=i;return{then:(t,r)=>{e.then(e=>{vE(n),t(e)},e=>{vE(n),r(e)})}}}else return vE(n),i}catch(e){throw vE(n),e}}}const xE=bE(gE),$=function(){return oE(...arguments)};Object.keys(oE).forEach(e=>{$[e]=function(){return oE[e](...arguments)}});const SE=$.mouseEnter,CE=$.mouseLeave;$.mouseEnter=function(){return SE(...arguments),$.mouseOver(...arguments)},$.mouseLeave=function(){return CE(...arguments),$.mouseOut(...arguments)};const wE=$.pointerEnter,TE=$.pointerLeave;$.pointerEnter=function(){return wE(...arguments),$.pointerOver(...arguments)},$.pointerLeave=function(){return TE(...arguments),$.pointerOut(...arguments)};const EE=$.select;$.select=(e,t)=>{EE(e,t),e.focus(),$.keyUp(e,t)};const DE=$.blur,OE=$.focus;$.blur=function(){return $.focusOut(...arguments),DE(...arguments)},$.focus=function(){return $.focusIn(...arguments),OE(...arguments)};let kE={reactStrictMode:!1};function AE(){return{...Q(),...kE}}function jE(){return typeof jest<`u`&&jest!==null?setTimeout._isMockFunction===!0||Object.prototype.hasOwnProperty.call(setTimeout,`clock`):!1}jC({unstable_advanceTimersWrapper:e=>xE(e),asyncWrapper:async e=>{let t=yE();vE(!1);try{let t=await e();return await new Promise(e=>{setTimeout(()=>{e()},0),jE()&&jest.advanceTimersByTime(0)}),t}finally{vE(t)}},eventWrapper:e=>{let t;return xE(()=>{t=e()}),t}});const ME=new Set,NE=[];function PE(e){return AE().reactStrictMode?i.createElement(i.StrictMode,null,e):e}function FE(e,t){return t?i.createElement(t,null,e):e}function IE(e,t){let{hydrate:n,ui:r,wrapper:i}=t,a;return n?xE(()=>{a=c.hydrateRoot(e,PE(FE(r,i)))}):a=c.createRoot(e),{hydrate(){if(!n)throw Error("Attempted to hydrate a non-hydrateable root. This is a bug in `@testing-library/react`.")},render(e){a.render(e)},unmount(){a.unmount()}}}function LE(e){return{hydrate(t){s.hydrate(t,e)},render(t){s.render(t,e)},unmount(){s.unmountComponentAtNode(e)}}}function RE(e,t){let{baseElement:n,container:r,hydrate:i,queries:a,root:o,wrapper:s}=t;return xE(()=>{i?o.hydrate(PE(FE(e,s)),r):o.render(PE(FE(e,s)),r)}),{container:r,baseElement:n,debug:function(e,t,r){return e===void 0&&(e=n),Array.isArray(e)?e.forEach(e=>console.log(DC(e,t,r))):console.log(DC(e,t,r))},unmount:()=>{xE(()=>{o.unmount()})},rerender:e=>{RE(e,{container:r,baseElement:n,root:o,wrapper:s})},asFragment:()=>{if(typeof document.createRange==`function`)return document.createRange().createContextualFragment(r.innerHTML);{let e=document.createElement(`template`);return e.innerHTML=r.innerHTML,e.content}},...rE(n,a)}}function zE(e,t){let{container:n,baseElement:r=n,legacyRoot:i=!1,queries:a,hydrate:o=!1,wrapper:c}=t===void 0?{}:t;if(i&&typeof s.render!=`function`){let e=Error("`legacyRoot: true` is not supported in this version of React. Please use React 18 instead.");throw Error.captureStackTrace(e,zE),e}r||=document.body,n||=r.appendChild(document.createElement(`div`));let l;if(ME.has(n))NE.forEach(e=>{e.container===n&&(l=e.root)});else{let t=i?LE:IE;l=t(n,{hydrate:o,ui:e,wrapper:c}),NE.push({container:n,root:l}),ME.add(n)}return RE(e,{container:n,baseElement:r,queries:a,hydrate:o,wrapper:c,root:l})}function BE(){NE.forEach(e=>{let{root:t,container:n}=e;xE(()=>{t.unmount()}),n.parentNode===document.body&&document.body.removeChild(n)}),NE.length=0,ME.clear()}function VE(e,t){t===void 0&&(t={});let{initialProps:n,...r}=t;if(r.legacyRoot&&typeof s.render!=`function`){let e=Error("`legacyRoot: true` is not supported in this version of React. Please use React 18 instead.");throw Error.captureStackTrace(e,VE),e}let a=i.createRef();function o(t){let{renderCallbackProps:n}=t,r=e(n);return i.useEffect(()=>{a.current=r}),null}let{rerender:c,unmount:l}=zE(i.createElement(o,{renderCallbackProps:n}),r);function u(e){return c(i.createElement(o,{renderCallbackProps:e}))}return{result:a,rerender:u,unmount:l}}if((typeof process>`u`||!process.env?.RTL_SKIP_AUTO_CLEANUP)&&(typeof afterEach==`function`?afterEach(()=>{BE()}):typeof teardown==`function`&&teardown(()=>{BE()}),typeof beforeAll==`function`&&typeof afterAll==`function`)){let e=yE();beforeAll(()=>{e=yE(),vE(!0)}),afterAll(()=>{vE(e)})}window.IS_REACT_ACT_ENVIRONMENT=!0,ud(`usePageView`,()=>{let e=Hg.fn(),t={pageId:`test-page`,onPageView:e};cf(()=>{Hg.useFakeTimers(),e.mockClear(),Object.defineProperty(document,`hidden`,{configurable:!0,value:!1})}),lf(()=>{Hg.useRealTimers()}),dd(`should initialize with correct default values`,async()=>{let{result:e}=VE(()=>r(t));await a(async()=>{await Promise.resolve()}),wh(e.current.timeSpent).toBe(0),wh(e.current.isActive).toBe(!0)}),dd(`should track time spent correctly`,async()=>{let{result:e}=VE(()=>r(t));await a(async()=>{await Promise.resolve()}),await a(async()=>{Hg.advanceTimersByTime(5e3),await Promise.resolve()}),wh(e.current.timeSpent).toBe(5)}),dd(`should not call onPageView before minTimeThreshold`,async()=>{VE(()=>r({...t,minTimeThreshold:10})),await a(async()=>{await Promise.resolve()}),await a(async()=>{Hg.advanceTimersByTime(5e3),await Promise.resolve()}),wh(e).not.toHaveBeenCalled()}),dd(`should call onPageView after minTimeThreshold`,async()=>{VE(()=>r({...t,minTimeThreshold:10,heartbeatInterval:10})),wh(e).not.toHaveBeenCalled(),await a(async()=>{Hg.advanceTimersByTime(1e4),await Promise.resolve()}),await a(async()=>{Hg.advanceTimersByTime(1e4),await Promise.resolve()}),wh(e).toHaveBeenCalledWith({pageId:`test-page`,timeSpent:10,isActive:!0})}),dd(`should track user activity correctly`,async()=>{let{result:e}=VE(()=>r({...t,inactivityThreshold:5}));await a(async()=>{await Promise.resolve()}),await a(async()=>{document.dispatchEvent(new MouseEvent(`mousemove`)),Hg.advanceTimersByTime(2e3),await Promise.resolve()}),wh(e.current.isActive).toBe(!0),await a(async()=>{Hg.advanceTimersByTime(6e3),await Promise.resolve()}),wh(e.current.isActive).toBe(!1)}),dd(`should handle page visibility changes`,async()=>{let{result:e}=VE(()=>r(t));await a(async()=>{await Promise.resolve()}),await a(async()=>{Object.defineProperty(document,`hidden`,{configurable:!0,value:!0}),document.dispatchEvent(new Event(`visibilitychange`)),await Promise.resolve()}),wh(e.current.isActive).toBe(!1),await a(async()=>{Object.defineProperty(document,`hidden`,{configurable:!0,value:!1}),document.dispatchEvent(new Event(`visibilitychange`)),await Promise.resolve()}),wh(e.current.isActive).toBe(!0)}),dd(`should handle trackOnce option correctly`,async()=>{VE(()=>r({...t,trackOnce:!0,trackOnceDelay:5})),await a(async()=>{await Promise.resolve()}),wh(e).not.toHaveBeenCalled(),await a(async()=>{Hg.advanceTimersByTime(5e3),await Promise.resolve()}),wh(e).toHaveBeenCalledTimes(1),wh(e).toHaveBeenCalledWith({pageId:`test-page`,timeSpent:5,isActive:!0}),await a(async()=>{Hg.advanceTimersByTime(5e3),await Promise.resolve()}),wh(e).toHaveBeenCalledTimes(1)}),dd(`should include userId in page view data when provided`,async()=>{VE(()=>r({...t,userId:`test-user`,minTimeThreshold:5,heartbeatInterval:10})),await a(async()=>{await Promise.resolve()}),await a(async()=>{Hg.advanceTimersByTime(1e4),await Promise.resolve()}),await a(async()=>{Hg.advanceTimersByTime(1e4),await Promise.resolve()}),wh(e).toHaveBeenCalledWith({pageId:`test-page`,userId:`test-user`,timeSpent:10,isActive:!0})}),dd(`should handle custom heartbeat interval`,async()=>{VE(()=>r({...t,minTimeThreshold:5,heartbeatInterval:15})),await a(async()=>{await Promise.resolve()}),await a(async()=>{Hg.advanceTimersByTime(5e3),await Promise.resolve()}),await a(async()=>{Hg.advanceTimersByTime(15e3),await Promise.resolve()}),wh(e).toHaveBeenCalledTimes(1),await a(async()=>{Hg.advanceTimersByTime(15e3),await Promise.resolve()}),wh(e).toHaveBeenCalledTimes(2)}),dd(`should send final data on unmount`,async()=>{let{unmount:n}=VE(()=>r({...t,minTimeThreshold:5}));await a(async()=>{await Promise.resolve()}),await a(async()=>{Hg.advanceTimersByTime(1e4),await Promise.resolve()}),n(),wh(e).toHaveBeenCalledWith({pageId:`test-page`,timeSpent:10,isActive:!1})})});

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "use-page-view",
-  "version": "0.0.1",
-  "description": "React hook for tracking page views",
+  "version": "1.0.1",
+  "description": "A React hook for tracking page views and user engagement time. This hook provides real-time tracking of how long users spend on a page, their activity status, and the ability to persist time tracking across page reloads.",
   "type": "module",
   "main": "dist/index.js",
   "files": [
@@ -9,8 +9,19 @@
   ],
   "keywords": [
     "react",
+    "hooks",
     "page-view",
-    "typescript"
+    "analytics",
+    "tracking",
+    "engagement",
+    "time-tracking",
+    "localstorage",
+    "persistence",
+    "typescript",
+    "react-hooks",
+    "user-activity",
+    "page-visibility",
+    "performance-monitoring"
   ],
   "author": "Christopher S. Aondona <me@codingsimba.com> (https://codingsimba.com)",
   "repository": {
@@ -23,15 +34,17 @@
   },
   "scripts": {
     "build": "tsdown",
-    "test": "vitest",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
     "lint": "tsc",
     "format": "prettier --write .",
     "format:check": "prettier . --check",
     "exports:check": "attw --pack . --ignore-rules=cjs-resolves-to-esm",
-    "release:local": "changeset version && changeset publish",
+    "release:version": "changeset version",
+    "release:local": "changeset && changeset version && changeset publish",
     "prepublishOnly": "npm run ci",
-    "test:browser": "vitest run",
-    "ci": "npm run build && npm run format:check && npm run lint"
+    "ci": "npm run build && npm run format:check && npm run lint && npm run exports:check && npm run test"
   },
   "license": "MIT",
   "dependencies": {
@@ -47,6 +60,7 @@
     "@types/react-dom": "^19.1.0",
     "@vitejs/plugin-react": "^4.5.1",
     "@vitest/browser": "^3.2.0",
+    "@vitest/coverage-v8": "^3.2.2",
     "playwright": "^1.52.0",
     "prettier": "^3.5.3",
     "tsdown": "^0.12.6",