@lime-bundles/widget 3.3.0 → 3.4.0

package/dist/index.d.cts

@@ -105,14 +105,20 @@ declare class LimeBundleElement extends HTMLElement {
     private isMarketHidden;
     private fetchBundle;
     /**
-     * Resolve the visitor's A/B bucket for every bundle with an active test
-     * and merge Variant B overrides where applicable. Runs in parallel; any
-     * assignment failure logs internally but still renders Variant A (safe
-     * default). The `getABTestAssignment` helper persists the bucket via a
-     * first-party cookie; variant attribution is recorded server-side from
-     * the analytics events the widget already emits.
+     * Resolve the visitor's assigned variant for every primary bundle in a link
+     * group. Runs in parallel; any assignment failure logs internally and still
+     * renders the primary (safe default). The `getLinkGroupAssignment` helper
+     * persists the bucket via a first-party cookie; variant attribution is
+     * recorded server-side from the cart-line `_lime_bundle_gid` + `_lime_link_group`
+     * attributes the cart-add path stamps when an assignment lands on a non-primary
+     * variant.
+     *
+     * When the assignment points to a non-primary variant the SDK swaps in that
+     * variant's `ParsedBundle` from the primary's `linkGroup.variants` list. The
+     * variant data must already be present in the storefront query response — the
+     * SDK does NOT issue a separate metaobject fetch on the hot path.
      */
-    private applyABVariants;
+    private applyLinkGroupVariants;
     private fetchSingleBundle;
     private fetchProductBundles;
     /**

package/dist/index.d.ts

@@ -105,14 +105,20 @@ declare class LimeBundleElement extends HTMLElement {
     private isMarketHidden;
     private fetchBundle;
     /**
-     * Resolve the visitor's A/B bucket for every bundle with an active test
-     * and merge Variant B overrides where applicable. Runs in parallel; any
-     * assignment failure logs internally but still renders Variant A (safe
-     * default). The `getABTestAssignment` helper persists the bucket via a
-     * first-party cookie; variant attribution is recorded server-side from
-     * the analytics events the widget already emits.
+     * Resolve the visitor's assigned variant for every primary bundle in a link
+     * group. Runs in parallel; any assignment failure logs internally and still
+     * renders the primary (safe default). The `getLinkGroupAssignment` helper
+     * persists the bucket via a first-party cookie; variant attribution is
+     * recorded server-side from the cart-line `_lime_bundle_gid` + `_lime_link_group`
+     * attributes the cart-add path stamps when an assignment lands on a non-primary
+     * variant.
+     *
+     * When the assignment points to a non-primary variant the SDK swaps in that
+     * variant's `ParsedBundle` from the primary's `linkGroup.variants` list. The
+     * variant data must already be present in the storefront query response — the
+     * SDK does NOT issue a separate metaobject fetch on the hot path.
      */
-    private applyABVariants;
+    private applyLinkGroupVariants;
     private fetchSingleBundle;
     private fetchProductBundles;
     /**

package/dist/index.js

@@ -12,8 +12,7 @@ import {
   reportAddToCart,
   injectCustomCss,
   sanitizeCustomCss,
-  getABTestAssignment,
-  applyABVariantB,
+  getLinkGroupAssignment,
   hasInContext,
   withInContext
 } from "@lime-bundles/core";
@@ -4303,7 +4302,7 @@ var LimeBundleElement = class extends HTMLElement {
         const sanitized = sanitizeCustomCss(css.shop.metafield.value);
         if (sanitized.ok) this.shopCustomCss = sanitized.css;
       }
-      await this.applyABVariants();
+      await this.applyLinkGroupVariants();
       this.renderBundles();
     } catch (err) {
       if (controller.signal.aborted) return;
@@ -4315,33 +4314,47 @@ var LimeBundleElement = class extends HTMLElement {
     }
   }
   /**
-   * Resolve the visitor's A/B bucket for every bundle with an active test
-   * and merge Variant B overrides where applicable. Runs in parallel; any
-   * assignment failure logs internally but still renders Variant A (safe
-   * default). The `getABTestAssignment` helper persists the bucket via a
-   * first-party cookie; variant attribution is recorded server-side from
-   * the analytics events the widget already emits.
+   * Resolve the visitor's assigned variant for every primary bundle in a link
+   * group. Runs in parallel; any assignment failure logs internally and still
+   * renders the primary (safe default). The `getLinkGroupAssignment` helper
+   * persists the bucket via a first-party cookie; variant attribution is
+   * recorded server-side from the cart-line `_lime_bundle_gid` + `_lime_link_group`
+   * attributes the cart-add path stamps when an assignment lands on a non-primary
+   * variant.
+   *
+   * When the assignment points to a non-primary variant the SDK swaps in that
+   * variant's `ParsedBundle` from the primary's `linkGroup.variants` list. The
+   * variant data must already be present in the storefront query response — the
+   * SDK does NOT issue a separate metaobject fetch on the hot path.
    */
-  async applyABVariants() {
+  async applyLinkGroupVariants() {
     if (this.bundles.length === 0) return;
+    const bundleLookupByMetaobjectId = /* @__PURE__ */ new Map();
+    for (const b of this.bundles) {
+      bundleLookupByMetaobjectId.set(b.id, b);
+    }
     const results = await Promise.all(
       this.bundles.map(async (bundle) => {
-        if (!bundle.abTestId || !bundle.abVariantB) return bundle;
+        const lg = bundle.linkGroup;
+        if (!lg || !lg.isPrimary || !lg.variants || lg.variants.length < 2) {
+          return bundle;
+        }
         try {
-          const assignment = await getABTestAssignment(
-            bundle.abTestId,
-            bundle.id
+          const assignment = await getLinkGroupAssignment(lg.id, lg.variants);
+          if (!assignment) return bundle;
+          if (assignment.variantMetaobjectId === bundle.id) return bundle;
+          const swap = bundleLookupByMetaobjectId.get(
+            assignment.variantMetaobjectId
           );
-          if (assignment?.variant === "B") {
-            return applyABVariantB(bundle);
-          }
+          if (!swap) return bundle;
+          return swap;
         } catch (err) {
           console.warn(
-            `[lime-bundle] A/B assignment failed for bundle ${bundle.id}; falling back to Variant A.`,
+            `[lime-bundle] link-group assignment failed for bundle ${bundle.id}; falling back to primary.`,
             err
           );
+          return bundle;
         }
-        return bundle;
       })
     );
     this.bundles = results;