@behio/storefront-sdk 1.8.0 → 1.17.0

package/dist/react.mjs

@@ -5,6 +5,38 @@ import { useRef, useEffect, useMemo, useState, useCallback } from "react";
 import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
 
 // src/types.ts
+var BE_CODE_TO_ERROR = {
+  "be.storefront.cartIsEmpty": "CART_EMPTY",
+  "be.storefront.productNotFound": "PRODUCT_NOT_FOUND",
+  "be.storefront.productNotAvailable": "PRODUCT_NOT_FOUND",
+  "be.storefront.invalidEmailOrPassword": "INVALID_CREDENTIALS",
+  "be.storefront.currentPasswordIncorrect": "INVALID_CREDENTIALS",
+  "be.storefront.discountExpired": "DISCOUNT_EXPIRED",
+  "be.storefront.discountExpiredOrLimit": "DISCOUNT_EXPIRED",
+  "be.storefront.invalidDiscountCode": "INVALID_DISCOUNT",
+  "be.storefront.discountInvalid": "INVALID_DISCOUNT",
+  "be.storefront.discountInactive": "INVALID_DISCOUNT",
+  "be.storefront.discountWrongCurrency": "INVALID_DISCOUNT",
+  "be.storefront.discountNotApplicable": "INVALID_DISCOUNT",
+  "be.storefront.discountNotYetValid": "INVALID_DISCOUNT",
+  "be.storefront.discountUsageLimitReached": "INVALID_DISCOUNT",
+  "be.storefront.discountLimitedToGroups": "INVALID_DISCOUNT",
+  "be.storefront.tokenInvalid": "TOKEN_INVALID",
+  "be.storefront.orderAccessTokenInvalid": "TOKEN_INVALID",
+  "be.storefront.resetTokenInvalid": "TOKEN_INVALID",
+  "be.storefront.invalidVerificationToken": "TOKEN_INVALID",
+  "be.storefront.invalidRefreshToken": "TOKEN_INVALID",
+  "be.storefront.refreshTokenExpired": "TOKEN_EXPIRED",
+  "be.storefront.apiKeyExpired": "TOKEN_EXPIRED",
+  "be.storefront.customerEmailTaken": "EMAIL_ALREADY_EXISTS",
+  "be.storefront.orderNotCancellable": "ORDER_NOT_CANCELLABLE",
+  "be.storefront.orderCancelledNotReturnable": "ORDER_NOT_CANCELLABLE",
+  "be.validation.failed": "VALIDATION_ERROR",
+  "be.forms.formNotFound": "NOT_FOUND",
+  "be.forms.validationFailed": "VALIDATION_ERROR",
+  "be.forms.consentRequired": "VALIDATION_ERROR",
+  "be.forms.tooLarge": "VALIDATION_ERROR"
+};
 var BehioApiError = class _BehioApiError extends Error {
   constructor(status, body, message) {
     super(message || `API Error ${status}`);
@@ -21,6 +53,11 @@ var BehioApiError = class _BehioApiError extends Error {
     if (status === 409) return "EMAIL_ALREADY_EXISTS";
     if (status === 429) return "RATE_LIMITED";
     if (status >= 500) return "INTERNAL_ERROR";
+    const rawCode = body?.code;
+    if (typeof rawCode === "string") {
+      const mapped = BE_CODE_TO_ERROR[rawCode];
+      if (mapped) return mapped;
+    }
     const msg = (body?.message || "").toLowerCase();
     if (msg.includes("invalid") && msg.includes("password"))
       return "INVALID_CREDENTIALS";
@@ -126,6 +163,8 @@ var BehioStorefront = class {
     this.orders = new OrdersModule(this);
     this.customer = new CustomerModule(this);
     this.pages = new PagesModule(this);
+    this.blog = new BlogModule(this);
+    this.forms = new FormsModule(this);
     this.wishlist = new WishlistModule(this);
     this.reviews = new ReviewsModule(this);
     this.returns = new ReturnsModule(this);
@@ -194,6 +233,21 @@ var BehioStorefront = class {
       body: input
     });
   }
+  /**
+   * Visitor messages from merchant automations (storefront.event action).
+   * Consent-gated visitor id; each message carries a merchant-defined `name`
+   * and free-form `payload` the template reacts to (modal, banner, ...).
+   * Messages stay listed until acknowledged via `ackVisitorMessage`.
+   */
+  async getVisitorMessages(visitorId) {
+    return this.request("GET", "/messages", { query: { visitorId } });
+  }
+  /** Acknowledge a visitor message so it is not delivered again. */
+  async ackVisitorMessage(messageId, visitorId) {
+    return this.request("POST", `/messages/${messageId}/ack`, {
+      query: { visitorId }
+    });
+  }
   /** Get basic shop info */
   async getShopInfo() {
     return this.request("GET", "/shop");
@@ -813,16 +867,27 @@ var CatalogModule = class {
       { body: input }
     );
   }
-  /** List configured payment methods (filtered by currency). */
+  /**
+   * List configured payment methods (filtered by currency). `locale` picks the
+   * language of `instruments[].label` / `swifts[].label` (SDK 1.14.0); pass the
+   * locale of the page so the instrument tiles read in the shopper's language.
+   */
   async listPaymentMethods(opts) {
     const query = {};
     if (opts?.currency) query.currency = opts.currency;
+    if (opts?.locale) query.locale = opts.locale;
+    if (opts?.country) query.country = opts.country;
+    if (opts?.shippingMethodId) query.shippingMethodId = opts.shippingMethodId;
     return this.client.request(
       "GET",
       "/catalog/payment-methods",
       { query }
     );
   }
+  /** Alias of `listPaymentMethods` (SDK 1.14.0). */
+  paymentMethods(opts) {
+    return this.listPaymentMethods(opts);
+  }
 };
 var AuthModule = class {
   constructor(client) {
@@ -976,6 +1041,26 @@ var CartModule = class {
     this.client.emit("cart:updated", res.data);
     return res;
   }
+  /**
+   * Tell the cart where the order will ship (and, for B2B, the buyer's VAT
+   * ID) so the VAT breakdown matches the checkout before the address form:
+   * destination-country rate (OSS), 0 % export outside the EU, or reverse
+   * charge for an EU business with a VIES-valid VAT ID. `cart.vatMode` says
+   * which rule applied. SDK 1.17.0.
+   *
+   * ```ts
+   * await client.cart.setDestination({ country: "SK" });
+   * await client.cart.setDestination({ vatId: "SK2020000001" }); // "" clears
+   * ```
+   */
+  async setDestination(input) {
+    const res = await this.client.request("PUT", "/cart/destination", {
+      body: input
+    });
+    if (res.error) return res;
+    this.client.emit("cart:updated", res.data);
+    return res;
+  }
   /** Update item quantity */
   async updateQuantity(itemId, quantity) {
     const res = await this.client.request(
@@ -1127,6 +1212,30 @@ var OrdersModule = class {
   constructor(client) {
     this.client = client;
   }
+  /**
+   * Ask the backend to re-check this order's payment with the gateway.
+   *
+   * Call it on the thank-you page the customer lands on after paying, BEFORE
+   * you read the order. Some gateways (Tatrapay+) have no server-to-server
+   * notification at all, so the customer's return is the only fast way the
+   * payment gets confirmed; for the others it is a safety net for a lost
+   * notification.
+   *
+   * The response is deliberately opaque (`{ok: true}` every time, even for an
+   * order number that does not exist): order numbers are sequential, so
+   * anything else would turn this into a probe for other people's orders.
+   * Read the actual state afterwards through a path that proves entitlement
+   * ({@link get}, {@link track} or the guest access-code flow).
+   *
+   * Never throws for a missing order and never blocks the page: treat a
+   * failure as "not confirmed yet", the backend poller catches up on its own.
+   */
+  async syncPaymentOnReturn(orderNumber) {
+    return this.client.request(
+      "POST",
+      `/payments/return/${orderNumber}`
+    );
+  }
   /** List customer orders (requires auth) */
   async list(options) {
     return this.client.request(
@@ -1479,6 +1588,59 @@ var PagesModule = class {
     });
   }
 };
+var BlogModule = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /** List the site's blogs (active only). */
+  async list(locale) {
+    return this.client.request("GET", "/blogs", {
+      query: { locale }
+    });
+  }
+  /** Published posts of one blog, newest first (featured first), paginated. */
+  async posts(handle, query = {}) {
+    return this.client.request("GET", `/blogs/${handle}/posts`, {
+      query: {
+        locale: query.locale,
+        page: query.page,
+        limit: query.limit,
+        tag: query.tag
+      }
+    });
+  }
+  /** One published post with sanitised HTML content and related posts. */
+  async post(handle, slug, locale) {
+    return this.client.request("GET", `/blogs/${handle}/posts/${slug}`, {
+      query: { locale }
+    });
+  }
+};
+var FormsModule = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /** Public definition of one form (fields + settings). 404 for an unknown or inactive slug. */
+  async get(slug) {
+    return this.client.request(
+      "GET",
+      `/forms/${encodeURIComponent(slug)}`
+    );
+  }
+  /**
+   * Submit a response. On `be.forms.validationFailed` the returned error
+   * carries per-field codes: read them with `formFieldErrors(error)`. Other
+   * rejections: `be.forms.consentRequired`, `be.forms.tooLarge`,
+   * `be.forms.formNotFound`; rate limit 10 submits per minute per visitor.
+   */
+  async submit(slug, input) {
+    return this.client.request(
+      "POST",
+      `/forms/${encodeURIComponent(slug)}/submit`,
+      { body: input, auth: false }
+    );
+  }
+};
 var WishlistModule = class {
   constructor(client) {
     this.client = client;
@@ -3066,9 +3228,10 @@ import { useQuery as useQuery25 } from "@tanstack/react-query";
 function usePaymentMethods(options) {
   const { client, currency: activeCurrency } = useBehio();
   const currency = options?.currency ?? activeCurrency;
+  const locale = options?.locale;
   const { data, isLoading, error, refetch } = useQuery25({
-    queryKey: ["behio", "payment-methods", currency ?? ""],
-    queryFn: () => unwrap(client.catalog.listPaymentMethods({ currency })),
+    queryKey: ["behio", "payment-methods", currency ?? "", locale ?? ""],
+    queryFn: () => unwrap(client.catalog.listPaymentMethods({ currency, ...locale ? { locale } : {} })),
     enabled: options?.enabled !== false
   });
   return { methods: data?.items ?? [], isLoading, error, refetch };
@@ -3133,11 +3296,78 @@ function usePersonalOffers(options) {
   };
 }
 
+// src/react/hooks/use-visitor-messages.ts
+import { useCallback as useCallback9, useEffect as useEffect5, useRef as useRef3, useState as useState6 } from "react";
+import { useQuery as useQuery27, useQueryClient as useQueryClient13 } from "@tanstack/react-query";
+function useVisitorMessages(options) {
+  const { client } = useBehio();
+  const queryClient = useQueryClient13();
+  const [polledVid, setPolledVid] = useState6(null);
+  const seenRef = useRef3(/* @__PURE__ */ new Set());
+  const explicitVid = options?.visitorId;
+  useEffect5(() => {
+    if (explicitVid) return;
+    const read = () => {
+      const vid = client.getAnalyticsVisitorId();
+      if (vid) setPolledVid(vid);
+      return vid;
+    };
+    if (read()) return;
+    const timer = setInterval(() => {
+      if (read()) clearInterval(timer);
+    }, 3e3);
+    return () => clearInterval(timer);
+  }, [client, explicitVid]);
+  const visitorId = explicitVid ?? polledVid;
+  const pollMs = options?.pollMs ?? 3e4;
+  const queryKey = ["behio", "visitor-messages", visitorId ?? ""];
+  const { data, isLoading, error, refetch } = useQuery27({
+    queryKey,
+    queryFn: () => unwrap(client.getVisitorMessages(visitorId)),
+    enabled: options?.enabled !== false && !!visitorId,
+    refetchInterval: pollMs > 0 ? pollMs : false
+  });
+  const ack = useCallback9(
+    async (messageId) => {
+      if (!visitorId) return false;
+      const result = await unwrap(client.ackVisitorMessage(messageId, visitorId));
+      queryClient.setQueryData(
+        queryKey,
+        (prev) => prev ? { items: prev.items.filter((m) => m.id !== messageId) } : prev
+      );
+      return result.ok;
+    },
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [client, visitorId, queryClient]
+  );
+  const onMessage = options?.onMessage;
+  const dispatchDom = options?.dispatchDomEvents !== false;
+  useEffect5(() => {
+    for (const message of data?.items ?? []) {
+      if (seenRef.current.has(message.id)) continue;
+      seenRef.current.add(message.id);
+      if (dispatchDom && typeof window !== "undefined") {
+        window.dispatchEvent(new CustomEvent("behio:visitor-message", { detail: message }));
+      }
+      onMessage?.(message);
+    }
+  }, [data, onMessage, dispatchDom]);
+  return {
+    messages: data?.items ?? [],
+    isLoading,
+    error,
+    refetch,
+    /** Mark a message as shown; it will not be delivered again. */
+    ack,
+    visitorId
+  };
+}
+
 // src/react/hooks/use-analytics-events.ts
-import { useCallback as useCallback9 } from "react";
+import { useCallback as useCallback10 } from "react";
 function useAnalyticsEvents() {
   const { client } = useBehio();
-  const track = useCallback9(
+  const track = useCallback10(
     (events, opts) => {
       const list = Array.isArray(events) ? events : [events];
       if (list.length === 0) return Promise.resolve();
@@ -3149,7 +3379,7 @@ function useAnalyticsEvents() {
     },
     [client]
   );
-  const trackEvent = useCallback9(
+  const trackEvent = useCallback10(
     (name, props) => track({ type: "custom", name, props }),
     [track]
   );
@@ -3179,12 +3409,12 @@ function useNewsletterUnsubscribe() {
 }
 
 // src/react/hooks/use-orders.ts
-import { useCallback as useCallback10, useMemo as useMemo3, useState as useState6 } from "react";
+import { useCallback as useCallback11, useMemo as useMemo3, useState as useState7 } from "react";
 import { useInfiniteQuery as useInfiniteQuery2 } from "@tanstack/react-query";
 function useOrders(options) {
   const { client } = useBehio();
   const { page: initialPage, limit, enabled } = options ?? {};
-  const [page, setPage] = useState6(initialPage ?? 1);
+  const [page, setPage] = useState7(initialPage ?? 1);
   const infinite = useInfiniteQuery2({
     queryKey: ["behio", "orders", limit, page],
     queryFn: ({ pageParam }) => unwrap(client.orders.list({ limit, page: pageParam })),
@@ -3198,13 +3428,13 @@ function useOrders(options) {
     [infinite.data]
   );
   const lastPage = infinite.data?.pages[infinite.data.pages.length - 1];
-  const loadMore = useCallback10(() => {
+  const loadMore = useCallback11(() => {
     if (infinite.hasNextPage && !infinite.isFetchingNextPage) {
       return infinite.fetchNextPage();
     }
     return Promise.resolve();
   }, [infinite]);
-  const goToPage = useCallback10((newPage) => {
+  const goToPage = useCallback11((newPage) => {
     setPage(newPage);
   }, []);
   return {
@@ -3230,16 +3460,16 @@ function useOrders(options) {
 }
 
 // src/react/hooks/use-order.ts
-import { useCallback as useCallback11 } from "react";
-import { useQuery as useQuery27, useMutation as useMutation12, useQueryClient as useQueryClient13 } from "@tanstack/react-query";
+import { useCallback as useCallback12 } from "react";
+import { useQuery as useQuery28, useMutation as useMutation12, useQueryClient as useQueryClient14 } from "@tanstack/react-query";
 function useOrder(orderNumber, options) {
   const { client } = useBehio();
-  const queryClient = useQueryClient13();
+  const queryClient = useQueryClient14();
   const {
     data,
     isLoading,
     error
-  } = useQuery27({
+  } = useQuery28({
     queryKey: ["behio", "order", orderNumber],
     queryFn: () => unwrap(client.orders.get(orderNumber)),
     enabled: options?.enabled !== false && !!orderNumber && !!client.getAccessToken()
@@ -3251,7 +3481,7 @@ function useOrder(orderNumber, options) {
       queryClient.invalidateQueries({ queryKey: ["behio", "orders"] });
     }
   });
-  const cancel = useCallback11(
+  const cancel = useCallback12(
     () => cancelMutation.mutateAsync(),
     [cancelMutation]
   );
@@ -3265,14 +3495,14 @@ function useOrder(orderNumber, options) {
 }
 
 // src/react/hooks/use-order-access.ts
-import { useCallback as useCallback12, useState as useState7 } from "react";
+import { useCallback as useCallback13, useState as useState8 } from "react";
 import { useMutation as useMutation13 } from "@tanstack/react-query";
 function useOrderAccess() {
   const { client } = useBehio();
-  const [orderNumber, setOrderNumber] = useState7(null);
-  const [email, setEmail] = useState7(null);
-  const [order, setOrder] = useState7(null);
-  const [accessToken, setAccessToken] = useState7(null);
+  const [orderNumber, setOrderNumber] = useState8(null);
+  const [email, setEmail] = useState8(null);
+  const [order, setOrder] = useState8(null);
+  const [accessToken, setAccessToken] = useState8(null);
   const requestMutation = useMutation13({
     mutationFn: (input) => unwrap(client.orders.requestAccessCode(input.orderNumber, input.email)),
     onSuccess: (_data, input) => {
@@ -3292,12 +3522,12 @@ function useOrderAccess() {
       setAccessToken(result.accessToken);
     }
   });
-  const requestCode = useCallback12(
+  const requestCode = useCallback13(
     (on, em) => requestMutation.mutateAsync({ orderNumber: on, email: em }),
     [requestMutation]
   );
-  const verifyCode = useCallback12((code) => verifyMutation.mutateAsync(code), [verifyMutation]);
-  const reset = useCallback12(() => {
+  const verifyCode = useCallback13((code) => verifyMutation.mutateAsync(code), [verifyMutation]);
+  const reset = useCallback13(() => {
     setOrderNumber(null);
     setEmail(null);
     setOrder(null);
@@ -3325,12 +3555,12 @@ function useOrderAccess() {
 }
 
 // src/react/hooks/use-checkout.ts
-import { useState as useState8, useCallback as useCallback13 } from "react";
-import { useMutation as useMutation14, useQueryClient as useQueryClient14 } from "@tanstack/react-query";
+import { useState as useState9, useCallback as useCallback14 } from "react";
+import { useMutation as useMutation14, useQueryClient as useQueryClient15 } from "@tanstack/react-query";
 function useCheckout() {
   const { client, storage } = useBehio();
-  const queryClient = useQueryClient14();
-  const [order, setOrder] = useState8(null);
+  const queryClient = useQueryClient15();
+  const [order, setOrder] = useState9(null);
   const mutation = useMutation14({
     mutationFn: (input) => unwrap(client.checkout.createOrder(input)),
     onSuccess: (result) => {
@@ -3340,11 +3570,11 @@ function useCheckout() {
       queryClient.invalidateQueries({ queryKey: ["behio", "orders"] });
     }
   });
-  const createOrder = useCallback13(
+  const createOrder = useCallback14(
     (input) => mutation.mutateAsync(input),
     [mutation]
   );
-  const reset = useCallback13(() => {
+  const reset = useCallback14(() => {
     setOrder(null);
     mutation.reset();
   }, [mutation]);
@@ -3358,10 +3588,10 @@ function useCheckout() {
 }
 
 // src/react/hooks/use-pages.ts
-import { useQuery as useQuery28 } from "@tanstack/react-query";
+import { useQuery as useQuery29 } from "@tanstack/react-query";
 function usePages(locale, options) {
   const { client } = useBehio();
-  return useQuery28({
+  return useQuery29({
     queryKey: ["behio", "pages", locale],
     queryFn: async () => {
       const result = await unwrap(client.pages.list(locale));
@@ -3372,18 +3602,141 @@ function usePages(locale, options) {
 }
 function usePage(slug, locale, options) {
   const { client } = useBehio();
-  return useQuery28({
+  return useQuery29({
     queryKey: ["behio", "page", slug, locale],
     queryFn: () => unwrap(client.pages.get(slug, locale)),
     enabled: options?.enabled !== false && !!slug
   });
 }
 
+// src/react/hooks/use-blog.ts
+import { useQuery as useQuery30 } from "@tanstack/react-query";
+function useBlogs(locale, options) {
+  const { client } = useBehio();
+  return useQuery30({
+    queryKey: ["behio", "blogs", locale],
+    queryFn: async () => {
+      const result = await unwrap(client.blog.list(locale));
+      return result.blogs;
+    },
+    enabled: options?.enabled !== false
+  });
+}
+function useBlogPosts(handle, query, options) {
+  const { client } = useBehio();
+  return useQuery30({
+    queryKey: ["behio", "blog", handle, "posts", query?.locale, query?.page, query?.limit, query?.tag],
+    queryFn: () => unwrap(client.blog.posts(handle, query)),
+    enabled: options?.enabled !== false && !!handle
+  });
+}
+function useBlogPost(handle, slug, locale, options) {
+  const { client } = useBehio();
+  return useQuery30({
+    queryKey: ["behio", "blog", handle, "post", slug, locale],
+    queryFn: () => unwrap(client.blog.post(handle, slug, locale)),
+    enabled: options?.enabled !== false && !!handle && !!slug
+  });
+}
+
+// src/react/hooks/use-site-form.ts
+import { useCallback as useCallback15, useMemo as useMemo4 } from "react";
+import { useMutation as useMutation15, useQuery as useQuery31 } from "@tanstack/react-query";
+
+// src/errors.ts
+function bodyOf(err) {
+  const body = err instanceof BehioApiError ? err.body : err && typeof err === "object" && "body" in err ? err.body : err;
+  return body && typeof body === "object" ? body : null;
+}
+function errorCode(err) {
+  const body = bodyOf(err);
+  if (!body) return null;
+  const code = body.code ?? body.key;
+  return typeof code === "string" && code.startsWith("be.") ? code : null;
+}
+function errorParams(err) {
+  const body = bodyOf(err);
+  const params = body?.params;
+  return params && typeof params === "object" && !Array.isArray(params) ? params : {};
+}
+var FORM_FIELD_ERROR_CODES = /* @__PURE__ */ new Set([
+  "required",
+  "invalid",
+  "tooShort",
+  "tooLong",
+  "min",
+  "max",
+  "notOption",
+  "pattern"
+]);
+function formFieldErrors(err) {
+  if (errorCode(err) !== "be.forms.validationFailed") return [];
+  const raw = errorParams(err).errors;
+  if (!Array.isArray(raw)) return [];
+  const out = [];
+  for (const entry of raw) {
+    if (typeof entry !== "string") continue;
+    const idx = entry.lastIndexOf(":");
+    if (idx <= 0) continue;
+    const key = entry.slice(0, idx);
+    const code = entry.slice(idx + 1);
+    if (!FORM_FIELD_ERROR_CODES.has(code)) continue;
+    out.push({ key, code });
+  }
+  return out;
+}
+
+// src/react/hooks/use-site-form.ts
+function useSiteForm(slug, options) {
+  const { client } = useBehio();
+  return useQuery31({
+    queryKey: ["behio", "form", slug],
+    queryFn: () => unwrap(client.forms.get(slug)),
+    enabled: options?.enabled !== false && !!slug
+  });
+}
+function useSiteFormSubmit(slug) {
+  const { client } = useBehio();
+  const mutation = useMutation15({
+    mutationFn: (input) => unwrap(client.forms.submit(slug, input))
+  });
+  const sdkError = mutation.error instanceof UnwrappedError ? mutation.error.sdkError : null;
+  const fieldErrors = useMemo4(() => {
+    const out = {};
+    for (const e of formFieldErrors(sdkError)) out[e.key] = e.code;
+    return out;
+  }, [sdkError]);
+  const errorCode2 = useMemo4(() => {
+    const body = sdkError?.body;
+    const code = body?.code ?? body?.key;
+    return typeof code === "string" ? code : sdkError ? sdkError.code : null;
+  }, [sdkError]);
+  const submit = useCallback15(
+    (input) => mutation.mutateAsync(input).catch(() => null),
+    [mutation]
+  );
+  return {
+    /** Resolves to the result, or null when the submit was rejected (see `fieldErrors` / `errorCode`). */
+    submit,
+    isSubmitting: mutation.isPending,
+    isSuccess: mutation.isSuccess,
+    /** `{ok, id, message, redirectUrl}` after a successful submit. */
+    result: mutation.data ?? null,
+    /** Field key -> validation code after a rejected submit. */
+    fieldErrors,
+    /** Backend error key (`be.forms.*`) or SDK code when the rejection is not per field. */
+    errorCode: errorCode2,
+    /** Raw SDK error (pass to `errorMessage(error, locale)` for a sentence). */
+    error: sdkError,
+    reset: mutation.reset
+  };
+}
+
 // src/react/hooks/use-shop-info.ts
-import { useQuery as useQuery29 } from "@tanstack/react-query";
+import { useQuery as useQuery32 } from "@tanstack/react-query";
 function useShopInfo(options) {
   const { client } = useBehio();
-  return useQuery29({
+  return useQuery32({
     queryKey: ["behio", "shop-info"],
     queryFn: () => unwrap(client.getShopInfo()),
     enabled: options?.enabled !== false
@@ -3391,10 +3744,10 @@ function useShopInfo(options) {
 }
 
 // src/react/hooks/use-shop-scripts.ts
-import { useQuery as useQuery30 } from "@tanstack/react-query";
+import { useQuery as useQuery33 } from "@tanstack/react-query";
 function useShopScripts(options) {
   const { client } = useBehio();
-  return useQuery30({
+  return useQuery33({
     queryKey: ["behio", "shop-scripts"],
     queryFn: () => unwrap(client.getShopScripts()),
     enabled: options?.enabled !== false
@@ -3402,11 +3755,11 @@ function useShopScripts(options) {
 }
 
 // src/react/hooks/use-shop-seo.ts
-import { useQuery as useQuery31 } from "@tanstack/react-query";
+import { useQuery as useQuery34 } from "@tanstack/react-query";
 function useShopSeo(options) {
   const { client } = useBehio();
   const { locale, initialData, enabled = true } = options ?? {};
-  return useQuery31({
+  return useQuery34({
     queryKey: ["behio", "shop-seo", locale ?? "_default"],
     queryFn: () => unwrap(client.getShopSeo(locale)),
     initialData,
@@ -3466,23 +3819,23 @@ function CurrencySwitcher({
 }
 
 // src/react/components/storefront-scripts.tsx
-import { useEffect as useEffect5, useMemo as useMemo4, useState as useState9 } from "react";
+import { useEffect as useEffect6, useMemo as useMemo5, useState as useState10 } from "react";
 
 // src/react/hooks/use-consent.ts
-import { useQuery as useQuery32, useMutation as useMutation15, useQueryClient as useQueryClient15 } from "@tanstack/react-query";
+import { useQuery as useQuery35, useMutation as useMutation16, useQueryClient as useQueryClient16 } from "@tanstack/react-query";
 function useCookieConsent(visitorId) {
   const { client } = useBehio();
-  const qc = useQueryClient15();
-  const query = useQuery32({
+  const qc = useQueryClient16();
+  const query = useQuery35({
     queryKey: ["behio", "consent", visitorId],
     queryFn: () => unwrap(client.consent.get(visitorId)),
     enabled: Boolean(visitorId)
   });
-  const recordMutation = useMutation15({
+  const recordMutation = useMutation16({
     mutationFn: (input) => unwrap(client.consent.record(input)),
     onSuccess: () => qc.invalidateQueries({ queryKey: ["behio", "consent"] })
   });
-  const revokeMutation = useMutation15({
+  const revokeMutation = useMutation16({
     mutationFn: () => unwrap(client.consent.revoke(visitorId)),
     onSuccess: () => qc.invalidateQueries({ queryKey: ["behio", "consent"] })
   });
@@ -3556,8 +3909,8 @@ function injectHtml(target, html) {
 }
 function StorefrontScripts({ visitorId: visitorIdProp } = {}) {
   const { data } = useShopScripts();
-  const [visitorId, setVisitorId] = useState9(visitorIdProp ?? "");
-  useEffect5(() => {
+  const [visitorId, setVisitorId] = useState10(visitorIdProp ?? "");
+  useEffect6(() => {
     if (visitorIdProp) return;
     try {
       const v = localStorage.getItem(VISITOR_KEY);
@@ -3567,15 +3920,15 @@ function StorefrontScripts({ visitorId: visitorIdProp } = {}) {
   }, [visitorIdProp]);
   const { data: consent } = useCookieConsent(visitorId || void 0);
   const analyticsOk = Boolean(consent?.analytics);
-  const scripts = useMemo4(
+  const scripts = useMemo5(
     () => (data?.scripts ?? []).filter((s) => !s.consentRequired || analyticsOk),
     [data, analyticsOk]
   );
-  const signature = useMemo4(
+  const signature = useMemo5(
     () => JSON.stringify(scripts.map((s) => [s.id, s.type, s.placement, s.value])),
     [scripts]
   );
-  useEffect5(() => {
+  useEffect6(() => {
     if (typeof document === "undefined") return;
     const added = [];
     for (const s of scripts) {
@@ -3592,7 +3945,7 @@ function StorefrontScripts({ visitorId: visitorIdProp } = {}) {
 }
 
 // src/react/components/behio-analytics.tsx
-import { useEffect as useEffect6 } from "react";
+import { useEffect as useEffect7 } from "react";
 
 // src/react/hooks/use-behio-client.ts
 function useBehioClient() {
@@ -3602,7 +3955,7 @@ function useBehioClient() {
 // src/react/components/behio-analytics.tsx
 function BehioAnalyticsTracker() {
   const client = useBehioClient();
-  useEffect6(() => {
+  useEffect7(() => {
     if (typeof window === "undefined") return;
     const w = window;
     if (w.__behioAnalytics) return;
@@ -3841,10 +4194,10 @@ function utmFromSearch(search) {
 }
 
 // src/react/hooks/use-bundles.ts
-import { useQuery as useQuery33 } from "@tanstack/react-query";
+import { useQuery as useQuery36 } from "@tanstack/react-query";
 function useBundles(options) {
   const { client } = useBehio();
-  return useQuery33({
+  return useQuery36({
     queryKey: ["behio", "bundles"],
     queryFn: () => unwrap(client.catalog.getBundles()),
     enabled: options?.enabled ?? true,
@@ -3853,7 +4206,7 @@ function useBundles(options) {
 }
 function useBundle(slug, options) {
   const { client } = useBehio();
-  return useQuery33({
+  return useQuery36({
     queryKey: ["behio", "bundle", slug],
     queryFn: () => unwrap(client.catalog.getBundle(slug)),
     enabled: Boolean(slug) && (options?.enabled ?? true),
@@ -3862,10 +4215,10 @@ function useBundle(slug, options) {
 }
 
 // src/react/hooks/use-product-group.ts
-import { useQuery as useQuery34 } from "@tanstack/react-query";
+import { useQuery as useQuery37 } from "@tanstack/react-query";
 function useProductGroup(slug, options) {
   const { client } = useBehio();
-  return useQuery34({
+  return useQuery37({
     queryKey: ["behio", "product-group", slug, options?.locale, options?.currency],
     queryFn: () => unwrap(
       client.catalog.getProductGroup(slug, {
@@ -3879,10 +4232,10 @@ function useProductGroup(slug, options) {
 }
 
 // src/react/hooks/use-cross-sell.ts
-import { useQuery as useQuery35 } from "@tanstack/react-query";
+import { useQuery as useQuery38 } from "@tanstack/react-query";
 function useCrossSell(productSlug, options) {
   const { client } = useBehio();
-  return useQuery35({
+  return useQuery38({
     queryKey: ["behio", "cross-sell", productSlug, options?.locale, options?.currency],
     queryFn: () => unwrap(
       client.catalog.getCrossSell(productSlug, {
@@ -3896,10 +4249,10 @@ function useCrossSell(productSlug, options) {
 }
 
 // src/react/hooks/use-product-promotions.ts
-import { useQuery as useQuery36 } from "@tanstack/react-query";
+import { useQuery as useQuery39 } from "@tanstack/react-query";
 function useProductPromotions(productSlug, options) {
   const { client } = useBehio();
-  return useQuery36({
+  return useQuery39({
     queryKey: ["behio", "product-promotions", productSlug],
     queryFn: () => unwrap(client.catalog.getProductPromotions(productSlug)),
     enabled: Boolean(productSlug) && (options?.enabled ?? true),
@@ -3908,11 +4261,11 @@ function useProductPromotions(productSlug, options) {
 }
 
 // src/react/hooks/use-gift-card.ts
-import { useQuery as useQuery37 } from "@tanstack/react-query";
+import { useQuery as useQuery40 } from "@tanstack/react-query";
 function useGiftCardBalance(code, options) {
   const { client } = useBehio();
   const trimmed = code?.trim();
-  return useQuery37({
+  return useQuery40({
     queryKey: ["behio", "gift-card-balance", trimmed],
     queryFn: () => unwrap(client.catalog.checkGiftCard(trimmed)),
     enabled: Boolean(trimmed && trimmed.length >= 6) && (options?.enabled ?? true)
@@ -3920,20 +4273,20 @@ function useGiftCardBalance(code, options) {
 }
 
 // src/react/hooks/use-wishlist.ts
-import { useQuery as useQuery38, useMutation as useMutation16, useQueryClient as useQueryClient16 } from "@tanstack/react-query";
+import { useQuery as useQuery41, useMutation as useMutation17, useQueryClient as useQueryClient17 } from "@tanstack/react-query";
 function useWishlist(options) {
   const { client } = useBehio();
-  const qc = useQueryClient16();
-  const query = useQuery38({
+  const qc = useQueryClient17();
+  const query = useQuery41({
     queryKey: ["behio", "wishlist"],
     queryFn: () => unwrap(client.wishlist.get()),
     enabled: options?.enabled ?? true
   });
-  const addMutation = useMutation16({
+  const addMutation = useMutation17({
     mutationFn: (productId) => unwrap(client.wishlist.add(productId)),
     onSuccess: () => qc.invalidateQueries({ queryKey: ["behio", "wishlist"] })
   });
-  const removeMutation = useMutation16({
+  const removeMutation = useMutation17({
     mutationFn: (productId) => unwrap(client.wishlist.remove(productId)),
     onSuccess: () => qc.invalidateQueries({ queryKey: ["behio", "wishlist"] })
   });
@@ -3947,7 +4300,7 @@ function useWishlist(options) {
 }
 function useIsInWishlist(productId) {
   const { client } = useBehio();
-  return useQuery38({
+  return useQuery41({
     queryKey: ["behio", "wishlist-check", productId],
     queryFn: () => unwrap(client.wishlist.isInWishlist(productId)),
     enabled: Boolean(productId)
@@ -3955,10 +4308,10 @@ function useIsInWishlist(productId) {
 }
 
 // src/react/hooks/use-reviews.ts
-import { useQuery as useQuery39, useMutation as useMutation17, useQueryClient as useQueryClient17 } from "@tanstack/react-query";
+import { useQuery as useQuery42, useMutation as useMutation18, useQueryClient as useQueryClient18 } from "@tanstack/react-query";
 function useProductReviews(productId, options) {
   const { client } = useBehio();
-  return useQuery39({
+  return useQuery42({
     queryKey: ["behio", "reviews", productId, options?.page ?? 1],
     queryFn: () => unwrap(client.reviews.getProductReviews(productId, options?.page, options?.limit)),
     enabled: Boolean(productId) && (options?.enabled ?? true)
@@ -3966,30 +4319,30 @@ function useProductReviews(productId, options) {
 }
 function useSubmitReview() {
   const { client } = useBehio();
-  const qc = useQueryClient17();
-  return useMutation17({
+  const qc = useQueryClient18();
+  return useMutation18({
     mutationFn: (input) => unwrap(client.reviews.submit(input)),
     onSuccess: (_, input) => qc.invalidateQueries({ queryKey: ["behio", "reviews", input.productId] })
   });
 }
 
 // src/react/hooks/use-returns.ts
-import { useQuery as useQuery40, useMutation as useMutation18 } from "@tanstack/react-query";
+import { useQuery as useQuery43, useMutation as useMutation19 } from "@tanstack/react-query";
 function useLookupReturnableOrder() {
   const { client } = useBehio();
-  return useMutation18({
+  return useMutation19({
     mutationFn: ({ orderNumber, email }) => unwrap(client.returns.lookupOrder(orderNumber, email))
   });
 }
 function useSubmitReturn() {
   const { client } = useBehio();
-  return useMutation18({
+  return useMutation19({
     mutationFn: (input) => unwrap(client.returns.submit(input))
   });
 }
 function useReturnStatus(returnId, email) {
   const { client } = useBehio();
-  return useQuery40({
+  return useQuery43({
     queryKey: ["behio", "return-status", returnId],
     queryFn: () => unwrap(client.returns.getStatus(returnId, email)),
     enabled: Boolean(returnId && email)
@@ -3997,16 +4350,16 @@ function useReturnStatus(returnId, email) {
 }
 
 // src/react/hooks/use-quotes.ts
-import { useMutation as useMutation19, useQuery as useQuery41 } from "@tanstack/react-query";
+import { useMutation as useMutation20, useQuery as useQuery44 } from "@tanstack/react-query";
 function useSubmitQuote() {
   const { client } = useBehio();
-  return useMutation19({
+  return useMutation20({
     mutationFn: (input) => unwrap(client.quotes.submit(input))
   });
 }
 function useQuoteStatus(quoteId, email) {
   const { client } = useBehio();
-  return useQuery41({
+  return useQuery44({
     queryKey: ["behio", "quote-status", quoteId],
     queryFn: () => unwrap(client.quotes.getStatus(quoteId, email)),
     enabled: Boolean(quoteId && email)
@@ -4014,10 +4367,10 @@ function useQuoteStatus(quoteId, email) {
 }
 
 // src/react/hooks/use-back-in-stock.ts
-import { useMutation as useMutation20 } from "@tanstack/react-query";
+import { useMutation as useMutation21 } from "@tanstack/react-query";
 function useNotifyWhenAvailable() {
   const { client } = useBehio();
-  return useMutation20({
+  return useMutation21({
     mutationFn: ({ productId, email }) => unwrap(client.catalog.notifyWhenAvailable(productId, email))
   });
 }
@@ -4153,6 +4506,9 @@ export {
   useAuth,
   useBehio,
   useBehioClient,
+  useBlogPost,
+  useBlogPosts,
+  useBlogs,
   useBundle,
   useBundles,
   useCart,
@@ -4206,9 +4562,12 @@ export {
   useShopInfo,
   useShopScripts,
   useShopSeo,
+  useSiteForm,
+  useSiteFormSubmit,
   useSubmitQuote,
   useSubmitReturn,
   useSubmitReview,
   useSubscriptions,
+  useVisitorMessages,
   useWishlist
 };