@aranova/tracking-react 1.2.0 → 1.2.2

package/dist/client.js

@@ -1697,6 +1697,91 @@ function withConversionAutoFire(client, autoFire) {
   };
 }
 
+// ../tracking-core/src/events/semantics.ts
+var EVENT_SEMANTICS = {
+  page_view: {
+    label: "Page view",
+    category: "page",
+    outcomeRole: "navigation",
+    clientVisibility: "simple"
+  },
+  time_on_site: {
+    label: "Time on site",
+    category: "engagement",
+    outcomeRole: "engagement",
+    clientVisibility: "detailed"
+  },
+  specific_page_visit: {
+    label: "Key page visit",
+    category: "engagement",
+    outcomeRole: "engagement",
+    clientVisibility: "detailed"
+  },
+  scroll_depth: {
+    label: "Scroll depth",
+    category: "engagement",
+    outcomeRole: "engagement",
+    clientVisibility: "detailed"
+  },
+  multi_page_session: {
+    label: "Multi-page session",
+    category: "engagement",
+    outcomeRole: "engagement",
+    clientVisibility: "detailed"
+  },
+  form_start: {
+    label: "Form started",
+    category: "engagement",
+    outcomeRole: "engagement",
+    clientVisibility: "simple"
+  },
+  sdk_heartbeat: {
+    label: "SDK heartbeat",
+    category: "system",
+    outcomeRole: "diagnostic",
+    clientVisibility: "hidden"
+  },
+  page_exit: {
+    label: "Page exit",
+    category: "engagement",
+    outcomeRole: "diagnostic",
+    clientVisibility: "detailed"
+  },
+  form_submit: {
+    label: "Form submitted",
+    category: "lead",
+    outcomeRole: "lead",
+    clientVisibility: "simple"
+  },
+  phone_click: {
+    label: "Phone click",
+    category: "lead",
+    outcomeRole: "lead",
+    clientVisibility: "simple"
+  },
+  cta_click: {
+    label: "CTA click",
+    category: "engagement",
+    outcomeRole: "engagement",
+    clientVisibility: "simple"
+  },
+  site_link_click: {
+    label: "Left for sibling site",
+    category: "page",
+    outcomeRole: "navigation",
+    clientVisibility: "detailed"
+  },
+  site_link_arrival: {
+    label: "Arrived from sibling site",
+    category: "page",
+    outcomeRole: "navigation",
+    clientVisibility: "simple"
+  }
+};
+function getEventSemantics(eventName) {
+  return eventName in EVENT_SEMANTICS ? EVENT_SEMANTICS[eventName] : null;
+}
+
 // ../tracking-core/src/page-view.ts
 var import_mini = require("zod/mini");
 
@@ -1743,6 +1828,13 @@ function writeSessionStorage(key, value) {
   } catch {
   }
 }
