@lime-bundles/react 4.0.0 → 5.0.0

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { CartLineInput, ProductVariant, ParsedBundle, WidgetConfig } from '@lime-bundles/core';
-export { ABVariantOverrides, BUNDLES_FOR_PRODUCT_QUERY, BUNDLE_METAOBJECT_QUERY, BundleParseError, BundleType, CartLineInput, CountdownConfig, CtaConfig, DiscountConfig, FixedBundleData, FixedBundlePricing, HeaderConfig, ImageTransform, LayoutConfig, MixMatchBundleData, ParsedBundle, PopularBadgeConfig, PricingConfig, PricingRow, Product, ProductListConfig, ProductVariant, SHOP_CUSTOM_CSS_QUERY, SavingsBarConfig, StorefrontApiError, ThumbnailRatio, VolumeBundleData, VolumeTier, WIDGET_CONFIG_DEFAULTS, WidgetConfig, applyABVariantB, applyWidgetConfigVars, calculateDiscount, calculateTierSavings, computeBundleSaleCents, computeFixedPricing, createStorefrontClient, fetchBundlesForProduct, formatCents, formatCountdown, formatMoney, formatUnitPrice, getABTestAssignment, getActiveTier, hasConsent, injectCustomCss, mergeWidgetConfig, observeImpression, parseCents, parseMetaobjectBundle, parseMetaobjectBundleStrict, percentageDiscountUnit, reportAddToCart, reportImpression, sanitizeCustomCss, setConsent, thumbnailRatioVars, transformImageUrl, validateQuantity } from '@lime-bundles/core';
+import { CartLineInput, BuyerResolver, ProductVariant, ParsedBundle, WidgetConfig } from '@lime-bundles/core';
+export { ABVariantOverrides, BUNDLES_FOR_PRODUCT_QUERY, BUNDLE_METAOBJECT_QUERY, BundleParseError, BundleType, CartLineInput, CountdownConfig, CtaConfig, DiscountConfig, FixedBundleData, FixedBundlePricing, HeaderConfig, ImageTransform, LayoutConfig, MixMatchBundleData, ParsedBundle, PopularBadgeConfig, PricingConfig, PricingRow, Product, ProductListConfig, ProductVariant, SHOP_CUSTOM_CSS_QUERY, SavingsBarConfig, StorefrontApiError, ThumbnailRatio, VolumeBundleData, VolumeTier, WIDGET_CONFIG_DEFAULTS, WidgetConfig, applyWidgetConfigVars, calculateDiscount, calculateTierSavings, computeBundleSaleCents, computeFixedPricing, createStorefrontClient, fetchBundlesForProduct, fnv1a, formatCents, formatCountdown, formatMoney, formatUnitPrice, getActiveTier, getLinkGroupAssignment, hasConsent, injectCustomCss, mergeWidgetConfig, observeImpression, parseCents, parseMetaobjectBundle, parseMetaobjectBundleStrict, percentageDiscountUnit, pickVariantFromWeights, reportAddToCart, reportImpression, sanitizeCustomCss, setConsent, thumbnailRatioVars, transformImageUrl, validateQuantity } from '@lime-bundles/core';
 
 /**
  * Shared props for bundle components.
@@ -32,6 +32,25 @@ interface BundleComponentProps {
     analyticsEnabled?: boolean;
     /** Called with the thrown `Error` from fetchBundleData or onAddToCart. */
     onError?: (error: Error) => void;
+    /**
+     * ISO-3166 alpha-2 country code, passed as Storefront `@inContext(country:)`.
+     * Drives Markets pricing and currency. Omit for shop default.
+     */
+    country?: string;
+    /** ISO-639-1 language code, passed as `@inContext(language:)`. */
+    language?: string;
+    /**
+     * B2B buyer identity. Prefer the callback form (`() => Promise<BuyerInput>`)
+     * so the customer access token doesn't live in static prop trees. See
+     * the package README ("Markets & B2B") for the security threat model.
+     */
+    buyer?: BuyerResolver;
+    /**
+     * Current visitor's Shopify Market GID. When set and the bundle's
+     * `marketVisibility === "specific"`, the bundle is hidden if its
+     * `marketIds` doesn't include this market.
+     */
+    marketId?: string;
 }
 
 declare function FixedBundle(props: BundleComponentProps): react_jsx_runtime.JSX.Element | null;
