@shoppexio/storefront 1.0.82 → 1.0.85

package/dist/index.d.cts

@@ -1908,7 +1908,24 @@ declare function getMenu(title: string): Promise<SDKResponse<Menu>>;
 declare function getMenuBySlot(slot: NavigationMenuSlot): Promise<SDKResponse<Menu>>;
 declare function getMenuSlotTitles(slot: NavigationMenuSlot): string[];
 
+/**
+ * Counts a page view. Call it once per page load or client-side navigation.
+ * Passing the cart also records it for the live visitor map.
+ */
 declare function trackPageView(cartValue?: number, itemCount?: number): Promise<void>;
+/**
+ * Reports a cart change for the live visitor map without counting a page view
+ * (`event_type: 'presence'`). Use it when the cart changes on a page that was
+ * already counted. A cart state the server already acknowledged, or that a tab
+ * of this shop is sending right now, is not sent again, so a cross-tab `storage`
+ * echo of a change is not a second ping. A failed send leaves nothing behind:
+ * the same state goes out again on the next change or page load.
+ *
+ * The check runs when the change's turn comes, after this tab's earlier sends
+ * settled, never at call time: a revert to the confirmed cart while another
+ * state is on the wire must still go out once that send confirms its state.
+ */
+declare function trackCartActivity(cartValue: number, itemCount: number): Promise<void>;
 
 /**
  * Anonymized recent-sales feed for storefront social proof (product title +
@@ -1917,6 +1934,12 @@ declare function trackPageView(cartValue?: number, itemCount?: number): Promise<
  */
 declare function getStorefrontRecentSales(): Promise<SDKResponse<StorefrontRecentSales>>;
 declare function getStorefrontOnlineUsers(): Promise<SDKResponse<StorefrontOnlineUsers>>;
+/**
+ * Keeps this visitor's live presence fresh. The ping carries
+ * `event_type: 'presence'`, so the server refreshes the live session without
+ * counting a shop view: an idle tab that touches presence every minute must
+ * not add a view every few minutes. Page views go through `trackPageView()`.
+ */
 declare function touchStorefrontPresence(): Promise<SDKResponse<{
     pong: string;
 }>>;
