@salla.sa/twilight-components 2.14.590 → 2.14.592

package/dist/collection/components/salla-conditional-offer/cart-update-window.js

@@ -0,0 +1,34 @@
+/*!
+ * Crafted with ❤ by Salla
+ */
+/**
+ * TRAILING window over which a BURST of `cart::updated` events collapses into ONE refresh
+ * pass in `salla-conditional-offer`.
+ *
+ * `cart::updated` is not one-event-per-shopper-action. `CartEvents.updated()` is called
+ * from SIX call sites (twilight/src/event/cart.js:122-174) — `latestFetched`, `itemAdded`,
+ * `itemDeleted`, `itemUpdated`, `couponAdded`, `couponDeleted` — and a single mutation
+ * routinely produces more than one of them, because the mutation's own response and the
+ * summary refetch that follows it both land here. Each one used to cost the banner TWO
+ * server round trips: `offers()` from `refresh()`, and `details()` from the
+ * `refreshCartFreeGifts()` + `loadCart()` pair. That is now paid ONCE per burst.
+ *
+ * TRAILING, not leading: the LAST event of a burst is the one that describes the cart the
+ * shopper is actually looking at, so the pass has to run after it, not before it. A
+ * leading-edge debounce would answer from the FIRST event and need a second pass anyway.
+ *
+ * What is deliberately NOT deferred is `readCartCountFromEvent`, which stays synchronous on
+ * every single event — it is what hides the banner the instant the cart empties, and
+ * `render()` gates on `hasCartItems()` alone, so the hidden-by-default behaviour is
+ * unaffected by this window. Only the REQUESTS wait.
+ *
+ * 200ms is comfortably below the ~500ms `Helper.debounce` the quantity stepper already
+ * applies upstream (Helpers/Helper.ts:45-51), so this cannot swallow two deliberate,
+ * separate shopper actions into one pass — it only collapses the machine-generated repeats
+ * of a single one.
+ *
+ * It lives in its own module rather than beside the component's other timing constants
+ * because Stencil allows a `@Component()` module exactly one export — the class — and the
+ * spec has to assert against the REAL number rather than a copy of it.
+ */
+export const CART_UPDATE_COALESCE_MS = 200;

package/dist/collection/components/salla-conditional-offer/interfaces.js

@@ -6,6 +6,7 @@ export var DiscountType;
     DiscountType["PERCENTAGE"] = "percentage";
     DiscountType["FIXED"] = "fixed";
     DiscountType["FREE_PRODUCT"] = "free_product";
+    DiscountType["FREE_SHIPPING"] = "free_shipping";
 })(DiscountType || (DiscountType = {}));
 export var OfferType;
 (function (OfferType) {