@shoppexio/storefront 1.0.84 → 1.0.87

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,9 +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 that any tab of this shop already reported is
- * not sent again, so a cross-tab `storage` echo of a change is not a second
- * ping.
+ * 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>;
 

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,9 +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 that any tab of this shop already reported is
- * not sent again, so a cross-tab `storage` echo of a change is not a second
- * ping.
+ * 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>;
 

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)
     }
@@ -5370,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", {
@@ -5384,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
       }
@@ -5399,10 +5405,7 @@ async function getShopReviewsPage(cursor) {
       }
     };
   }
-  return {
-    success: false,
-    message: response.message
-  };
+  return forwardFailure(response);
 }
 async function getShopReviews() {
   const allFeedback = [];
@@ -5872,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();
@@ -5898,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
@@ -6083,72 +6080,122 @@ function isPlatformPageTrackerActive() {
 }
 
 // ../sdk/src/modules/analytics.ts
-var REPORTED_CART_STORAGE_PREFIX = "reported_cart_";
-function reportedCartKey(storeSlug) {
-  return `${REPORTED_CART_STORAGE_PREFIX}${storeSlug}`;
+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 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()) {
-    if (carriesCart) await sendCartActivity(cartValue ?? 0, itemCount ?? 0);
-    return;
+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);
-  if (carriesCart) rememberReportedCart(config.storeSlug, cartValue, itemCount);
+  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;
-  if (getItem(reportedCartKey(getConfig().storeSlug)) === cartSnapshot(cartValue, itemCount)) return;
-  await sendCartActivity(cartValue, itemCount);
+  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();
-  rememberReportedCart(config.storeSlug, cartValue, itemCount);
-  try {
-    const endpoint = buildEndpoint("/v1/storefront/shops/:storeSlug/ping", {
-      storeSlug: config.storeSlug
-    });
-    await fetch(`${config.apiBaseUrl}${endpoint}`, {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({
-        event_type: "presence",
-        cart_value: cartValue,
-        item_count: itemCount,
-        connection_id: getStorefrontConnectionId(config.storeSlug) ?? void 0,
-        path: resolveStorefrontPagePath()
-      })
-    });
-  } catch {
-  }
+  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