@shoppexio/storefront 1.0.85 → 1.0.88

package/dist/index.d.cts

@@ -1701,7 +1701,14 @@ declare function validateCoupon(code: string, productOrOptions?: string | Coupon
  * Note: Shoppex has shop-level feedback, not product-level reviews.
  */
 
-declare function getShopReviewsPage(cursor?: string | null): Promise<SDKResponse<ShopReviewsPage>>;
+interface ShopReviewsPageOptions {
+    /**
+     * One product's reviews, by the product's public id (the `id` the catalog
+     * carries). The page's `summary` then counts that product's reviews only.
+     */
+    product?: string | null;
+}
+declare function getShopReviewsPage(cursor?: string | null, options?: ShopReviewsPageOptions): Promise<SDKResponse<ShopReviewsPage>>;
 declare function getShopReviews(): Promise<SDKResponse<Feedback[]>>;
 
 /**
@@ -1916,14 +1923,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>;
 

package/dist/index.d.ts

@@ -1701,7 +1701,14 @@ declare function validateCoupon(code: string, productOrOptions?: string | Coupon
  * Note: Shoppex has shop-level feedback, not product-level reviews.
  */
 
-declare function getShopReviewsPage(cursor?: string | null): Promise<SDKResponse<ShopReviewsPage>>;
+interface ShopReviewsPageOptions {
+    /**
+     * One product's reviews, by the product's public id (the `id` the catalog
+     * carries). The page's `summary` then counts that product's reviews only.
+     */
+    product?: string | null;
+}
+declare function getShopReviewsPage(cursor?: string | null, options?: ShopReviewsPageOptions): Promise<SDKResponse<ShopReviewsPage>>;
 declare function getShopReviews(): Promise<SDKResponse<Feedback[]>>;
 
 /**
@@ -1916,14 +1923,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>;
 

package/dist/index.js

@@ -5372,13 +5372,17 @@ function normalizeFeedback(raw, index) {
     created_at
   };
 }
-async function getShopReviewsPage(cursor) {
+async function getShopReviewsPage(cursor, options = {}) {
   const config = getConfig();
   const query = new URLSearchParams();
   query.set("limit", String(REVIEWS_PAGE_LIMIT));
   if (typeof cursor === "string" && cursor.trim().length > 0) {
     query.set("cursor", cursor);
   }
+  const product = typeof options.product === "string" ? options.product.trim() : "";
+  if (product) {
+    query.set("product", product);
+  }
   const querySuffix = `?${query.toString()}`;
   const response = await get(
     `${buildEndpoint("/v1/storefront/feedback/shop/:storeSlug", {
@@ -5386,7 +5390,7 @@ async function getShopReviewsPage(cursor) {
     })}${querySuffix}`,
     {
       cache: {
-        key: `reviews:${config.storeSlug}:${cursor ?? "start"}:${REVIEWS_PAGE_LIMIT}`,
+        key: `reviews:${config.storeSlug}:${product || "all"}:${cursor ?? "start"}:${REVIEWS_PAGE_LIMIT}`,
         ttl: REVIEWS_CACHE_TTL,
         staleWhileRevalidate: true
       }
@@ -5401,10 +5405,7 @@ async function getShopReviewsPage(cursor) {
       }
     };
   }
-  return {
-    success: false,
-    message: response.message
-  };
+  return forwardFailure(response);
 }
 async function getShopReviews() {
   const allFeedback = [];
@@ -5874,10 +5875,7 @@ async function getPages() {
       data: response.data.pages
     };
   }
-  return {
-    success: false,
-    message: response.message
-  };
+  return forwardFailure(response);
 }
 async function getPage(slug) {
   const config = getConfig();
@@ -5900,10 +5898,7 @@ async function getPage(slug) {
       data: response.data.page
     };
   }
-  return {
-    success: false,
-    message: response.message
-  };
+  return forwardFailure(response);
 }
 
 // ../sdk/src/modules/navigation.ts
@@ -6087,6 +6082,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}`;
@@ -6094,33 +6090,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();
@@ -6161,42 +6201,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()
   });