@@ -116,6 +135,26 @@ interface FetchBundleDataOptions {
     signal?: AbortSignal;
     /** Override the Storefront API version pinned in `createStorefrontClient`. */
     apiVersion?: string;
+    /**
+     * ISO-3166 alpha-2 country code passed as `@inContext(country: ...)`.
+     * Drives Shopify Markets pricing, currency, and availability.
+     */
+    country?: string;
+    /** ISO-639-1 language code passed as `@inContext(language: ...)`. */
+    language?: string;
+    /**
+     * B2B buyer identity. Prefer the callback form for security — it lets
+     * you fetch the customer access token just-in-time so it doesn't sit
+     * in static prop trees. See packages/*\/README.md → "Markets & B2B".
+     */
+    buyer?: BuyerResolver;
+    /**
+     * Shopify Market GID for the current visitor. When set and the bundle's
+     * `marketVisibility === "specific"`, the bundle is filtered out if its
+     * `marketIds` doesn't include this market. Returned to the caller via
+     * `BundleVisibilityWarning[]` for surfacing.
+     */
+    marketId?: string;
 }
 declare function fetchBundleData(options: FetchBundleDataOptions): Promise<ParsedBundle>;
 
@@ -131,6 +170,14 @@ interface UseBundleDataOptions {
     shopDomain: string;
     storefrontAccessToken: string;
     bundleGid: string;
+    /** ISO-3166 alpha-2 country, passed as Storefront `@inContext(country:)`. */
+    country?: string;
+    /** ISO-639-1 language, passed as `@inContext(language:)`. */
+    language?: string;
+    /** B2B buyer identity. Prefer the callback form to keep tokens off prop trees. */
+    buyer?: BuyerResolver;
+    /** Current visitor's Market GID — filters market-restricted bundles client-side. */
+    marketId?: string;
 }
 type UseBundleDataResult = {
     status: "loading";
@@ -175,8 +222,13 @@ interface UseAnalyticsOptions {
     bundleGid: string;
     bundleType: string;
     enabled?: boolean;
-    abTestId?: string;
-    abVariant?: string;
+    /**
+     * Link-group UUID when the rendered bundle is part of an A/B test. Replaces
+     * the prior abTestId/abVariant pair — each variant is its own bundle row
+     * under the duplicate-bundle model so `bundleGid` already identifies the
+     * variant; `linkGroupId` is the convenience join key for analytics.
+     */
+    linkGroupId?: string;
 }
 declare function useAnalytics(options: UseAnalyticsOptions): {
     elementRef: (el: HTMLElement | null) => void;

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { CartLineInput, ProductVariant, ParsedBundle, WidgetConfig } from '@lime-bundles/core';
-export { ABVariantOverrides, BUNDLES_FOR_PRODUCT_QUERY, BUNDLE_METAOBJECT_QUERY, BundleParseError, BundleType, CartLineInput, CountdownConfig, CtaConfig, DiscountConfig, FixedBundleData, FixedBundlePricing, HeaderConfig, ImageTransform, LayoutConfig, MixMatchBundleData, ParsedBundle, PopularBadgeConfig, PricingConfig, PricingRow, Product, ProductListConfig, ProductVariant, SHOP_CUSTOM_CSS_QUERY, SavingsBarConfig, StorefrontApiError, ThumbnailRatio, VolumeBundleData, VolumeTier, WIDGET_CONFIG_DEFAULTS, WidgetConfig, applyABVariantB, applyWidgetConfigVars, calculateDiscount, calculateTierSavings, computeBundleSaleCents, computeFixedPricing, createStorefrontClient, fetchBundlesForProduct, formatCents, formatCountdown, formatMoney, formatUnitPrice, getABTestAssignment, getActiveTier, hasConsent, injectCustomCss, mergeWidgetConfig, observeImpression, parseCents, parseMetaobjectBundle, parseMetaobjectBundleStrict, percentageDiscountUnit, reportAddToCart, reportImpression, sanitizeCustomCss, setConsent, thumbnailRatioVars, transformImageUrl, validateQuantity } from '@lime-bundles/core';
+import { CartLineInput, BuyerResolver, ProductVariant, ParsedBundle, WidgetConfig } from '@lime-bundles/core';
+export { ABVariantOverrides, BUNDLES_FOR_PRODUCT_QUERY, BUNDLE_METAOBJECT_QUERY, BundleParseError, BundleType, CartLineInput, CountdownConfig, CtaConfig, DiscountConfig, FixedBundleData, FixedBundlePricing, HeaderConfig, ImageTransform, LayoutConfig, MixMatchBundleData, ParsedBundle, PopularBadgeConfig, PricingConfig, PricingRow, Product, ProductListConfig, ProductVariant, SHOP_CUSTOM_CSS_QUERY, SavingsBarConfig, StorefrontApiError, ThumbnailRatio, VolumeBundleData, VolumeTier, WIDGET_CONFIG_DEFAULTS, WidgetConfig, applyWidgetConfigVars, calculateDiscount, calculateTierSavings, computeBundleSaleCents, computeFixedPricing, createStorefrontClient, fetchBundlesForProduct, fnv1a, formatCents, formatCountdown, formatMoney, formatUnitPrice, getActiveTier, getLinkGroupAssignment, hasConsent, injectCustomCss, mergeWidgetConfig, observeImpression, parseCents, parseMetaobjectBundle, parseMetaobjectBundleStrict, percentageDiscountUnit, pickVariantFromWeights, reportAddToCart, reportImpression, sanitizeCustomCss, setConsent, thumbnailRatioVars, transformImageUrl, validateQuantity } from '@lime-bundles/core';
 
 /**
  * Shared props for bundle components.
@@ -32,6 +32,25 @@ interface BundleComponentProps {
     analyticsEnabled?: boolean;
     /** Called with the thrown `Error` from fetchBundleData or onAddToCart. */
     onError?: (error: Error) => void;
+    /**
+     * ISO-3166 alpha-2 country code, passed as Storefront `@inContext(country:)`.
+     * Drives Markets pricing and currency. Omit for shop default.
+     */
+    country?: string;
+    /** ISO-639-1 language code, passed as `@inContext(language:)`. */
+    language?: string;
+    /**
+     * B2B buyer identity. Prefer the callback form (`() => Promise<BuyerInput>`)
+     * so the customer access token doesn't live in static prop trees. See
+     * the package README ("Markets & B2B") for the security threat model.
+     */
+    buyer?: BuyerResolver;
+    /**
+     * Current visitor's Shopify Market GID. When set and the bundle's
+     * `marketVisibility === "specific"`, the bundle is hidden if its
+     * `marketIds` doesn't include this market.
+     */
+    marketId?: string;
 }
 
 declare function FixedBundle(props: BundleComponentProps): react_jsx_runtime.JSX.Element | null;
@@ -116,6 +135,26 @@ interface FetchBundleDataOptions {
     signal?: AbortSignal;
     /** Override the Storefront API version pinned in `createStorefrontClient`. */
     apiVersion?: string;
+    /**
+     * ISO-3166 alpha-2 country code passed as `@inContext(country: ...)`.
+     * Drives Shopify Markets pricing, currency, and availability.
+     */
+    country?: string;
+    /** ISO-639-1 language code passed as `@inContext(language: ...)`. */
+    language?: string;
+    /**
+     * B2B buyer identity. Prefer the callback form for security — it lets
+     * you fetch the customer access token just-in-time so it doesn't sit
+     * in static prop trees. See packages/*\/README.md → "Markets & B2B".
+     */
+    buyer?: BuyerResolver;
+    /**
+     * Shopify Market GID for the current visitor. When set and the bundle's
+     * `marketVisibility === "specific"`, the bundle is filtered out if its
+     * `marketIds` doesn't include this market. Returned to the caller via
+     * `BundleVisibilityWarning[]` for surfacing.
+     */
+    marketId?: string;
 }
 declare function fetchBundleData(options: FetchBundleDataOptions): Promise<ParsedBundle>;
 
@@ -131,6 +170,14 @@ interface UseBundleDataOptions {
     shopDomain: string;
     storefrontAccessToken: string;
     bundleGid: string;
+    /** ISO-3166 alpha-2 country, passed as Storefront `@inContext(country:)`. */
+    country?: string;
+    /** ISO-639-1 language, passed as `@inContext(language:)`. */
+    language?: string;
+    /** B2B buyer identity. Prefer the callback form to keep tokens off prop trees. */
+    buyer?: BuyerResolver;
+    /** Current visitor's Market GID — filters market-restricted bundles client-side. */
+    marketId?: string;
 }
 type UseBundleDataResult = {
     status: "loading";
@@ -175,8 +222,13 @@ interface UseAnalyticsOptions {
     bundleGid: string;
     bundleType: string;
     enabled?: boolean;
-    abTestId?: string;
-    abVariant?: string;
+    /**
+     * Link-group UUID when the rendered bundle is part of an A/B test. Replaces
+     * the prior abTestId/abVariant pair — each variant is its own bundle row
+     * under the duplicate-bundle model so `bundleGid` already identifies the
+     * variant; `linkGroupId` is the convenience join key for analytics.
+     */
+    linkGroupId?: string;
 }
 declare function useAnalytics(options: UseAnalyticsOptions): {
     elementRef: (el: HTMLElement | null) => void;

package/dist/index.js

@@ -11,24 +11,43 @@ import {
 
 // src/hooks/useBundleData.ts
 import { useState, useEffect } from "react";
-import { injectCustomCss } from "@lime-bundles/core";
+import {
+  injectCustomCss
+} from "@lime-bundles/core";
 
 // src/fetchBundleData.ts
 import {
   createStorefrontClient,
+  hasInContext,
   BUNDLE_METAOBJECT_QUERY,
+  withInContext,
   parseMetaobjectBundleStrict,
   BundleParseError
 } from "@lime-bundles/core";
 async function fetchBundleData(options) {
-  const client = createStorefrontClient({
+  const result = await fetchBundleDataWithWarnings(options);
+  if (!result.bundle) {
+    throw new BundleParseError(
+      `Bundle hidden by market gate: ${options.bundleGid}`,
+      "not_found"
+    );
+  }
+  return result.bundle;
+}
+async function fetchBundleDataWithWarnings(options) {
+  const config = {
     shopDomain: options.shopDomain,
     accessToken: options.storefrontAccessToken,
     buyerIp: options.buyerIp,
-    apiVersion: options.apiVersion
-  });
+    apiVersion: options.apiVersion,
+    country: options.country,
+    language: options.language,
+    buyer: options.buyer
+  };
+  const client = createStorefrontClient(config);
+  const query = hasInContext(config) ? withInContext(BUNDLE_METAOBJECT_QUERY) : BUNDLE_METAOBJECT_QUERY;
   const data = await client.query(
-    BUNDLE_METAOBJECT_QUERY,
+    query,
     { id: options.bundleGid },
     { signal: options.signal }
   );
@@ -38,10 +57,24 @@ async function fetchBundleData(options) {
       "not_found"
     );
   }
-  return parseMetaobjectBundleStrict(
+  const bundle = parseMetaobjectBundleStrict(
     data.metaobject.id,
     data.metaobject.fields
   );
+  if (bundle.marketVisibility === "specific" && (!options.marketId || !bundle.marketIds.includes(options.marketId))) {
+    return {
+      bundle: null,
+      warnings: [
+        {
+          bundleGid: options.bundleGid,
+          reason: "market_mismatch",
+          currentMarketId: options.marketId ?? null,
+          allowedMarketIds: bundle.marketIds
+        }
+      ]
+    };
+  }
+  return { bundle, warnings: [] };
 }
 
 // src/fetchShopCustomCss.ts
@@ -90,7 +123,11 @@ function useBundleData(options) {
       shopDomain: options.shopDomain,
       storefrontAccessToken: options.storefrontAccessToken,
       bundleGid: options.bundleGid,
-      signal: controller.signal
+      signal: controller.signal,
+      country: options.country,
+      language: options.language,
+      buyer: options.buyer,
+      marketId: options.marketId
     }).then((bundle) => {
       if (controller.signal.aborted) return;
       setState({ status: "success", bundle, error: null });
@@ -117,7 +154,11 @@ function useBundleData(options) {
   }, [
     options.shopDomain,
     options.storefrontAccessToken,
-    options.bundleGid
+    options.bundleGid,
+    options.country,
+    options.language,
+    options.buyer,
+    options.marketId
   ]);
   return state;
 }
@@ -141,7 +182,7 @@ function useAnalytics(options) {
   );
   useEffect2(() => {
     impressionFiredRef.current = false;
-  }, [options.bundleGid, options.abVariant]);
+  }, [options.bundleGid]);
   useEffect2(() => {
     if (options.enabled === false) return;
     if (impressionFiredRef.current) return;
@@ -152,8 +193,7 @@ function useAnalytics(options) {
       reportImpression(config, {
         bundleGid: options.bundleGid,
         bundleType: options.bundleType,
-        abTestId: options.abTestId,
-        abVariant: options.abVariant
+        linkGroupId: options.linkGroupId
       });
     });
     return cleanup;
@@ -163,8 +203,7 @@ function useAnalytics(options) {
     options.enabled,
     options.bundleGid,
     options.bundleType,
-    options.abTestId,
-    options.abVariant
+    options.linkGroupId
   ]);
   const trackAddToCart = useCallback(
     (event) => {
@@ -175,8 +214,7 @@ function useAnalytics(options) {
         productId: event.productId,
         quantity: event.quantity,
         totalPrice: event.totalPrice,
-        abTestId: options.abTestId,
-        abVariant: options.abVariant
+        linkGroupId: options.linkGroupId
       });
     },
     [
@@ -184,8 +222,7 @@ function useAnalytics(options) {
       options.enabled,
       options.bundleGid,
       options.bundleType,
-      options.abTestId,
-      options.abVariant
+      options.linkGroupId
     ]
   );
   return { elementRef, trackAddToCart };
@@ -1479,7 +1516,6 @@ import {
   mergeWidgetConfig,
   applyWidgetConfigVars as applyWidgetConfigVars2,
   thumbnailRatioVars,
-  applyABVariantB,
   parseCents,
   formatCents,
   percentageDiscountUnit,
@@ -1496,7 +1532,9 @@ import {
   reportImpression as reportImpression2,
   reportAddToCart as reportAddToCart2,
   observeImpression as observeImpression2,
-  getABTestAssignment,
+  getLinkGroupAssignment,
+  pickVariantFromWeights,
+  fnv1a,
   setConsent,
   hasConsent,
   injectCustomCss as injectCustomCss3,
@@ -1520,7 +1558,6 @@ export {
   VariantDropdown,
   VolumeBundle,
   WIDGET_CONFIG_DEFAULTS,
-  applyABVariantB,
   applyWidgetConfigVars2 as applyWidgetConfigVars,
   calculateDiscount2 as calculateDiscount,
   calculateTierSavings2 as calculateTierSavings,
@@ -1530,12 +1567,13 @@ export {
   fetchBundleData,
   fetchBundlesForProduct2 as fetchBundlesForProduct,
   fetchShopCustomCss,
+  fnv1a,
   formatCents,
   formatCountdown,
   formatMoney4 as formatMoney,
   formatUnitPrice4 as formatUnitPrice,
-  getABTestAssignment,
   getActiveTier2 as getActiveTier,
+  getLinkGroupAssignment,
   hasConsent,
   injectCustomCss3 as injectCustomCss,
   mergeWidgetConfig,
@@ -1544,6 +1582,7 @@ export {
   parseMetaobjectBundle,
   parseMetaobjectBundleStrict2 as parseMetaobjectBundleStrict,
   percentageDiscountUnit,
+  pickVariantFromWeights,
   reportAddToCart2 as reportAddToCart,
   reportImpression2 as reportImpression,
   sanitizeCustomCss,