@lime-bundles/widget 4.5.1 → 4.6.1

package/README.md

@@ -62,9 +62,12 @@ document.querySelector("lime-bundle").addEventListener(
 | `app-url` |  | Enables impression + add-to-cart analytics when set. |
 | `analytics` |  | `"false"` suppresses analytics even when `app-url` is set. |
 | `locale` |  | BCP-47 tag forwarded to the Storefront API. |
-| `country` |  | ISO-3166 alpha-2 (e.g. `"US"`). Adds `@inContext(country:)` to Storefront queries — Markets pricing + currency. |
+| `country` |  | ISO-3166 alpha-2 (e.g. `"US"`). Adds `@inContext(country:)` to Storefront queries — Markets pricing + currency — and matches market-restricted bundles' projected country codes. |
 | `language` |  | ISO-639-1 (e.g. `"EN"`). Adds `@inContext(language:)`. |
-| `market-id` |  | Current visitor's Market GID. Hides market-restricted bundles whose allow-list doesn't include this market. |
+| `market-id` |  | Current visitor's Market GID. Legacy market-gate signal; prefer `country` (retail) and the `buyer` property (B2B) — a B2B buyer's company-location market has no storefront market context. |
+| `currency-rate` |  | Store→presentment currency rate. Merchant-configured amounts (fixed-amount discounts, flat prices, volume tier amounts) are stored in the shop's store currency; on a "local currencies" market, pass the buyer's rate (on a Liquid-adjacent page, `window.Shopify.currency.rate`) so quoted sale prices match what checkout charges. Defaults to `1` (no conversion); invalid or non-positive values also fall back to `1`. Percentages are unaffected. |
+
+A market-restricted bundle renders when any signal matches: `country` vs the bundle's projected country codes, the resolved `buyer` property's `companyLocationId` vs its projected company locations, or `market-id` vs its market allow-list.
 
 **Product resolution** (when `bundle-gid` is absent): explicit `product-handle` → `<meta name="shopify:product-handle">` → `/products/<handle>` URL segment.
 

package/dist/index.cjs

@@ -43,6 +43,8 @@ function intlFormatMoney(currencyCode) {
 }
 var BUNDLE_GID_ATTRIBUTE = "_lime_bundle_gid";
 var BUNDLE_TYPE_ATTRIBUTE = "_lime_bundle_type";
+var BUNDLE_ROLE_ATTRIBUTE = "_lime_bundle_role";
+var BUNDLE_ROLE_GET = "get";
 function bundleLineAttributes(bundleGid, bundleType) {
   return [
     { key: BUNDLE_GID_ATTRIBUTE, value: bundleGid },
@@ -3170,7 +3172,8 @@ function buildBogoCartItems(sides, percent, buyQty, getQty) {
     {
       variantId: Number(sides[1].selectedVariantId),
       quantity: getQty,
-      priceCents: getPriceCents
+      priceCents: getPriceCents,
+      attributes: [{ key: BUNDLE_ROLE_ATTRIBUTE, value: BUNDLE_ROLE_GET }]
     }
   ];
 }
@@ -3195,18 +3198,20 @@ function renderBogoBundle(container, bundle, onAddToCart, onCleanup) {
     productQuantities: bundle.productQuantities,
     variantQuantities: bundle.variantQuantities
   };
+  const buyAllowed = bundle.buyVariantIds?.length ? bundle.buyVariantIds : null;
+  const getAllowed = bundle.getVariantIds?.length ? bundle.getVariantIds : null;
   const sides = [
     {
       ...adaptProduct(buyProduct, bundle.id, {
         quantities,
-        allowedVariantIds: bundle.selectedVariantIds?.[0] ?? null
+        allowedVariantIds: buyAllowed
       }),
       role: "buy"
     },
     {
       ...adaptProduct(getProduct, bundle.id, {
         quantities,
-        allowedVariantIds: bundle.selectedVariantIds?.[1] ?? null
+        allowedVariantIds: getAllowed
       }),
       role: "get"
     }
@@ -3268,7 +3273,12 @@ function renderBogoBundle(container, bundle, onAddToCart, onCleanup) {
         buildBogoCartItems(sides, percent, buyQty, getQty).map((item) => ({
           merchandiseId: "gid://shopify/ProductVariant/" + item.variantId,
           quantity: item.quantity,
-          attributes: bundleLineAttributes(bundle.id, bundle.bundleType)
+          // Per-line extras (the reward marker) on top of the attribution
+          // every line carries.
+          attributes: [
+            ...bundleLineAttributes(bundle.id, bundle.bundleType),
+            ...item.attributes ?? []
+          ]
         }))
       );
     });
@@ -7212,7 +7222,8 @@ var LimeBundleElement = class extends HTMLElement {
     "locale",
     "country",
     "language",
-    "market-id"
+    "market-id",
+    "currency-rate"
   ];
   /**
    * B2B buyer identity. Set programmatically — `element.buyer = {...}` or
@@ -7267,7 +7278,7 @@ var LimeBundleElement = class extends HTMLElement {
   }
   attributeChangedCallback(name, oldValue, newValue) {
     if (oldValue === newValue || !this.isConnected) return;
-    if (name === "bundle-gid" || name === "product-handle" || name === "product-id" || name === "shop-domain" || name === "storefront-token") {
+    if (name === "bundle-gid" || name === "product-handle" || name === "product-id" || name === "shop-domain" || name === "storefront-token" || name === "currency-rate") {
       if (this.shopDomain && this.storefrontToken) {
         this.fetchBundle();
       }
@@ -7310,6 +7321,17 @@ var LimeBundleElement = class extends HTMLElement {
   get marketId() {
     return this.getAttribute("market-id") ?? void 0;
   }
+  /**
+   * Store→presentment currency rate. Merchant-configured amounts
+   * (fixed_amount / flat_price values, volume tier amounts) are stored in
+   * the shop's store currency; set this to the buyer's currency rate so
+   * quoted sale prices match what the checkout's discount function
+   * charges. Anything unparseable or non-positive falls back to 1 —
+   * no conversion — via `normalizeCurrencyRate`.
+   */
+  get currencyRate() {
+    return this.getAttribute("currency-rate") ?? void 0;
+  }
   /**
    * Returns the @inContext-wrapped query when any context field is set;
    * otherwise the plain query. Keeps responses publicly cacheable when
@@ -7324,14 +7346,23 @@ var LimeBundleElement = class extends HTMLElement {
       buyer: this.buyer
     }) ? (0, import_core6.withInContext)(query) : query;
   }
+  /** Buyer resolved once per fetch so the market gate can read the
+   *  company location without invoking a callback resolver twice. */
+  resolvedBuyer = void 0;
   /**
-   * Returns true if this bundle should be hidden for the current market.
+   * Returns true if this bundle should be hidden for the current buyer.
    * For "all" bundles, always returns false (visible). For "specific"
-   * bundles, returns true when no marketId was set or when the bundle's
-   * marketIds doesn't include the configured market.
+   * bundles, visibility needs a matching signal: the `country` attribute
+   * against the bundle's projected country codes (retail markets), the
+   * resolved buyer's companyLocationId against its projected company
+   * locations (B2B markets), or a legacy `market-id` match.
    */
   isMarketHidden(bundle) {
-    return !(0, import_core6.isVisibleInMarket)(bundle, this.marketId);
+    return !(0, import_core6.isVisibleToBuyer)(bundle, {
+      marketId: this.marketId,
+      countryCode: this.country,
+      companyLocationId: this.resolvedBuyer?.companyLocationId
+    });
   }
   async fetchBundle() {
     if (!this.shopDomain || !this.storefrontToken) {
@@ -7344,12 +7375,17 @@ var LimeBundleElement = class extends HTMLElement {
     const controller = new AbortController();
     this.abortController = controller;
     this.renderLoading();
+    try {
+      this.resolvedBuyer = typeof this.buyer === "function" ? await this.buyer() : this.buyer;
+    } catch {
+      this.resolvedBuyer = void 0;
+    }
     const client = (0, import_core6.createStorefrontClient)({
       shopDomain: this.shopDomain,
       accessToken: this.storefrontToken,
       country: this.country,
       language: this.language,
-      buyer: this.buyer
+      buyer: this.resolvedBuyer
     });
     try {
       let bundlePromise;
@@ -7414,7 +7450,7 @@ var LimeBundleElement = class extends HTMLElement {
       data.metaobject.id,
       data.metaobject.fields
     );
-    this.bundles = parsed && !this.isMarketHidden(parsed) ? [parsed] : [];
+    this.bundles = parsed && !this.isMarketHidden(parsed) ? [(0, import_core6.convertBundleToPresentment)(parsed, this.currencyRate)] : [];
   }
   async fetchProductBundles(client, signal, productHandle) {
     const data = await client.query(
@@ -7430,7 +7466,9 @@ var LimeBundleElement = class extends HTMLElement {
     const bundles = [];
     for (const ref of refs) {
       const parsed = (0, import_core6.parseMetaobjectBundle)(ref.id, ref.fields);
-      if (parsed && !this.isMarketHidden(parsed)) bundles.push(parsed);
+      if (parsed && !this.isMarketHidden(parsed)) {
+        bundles.push((0, import_core6.convertBundleToPresentment)(parsed, this.currencyRate));
+      }
     }
     this.bundles = (0, import_core6.resolveAbTests)(bundles, (0, import_core6.getVisitorId)());
   }

package/dist/index.d.cts

@@ -109,17 +109,31 @@ declare class LimeBundleElement extends HTMLElement {
     private get country();
     private get language();
     private get marketId();
+    /**
+     * Store→presentment currency rate. Merchant-configured amounts
+     * (fixed_amount / flat_price values, volume tier amounts) are stored in
+     * the shop's store currency; set this to the buyer's currency rate so
+     * quoted sale prices match what the checkout's discount function
+     * charges. Anything unparseable or non-positive falls back to 1 —
+     * no conversion — via `normalizeCurrencyRate`.
+     */
+    private get currencyRate();
     /**
      * Returns the @inContext-wrapped query when any context field is set;
      * otherwise the plain query. Keeps responses publicly cacheable when
      * no buyer/country/language is set.
      */
     private wrapQueryForContext;
+    /** Buyer resolved once per fetch so the market gate can read the
+     *  company location without invoking a callback resolver twice. */
+    private resolvedBuyer;
     /**
-     * Returns true if this bundle should be hidden for the current market.
+     * Returns true if this bundle should be hidden for the current buyer.
      * For "all" bundles, always returns false (visible). For "specific"
-     * bundles, returns true when no marketId was set or when the bundle's
-     * marketIds doesn't include the configured market.
+     * bundles, visibility needs a matching signal: the `country` attribute
+     * against the bundle's projected country codes (retail markets), the
+     * resolved buyer's companyLocationId against its projected company
+     * locations (B2B markets), or a legacy `market-id` match.
      */
     private isMarketHidden;
     private fetchBundle;

package/dist/index.d.ts

@@ -109,17 +109,31 @@ declare class LimeBundleElement extends HTMLElement {
     private get country();
     private get language();
     private get marketId();
+    /**
+     * Store→presentment currency rate. Merchant-configured amounts
+     * (fixed_amount / flat_price values, volume tier amounts) are stored in
+     * the shop's store currency; set this to the buyer's currency rate so
+     * quoted sale prices match what the checkout's discount function
+     * charges. Anything unparseable or non-positive falls back to 1 —
+     * no conversion — via `normalizeCurrencyRate`.
+     */
+    private get currencyRate();
     /**
      * Returns the @inContext-wrapped query when any context field is set;
      * otherwise the plain query. Keeps responses publicly cacheable when
      * no buyer/country/language is set.
      */
     private wrapQueryForContext;
+    /** Buyer resolved once per fetch so the market gate can read the
+     *  company location without invoking a callback resolver twice. */
+    private resolvedBuyer;
     /**
-     * Returns true if this bundle should be hidden for the current market.
+     * Returns true if this bundle should be hidden for the current buyer.
      * For "all" bundles, always returns false (visible). For "specific"
-     * bundles, returns true when no marketId was set or when the bundle's
-     * marketIds doesn't include the configured market.
+     * bundles, visibility needs a matching signal: the `country` attribute
+     * against the bundle's projected country codes (retail markets), the
+     * resolved buyer's companyLocationId against its projected company
+     * locations (B2B markets), or a legacy `market-id` match.
      */
     private isMarketHidden;
     private fetchBundle;

package/dist/index.js

@@ -9,6 +9,7 @@ import {
   CART_LINES_REMOVE_MUTATION,
   SHOP_SETTINGS_QUERY,
   parseMetaobjectBundle,
+  convertBundleToPresentment,
   observeImpression,
   reportImpression,
   reportAddToCart,
@@ -16,7 +17,7 @@ import {
   sanitizeCustomCss,
   hasInContext,
   withInContext,
-  isVisibleInMarket,
+  isVisibleToBuyer,
   getVisitorId,
   resolveAbTests
 } from "@lime-bundles/core";
@@ -36,6 +37,8 @@ function intlFormatMoney(currencyCode) {
 }
 var BUNDLE_GID_ATTRIBUTE = "_lime_bundle_gid";
 var BUNDLE_TYPE_ATTRIBUTE = "_lime_bundle_type";
+var BUNDLE_ROLE_ATTRIBUTE = "_lime_bundle_role";
+var BUNDLE_ROLE_GET = "get";
 function bundleLineAttributes(bundleGid, bundleType) {
   return [
     { key: BUNDLE_GID_ATTRIBUTE, value: bundleGid },
@@ -3175,7 +3178,8 @@ function buildBogoCartItems(sides, percent, buyQty, getQty) {
     {
       variantId: Number(sides[1].selectedVariantId),
       quantity: getQty,
-      priceCents: getPriceCents
+      priceCents: getPriceCents,
+      attributes: [{ key: BUNDLE_ROLE_ATTRIBUTE, value: BUNDLE_ROLE_GET }]
     }
   ];
 }
@@ -3200,18 +3204,20 @@ function renderBogoBundle(container, bundle, onAddToCart, onCleanup) {
     productQuantities: bundle.productQuantities,
     variantQuantities: bundle.variantQuantities
   };
+  const buyAllowed = bundle.buyVariantIds?.length ? bundle.buyVariantIds : null;
+  const getAllowed = bundle.getVariantIds?.length ? bundle.getVariantIds : null;
   const sides = [
     {
       ...adaptProduct(buyProduct, bundle.id, {
         quantities,
-        allowedVariantIds: bundle.selectedVariantIds?.[0] ?? null
+        allowedVariantIds: buyAllowed
       }),
       role: "buy"
     },
     {
       ...adaptProduct(getProduct, bundle.id, {
         quantities,
-        allowedVariantIds: bundle.selectedVariantIds?.[1] ?? null
+        allowedVariantIds: getAllowed
       }),
       role: "get"
     }
@@ -3273,7 +3279,12 @@ function renderBogoBundle(container, bundle, onAddToCart, onCleanup) {
         buildBogoCartItems(sides, percent, buyQty, getQty).map((item) => ({
           merchandiseId: "gid://shopify/ProductVariant/" + item.variantId,
           quantity: item.quantity,
-          attributes: bundleLineAttributes(bundle.id, bundle.bundleType)
+          // Per-line extras (the reward marker) on top of the attribution
+          // every line carries.
+          attributes: [
+            ...bundleLineAttributes(bundle.id, bundle.bundleType),
+            ...item.attributes ?? []
+          ]
         }))
       );
     });
@@ -7220,7 +7231,8 @@ var LimeBundleElement = class extends HTMLElement {
     "locale",
     "country",
     "language",
-    "market-id"
+    "market-id",
+    "currency-rate"
   ];
   /**
    * B2B buyer identity. Set programmatically — `element.buyer = {...}` or
@@ -7275,7 +7287,7 @@ var LimeBundleElement = class extends HTMLElement {
   }
   attributeChangedCallback(name, oldValue, newValue) {
     if (oldValue === newValue || !this.isConnected) return;
-    if (name === "bundle-gid" || name === "product-handle" || name === "product-id" || name === "shop-domain" || name === "storefront-token") {
+    if (name === "bundle-gid" || name === "product-handle" || name === "product-id" || name === "shop-domain" || name === "storefront-token" || name === "currency-rate") {
       if (this.shopDomain && this.storefrontToken) {
         this.fetchBundle();
       }
@@ -7318,6 +7330,17 @@ var LimeBundleElement = class extends HTMLElement {
   get marketId() {
     return this.getAttribute("market-id") ?? void 0;
   }
+  /**
+   * Store→presentment currency rate. Merchant-configured amounts
+   * (fixed_amount / flat_price values, volume tier amounts) are stored in
+   * the shop's store currency; set this to the buyer's currency rate so
+   * quoted sale prices match what the checkout's discount function
+   * charges. Anything unparseable or non-positive falls back to 1 —
+   * no conversion — via `normalizeCurrencyRate`.
+   */
+  get currencyRate() {
+    return this.getAttribute("currency-rate") ?? void 0;
+  }
   /**
    * Returns the @inContext-wrapped query when any context field is set;
    * otherwise the plain query. Keeps responses publicly cacheable when
@@ -7332,14 +7355,23 @@ var LimeBundleElement = class extends HTMLElement {
       buyer: this.buyer
     }) ? withInContext(query) : query;
   }
+  /** Buyer resolved once per fetch so the market gate can read the
+   *  company location without invoking a callback resolver twice. */
+  resolvedBuyer = void 0;
   /**
-   * Returns true if this bundle should be hidden for the current market.
+   * Returns true if this bundle should be hidden for the current buyer.
    * For "all" bundles, always returns false (visible). For "specific"
-   * bundles, returns true when no marketId was set or when the bundle's
-   * marketIds doesn't include the configured market.
+   * bundles, visibility needs a matching signal: the `country` attribute
+   * against the bundle's projected country codes (retail markets), the
+   * resolved buyer's companyLocationId against its projected company
+   * locations (B2B markets), or a legacy `market-id` match.
    */
   isMarketHidden(bundle) {
-    return !isVisibleInMarket(bundle, this.marketId);
+    return !isVisibleToBuyer(bundle, {
+      marketId: this.marketId,
+      countryCode: this.country,
+      companyLocationId: this.resolvedBuyer?.companyLocationId
+    });
   }
   async fetchBundle() {
     if (!this.shopDomain || !this.storefrontToken) {
@@ -7352,12 +7384,17 @@ var LimeBundleElement = class extends HTMLElement {
     const controller = new AbortController();
     this.abortController = controller;
     this.renderLoading();
+    try {
+      this.resolvedBuyer = typeof this.buyer === "function" ? await this.buyer() : this.buyer;
+    } catch {
+      this.resolvedBuyer = void 0;
+    }
     const client = createStorefrontClient({
       shopDomain: this.shopDomain,
       accessToken: this.storefrontToken,
       country: this.country,
       language: this.language,
-      buyer: this.buyer
+      buyer: this.resolvedBuyer
     });
     try {
       let bundlePromise;
@@ -7422,7 +7459,7 @@ var LimeBundleElement = class extends HTMLElement {
       data.metaobject.id,
       data.metaobject.fields
     );
-    this.bundles = parsed && !this.isMarketHidden(parsed) ? [parsed] : [];
+    this.bundles = parsed && !this.isMarketHidden(parsed) ? [convertBundleToPresentment(parsed, this.currencyRate)] : [];
   }
   async fetchProductBundles(client, signal, productHandle) {
     const data = await client.query(
@@ -7438,7 +7475,9 @@ var LimeBundleElement = class extends HTMLElement {
     const bundles = [];
     for (const ref of refs) {
       const parsed = parseMetaobjectBundle(ref.id, ref.fields);
-      if (parsed && !this.isMarketHidden(parsed)) bundles.push(parsed);
+      if (parsed && !this.isMarketHidden(parsed)) {
+        bundles.push(convertBundleToPresentment(parsed, this.currencyRate));
+      }
     }
     this.bundles = resolveAbTests(bundles, getVisitorId());
   }