@behio/storefront-sdk 0.32.0 → 0.34.0

package/dist/{client-BOz1trRk.d.ts → client-DdaC0_6x.d.ts}

@@ -100,7 +100,21 @@ interface CheckoutSettings {
     lowStockThreshold: number;
     /** Google Places address autocomplete is enabled; mount the UX when true. */
     addressAutocompleteEnabled: boolean;
+    /**
+     * How prices are presented to the customer (GAP-30):
+     * - `INCL_VAT` (default, B2C): catalog/cart prices already include VAT; the
+     *   VAT breakdown is the portion contained within.
+     * - `EXCL_VAT` (B2B): prices are net; render "bez DPH" labels and show VAT
+     *   added on top.
+     * - `CUSTOMER_CHOICE`: the customer toggles incl/excl.
+     * Pair with per-line `taxRate` + cart/order `taxBreakdown` to render VAT rows.
+     */
+    priceDisplay: PriceDisplay;
+    /** Shop default VAT rate (percent, e.g. 21) for labelling a single-rate cart. */
+    vatRate: number;
 }
+/** Price presentation mode (Eshop.priceDisplay). See `CheckoutSettings.priceDisplay`. */
+type PriceDisplay = "INCL_VAT" | "EXCL_VAT" | "CUSTOMER_CHOICE";
 interface ShopInfo {
     id: string;
     name: string;
@@ -125,6 +139,20 @@ interface ShopInfo {
     quotesEnabled: boolean;
     /** Full merchant checkout & cart contract. Honour these in cart + checkout. */
     checkout: CheckoutSettings;
+    /**
+     * Public shop identity for SEO / structured data (GAP-31). Reads of existing
+     * merchant data — feed into the Organization JSON-LD and degrade gracefully
+     * on nulls. Optional because cached ShopInfo payloads predating the field
+     * may still be served.
+     */
+    seo?: ShopSeoIdentity;
+}
+/** Public shop identity for SEO / structured data (GAP-31). */
+interface ShopSeoIdentity {
+    /** Merchant shop description — Organization JSON-LD `description`. */
+    description: string | null;
+    /** Public contact e-mail (shop e-mail sender config) for ContactPoint. */
+    contactEmail: string | null;
 }
 interface NewsletterSubscribeInput {
     email: string;
@@ -245,7 +273,9 @@ interface ProductVariant {
     /** `null` when prices are gated behind login for guests (B2B mode). */
     price: ProductPrice | null;
     inStock: boolean;
-    stockQuantity?: number;
+    /** Exact remaining stock, or `null` when the merchant hides the count
+     *  (showStockCount off) — treat null as "unknown", never as 0. */
+    stockQuantity?: number | null;
     /** "Only X left" for this variant — same contract as ProductListItem.lowStockRemaining. */
     lowStockRemaining?: number | null;
     /**
@@ -298,7 +328,9 @@ interface ProductListItem {
     /** `null` when prices are gated behind login for guests (B2B mode). */
     price: ProductPrice | null;
     inStock: boolean;
-    stockQuantity?: number;
+    /** Exact remaining stock, or `null` when the merchant hides the count
+     *  (showStockCount off) — treat null as "unknown", never as 0. */
+    stockQuantity?: number | null;
     /**
      * "Zbývá posledních X kusů" nudge, computed SERVER-side. Non-null ONLY when
      * the merchant enabled the low-stock indicator AND 0 < stock <= threshold;
@@ -316,6 +348,57 @@ interface ProductListItem {
     } | null;
     labels: ProductLabel[];
     isFeatured: boolean;
+    /**
+     * Minimum order quantity (units); null/undefined = no minimum. Start the
+     * quantity stepper here — the server rejects add-to-cart / checkout below it.
+     */
+    minOrderQuantity?: number | null;
+    /**
+     * Order quantity step / multiple (units); null/undefined = any quantity. The
+     * stepper moves by this amount and the server rejects non-multiple quantities.
+     */
+    orderQuantityStep?: number | null;
+    /**
+     * Cheapest applicable auto-promotion for this product (GAP-13), or null. Same
+     * priority-based selection the checkout uses, so a card badge matches what the
+     * customer pays. Render a badge chip + a STATIC end date ("do 20. 7.") on
+     * cards; keep the live countdown on the PDP only (no per-card tickers).
+     */
+    activePromotion?: ProductPromotionSummary | null;
+    /**
+     * Rollover image URL for the card (GAP-27), from the product's HOVER-role
+     * image when the merchant set one. Null/absent = no hover image (show the
+     * cover only). Crossfade to it on desktop hover (opacity only, no transform).
+     */
+    hoverImageUrl?: string | null;
+    /**
+     * Aggregate rating from APPROVED reviews (GAP-23): mean 1-5 rating, or null
+     * when the product has no approved reviews. Server-computed + cached. Render
+     * gold stars only when `ratingCount > 0`; do NOT compute this from the
+     * paginated reviews endpoint.
+     */
+    ratingAverage?: number | null;
+    /** Number of approved reviews behind `ratingAverage` (0 when none). */
+    ratingCount?: number;
+    /**
+     * Last modification of the product record (epoch ms) — sitemap `lastmod`
+     * and `dateModified` structured data (GAP-31).
+     */
+    updatedAt?: number;
+}
+/** Display-only summary of the promotion winning for a card (GAP-13). */
+interface ProductPromotionSummary {
+    promotionId: string;
+    /** Merchant badge label ("1+1"); null → render "-{discountValue} %" from the discount. */
+    badgeText: string | null;
+    /** Merchant hex badge color; null falls back to the shop's sale color. */
+    badgeColor: string | null;
+    discountType: 'PERCENTAGE' | 'FIXED_AMOUNT' | 'BUY_X_GET_Y';
+    discountValue: number;
+    /** Promotion end (epoch ms), or null for open-ended. */
+    endsAt: number | null;
+    /** Merchant opted into a countdown (the PDP shows a ticker; cards stay static). */
+    showCountdown: boolean;
 }
 /** A single responsive derivative (size + format) of a media image. */
 interface ProductMediaVariant {
@@ -363,13 +446,39 @@ interface VariantAxis {
     /** Values present among the purchasable variants, in admin-defined order. */
     values: VariantAxisValue[];
 }
+/**
+ * One custom-field (data-group value) rendered as a spec-table row. BOOLEAN
+ * carries a typed `booleanValue` (value is null) so the storefront can localize
+ * Ano/Ne; MONEY carries its currency in `unit`; PERCENTAGE carries "%" in
+ * `unit`.
+ */
+interface ProductCustomField {
+    key: string;
+    name: string;
+    /** TEXT | NUMBER | DECIMAL | BOOLEAN | DATE | TIME | DATETIME | PERCENTAGE | MONEY | ITEM_LIST | ... */
+    type: string;
+    value: string | null;
+    booleanValue: boolean | null;
+    unit: string | null;
+}
+/** A spec-table section (one inventory data group) with its fields. */
+interface ProductCustomFieldGroup {
+    key: string;
+    name: string;
+    fields: ProductCustomField[];
+}
 interface ProductDetail extends ProductListItem {
     longDescription?: string;
-    /** @deprecated Legacy per-listing images. Prefer `media`. */
+    /**
+     * @deprecated Legacy per-listing images. Prefer `media`. Each carries its
+     * `role` (COVER | LISTING | HOVER | GALLERY) so the storefront can pick a
+     * specific image deliberately (GAP-27).
+     */
     images: Array<{
         url: string;
         alt?: string;
         order: number;
+        role?: string;
     }>;
     /** Product gallery (images + videos) with responsive derivatives. */
     media: ProductMedia[];
@@ -385,7 +494,15 @@ interface ProductDetail extends ProductListItem {
      */
     variantAxes: VariantAxis[];
     volumePricing: ProductVolumePrice[];
-    customFields: Record<string, unknown>;
+    /**
+     * Structured product parameters from custom fields (inventory data groups),
+     * grouped into spec-table sections (GAP-12). Empty when the product has no
+     * data-group values. Distinct from `longDescription` (free HTML): this is
+     * machine-readable key/value data for a "Parametry" table + comparison
+     * engines. (Corrected from the old untyped `Record<string, unknown>` — the
+     * API never populated that; it now sends this structured shape.)
+     */
+    customFields: ProductCustomFieldGroup[];
     seo: {
         title?: string | null;
         description?: string | null;
@@ -601,6 +718,12 @@ interface CartItemProduct {
     imageUrl?: string;
     inStock: boolean;
     currentPrice: number;
+    /** Minimum order quantity (units); null = no minimum. Clamp the cart
+     *  stepper's lower bound to this (GAP-48). */
+    minOrderQuantity?: number | null;
+    /** Order quantity step/multiple (units); null = any. Move the cart stepper
+     *  by this amount so quantities stay valid. */
+    orderQuantityStep?: number | null;
 }
 interface CartItem {
     id: string;
@@ -616,6 +739,27 @@ interface CartItem {
     totalPrice: number;
     priceChanged: boolean;
     volumePriceApplied: boolean;
+    /** VAT rate for this line in percent (e.g. 21). Estimated from the shop /
+     *  product rate; refined by the shipping country at checkout (GAP-30). */
+    taxRate: number;
+    /** Net amount for this line (without VAT) = totalPrice. */
+    netAmount: number;
+    /** VAT amount for this line at `taxRate`. */
+    taxAmount: number;
+    /** Gross amount for this line (net + VAT). */
+    grossAmount: number;
+}
+/** One VAT rate's slice of a cart or order (GAP-30). Render "DPH {rate} %:
+ *  {taxAmount}" summary rows from these. `netAmount + taxAmount = grossAmount`. */
+interface TaxBreakdownLine {
+    /** VAT rate in percent, e.g. 21 or 12 or 0. */
+    rate: number;
+    /** Base amount (net, without VAT) taxed at this rate. */
+    netAmount: number;
+    /** VAT amount charged at this rate. */
+    taxAmount: number;
+    /** Gross amount (net + VAT) at this rate. */
+    grossAmount: number;
 }
 interface CartDiscount {
     code: string;
@@ -643,6 +787,12 @@ interface Cart {
     /** Sum of `appliedPromotions[].discountAmount`; already reflected in `grandTotal`. */
     promotionDiscountTotal: number;
     grandTotal: number;
+    /** Total VAT contained in / added to the cart across all lines (GAP-30). An
+     *  estimate finalized at checkout once the shipping country is known. */
+    taxTotal: number;
+    /** VAT split by rate for "DPH 21 %: X Kč" summary rows. Empty for a
+     *  non-VAT-payer shop. */
+    taxBreakdown: TaxBreakdownLine[];
     currency: string;
     itemCount: number;
     /** Applied gift cards (multi). They deduct at checkout (consumed in order, each
@@ -808,6 +958,9 @@ interface OrderDetail extends OrderListItem {
     customerNote?: string;
     subtotal: number;
     taxTotal: number;
+    /** VAT split by rate (GAP-30), summed from the order lines. Render
+     *  "DPH 21 %: X Kč" rows. Empty for a non-VAT order. */
+    taxBreakdown: TaxBreakdownLine[];
     shippingTotal: number;
     discountTotal: number;
     fulfillmentStatus: FulfillmentStatus;
@@ -888,6 +1041,14 @@ interface CustomerProfile {
     lastName?: string;
     phone?: string;
     emailVerified: boolean;
+    /**
+     * B2B approval gate (GAP-19). `false` = the account is awaiting merchant
+     * approval (or was deactivated) — show a "pending approval" banner and gate
+     * ordering. `true` = approved / active. New registrations on a shop with
+     * `requireRegistrationApproval` start unapproved and cannot log in until
+     * approved (register returns `pendingApproval`).
+     */
+    isApproved: boolean;
 }
 interface CustomerAddress {
     id: string;
@@ -906,6 +1067,8 @@ interface Page {
     slug: string;
     title: string;
     isActive: boolean;
+    /** Last modification of the page record (epoch ms) — sitemap `lastmod` (GAP-31). */
+    updatedAt?: number;
 }
 interface PageDetail {
     slug: string;
@@ -1320,6 +1483,46 @@ interface WishlistItem {
     stockCached: number;
     createdAt: number;
 }
+type SubscriptionStatus = "ACTIVE" | "PAUSED" | "CANCELLED" | "EXPIRED" | "PAYMENT_FAILED";
+type SubscriptionFrequency = "WEEKLY" | "BIWEEKLY" | "MONTHLY" | "BIMONTHLY" | "QUARTERLY" | "EVERY_6_MONTHS" | "YEARLY" | "CUSTOM_DAYS";
+interface SubscriptionItem {
+    id: string;
+    productId: string;
+    product: {
+        id: string;
+        slug: string | null;
+    };
+    quantity: number;
+    unitPriceSnapshot: number;
+    currency: string;
+}
+interface Subscription {
+    id: string;
+    status: SubscriptionStatus;
+    frequency: SubscriptionFrequency;
+    /** For CUSTOM_DAYS frequency: order every N days. */
+    customDays: number | null;
+    /** Unix ms of the next scheduled order. */
+    nextOrderAt: number;
+    /** Unix ms of the last generated order, if any. */
+    lastOrderAt: number | null;
+    totalOrders: number;
+    /** Max number of orders before the subscription expires (null = unlimited). */
+    maxOrders: number | null;
+    /** Subscriber discount percent applied to each generated order. */
+    discountPercent: number | null;
+    items: SubscriptionItem[];
+    orderCount: number;
+    createdAt: number;
+    updatedAt: number;
+}
+interface SubscriptionAction {
+    id: string;
+    status: SubscriptionStatus;
+    /** Present after resume — the newly scheduled next order (Unix ms). */
+    nextOrderAt?: number | null;
+    updatedAt: number;
+}
 interface ProductReview {
     id: string;
     authorName: string;
@@ -1523,6 +1726,7 @@ declare class BehioStorefront {
     readonly addresses: AddressModule;
     readonly shipping: ShippingModule;
     readonly newsletter: NewsletterModule;
+    readonly subscriptions: SubscriptionsModule;
     /**
      * Called by the analytics tracker when the visitor grants (id) or revokes
      * (null) analytics consent. When set, requests carry the X-Behio-Vid header
@@ -1550,6 +1754,10 @@ declare class BehioStorefront {
             utmSource?: string;
             utmMedium?: string;
             utmCampaign?: string;
+            utmTerm?: string;
+            utmContent?: string;
+            gclid?: string;
+            fbclid?: string;
             dwellMs?: number;
             value?: number;
             currency?: string;
@@ -1943,6 +2151,24 @@ declare class WishlistModule {
         inWishlist: boolean;
     }>>;
 }
+declare class SubscriptionsModule {
+    private client;
+    constructor(client: BehioStorefront);
+    /**
+     * List the logged-in customer's recurring-order subscriptions (products,
+     * cadence, next order date, status). Requires an authenticated customer
+     * session. Subscriptions are created by the merchant in v1.
+     */
+    list(): Promise<SdkResult<{
+        items: Subscription[];
+    }>>;
+    /** Pause an active subscription (no orders are generated while paused). */
+    pause(subscriptionId: string): Promise<SdkResult<SubscriptionAction>>;
+    /** Resume a paused subscription (re-schedules the next order). */
+    resume(subscriptionId: string): Promise<SdkResult<SubscriptionAction>>;
+    /** Cancel a subscription permanently (no more orders). */
+    cancel(subscriptionId: string): Promise<SdkResult<SubscriptionAction>>;
+}
 declare class ReviewsModule {
     private client;
     constructor(client: BehioStorefront);
@@ -1984,6 +2210,14 @@ declare class QuotesModule {
     /** Email is the ownership gate — quotes carry contact PII and negotiated
      *  prices, so the id alone is never enough. POST keeps it out of URLs. */
     getStatus(quoteId: string, email: string): Promise<SdkResult<QuoteRequest>>;
+    /**
+     * The logged-in customer's own quote requests ("Moje poptávky", GAP-18).
+     * Requires an authenticated session; ownership is the auth token (customer id
+     * + verified email), never a payload. Newest first.
+     */
+    listMine(): Promise<SdkResult<{
+        items: QuoteRequest[];
+    }>>;
 }
 interface AddressSuggestion {
     placeId: string;
@@ -2080,4 +2314,4 @@ declare class NewsletterModule {
     unsubscribe(email: string): Promise<SdkResult<NewsletterUnsubscribeResult>>;
 }
 
-export { type BundleItem as $, type AddressSuggestion as A, type BehioStorefrontConfig as B, type Category as C, type ProductReviewsResponse as D, type SubmitReviewInput as E, type FilterField as F, type GiftCardBalance as G, type ReturnableOrder as H, type ReturnStatus as I, type ReturnRequest as J, type SubmitReturnInput as K, type LoyaltySummary as L, type Menu as M, type NewsletterSubscribeResult as N, type OrderListItem as O, type ProductsQuery as P, type CookieConsent as Q, type RegisterInput as R, type ShopInfo as S, type CookieConsentInput as T, type QuoteRequest as U, type SubmitQuoteInput as V, type WishlistItem as W, type BackInStockSubscription as X, type AddToCartInput as Y, type AuthTokens as Z, BehioApiError as _, BehioStorefront as a, type SdkError as a$, type CartDiscount as a0, type CartItem as a1, type CheckoutAddress as a2, type FulfillmentStatus as a3, type LoginInput as a4, type MessageResponse as a5, type OrderItem as a6, type OrderStatus as a7, type PaymentStatus as a8, type ProductPrice as a9, type LoyaltyTierPerks as aA, type LoyaltyTransaction as aB, type MenuItem as aC, type MenuItemRef as aD, type MenuItemType as aE, type NewsletterOptInDefault as aF, type OrderStatusHistory as aG, OrderStatuses as aH, type OrderTracking as aI, type PageAttachment as aJ, PaymentStatuses as aK, type PickupPointHours as aL, type ProductAvailability as aM, type ProductMedia as aN, type ProductMediaVariant as aO, ProductSort as aP, type ProductSortValue as aQ, type ProductVolumePrice as aR, type QuoteItem as aS, type RegisterResult as aT, type RequestInterceptor as aU, type RequestInterceptorConfig as aV, type ResponseInterceptor as aW, type ResponseInterceptorData as aX, type ReturnRequestItem as aY, type ReturnStatusItem as aZ, type ReturnableOrderItem as a_, type ProductReview as aa, type ProductVariant as ab, type AddressType as ac, AddressTypes as ad, type BadgeTone as ae, type BehioErrorCode as af, type BehioEventHandler as ag, type BehioEventType as ah, BehioNetworkError as ai, type CartBundleLine as aj, type CartBundleLineItem as ak, type CartItemProduct as al, type CartPromotion as am, type CheckoutPaymentMethod as an, type CheckoutSettings as ao, type DataGroupFieldType as ap, type DigitalDownload as aq, type DownloadUrl as ar, FulfillmentStatuses as as, type GiftCardPurchaseInput as at, type GiftCardPurchaseResult as au, type GiftCardSummary as av, type LoyaltyBalance as aw, type LoyaltyNextTier as ax, type LoyaltyProgram as ay, type LoyaltyTier as az, type PaginatedResponse as b, type SdkResult as b0, type ShippingMethodSummary as b1, type ShippingQuote as b2, type ShippingQuoteInput as b3, type ShopScript as b4, type ShopScriptPlacement as b5, type ShopScriptType as b6, type StockBehavior as b7, type VariantAxis as b8, type VariantAxisValue as b9, err as ba, ok as bb, toSdkError as bc, type ProductListItem as c, type ProductDetail as d, type CategoryDetail as e, type ProductLabel as f, type Cart as g, type CustomerProfile as h, type CustomerAddress as i, type AddressDetail as j, type PickupPointsInput as k, type PickupPoint as l, type NewsletterSubscribeInput as m, type NewsletterUnsubscribeResult as n, type OrderDetail as o, type OrderAccessRequestResponse as p, type OrderAccessVerifyResponse as q, type CheckoutInput as r, type PageDetail as s, type Page as t, type ShopScripts as u, type ShopSeo as v, type Bundle as w, type ProductGroup as x, type CrossSellItem as y, type ActivePromotion as z };
+export { type QuoteRequest as $, type AddressSuggestion as A, type BehioStorefrontConfig as B, type Category as C, type ShopScripts as D, type ShopSeo as E, type FilterField as F, type Bundle as G, type ProductGroup as H, type CrossSellItem as I, type ActivePromotion as J, type GiftCardBalance as K, type LoyaltySummary as L, type Menu as M, type NewsletterSubscribeResult as N, type OrderListItem as O, type ProductsQuery as P, type ProductReviewsResponse as Q, type RegisterInput as R, type Subscription as S, type SubmitReviewInput as T, type ReturnableOrder as U, type ReturnStatus as V, type WishlistItem as W, type ReturnRequest as X, type SubmitReturnInput as Y, type CookieConsent as Z, type CookieConsentInput as _, BehioStorefront as a, type ProductVolumePrice as a$, type SubmitQuoteInput as a0, type BackInStockSubscription as a1, type AddToCartInput as a2, type AuthTokens as a3, BehioApiError as a4, type BundleItem as a5, type CartDiscount as a6, type CartItem as a7, type CheckoutAddress as a8, type FulfillmentStatus as a9, type GiftCardPurchaseResult as aA, type GiftCardSummary as aB, type LoyaltyBalance as aC, type LoyaltyNextTier as aD, type LoyaltyProgram as aE, type LoyaltyTier as aF, type LoyaltyTierPerks as aG, type LoyaltyTransaction as aH, type MenuItem as aI, type MenuItemRef as aJ, type MenuItemType as aK, type NewsletterOptInDefault as aL, type OrderStatusHistory as aM, OrderStatuses as aN, type OrderTracking as aO, type PageAttachment as aP, PaymentStatuses as aQ, type PickupPointHours as aR, type PriceDisplay as aS, type ProductAvailability as aT, type ProductCustomField as aU, type ProductCustomFieldGroup as aV, type ProductMedia as aW, type ProductMediaVariant as aX, type ProductPromotionSummary as aY, ProductSort as aZ, type ProductSortValue as a_, type LoginInput as aa, type MessageResponse as ab, type OrderItem as ac, type OrderStatus as ad, type PaymentStatus as ae, type ProductPrice as af, type ProductReview as ag, type ProductVariant as ah, type SdkResult as ai, type AddressType as aj, AddressTypes as ak, type BadgeTone as al, type BehioErrorCode as am, type BehioEventHandler as an, type BehioEventType as ao, BehioNetworkError as ap, type CartBundleLine as aq, type CartBundleLineItem as ar, type CartItemProduct as as, type CartPromotion as at, type CheckoutSettings as au, type DataGroupFieldType as av, type DigitalDownload as aw, type DownloadUrl as ax, FulfillmentStatuses as ay, type GiftCardPurchaseInput as az, type PaginatedResponse as b, type QuoteItem as b0, type RegisterResult as b1, type RequestInterceptor as b2, type RequestInterceptorConfig as b3, type ResponseInterceptor as b4, type ResponseInterceptorData as b5, type ReturnRequestItem as b6, type ReturnStatusItem as b7, type ReturnableOrderItem as b8, type SdkError as b9, type ShopScript as ba, type ShopScriptPlacement as bb, type ShopScriptType as bc, type ShopSeoIdentity as bd, type StockBehavior as be, type SubscriptionFrequency as bf, type SubscriptionItem as bg, type SubscriptionStatus as bh, type TaxBreakdownLine as bi, type VariantAxis as bj, type VariantAxisValue as bk, err as bl, ok as bm, toSdkError as bn, type ProductListItem as c, type ProductDetail as d, type CategoryDetail as e, type ProductLabel as f, type Cart as g, type CustomerProfile as h, type CustomerAddress as i, type AddressDetail as j, type SubscriptionAction as k, type PickupPointsInput as l, type PickupPoint as m, type ShippingMethodSummary as n, type ShippingQuoteInput as o, type ShippingQuote as p, type CheckoutPaymentMethod as q, type NewsletterSubscribeInput as r, type NewsletterUnsubscribeResult as s, type OrderDetail as t, type OrderAccessRequestResponse as u, type OrderAccessVerifyResponse as v, type CheckoutInput as w, type PageDetail as x, type Page as y, type ShopInfo as z };

package/dist/index.d.mts

@@ -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.mjs';
+import { a as BehioStorefront, ai as SdkResult, Z as CookieConsent } from './client-DdaC0_6x.mjs';
+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.mjs';
 
 /**
  * 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 };