@cimplify/sdk 0.93.0 → 0.94.0

package/dist/react.d.mts

@@ -869,8 +869,14 @@ interface CimplifyProviderProps {
     optimistic?: boolean;
     prefetch?: PrefetchOptions;
     linkComponent?: CimplifyLinkComponent;
+    /**
+     * Auto-record a page view on mount and on every route change. Default true,
+     * so a storefront reports traffic without wiring anything. Set false where
+     * consent has not been given, or where the app tracks page views itself.
+     */
+    trackPageViews?: boolean;
 }
-declare function CimplifyProvider({ client, children, onLocationChange, initialBusiness, initialLocations, optimistic, prefetch, linkComponent, }: CimplifyProviderProps): React$1.ReactElement;
+declare function CimplifyProvider({ client, children, onLocationChange, initialBusiness, initialLocations, optimistic, prefetch, linkComponent, trackPageViews, }: CimplifyProviderProps): React$1.ReactElement;
 declare function useCimplify(): CimplifyContextValue;
 declare function useOptionalCimplify(): CimplifyContextValue | null;
 declare function useCimplifyClient(): CimplifyClientContextValue;

package/dist/react.d.ts

@@ -869,8 +869,14 @@ interface CimplifyProviderProps {
     optimistic?: boolean;
     prefetch?: PrefetchOptions;
     linkComponent?: CimplifyLinkComponent;
+    /**
+     * Auto-record a page view on mount and on every route change. Default true,
+     * so a storefront reports traffic without wiring anything. Set false where
+     * consent has not been given, or where the app tracks page views itself.
+     */
+    trackPageViews?: boolean;
 }
-declare function CimplifyProvider({ client, children, onLocationChange, initialBusiness, initialLocations, optimistic, prefetch, linkComponent, }: CimplifyProviderProps): React$1.ReactElement;
+declare function CimplifyProvider({ client, children, onLocationChange, initialBusiness, initialLocations, optimistic, prefetch, linkComponent, trackPageViews, }: CimplifyProviderProps): React$1.ReactElement;
 declare function useCimplify(): CimplifyContextValue;
 declare function useOptionalCimplify(): CimplifyContextValue | null;
 declare function useCimplifyClient(): CimplifyClientContextValue;

package/dist/react.js

@@ -1137,6 +1137,37 @@ function preconnectOrigin(url, crossOrigin) {
   if (crossOrigin) link.crossOrigin = crossOrigin;
   document.head.appendChild(link);
 }
+function usePageViewTracking(client, enabled) {
+  React14.useEffect(() => {
+    if (!enabled || typeof window === "undefined") return;
+    let lastPath = null;
+    const record = () => {
+      const path = window.location.pathname;
+      if (path === lastPath) return;
+      lastPath = path;
+      try {
+        client.activity?.trackPageView({ pagePath: path });
+      } catch {
+      }
+    };
+    record();
+    const { pushState, replaceState } = window.history;
+    window.history.pushState = function(...args) {
+      pushState.apply(this, args);
+      record();
+    };
+    window.history.replaceState = function(...args) {
+      replaceState.apply(this, args);
+      record();
+    };
+    window.addEventListener("popstate", record);
+    return () => {
+      window.history.pushState = pushState;
+      window.history.replaceState = replaceState;
+      window.removeEventListener("popstate", record);
+    };
+  }, [client, enabled]);
+}
 var LOCATION_STORAGE_KEY = "cimplify_location_id";
 var DISPLAY_CURRENCY_STORAGE_KEY = "cimplify_display_currency";
 var FX_REFRESH_INTERVAL = 12e4;
@@ -1217,9 +1248,11 @@ function CimplifyProvider({
   initialLocations,
   optimistic = true,
   prefetch,
-  linkComponent
+  linkComponent,
+  trackPageViews = true
 }) {
   const resolvedClient = React14.useMemo(() => client ?? createDefaultClient(), [client]);
+  usePageViewTracking(resolvedClient, trackPageViews);
   const resolvedPrefetch = React14.useMemo(
     () => ({
       mode: prefetch?.mode ?? DEFAULT_PREFETCH_OPTIONS.mode,

package/dist/react.mjs

@@ -1113,6 +1113,37 @@ function preconnectOrigin(url, crossOrigin) {
   if (crossOrigin) link.crossOrigin = crossOrigin;
   document.head.appendChild(link);
 }
+function usePageViewTracking(client, enabled) {
+  useEffect(() => {
+    if (!enabled || typeof window === "undefined") return;
+    let lastPath = null;
+    const record = () => {
+      const path = window.location.pathname;
+      if (path === lastPath) return;
+      lastPath = path;
+      try {
+        client.activity?.trackPageView({ pagePath: path });
+      } catch {
+      }
+    };
+    record();
+    const { pushState, replaceState } = window.history;
+    window.history.pushState = function(...args) {
+      pushState.apply(this, args);
+      record();
+    };
+    window.history.replaceState = function(...args) {
+      replaceState.apply(this, args);
+      record();
+    };
+    window.addEventListener("popstate", record);
+    return () => {
+      window.history.pushState = pushState;
+      window.history.replaceState = replaceState;
+      window.removeEventListener("popstate", record);
+    };
+  }, [client, enabled]);
+}
 var LOCATION_STORAGE_KEY = "cimplify_location_id";
 var DISPLAY_CURRENCY_STORAGE_KEY = "cimplify_display_currency";
 var FX_REFRESH_INTERVAL = 12e4;
@@ -1193,9 +1224,11 @@ function CimplifyProvider({
   initialLocations,
   optimistic = true,
   prefetch,
-  linkComponent
+  linkComponent,
+  trackPageViews = true
 }) {
   const resolvedClient = useMemo(() => client ?? createDefaultClient(), [client]);
+  usePageViewTracking(resolvedClient, trackPageViews);
   const resolvedPrefetch = useMemo(
     () => ({
       mode: prefetch?.mode ?? DEFAULT_PREFETCH_OPTIONS.mode,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cimplify/sdk",
-  "version": "0.93.0",
+  "version": "0.94.0",
   "description": "Cimplify Commerce SDK for storefronts",
   "keywords": [
     "cimplify",