@behio/storefront-sdk 0.32.0 → 0.34.0

package/dist/index.d.ts

@@ -1,4 +1,5 @@
-export { z as ActivePromotion, Y as AddToCartInput, j as AddressDetail, A as AddressSuggestion, ac as AddressType, ad as AddressTypes, Z as AuthTokens, X as BackInStockSubscription, ae as BadgeTone, _ as BehioApiError, af as BehioErrorCode, ag as BehioEventHandler, ah as BehioEventType, ai as BehioNetworkError, a as BehioStorefront, B as BehioStorefrontConfig, w as Bundle, $ as BundleItem, g as Cart, aj as CartBundleLine, ak as CartBundleLineItem, a0 as CartDiscount, a1 as CartItem, al as CartItemProduct, am as CartPromotion, C as Category, e as CategoryDetail, a2 as CheckoutAddress, r as CheckoutInput, an as CheckoutPaymentMethod, ao as CheckoutSettings, Q as CookieConsent, T as CookieConsentInput, y as CrossSellItem, i as CustomerAddress, h as CustomerProfile, ap as DataGroupFieldType, aq as DigitalDownload, ar as DownloadUrl, F as FilterField, a3 as FulfillmentStatus, as as FulfillmentStatuses, G as GiftCardBalance, at as GiftCardPurchaseInput, au as GiftCardPurchaseResult, av as GiftCardSummary, a4 as LoginInput, aw as LoyaltyBalance, ax as LoyaltyNextTier, ay as LoyaltyProgram, L as LoyaltySummary, az as LoyaltyTier, aA as LoyaltyTierPerks, aB as LoyaltyTransaction, M as Menu, aC as MenuItem, aD as MenuItemRef, aE as MenuItemType, a5 as MessageResponse, aF as NewsletterOptInDefault, m as NewsletterSubscribeInput, N as NewsletterSubscribeResult, n as NewsletterUnsubscribeResult, p as OrderAccessRequestResponse, q as OrderAccessVerifyResponse, o as OrderDetail, a6 as OrderItem, O as OrderListItem, a7 as OrderStatus, aG as OrderStatusHistory, aH as OrderStatuses, aI as OrderTracking, t as Page, aJ as PageAttachment, s as PageDetail, b as PaginatedResponse, a8 as PaymentStatus, aK as PaymentStatuses, l as PickupPoint, aL as PickupPointHours, k as PickupPointsInput, aM as ProductAvailability, d as ProductDetail, x as ProductGroup, f as ProductLabel, c as ProductListItem, aN as ProductMedia, aO as ProductMediaVariant, a9 as ProductPrice, aa as ProductReview, D as ProductReviewsResponse, aP as ProductSort, aQ as ProductSortValue, ab as ProductVariant, aR as ProductVolumePrice, P as ProductsQuery, aS as QuoteItem, U as QuoteRequest, R as RegisterInput, aT as RegisterResult, aU as RequestInterceptor, aV as RequestInterceptorConfig, aW as ResponseInterceptor, aX as ResponseInterceptorData, J as ReturnRequest, aY as ReturnRequestItem, I as ReturnStatus, aZ as ReturnStatusItem, H as ReturnableOrder, a_ as ReturnableOrderItem, a$ as SdkError, b0 as SdkResult, b1 as ShippingMethodSummary, b2 as ShippingQuote, b3 as ShippingQuoteInput, S as ShopInfo, b4 as ShopScript, b5 as ShopScriptPlacement, b6 as ShopScriptType, u as ShopScripts, v as ShopSeo, b7 as StockBehavior, V as SubmitQuoteInput, K as SubmitReturnInput, E as SubmitReviewInput, b8 as VariantAxis, b9 as VariantAxisValue, W as WishlistItem, ba as err, bb as ok, bc as toSdkError } from './client-BOz1trRk.js';
+import { a as BehioStorefront, ai as SdkResult, Z as CookieConsent } from './client-DdaC0_6x.js';
+export { J as ActivePromotion, a2 as AddToCartInput, j as AddressDetail, A as AddressSuggestion, aj as AddressType, ak as AddressTypes, a3 as AuthTokens, a1 as BackInStockSubscription, al as BadgeTone, a4 as BehioApiError, am as BehioErrorCode, an as BehioEventHandler, ao as BehioEventType, ap as BehioNetworkError, B as BehioStorefrontConfig, G as Bundle, a5 as BundleItem, g as Cart, aq as CartBundleLine, ar as CartBundleLineItem, a6 as CartDiscount, a7 as CartItem, as as CartItemProduct, at as CartPromotion, C as Category, e as CategoryDetail, a8 as CheckoutAddress, w as CheckoutInput, q as CheckoutPaymentMethod, au as CheckoutSettings, _ as CookieConsentInput, I as CrossSellItem, i as CustomerAddress, h as CustomerProfile, av as DataGroupFieldType, aw as DigitalDownload, ax as DownloadUrl, F as FilterField, a9 as FulfillmentStatus, ay as FulfillmentStatuses, K as GiftCardBalance, az as GiftCardPurchaseInput, aA as GiftCardPurchaseResult, aB as GiftCardSummary, aa as LoginInput, aC as LoyaltyBalance, aD as LoyaltyNextTier, aE as LoyaltyProgram, L as LoyaltySummary, aF as LoyaltyTier, aG as LoyaltyTierPerks, aH as LoyaltyTransaction, M as Menu, aI as MenuItem, aJ as MenuItemRef, aK as MenuItemType, ab as MessageResponse, aL as NewsletterOptInDefault, r as NewsletterSubscribeInput, N as NewsletterSubscribeResult, s as NewsletterUnsubscribeResult, u as OrderAccessRequestResponse, v as OrderAccessVerifyResponse, t as OrderDetail, ac as OrderItem, O as OrderListItem, ad as OrderStatus, aM as OrderStatusHistory, aN as OrderStatuses, aO as OrderTracking, y as Page, aP as PageAttachment, x as PageDetail, b as PaginatedResponse, ae as PaymentStatus, aQ as PaymentStatuses, m as PickupPoint, aR as PickupPointHours, l as PickupPointsInput, aS as PriceDisplay, aT as ProductAvailability, aU as ProductCustomField, aV as ProductCustomFieldGroup, d as ProductDetail, H as ProductGroup, f as ProductLabel, c as ProductListItem, aW as ProductMedia, aX as ProductMediaVariant, af as ProductPrice, aY as ProductPromotionSummary, ag as ProductReview, Q as ProductReviewsResponse, aZ as ProductSort, a_ as ProductSortValue, ah as ProductVariant, a$ as ProductVolumePrice, P as ProductsQuery, b0 as QuoteItem, $ as QuoteRequest, R as RegisterInput, b1 as RegisterResult, b2 as RequestInterceptor, b3 as RequestInterceptorConfig, b4 as ResponseInterceptor, b5 as ResponseInterceptorData, X as ReturnRequest, b6 as ReturnRequestItem, V as ReturnStatus, b7 as ReturnStatusItem, U as ReturnableOrder, b8 as ReturnableOrderItem, b9 as SdkError, n as ShippingMethodSummary, p as ShippingQuote, o as ShippingQuoteInput, z as ShopInfo, ba as ShopScript, bb as ShopScriptPlacement, bc as ShopScriptType, D as ShopScripts, E as ShopSeo, bd as ShopSeoIdentity, be as StockBehavior, a0 as SubmitQuoteInput, Y as SubmitReturnInput, T as SubmitReviewInput, S as Subscription, k as SubscriptionAction, bf as SubscriptionFrequency, bg as SubscriptionItem, bh as SubscriptionStatus, bi as TaxBreakdownLine, bj as VariantAxis, bk as VariantAxisValue, W as WishlistItem, bl as err, bm as ok, bn as toSdkError } from './client-DdaC0_6x.js';
 
 /**
  * Format a price amount with currency using Intl.NumberFormat.
@@ -13,20 +14,29 @@ declare function formatPrice(amount: number, currency: string, locale?: string):
 /**
  * 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/>`:
+ * Fires standard GA4 ecommerce/engagement events (view_item, add_to_cart,
+ * begin_checkout, purchase, search, ...) into whatever analytics runtime the
+ * shop has injected via `<StorefrontScripts/>`, and — crucially — into Behio
+ * Analytics via the sink the tracker registers. One call, both systems.
  *
+ * Sinks:
+ * - Behio Analytics (`__behioEcommerceSink`) — always, when the tracker is
+ *   mounted. Records the ORIGINAL event name so Behio-exclusive signals
+ *   (variant_selected, newsletter_signup) stay distinct.
  * - 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
+ *   the consent-gated script never loaded) -> silent no-op for the GA path
+ *
+ * Behio-only signal names that have a GA4 recommended equivalent are remapped
+ * for the GA path only (see `GA4_NAME_MAP`), so merchants keep clean GA4
+ * reports while Behio keeps the richer signal.
  *
  * 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 EcommerceEventName = "view_item" | "view_item_list" | "select_item" | "add_to_cart" | "remove_from_cart" | "view_cart" | "add_to_wishlist" | "view_promotion" | "select_promotion" | "begin_checkout" | "add_payment_info" | "add_shipping_info" | "search" | "generate_lead" | "purchase" | "variant_selected" | "newsletter_signup";
 type EcommerceItem = {
     item_id: string;
     item_name: string;
@@ -34,6 +44,8 @@ type EcommerceItem = {
     quantity?: number;
     item_variant?: string;
     item_category?: string;
+    /** Position in the list (1-based) — for select_item rail/list attribution. */
+    index?: number;
 };
 type EcommercePayload = {
     currency?: string;
@@ -42,8 +54,74 @@ type EcommercePayload = {
     /** Required for `purchase` — the order number. */
     transaction_id?: string;
     shipping?: number;
-    items: EcommerceItem[];
+    /** Optional for non-item events (search, add_shipping_info, newsletter). */
+    items?: EcommerceItem[];
+    /** search event: the query string. */
+    search_term?: string;
+    /** add_shipping_info: the selected shipping method label. */
+    shipping_tier?: string;
+    /** add_payment_info: the selected payment method type. */
+    payment_type?: string;
+    /** view_item_list / select_item: the list id (shop|category|search|rail:*). */
+    item_list_id?: string;
+    /** view_item_list / select_item: human-readable list name. */
+    item_list_name?: string;
+    /**
+     * Behio-only extra props forwarded verbatim into the Behio event `props`
+     * (ignored by GA4). Use for signals GA4 can't model: resultsCount,
+     * zeroResults, variantId, listId, position, source, ...
+     */
+    props?: Record<string, unknown>;
 };
 declare function trackEcommerceEvent(event: EcommerceEventName, payload: EcommercePayload): void;
 
-export { type EcommerceEventName, type EcommerceItem, type EcommercePayload, formatPrice, trackEcommerceEvent };
+/**
+ * Consent-gated visitor identity helpers.
+ *
+ * Behio Analytics has three identity tiers (see BehioAnalyticsTracker):
+ * anonymous (cookieless server hash), consented (persistent behio_visitor_id),
+ * and customer-linked (server stitches at checkout/login). The persistent
+ * `behio_visitor_id` is what unlocks returning-visitor metrics, the customer
+ * journey and Smart Offers.
+ *
+ * Historically the SDK only READ that id and left generation/writing to each
+ * shop's consent banner — so any storefront that forgot the write stayed 100%
+ * anonymous. These helpers move the write into the SDK: the consent banner just
+ * calls `grantAnalyticsConsent(client)` / `revokeAnalyticsConsent(client)` and
+ * everything (id generation, storage, server record, tracker refresh) is
+ * handled here, identically for every template and AI-generated shop.
+ */
+
+/** Read the persistent visitor id (localStorage first, cookie fallback for SSR-set ids). */
+declare function getStoredVisitorId(): string | null;
+/**
+ * Generate a fresh, URL-safe visitor id in the range the ingest DTO accepts
+ * (8..64 chars, [A-Za-z0-9_-]). Uses crypto when available, falling back to
+ * Math.random so it never throws in a locked-down runtime.
+ */
+declare function generateVisitorId(): string;
+/**
+ * Grant analytics consent: ensure a persistent `behio_visitor_id` exists, store
+ * it, record the consent server-side, wire the id into the client (so orders /
+ * logins can be attributed) and notify the tracker to start sending it.
+ *
+ * Returns the visitor id (or an SdkResult error if the server record failed —
+ * the id is still stored locally so tracking works and can retry later).
+ *
+ * @param categories optional marketing/preferences flags (default false); the
+ *                   analytics flag is always true here.
+ */
+declare function grantAnalyticsConsent(client: BehioStorefront, categories?: {
+    marketing?: boolean;
+    preferences?: boolean;
+}): Promise<SdkResult<CookieConsent>>;
+/**
+ * Revoke analytics consent: tell the server, stop sending the id and notify the
+ * tracker. The stored id is kept (consent record now says analytics=false) so a
+ * later re-grant reuses the same visitor rather than fragmenting the journey.
+ */
+declare function revokeAnalyticsConsent(client: BehioStorefront): Promise<SdkResult<{
+    success: boolean;
+}>>;
+
+export { BehioStorefront, CookieConsent, type EcommerceEventName, type EcommerceItem, type EcommercePayload, SdkResult, formatPrice, generateVisitorId, getStoredVisitorId, grantAnalyticsConsent, revokeAnalyticsConsent, trackEcommerceEvent };

package/dist/index.js

@@ -1,11 +1,11 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
 
-var _chunkJIAOZ5YWjs = require('./chunk-JIAOZ5YW.js');
 
 
 
 
+var _chunkCZRSJULDjs = require('./chunk-CZRSJULD.js');
 
 
 
@@ -14,11 +14,11 @@ var _chunkJIAOZ5YWjs = require('./chunk-JIAOZ5YW.js');
 
 
 
-var _chunk5OFVG2BOjs = require('./chunk-5OFVG2BO.js');
 
 
 
 
+var _chunkY4ZCK5HDjs = require('./chunk-Y4ZCK5HD.js');
 
 
 
@@ -29,4 +29,12 @@ var _chunk5OFVG2BOjs = require('./chunk-5OFVG2BO.js');
 
 
 
-exports.AddressTypes = _chunk5OFVG2BOjs.AddressTypes; exports.BehioApiError = _chunk5OFVG2BOjs.BehioApiError; exports.BehioNetworkError = _chunk5OFVG2BOjs.BehioNetworkError; exports.BehioStorefront = _chunk5OFVG2BOjs.BehioStorefront; exports.FulfillmentStatuses = _chunk5OFVG2BOjs.FulfillmentStatuses; exports.OrderStatuses = _chunk5OFVG2BOjs.OrderStatuses; exports.PaymentStatuses = _chunk5OFVG2BOjs.PaymentStatuses; exports.ProductSort = _chunk5OFVG2BOjs.ProductSort; exports.err = _chunk5OFVG2BOjs.err; exports.formatPrice = _chunkJIAOZ5YWjs.formatPrice; exports.ok = _chunk5OFVG2BOjs.ok; exports.toSdkError = _chunk5OFVG2BOjs.toSdkError; exports.trackEcommerceEvent = _chunkJIAOZ5YWjs.trackEcommerceEvent;
+
+
+
+
+
+
+
+
+exports.AddressTypes = _chunkY4ZCK5HDjs.AddressTypes; exports.BehioApiError = _chunkY4ZCK5HDjs.BehioApiError; exports.BehioNetworkError = _chunkY4ZCK5HDjs.BehioNetworkError; exports.BehioStorefront = _chunkY4ZCK5HDjs.BehioStorefront; exports.FulfillmentStatuses = _chunkY4ZCK5HDjs.FulfillmentStatuses; exports.OrderStatuses = _chunkY4ZCK5HDjs.OrderStatuses; exports.PaymentStatuses = _chunkY4ZCK5HDjs.PaymentStatuses; exports.ProductSort = _chunkY4ZCK5HDjs.ProductSort; exports.err = _chunkY4ZCK5HDjs.err; exports.formatPrice = _chunkCZRSJULDjs.formatPrice; exports.generateVisitorId = _chunkCZRSJULDjs.generateVisitorId; exports.getStoredVisitorId = _chunkCZRSJULDjs.getStoredVisitorId; exports.grantAnalyticsConsent = _chunkCZRSJULDjs.grantAnalyticsConsent; exports.ok = _chunkY4ZCK5HDjs.ok; exports.revokeAnalyticsConsent = _chunkCZRSJULDjs.revokeAnalyticsConsent; exports.toSdkError = _chunkY4ZCK5HDjs.toSdkError; exports.trackEcommerceEvent = _chunkCZRSJULDjs.trackEcommerceEvent;

package/dist/index.mjs

@@ -1,7 +1,11 @@
 import {
   formatPrice,
+  generateVisitorId,
+  getStoredVisitorId,
+  grantAnalyticsConsent,
+  revokeAnalyticsConsent,
   trackEcommerceEvent
-} from "./chunk-ZOZAJG6T.mjs";
+} from "./chunk-QUU76QUB.mjs";
 import {
   AddressTypes,
   BehioApiError,
@@ -14,7 +18,7 @@ import {
   err,
   ok,
   toSdkError
-} from "./chunk-Y7QAB75P.mjs";
+} from "./chunk-5KJDVDUM.mjs";
 export {
   AddressTypes,
   BehioApiError,
@@ -26,7 +30,11 @@ export {
   ProductSort,
   err,
   formatPrice,
+  generateVisitorId,
+  getStoredVisitorId,
+  grantAnalyticsConsent,
   ok,
+  revokeAnalyticsConsent,
   toSdkError,
   trackEcommerceEvent
 };

package/dist/next.d.mts

@@ -1,4 +1,4 @@
-import { B as BehioStorefrontConfig, a as BehioStorefront } from './client-BOz1trRk.mjs';
+import { B as BehioStorefrontConfig, a as BehioStorefront } from './client-DdaC0_6x.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-BOz1trRk.js';
+import { B as BehioStorefrontConfig, a as BehioStorefront } from './client-DdaC0_6x.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 _chunk5OFVG2BOjs = require('./chunk-5OFVG2BO.js');
+var _chunkY4ZCK5HDjs = require('./chunk-Y4ZCK5HD.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, _chunk5OFVG2BOjs.BehioStorefront)({
+  const client = new (0, _chunkY4ZCK5HDjs.BehioStorefront)({
     apiKey,
     ...baseUrl ? { baseUrl } : {},
     ...locale ? { locale } : {},

package/dist/next.mjs

@@ -1,6 +1,6 @@
 import {
   BehioStorefront
-} from "./chunk-Y7QAB75P.mjs";
+} from "./chunk-5KJDVDUM.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, M as Menu, f as ProductLabel, F as FilterField, g as Cart, h as CustomerProfile, R as RegisterInput, i as CustomerAddress, A as AddressSuggestion, j as AddressDetail, L as LoyaltySummary, k as PickupPointsInput, l as PickupPoint, N as NewsletterSubscribeResult, m as NewsletterSubscribeInput, n as NewsletterUnsubscribeResult, O as OrderListItem, o as OrderDetail, p as OrderAccessRequestResponse, q as OrderAccessVerifyResponse, r as CheckoutInput, s as PageDetail, t as Page, S as ShopInfo, u as ShopScripts, v as ShopSeo, w as Bundle, x as ProductGroup, y as CrossSellItem, z as ActivePromotion, G as GiftCardBalance, W as WishlistItem, D as ProductReviewsResponse, E as SubmitReviewInput, H as ReturnableOrder, I as ReturnStatus, J as ReturnRequest, K as SubmitReturnInput, Q as CookieConsent, T as CookieConsentInput, U as QuoteRequest, V as SubmitQuoteInput, X as BackInStockSubscription } from './client-BOz1trRk.mjs';
-export { Y as AddToCartInput, Z as AuthTokens, _ as BehioApiError, $ as BundleItem, a0 as CartDiscount, a1 as CartItem, a2 as CheckoutAddress, a3 as FulfillmentStatus, a4 as LoginInput, a5 as MessageResponse, a6 as OrderItem, a7 as OrderStatus, a8 as PaymentStatus, a9 as ProductPrice, aa as ProductReview, ab as ProductVariant } from './client-BOz1trRk.mjs';
+import { a as BehioStorefront, P as ProductsQuery, b as PaginatedResponse, c as ProductListItem, d as ProductDetail, C as Category, e as CategoryDetail, M as Menu, f as ProductLabel, F as FilterField, g as Cart, h as CustomerProfile, R as RegisterInput, i as CustomerAddress, A as AddressSuggestion, j as AddressDetail, L as LoyaltySummary, S as Subscription, k as SubscriptionAction, l as PickupPointsInput, m as PickupPoint, n as ShippingMethodSummary, o as ShippingQuoteInput, p as ShippingQuote, q as CheckoutPaymentMethod, N as NewsletterSubscribeResult, r as NewsletterSubscribeInput, s as NewsletterUnsubscribeResult, O as OrderListItem, t as OrderDetail, u as OrderAccessRequestResponse, v as OrderAccessVerifyResponse, w as CheckoutInput, x as PageDetail, y as Page, z as ShopInfo, D as ShopScripts, E as ShopSeo, G as Bundle, H as ProductGroup, I as CrossSellItem, J as ActivePromotion, K as GiftCardBalance, W as WishlistItem, Q as ProductReviewsResponse, T as SubmitReviewInput, U as ReturnableOrder, V as ReturnStatus, X as ReturnRequest, Y as SubmitReturnInput, Z as CookieConsent, _ as CookieConsentInput, $ as QuoteRequest, a0 as SubmitQuoteInput, a1 as BackInStockSubscription } from './client-DdaC0_6x.mjs';
+export { a2 as AddToCartInput, a3 as AuthTokens, a4 as BehioApiError, a5 as BundleItem, a6 as CartDiscount, a7 as CartItem, a8 as CheckoutAddress, a9 as FulfillmentStatus, aa as LoginInput, ab as MessageResponse, ac as OrderItem, ad as OrderStatus, ae as PaymentStatus, af as ProductPrice, ag as ProductReview, ah as ProductVariant } from './client-DdaC0_6x.mjs';
 import * as _tanstack_query_core from '@tanstack/query-core';
-export { EcommerceEventName, EcommerceItem, EcommercePayload, formatPrice, trackEcommerceEvent } from './index.mjs';
+export { EcommerceEventName, EcommerceItem, EcommercePayload, formatPrice, generateVisitorId, getStoredVisitorId, grantAnalyticsConsent, revokeAnalyticsConsent, trackEcommerceEvent } from './index.mjs';
 
 interface StorageAdapter {
     get(key: string): string | null;
@@ -320,6 +320,30 @@ declare function useLoyalty(options?: UseLoyaltyOptions): {
     refetch: (options?: _tanstack_query_core.RefetchOptions) => Promise<_tanstack_query_core.QueryObserverResult<NoInfer<LoyaltySummary>, Error>>;
 };
 
+interface UseSubscriptionsOptions {
+    enabled?: boolean;
+}
+/**
+ * The logged-in customer's recurring-order subscriptions (GAP-40): products,
+ * cadence, next order date and status, plus pause / resume / cancel actions.
+ * Only runs when a customer is authenticated. Subscriptions are merchant-created
+ * in v1; a storefront self-serve subscribe flow is a follow-up.
+ */
+declare function useSubscriptions(options?: UseSubscriptionsOptions): {
+    subscriptions: Subscription[];
+    isLoading: boolean;
+    error: Error | null;
+    refetch: (options?: _tanstack_query_core.RefetchOptions) => Promise<_tanstack_query_core.QueryObserverResult<NoInfer<{
+        items: Subscription[];
+    }>, Error>>;
+    pause: _tanstack_react_query.UseMutateAsyncFunction<SubscriptionAction, Error, string, unknown>;
+    resume: _tanstack_react_query.UseMutateAsyncFunction<SubscriptionAction, Error, string, unknown>;
+    cancel: _tanstack_react_query.UseMutateAsyncFunction<SubscriptionAction, Error, string, unknown>;
+    isPausing: boolean;
+    isResuming: boolean;
+    isCancelling: boolean;
+};
+
 /**
  * Pickup points (parcel shops / lockers) for a shipping method that supports
  * them (GAP-03). Pass `methodId` and optionally a `query` (name / city / zip)
@@ -337,6 +361,150 @@ declare function usePickupPoints(input: Partial<PickupPointsInput> & {
     }>, Error>>;
 };
 
+interface UseShippingMethodsOptions {
+    /** ISO 4217 code; defaults to the provider / shop currency. */
+    currency?: string;
+    /** ISO 3166-1 alpha-2 destination country to filter methods. */
+    country?: string;
+    /** Cart total for free-shipping / price-tier resolution. */
+    cartTotal?: number;
+    /** Cart weight in kg for weight-tier pricing. */
+    cartWeightKg?: number;
+    enabled?: boolean;
+}
+/**
+ * Merchant shipping methods with resolved fixed prices (GAP-20). Pass the
+ * cart total / weight so tiered and free-shipping rules resolve; methods with
+ * `priceStrategy: "live_quote"` have `price: null` — get a real price via
+ * `useShippingQuote` once a destination address is known.
+ */
+declare function useShippingMethods(options?: UseShippingMethodsOptions): {
+    methods: ShippingMethodSummary[];
+    isLoading: boolean;
+    error: Error | null;
+    refetch: (options?: _tanstack_query_core.RefetchOptions) => Promise<_tanstack_query_core.QueryObserverResult<NoInfer<{
+        items: ShippingMethodSummary[];
+    }>, Error>>;
+};
+
+interface UseShippingQuoteOptions extends Partial<ShippingQuoteInput> {
+    enabled?: boolean;
+}
+/**
+ * Live shipping quote for a destination address (GAP-20). Disabled until the
+ * destination country is known — pass the address as the customer fills the
+ * checkout form and the quote re-resolves automatically. Each returned item
+ * carries `available` + `reason` so the template can grey out methods the
+ * carrier refused to price.
+ */
+declare function useShippingQuote(options?: UseShippingQuoteOptions): {
+    quotes: ShippingQuote[];
+    isLoading: boolean;
+    error: Error | null;
+    refetch: (options?: _tanstack_query_core.RefetchOptions) => Promise<_tanstack_query_core.QueryObserverResult<NoInfer<{
+        items: ShippingQuote[];
+    }>, Error>>;
+};
+
+interface UsePaymentMethodsOptions {
+    /** ISO 4217 code; defaults to the active currency. Methods that do not
+     *  support the currency are filtered out server-side. */
+    currency?: string;
+    enabled?: boolean;
+}
+/**
+ * Merchant payment methods for the checkout (GAP-20). `publicConfig` carries
+ * customer-safe provider hints (e.g. `redirectFlow`, `offline`, bank account
+ * for transfers); `fee` is the optional payment surcharge.
+ */
+declare function usePaymentMethods(options?: UsePaymentMethodsOptions): {
+    methods: CheckoutPaymentMethod[];
+    isLoading: boolean;
+    error: Error | null;
+    refetch: (options?: _tanstack_query_core.RefetchOptions) => Promise<_tanstack_query_core.QueryObserverResult<NoInfer<{
+        items: CheckoutPaymentMethod[];
+    }>, Error>>;
+};
+
+/** One behavioral personal offer (Behio Analytics -> Smart Offers). */
+interface PersonalOffer {
+    id: string;
+    productId: string;
+    percent: number;
+    /** "OFFERED" = code ready; "EMAIL_PENDING" = e-mail gate, claim to reveal. */
+    status: string;
+    code: string | null;
+    /** Epoch ms. */
+    expiresAt: number;
+}
+interface UsePersonalOffersOptions {
+    /**
+     * Consent-gated analytics visitor id. When omitted the hook polls
+     * `client.getAnalyticsVisitorId()` until the tracker resolves consent
+     * (it is null before consent / for opted-out visitors).
+     */
+    visitorId?: string;
+    enabled?: boolean;
+}
+/**
+ * Personal behavioral offers for the current visitor (GAP-20 / GAP-28).
+ * Consent-gated: without an analytics visitor id the hook stays idle and
+ * `offers` is empty, so it is always safe to mount. `claimByEmail` completes
+ * the e-mail gate flow and updates the cached offer with the revealed code.
+ */
+declare function usePersonalOffers(options?: UsePersonalOffersOptions): {
+    offers: PersonalOffer[];
+    /** Resolved consent-gated visitor id (null before consent). */
+    visitorId: string | null;
+    isLoading: boolean;
+    error: Error | null;
+    refetch: (options?: _tanstack_query_core.RefetchOptions) => Promise<_tanstack_query_core.QueryObserverResult<NoInfer<{
+        items: PersonalOffer[];
+    }>, Error>>;
+    /** E-mail gate: trade an e-mail for the discount code of the given offer. */
+    claimByEmail: (offerId: string, email: string) => Promise<{
+        code: string;
+        percent: number;
+        expiresAt: number;
+    }>;
+    isClaiming: boolean;
+    claimError: Error | null;
+};
+
+/** One Behio Analytics ingest event (mirrors the public analytics DTO). */
+interface AnalyticsEventInput {
+    type: "pageview" | "ecommerce" | "custom";
+    name?: string;
+    /** Client event time (epoch ms); defaults server-side to receive time. */
+    ts?: number;
+    path?: string;
+    referrer?: string;
+    utmSource?: string;
+    utmMedium?: string;
+    utmCampaign?: string;
+    dwellMs?: number;
+    value?: number;
+    currency?: string;
+    props?: Record<string, unknown>;
+}
+/**
+ * Thin wrapper over the fire-and-forget Behio Analytics ingest (GAP-20).
+ * Prefer mounting `BehioAnalyticsTracker` (it handles pageviews, consent and
+ * batching for you); use this hook for extra `custom` / `ecommerce` events on
+ * top. The consent-gated visitor id is attached automatically when available;
+ * failures are swallowed — analytics never breaks the shop.
+ */
+declare function useAnalyticsEvents(): {
+    /** Send one or more raw analytics events. */
+    track: (events: AnalyticsEventInput | AnalyticsEventInput[], opts?: {
+        sessionId?: string;
+    }) => Promise<void>;
+    /** Convenience: send a named `custom` event with optional props. */
+    trackEvent: (name: string, props?: Record<string, unknown>) => Promise<void>;
+    /** Consent-gated visitor id, null before analytics consent. */
+    getVisitorId: () => string | null;
+};
+
 /**
  * Subscribe an email to the shop newsletter (first-party opt-in, GAP-08).
  * Use for the footer signup block; the checkout opt-in checkbox goes through
@@ -1113,4 +1281,4 @@ declare function useNotifyWhenAvailable(): _tanstack_react_query.UseMutationResu
  */
 declare function useBehioClient(): BehioStorefront;
 
-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 UseLoyaltyOptions, type UseMenuOptions, 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, useLoyalty, useMenu, useNewsletterSubscribe, useNewsletterUnsubscribe, useNotifyWhenAvailable, useOrder, useOrderAccess, useOrders, usePage, usePages, usePickupPoints, useProduct, useProductGroup, useProductPromotions, useProductReviews, useProducts, useQuoteStatus, useReturnStatus, useSearch, useShopInfo, useShopScripts, useShopSeo, useSubmitQuote, useSubmitReturn, useSubmitReview, useWishlist };
+export { ActivePromotion, type AnalyticsEventInput, 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, type PersonalOffer, 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 UseLoyaltyOptions, type UseMenuOptions, type UseOrderOptions, type UseOrdersOptions, type UsePageOptions, type UsePagesOptions, type UsePaymentMethodsOptions, type UsePersonalOffersOptions, type UseProductOptions, type UseProductsOptions, type UseSearchOptions, type UseShippingMethodsOptions, type UseShippingQuoteOptions, type UseShopInfoOptions, type UseShopScriptsOptions, type UseShopSeoOptions, type UseSubscriptionsOptions, WishlistItem, cookieStorage, createMemoryStorage, detectStorage, localStorageAdapter, memoryStorage, useAddressAutocomplete, useAddresses, useAnalyticsEvents, useAuth, useBehio, useBehioClient, useBundle, useBundles, useCart, useCartCount, useCategories, useCategory, useCheckout, useCookieConsent, useCrossSell, useCurrency, useCustomer, useFeatured, useFilters, useGiftCardBalance, useIsInWishlist, useLabels, useLookupReturnableOrder, useLoyalty, useMenu, useNewsletterSubscribe, useNewsletterUnsubscribe, useNotifyWhenAvailable, useOrder, useOrderAccess, useOrders, usePage, usePages, usePaymentMethods, usePersonalOffers, usePickupPoints, useProduct, useProductGroup, useProductPromotions, useProductReviews, useProducts, useQuoteStatus, useReturnStatus, useSearch, useShippingMethods, useShippingQuote, useShopInfo, useShopScripts, useShopSeo, useSubmitQuote, useSubmitReturn, useSubmitReview, useSubscriptions, useWishlist };