@shoppexio/storefront 1.0.82 → 1.0.84

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 1.0.84
+
+- `touchStorefrontPresence()` sends `event_type: "presence"`. The server refreshes the live session but no longer counts the ping as a shop view, so an idle tab with `sx-online-users` (or any theme that touches presence on a timer) stops adding a view every few minutes.
+- New `trackCartActivity(cartValue, itemCount)`: reports a cart change for the live visitor map as a presence ping, without counting a page view. A cart state that any tab of the shop already reported is not sent again, so the cross-tab `storage` echo of one change is not a second ping.
+- On code storefronts (platform page tracker active), `trackPageView(cartValue, itemCount)` sends the cart as cart activity instead of a second counted view.
+- `trackPageView()` is otherwise unchanged: one call counts one view.
+
 ## 1.0.82
 
 - Page views and presence send the page path (query and fragment dropped, long paths capped), so the dashboard can show the top live page.

package/README.md

@@ -151,6 +151,8 @@ await refreshLiveUsers();
 setInterval(refreshLiveUsers, 30_000);
 ```
 
+`touchStorefrontPresence()` keeps the visitor online but never counts as a page view, so it is safe on a timer. Report page views with `trackPageView()` (once per page load or navigation) and later cart changes with `trackCartActivity(cartValue, itemCount)`, which updates the live visitor map without counting a view.
+
 ## Not this package
 
 If you want the authenticated Developer API wrapper for backend integrations, use `@shoppexio/sdk`. Do not ship `@shoppexio/sdk` in a browser bundle; use this Storefront SDK for headless storefronts.

package/dist/index.cjs

@@ -109,6 +109,7 @@ __export(src_exports, {
   subscriptionBillingHistory: () => subscriptionBillingHistory,
   ticket: () => ticket,
   touchStorefrontPresence: () => touchStorefrontPresence,
+  trackCartActivity: () => trackCartActivity,
   trackPageView: () => trackPageView,
   updateAvatar: () => updateAvatar,
   updateEmailPreferences: () => updateEmailPreferences,
@@ -26634,13 +26635,27 @@ function isPlatformPageTrackerActive() {
 }
 
 // ../sdk/src/modules/analytics.ts
+var REPORTED_CART_STORAGE_PREFIX = "reported_cart_";
+function reportedCartKey(storeSlug) {
+  return `${REPORTED_CART_STORAGE_PREFIX}${storeSlug}`;
+}
+function cartSnapshot(cartValue, itemCount) {
+  return `${cartValue ?? ""}|${itemCount ?? ""}`;
+}
+function rememberReportedCart(storeSlug, cartValue, itemCount) {
+  setItem(reportedCartKey(storeSlug), cartSnapshot(cartValue, itemCount));
+}
 async function trackPageView(cartValue, itemCount) {
   if (!isInitialized()) return;
   if (typeof document === "undefined") return;
   const carriesCart = cartValue !== void 0 || itemCount !== void 0;
-  if (isPlatformPageTrackerActive() && !carriesCart) return;
+  if (isPlatformPageTrackerActive()) {
+    if (carriesCart) await sendCartActivity(cartValue ?? 0, itemCount ?? 0);
+    return;
+  }
   const config2 = getConfig();
   const connectionId = getStorefrontConnectionId(config2.storeSlug);
+  if (carriesCart) rememberReportedCart(config2.storeSlug, cartValue, itemCount);
   try {
     const endpoint = buildEndpoint("/v1/storefront/shops/:storeSlug/ping", {
       storeSlug: config2.storeSlug
@@ -26660,6 +26675,33 @@ async function trackPageView(cartValue, itemCount) {
   } catch {
   }
 }
+async function trackCartActivity(cartValue, itemCount) {
+  if (!isInitialized()) return;
+  if (typeof document === "undefined") return;
+  if (getItem(reportedCartKey(getConfig().storeSlug)) === cartSnapshot(cartValue, itemCount)) return;
+  await sendCartActivity(cartValue, itemCount);
+}
+async function sendCartActivity(cartValue, itemCount) {
+  const config2 = getConfig();
+  rememberReportedCart(config2.storeSlug, cartValue, itemCount);
+  try {
+    const endpoint = buildEndpoint("/v1/storefront/shops/:storeSlug/ping", {
+      storeSlug: config2.storeSlug
+    });
+    await fetch(`${config2.apiBaseUrl}${endpoint}`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        event_type: "presence",
+        cart_value: cartValue,
+        item_count: itemCount,
+        connection_id: getStorefrontConnectionId(config2.storeSlug) ?? void 0,
+        path: resolveStorefrontPagePath()
+      })
+    });
+  } catch {
+  }
+}
 
 // ../sdk/src/modules/presence.ts
 async function getStorefrontRecentSales() {
@@ -26710,6 +26752,7 @@ async function touchStorefrontPresence() {
   return post(
     endpoint,
     {
+      event_type: "presence",
       referer: document.referrer || void 0,
       connection_id: getStorefrontConnectionId(config2.storeSlug) ?? void 0,
       path: resolveStorefrontPagePath(),
@@ -26929,6 +26972,7 @@ var shoppex = {
   getMenuSlotTitles,
   // Analytics
   trackPageView,
+  trackCartActivity,
   getStorefrontOnlineUsers,
   getStorefrontRecentSales,
   touchStorefrontPresence,
@@ -27042,6 +27086,7 @@ if (typeof window !== "undefined") {
   subscriptionBillingHistory,
   ticket,
   touchStorefrontPresence,
+  trackCartActivity,
   trackPageView,
   updateAvatar,
   updateEmailPreferences,