@behio/storefront-sdk 0.21.0 → 0.23.0

package/dist/{chunk-PZED7VMQ.mjs → chunk-2CD4CPEV.mjs}

@@ -110,6 +110,8 @@ function toSdkError(err2) {
 // src/client.ts
 var BehioStorefront = class {
   constructor(config) {
+    /** Consent-gated persistent visitor id — set by the analytics tracker. */
+    this.analyticsVisitorId = null;
     // Token refresh lock
     this.isRefreshing = false;
     this.refreshPromise = null;
@@ -146,6 +148,40 @@ var BehioStorefront = class {
     this.shipping = new ShippingModule(this);
   }
   // --- Public methods ---
+  /**
+   * Called by the analytics tracker when the visitor grants (id) or revokes
+   * (null) analytics consent. When set, requests carry the X-Behio-Vid header
+   * so the backend can attribute orders to the visitor journey.
+   */
+  setAnalyticsVisitorId(id) {
+    this.analyticsVisitorId = id;
+  }
+  /** The consent-gated visitor id, if analytics consent was granted. */
+  getAnalyticsVisitorId() {
+    return this.analyticsVisitorId;
+  }
+  /**
+   * Fire-and-forget Behio Analytics ingest. Uses a bare keepalive fetch (not
+   * the interceptor pipeline) so flushes on pagehide still land, and swallows
+   * every error — analytics must never break the shop. The client sends no
+   * identity; the visitor hash is computed server-side from a daily salt.
+   */
+  async sendAnalyticsEvents(input) {
+    try {
+      const headers = {
+        "X-Api-Key": this.apiKey,
+        "Content-Type": "application/json"
+      };
+      if (this.shopDomain) headers["X-Shop-Domain"] = this.shopDomain;
+      await fetch(`${this.baseUrl}/storefront/v1/analytics/events`, {
+        method: "POST",
+        keepalive: true,
+        headers,
+        body: JSON.stringify(input)
+      });
+    } catch {
+    }
+  }
   /** Get basic shop info */
   async getShopInfo() {
     return this.request("GET", "/shop");
@@ -342,6 +378,9 @@ var BehioStorefront = class {
     if (this.cartSession) {
       headers["X-Cart-Session"] = this.cartSession;
     }
+    if (this.analyticsVisitorId) {
+      headers["X-Behio-Vid"] = this.analyticsVisitorId;
+    }
     if (options?.headers) {
       Object.assign(headers, options.headers);
     }

package/dist/{chunk-BF4YVFHX.js → chunk-3RI2QBQO.js}

@@ -110,6 +110,8 @@ function toSdkError(err2) {
 // src/client.ts
 var BehioStorefront = class {
   constructor(config) {
+    /** Consent-gated persistent visitor id — set by the analytics tracker. */
+    this.analyticsVisitorId = null;
     // Token refresh lock
     this.isRefreshing = false;
     this.refreshPromise = null;
@@ -146,6 +148,40 @@ var BehioStorefront = class {
     this.shipping = new ShippingModule(this);
   }
   // --- Public methods ---
+  /**
+   * Called by the analytics tracker when the visitor grants (id) or revokes
+   * (null) analytics consent. When set, requests carry the X-Behio-Vid header
+   * so the backend can attribute orders to the visitor journey.
+   */
+  setAnalyticsVisitorId(id) {
+    this.analyticsVisitorId = id;
+  }
+  /** The consent-gated visitor id, if analytics consent was granted. */
+  getAnalyticsVisitorId() {
+    return this.analyticsVisitorId;
+  }
+  /**
+   * Fire-and-forget Behio Analytics ingest. Uses a bare keepalive fetch (not
+   * the interceptor pipeline) so flushes on pagehide still land, and swallows
+   * every error — analytics must never break the shop. The client sends no
+   * identity; the visitor hash is computed server-side from a daily salt.
+   */
+  async sendAnalyticsEvents(input) {
+    try {
+      const headers = {
+        "X-Api-Key": this.apiKey,
+        "Content-Type": "application/json"
+      };
+      if (this.shopDomain) headers["X-Shop-Domain"] = this.shopDomain;
+      await fetch(`${this.baseUrl}/storefront/v1/analytics/events`, {
+        method: "POST",
+        keepalive: true,
+        headers,
+        body: JSON.stringify(input)
+      });
+    } catch (e) {
+    }
+  }
   /** Get basic shop info */
   async getShopInfo() {
     return this.request("GET", "/shop");
@@ -231,7 +267,7 @@ var BehioStorefront = class {
     _optionalChain([this, 'access', _7 => _7.listeners, 'access', _8 => _8.get, 'call', _9 => _9(event), 'optionalAccess', _10 => _10.forEach, 'call', _11 => _11((fn) => {
       try {
         fn(data);
-      } catch (e) {
+      } catch (e2) {
       }
     })]);
   }
@@ -342,6 +378,9 @@ var BehioStorefront = class {
     if (this.cartSession) {
       headers["X-Cart-Session"] = this.cartSession;
     }
+    if (this.analyticsVisitorId) {
+      headers["X-Behio-Vid"] = this.analyticsVisitorId;
+    }
     if (_optionalChain([options, 'optionalAccess', _14 => _14.headers])) {
       Object.assign(headers, options.headers);
     }
@@ -405,7 +444,7 @@ var BehioStorefront = class {
           try {
             await this.handleTokenRefresh();
             return this.rawRequest(method, path, { ...options, _isRetryAfterRefresh: true });
-          } catch (e2) {
+          } catch (e3) {
             this.emit("error", apiError);
             throw apiError;
           }
@@ -421,7 +460,7 @@ var BehioStorefront = class {
       for (const interceptor of this.responseInterceptors) {
         try {
           await interceptor({ status: res.status, data: responseData, headers: res.headers });
-        } catch (e3) {
+        } catch (e4) {
         }
       }
       return responseData;

package/dist/chunk-JIAOZ5YW.js

@@ -0,0 +1,40 @@
+"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; }// src/react/utils/format-price.ts
+function formatPrice(amount, currency, locale) {
+  const resolvedLocale = _nullishCoalesce(locale, () => ( "cs"));
+  try {
+    return new Intl.NumberFormat(resolvedLocale, {
+      style: "currency",
+      currency,
+      minimumFractionDigits: Number.isInteger(amount) ? 0 : 2,
+      maximumFractionDigits: 2
+    }).format(amount);
+  } catch (e) {
+    return `${amount} ${currency}`;
+  }
+}
+
+// src/analytics.ts
+function trackEcommerceEvent(event, payload) {
+  if (typeof window === "undefined") return;
+  const w = window;
+  try {
+    _optionalChain([w, 'access', _ => _.__behioEcommerceSink, 'optionalCall', _2 => _2(event, payload)]);
+  } catch (e2) {
+  }
+  try {
+    if (typeof w.gtag === "function") {
+      w.gtag("event", event, payload);
+      return;
+    }
+    if (Array.isArray(w.dataLayer)) {
+      w.dataLayer.push({ ecommerce: null });
+      w.dataLayer.push({ event, ecommerce: payload });
+    }
+  } catch (e3) {
+  }
+}
+
+
+
+
+exports.formatPrice = formatPrice; exports.trackEcommerceEvent = trackEcommerceEvent;

package/dist/chunk-ZOZAJG6T.mjs

@@ -0,0 +1,40 @@
+// src/react/utils/format-price.ts
+function formatPrice(amount, currency, locale) {
+  const resolvedLocale = locale ?? "cs";
+  try {
+    return new Intl.NumberFormat(resolvedLocale, {
+      style: "currency",
+      currency,
+      minimumFractionDigits: Number.isInteger(amount) ? 0 : 2,
+      maximumFractionDigits: 2
+    }).format(amount);
+  } catch {
+    return `${amount} ${currency}`;
+  }
+}
+
+// src/analytics.ts
+function trackEcommerceEvent(event, payload) {
+  if (typeof window === "undefined") return;
+  const w = window;
+  try {
+    w.__behioEcommerceSink?.(event, payload);
+  } catch {
+  }
+  try {
+    if (typeof w.gtag === "function") {
+      w.gtag("event", event, payload);
+      return;
+    }
+    if (Array.isArray(w.dataLayer)) {
+      w.dataLayer.push({ ecommerce: null });
+      w.dataLayer.push({ event, ecommerce: payload });
+    }
+  } catch {
+  }
+}
+
+export {
+  formatPrice,
+  trackEcommerceEvent
+};

package/dist/{client-hCuGQERQ.d.mts → client-B0VFrsad.d.mts}

@@ -454,6 +454,12 @@ interface CheckoutAddress {
     phone?: string;
 }
 interface CheckoutInput {
+    /**
+     * Consent-gated Behio Analytics visitor id (behio_visitor_id). Optional;
+     * lets the backend attribute the order to the visitor journey. Send it only
+     * when the visitor granted analytics consent.
+     */
+    analyticsVisitorId?: string;
     shippingAddress: CheckoutAddress;
     billingAddress: CheckoutAddress;
     email: string;
@@ -993,6 +999,8 @@ interface SubmitQuoteInput {
 declare class BehioStorefront {
     private baseUrl;
     private apiKey;
+    /** Consent-gated persistent visitor id — set by the analytics tracker. */
+    private analyticsVisitorId;
     private shopDomain?;
     private defaultLocale?;
     private defaultCurrency?;
@@ -1025,6 +1033,39 @@ declare class BehioStorefront {
     readonly quotes: QuotesModule;
     readonly addresses: AddressModule;
     readonly shipping: ShippingModule;
+    /**
+     * Called by the analytics tracker when the visitor grants (id) or revokes
+     * (null) analytics consent. When set, requests carry the X-Behio-Vid header
+     * so the backend can attribute orders to the visitor journey.
+     */
+    setAnalyticsVisitorId(id: string | null): void;
+    /** The consent-gated visitor id, if analytics consent was granted. */
+    getAnalyticsVisitorId(): string | null;
+    /**
+     * Fire-and-forget Behio Analytics ingest. Uses a bare keepalive fetch (not
+     * the interceptor pipeline) so flushes on pagehide still land, and swallows
+     * every error — analytics must never break the shop. The client sends no
+     * identity; the visitor hash is computed server-side from a daily salt.
+     */
+    sendAnalyticsEvents(input: {
+        sessionId?: string;
+        /** Persistent consent-gated visitor id (behio_visitor_id). */
+        visitorId?: string;
+        events: Array<{
+            type: "pageview" | "ecommerce" | "custom";
+            name?: string;
+            ts?: number;
+            path?: string;
+            referrer?: string;
+            utmSource?: string;
+            utmMedium?: string;
+            utmCampaign?: string;
+            dwellMs?: number;
+            value?: number;
+            currency?: string;
+            props?: Record<string, unknown>;
+        }>;
+    }): Promise<void>;
     /** Get basic shop info */
     getShopInfo(): Promise<SdkResult<ShopInfo>>;
     /** Get SEO metadata for the shop homepage in the given locale (defaults to shop default). */

package/dist/{client-hCuGQERQ.d.ts → client-B0VFrsad.d.ts}

@@ -454,6 +454,12 @@ interface CheckoutAddress {
     phone?: string;
 }
 interface CheckoutInput {
+    /**
+     * Consent-gated Behio Analytics visitor id (behio_visitor_id). Optional;
+     * lets the backend attribute the order to the visitor journey. Send it only
+     * when the visitor granted analytics consent.
+     */
+    analyticsVisitorId?: string;
     shippingAddress: CheckoutAddress;
     billingAddress: CheckoutAddress;
     email: string;
@@ -993,6 +999,8 @@ interface SubmitQuoteInput {
 declare class BehioStorefront {
     private baseUrl;
     private apiKey;
+    /** Consent-gated persistent visitor id — set by the analytics tracker. */
+    private analyticsVisitorId;
     private shopDomain?;
     private defaultLocale?;
     private defaultCurrency?;
@@ -1025,6 +1033,39 @@ declare class BehioStorefront {
     readonly quotes: QuotesModule;
     readonly addresses: AddressModule;
     readonly shipping: ShippingModule;
+    /**
+     * Called by the analytics tracker when the visitor grants (id) or revokes
+     * (null) analytics consent. When set, requests carry the X-Behio-Vid header
+     * so the backend can attribute orders to the visitor journey.
+     */
+    setAnalyticsVisitorId(id: string | null): void;
+    /** The consent-gated visitor id, if analytics consent was granted. */
+    getAnalyticsVisitorId(): string | null;
+    /**
+     * Fire-and-forget Behio Analytics ingest. Uses a bare keepalive fetch (not
+     * the interceptor pipeline) so flushes on pagehide still land, and swallows
+     * every error — analytics must never break the shop. The client sends no
+     * identity; the visitor hash is computed server-side from a daily salt.
+     */
+    sendAnalyticsEvents(input: {
+        sessionId?: string;
+        /** Persistent consent-gated visitor id (behio_visitor_id). */
+        visitorId?: string;
+        events: Array<{
+            type: "pageview" | "ecommerce" | "custom";
+            name?: string;
+            ts?: number;
+            path?: string;
+            referrer?: string;
+            utmSource?: string;
+            utmMedium?: string;
+            utmCampaign?: string;
+            dwellMs?: number;
+            value?: number;
+            currency?: string;
+            props?: Record<string, unknown>;
+        }>;
+    }): Promise<void>;
     /** Get basic shop info */
     getShopInfo(): Promise<SdkResult<ShopInfo>>;
     /** Get SEO metadata for the shop homepage in the given locale (defaults to shop default). */

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-export { u as ActivePromotion, K as AddToCartInput, j as AddressDetail, A as AddressSuggestion, a4 as AddressType, a5 as AddressTypes, L as AuthTokens, J as BackInStockSubscription, M as BehioApiError, a6 as BehioErrorCode, a7 as BehioEventHandler, a8 as BehioEventType, a9 as BehioNetworkError, a as BehioStorefront, B as BehioStorefrontConfig, s as Bundle, N as BundleItem, g as Cart, aa as CartBundleLine, ab as CartBundleLineItem, T as CartDiscount, U as CartItem, ac as CartItemProduct, C as Category, e as CategoryDetail, V as CheckoutAddress, n as CheckoutInput, ad as CheckoutPaymentMethod, E as CookieConsent, H as CookieConsentInput, t as CrossSellItem, i as CustomerAddress, h as CustomerProfile, ae as DataGroupFieldType, F as FilterField, X as FulfillmentStatus, af as FulfillmentStatuses, G as GiftCardBalance, ag as GiftCardSummary, Y as LoginInput, Z as MessageResponse, l as OrderAccessRequestResponse, m as OrderAccessVerifyResponse, k as OrderDetail, _ as OrderItem, O as OrderListItem, $ as OrderStatus, ah as OrderStatusHistory, ai as OrderStatuses, aj as OrderTracking, p as Page, ak as PageAttachment, o as PageDetail, b as PaginatedResponse, a0 as PaymentStatus, al as PaymentStatuses, d as ProductDetail, f as ProductLabel, c as ProductListItem, am as ProductMedia, an as ProductMediaVariant, a1 as ProductPrice, a2 as ProductReview, v as ProductReviewsResponse, ao as ProductSort, ap as ProductSortValue, a3 as ProductVariant, aq as ProductVolumePrice, P as ProductsQuery, ar as QuoteItem, Q as QuoteRequest, R as RegisterInput, as as RegisterResult, at as RequestInterceptor, au as RequestInterceptorConfig, av as ResponseInterceptor, aw as ResponseInterceptorData, z as ReturnRequest, ax as ReturnRequestItem, y as ReturnStatus, ay as ReturnStatusItem, x as ReturnableOrder, az as ReturnableOrderItem, aA as SdkError, aB as SdkResult, aC as ShippingMethodSummary, aD as ShippingQuote, aE as ShippingQuoteInput, S as ShopInfo, aF as ShopScript, aG as ShopScriptPlacement, aH as ShopScriptType, q as ShopScripts, r as ShopSeo, I as SubmitQuoteInput, D as SubmitReturnInput, w as SubmitReviewInput, W as WishlistItem, aI as err, aJ as ok, aK as toSdkError } from './client-hCuGQERQ.mjs';
+export { u as ActivePromotion, K as AddToCartInput, j as AddressDetail, A as AddressSuggestion, a4 as AddressType, a5 as AddressTypes, L as AuthTokens, J as BackInStockSubscription, M as BehioApiError, a6 as BehioErrorCode, a7 as BehioEventHandler, a8 as BehioEventType, a9 as BehioNetworkError, a as BehioStorefront, B as BehioStorefrontConfig, s as Bundle, N as BundleItem, g as Cart, aa as CartBundleLine, ab as CartBundleLineItem, T as CartDiscount, U as CartItem, ac as CartItemProduct, C as Category, e as CategoryDetail, V as CheckoutAddress, n as CheckoutInput, ad as CheckoutPaymentMethod, E as CookieConsent, H as CookieConsentInput, t as CrossSellItem, i as CustomerAddress, h as CustomerProfile, ae as DataGroupFieldType, F as FilterField, X as FulfillmentStatus, af as FulfillmentStatuses, G as GiftCardBalance, ag as GiftCardSummary, Y as LoginInput, Z as MessageResponse, l as OrderAccessRequestResponse, m as OrderAccessVerifyResponse, k as OrderDetail, _ as OrderItem, O as OrderListItem, $ as OrderStatus, ah as OrderStatusHistory, ai as OrderStatuses, aj as OrderTracking, p as Page, ak as PageAttachment, o as PageDetail, b as PaginatedResponse, a0 as PaymentStatus, al as PaymentStatuses, d as ProductDetail, f as ProductLabel, c as ProductListItem, am as ProductMedia, an as ProductMediaVariant, a1 as ProductPrice, a2 as ProductReview, v as ProductReviewsResponse, ao as ProductSort, ap as ProductSortValue, a3 as ProductVariant, aq as ProductVolumePrice, P as ProductsQuery, ar as QuoteItem, Q as QuoteRequest, R as RegisterInput, as as RegisterResult, at as RequestInterceptor, au as RequestInterceptorConfig, av as ResponseInterceptor, aw as ResponseInterceptorData, z as ReturnRequest, ax as ReturnRequestItem, y as ReturnStatus, ay as ReturnStatusItem, x as ReturnableOrder, az as ReturnableOrderItem, aA as SdkError, aB as SdkResult, aC as ShippingMethodSummary, aD as ShippingQuote, aE as ShippingQuoteInput, S as ShopInfo, aF as ShopScript, aG as ShopScriptPlacement, aH as ShopScriptType, q as ShopScripts, r as ShopSeo, I as SubmitQuoteInput, D as SubmitReturnInput, w as SubmitReviewInput, W as WishlistItem, aI as err, aJ as ok, aK as toSdkError } from './client-B0VFrsad.mjs';
 
 /**
  * Format a price amount with currency using Intl.NumberFormat.
@@ -10,4 +10,40 @@ export { u as ActivePromotion, K as AddToCartInput, j as AddressDetail, A as Add
  */
 declare function formatPrice(amount: number, currency: string, locale?: string): string;
 
-export { formatPrice };
+/**
+ * GA4 e-commerce event helper.
+ *
+ * Fires standard GA4 ecommerce events (view_item, add_to_cart, begin_checkout,
+ * purchase, ...) into whatever analytics runtime the shop has injected via
+ * `<StorefrontScripts/>`:
+ *
+ * - direct GA4 (`gtag` present) -> `gtag("event", name, payload)`
+ * - GTM (`dataLayer` array present) -> `dataLayer.push({event, ecommerce})`
+ *   (with the recommended `ecommerce: null` reset push first)
+ * - neither present (no analytics configured, or consent not granted yet so
+ *   the consent-gated script never loaded) -> silent no-op
+ *
+ * Consent stays the script layer's job: this helper never loads anything, it
+ * only talks to runtimes that already exist on the page.
+ */
+type EcommerceEventName = "view_item" | "add_to_cart" | "remove_from_cart" | "view_cart" | "begin_checkout" | "add_payment_info" | "add_shipping_info" | "purchase";
+type EcommerceItem = {
+    item_id: string;
+    item_name: string;
+    price?: number;
+    quantity?: number;
+    item_variant?: string;
+    item_category?: string;
+};
+type EcommercePayload = {
+    currency?: string;
+    /** Order / cart total in `currency`. */
+    value?: number;
+    /** Required for `purchase` — the order number. */
+    transaction_id?: string;
+    shipping?: number;
+    items: EcommerceItem[];
+};
+declare function trackEcommerceEvent(event: EcommerceEventName, payload: EcommercePayload): void;
+
+export { type EcommerceEventName, type EcommerceItem, type EcommercePayload, formatPrice, trackEcommerceEvent };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { u as ActivePromotion, K as AddToCartInput, j as AddressDetail, A as AddressSuggestion, a4 as AddressType, a5 as AddressTypes, L as AuthTokens, J as BackInStockSubscription, M as BehioApiError, a6 as BehioErrorCode, a7 as BehioEventHandler, a8 as BehioEventType, a9 as BehioNetworkError, a as BehioStorefront, B as BehioStorefrontConfig, s as Bundle, N as BundleItem, g as Cart, aa as CartBundleLine, ab as CartBundleLineItem, T as CartDiscount, U as CartItem, ac as CartItemProduct, C as Category, e as CategoryDetail, V as CheckoutAddress, n as CheckoutInput, ad as CheckoutPaymentMethod, E as CookieConsent, H as CookieConsentInput, t as CrossSellItem, i as CustomerAddress, h as CustomerProfile, ae as DataGroupFieldType, F as FilterField, X as FulfillmentStatus, af as FulfillmentStatuses, G as GiftCardBalance, ag as GiftCardSummary, Y as LoginInput, Z as MessageResponse, l as OrderAccessRequestResponse, m as OrderAccessVerifyResponse, k as OrderDetail, _ as OrderItem, O as OrderListItem, $ as OrderStatus, ah as OrderStatusHistory, ai as OrderStatuses, aj as OrderTracking, p as Page, ak as PageAttachment, o as PageDetail, b as PaginatedResponse, a0 as PaymentStatus, al as PaymentStatuses, d as ProductDetail, f as ProductLabel, c as ProductListItem, am as ProductMedia, an as ProductMediaVariant, a1 as ProductPrice, a2 as ProductReview, v as ProductReviewsResponse, ao as ProductSort, ap as ProductSortValue, a3 as ProductVariant, aq as ProductVolumePrice, P as ProductsQuery, ar as QuoteItem, Q as QuoteRequest, R as RegisterInput, as as RegisterResult, at as RequestInterceptor, au as RequestInterceptorConfig, av as ResponseInterceptor, aw as ResponseInterceptorData, z as ReturnRequest, ax as ReturnRequestItem, y as ReturnStatus, ay as ReturnStatusItem, x as ReturnableOrder, az as ReturnableOrderItem, aA as SdkError, aB as SdkResult, aC as ShippingMethodSummary, aD as ShippingQuote, aE as ShippingQuoteInput, S as ShopInfo, aF as ShopScript, aG as ShopScriptPlacement, aH as ShopScriptType, q as ShopScripts, r as ShopSeo, I as SubmitQuoteInput, D as SubmitReturnInput, w as SubmitReviewInput, W as WishlistItem, aI as err, aJ as ok, aK as toSdkError } from './client-hCuGQERQ.js';
+export { u as ActivePromotion, K as AddToCartInput, j as AddressDetail, A as AddressSuggestion, a4 as AddressType, a5 as AddressTypes, L as AuthTokens, J as BackInStockSubscription, M as BehioApiError, a6 as BehioErrorCode, a7 as BehioEventHandler, a8 as BehioEventType, a9 as BehioNetworkError, a as BehioStorefront, B as BehioStorefrontConfig, s as Bundle, N as BundleItem, g as Cart, aa as CartBundleLine, ab as CartBundleLineItem, T as CartDiscount, U as CartItem, ac as CartItemProduct, C as Category, e as CategoryDetail, V as CheckoutAddress, n as CheckoutInput, ad as CheckoutPaymentMethod, E as CookieConsent, H as CookieConsentInput, t as CrossSellItem, i as CustomerAddress, h as CustomerProfile, ae as DataGroupFieldType, F as FilterField, X as FulfillmentStatus, af as FulfillmentStatuses, G as GiftCardBalance, ag as GiftCardSummary, Y as LoginInput, Z as MessageResponse, l as OrderAccessRequestResponse, m as OrderAccessVerifyResponse, k as OrderDetail, _ as OrderItem, O as OrderListItem, $ as OrderStatus, ah as OrderStatusHistory, ai as OrderStatuses, aj as OrderTracking, p as Page, ak as PageAttachment, o as PageDetail, b as PaginatedResponse, a0 as PaymentStatus, al as PaymentStatuses, d as ProductDetail, f as ProductLabel, c as ProductListItem, am as ProductMedia, an as ProductMediaVariant, a1 as ProductPrice, a2 as ProductReview, v as ProductReviewsResponse, ao as ProductSort, ap as ProductSortValue, a3 as ProductVariant, aq as ProductVolumePrice, P as ProductsQuery, ar as QuoteItem, Q as QuoteRequest, R as RegisterInput, as as RegisterResult, at as RequestInterceptor, au as RequestInterceptorConfig, av as ResponseInterceptor, aw as ResponseInterceptorData, z as ReturnRequest, ax as ReturnRequestItem, y as ReturnStatus, ay as ReturnStatusItem, x as ReturnableOrder, az as ReturnableOrderItem, aA as SdkError, aB as SdkResult, aC as ShippingMethodSummary, aD as ShippingQuote, aE as ShippingQuoteInput, S as ShopInfo, aF as ShopScript, aG as ShopScriptPlacement, aH as ShopScriptType, q as ShopScripts, r as ShopSeo, I as SubmitQuoteInput, D as SubmitReturnInput, w as SubmitReviewInput, W as WishlistItem, aI as err, aJ as ok, aK as toSdkError } from './client-B0VFrsad.js';
 
 /**
  * Format a price amount with currency using Intl.NumberFormat.
@@ -10,4 +10,40 @@ export { u as ActivePromotion, K as AddToCartInput, j as AddressDetail, A as Add
  */
 declare function formatPrice(amount: number, currency: string, locale?: string): string;
 
-export { formatPrice };
+/**
+ * GA4 e-commerce event helper.
+ *
+ * Fires standard GA4 ecommerce events (view_item, add_to_cart, begin_checkout,
+ * purchase, ...) into whatever analytics runtime the shop has injected via
+ * `<StorefrontScripts/>`:
+ *
+ * - direct GA4 (`gtag` present) -> `gtag("event", name, payload)`
+ * - GTM (`dataLayer` array present) -> `dataLayer.push({event, ecommerce})`
+ *   (with the recommended `ecommerce: null` reset push first)
+ * - neither present (no analytics configured, or consent not granted yet so
+ *   the consent-gated script never loaded) -> silent no-op
+ *
+ * Consent stays the script layer's job: this helper never loads anything, it
+ * only talks to runtimes that already exist on the page.
+ */
+type EcommerceEventName = "view_item" | "add_to_cart" | "remove_from_cart" | "view_cart" | "begin_checkout" | "add_payment_info" | "add_shipping_info" | "purchase";
+type EcommerceItem = {
+    item_id: string;
+    item_name: string;
+    price?: number;
+    quantity?: number;
+    item_variant?: string;
+    item_category?: string;
+};
+type EcommercePayload = {
+    currency?: string;
+    /** Order / cart total in `currency`. */
+    value?: number;
+    /** Required for `purchase` — the order number. */
+    transaction_id?: string;
+    shipping?: number;
+    items: EcommerceItem[];
+};
+declare function trackEcommerceEvent(event: EcommerceEventName, payload: EcommercePayload): void;
+
+export { type EcommerceEventName, type EcommerceItem, type EcommercePayload, formatPrice, trackEcommerceEvent };

package/dist/index.js

@@ -1,7 +1,7 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunkXWYDXBLGjs = require('./chunk-XWYDXBLG.js');
 
+var _chunkJIAOZ5YWjs = require('./chunk-JIAOZ5YW.js');
 
 
 
@@ -13,8 +13,8 @@ var _chunkXWYDXBLGjs = require('./chunk-XWYDXBLG.js');
 
 
 
-var _chunkBF4YVFHXjs = require('./chunk-BF4YVFHX.js');
 
+var _chunk3RI2QBQOjs = require('./chunk-3RI2QBQO.js');
 
 
 
@@ -27,4 +27,6 @@ var _chunkBF4YVFHXjs = require('./chunk-BF4YVFHX.js');
 
 
 
-exports.AddressTypes = _chunkBF4YVFHXjs.AddressTypes; exports.BehioApiError = _chunkBF4YVFHXjs.BehioApiError; exports.BehioNetworkError = _chunkBF4YVFHXjs.BehioNetworkError; exports.BehioStorefront = _chunkBF4YVFHXjs.BehioStorefront; exports.FulfillmentStatuses = _chunkBF4YVFHXjs.FulfillmentStatuses; exports.OrderStatuses = _chunkBF4YVFHXjs.OrderStatuses; exports.PaymentStatuses = _chunkBF4YVFHXjs.PaymentStatuses; exports.ProductSort = _chunkBF4YVFHXjs.ProductSort; exports.err = _chunkBF4YVFHXjs.err; exports.formatPrice = _chunkXWYDXBLGjs.formatPrice; exports.ok = _chunkBF4YVFHXjs.ok; exports.toSdkError = _chunkBF4YVFHXjs.toSdkError;
+
+
+exports.AddressTypes = _chunk3RI2QBQOjs.AddressTypes; exports.BehioApiError = _chunk3RI2QBQOjs.BehioApiError; exports.BehioNetworkError = _chunk3RI2QBQOjs.BehioNetworkError; exports.BehioStorefront = _chunk3RI2QBQOjs.BehioStorefront; exports.FulfillmentStatuses = _chunk3RI2QBQOjs.FulfillmentStatuses; exports.OrderStatuses = _chunk3RI2QBQOjs.OrderStatuses; exports.PaymentStatuses = _chunk3RI2QBQOjs.PaymentStatuses; exports.ProductSort = _chunk3RI2QBQOjs.ProductSort; exports.err = _chunk3RI2QBQOjs.err; exports.formatPrice = _chunkJIAOZ5YWjs.formatPrice; exports.ok = _chunk3RI2QBQOjs.ok; exports.toSdkError = _chunk3RI2QBQOjs.toSdkError; exports.trackEcommerceEvent = _chunkJIAOZ5YWjs.trackEcommerceEvent;

package/dist/index.mjs

@@ -1,6 +1,7 @@
 import {
-  formatPrice
-} from "./chunk-YJ45WIQZ.mjs";
+  formatPrice,
+  trackEcommerceEvent
+} from "./chunk-ZOZAJG6T.mjs";
 import {
   AddressTypes,
   BehioApiError,
@@ -13,7 +14,7 @@ import {
   err,
   ok,
   toSdkError
-} from "./chunk-PZED7VMQ.mjs";
+} from "./chunk-2CD4CPEV.mjs";
 export {
   AddressTypes,
   BehioApiError,
@@ -26,5 +27,6 @@ export {
   err,
   formatPrice,
   ok,
-  toSdkError
+  toSdkError,
+  trackEcommerceEvent
 };

package/dist/next.d.mts

@@ -1,4 +1,4 @@
-import { B as BehioStorefrontConfig, a as BehioStorefront } from './client-hCuGQERQ.mjs';
+import { B as BehioStorefrontConfig, a as BehioStorefront } from './client-B0VFrsad.mjs';
 
 interface GetBehioOptions extends Partial<BehioStorefrontConfig> {
     /** Override the cart session cookie name (default: "behio_cart_session"). */

package/dist/next.d.ts

@@ -1,4 +1,4 @@
-import { B as BehioStorefrontConfig, a as BehioStorefront } from './client-hCuGQERQ.js';
+import { B as BehioStorefrontConfig, a as BehioStorefront } from './client-B0VFrsad.js';
 
 interface GetBehioOptions extends Partial<BehioStorefrontConfig> {
     /** Override the cart session cookie name (default: "behio_cart_session"). */

package/dist/next.js

@@ -1,6 +1,6 @@
 "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 _chunkBF4YVFHXjs = require('./chunk-BF4YVFHX.js');
+var _chunk3RI2QBQOjs = require('./chunk-3RI2QBQO.js');
 
 // src/next.ts
 var _headers = require('next/headers');
@@ -18,7 +18,7 @@ async function getBehio(options = {}) {
   const locale = _nullishCoalesce(options.locale, () => ( process.env.BEHIO_LOCALE));
   const currency = _nullishCoalesce(options.currency, () => ( process.env.BEHIO_CURRENCY));
   const cookieName = _nullishCoalesce(options.cartCookieName, () => ( CART_COOKIE_NAME));
-  const client = new (0, _chunkBF4YVFHXjs.BehioStorefront)({
+  const client = new (0, _chunk3RI2QBQOjs.BehioStorefront)({
     apiKey,
     ...baseUrl ? { baseUrl } : {},
     ...locale ? { locale } : {},

package/dist/next.mjs

@@ -1,6 +1,6 @@
 import {
   BehioStorefront
-} from "./chunk-PZED7VMQ.mjs";
+} from "./chunk-2CD4CPEV.mjs";
 
 // src/next.ts
 import { cookies } from "next/headers";

package/dist/react.d.mts

@@ -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.mjs';
-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.mjs';
+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.mjs';
+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.mjs';
 import * as _tanstack_query_core from '@tanstack/query-core';
-export { formatPrice } from './index.mjs';
+export { EcommerceEventName, EcommerceItem, EcommercePayload, formatPrice, trackEcommerceEvent } from './index.mjs';
 
 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 };