@@ -2066,6 +2089,7 @@ declare const shoppex: {
     getMenuByTitle: typeof getMenuByTitle;
     getMenuSlotTitles: typeof getMenuSlotTitles;
     trackPageView: typeof trackPageView;
+    trackCartActivity: typeof trackCartActivity;
     getStorefrontOnlineUsers: typeof getStorefrontOnlineUsers;
     getStorefrontRecentSales: typeof getStorefrontRecentSales;
     touchStorefrontPresence: typeof touchStorefrontPresence;
@@ -2080,4 +2104,4 @@ declare const shoppex: {
     mergeSettings: typeof mergeSettings;
 };
 
-export { type AffiliateValidation, ApiError, type ApiResponse, type BlockDefinition, type BlockInstance, type BuyerRewardActivityItem, type BuyerRewards, CURRENCY_UNAVAILABLE_ERROR_CODE, type CartAddOptions, type CartAddon, type CartAppliedDiscount, type CartBasketMergeLine, type CartCodeSource, CartError, type CartItem, type CartItemUpdate, type CartLineIdentityInput, type CartMetadata, type CartPayload, type CartQuote, type CartQuoteLine, type CartStats, type Category, CheckoutCreateError, type CheckoutOptions, type CheckoutResult, type CouponValidation, type CouponValidationOptions, type CursorPagination, type CustomFieldDefinition, type CustomerEmailPreferencesPatch, type CustomerProfilePatch, type CustomerSubscriptionCancelOptions, type CustomerTicketPayload, type EligibleBundleDeal, type EligibleBundleDealProduct, type EligibleCartDeal, type Feedback, type Invoice, type InvoiceProduct, type Menu, type MenuItem, NetworkError, NotInitializedError, type Page, type PageLayout, type PriceVariant, type Product, type ProductAddon, type ProductBundle, type ProductBundleProduct, type ProductCategory, type ProductDescriptionTab, type ProductFaq, type ProductFeedback, type ProductGroup, type ProductImage, type ProductVariant, type PublishedBuilderSettings, type PublishedThemeSettingsPayload, type ResellerCatalogQuery, type ResellerOrderItem, type ResellerOrdersQuery, type ResolvedThemeSettings, type RewardActionType, type RewardGrantStatus, type RewardProgramSummary, type RewardProgramTeaserItem, type RewardReason, type SDKResponse, type SearchOptions, type SectionDefinition, type SettingField, type Shop, type ShopFeedback, type ShopReviewsPage, type ShopReviewsSummary, type ShopTheme, type ShoppexConfig, ShoppexError, type ShoppexInitOptions, type StorefrontAddon, type StorefrontAddonBootstrap, type StorefrontAnnouncementBarAddon, type StorefrontCatalogSearchItem, type StorefrontContactTicketInput, type StorefrontContactTicketResult, type StorefrontCountdownBarAddon, type StorefrontCouponPopupModalAddon, type StorefrontCustomField, type StorefrontData, type StorefrontItem, type StorefrontOnlineUsers, type StorefrontPromoInfoCardAddon, type StorefrontRecentPurchasePopupAddon, type StorefrontRecentSaleEntry, type StorefrontRecentSales, type StorefrontSearchFilterOptions, type StorefrontSocialLinks, type Subscription, type SubscriptionFlags, type SubscriptionInterval, type ThemeBlockManifest, type ThemeConfig, type TrustedChecks, ValidationError, acceptResellerInvite, addFavorite, affiliate, affiliateStats, applyForReseller, buildStorefrontContactMessage, buildStorefrontCustomFieldPayload, buildStorefrontProductLookup, cancelSubscription, claimWarranty, collectProductSearchHaystack, computeCartLineId, createTicket, dashboard, shoppex as default, emailPreferences, enrollAsReseller, ensureCartLineId, favorites, fetchPublishedBuilderSettings, fetchPublishedThemeSettings, filterProductsBySearchQuery, getMenu, getMenuBySlot, getMenuByTitle, getMenuSlotTitles, getMenus, getMergedStorefrontProducts, getShopReviewsPage, getStorefrontGroupProducts, getStorefrontOnlineUsers, getStorefrontRecentSales, groupMatchesSearchQuery, isProductInStock, isProductOutOfStock, isStorefrontCheckboxCustomFieldValueChecked, isVariantOutOfStock, logout, loyalty, me, mergeSettings, normalizeSearchQuery, normalizeStorefrontCustomFields, order, orders, pauseSubscription, productMatchesSearchQuery, quoteResellerOrder, redeemLoyaltyPoints, removeAvatar, removeFavorite, replyToTicket, requestOtp, reseller, resellerApiKeys, resellerCatalog, resellerOrder, resellerOrders, resellerWallet, resetLicenseHwid, resolveDefaults, resolveDisplayStock, resolveStorefrontApiBaseUrl, resolveStorefrontSocialLinks, resolveVariantStockValue, resumeSubscription, revokeAllSessions, revokeSession, searchMergedStorefrontCatalog, searchMergedStorefrontCatalogItems, sessions, shoppex, stripHtmlFromText, submitStorefrontContactTicket, subscriptionBillingHistory, ticket, touchStorefrontPresence, trackPageView, updateAvatar, updateEmailPreferences, updateProfile, validateStorefrontCustomFieldValue, verifyOtp, warranties };
+export { type AffiliateValidation, ApiError, type ApiResponse, type BlockDefinition, type BlockInstance, type BuyerRewardActivityItem, type BuyerRewards, CURRENCY_UNAVAILABLE_ERROR_CODE, type CartAddOptions, type CartAddon, type CartAppliedDiscount, type CartBasketMergeLine, type CartCodeSource, CartError, type CartItem, type CartItemUpdate, type CartLineIdentityInput, type CartMetadata, type CartPayload, type CartQuote, type CartQuoteLine, type CartStats, type Category, CheckoutCreateError, type CheckoutOptions, type CheckoutResult, type CouponValidation, type CouponValidationOptions, type CursorPagination, type CustomFieldDefinition, type CustomerEmailPreferencesPatch, type CustomerProfilePatch, type CustomerSubscriptionCancelOptions, type CustomerTicketPayload, type EligibleBundleDeal, type EligibleBundleDealProduct, type EligibleCartDeal, type Feedback, type Invoice, type InvoiceProduct, type Menu, type MenuItem, NetworkError, NotInitializedError, type Page, type PageLayout, type PriceVariant, type Product, type ProductAddon, type ProductBundle, type ProductBundleProduct, type ProductCategory, type ProductDescriptionTab, type ProductFaq, type ProductFeedback, type ProductGroup, type ProductImage, type ProductVariant, type PublishedBuilderSettings, type PublishedThemeSettingsPayload, type ResellerCatalogQuery, type ResellerOrderItem, type ResellerOrdersQuery, type ResolvedThemeSettings, type RewardActionType, type RewardGrantStatus, type RewardProgramSummary, type RewardProgramTeaserItem, type RewardReason, type SDKResponse, type SearchOptions, type SectionDefinition, type SettingField, type Shop, type ShopFeedback, type ShopReviewsPage, type ShopReviewsSummary, type ShopTheme, type ShoppexConfig, ShoppexError, type ShoppexInitOptions, type StorefrontAddon, type StorefrontAddonBootstrap, type StorefrontAnnouncementBarAddon, type StorefrontCatalogSearchItem, type StorefrontContactTicketInput, type StorefrontContactTicketResult, type StorefrontCountdownBarAddon, type StorefrontCouponPopupModalAddon, type StorefrontCustomField, type StorefrontData, type StorefrontItem, type StorefrontOnlineUsers, type StorefrontPromoInfoCardAddon, type StorefrontRecentPurchasePopupAddon, type StorefrontRecentSaleEntry, type StorefrontRecentSales, type StorefrontSearchFilterOptions, type StorefrontSocialLinks, type Subscription, type SubscriptionFlags, type SubscriptionInterval, type ThemeBlockManifest, type ThemeConfig, type TrustedChecks, ValidationError, acceptResellerInvite, addFavorite, affiliate, affiliateStats, applyForReseller, buildStorefrontContactMessage, buildStorefrontCustomFieldPayload, buildStorefrontProductLookup, cancelSubscription, claimWarranty, collectProductSearchHaystack, computeCartLineId, createTicket, dashboard, shoppex as default, emailPreferences, enrollAsReseller, ensureCartLineId, favorites, fetchPublishedBuilderSettings, fetchPublishedThemeSettings, filterProductsBySearchQuery, getMenu, getMenuBySlot, getMenuByTitle, getMenuSlotTitles, getMenus, getMergedStorefrontProducts, getShopReviewsPage, getStorefrontGroupProducts, getStorefrontOnlineUsers, getStorefrontRecentSales, groupMatchesSearchQuery, isProductInStock, isProductOutOfStock, isStorefrontCheckboxCustomFieldValueChecked, isVariantOutOfStock, logout, loyalty, me, mergeSettings, normalizeSearchQuery, normalizeStorefrontCustomFields, order, orders, pauseSubscription, productMatchesSearchQuery, quoteResellerOrder, redeemLoyaltyPoints, removeAvatar, removeFavorite, replyToTicket, requestOtp, reseller, resellerApiKeys, resellerCatalog, resellerOrder, resellerOrders, resellerWallet, resetLicenseHwid, resolveDefaults, resolveDisplayStock, resolveStorefrontApiBaseUrl, resolveStorefrontSocialLinks, resolveVariantStockValue, resumeSubscription, revokeAllSessions, revokeSession, searchMergedStorefrontCatalog, searchMergedStorefrontCatalogItems, sessions, shoppex, stripHtmlFromText, submitStorefrontContactTicket, subscriptionBillingHistory, ticket, touchStorefrontPresence, trackCartActivity, trackPageView, updateAvatar, updateEmailPreferences, updateProfile, validateStorefrontCustomFieldValue, verifyOtp, warranties };

package/dist/index.d.ts

@@ -1908,7 +1908,24 @@ declare function getMenu(title: string): Promise<SDKResponse<Menu>>;
 declare function getMenuBySlot(slot: NavigationMenuSlot): Promise<SDKResponse<Menu>>;
 declare function getMenuSlotTitles(slot: NavigationMenuSlot): string[];
 
+/**
+ * Counts a page view. Call it once per page load or client-side navigation.
+ * Passing the cart also records it for the live visitor map.
+ */
 declare function trackPageView(cartValue?: number, itemCount?: number): Promise<void>;
+/**
+ * Reports a cart change for the live visitor map without counting a page view
+ * (`event_type: 'presence'`). Use it when the cart changes on a page that was
+ * already counted. A cart state the server already acknowledged, or that a tab
+ * of this shop is sending right now, is not sent again, so a cross-tab `storage`
+ * echo of a change is not a second ping. A failed send leaves nothing behind:
+ * the same state goes out again on the next change or page load.
+ *
+ * The check runs when the change's turn comes, after this tab's earlier sends
+ * settled, never at call time: a revert to the confirmed cart while another
+ * state is on the wire must still go out once that send confirms its state.
+ */
+declare function trackCartActivity(cartValue: number, itemCount: number): Promise<void>;
 
 /**
  * Anonymized recent-sales feed for storefront social proof (product title +
@@ -1917,6 +1934,12 @@ declare function trackPageView(cartValue?: number, itemCount?: number): Promise<
  */
 declare function getStorefrontRecentSales(): Promise<SDKResponse<StorefrontRecentSales>>;
 declare function getStorefrontOnlineUsers(): Promise<SDKResponse<StorefrontOnlineUsers>>;
+/**
+ * Keeps this visitor's live presence fresh. The ping carries
+ * `event_type: 'presence'`, so the server refreshes the live session without
+ * counting a shop view: an idle tab that touches presence every minute must
+ * not add a view every few minutes. Page views go through `trackPageView()`.
+ */
 declare function touchStorefrontPresence(): Promise<SDKResponse<{
     pong: string;
 }>>;
@@ -2066,6 +2089,7 @@ declare const shoppex: {
     getMenuByTitle: typeof getMenuByTitle;
     getMenuSlotTitles: typeof getMenuSlotTitles;
     trackPageView: typeof trackPageView;
+    trackCartActivity: typeof trackCartActivity;
     getStorefrontOnlineUsers: typeof getStorefrontOnlineUsers;
     getStorefrontRecentSales: typeof getStorefrontRecentSales;
     touchStorefrontPresence: typeof touchStorefrontPresence;
@@ -2080,4 +2104,4 @@ declare const shoppex: {
     mergeSettings: typeof mergeSettings;
 };
 
-export { type AffiliateValidation, ApiError, type ApiResponse, type BlockDefinition, type BlockInstance, type BuyerRewardActivityItem, type BuyerRewards, CURRENCY_UNAVAILABLE_ERROR_CODE, type CartAddOptions, type CartAddon, type CartAppliedDiscount, type CartBasketMergeLine, type CartCodeSource, CartError, type CartItem, type CartItemUpdate, type CartLineIdentityInput, type CartMetadata, type CartPayload, type CartQuote, type CartQuoteLine, type CartStats, type Category, CheckoutCreateError, type CheckoutOptions, type CheckoutResult, type CouponValidation, type CouponValidationOptions, type CursorPagination, type CustomFieldDefinition, type CustomerEmailPreferencesPatch, type CustomerProfilePatch, type CustomerSubscriptionCancelOptions, type CustomerTicketPayload, type EligibleBundleDeal, type EligibleBundleDealProduct, type EligibleCartDeal, type Feedback, type Invoice, type InvoiceProduct, type Menu, type MenuItem, NetworkError, NotInitializedError, type Page, type PageLayout, type PriceVariant, type Product, type ProductAddon, type ProductBundle, type ProductBundleProduct, type ProductCategory, type ProductDescriptionTab, type ProductFaq, type ProductFeedback, type ProductGroup, type ProductImage, type ProductVariant, type PublishedBuilderSettings, type PublishedThemeSettingsPayload, type ResellerCatalogQuery, type ResellerOrderItem, type ResellerOrdersQuery, type ResolvedThemeSettings, type RewardActionType, type RewardGrantStatus, type RewardProgramSummary, type RewardProgramTeaserItem, type RewardReason, type SDKResponse, type SearchOptions, type SectionDefinition, type SettingField, type Shop, type ShopFeedback, type ShopReviewsPage, type ShopReviewsSummary, type ShopTheme, type ShoppexConfig, ShoppexError, type ShoppexInitOptions, type StorefrontAddon, type StorefrontAddonBootstrap, type StorefrontAnnouncementBarAddon, type StorefrontCatalogSearchItem, type StorefrontContactTicketInput, type StorefrontContactTicketResult, type StorefrontCountdownBarAddon, type StorefrontCouponPopupModalAddon, type StorefrontCustomField, type StorefrontData, type StorefrontItem, type StorefrontOnlineUsers, type StorefrontPromoInfoCardAddon, type StorefrontRecentPurchasePopupAddon, type StorefrontRecentSaleEntry, type StorefrontRecentSales, type StorefrontSearchFilterOptions, type StorefrontSocialLinks, type Subscription, type SubscriptionFlags, type SubscriptionInterval, type ThemeBlockManifest, type ThemeConfig, type TrustedChecks, ValidationError, acceptResellerInvite, addFavorite, affiliate, affiliateStats, applyForReseller, buildStorefrontContactMessage, buildStorefrontCustomFieldPayload, buildStorefrontProductLookup, cancelSubscription, claimWarranty, collectProductSearchHaystack, computeCartLineId, createTicket, dashboard, shoppex as default, emailPreferences, enrollAsReseller, ensureCartLineId, favorites, fetchPublishedBuilderSettings, fetchPublishedThemeSettings, filterProductsBySearchQuery, getMenu, getMenuBySlot, getMenuByTitle, getMenuSlotTitles, getMenus, getMergedStorefrontProducts, getShopReviewsPage, getStorefrontGroupProducts, getStorefrontOnlineUsers, getStorefrontRecentSales, groupMatchesSearchQuery, isProductInStock, isProductOutOfStock, isStorefrontCheckboxCustomFieldValueChecked, isVariantOutOfStock, logout, loyalty, me, mergeSettings, normalizeSearchQuery, normalizeStorefrontCustomFields, order, orders, pauseSubscription, productMatchesSearchQuery, quoteResellerOrder, redeemLoyaltyPoints, removeAvatar, removeFavorite, replyToTicket, requestOtp, reseller, resellerApiKeys, resellerCatalog, resellerOrder, resellerOrders, resellerWallet, resetLicenseHwid, resolveDefaults, resolveDisplayStock, resolveStorefrontApiBaseUrl, resolveStorefrontSocialLinks, resolveVariantStockValue, resumeSubscription, revokeAllSessions, revokeSession, searchMergedStorefrontCatalog, searchMergedStorefrontCatalogItems, sessions, shoppex, stripHtmlFromText, submitStorefrontContactTicket, subscriptionBillingHistory, ticket, touchStorefrontPresence, trackPageView, updateAvatar, updateEmailPreferences, updateProfile, validateStorefrontCustomFieldValue, verifyOtp, warranties };
+export { type AffiliateValidation, ApiError, type ApiResponse, type BlockDefinition, type BlockInstance, type BuyerRewardActivityItem, type BuyerRewards, CURRENCY_UNAVAILABLE_ERROR_CODE, type CartAddOptions, type CartAddon, type CartAppliedDiscount, type CartBasketMergeLine, type CartCodeSource, CartError, type CartItem, type CartItemUpdate, type CartLineIdentityInput, type CartMetadata, type CartPayload, type CartQuote, type CartQuoteLine, type CartStats, type Category, CheckoutCreateError, type CheckoutOptions, type CheckoutResult, type CouponValidation, type CouponValidationOptions, type CursorPagination, type CustomFieldDefinition, type CustomerEmailPreferencesPatch, type CustomerProfilePatch, type CustomerSubscriptionCancelOptions, type CustomerTicketPayload, type EligibleBundleDeal, type EligibleBundleDealProduct, type EligibleCartDeal, type Feedback, type Invoice, type InvoiceProduct, type Menu, type MenuItem, NetworkError, NotInitializedError, type Page, type PageLayout, type PriceVariant, type Product, type ProductAddon, type ProductBundle, type ProductBundleProduct, type ProductCategory, type ProductDescriptionTab, type ProductFaq, type ProductFeedback, type ProductGroup, type ProductImage, type ProductVariant, type PublishedBuilderSettings, type PublishedThemeSettingsPayload, type ResellerCatalogQuery, type ResellerOrderItem, type ResellerOrdersQuery, type ResolvedThemeSettings, type RewardActionType, type RewardGrantStatus, type RewardProgramSummary, type RewardProgramTeaserItem, type RewardReason, type SDKResponse, type SearchOptions, type SectionDefinition, type SettingField, type Shop, type ShopFeedback, type ShopReviewsPage, type ShopReviewsSummary, type ShopTheme, type ShoppexConfig, ShoppexError, type ShoppexInitOptions, type StorefrontAddon, type StorefrontAddonBootstrap, type StorefrontAnnouncementBarAddon, type StorefrontCatalogSearchItem, type StorefrontContactTicketInput, type StorefrontContactTicketResult, type StorefrontCountdownBarAddon, type StorefrontCouponPopupModalAddon, type StorefrontCustomField, type StorefrontData, type StorefrontItem, type StorefrontOnlineUsers, type StorefrontPromoInfoCardAddon, type StorefrontRecentPurchasePopupAddon, type StorefrontRecentSaleEntry, type StorefrontRecentSales, type StorefrontSearchFilterOptions, type StorefrontSocialLinks, type Subscription, type SubscriptionFlags, type SubscriptionInterval, type ThemeBlockManifest, type ThemeConfig, type TrustedChecks, ValidationError, acceptResellerInvite, addFavorite, affiliate, affiliateStats, applyForReseller, buildStorefrontContactMessage, buildStorefrontCustomFieldPayload, buildStorefrontProductLookup, cancelSubscription, claimWarranty, collectProductSearchHaystack, computeCartLineId, createTicket, dashboard, shoppex as default, emailPreferences, enrollAsReseller, ensureCartLineId, favorites, fetchPublishedBuilderSettings, fetchPublishedThemeSettings, filterProductsBySearchQuery, getMenu, getMenuBySlot, getMenuByTitle, getMenuSlotTitles, getMenus, getMergedStorefrontProducts, getShopReviewsPage, getStorefrontGroupProducts, getStorefrontOnlineUsers, getStorefrontRecentSales, groupMatchesSearchQuery, isProductInStock, isProductOutOfStock, isStorefrontCheckboxCustomFieldValueChecked, isVariantOutOfStock, logout, loyalty, me, mergeSettings, normalizeSearchQuery, normalizeStorefrontCustomFields, order, orders, pauseSubscription, productMatchesSearchQuery, quoteResellerOrder, redeemLoyaltyPoints, removeAvatar, removeFavorite, replyToTicket, requestOtp, reseller, resellerApiKeys, resellerCatalog, resellerOrder, resellerOrders, resellerWallet, resetLicenseHwid, resolveDefaults, resolveDisplayStock, resolveStorefrontApiBaseUrl, resolveStorefrontSocialLinks, resolveVariantStockValue, resumeSubscription, revokeAllSessions, revokeSession, searchMergedStorefrontCatalog, searchMergedStorefrontCatalogItems, sessions, shoppex, stripHtmlFromText, submitStorefrontContactTicket, subscriptionBillingHistory, ticket, touchStorefrontPresence, trackCartActivity, trackPageView, updateAvatar, updateEmailPreferences, updateProfile, validateStorefrontCustomFieldValue, verifyOtp, warranties };

package/dist/index.js

@@ -3318,6 +3318,8 @@ function removeItem(key) {
 // ../sdk/src/core/telemetry.ts
 var CONNECTION_ID_STORAGE_PREFIX = "presence_connection_";
 var CLIENT_ERROR_DEDUPE_WINDOW_MS = 15e3;
+var CLIENT_ERROR_TEXT_MAX_LENGTH = 500;
+var CLIENT_ERROR_URL_MAX_LENGTH = 2e3;
 function createPresenceConnectionId() {
   if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
     return crypto.randomUUID();
@@ -3368,14 +3370,14 @@ async function reportStorefrontClientError(payload) {
     client_error: {
       source: payload.source ?? "sdk",
       phase: payload.phase ?? "request",
-      endpoint: payload.endpoint,
+      endpoint: payload.endpoint.slice(0, CLIENT_ERROR_TEXT_MAX_LENGTH),
       method: payload.method,
-      message: payload.message,
+      message: payload.message.slice(0, CLIENT_ERROR_TEXT_MAX_LENGTH),
       status_code: payload.statusCode,
       attempt_count: payload.attemptCount,
       response_received: payload.responseReceived ?? false,
-      page_url: payload.pageUrl ?? window.location.href,
-      request_url: payload.requestUrl,
+      page_url: (payload.pageUrl ?? window.location.href).slice(0, CLIENT_ERROR_URL_MAX_LENGTH),
+      request_url: payload.requestUrl?.slice(0, CLIENT_ERROR_URL_MAX_LENGTH),
       online: payload.online ?? (typeof navigator !== "undefined" ? navigator.onLine : void 0),
       visibility_state: payload.visibilityState ?? (typeof document !== "undefined" ? document.visibilityState : void 0)
     }
@@ -6083,32 +6085,123 @@ function isPlatformPageTrackerActive() {
 }
 
 // ../sdk/src/modules/analytics.ts
-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;
+var CONFIRMED_CART_STORAGE_PREFIX = "reported_cart_";
+var IN_FLIGHT_CART_STORAGE_PREFIX = "reporting_cart_";
+var CART_CLAIM_TTL_MS = 1e4;
+function confirmedCartKey(storeSlug) {
+  return `${CONFIRMED_CART_STORAGE_PREFIX}${storeSlug}`;
+}
+function inFlightCartKey(storeSlug) {
+  return `${IN_FLIGHT_CART_STORAGE_PREFIX}${storeSlug}`;
+}
+function cartSnapshot(cartValue, itemCount) {
+  return `${cartValue ?? ""}|${itemCount ?? ""}`;
+}
+function readInFlightCart(storeSlug) {
+  const claim = getItem(inFlightCartKey(storeSlug));
+  if (!claim || typeof claim.snapshot !== "string" || typeof claim.token !== "string" || typeof claim.at !== "number") {
+    return null;
+  }
+  return claim;
+}
+function isCartReportedOrInFlight(storeSlug, snapshot) {
+  if (getItem(confirmedCartKey(storeSlug)) === snapshot) return true;
+  const claim = readInFlightCart(storeSlug);
+  return claim !== null && claim.snapshot === snapshot && Date.now() - claim.at < CART_CLAIM_TTL_MS;
+}
+function createClaimToken() {
+  if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") return crypto.randomUUID();
+  return `${Date.now().toString(36)}${Math.random().toString(36).slice(2)}`;
+}
+function claimCartReport(storeSlug, cartValue, itemCount) {
+  const snapshot = cartSnapshot(cartValue, itemCount);
+  const token = createClaimToken();
+  setItem(inFlightCartKey(storeSlug), { snapshot, token, at: Date.now() });
+  return (delivered) => {
+    if (readInFlightCart(storeSlug)?.token !== token) return;
+    if (delivered) setItem(confirmedCartKey(storeSlug), snapshot);
+    removeItem(inFlightCartKey(storeSlug));
+  };
+}
+var cartSendTail = Promise.resolve();
+var latestCartRequest = 0;
+function enqueueCartSend(send) {
+  const request2 = ++latestCartRequest;
+  const run = () => send(() => request2 === latestCartRequest);
+  cartSendTail = cartSendTail.then(run, run);
+  return cartSendTail;
+}
+async function postPing(body) {
   const config = getConfig();
-  const connectionId = getStorefrontConnectionId(config.storeSlug);
+  const controller = typeof AbortController === "undefined" ? void 0 : new AbortController();
+  let timer;
+  const timedOut = new Promise((resolve) => {
+    timer = setTimeout(() => {
+      controller?.abort();
+      resolve(false);
+    }, CART_CLAIM_TTL_MS);
+  });
   try {
     const endpoint = buildEndpoint("/v1/storefront/shops/:storeSlug/ping", {
       storeSlug: config.storeSlug
     });
-    await fetch(`${config.apiBaseUrl}${endpoint}`, {
+    const delivered = fetch(`${config.apiBaseUrl}${endpoint}`, {
       method: "POST",
       headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({
-        referer: document.referrer || void 0,
-        cart_value: cartValue ?? void 0,
-        item_count: itemCount ?? void 0,
-        connection_id: connectionId ?? void 0,
-        path: resolveStorefrontPagePath(),
-        utm: resolveUtmParameters(config.storeSlug)
-      })
-    });
+      body: JSON.stringify(body),
+      signal: controller?.signal
+    }).then((response) => response.ok);
+    return await Promise.race([delivered, timedOut]);
   } catch {
+    return false;
+  } finally {
+    clearTimeout(timer);
   }
 }
+async function trackPageView(cartValue, itemCount) {
+  if (!isInitialized()) return;
+  if (typeof document === "undefined") return;
+  const carriesCart = cartValue !== void 0 || itemCount !== void 0;
+  if (isPlatformPageTrackerActive()) {
+    if (carriesCart) await enqueueCartSend(() => sendCartActivity(cartValue, itemCount));
+    return;
+  }
+  const config = getConfig();
+  const sendView = async () => {
+    const settle = carriesCart ? claimCartReport(config.storeSlug, cartValue, itemCount) : void 0;
+    const delivered = await postPing({
+      referer: document.referrer || void 0,
+      cart_value: cartValue,
+      item_count: itemCount,
+      connection_id: getStorefrontConnectionId(config.storeSlug) ?? void 0,
+      path: resolveStorefrontPagePath(),
+      utm: resolveUtmParameters(config.storeSlug)
+    });
+    settle?.(delivered);
+  };
+  await (carriesCart ? enqueueCartSend(sendView) : sendView());
+}
+async function trackCartActivity(cartValue, itemCount) {
+  if (!isInitialized()) return;
+  if (typeof document === "undefined") return;
+  const snapshot = cartSnapshot(cartValue, itemCount);
+  await enqueueCartSend(async (isLatest) => {
+    if (!isLatest() || isCartReportedOrInFlight(getConfig().storeSlug, snapshot)) return;
+    await sendCartActivity(cartValue, itemCount);
+  });
+}
+async function sendCartActivity(cartValue, itemCount) {
+  const config = getConfig();
+  const settle = claimCartReport(config.storeSlug, cartValue, itemCount);
+  const delivered = await postPing({
+    event_type: "presence",
+    cart_value: cartValue,
+    item_count: itemCount,
+    connection_id: getStorefrontConnectionId(config.storeSlug) ?? void 0,
+    path: resolveStorefrontPagePath()
+  });
+  settle(delivered);
+}
 
 // ../sdk/src/modules/presence.ts
 async function getStorefrontRecentSales() {
@@ -6159,6 +6252,7 @@ async function touchStorefrontPresence() {
   return post(
     endpoint,
     {
+      event_type: "presence",
       referer: document.referrer || void 0,
       connection_id: getStorefrontConnectionId(config.storeSlug) ?? void 0,
       path: resolveStorefrontPagePath(),
@@ -6378,6 +6472,7 @@ var shoppex = {
   getMenuSlotTitles,
   // Analytics
   trackPageView,
+  trackCartActivity,
   getStorefrontOnlineUsers,
   getStorefrontRecentSales,
   touchStorefrontPresence,
@@ -6491,6 +6586,7 @@ export {
   subscriptionBillingHistory,
   ticket,
   touchStorefrontPresence,
+  trackCartActivity,
   trackPageView,
   updateAvatar,
   updateEmailPreferences,