+function deleteSessionStorage(key) {
+  try {
+    if (typeof window === "undefined") return;
+    window.sessionStorage.removeItem(key);
+  } catch {
+  }
+}
 function getLastFiredUrl() {
   if (!lastFiredUrlHydrated) {
     lastFiredUrlHydrated = true;
@@ -1756,6 +1848,31 @@ function setLastFiredUrl(url) {
   lastFiredUrlHydrated = true;
   writeSessionStorage(LAST_FIRED_URL_STORAGE_KEY, url);
 }
+function resetPageViewState() {
+  lastFiredUrl = null;
+  lastFiredUrlHydrated = false;
+  deleteSessionStorage(LAST_FIRED_URL_STORAGE_KEY);
+  autoPageViewSlot().key = null;
+}
+var AUTO_PAGE_VIEW_SLOT = /* @__PURE__ */ Symbol.for("aranova.tracking.autoPageView");
+function autoPageViewSlot() {
+  const scope = globalThis;
+  scope[AUTO_PAGE_VIEW_SLOT] ?? (scope[AUTO_PAGE_VIEW_SLOT] = { key: null });
+  return scope[AUTO_PAGE_VIEW_SLOT];
+}
+function pageViewRouteKey(pathname, search) {
+  const query = stripLinkParamFromSearch(search);
+  return query.length > 1 ? `${pathname}${query}` : pathname;
+}
+function fireAutoPageView(client, options = {}) {
+  if (typeof window === "undefined") return false;
+  const key = pageViewRouteKey(window.location.pathname, window.location.search);
+  const slot = autoPageViewSlot();
+  if (!options.force && slot.key === key) return false;
+  slot.key = key;
+  fireManualPageView(client);
+  return true;
+}
 function buildPageViewMetadata(referrerOverride) {
   if (typeof window === "undefined" || typeof document === "undefined") return null;
   return (0, import_mini.parse)(pageViewMetadataSchema, {
@@ -1791,49 +1908,41 @@ function attachBfcacheRestore(client) {
   };
   function handlePageShow(event) {
     if (!event.persisted) return;
-    fireManualPageView(client);
+    fireAutoPageView(client, { force: true });
   }
   window.addEventListener("pageshow", handlePageShow);
   return () => {
     window.removeEventListener("pageshow", handlePageShow);
   };
 }
-function attachAutoPageView(client, options = {}) {
+function attachAutoPageView(client) {
   if (typeof window === "undefined" || typeof history === "undefined") {
     return () => {
     };
   }
-  let lastPath = window.location.pathname + window.location.search;
-  function maybeFire() {
-    const current = window.location.pathname + window.location.search;
-    if (current === lastPath) return;
-    lastPath = current;
-    fireManualPageView(client);
+  function fireForCurrentRoute() {
+    fireAutoPageView(client);
   }
   const originalPushState = history.pushState.bind(history);
   const originalReplaceState = history.replaceState.bind(history);
   function patchedPushState(...args) {
     originalPushState(...args);
-    setTimeout(maybeFire, 0);
+    setTimeout(fireForCurrentRoute, 0);
   }
   function patchedReplaceState(...args) {
     originalReplaceState(...args);
-    setTimeout(maybeFire, 0);
-  }
-  function handlePageShow(event) {
-    if (!event.persisted) return;
-    fireManualPageView(client);
+    setTimeout(fireForCurrentRoute, 0);
   }
   history.pushState = patchedPushState;
   history.replaceState = patchedReplaceState;
-  window.addEventListener("popstate", maybeFire);
-  window.addEventListener("pageshow", handlePageShow);
-  if (!options.skipInitial) fireManualPageView(client);
+  window.addEventListener("popstate", fireForCurrentRoute);
+  const detachBfcacheRestore = attachBfcacheRestore(client);
+  fireForCurrentRoute();
   return () => {
     history.pushState = originalPushState;
     history.replaceState = originalReplaceState;
-    window.removeEventListener("popstate", maybeFire);
-    window.removeEventListener("pageshow", handlePageShow);
+    window.removeEventListener("popstate", fireForCurrentRoute);
+    detachBfcacheRestore();
   };
 }
 
@@ -2011,6 +2120,7 @@ function getOrCreateTrackingClient(config) {
   }
   if (globalClient !== null) {
     globalClient.destroy();
+    resetPageViewState();
   }
   globalClient = createTrackingClient(config);
   globalClientKey = key;
@@ -2217,11 +2327,12 @@ function createTrackingClient(config) {
           identityHeaders,
           false
         );
+        if (destroyed) return;
         if (outcome === "retry") {
           retryAttempt += 1;
           return;
         }
-        pending = pending.slice(1);
+        pending = pending.filter((entry) => entry !== batch);
         writePendingBatches(bufferKey, pending);
         retryAttempt = 0;
       }
@@ -2252,13 +2363,14 @@ function createTrackingClient(config) {
       metadata: input.metadata ?? null,
       occurred_at: occurredAt
     });
-    if (queue.length >= maxQueueSize) {
+    if (queue.length >= maxQueueSize || getEventSemantics(input.eventType)?.outcomeRole === "lead") {
       void flush();
     } else {
       scheduleFlush();
     }
   }
   function flushOnUnload() {
+    if (destroyed) return;
     bufferQueued();
     clearScheduledFlush();
     if (pending.length === 0) return;
@@ -2268,11 +2380,12 @@ function createTrackingClient(config) {
     const body = { session: batch.session, events: batch.events };
     void postWithFetch(eventsUrl, JSON.stringify(body), config.apiKey, identityHeaders, true);
   }
+  function onVisibilityChange() {
+    if (document.visibilityState === "hidden") flushOnUnload();
+  }
   if (typeof window !== "undefined") {
     window.addEventListener("pagehide", flushOnUnload);
-    window.addEventListener("visibilitychange", () => {
-      if (document.visibilityState === "hidden") flushOnUnload();
-    });
+    window.addEventListener("visibilitychange", onVisibilityChange);
   }
   return {
     trackEvent,
@@ -2281,14 +2394,16 @@ function createTrackingClient(config) {
     getSessionId: () => sessionId,
     getVisitorId: () => visitorId,
     destroy: () => {
-      destroyed = true;
+      if (destroyed) return;
       if (queue.length > 0) {
         flushOnUnload();
       }
+      destroyed = true;
       clearScheduledFlush();
       queue = [];
       if (typeof window !== "undefined") {
         window.removeEventListener("pagehide", flushOnUnload);
+        window.removeEventListener("visibilitychange", onVisibilityChange);
       }
     }
   };
@@ -2511,88 +2626,6 @@ var timeOnSiteConfigSchema = z13.strictObject({
   thresholdSeconds: z13.int().check(z13.positive())
 });
 
-// ../tracking-core/src/events/semantics.ts
-var EVENT_SEMANTICS = {
-  page_view: {
-    label: "Page view",
-    category: "page",
-    outcomeRole: "navigation",
-    clientVisibility: "simple"
-  },
-  time_on_site: {
-    label: "Time on site",
-    category: "engagement",
-    outcomeRole: "engagement",
-    clientVisibility: "detailed"
-  },
-  specific_page_visit: {
-    label: "Key page visit",
-    category: "engagement",
-    outcomeRole: "engagement",
-    clientVisibility: "detailed"
-  },
-  scroll_depth: {
-    label: "Scroll depth",
-    category: "engagement",
-    outcomeRole: "engagement",
-    clientVisibility: "detailed"
-  },
-  multi_page_session: {
-    label: "Multi-page session",
-    category: "engagement",
-    outcomeRole: "engagement",
-    clientVisibility: "detailed"
-  },
-  form_start: {
-    label: "Form started",
-    category: "engagement",
-    outcomeRole: "engagement",
-    clientVisibility: "simple"
-  },
-  sdk_heartbeat: {
-    label: "SDK heartbeat",
-    category: "system",
-    outcomeRole: "diagnostic",
-    clientVisibility: "hidden"
-  },
-  page_exit: {
-    label: "Page exit",
-    category: "engagement",
-    outcomeRole: "diagnostic",
-    clientVisibility: "detailed"
-  },
-  form_submit: {
-    label: "Form submitted",
-    category: "lead",
-    outcomeRole: "lead",
-    clientVisibility: "simple"
-  },
-  phone_click: {
-    label: "Phone click",
-    category: "lead",
-    outcomeRole: "lead",
-    clientVisibility: "simple"
-  },
-  cta_click: {
-    label: "CTA click",
-    category: "engagement",
-    outcomeRole: "engagement",
-    clientVisibility: "simple"
-  },
-  site_link_click: {
-    label: "Left for sibling site",
-    category: "page",
-    outcomeRole: "navigation",
-    clientVisibility: "detailed"
-  },
-  site_link_arrival: {
-    label: "Arrived from sibling site",
-    category: "page",
-    outcomeRole: "navigation",
-    clientVisibility: "simple"
-  }
-};
-
 // ../tracking-core/src/events/registry.ts
 var EVENT_REGISTRY = {
   // --- automatic triggers ---
@@ -3700,7 +3733,7 @@ function GoogleAdsTracking(props) {
 var import_react6 = require("react");
 
 // package.json
-var version = "1.2.0";
+var version = "1.2.2";
 
 // ../tracking-core/src/phone-react.tsx
 var import_react5 = require("react");
@@ -3906,7 +3939,6 @@ function createTracking(options) {
           }
         } : detectorClient;
         detachers.push(attachAutoPageView(pageClient));
-        detachers.push(attachBfcacheRestore(pageClient));
         detachers.push(attachPageExit(detectorClient));
         const timeOnSite = triggers.automatic.time_on_site;
         if (timeOnSite) {