@behio/storefront-sdk 0.32.0 → 0.33.0

package/dist/react.d.mts

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

package/dist/react.d.ts

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