elseware-ui 2.40.1 → 2.40.2

package/dist/index.d.mts

@@ -294,6 +294,20 @@ interface UsePageTrackingOptions {
     fullUrl?: string;
     metadata?: Record<string, unknown>;
     enabled?: boolean;
+    /**
+  
+     * Disabled by default for lightweight analytics.
+  
+     * Enable only when you really need time-on-page.
+  
+     */
+    trackPageLeave?: boolean;
+    /**
+  
+     * Prevents duplicate page_view events for the same path in the same mount cycle.
+  
+     */
+    dedupe?: boolean;
 }
 interface UseSessionTrackingOptions {
     enabled?: boolean;
@@ -366,7 +380,7 @@ declare const useCookieConsent: () => {
     resetConsent: () => void;
 };
 
-declare const usePageTracking: ({ path, search, title, fullUrl, metadata, enabled, }: UsePageTrackingOptions) => void;
+declare const usePageTracking: ({ path, search, title, fullUrl, metadata, enabled, trackPageLeave, dedupe, }: UsePageTrackingOptions) => void;
 
 declare const useSessionTracking: ({ enabled, metadata, }?: UseSessionTrackingOptions) => void;
 

package/dist/index.d.ts

@@ -294,6 +294,20 @@ interface UsePageTrackingOptions {
     fullUrl?: string;
     metadata?: Record<string, unknown>;
     enabled?: boolean;
+    /**
+  
+     * Disabled by default for lightweight analytics.
+  
+     * Enable only when you really need time-on-page.
+  
+     */
+    trackPageLeave?: boolean;
+    /**
+  
+     * Prevents duplicate page_view events for the same path in the same mount cycle.
+  
+     */
+    dedupe?: boolean;
 }
 interface UseSessionTrackingOptions {
     enabled?: boolean;
@@ -366,7 +380,7 @@ declare const useCookieConsent: () => {
     resetConsent: () => void;
 };
 
-declare const usePageTracking: ({ path, search, title, fullUrl, metadata, enabled, }: UsePageTrackingOptions) => void;
+declare const usePageTracking: ({ path, search, title, fullUrl, metadata, enabled, trackPageLeave, dedupe, }: UsePageTrackingOptions) => void;
 
 declare const useSessionTracking: ({ enabled, metadata, }?: UseSessionTrackingOptions) => void;
 

package/dist/index.js

@@ -29614,17 +29614,29 @@ var usePageTracking = ({
   title,
   fullUrl,
   metadata,
-  enabled = true
+  enabled = true,
+  trackPageLeave = false,
+  dedupe = true
 }) => {
   const { track } = useAnalytics();
+  const trackRef = React25.useRef(track);
   const enteredAtRef = React25.useRef(Date.now());
   const previousPathRef = React25.useRef(null);
+  const trackedPathsRef = React25.useRef(/* @__PURE__ */ new Set());
+  React25.useEffect(() => {
+    trackRef.current = track;
+  }, [track]);
+  const metadataKey = React25.useMemo(() => JSON.stringify(metadata ?? {}), [metadata]);
   React25.useEffect(() => {
     if (!enabled) return;
     const nextPath = `${path2}${search3}`;
-    if (previousPathRef.current) {
+    if (!nextPath) return;
+    if (dedupe && trackedPathsRef.current.has(nextPath)) {
+      return;
+    }
+    if (trackPageLeave && previousPathRef.current) {
       const durationMs = Date.now() - enteredAtRef.current;
-      track("page_leave", {
+      trackRef.current("page_leave", {
         path: previousPathRef.current,
         durationMs,
         metadata
@@ -29632,21 +29644,32 @@ var usePageTracking = ({
     }
     enteredAtRef.current = Date.now();
     previousPathRef.current = nextPath;
-    track("page_view", {
+    trackedPathsRef.current.add(nextPath);
+    trackRef.current("page_view", {
       path: nextPath,
       title,
       fullUrl,
       metadata
     });
     return () => {
+      if (!trackPageLeave) return;
       const durationMs = Date.now() - enteredAtRef.current;
-      track("page_leave", {
+      trackRef.current("page_leave", {
         path: nextPath,
         durationMs,
         metadata
       });
     };
-  }, [enabled, fullUrl, metadata, path2, search3, title, track]);
+  }, [
+    dedupe,
+    enabled,
+    fullUrl,
+    metadataKey,
+    path2,
+    search3,
+    title,
+    trackPageLeave
+  ]);
 };
 var useSessionTracking = ({
   enabled = true,