@shoppexio/storefront 1.0.81 → 1.0.84

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # 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.
+- On code storefronts the platform injects a page tracker. While it runs, `trackPageView()` without cart data and `touchStorefrontPresence()` stand down so a view is not counted twice. `trackPageView(cartValue, itemCount)` still reports the cart activity the tracker cannot see.
+
 ## 1.0.81
 
 - `ProductCategory` carries `sort_order`, the merchant's category position from the dashboard. Product-level category references arrive sorted by it, so a theme can order its filter row and grouped sections the way the merchant arranged them instead of alphabetically.

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.