featurely-site-manager 1.1.9 → 1.1.11

package/dist/index.d.mts

@@ -105,6 +105,7 @@ declare class SiteManager {
     private consecutiveFetchFailures;
     private pageTrackingSetup;
     private currentPagePath;
+    private currentPageSearch;
     private pageEntryTime;
     private static readonly MAX_CONSECUTIVE_FAILURES;
     private lastVersionCheck;
@@ -128,6 +129,7 @@ declare class SiteManager {
     private flushAnalytics;
     private setupPageTracking;
     private trackPageView;
+    private trackPageExit;
     private onNavigate;
     private generateSessionId;
     checkVersion(currentVersion?: string): Promise<VersionCheckResponse | null>;

package/dist/index.d.ts

@@ -105,6 +105,7 @@ declare class SiteManager {
     private consecutiveFetchFailures;
     private pageTrackingSetup;
     private currentPagePath;
+    private currentPageSearch;
     private pageEntryTime;
     private static readonly MAX_CONSECUTIVE_FAILURES;
     private lastVersionCheck;
@@ -128,6 +129,7 @@ declare class SiteManager {
     private flushAnalytics;
     private setupPageTracking;
     private trackPageView;
+    private trackPageExit;
     private onNavigate;
     private generateSessionId;
     checkVersion(currentVersion?: string): Promise<VersionCheckResponse | null>;

package/dist/index.js

@@ -50,6 +50,7 @@ var _SiteManager = class _SiteManager {
     this.consecutiveFetchFailures = 0;
     this.pageTrackingSetup = false;
     this.currentPagePath = "";
+    this.currentPageSearch = "";
     this.pageEntryTime = 0;
     this.lastVersionCheck = null;
     var _a, _b, _c, _d, _e;
@@ -379,7 +380,7 @@ var _SiteManager = class _SiteManager {
       this.analyticsFlushIntervalId = null;
     }
   }
-  async flushAnalytics() {
+  async flushAnalytics(useBeacon = false) {
     if (this.analyticsQueue.length === 0) {
       return;
     }
@@ -396,16 +397,27 @@ var _SiteManager = class _SiteManager {
         platform: typeof navigator !== "undefined" ? navigator.platform : void 0,
         appVersion: this.config.appVersion
       });
-      const sentViaBeacon = typeof navigator !== "undefined" && typeof navigator.sendBeacon === "function" && navigator.sendBeacon(url, payload);
-      if (!sentViaBeacon) {
+      if (useBeacon) {
+        if (typeof navigator !== "undefined" && typeof navigator.sendBeacon === "function") {
+          navigator.sendBeacon(url, payload);
+        }
+      } else {
         try {
-          await fetch(url, {
+          const res = await fetch(url, {
             method: "POST",
             headers: { "Content-Type": "application/json" },
-            body: payload
+            body: payload,
+            keepalive: true
           });
-        } catch (error) {
-          console.error("Failed to send analytics event:", error);
+          if (!res.ok) {
+            const body = await res.text().catch(() => "(unreadable)");
+            console.error(`[Featurely] Analytics event "${event.eventName}" rejected: ${res.status} ${res.statusText} \u2014 ${body}`);
+          }
+        } catch (fetchError) {
+          const sentViaBeacon = typeof navigator !== "undefined" && typeof navigator.sendBeacon === "function" && navigator.sendBeacon(url, payload);
+          if (!sentViaBeacon) {
+            console.error(`[Featurely] Failed to send analytics event "${event.eventName}":`, fetchError);
+          }
         }
       }
     }
@@ -421,8 +433,9 @@ var _SiteManager = class _SiteManager {
       isLoggedIn: !!this.config.userId
     });
     this.currentPagePath = window.location.pathname;
+    this.currentPageSearch = window.location.search;
     this.pageEntryTime = Date.now();
-    this.trackPageView();
+    this.trackPageView(this.currentPagePath);
     setTimeout(() => this.flushAnalytics(), 2e3);
     const originalPushState = history.pushState.bind(history);
     const originalReplaceState = history.replaceState.bind(history);
@@ -433,29 +446,35 @@ var _SiteManager = class _SiteManager {
     };
     history.replaceState = function(...args) {
       originalReplaceState(...args);
-      if (window.location.pathname !== self.currentPagePath) {
+      const nextFull = window.location.pathname + window.location.search;
+      const prevFull = self.currentPagePath + self.currentPageSearch;
+      if (nextFull !== prevFull) {
         self.onNavigate();
       }
     };
     window.addEventListener("popstate", () => this.onNavigate());
+    window.addEventListener("hashchange", () => {
+      if (window.location.pathname !== this.currentPagePath) {
+        this.onNavigate();
+      }
+    });
     window.addEventListener("visibilitychange", () => {
       if (document.visibilityState === "hidden") {
-        const duration = Math.round((Date.now() - this.pageEntryTime) / 1e3);
-        if (duration > 0) {
-          this.trackEvent("page_exit", {
-            path: this.currentPagePath,
-            durationSeconds: duration
-          });
-          this.flushAnalytics();
-        }
+        this.trackPageExit();
+        this.flushAnalytics(true);
       } else if (document.visibilityState === "visible") {
         this.pageEntryTime = Date.now();
       }
     });
+    window.addEventListener("pagehide", () => {
+      this.trackPageExit();
+      this.flushAnalytics(true);
+    });
   }
-  trackPageView() {
+  /** Track a page_view for a captured path (path passed in to avoid closure bugs on rapid nav). */
+  trackPageView(path) {
     const props = {
-      path: this.currentPagePath,
+      path,
       title: document.title,
       referrer: document.referrer || "",
       isLoggedIn: !!this.config.userId
@@ -464,23 +483,29 @@ var _SiteManager = class _SiteManager {
     if (this.config.userEmail) props.userEmail = this.config.userEmail;
     this.trackEvent("page_view", props);
   }
+  /** Record how long the user spent on the current page (called before navigation or unload). */
+  trackPageExit() {
+    if (!this.currentPagePath || this.pageEntryTime <= 0) return;
+    const duration = Math.round((Date.now() - this.pageEntryTime) / 1e3);
+    this.trackEvent("page_exit", {
+      path: this.currentPagePath,
+      durationSeconds: duration
+      // 0 is valid — records bounces/instant navigation
+    });
+    this.pageEntryTime = 0;
+  }
   onNavigate() {
     const newPath = window.location.pathname;
-    if (this.currentPagePath && this.pageEntryTime > 0) {
-      const duration = Math.round((Date.now() - this.pageEntryTime) / 1e3);
-      if (duration > 0) {
-        this.trackEvent("page_exit", {
-          path: this.currentPagePath,
-          durationSeconds: duration
-        });
-      }
-    }
+    const newSearch = window.location.search;
+    this.trackPageExit();
     this.currentPagePath = newPath;
+    this.currentPageSearch = newSearch;
     this.pageEntryTime = Date.now();
+    const capturedPath = newPath;
     setTimeout(() => {
-      this.trackPageView();
+      this.trackPageView(capturedPath);
       this.flushAnalytics();
-    }, 100);
+    }, 150);
   }
   generateSessionId() {
     if (typeof crypto !== "undefined" && crypto.getRandomValues) {

package/dist/index.mjs

@@ -15,6 +15,7 @@ var _SiteManager = class _SiteManager {
     this.consecutiveFetchFailures = 0;
     this.pageTrackingSetup = false;
     this.currentPagePath = "";
+    this.currentPageSearch = "";
     this.pageEntryTime = 0;
     this.lastVersionCheck = null;
     var _a, _b, _c, _d, _e;
@@ -344,7 +345,7 @@ var _SiteManager = class _SiteManager {
       this.analyticsFlushIntervalId = null;
     }
   }
-  async flushAnalytics() {
+  async flushAnalytics(useBeacon = false) {
     if (this.analyticsQueue.length === 0) {
       return;
     }
@@ -361,16 +362,27 @@ var _SiteManager = class _SiteManager {
         platform: typeof navigator !== "undefined" ? navigator.platform : void 0,
         appVersion: this.config.appVersion
       });
-      const sentViaBeacon = typeof navigator !== "undefined" && typeof navigator.sendBeacon === "function" && navigator.sendBeacon(url, payload);
-      if (!sentViaBeacon) {
+      if (useBeacon) {
+        if (typeof navigator !== "undefined" && typeof navigator.sendBeacon === "function") {
+          navigator.sendBeacon(url, payload);
+        }
+      } else {
         try {
-          await fetch(url, {
+          const res = await fetch(url, {
             method: "POST",
             headers: { "Content-Type": "application/json" },
-            body: payload
+            body: payload,
+            keepalive: true
           });
-        } catch (error) {
-          console.error("Failed to send analytics event:", error);
+          if (!res.ok) {
+            const body = await res.text().catch(() => "(unreadable)");
+            console.error(`[Featurely] Analytics event "${event.eventName}" rejected: ${res.status} ${res.statusText} \u2014 ${body}`);
+          }
+        } catch (fetchError) {
+          const sentViaBeacon = typeof navigator !== "undefined" && typeof navigator.sendBeacon === "function" && navigator.sendBeacon(url, payload);
+          if (!sentViaBeacon) {
+            console.error(`[Featurely] Failed to send analytics event "${event.eventName}":`, fetchError);
+          }
         }
       }
     }
@@ -386,8 +398,9 @@ var _SiteManager = class _SiteManager {
       isLoggedIn: !!this.config.userId
     });
     this.currentPagePath = window.location.pathname;
+    this.currentPageSearch = window.location.search;
     this.pageEntryTime = Date.now();
-    this.trackPageView();
+    this.trackPageView(this.currentPagePath);
     setTimeout(() => this.flushAnalytics(), 2e3);
     const originalPushState = history.pushState.bind(history);
     const originalReplaceState = history.replaceState.bind(history);
@@ -398,29 +411,35 @@ var _SiteManager = class _SiteManager {
     };
     history.replaceState = function(...args) {
       originalReplaceState(...args);
-      if (window.location.pathname !== self.currentPagePath) {
+      const nextFull = window.location.pathname + window.location.search;
+      const prevFull = self.currentPagePath + self.currentPageSearch;
+      if (nextFull !== prevFull) {
         self.onNavigate();
       }
     };
     window.addEventListener("popstate", () => this.onNavigate());
+    window.addEventListener("hashchange", () => {
+      if (window.location.pathname !== this.currentPagePath) {
+        this.onNavigate();
+      }
+    });
     window.addEventListener("visibilitychange", () => {
       if (document.visibilityState === "hidden") {
-        const duration = Math.round((Date.now() - this.pageEntryTime) / 1e3);
-        if (duration > 0) {
-          this.trackEvent("page_exit", {
-            path: this.currentPagePath,
-            durationSeconds: duration
-          });
-          this.flushAnalytics();
-        }
+        this.trackPageExit();
+        this.flushAnalytics(true);
       } else if (document.visibilityState === "visible") {
         this.pageEntryTime = Date.now();
       }
     });
+    window.addEventListener("pagehide", () => {
+      this.trackPageExit();
+      this.flushAnalytics(true);
+    });
   }
-  trackPageView() {
+  /** Track a page_view for a captured path (path passed in to avoid closure bugs on rapid nav). */
+  trackPageView(path) {
     const props = {
-      path: this.currentPagePath,
+      path,
       title: document.title,
       referrer: document.referrer || "",
       isLoggedIn: !!this.config.userId
@@ -429,23 +448,29 @@ var _SiteManager = class _SiteManager {
     if (this.config.userEmail) props.userEmail = this.config.userEmail;
     this.trackEvent("page_view", props);
   }
+  /** Record how long the user spent on the current page (called before navigation or unload). */
+  trackPageExit() {
+    if (!this.currentPagePath || this.pageEntryTime <= 0) return;
+    const duration = Math.round((Date.now() - this.pageEntryTime) / 1e3);
+    this.trackEvent("page_exit", {
+      path: this.currentPagePath,
+      durationSeconds: duration
+      // 0 is valid — records bounces/instant navigation
+    });
+    this.pageEntryTime = 0;
+  }
   onNavigate() {
     const newPath = window.location.pathname;
-    if (this.currentPagePath && this.pageEntryTime > 0) {
-      const duration = Math.round((Date.now() - this.pageEntryTime) / 1e3);
-      if (duration > 0) {
-        this.trackEvent("page_exit", {
-          path: this.currentPagePath,
-          durationSeconds: duration
-        });
-      }
-    }
+    const newSearch = window.location.search;
+    this.trackPageExit();
     this.currentPagePath = newPath;
+    this.currentPageSearch = newSearch;
     this.pageEntryTime = Date.now();
+    const capturedPath = newPath;
     setTimeout(() => {
-      this.trackPageView();
+      this.trackPageView(capturedPath);
       this.flushAnalytics();
-    }, 100);
+    }, 150);
   }
   generateSessionId() {
     if (typeof crypto !== "undefined" && crypto.getRandomValues) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "featurely-site-manager",
-  "version": "1.1.9",
+  "version": "1.1.11",
   "description": "Complete site management SDK for maintenance mode, status messages, feature flags, version checking, and analytics",
   "main": "dist/index.js",
   "module": "dist/index.mjs",