@shoppexio/storefront 1.0.87 → 1.0.89

package/dist/index.d.cts

@@ -487,6 +487,13 @@ interface ShopReviewsPage {
     feedback: Feedback[];
     pagination: CursorPagination;
     summary: ShopReviewsSummary;
+    /**
+     * The product filter the API applied (the `product` passed in), or null for
+     * the whole shop. `getShopReviewsPage` fails a filtered request whose answer
+     * does not carry the same id, so a caller never gets another product's
+     * reviews from an API that ignored the filter.
+     */
+    product?: string | null;
 }
 interface ProductBundle {
     id?: string;
@@ -1701,6 +1708,8 @@ declare function validateCoupon(code: string, productOrOptions?: string | Coupon
  * Note: Shoppex has shop-level feedback, not product-level reviews.
  */
 
+/** `code` of a filtered request the API answered without applying the filter. */
+declare const PRODUCT_FILTER_UNSUPPORTED = "reviews_product_filter_unsupported";
 interface ShopReviewsPageOptions {
     /**
      * One product's reviews, by the product's public id (the `id` the catalog
@@ -1923,14 +1932,14 @@ declare function trackPageView(cartValue?: number, itemCount?: number): Promise<
 /**
  * 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.
+ * already counted. A cart state the server holds, or will hold once a send in
+ * flight lands, 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.
+ * The sequence is taken at call time; the check runs when the change's turn
+ * comes, after this tab's earlier sends settled: a revert to the confirmed
+ * cart while another state is on the wire must still go out.
  */
 declare function trackCartActivity(cartValue: number, itemCount: number): Promise<void>;
 
@@ -2111,4 +2120,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, trackCartActivity, 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, PRODUCT_FILTER_UNSUPPORTED, 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

@@ -487,6 +487,13 @@ interface ShopReviewsPage {
     feedback: Feedback[];
     pagination: CursorPagination;
     summary: ShopReviewsSummary;
+    /**
+     * The product filter the API applied (the `product` passed in), or null for
+     * the whole shop. `getShopReviewsPage` fails a filtered request whose answer
+     * does not carry the same id, so a caller never gets another product's
+     * reviews from an API that ignored the filter.
+     */
+    product?: string | null;
 }
 interface ProductBundle {
     id?: string;
@@ -1701,6 +1708,8 @@ declare function validateCoupon(code: string, productOrOptions?: string | Coupon
  * Note: Shoppex has shop-level feedback, not product-level reviews.
  */
 
+/** `code` of a filtered request the API answered without applying the filter. */
+declare const PRODUCT_FILTER_UNSUPPORTED = "reviews_product_filter_unsupported";
 interface ShopReviewsPageOptions {
     /**
      * One product's reviews, by the product's public id (the `id` the catalog
@@ -1923,14 +1932,14 @@ declare function trackPageView(cartValue?: number, itemCount?: number): Promise<
 /**
  * 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.
+ * already counted. A cart state the server holds, or will hold once a send in
+ * flight lands, 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.
+ * The sequence is taken at call time; the check runs when the change's turn
+ * comes, after this tab's earlier sends settled: a revert to the confirmed
+ * cart while another state is on the wire must still go out.
  */
 declare function trackCartActivity(cartValue: number, itemCount: number): Promise<void>;
 
@@ -2111,4 +2120,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, trackCartActivity, 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, PRODUCT_FILTER_UNSUPPORTED, 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

@@ -5372,6 +5372,7 @@ function normalizeFeedback(raw, index) {
     created_at
   };
 }
+var PRODUCT_FILTER_UNSUPPORTED = "reviews_product_filter_unsupported";
 async function getShopReviewsPage(cursor, options = {}) {
   const config = getConfig();
   const query = new URLSearchParams();
@@ -5397,6 +5398,15 @@ async function getShopReviewsPage(cursor, options = {}) {
     }
   );
   if (response.success && response.data) {
+    if (product && response.data.product !== product) {
+      return {
+        success: false,
+        message: "Reviews for a single product are not available from this store yet.",
+        code: PRODUCT_FILTER_UNSUPPORTED,
+        status: 200,
+        responseReceived: true
+      };
+    }
     return {
       success: true,
       data: {
@@ -6082,6 +6092,7 @@ function isPlatformPageTrackerActive() {
 // ../sdk/src/modules/analytics.ts
 var CONFIRMED_CART_STORAGE_PREFIX = "reported_cart_";
 var IN_FLIGHT_CART_STORAGE_PREFIX = "reporting_cart_";
+var CART_SEQUENCE_STORAGE_PREFIX = "presence_cart_seq_";
 var CART_CLAIM_TTL_MS = 1e4;
 function confirmedCartKey(storeSlug) {
   return `${CONFIRMED_CART_STORAGE_PREFIX}${storeSlug}`;
@@ -6089,33 +6100,77 @@ function confirmedCartKey(storeSlug) {
 function inFlightCartKey(storeSlug) {
   return `${IN_FLIGHT_CART_STORAGE_PREFIX}${storeSlug}`;
 }
+function cartSequenceKey(storeSlug) {
+  return `${CART_SEQUENCE_STORAGE_PREFIX}${storeSlug}`;
+}
 function cartSnapshot(cartValue, itemCount) {
   return `${cartValue ?? ""}|${itemCount ?? ""}`;
 }
+function isCartSequence(value) {
+  return typeof value === "number" && Number.isSafeInteger(value) && value > 0;
+}
+var CART_SEQUENCE_SCOPE_MAX_LENGTH = 64;
+function readCartCounter(storeSlug) {
+  const counter = getItem(cartSequenceKey(storeSlug));
+  if (!counter || typeof counter.scope !== "string" || counter.scope.length === 0 || counter.scope.length > CART_SEQUENCE_SCOPE_MAX_LENGTH || !isCartSequence(counter.seq)) {
+    return null;
+  }
+  return counter;
+}
+var lastCartOrder = null;
+function nextCartOrder(storeSlug) {
+  const stored = readCartCounter(storeSlug);
+  const scope = stored?.scope ?? lastCartOrder?.scope ?? createClaimToken();
+  const floor = Math.max(stored?.seq ?? 0, lastCartOrder?.scope === scope ? lastCartOrder.seq : 0);
+  const order2 = { scope, seq: Math.max(Date.now(), floor + 1) };
+  lastCartOrder = order2;
+  setItem(cartSequenceKey(storeSlug), order2);
+  return order2;
+}
+function cartSequenceLocks() {
+  if (typeof navigator === "undefined") return null;
+  const locks = navigator.locks;
+  return locks && typeof locks.request === "function" ? locks : null;
+}
+function reserveCartOrder(storeSlug) {
+  const take = () => nextCartOrder(storeSlug);
+  const locks = cartSequenceLocks();
+  if (!locks) return Promise.resolve(take());
+  return locks.request(cartSequenceKey(storeSlug), take).catch(take);
+}
+function readConfirmedCart(storeSlug) {
+  const confirmed = getItem(confirmedCartKey(storeSlug));
+  if (!confirmed || typeof confirmed.snapshot !== "string" || !isCartSequence(confirmed.seq)) return null;
+  return confirmed;
+}
 function readInFlightCart(storeSlug) {
   const claim = getItem(inFlightCartKey(storeSlug));
-  if (!claim || typeof claim.snapshot !== "string" || typeof claim.token !== "string" || typeof claim.at !== "number") {
+  if (!claim || typeof claim.snapshot !== "string" || !isCartSequence(claim.seq) || typeof claim.token !== "string" || typeof claim.at !== "number") {
     return null;
   }
   return claim;
 }
 function isCartReportedOrInFlight(storeSlug, snapshot) {
-  if (getItem(confirmedCartKey(storeSlug)) === snapshot) return true;
+  const confirmed = readConfirmedCart(storeSlug);
   const claim = readInFlightCart(storeSlug);
-  return claim !== null && claim.snapshot === snapshot && Date.now() - claim.at < CART_CLAIM_TTL_MS;
+  const liveClaim = claim && Date.now() - claim.at < CART_CLAIM_TTL_MS ? claim : null;
+  const expected = liveClaim && (!confirmed || liveClaim.seq > confirmed.seq) ? liveClaim : confirmed;
+  return expected?.snapshot === snapshot;
 }
 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) {
+function claimCartReport(storeSlug, seq, cartValue, itemCount) {
   const snapshot = cartSnapshot(cartValue, itemCount);
   const token = createClaimToken();
-  setItem(inFlightCartKey(storeSlug), { snapshot, token, at: Date.now() });
+  setItem(inFlightCartKey(storeSlug), { snapshot, seq, token, at: Date.now() });
   return (delivered) => {
-    if (readInFlightCart(storeSlug)?.token !== token) return;
-    if (delivered) setItem(confirmedCartKey(storeSlug), snapshot);
-    removeItem(inFlightCartKey(storeSlug));
+    if (delivered) {
+      const confirmed = readConfirmedCart(storeSlug);
+      if (!confirmed || seq > confirmed.seq) setItem(confirmedCartKey(storeSlug), { snapshot, seq });
+    }
+    if (readInFlightCart(storeSlug)?.token === token) removeItem(inFlightCartKey(storeSlug));
   };
 }
 var cartSendTail = Promise.resolve();
@@ -6156,42 +6211,50 @@ async function postPing(body) {
 async function trackPageView(cartValue, itemCount) {
   if (!isInitialized()) return;
   if (typeof document === "undefined") return;
+  const config = getConfig();
   const carriesCart = cartValue !== void 0 || itemCount !== void 0;
+  const reservedOrder = carriesCart ? reserveCartOrder(config.storeSlug) : void 0;
   if (isPlatformPageTrackerActive()) {
-    if (carriesCart) await enqueueCartSend(() => sendCartActivity(cartValue, itemCount));
+    if (reservedOrder) await enqueueCartSend(async () => sendCartActivity(await reservedOrder, cartValue, itemCount));
     return;
   }
-  const config = getConfig();
   const sendView = async () => {
-    const settle = carriesCart ? claimCartReport(config.storeSlug, cartValue, itemCount) : void 0;
+    const order2 = reservedOrder ? await reservedOrder : void 0;
+    const settle = order2 ? claimCartReport(config.storeSlug, order2.seq, cartValue, itemCount) : void 0;
     const delivered = await postPing({
       referer: document.referrer || void 0,
       cart_value: cartValue,
       item_count: itemCount,
+      cart_seq: order2?.seq,
+      cart_seq_scope: order2?.scope,
       connection_id: getStorefrontConnectionId(config.storeSlug) ?? void 0,
       path: resolveStorefrontPagePath(),
       utm: resolveUtmParameters(config.storeSlug)
     });
     settle?.(delivered);
   };
-  await (carriesCart ? enqueueCartSend(sendView) : sendView());
+  await (reservedOrder ? enqueueCartSend(sendView) : sendView());
 }
 async function trackCartActivity(cartValue, itemCount) {
   if (!isInitialized()) return;
   if (typeof document === "undefined") return;
   const snapshot = cartSnapshot(cartValue, itemCount);
+  const reservedOrder = reserveCartOrder(getConfig().storeSlug);
   await enqueueCartSend(async (isLatest) => {
+    const order2 = await reservedOrder;
     if (!isLatest() || isCartReportedOrInFlight(getConfig().storeSlug, snapshot)) return;
-    await sendCartActivity(cartValue, itemCount);
+    await sendCartActivity(order2, cartValue, itemCount);
   });
 }
-async function sendCartActivity(cartValue, itemCount) {
+async function sendCartActivity(order2, cartValue, itemCount) {
   const config = getConfig();
-  const settle = claimCartReport(config.storeSlug, cartValue, itemCount);
+  const settle = claimCartReport(config.storeSlug, order2.seq, cartValue, itemCount);
   const delivered = await postPing({
     event_type: "presence",
     cart_value: cartValue,
     item_count: itemCount,
+    cart_seq: order2.seq,
+    cart_seq_scope: order2.scope,
     connection_id: getStorefrontConnectionId(config.storeSlug) ?? void 0,
     path: resolveStorefrontPagePath()
   });
@@ -6501,6 +6564,7 @@ export {
   NetworkError,
   NotInitializedError,
   PAYABLE_AMOUNT_DECIMAL_PLACES,
+  PRODUCT_FILTER_UNSUPPORTED,
   ShoppexError,
   ValidationError,
   acceptResellerInvite,