@kitbase/analytics 0.1.6 → 0.1.7

package/dist/index.d.cts

@@ -346,6 +346,13 @@ interface AnalyticsConfig$1 {
      * @default true
      */
     autoTrackPageViews?: boolean;
+    /**
+     * Track pageviews on bfcache restore (browser back/forward in MPAs).
+     * When enabled, a pageview is sent when the page is restored from the
+     * browser's back-forward cache (the `pageshow` event with `persisted`).
+     * @default true
+     */
+    trackBfcacheRestore?: boolean;
     /**
      * Enable automatic outbound link click tracking
      * Tracks when users click links to external domains
@@ -541,6 +548,13 @@ interface AnalyticsConfig {
      * @default true
      */
     autoTrackPageViews?: boolean;
+    /**
+     * Track pageviews on bfcache restore (browser back/forward in MPAs).
+     * When enabled, a pageview is sent when the page is restored from the
+     * browser's back-forward cache (the `pageshow` event with `persisted`).
+     * @default true
+     */
+    trackBfcacheRestore?: boolean;
     /**
      * Enable automatic outbound link click tracking
      * Tracks when users click links to external domains
@@ -1147,6 +1161,7 @@ declare class PageViewPlugin implements KitbasePlugin {
     private ctx;
     private active;
     private popstateListener;
+    private pageshowListener;
     setup(ctx: PluginContext): void | false;
     teardown(): void;
     get methods(): {

package/dist/index.d.ts

@@ -346,6 +346,13 @@ interface AnalyticsConfig$1 {
      * @default true
      */
     autoTrackPageViews?: boolean;
+    /**
+     * Track pageviews on bfcache restore (browser back/forward in MPAs).
+     * When enabled, a pageview is sent when the page is restored from the
+     * browser's back-forward cache (the `pageshow` event with `persisted`).
+     * @default true
+     */
+    trackBfcacheRestore?: boolean;
     /**
      * Enable automatic outbound link click tracking
      * Tracks when users click links to external domains
@@ -541,6 +548,13 @@ interface AnalyticsConfig {
      * @default true
      */
     autoTrackPageViews?: boolean;
+    /**
+     * Track pageviews on bfcache restore (browser back/forward in MPAs).
+     * When enabled, a pageview is sent when the page is restored from the
+     * browser's back-forward cache (the `pageshow` event with `persisted`).
+     * @default true
+     */
+    trackBfcacheRestore?: boolean;
     /**
      * Enable automatic outbound link click tracking
      * Tracks when users click links to external domains
@@ -1147,6 +1161,7 @@ declare class PageViewPlugin implements KitbasePlugin {
     private ctx;
     private active;
     private popstateListener;
+    private pageshowListener;
     setup(ctx: PluginContext): void | false;
     teardown(): void;
     get methods(): {

package/dist/index.js

@@ -1459,6 +1459,7 @@ var PageViewPlugin = class {
   ctx;
   active = false;
   popstateListener = null;
+  pageshowListener = null;
   setup(ctx) {
     if (typeof window === "undefined") return false;
     this.ctx = ctx;
@@ -1485,6 +1486,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() {
@@ -1493,6 +1502,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 {