@kitbase/analytics 0.1.6 → 0.1.7

package/README.md

@@ -74,6 +74,7 @@ const kitbase = new Kitbase({
 
   analytics: {
     autoTrackPageViews: true,      // track route changes automatically
+    trackBfcacheRestore: true,     // track pageview on bfcache restore (back/forward in MPAs)
     autoTrackOutboundLinks: true,  // track external link clicks
     autoTrackClicks: true,         // track button/link/input clicks + data-kb-track-click
     autoTrackScrollDepth: true,    // track max scroll depth per page
@@ -103,6 +104,7 @@ All enabled by default. The SDK automatically tracks:
 | Event | Channel | Trigger | Config |
 |-------|---------|---------|--------|
 | `screen_view` | `__analytics` | Page navigation (init, pushState, popstate) | `autoTrackPageViews` (default `true`) |
+| `screen_view` | `__analytics` | Page restored from bfcache (back/forward in MPAs) | `trackBfcacheRestore` (default `true`) |
 | `outbound_link` | `__analytics` | Click on external link | `autoTrackOutboundLinks` (default `true`) |
 | `click` | `__analytics` | Click on interactive element | `autoTrackClicks` (default `true`) |
 | `scroll_depth` | `__analytics` | Navigation / unload (max depth per page) | `autoTrackScrollDepth` (default `true`) |
@@ -110,7 +112,7 @@ All enabled by default. The SDK automatically tracks:
 | `dead_click` | `__analytics` | Click with no DOM change within 1s | `autoDetectFrustration` (default `true`) |
 | `web_vitals` | `__analytics` | Once per page load | `autoTrackWebVitals` (default `false`) |
 
-Page views, clicks, outbound links, scroll depth, and frustration signals are tracked automatically. The SDK intercepts `history.pushState`/`popstate` for SPA support — no framework router integration needed.
+Page views, clicks, outbound links, scroll depth, and frustration signals are tracked automatically. The SDK intercepts `history.pushState`/`popstate` for SPA support — no framework router integration needed. For multi-page sites, the SDK also listens for bfcache restores (`pageshow` with `persisted`) so back/forward navigation is counted even when scripts don't re-execute.
 
 ## Data Attribute Events
 

package/dist/index.cjs

@@ -1514,6 +1514,7 @@ var PageViewPlugin = class {
   ctx;
   active = false;
   popstateListener = null;
+  pageshowListener = null;
   setup(ctx) {
     if (typeof window === "undefined") return false;
     this.ctx = ctx;
@@ -1540,6 +1541,14 @@ var PageViewPlugin = class {
       }
     };
     window.addEventListener("popstate", this.popstateListener);
+    if (ctx.config.trackBfcacheRestore !== false) {
+      this.pageshowListener = (e) => {
+        if (e.persisted && this.active) {
+          this.trackPageView().catch((err) => ctx.log("Failed to track page view (bfcache)", err));
+        }
+      };
+      window.addEventListener("pageshow", this.pageshowListener);
+    }
     ctx.log("Auto page view tracking enabled");
   }
   teardown() {
@@ -1548,6 +1557,10 @@ var PageViewPlugin = class {
       window.removeEventListener("popstate", this.popstateListener);
       this.popstateListener = null;
     }
+    if (this.pageshowListener) {
+      window.removeEventListener("pageshow", this.pageshowListener);
+      this.pageshowListener = null;
+    }
   }
   get methods() {
     return {