@behio/storefront-sdk 1.18.0 → 2.0.0

package/dist/react.mjs

@@ -150,6 +150,7 @@ var BehioStorefront = class {
     this.shopDomain = config.shopDomain;
     this.defaultLocale = config.locale;
     this.defaultCurrency = config.currency;
+    this.setCountry(config.country);
     this.fetchFn = config.fetch || globalThis.fetch.bind(globalThis);
     this.timeout = config.timeout ?? 3e4;
     this.retries = config.retries ?? 1;
@@ -311,6 +312,14 @@ var BehioStorefront = class {
   getCurrency() {
     return this.defaultCurrency;
   }
+  /** Set the catalog's delivery country. Use cart.setDestination separately for the cart. */
+  setCountry(country) {
+    const normalized = country?.trim().toUpperCase();
+    this.defaultCountry = normalized && /^[A-Z]{2}$/.test(normalized) ? normalized : void 0;
+  }
+  getCountry() {
+    return this.defaultCountry;
+  }
   /** Set the default locale sent on every catalog request (per-call wins). */
   setLocale(locale) {
     this.defaultLocale = locale || void 0;
@@ -466,12 +475,16 @@ var BehioStorefront = class {
     if (this.defaultCurrency && !params.has("currency")) {
       params.set("currency", this.defaultCurrency);
     }
+    if (this.defaultCountry && path.startsWith("/catalog/") && !params.has("country")) {
+      params.set("country", this.defaultCountry);
+    }
     const qs = params.toString();
     const url = `${this.baseUrl}/storefront/v1${path}${qs ? `?${qs}` : ""}`;
     const headers = {
       "X-Api-Key": this.apiKey,
       "Content-Type": "application/json"
     };
+    if (path === "/cart" || path.startsWith("/cart/")) headers["X-Behio-Cart-Contract"] = "2";
     if (this.shopDomain) {
       headers["X-Shop-Domain"] = this.shopDomain;
     }
@@ -598,42 +611,46 @@ var BehioStorefront = class {
     throw new BehioNetworkError("Request failed after retries");
   }
 };
+function catalogProductsQuery(query) {
+  const q = {};
+  if (query) {
+    if (query.page !== void 0) q.page = query.page;
+    if (query.limit !== void 0) q.limit = query.limit;
+    if (query.category) q.category = query.category;
+    if (query.label) q.label = query.label;
+    if (query.priceMin !== void 0) q.priceMin = query.priceMin;
+    if (query.priceMax !== void 0) q.priceMax = query.priceMax;
+    if (query.currency) q.currency = query.currency;
+    if (query.country) q.country = query.country;
+    if (query.locale) q.locale = query.locale;
+    if (query.sort) q.sort = query.sort;
+    if (query.inStock !== void 0) q.inStock = query.inStock;
+    if (query.ratingMin !== void 0) q.ratingMin = query.ratingMin;
+    if (query.search) q.search = query.search;
+    if (query.parameters) q.parameters = JSON.stringify(query.parameters);
+    if (query.facets) q.facets = JSON.stringify(query.facets);
+    if (query.ids && query.ids.length > 0) q.ids = query.ids;
+    if (query.slugs && query.slugs.length > 0) q.slugs = query.slugs;
+    if (query.labels && query.labels.length > 0) q.labels = query.labels;
+    if (query.categories && query.categories.length > 0)
+      q.categories = query.categories;
+    if (query.excludeIds && query.excludeIds.length > 0)
+      q.excludeIds = query.excludeIds;
+    if (query.excludeCategories && query.excludeCategories.length > 0)
+      q.excludeCategories = query.excludeCategories;
+    if (query.hasDiscount !== void 0) q.hasDiscount = query.hasDiscount;
+    if (query.isFeatured !== void 0) q.isFeatured = query.isFeatured;
+    if (query.createdAfter !== void 0) q.createdAfter = query.createdAfter;
+  }
+  return q;
+}
 var CatalogModule = class {
   constructor(client) {
     this.client = client;
   }
   /** List products with filtering, pagination, search */
   async getProducts(query) {
-    const q = {};
-    if (query) {
-      if (query.page) q.page = query.page;
-      if (query.limit) q.limit = query.limit;
-      if (query.category) q.category = query.category;
-      if (query.label) q.label = query.label;
-      if (query.priceMin) q.priceMin = query.priceMin;
-      if (query.priceMax) q.priceMax = query.priceMax;
-      if (query.currency) q.currency = query.currency;
-      if (query.country) q.country = query.country;
-      if (query.locale) q.locale = query.locale;
-      if (query.sort) q.sort = query.sort;
-      if (query.inStock !== void 0) q.inStock = query.inStock;
-      if (query.ratingMin !== void 0) q.ratingMin = query.ratingMin;
-      if (query.search) q.search = query.search;
-      if (query.parameters) q.parameters = JSON.stringify(query.parameters);
-      if (query.facets) q.facets = JSON.stringify(query.facets);
-      if (query.ids && query.ids.length > 0) q.ids = query.ids;
-      if (query.slugs && query.slugs.length > 0) q.slugs = query.slugs;
-      if (query.labels && query.labels.length > 0) q.labels = query.labels;
-      if (query.categories && query.categories.length > 0)
-        q.categories = query.categories;
-      if (query.excludeIds && query.excludeIds.length > 0)
-        q.excludeIds = query.excludeIds;
-      if (query.excludeCategories && query.excludeCategories.length > 0)
-        q.excludeCategories = query.excludeCategories;
-      if (query.hasDiscount !== void 0) q.hasDiscount = query.hasDiscount;
-      if (query.isFeatured !== void 0) q.isFeatured = query.isFeatured;
-      if (query.createdAfter !== void 0) q.createdAfter = query.createdAfter;
-    }
+    const q = catalogProductsQuery(query);
     return this.client.request(
       "GET",
       "/catalog/products",
@@ -675,14 +692,7 @@ var CatalogModule = class {
   }
   /** Get products in a category */
   async getCategoryProducts(slug, query) {
-    const q = {};
-    if (query) {
-      if (query.page) q.page = query.page;
-      if (query.limit) q.limit = query.limit;
-      if (query.sort) q.sort = query.sort;
-      if (query.locale) q.locale = query.locale;
-      if (query.currency) q.currency = query.currency;
-    }
+    const q = catalogProductsQuery(query);
     return this.client.request(
       "GET",
       `/catalog/categories/${slug}/products`,
@@ -716,7 +726,7 @@ var CatalogModule = class {
       "GET",
       "/catalog/featured",
       {
-        query: { locale: options?.locale, currency: options?.currency }
+        query: { locale: options?.locale, currency: options?.currency, country: options?.country }
       }
     );
   }
@@ -774,9 +784,10 @@ var CatalogModule = class {
     if (query) {
       if (query.category) q.category = query.category;
       if (query.label) q.label = query.label;
-      if (query.priceMin) q.priceMin = query.priceMin;
-      if (query.priceMax) q.priceMax = query.priceMax;
+      if (query.priceMin !== void 0) q.priceMin = query.priceMin;
+      if (query.priceMax !== void 0) q.priceMax = query.priceMax;
       if (query.currency) q.currency = query.currency;
+      if (query.country) q.country = query.country;
       if (query.locale) q.locale = query.locale;
       if (query.inStock !== void 0) q.inStock = query.inStock;
       if (query.ratingMin !== void 0) q.ratingMin = query.ratingMin;
@@ -798,12 +809,12 @@ var CatalogModule = class {
     return this.getProducts({ search: query, ...options });
   }
   /** List all active bundles */
-  async getBundles() {
-    return this.client.request("GET", "/catalog/bundles");
+  async getBundles(options) {
+    return this.client.request("GET", "/catalog/bundles", { query: { ...options } });
   }
   /** Get a single bundle by slug */
-  async getBundle(slug) {
-    return this.client.request("GET", `/catalog/bundles/${slug}`);
+  async getBundle(slug, options) {
+    return this.client.request("GET", `/catalog/bundles/${encodeURIComponent(slug)}`, { query: { ...options } });
   }
   /**
    * One product group ("collection") by slug with its products as standard
@@ -816,7 +827,7 @@ var CatalogModule = class {
       "GET",
       `/catalog/product-groups/${encodeURIComponent(slug)}`,
       {
-        query: { locale: options?.locale, currency: options?.currency }
+        query: { locale: options?.locale, currency: options?.currency, country: options?.country }
       }
     );
   }
@@ -831,7 +842,7 @@ var CatalogModule = class {
     return this.client.request(
       "GET",
       `/catalog/products/${encodeURIComponent(productSlug)}/cross-sell`,
-      { query: { locale: options?.locale, currency: options?.currency } }
+      { query: { locale: options?.locale, currency: options?.currency, country: options?.country } }
     );
   }
   /** Active promotions applicable to a product (with countdown end time) */
@@ -1039,6 +1050,7 @@ var CartModule = class {
       body: { currency }
     });
     if (res.error) return res;
+    if (res.data.sessionToken) this.client.setCartSession(res.data.sessionToken);
     this.client.emit("cart:updated", res.data);
     return res;
   }
@@ -1059,6 +1071,7 @@ var CartModule = class {
       body: input
     });
     if (res.error) return res;
+    if (res.data.sessionToken) this.client.setCartSession(res.data.sessionToken);
     this.client.emit("cart:updated", res.data);
     return res;
   }
@@ -1143,14 +1156,15 @@ var CartModule = class {
       body
     });
     if (res.error) return res;
+    if (res.data.sessionToken) this.client.setCartSession(res.data.sessionToken);
     this.client.emit("cart:updated", res.data);
     return res;
   }
-  /** Update quantity of a bundle already in the cart */
-  async updateBundleQuantity(bundleId, quantity) {
+  /** Update by CartBundleLine.id; legacy catalog bundle IDs are accepted by the API */
+  async updateBundleQuantity(lineId, quantity) {
     const res = await this.client.request(
       "PATCH",
-      `/cart/bundles/${bundleId}`,
+      `/cart/bundles/${lineId}`,
       {
         body: { quantity }
       }
@@ -1159,11 +1173,11 @@ var CartModule = class {
     this.client.emit("cart:updated", res.data);
     return res;
   }
-  /** Remove a bundle from the cart */
-  async removeBundle(bundleId) {
+  /** Remove by CartBundleLine.id; scoped to the current visitor cart */
+  async removeBundle(lineId) {
     const res = await this.client.request(
       "DELETE",
-      `/cart/bundles/${bundleId}`
+      `/cart/bundles/${lineId}`
     );
     if (res.error) return res;
     this.client.emit("cart:updated", res.data);
@@ -1197,6 +1211,12 @@ var CheckoutModule = class {
   constructor(client) {
     this.client = client;
   }
+  /** Recalculate the current cart including shipping, fees, benefits and rounding.
+   * No order, stock claim, payment or gift-card redemption is created. Required
+   * legal consents are enforced only on createOrder, not while quoting. */
+  async preview(input) {
+    return this.client.request("POST", "/checkout/preview", { body: input });
+  }
   /** Create order from cart */
   async createOrder(input) {
     const res = await this.client.request("POST", "/checkout", {
@@ -2091,6 +2111,7 @@ function BehioProvider({
     });
   }
   const client = clientRef.current;
+  const [sessionRestored, setSessionRestored] = useState(false);
   useEffect(() => {
     const accessToken = storageAdapter.get(STORAGE_KEYS.ACCESS_TOKEN);
     const refreshToken = storageAdapter.get(STORAGE_KEYS.REFRESH_TOKEN);
@@ -2101,6 +2122,7 @@ function BehioProvider({
     if (cartSession) {
       client.setCartSession(cartSession);
     }
+    setSessionRestored(true);
   }, [client, storageAdapter]);
   useEffect(() => {
     if (!persistCurrency) return;
@@ -2155,12 +2177,13 @@ function BehioProvider({
     () => ({
       client,
       storage: storageAdapter,
+      sessionRestored,
       currency: activeCurrency,
       setCurrency,
       configuredDefaultCurrency: defaultCurrency,
       configuredCurrencies: currencies
     }),
-    [client, storageAdapter, activeCurrency, setCurrency, defaultCurrency, currencies]
+    [client, storageAdapter, sessionRestored, activeCurrency, setCurrency, defaultCurrency, currencies]
   );
   return /* @__PURE__ */ jsx(QueryClientProvider, { client: qc, children: /* @__PURE__ */ jsx(BehioContext.Provider, { value: ctxValue, children }) });
 }
@@ -2410,6 +2433,15 @@ function useSearch(query, options) {
 // src/react/hooks/use-cart.ts
 import { useCallback as useCallback3 } from "react";
 import { useQuery as useQuery10, useMutation, useQueryClient } from "@tanstack/react-query";
+
+// src/react/utils/refresh-bundle-queries.ts
+async function refreshBundleQueries(queryClient) {
+  const keys = [["behio", "bundle"], ["behio", "bundles"]];
+  await Promise.all(keys.map((queryKey) => queryClient.cancelQueries({ queryKey })));
+  await Promise.all(keys.map((queryKey) => queryClient.invalidateQueries({ queryKey })));
+}
+
+// src/react/hooks/use-cart.ts
 var CART_KEY = ["behio", "cart"];
 function useCart(options) {
   const { client, storage } = useBehio();
@@ -2433,32 +2465,21 @@ function useCart(options) {
         storage.set(STORAGE_KEYS.CART_SESSION, result.newSessionToken);
       }
       queryClient.setQueryData([...CART_KEY], result);
+      void refreshBundleQueries(queryClient);
     }
   });
+  const cancelCartRead = () => queryClient.cancelQueries({ queryKey: [...CART_KEY] });
+  const acceptCart = async (result) => {
+    await cancelCartRead();
+    queryClient.setQueryData([...CART_KEY], result);
+    void refreshBundleQueries(queryClient);
+  };
   const updateMutation = useMutation({
     mutationFn: async ({ itemId, quantity }) => {
       return unwrap(client.cart.updateQuantity(itemId, quantity));
     },
-    onMutate: async ({ itemId, quantity }) => {
-      await queryClient.cancelQueries({ queryKey: [...CART_KEY] });
-      const previous = queryClient.getQueryData([...CART_KEY]);
-      if (previous) {
-        const updatedItems = previous.items.map(
-          (item) => item.id === itemId ? { ...item, quantity, totalPrice: item.unitPrice * quantity } : item
-        );
-        queryClient.setQueryData([...CART_KEY], {
-          ...previous,
-          items: updatedItems,
-          itemCount: updatedItems.reduce((sum, i) => sum + i.quantity, 0)
-        });
-      }
-      return { previous };
-    },
-    onError: (_err, _vars, context) => {
-      if (context?.previous) {
-        queryClient.setQueryData([...CART_KEY], context.previous);
-      }
-    },
+    onMutate: cancelCartRead,
+    onSuccess: acceptCart,
     onSettled: () => {
       queryClient.invalidateQueries({ queryKey: [...CART_KEY] });
     }
@@ -2467,24 +2488,8 @@ function useCart(options) {
     mutationFn: async (itemId) => {
       return unwrap(client.cart.removeItem(itemId));
     },
-    onMutate: async (itemId) => {
-      await queryClient.cancelQueries({ queryKey: [...CART_KEY] });
-      const previous = queryClient.getQueryData([...CART_KEY]);
-      if (previous) {
-        const updatedItems = previous.items.filter((item) => item.id !== itemId);
-        queryClient.setQueryData([...CART_KEY], {
-          ...previous,
-          items: updatedItems,
-          itemCount: updatedItems.reduce((sum, i) => sum + i.quantity, 0)
-        });
-      }
-      return { previous };
-    },
-    onError: (_err, _vars, context) => {
-      if (context?.previous) {
-        queryClient.setQueryData([...CART_KEY], context.previous);
-      }
-    },
+    onMutate: cancelCartRead,
+    onSuccess: acceptCart,
     onSettled: () => {
       queryClient.invalidateQueries({ queryKey: [...CART_KEY] });
     }
@@ -2495,6 +2500,7 @@ function useCart(options) {
       queryClient.setQueryData([...CART_KEY], null);
       client.clearCartSession();
       storage.remove(STORAGE_KEYS.CART_SESSION);
+      void refreshBundleQueries(queryClient);
     }
   });
   const applyDiscountMutation = useMutation({
@@ -2515,6 +2521,7 @@ function useCart(options) {
       queryClient.setQueryData([...CART_KEY], result);
       client.clearCartSession();
       storage.remove(STORAGE_KEYS.CART_SESSION);
+      void refreshBundleQueries(queryClient);
     }
   });
   const addItem = useCallback3(
@@ -2559,7 +2566,7 @@ function useCart(options) {
     merge,
     // Computed
     itemCount: cart?.itemCount ?? 0,
-    isEmpty: !cart || cart.items.length === 0,
+    isEmpty: !cart || cart.items.length === 0 && (cart.bundleLines?.length ?? 0) === 0,
     // Mutation states
     isAdding: addMutation.isPending,
     isUpdating: updateMutation.isPending,
@@ -2615,6 +2622,7 @@ function useAuth() {
     queryClient.setQueryData([...CUSTOMER_KEY], null);
     queryClient.invalidateQueries({ queryKey: ["behio", "orders"] });
     queryClient.invalidateQueries({ queryKey: ["behio", "addresses"] });
+    void refreshBundleQueries(queryClient);
   }, [client, storage, queryClient]);
   const postAuth = useCallback4(async () => {
     await queryClient.invalidateQueries({ queryKey: [...CUSTOMER_KEY] });
@@ -2627,6 +2635,7 @@ function useAuth() {
       }
     }
     queryClient.invalidateQueries({ queryKey: [...CART_KEY3] });
+    void refreshBundleQueries(queryClient);
   }, [client, storage, queryClient]);
   const loginMutation = useMutation2({
     mutationFn: async ({ email, password }) => {
@@ -3590,6 +3599,11 @@ function useCheckout() {
     reset
   };
 }
+function useCheckoutPreview() {
+  const { client } = useBehio();
+  const mutation = useMutation14({ mutationFn: (input) => unwrap(client.checkout.preview(input)) });
+  return { preview: mutation.mutateAsync, data: mutation.data, isPreviewing: mutation.isPending, error: mutation.error, reset: mutation.reset };
+}
 
 // src/react/hooks/use-pages.ts
 import { useQuery as useQuery29 } from "@tanstack/react-query";
@@ -3754,7 +3768,8 @@ function useShopScripts(options) {
   return useQuery33({
     queryKey: ["behio", "shop-scripts"],
     queryFn: () => unwrap(client.getShopScripts()),
-    enabled: options?.enabled !== false
+    enabled: options?.enabled !== false,
+    initialData: options?.initialData
   });
 }
 
@@ -3823,7 +3838,7 @@ function CurrencySwitcher({
 }
 
 // src/react/components/storefront-scripts.tsx
-import { useEffect as useEffect6, useMemo as useMemo5, useState as useState10 } from "react";
+import { useEffect as useEffect6, useMemo as useMemo5, useRef as useRef4, useState as useState10 } from "react";
 
 // src/react/hooks/use-consent.ts
 import { useQuery as useQuery35, useMutation as useMutation16, useQueryClient as useQueryClient16 } from "@tanstack/react-query";
@@ -3888,31 +3903,32 @@ function partsFor(s) {
       return [{ target: "head", html: `<meta name="google-site-verification" content="${id}" />` }];
     case "RAW":
     default:
-      return [{ target: s.placement === "HEAD" ? "head" : "body", html: s.value }];
+      return [{ target: s.placement === "HEAD" ? "head" : "body", start: s.placement === "BODY_START", html: s.value }];
   }
 }
-function injectHtml(target, html) {
+function injectHtml(target, html, start = false) {
   const tpl = document.createElement("template");
   tpl.innerHTML = html;
   const added = [];
+  const anchor = start ? target.firstChild : null;
   Array.from(tpl.content.childNodes).forEach((node) => {
     if (node.nodeName === "SCRIPT") {
       const old = node;
       const script = document.createElement("script");
       for (const attr of Array.from(old.attributes)) script.setAttribute(attr.name, attr.value);
       script.text = old.text;
-      target.appendChild(script);
+      target.insertBefore(script, anchor);
       added.push(script);
     } else if (node.nodeType === Node.ELEMENT_NODE) {
       const clone = node.cloneNode(true);
-      target.appendChild(clone);
+      target.insertBefore(clone, anchor);
       added.push(clone);
     }
   });
   return added;
 }
-function StorefrontScripts({ visitorId: visitorIdProp } = {}) {
-  const { data } = useShopScripts();
+function StorefrontScripts({ visitorId: visitorIdProp, initialScripts } = {}) {
+  const { data } = useShopScripts({ enabled: initialScripts === void 0, initialData: initialScripts ? { scripts: initialScripts } : void 0 });
   const [visitorId, setVisitorId] = useState10(visitorIdProp ?? "");
   useEffect6(() => {
     if (visitorIdProp) return;
@@ -3924,21 +3940,30 @@ function StorefrontScripts({ visitorId: visitorIdProp } = {}) {
   }, [visitorIdProp]);
   const { data: consent } = useCookieConsent(visitorId || void 0);
   const analyticsOk = Boolean(consent?.analytics);
+  const marketingOk = Boolean(consent?.marketing);
   const scripts = useMemo5(
-    () => (data?.scripts ?? []).filter((s) => !s.consentRequired || analyticsOk),
-    [data, analyticsOk]
+    () => (initialScripts ?? data?.scripts ?? []).filter((s) => !s.consentRequired || (s.type === "META_PIXEL" ? marketingOk : analyticsOk)),
+    [initialScripts, data, analyticsOk, marketingOk]
   );
   const signature = useMemo5(
     () => JSON.stringify(scripts.map((s) => [s.id, s.type, s.placement, s.value])),
     [scripts]
   );
+  const activeConsented = useRef4(/* @__PURE__ */ new Set());
   useEffect6(() => {
     if (typeof document === "undefined") return;
+    const nextConsented = new Set(scripts.filter((s) => s.consentRequired).map((s) => s.id));
+    const revoked = [...activeConsented.current].some((id) => !nextConsented.has(id));
+    activeConsented.current = nextConsented;
+    if (revoked) {
+      window.location.reload();
+      return;
+    }
     const added = [];
     for (const s of scripts) {
       for (const part of partsFor(s)) {
         const target = part.target === "head" ? document.head : document.body;
-        added.push(...injectHtml(target, part.html));
+        added.push(...injectHtml(target, part.html, part.start));
       }
     }
     return () => {
@@ -4200,20 +4225,22 @@ function utmFromSearch(search) {
 // src/react/hooks/use-bundles.ts
 import { useQuery as useQuery36 } from "@tanstack/react-query";
 function useBundles(options) {
-  const { client } = useBehio();
+  const { client, sessionRestored } = useBehio();
+  const query = { locale: options?.locale ?? client.getLocale(), currency: options?.currency ?? client.getCurrency(), country: options?.country ?? client.getCountry() };
   return useQuery36({
-    queryKey: ["behio", "bundles"],
-    queryFn: () => unwrap(client.catalog.getBundles()),
-    enabled: options?.enabled ?? true,
+    queryKey: ["behio", "bundles", query],
+    queryFn: () => unwrap(client.catalog.getBundles(query)),
+    enabled: sessionRestored && (options?.enabled ?? true),
     initialData: options?.initialData
   });
 }
 function useBundle(slug, options) {
-  const { client } = useBehio();
+  const { client, sessionRestored } = useBehio();
+  const query = { locale: options?.locale ?? client.getLocale(), currency: options?.currency ?? client.getCurrency(), country: options?.country ?? client.getCountry() };
   return useQuery36({
-    queryKey: ["behio", "bundle", slug],
-    queryFn: () => unwrap(client.catalog.getBundle(slug)),
-    enabled: Boolean(slug) && (options?.enabled ?? true),
+    queryKey: ["behio", "bundle", slug, query],
+    queryFn: () => unwrap(client.catalog.getBundle(slug, query)),
+    enabled: sessionRestored && Boolean(slug) && (options?.enabled ?? true),
     initialData: options?.initialData
   });
 }
@@ -4316,8 +4343,10 @@ import { useQuery as useQuery42, useMutation as useMutation18, useQueryClient as
 function useProductReviews(productId, options) {
   const { client } = useBehio();
   return useQuery42({
-    queryKey: ["behio", "reviews", productId, options?.page ?? 1],
+    queryKey: ["behio", "reviews", productId, options?.page ?? 1, options?.limit ?? 20],
     queryFn: () => unwrap(client.reviews.getProductReviews(productId, options?.page, options?.limit)),
+    initialData: options?.initialData,
+    staleTime: 3e4,
     enabled: Boolean(productId) && (options?.enabled ?? true)
   });
 }
@@ -4380,15 +4409,23 @@ function useNotifyWhenAvailable() {
 }
 
 // src/react/utils/format-price.ts
-function formatPrice(amount, currency, locale) {
+function formatPrice(amount, currency, locale, display) {
   const resolvedLocale = locale ?? "cs";
   try {
-    return new Intl.NumberFormat(resolvedLocale, {
+    const formatter = new Intl.NumberFormat(resolvedLocale, {
       style: "currency",
       currency,
+      currencyDisplay: display === "CODE" ? "code" : "symbol",
       minimumFractionDigits: Number.isInteger(amount) ? 0 : 2,
       maximumFractionDigits: 2
-    }).format(amount);
+    });
+    if (display === "SYMBOL_BEFORE" || display === "SYMBOL_AFTER") {
+      const parts = formatter.formatToParts(amount);
+      const symbol = parts.find((p) => p.type === "currency")?.value ?? currency;
+      const value = parts.filter((p) => p.type !== "currency").map((p) => p.value).join("").trim();
+      return display === "SYMBOL_BEFORE" ? `${symbol}\xA0${value}` : `${value}\xA0${symbol}`;
+    }
+    return formatter.format(amount);
   } catch {
     return `${amount} ${currency}`;
   }
@@ -4521,6 +4558,7 @@ export {
   useCategory,
   useCertificateVerification,
   useCheckout,
+  useCheckoutPreview,
   useCookieConsent,
   useCourse,
   useCourseCertificates,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@behio/storefront-sdk",
-  "version": "1.18.0",
+  "version": "2.0.0",
   "description": "TypeScript SDK for Behio headless e-commerce: core client + React hooks",
   "author": "Behio",
   "license": "MIT",