@behio/storefront-sdk 0.21.0 → 0.23.0

package/dist/react.d.ts

@@ -1,10 +1,10 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { QueryClient } from '@tanstack/react-query';
-import { a as BehioStorefront, P as ProductsQuery, b as PaginatedResponse, c as ProductListItem, d as ProductDetail, C as Category, e as CategoryDetail, f as ProductLabel, F as FilterField, g as Cart, h as CustomerProfile, R as RegisterInput, i as CustomerAddress, A as AddressSuggestion, j as AddressDetail, O as OrderListItem, k as OrderDetail, l as OrderAccessRequestResponse, m as OrderAccessVerifyResponse, n as CheckoutInput, o as PageDetail, p as Page, S as ShopInfo, q as ShopScripts, r as ShopSeo, s as Bundle, t as CrossSellItem, u as ActivePromotion, G as GiftCardBalance, W as WishlistItem, v as ProductReviewsResponse, w as SubmitReviewInput, x as ReturnableOrder, y as ReturnStatus, z as ReturnRequest, D as SubmitReturnInput, E as CookieConsent, H as CookieConsentInput, Q as QuoteRequest, I as SubmitQuoteInput, J as BackInStockSubscription } from './client-hCuGQERQ.js';
-export { K as AddToCartInput, L as AuthTokens, M as BehioApiError, N as BundleItem, T as CartDiscount, U as CartItem, V as CheckoutAddress, X as FulfillmentStatus, Y as LoginInput, Z as MessageResponse, _ as OrderItem, $ as OrderStatus, a0 as PaymentStatus, a1 as ProductPrice, a2 as ProductReview, a3 as ProductVariant } from './client-hCuGQERQ.js';
+import { a as BehioStorefront, P as ProductsQuery, b as PaginatedResponse, c as ProductListItem, d as ProductDetail, C as Category, e as CategoryDetail, f as ProductLabel, F as FilterField, g as Cart, h as CustomerProfile, R as RegisterInput, i as CustomerAddress, A as AddressSuggestion, j as AddressDetail, O as OrderListItem, k as OrderDetail, l as OrderAccessRequestResponse, m as OrderAccessVerifyResponse, n as CheckoutInput, o as PageDetail, p as Page, S as ShopInfo, q as ShopScripts, r as ShopSeo, s as Bundle, t as CrossSellItem, u as ActivePromotion, G as GiftCardBalance, W as WishlistItem, v as ProductReviewsResponse, w as SubmitReviewInput, x as ReturnableOrder, y as ReturnStatus, z as ReturnRequest, D as SubmitReturnInput, E as CookieConsent, H as CookieConsentInput, Q as QuoteRequest, I as SubmitQuoteInput, J as BackInStockSubscription } from './client-B0VFrsad.js';
+export { K as AddToCartInput, L as AuthTokens, M as BehioApiError, N as BundleItem, T as CartDiscount, U as CartItem, V as CheckoutAddress, X as FulfillmentStatus, Y as LoginInput, Z as MessageResponse, _ as OrderItem, $ as OrderStatus, a0 as PaymentStatus, a1 as ProductPrice, a2 as ProductReview, a3 as ProductVariant } from './client-B0VFrsad.js';
 import * as _tanstack_query_core from '@tanstack/query-core';
