@salla.sa/twilight-components 2.14.554 → 2.14.556

package/dist/components/Helper.js

@@ -255,6 +255,42 @@ class Helper {
             salla.logger.warn('Error saving position to session storage');
         }
     }
+    /**
+     * Persist the `s-request-id` of the products response the customer just interacted
+     * with, so the analytics event that follows can be attributed back to it.
+     *
+     * KNOWN LIMITATION — deliberate, accepted for this release.
+     * This is a single shared value, so the last interaction wins. Two flows can therefore
+     * attach the wrong request id to an event:
+     *   1. Infinite scroll — a later page overwrites this value while the earlier pages'
+     *      cards are still on screen, so clicking a product from page 1 after page 2 has
+     *      loaded attributes the event to the page-2 response.
+     *   2. Interleaved add-to-cart — `Product Added` only fires once the async cart request
+     *      resolves. If the customer interacts with another product in the meantime, this
+     *      value has already been replaced by the time the event reads it.
+     *
+     * Why this is safe to ship as-is: `request_id` is an analytics-attribution field only.
+     * It is never read by storefront logic, never affects the cart, pricing, the order, or
+     * anything the customer sees, and every read and write here is wrapped so it cannot
+     * throw. The worst outcome is one analytics row carrying a neighbouring request id —
+     * the event still fires, and its product, position and source fields stay correct.
+     * Both flows also need a specific interleaving to occur at all, so they are the
+     * exception rather than the norm.
+     *
+     * The fix is to key the stored value by product id instead of sharing one slot, which
+     * changes this method's signature and the session-storage schema. That is being handled
+     * as a follow-up enhancement rather than widening this PR.
+     */
+    saveRequestId(requestId) {
+        if (!requestId)
+            return;
+        try {
+            sessionStorage.setItem('s-request-id', requestId);
+        }
+        catch (error) {
+            salla.logger.warn('Error saving request id to session storage');
+        }
+    }
     saveAddToCartSource(source) {
         this.saveSource('s-add-to-cart-source', source);
     }