@builtonveya/analytics-web 4.0.0 → 4.0.2

package/dist/veya-analytics.js

@@ -1,4 +1,4 @@
-/*! @builtonveya/analytics-web v4.0.0 — https://github.com/adam-3owl/veya-analytics-api */
+/*! @builtonveya/analytics-web v4.0.2 — https://github.com/adam-3owl/veya-analytics-api */
 "use strict";
 var VeyaAnalyticsSDK = (() => {
   var __defProp = Object.defineProperty;
@@ -37,8 +37,7 @@ var VeyaAnalyticsSDK = (() => {
     tenantId: "",
     storeId: "",
     storeName: "",
-    endpoint: "https://analytics.veya.io/v1/events",
-    aiEndpoint: "https://analytics.veya.io/v1/classify",
+    endpoint: "https://analytics.builtonveya.com/v1/events",
     batchSize: 10,
     flushInterval: 5e3,
     sessionTimeout: 30 * 60 * 1e3,
@@ -46,8 +45,8 @@ var VeyaAnalyticsSDK = (() => {
     autoDetect: true,
     autoTrackProducts: true,
     autoTrackCart: true,
-    interceptOloApi: true,
-    useAiClassification: true,
+    // Opt-in: patches window.fetch and reads order/basket responses as placed orders
+    interceptOloApi: false,
     confidenceThreshold: 0.7,
     platform: "web"
   };
@@ -65,6 +64,8 @@ var VeyaAnalyticsSDK = (() => {
     constructor() {
       __publicField(this, "config");
       __publicField(this, "initialized", false);
+      // The in-flight (or completed) init run, shared by every init() call — see init()
+      __publicField(this, "initPromise", null);
       __publicField(this, "eventQueue", []);
       __publicField(this, "flushTimer", null);
       // Identifiers
@@ -95,11 +96,27 @@ var VeyaAnalyticsSDK = (() => {
     // ============================================================================
     // INITIALIZATION
     // ============================================================================
-    async init(options) {
-      if (this.initialized) {
-        this.log("warn", "SDK already initialized");
-        return this;
+    /**
+     * Initialize the SDK. Safe to call more than once: a call made while another is still in
+     * flight shares that run (React StrictMode's double effects, or two call sites, can't set up
+     * listeners or send session_start twice), and a call after a successful init resolves at once.
+     * A failed init (e.g. a missing tenantSlug) can be retried with corrected options.
+     *
+     * Platform SDKs set their platform by overriding init() and passing it through, and do their
+     * own setup in onInitialized(), which runs exactly once.
+     */
+    init(options) {
+      if (this.initPromise) {
+        if (this.initialized) this.log("warn", "SDK already initialized");
+        return this.initPromise;
       }
+      this.initPromise = this.runInit(options).catch((error) => {
+        if (!this.initialized) this.initPromise = null;
+        throw error;
+      });
+      return this.initPromise;
+    }
+    async runInit(options) {
       if (!options.tenantSlug && !options.tenantId) {
         throw new Error("VeyaAnalytics: tenantSlug is required");
       }
@@ -108,19 +125,30 @@ var VeyaAnalyticsSDK = (() => {
         this.config.tenantSlug = this.config.tenantId;
       }
       await this.initVisitor();
-      await this.initSession();
+      const isNewSession = await this.initSession();
       this.deviceInfo = await this.getDeviceInfo();
       this.startFlushTimer();
-      this.trackSessionStart();
       this.initialized = true;
+      if (isNewSession) {
+        this.trackSessionStart();
+      }
       this.log("info", "VeyaAnalytics initialized", {
         tenantSlug: this.config.tenantSlug,
         visitorId: this.visitorId,
         sessionId: this.sessionId,
-        platform: this.config.platform
+        platform: this.config.platform,
+        newSession: isNewSession
       });
+      try {
+        await this.onInitialized();
+      } catch (error) {
+        this.log("error", "Platform setup failed", error);
+      }
       return this;
     }
+    /** Platform hook: runs exactly once per instance, after the core is initialized. */
+    async onInitialized() {
+    }
     async initVisitor() {
       if (!this.storage) {
         this.visitorId = generateUUID();
@@ -134,10 +162,11 @@ var VeyaAnalyticsSDK = (() => {
         await this.storage.setItem("veya_visitor_id", this.visitorId);
       }
     }
+    /** Resolves true when a new session was started, false when a stored one was resumed. */
     async initSession() {
       if (!this.storage) {
         this.sessionId = generateUUID();
-        return;
+        return true;
       }
       const stored = await this.storage.getItem("veya_session");
       const now = Date.now();
@@ -148,13 +177,14 @@ var VeyaAnalyticsSDK = (() => {
             this.sessionId = sessionData.sessionId;
             this.sessionData = { ...this.sessionData, ...sessionData.data };
             await this.saveSession();
-            return;
+            return false;
           }
         } catch (e) {
         }
       }
       this.sessionId = generateUUID();
       await this.saveSession();
+      return true;
     }
     async saveSession() {
       if (!this.storage) return;
@@ -247,7 +277,7 @@ var VeyaAnalyticsSDK = (() => {
       delete sanitized.referrer;
       delete sanitized.funnel_step;
       delete sanitized.funnel_step_number;
-      const piiFields = ["email", "phone", "password", "ssn", "credit_card", "cvv"];
+      const piiFields = ["email", "phone", "password", "ssn", "credit_card", "cvv", "address", "street", "postal_code", "zip"];
       piiFields.forEach((field) => delete sanitized[field]);
       return sanitized;
     }
@@ -402,6 +432,19 @@ var VeyaAnalyticsSDK = (() => {
         ...properties
       });
     }
+    /**
+     * The shopper chose or entered a payment method. Sends add_payment_info with
+     * { payment_method } at funnel step checkout_payment (4); the cart value and item count ride
+     * on the event itself, as on every event (matching the v1 bundle's addPaymentInfo).
+     */
+    addPaymentInfo(paymentMethod, properties = {}) {
+      return this.track("add_payment_info", {
+        payment_method: paymentMethod,
+        funnel_step: "checkout_payment",
+        funnel_step_number: 4,
+        ...properties
+      });
+    }
     checkoutComplete(order, properties = {}) {
       this.updateFunnelStep("confirmation");
       const event = this.track("checkout_complete", {
@@ -728,6 +771,7 @@ var VeyaAnalyticsSDK = (() => {
       titlePatterns: []
     }
   };
+  var SCROLL_DEPTHS = [25, 50, 75, 100];
   var VeyaAnalyticsWeb = class extends VeyaAnalyticsCore {
     constructor() {
       super();
@@ -735,11 +779,18 @@ var VeyaAnalyticsSDK = (() => {
       this.productTracker = null;
       this.cartTracker = null;
       this.networkInterceptor = null;
+      // Page-level state for time_on_page and scroll depth; both reset on every page view
+      this.pageStartedAt = Date.now();
+      this.scrollDepthsFired = /* @__PURE__ */ new Set();
+      this.scrollCheckPending = false;
       this.storage = new LocalStorageAdapter();
     }
-    async init(options) {
-      options.platform = "web";
-      await super.init(options);
+    init(options) {
+      return super.init({ ...options, platform: "web" });
+    }
+    // Runs exactly once, after the core is initialized (see VeyaAnalyticsCore.init)
+    async onInitialized() {
+      this.pageStartedAt = Date.now();
       if (this.config.autoDetect) {
         this.setupPageChangeDetection();
       }
@@ -756,8 +807,9 @@ var VeyaAnalyticsSDK = (() => {
         this.networkInterceptor.init();
       }
       this.setupBrowserListeners();
-      this.trackCurrentPage();
-      return this;
+      if (this.config.autoDetect) {
+        this.trackCurrentPage();
+      }
     }
     async getDeviceInfo() {
       const ua = navigator.userAgent;
@@ -887,6 +939,13 @@ var VeyaAnalyticsSDK = (() => {
         ...this.getUTMParams()
       });
     }
+    // Every page view (SDK-detected or sent by the app) starts a new page: time_on_page restarts and
+    // the scroll-depth thresholds can fire again.
+    pageView(properties = {}) {
+      this.pageStartedAt = Date.now();
+      this.scrollDepthsFired.clear();
+      return super.pageView(properties);
+    }
     getUTMParams() {
       const params = new URLSearchParams(window.location.search);
       return {
@@ -903,13 +962,32 @@ var VeyaAnalyticsSDK = (() => {
     setupBrowserListeners() {
       document.addEventListener("visibilitychange", () => {
         if (document.visibilityState === "hidden") {
+          this.track("page_hidden", { time_on_page: this.timeOnPage() });
           this.flush(true);
+        } else if (document.visibilityState === "visible") {
+          this.track("page_visible");
         }
       });
-      window.addEventListener("beforeunload", () => {
-        this.trackSessionEnd();
+      window.addEventListener("pagehide", (event) => {
+        this.track("page_unload", { time_on_page: this.timeOnPage(), persisted: event.persisted });
         this.flush(true);
       });
+      window.addEventListener("pageshow", (event) => {
+        if (!event.persisted) return;
+        this.pageStartedAt = Date.now();
+        this.scrollDepthsFired.clear();
+        if (this.config.autoDetect) {
+          this.trackCurrentPage();
+        }
+      });
+      window.addEventListener("scroll", () => {
+        if (this.scrollCheckPending) return;
+        this.scrollCheckPending = true;
+        setTimeout(() => {
+          this.scrollCheckPending = false;
+          this.checkScrollDepth();
+        }, 100);
+      }, { passive: true });
       window.addEventListener("error", (e) => {
         this.error("javascript", e.message, {
           filename: e.filename,
@@ -922,6 +1000,22 @@ var VeyaAnalyticsSDK = (() => {
         this.error("promise_rejection", ((_a = e.reason) == null ? void 0 : _a.message) || String(e.reason));
       });
     }
+    timeOnPage() {
+      return Math.max(0, Date.now() - this.pageStartedAt);
+    }
+    // Fires every threshold at or below the current depth that hasn't fired yet on this page, so a
+    // fast scroll that jumps past several thresholds still reports each of them once.
+    checkScrollDepth() {
+      const scrollable = document.documentElement.scrollHeight - window.innerHeight;
+      if (scrollable <= 0) return;
+      const percent = Math.min(100, Math.round(window.scrollY / scrollable * 100));
+      for (const depth of SCROLL_DEPTHS) {
+        if (percent >= depth && !this.scrollDepthsFired.has(depth)) {
+          this.scrollDepthsFired.add(depth);
+          this.track("scroll_depth", { depth });
+        }
+      }
+    }
     // ============================================================================
     // FLUSH OVERRIDE FOR WEB
     // ============================================================================