-export { formatPrice } from './index.js';
+export { EcommerceEventName, EcommerceItem, EcommercePayload, formatPrice, trackEcommerceEvent } from './index.js';
 
 interface StorageAdapter {
     get(key: string): string | null;
@@ -504,6 +504,27 @@ interface StorefrontScriptsProps {
  */
 declare function StorefrontScripts({ visitorId: visitorIdProp }?: StorefrontScriptsProps): null;
 
+/**
+ * Behio Analytics auto-tracker. Mount ONCE in the root layout (next to
+ * <StorefrontScripts/>).
+ *
+ * Identity is three-tiered:
+ * - anonymous: no consent needed — the server computes a daily-rotating hash,
+ *   the client sends nothing identifying
+ * - consented: once the visitor grants analytics consent (the shop's consent
+ *   banner, keyed by the existing `behio_visitor_id`), events carry that
+ *   persistent first-party id — enabling returning-visitor metrics and the
+ *   customer journey
+ * - customer: the backend links the id to the customer at checkout/login
+ *
+ * Captures: pageviews (load + SPA route changes), visibility-aware dwell time
+ * per page, click events on interactive elements, UTM + referrer on landing.
+ * Events are batched (flush on 20 events / 5 s / route change / pagehide) via
+ * keepalive fetch. Listens for the `behio:consent-changed` window event to
+ * pick up consent grants/revocations immediately.
+ */
+declare function BehioAnalyticsTracker(): null;
+
 /** List all active bundles. */
 declare function useBundles(options?: {
     enabled?: boolean;
@@ -1028,4 +1049,4 @@ declare function useNotifyWhenAvailable(): _tanstack_react_query.UseMutationResu
  */
 declare function useBehioClient(): BehioStorefront;
 
-export { ActivePromotion, BehioProvider, type BehioProviderProps, Bundle, Cart, Category, CategoryDetail, CheckoutInput, CookieConsent, CookieConsentInput, CrossSellItem, CurrencySwitcher, type CurrencySwitcherProps, type CurrencySwitcherRenderProps, CustomerAddress, CustomerProfile, FilterField, GiftCardBalance, OrderDetail, OrderListItem, Page, PageDetail, PaginatedResponse, ProductDetail, ProductLabel, ProductListItem, ProductReviewsResponse, ProductsQuery, QuoteRequest, RegisterInput, ReturnRequest, ShopInfo, ShopSeo, type StorageAdapter, StorefrontScripts, type StorefrontScriptsProps, SubmitQuoteInput, SubmitReturnInput, SubmitReviewInput, type UseAddressAutocompleteOptions, type UseAddressAutocompleteReturn, type UseAddressesOptions, type UseCartCountOptions, type UseCartOptions, type UseCategoriesOptions, type UseCategoryOptions, type UseCurrencyResult, type UseCustomerOptions, type UseFeaturedOptions, type UseFiltersOptions, type UseLabelsOptions, type UseOrderOptions, type UseOrdersOptions, type UsePageOptions, type UsePagesOptions, type UseProductOptions, type UseProductsOptions, type UseSearchOptions, type UseShopInfoOptions, type UseShopScriptsOptions, type UseShopSeoOptions, WishlistItem, cookieStorage, createMemoryStorage, detectStorage, localStorageAdapter, memoryStorage, useAddressAutocomplete, useAddresses, useAuth, useBehio, useBehioClient, useBundle, useBundles, useCart, useCartCount, useCategories, useCategory, useCheckout, useCookieConsent, useCrossSell, useCurrency, useCustomer, useFeatured, useFilters, useGiftCardBalance, useIsInWishlist, useLabels, useLookupReturnableOrder, useNotifyWhenAvailable, useOrder, useOrderAccess, useOrders, usePage, usePages, useProduct, useProductPromotions, useProductReviews, useProducts, useQuoteStatus, useReturnStatus, useSearch, useShopInfo, useShopScripts, useShopSeo, useSubmitQuote, useSubmitReturn, useSubmitReview, useWishlist };
+export { ActivePromotion, BehioAnalyticsTracker, BehioProvider, type BehioProviderProps, Bundle, Cart, Category, CategoryDetail, CheckoutInput, CookieConsent, CookieConsentInput, CrossSellItem, CurrencySwitcher, type CurrencySwitcherProps, type CurrencySwitcherRenderProps, CustomerAddress, CustomerProfile, FilterField, GiftCardBalance, OrderDetail, OrderListItem, Page, PageDetail, PaginatedResponse, ProductDetail, ProductLabel, ProductListItem, ProductReviewsResponse, ProductsQuery, QuoteRequest, RegisterInput, ReturnRequest, ShopInfo, ShopSeo, type StorageAdapter, StorefrontScripts, type StorefrontScriptsProps, SubmitQuoteInput, SubmitReturnInput, SubmitReviewInput, type UseAddressAutocompleteOptions, type UseAddressAutocompleteReturn, type UseAddressesOptions, type UseCartCountOptions, type UseCartOptions, type UseCategoriesOptions, type UseCategoryOptions, type UseCurrencyResult, type UseCustomerOptions, type UseFeaturedOptions, type UseFiltersOptions, type UseLabelsOptions, type UseOrderOptions, type UseOrdersOptions, type UsePageOptions, type UsePagesOptions, type UseProductOptions, type UseProductsOptions, type UseSearchOptions, type UseShopInfoOptions, type UseShopScriptsOptions, type UseShopSeoOptions, WishlistItem, cookieStorage, createMemoryStorage, detectStorage, localStorageAdapter, memoryStorage, useAddressAutocomplete, useAddresses, useAuth, useBehio, useBehioClient, useBundle, useBundles, useCart, useCartCount, useCategories, useCategory, useCheckout, useCookieConsent, useCrossSell, useCurrency, useCustomer, useFeatured, useFilters, useGiftCardBalance, useIsInWishlist, useLabels, useLookupReturnableOrder, useNotifyWhenAvailable, useOrder, useOrderAccess, useOrders, usePage, usePages, useProduct, useProductPromotions, useProductReviews, useProducts, useQuoteStatus, useReturnStatus, useSearch, useShopInfo, useShopScripts, useShopSeo, useSubmitQuote, useSubmitReturn, useSubmitReview, useWishlist };

package/dist/react.js

@@ -1,9 +1,10 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 
-var _chunkXWYDXBLGjs = require('./chunk-XWYDXBLG.js');
 
+var _chunkJIAOZ5YWjs = require('./chunk-JIAOZ5YW.js');
 
-var _chunkBF4YVFHXjs = require('./chunk-BF4YVFHX.js');
+
+var _chunk3RI2QBQOjs = require('./chunk-3RI2QBQO.js');
 
 // src/react/provider.tsx
 var _react = require('react');
@@ -133,7 +134,7 @@ function BehioProvider({
   const [activeCurrency, setActiveCurrency] = _react.useState.call(void 0, resolveInitialCurrency);
   const clientRef = _react.useRef.call(void 0, null);
   if (!clientRef.current) {
-    clientRef.current = new (0, _chunkBF4YVFHXjs.BehioStorefront)({
+    clientRef.current = new (0, _chunk3RI2QBQOjs.BehioStorefront)({
       apiKey,
       baseUrl,
       ...shopDomain ? { shopDomain } : {},
@@ -1273,6 +1274,221 @@ function StorefrontScripts({ visitorId: visitorIdProp } = {}) {
   return null;
 }
 
+// src/react/components/behio-analytics.tsx
+
+
+// src/react/hooks/use-behio-client.ts
+function useBehioClient() {
+  return useBehio().client;
+}
+
+// src/react/components/behio-analytics.tsx
+function BehioAnalyticsTracker() {
+  const client = useBehioClient();
+  _react.useEffect.call(void 0, () => {
+    if (typeof window === "undefined") return;
+    const w = window;
+    if (w.__behioAnalytics) return;
+    w.__behioAnalytics = true;
+    const teardown = initTracker(client);
+    return () => {
+      w.__behioAnalytics = false;
+      teardown();
+    };
+  }, [client]);
+  return null;
+}
+var VISITOR_KEY2 = "behio_visitor_id";
+var FLUSH_MAX_EVENTS = 20;
+var FLUSH_INTERVAL_MS = 5e3;
+function initTracker(client) {
+  const sessionId = getSessionId();
+  let visitorId;
+  let currentPath = window.location.pathname;
+  let visibleSince = document.visibilityState === "visible" ? Date.now() : null;
+  let dwellAccumMs = 0;
+  const refreshIdentity = async () => {
+    try {
+      const stored = _nullishCoalesce(localStorage.getItem(VISITOR_KEY2), () => ( void 0));
+      if (!stored) {
+        visitorId = void 0;
+        client.setAnalyticsVisitorId(null);
+        return;
+      }
+      const { data } = await client.consent.get(stored);
+      const granted = Boolean(_optionalChain([data, 'optionalAccess', _71 => _71.analytics]));
+      visitorId = granted ? stored : void 0;
+      client.setAnalyticsVisitorId(granted ? stored : null);
+    } catch (e7) {
+      visitorId = void 0;
+    }
+  };
+  void refreshIdentity();
+  const onConsentChanged = () => void refreshIdentity();
+  window.addEventListener("behio:consent-changed", onConsentChanged);
+  let queue = [];
+  let flushTimer = null;
+  const flush = () => {
+    if (flushTimer) {
+      clearTimeout(flushTimer);
+      flushTimer = null;
+    }
+    if (queue.length === 0) return;
+    const events = queue;
+    queue = [];
+    void client.sendAnalyticsEvents({ sessionId, ...visitorId ? { visitorId } : {}, events });
+  };
+  const enqueue = (event) => {
+    queue.push(event);
+    if (queue.length >= FLUSH_MAX_EVENTS) {
+      flush();
+      return;
+    }
+    if (!flushTimer) flushTimer = setTimeout(flush, FLUSH_INTERVAL_MS);
+  };
+  const landing = utmFromSearch(window.location.search);
+  enqueue({
+    type: "pageview",
+    path: currentPath,
+    referrer: document.referrer || void 0,
+    ...landing,
+    ts: Date.now()
+  });
+  const settleDwell = () => {
+    if (visibleSince != null) {
+      dwellAccumMs += Date.now() - visibleSince;
+      visibleSince = document.visibilityState === "visible" ? Date.now() : null;
+    }
+  };
+  const takeDwell = () => {
+    settleDwell();
+    const dwell = dwellAccumMs;
+    dwellAccumMs = 0;
+    return dwell;
+  };
+  const onRouteChange = () => {
+    const nextPath = window.location.pathname;
+    if (nextPath === currentPath) return;
+    const dwellMs = takeDwell();
+    if (dwellMs > 0) {
+      enqueue({ type: "custom", name: "dwell", path: currentPath, dwellMs, ts: Date.now() });
+    }
+    currentPath = nextPath;
+    visibleSince = document.visibilityState === "visible" ? Date.now() : null;
+    enqueue({
+      type: "pageview",
+      path: currentPath,
+      ...utmFromSearch(window.location.search),
+      ts: Date.now()
+    });
+    flush();
+  };
+  const onVisibility = () => {
+    if (document.visibilityState === "hidden") {
+      settleDwell();
+      visibleSince = null;
+    } else if (visibleSince == null) {
+      visibleSince = Date.now();
+    }
+  };
+  const onPageHide = () => {
+    const dwellMs = takeDwell();
+    if (dwellMs > 0) {
+      enqueue({ type: "custom", name: "dwell", path: currentPath, dwellMs, ts: Date.now() });
+    }
+    flush();
+  };
+  const onClick = (ev) => {
+    const target = ev.target;
+    const el = _optionalChain([target, 'optionalAccess', _72 => _72.closest, 'optionalCall', _73 => _73("a,button,[role=button],[data-behio-event]")]);
+    if (!el) return;
+    const explicit = _nullishCoalesce(el.getAttribute("data-behio-event"), () => ( void 0));
+    const text = (_nullishCoalesce(el.textContent, () => ( ""))).trim().replace(/\s+/g, " ").slice(0, 80) || void 0;
+    const hrefRaw = _nullishCoalesce(el.getAttribute("href"), () => ( void 0));
+    let href;
+    if (hrefRaw) {
+      try {
+        const u = new URL(hrefRaw, window.location.origin);
+        href = u.origin === window.location.origin ? u.pathname : u.hostname;
+      } catch (e8) {
+        href = void 0;
+      }
+    }
+    enqueue({
+      type: "custom",
+      name: explicit || "click",
+      path: currentPath,
+      ts: Date.now(),
+      props: {
+        tag: el.tagName.toLowerCase(),
+        ...text ? { text } : {},
+        ...href ? { href } : {}
+      }
+    });
+  };
+  const w = window;
+  w.__behioEcommerceSink = (event, payload) => {
+    if (event === "purchase") return;
+    enqueue({
+      type: "ecommerce",
+      name: event,
+      path: currentPath,
+      ts: Date.now(),
+      ...payload.value != null ? { value: payload.value } : {},
+      ...payload.currency ? { currency: payload.currency } : {},
+      ...Array.isArray(payload.items) && payload.items.length > 0 ? { props: { items: payload.items.length } } : {}
+    });
+  };
+  const origPush = history.pushState.bind(history);
+  const origReplace = history.replaceState.bind(history);
+  history.pushState = (...args) => {
+    origPush(...args);
+    onRouteChange();
+  };
+  history.replaceState = (...args) => {
+    origReplace(...args);
+    onRouteChange();
+  };
+  window.addEventListener("popstate", onRouteChange);
+  document.addEventListener("visibilitychange", onVisibility);
+  window.addEventListener("pagehide", onPageHide);
+  document.addEventListener("click", onClick, { capture: true, passive: true });
+  return () => {
+    flush();
+    delete w.__behioEcommerceSink;
+    history.pushState = origPush;
+    history.replaceState = origReplace;
+    window.removeEventListener("popstate", onRouteChange);
+    document.removeEventListener("visibilitychange", onVisibility);
+    window.removeEventListener("pagehide", onPageHide);
+    document.removeEventListener("click", onClick, { capture: true });
+    window.removeEventListener("behio:consent-changed", onConsentChanged);
+  };
+}
+function getSessionId() {
+  try {
+    const existing = sessionStorage.getItem("behio.sid");
+    if (existing) return existing;
+    const sid = `s-${Math.random().toString(36).slice(2, 12)}${Date.now().toString(36)}`;
+    sessionStorage.setItem("behio.sid", sid);
+    return sid;
+  } catch (e9) {
+    return `s-${Math.random().toString(36).slice(2, 12)}`;
+  }
+}
+function utmFromSearch(search) {
+  try {
+    const p = new URLSearchParams(search);
+    return {
+      utmSource: _nullishCoalesce(p.get("utm_source"), () => ( void 0)),
+      utmMedium: _nullishCoalesce(p.get("utm_medium"), () => ( void 0)),
+      utmCampaign: _nullishCoalesce(p.get("utm_campaign"), () => ( void 0))
+    };
+  } catch (e10) {
+    return {};
+  }
+}
+
 // src/react/hooks/use-bundles.ts
 
 function useBundles(options) {
@@ -1280,8 +1496,8 @@ function useBundles(options) {
   return _reactquery.useQuery.call(void 0, {
     queryKey: ["behio", "bundles"],
     queryFn: () => unwrap(client.catalog.getBundles()),
-    enabled: _nullishCoalesce(_optionalChain([options, 'optionalAccess', _71 => _71.enabled]), () => ( true)),
-    initialData: _optionalChain([options, 'optionalAccess', _72 => _72.initialData])
+    enabled: _nullishCoalesce(_optionalChain([options, 'optionalAccess', _74 => _74.enabled]), () => ( true)),
+    initialData: _optionalChain([options, 'optionalAccess', _75 => _75.initialData])
   });
 }
 function useBundle(slug, options) {
@@ -1289,8 +1505,8 @@ function useBundle(slug, options) {
   return _reactquery.useQuery.call(void 0, {
     queryKey: ["behio", "bundle", slug],
     queryFn: () => unwrap(client.catalog.getBundle(slug)),
-    enabled: Boolean(slug) && (_nullishCoalesce(_optionalChain([options, 'optionalAccess', _73 => _73.enabled]), () => ( true))),
-    initialData: _optionalChain([options, 'optionalAccess', _74 => _74.initialData])
+    enabled: Boolean(slug) && (_nullishCoalesce(_optionalChain([options, 'optionalAccess', _76 => _76.enabled]), () => ( true))),
+    initialData: _optionalChain([options, 'optionalAccess', _77 => _77.initialData])
   });
 }
 
@@ -1301,8 +1517,8 @@ function useCrossSell(productSlug, options) {
   return _reactquery.useQuery.call(void 0, {
     queryKey: ["behio", "cross-sell", productSlug],
     queryFn: () => unwrap(client.catalog.getCrossSell(productSlug)),
-    enabled: Boolean(productSlug) && (_nullishCoalesce(_optionalChain([options, 'optionalAccess', _75 => _75.enabled]), () => ( true))),
-    initialData: _optionalChain([options, 'optionalAccess', _76 => _76.initialData])
+    enabled: Boolean(productSlug) && (_nullishCoalesce(_optionalChain([options, 'optionalAccess', _78 => _78.enabled]), () => ( true))),
+    initialData: _optionalChain([options, 'optionalAccess', _79 => _79.initialData])
   });
 }
 
@@ -1313,8 +1529,8 @@ function useProductPromotions(productSlug, options) {
   return _reactquery.useQuery.call(void 0, {
     queryKey: ["behio", "product-promotions", productSlug],
     queryFn: () => unwrap(client.catalog.getProductPromotions(productSlug)),
-    enabled: Boolean(productSlug) && (_nullishCoalesce(_optionalChain([options, 'optionalAccess', _77 => _77.enabled]), () => ( true))),
-    refetchInterval: _optionalChain([options, 'optionalAccess', _78 => _78.refetchIntervalMs])
+    enabled: Boolean(productSlug) && (_nullishCoalesce(_optionalChain([options, 'optionalAccess', _80 => _80.enabled]), () => ( true))),
+    refetchInterval: _optionalChain([options, 'optionalAccess', _81 => _81.refetchIntervalMs])
   });
 }
 
@@ -1322,11 +1538,11 @@ function useProductPromotions(productSlug, options) {
 
 function useGiftCardBalance(code, options) {
   const { client } = useBehio();
-  const trimmed = _optionalChain([code, 'optionalAccess', _79 => _79.trim, 'call', _80 => _80()]);
+  const trimmed = _optionalChain([code, 'optionalAccess', _82 => _82.trim, 'call', _83 => _83()]);
   return _reactquery.useQuery.call(void 0, {
     queryKey: ["behio", "gift-card-balance", trimmed],
     queryFn: () => unwrap(client.catalog.checkGiftCard(trimmed)),
-    enabled: Boolean(trimmed && trimmed.length >= 6) && (_nullishCoalesce(_optionalChain([options, 'optionalAccess', _81 => _81.enabled]), () => ( true)))
+    enabled: Boolean(trimmed && trimmed.length >= 6) && (_nullishCoalesce(_optionalChain([options, 'optionalAccess', _84 => _84.enabled]), () => ( true)))
   });
 }
 
@@ -1338,7 +1554,7 @@ function useWishlist(options) {
   const query = _reactquery.useQuery.call(void 0, {
     queryKey: ["behio", "wishlist"],
     queryFn: () => unwrap(client.wishlist.get()),
-    enabled: _nullishCoalesce(_optionalChain([options, 'optionalAccess', _82 => _82.enabled]), () => ( true))
+    enabled: _nullishCoalesce(_optionalChain([options, 'optionalAccess', _85 => _85.enabled]), () => ( true))
   });
   const addMutation = _reactquery.useMutation.call(void 0, {
     mutationFn: (productId) => unwrap(client.wishlist.add(productId)),
@@ -1370,9 +1586,9 @@ function useIsInWishlist(productId) {
 function useProductReviews(productId, options) {
   const { client } = useBehio();
   return _reactquery.useQuery.call(void 0, {
-    queryKey: ["behio", "reviews", productId, _nullishCoalesce(_optionalChain([options, 'optionalAccess', _83 => _83.page]), () => ( 1))],
-    queryFn: () => unwrap(client.reviews.getProductReviews(productId, _optionalChain([options, 'optionalAccess', _84 => _84.page]), _optionalChain([options, 'optionalAccess', _85 => _85.limit]))),
-    enabled: Boolean(productId) && (_nullishCoalesce(_optionalChain([options, 'optionalAccess', _86 => _86.enabled]), () => ( true)))
+    queryKey: ["behio", "reviews", productId, _nullishCoalesce(_optionalChain([options, 'optionalAccess', _86 => _86.page]), () => ( 1))],
+    queryFn: () => unwrap(client.reviews.getProductReviews(productId, _optionalChain([options, 'optionalAccess', _87 => _87.page]), _optionalChain([options, 'optionalAccess', _88 => _88.limit]))),
+    enabled: Boolean(productId) && (_nullishCoalesce(_optionalChain([options, 'optionalAccess', _89 => _89.enabled]), () => ( true)))
   });
 }
 function useSubmitReview() {
@@ -1433,10 +1649,6 @@ function useNotifyWhenAvailable() {
   });
 }
 
-// src/react/hooks/use-behio-client.ts
-function useBehioClient() {
-  return useBehio().client;
-}
 
 
 
@@ -1489,4 +1701,5 @@ function useBehioClient() {
 
 
 
-exports.BehioProvider = BehioProvider; exports.CurrencySwitcher = CurrencySwitcher; exports.StorefrontScripts = StorefrontScripts; exports.cookieStorage = cookieStorage; exports.createMemoryStorage = createMemoryStorage; exports.detectStorage = detectStorage; exports.formatPrice = _chunkXWYDXBLGjs.formatPrice; exports.localStorageAdapter = localStorageAdapter; exports.memoryStorage = memoryStorage; exports.useAddressAutocomplete = useAddressAutocomplete; exports.useAddresses = useAddresses; exports.useAuth = useAuth; exports.useBehio = useBehio; exports.useBehioClient = useBehioClient; exports.useBundle = useBundle; exports.useBundles = useBundles; exports.useCart = useCart; exports.useCartCount = useCartCount; exports.useCategories = useCategories; exports.useCategory = useCategory; exports.useCheckout = useCheckout; exports.useCookieConsent = useCookieConsent; exports.useCrossSell = useCrossSell; exports.useCurrency = useCurrency; exports.useCustomer = useCustomer; exports.useFeatured = useFeatured; exports.useFilters = useFilters; exports.useGiftCardBalance = useGiftCardBalance; exports.useIsInWishlist = useIsInWishlist; exports.useLabels = useLabels; exports.useLookupReturnableOrder = useLookupReturnableOrder; exports.useNotifyWhenAvailable = useNotifyWhenAvailable; exports.useOrder = useOrder; exports.useOrderAccess = useOrderAccess; exports.useOrders = useOrders; exports.usePage = usePage; exports.usePages = usePages; exports.useProduct = useProduct; exports.useProductPromotions = useProductPromotions; exports.useProductReviews = useProductReviews; exports.useProducts = useProducts; exports.useQuoteStatus = useQuoteStatus; exports.useReturnStatus = useReturnStatus; exports.useSearch = useSearch; exports.useShopInfo = useShopInfo; exports.useShopScripts = useShopScripts; exports.useShopSeo = useShopSeo; exports.useSubmitQuote = useSubmitQuote; exports.useSubmitReturn = useSubmitReturn; exports.useSubmitReview = useSubmitReview; exports.useWishlist = useWishlist;
+
+exports.BehioAnalyticsTracker = BehioAnalyticsTracker; exports.BehioProvider = BehioProvider; exports.CurrencySwitcher = CurrencySwitcher; exports.StorefrontScripts = StorefrontScripts; exports.cookieStorage = cookieStorage; exports.createMemoryStorage = createMemoryStorage; exports.detectStorage = detectStorage; exports.formatPrice = _chunkJIAOZ5YWjs.formatPrice; exports.localStorageAdapter = localStorageAdapter; exports.memoryStorage = memoryStorage; exports.trackEcommerceEvent = _chunkJIAOZ5YWjs.trackEcommerceEvent; exports.useAddressAutocomplete = useAddressAutocomplete; exports.useAddresses = useAddresses; exports.useAuth = useAuth; exports.useBehio = useBehio; exports.useBehioClient = useBehioClient; exports.useBundle = useBundle; exports.useBundles = useBundles; exports.useCart = useCart; exports.useCartCount = useCartCount; exports.useCategories = useCategories; exports.useCategory = useCategory; exports.useCheckout = useCheckout; exports.useCookieConsent = useCookieConsent; exports.useCrossSell = useCrossSell; exports.useCurrency = useCurrency; exports.useCustomer = useCustomer; exports.useFeatured = useFeatured; exports.useFilters = useFilters; exports.useGiftCardBalance = useGiftCardBalance; exports.useIsInWishlist = useIsInWishlist; exports.useLabels = useLabels; exports.useLookupReturnableOrder = useLookupReturnableOrder; exports.useNotifyWhenAvailable = useNotifyWhenAvailable; exports.useOrder = useOrder; exports.useOrderAccess = useOrderAccess; exports.useOrders = useOrders; exports.usePage = usePage; exports.usePages = usePages; exports.useProduct = useProduct; exports.useProductPromotions = useProductPromotions; exports.useProductReviews = useProductReviews; exports.useProducts = useProducts; exports.useQuoteStatus = useQuoteStatus; exports.useReturnStatus = useReturnStatus; exports.useSearch = useSearch; exports.useShopInfo = useShopInfo; exports.useShopScripts = useShopScripts; exports.useShopSeo = useShopSeo; exports.useSubmitQuote = useSubmitQuote; exports.useSubmitReturn = useSubmitReturn; exports.useSubmitReview = useSubmitReview; exports.useWishlist = useWishlist;

package/dist/react.mjs

@@ -1,9 +1,10 @@
 import {
-  formatPrice
-} from "./chunk-YJ45WIQZ.mjs";
+  formatPrice,
+  trackEcommerceEvent
+} from "./chunk-ZOZAJG6T.mjs";
 import {
   BehioStorefront
-} from "./chunk-PZED7VMQ.mjs";
+} from "./chunk-2CD4CPEV.mjs";
 
 // src/react/provider.tsx
 import { useRef, useEffect, useMemo, useState, useCallback } from "react";
@@ -1273,6 +1274,221 @@ function StorefrontScripts({ visitorId: visitorIdProp } = {}) {
   return null;
 }
 
+// src/react/components/behio-analytics.tsx
+import { useEffect as useEffect5 } from "react";
+
+// src/react/hooks/use-behio-client.ts
+function useBehioClient() {
+  return useBehio().client;
+}
+
+// src/react/components/behio-analytics.tsx
+function BehioAnalyticsTracker() {
+  const client = useBehioClient();
+  useEffect5(() => {
+    if (typeof window === "undefined") return;
+    const w = window;
+    if (w.__behioAnalytics) return;
+    w.__behioAnalytics = true;
+    const teardown = initTracker(client);
+    return () => {
+      w.__behioAnalytics = false;
+      teardown();
+    };
+  }, [client]);
+  return null;
+}
+var VISITOR_KEY2 = "behio_visitor_id";
+var FLUSH_MAX_EVENTS = 20;
+var FLUSH_INTERVAL_MS = 5e3;
+function initTracker(client) {
+  const sessionId = getSessionId();
+  let visitorId;
+  let currentPath = window.location.pathname;
+  let visibleSince = document.visibilityState === "visible" ? Date.now() : null;
+  let dwellAccumMs = 0;
+  const refreshIdentity = async () => {
+    try {
+      const stored = localStorage.getItem(VISITOR_KEY2) ?? void 0;
+      if (!stored) {
+        visitorId = void 0;
+        client.setAnalyticsVisitorId(null);
+        return;
+      }
+      const { data } = await client.consent.get(stored);
+      const granted = Boolean(data?.analytics);
+      visitorId = granted ? stored : void 0;
+      client.setAnalyticsVisitorId(granted ? stored : null);
+    } catch {
+      visitorId = void 0;
+    }
+  };
+  void refreshIdentity();
+  const onConsentChanged = () => void refreshIdentity();
+  window.addEventListener("behio:consent-changed", onConsentChanged);
+  let queue = [];
+  let flushTimer = null;
+  const flush = () => {
+    if (flushTimer) {
+      clearTimeout(flushTimer);
+      flushTimer = null;
+    }
+    if (queue.length === 0) return;
+    const events = queue;
+    queue = [];
+    void client.sendAnalyticsEvents({ sessionId, ...visitorId ? { visitorId } : {}, events });
+  };
+  const enqueue = (event) => {
+    queue.push(event);
+    if (queue.length >= FLUSH_MAX_EVENTS) {
+      flush();
+      return;
+    }
+    if (!flushTimer) flushTimer = setTimeout(flush, FLUSH_INTERVAL_MS);
+  };
+  const landing = utmFromSearch(window.location.search);
+  enqueue({
+    type: "pageview",
+    path: currentPath,
+    referrer: document.referrer || void 0,
+    ...landing,
+    ts: Date.now()
+  });
+  const settleDwell = () => {
+    if (visibleSince != null) {
+      dwellAccumMs += Date.now() - visibleSince;
+      visibleSince = document.visibilityState === "visible" ? Date.now() : null;
+    }
+  };
+  const takeDwell = () => {
+    settleDwell();
+    const dwell = dwellAccumMs;
+    dwellAccumMs = 0;
+    return dwell;
+  };
+  const onRouteChange = () => {
+    const nextPath = window.location.pathname;
+    if (nextPath === currentPath) return;
+    const dwellMs = takeDwell();
+    if (dwellMs > 0) {
+      enqueue({ type: "custom", name: "dwell", path: currentPath, dwellMs, ts: Date.now() });
+    }
+    currentPath = nextPath;
+    visibleSince = document.visibilityState === "visible" ? Date.now() : null;
+    enqueue({
+      type: "pageview",
+      path: currentPath,
+      ...utmFromSearch(window.location.search),
+      ts: Date.now()
+    });
+    flush();
+  };
+  const onVisibility = () => {
+    if (document.visibilityState === "hidden") {
+      settleDwell();
+      visibleSince = null;
+    } else if (visibleSince == null) {
+      visibleSince = Date.now();
+    }
+  };
+  const onPageHide = () => {
+    const dwellMs = takeDwell();
+    if (dwellMs > 0) {
+      enqueue({ type: "custom", name: "dwell", path: currentPath, dwellMs, ts: Date.now() });
+    }
+    flush();
+  };
+  const onClick = (ev) => {
+    const target = ev.target;
+    const el = target?.closest?.("a,button,[role=button],[data-behio-event]");
+    if (!el) return;
+    const explicit = el.getAttribute("data-behio-event") ?? void 0;
+    const text = (el.textContent ?? "").trim().replace(/\s+/g, " ").slice(0, 80) || void 0;
+    const hrefRaw = el.getAttribute("href") ?? void 0;
+    let href;
+    if (hrefRaw) {
+      try {
+        const u = new URL(hrefRaw, window.location.origin);
+        href = u.origin === window.location.origin ? u.pathname : u.hostname;
+      } catch {
+        href = void 0;
+      }
+    }
+    enqueue({
+      type: "custom",
+      name: explicit || "click",
+      path: currentPath,
+      ts: Date.now(),
+      props: {
+        tag: el.tagName.toLowerCase(),
+        ...text ? { text } : {},
+        ...href ? { href } : {}
+      }
+    });
+  };
+  const w = window;
+  w.__behioEcommerceSink = (event, payload) => {
+    if (event === "purchase") return;
+    enqueue({
+      type: "ecommerce",
+      name: event,
+      path: currentPath,
+      ts: Date.now(),
+      ...payload.value != null ? { value: payload.value } : {},
+      ...payload.currency ? { currency: payload.currency } : {},
+      ...Array.isArray(payload.items) && payload.items.length > 0 ? { props: { items: payload.items.length } } : {}
+    });
+  };
+  const origPush = history.pushState.bind(history);
+  const origReplace = history.replaceState.bind(history);
+  history.pushState = (...args) => {
+    origPush(...args);
+    onRouteChange();
+  };
+  history.replaceState = (...args) => {
+    origReplace(...args);
+    onRouteChange();
+  };
+  window.addEventListener("popstate", onRouteChange);
+  document.addEventListener("visibilitychange", onVisibility);
+  window.addEventListener("pagehide", onPageHide);
+  document.addEventListener("click", onClick, { capture: true, passive: true });
+  return () => {
+    flush();
+    delete w.__behioEcommerceSink;
+    history.pushState = origPush;
+    history.replaceState = origReplace;
+    window.removeEventListener("popstate", onRouteChange);
+    document.removeEventListener("visibilitychange", onVisibility);
+    window.removeEventListener("pagehide", onPageHide);
+    document.removeEventListener("click", onClick, { capture: true });
+    window.removeEventListener("behio:consent-changed", onConsentChanged);
+  };
+}
+function getSessionId() {
+  try {
+    const existing = sessionStorage.getItem("behio.sid");
+    if (existing) return existing;
+    const sid = `s-${Math.random().toString(36).slice(2, 12)}${Date.now().toString(36)}`;
+    sessionStorage.setItem("behio.sid", sid);
+    return sid;
+  } catch {
+    return `s-${Math.random().toString(36).slice(2, 12)}`;
+  }
+}
+function utmFromSearch(search) {
+  try {
+    const p = new URLSearchParams(search);
+    return {
+      utmSource: p.get("utm_source") ?? void 0,
+      utmMedium: p.get("utm_medium") ?? void 0,
+      utmCampaign: p.get("utm_campaign") ?? void 0
+    };
+  } catch {
+    return {};
+  }
+}
+
 // src/react/hooks/use-bundles.ts
 import { useQuery as useQuery19 } from "@tanstack/react-query";
 function useBundles(options) {
@@ -1432,12 +1648,8 @@ function useNotifyWhenAvailable() {
     mutationFn: ({ productId, email }) => unwrap(client.catalog.notifyWhenAvailable(productId, email))
   });
 }
-
-// src/react/hooks/use-behio-client.ts
-function useBehioClient() {
-  return useBehio().client;
-}
 export {
+  BehioAnalyticsTracker,
   BehioProvider,
   CurrencySwitcher,
   StorefrontScripts,
@@ -1447,6 +1659,7 @@ export {
   formatPrice,
   localStorageAdapter,
   memoryStorage,
+  trackEcommerceEvent,
   useAddressAutocomplete,
   useAddresses,
   useAuth,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@behio/storefront-sdk",
-  "version": "0.21.0",
+  "version": "0.23.0",
   "description": "TypeScript SDK for Behio Headless E-Shop — core client + React hooks",
   "author": "Behio",
   "license": "MIT",