@behio/storefront-sdk 1.18.0 → 2.0.0

package/dist/react.d.mts

@@ -71,6 +71,8 @@ interface BehioStorefrontConfig {
     locale?: string;
     /** Default currency for price resolution. Default: none (uses shop default) */
     currency?: string;
+    /** Default delivery country (ISO-2) for catalog price rules. Does not mutate the cart. */
+    country?: string;
     /** Custom fetch implementation (for Node.js < 18 or testing) */
     fetch?: typeof fetch;
     /**
@@ -134,6 +136,14 @@ type StockMode = "TRACKED" | "ALWAYS_AVAILABLE" | "MADE_TO_ORDER";
  * progress) rather than a security boundary.
  */
 interface CheckoutSettings {
+    /** Single page or address / delivery / confirmation steps. Missing = SINGLE_PAGE. */
+    checkoutLayout?: "SINGLE_PAGE" | "STEP_BY_STEP";
+    /** Hide the optional subtotal/tax/discount breakdown, never the payable total. */
+    showCartPriceBreakdown?: boolean;
+    /** Show a delivery estimate only if the selected method supplies one. */
+    showEstimatedDelivery?: boolean;
+    /** Merchant's plain-text order confirmation message. */
+    orderConfirmationText?: string | null;
     /** Guests may order without an account (also on ShopInfo for back-compat). */
     allowGuestCheckout: boolean;
     /** Checkout requires a logged-in / registered account. */
@@ -181,8 +191,10 @@ interface CheckoutSettings {
      *   them as sold out with the buy button disabled.
      * - `SHOW_SOLD_OUT`: sold-out products render with a "Vyprodáno" state and
      *   a disabled buy button; the API rejects over-stock adds with a 400.
-     * - `BACKORDER`: out-of-stock products stay purchasable (any quantity);
-     *   render "Na objednávku" instead of disabling the button.
+     * - `BACKORDER`: follow `isPurchasable`; the merchant can cap negative stock
+     *   with a positive safetyStock allowance. Zero keeps backorders unlimited.
+     *   The cart validates ordinary and bundled quantities together and returns
+     *   quantityControls for accepted repair/increase targets.
      * For HIDE/SHOW_SOLD_OUT cap quantity steppers at `stockQuantity` — the
      * cart API 400s on anything above it.
      */
@@ -214,7 +226,20 @@ interface CheckoutSettings {
 }
 /** Price presentation mode (Eshop.priceDisplay). See `CheckoutSettings.priceDisplay`. */
 type PriceDisplay = "INCL_VAT" | "EXCL_VAT" | "CUSTOMER_CHOICE";
+type CurrencyDisplayFormat = "SYMBOL_BEFORE" | "SYMBOL_AFTER" | "CODE";
 interface ShopInfo {
+    currencyDisplayFormat?: CurrencyDisplayFormat;
+    account?: {
+        passwordMinLength: number;
+        requireEmailVerification: boolean;
+    };
+    /** Admin overrides take precedence over template tokens; null inherits them. */
+    appearance?: ShopAppearance;
+    /** Separate from isActive. Explicit maintenance applies to preview shops too. */
+    maintenance?: {
+        enabled: boolean;
+        message: string | null;
+    };
     id: string;
     name: string;
     domain: string;
@@ -261,6 +286,15 @@ interface ShopInfo {
      */
     seo?: ShopSeoIdentity;
 }
+interface ShopAppearance {
+    primaryColor: string | null;
+    secondaryColor: string | null;
+    /** CSS family list. Templates validate syntax and retain local fallbacks. */
+    fontFamily: string | null;
+    /** CSS only. Escape raw-text closing tags when embedding in a style element. */
+    customCss: string | null;
+    showPoweredBy: boolean;
+}
 /** Public shop identity for SEO / structured data (GAP-31). */
 interface ShopSeoIdentity {
     /** Merchant shop description — Organization JSON-LD `description`. */
@@ -286,6 +320,8 @@ interface NewsletterUnsubscribeResult {
     success: boolean;
 }
 interface ShopSeo {
+    robotsTxt?: string | null;
+    googleSiteVerification?: string | null;
     locale: string;
     title: string | null;
     description: string | null;
@@ -412,7 +448,16 @@ interface ProductVariant {
      * the chosen variant.
      */
     id: string;
+    /** Public supporting files/media of this variant; no paid download URLs. */
+    assetGroups?: ProductAssetGroup[];
+    /** Approved reviews of this exact sellable listing. */
+    ratingAverage?: number | null;
+    ratingCount?: number;
+    requiresShipping?: boolean;
+    isDigital?: boolean;
     sku: string;
+    /** Barcode of this sellable variant; never inherit the parent barcode. */
+    gtin?: string | null;
     /**
      * Variant name in the requested locale. Before SDK 1.1.0 this was always the
      * warehouse item name, so translated shops showed one language to everyone.
@@ -447,6 +492,8 @@ interface ProductVariant {
      * Added in SDK 1.1.0.
      */
     images: ProductDetail["images"];
+    /** Own image/video gallery. Empty means inherit the parent gallery. */
+    media?: ProductMedia[];
     /**
      * Per-variant SEO/OG overrides, or `null` when the merchant wrote none. The
      * canonical URL stays the parent's, so use these only when a variant is
@@ -474,6 +521,16 @@ interface ProductVariant {
     /** `null` when prices are gated behind login for guests (B2B mode). */
     price: ProductPrice | null;
     inStock: boolean;
+    /** Own sale window and stock policy. Never infer eligibility from price. */
+    isPurchasable?: boolean;
+    availability?: ProductAvailability;
+    /** Own purchase rules; null means no constraint, not inheritance. */
+    minOrderQuantity?: number | null;
+    orderQuantityStep?: number | null;
+    saleStartAt?: number | null;
+    saleEndAt?: number | null;
+    /** This variant's quantity tiers in the requested currency. Empty for gated guests. */
+    volumePricing?: ProductVolumePrice[];
     /** Exact remaining stock, or `null` when the merchant hides the count
      *  (showStockCount off) — treat null as "unknown", never as 0. */
     stockQuantity?: number | null;
@@ -880,6 +937,8 @@ interface ProductDetail extends ProductListItem {
          * indexing = PARENT_PAGE). Added in SDK 1.4.0.
          */
         canonicalSlug?: string | null;
+        /** Actual canonical translations, for hreflang and locale navigation. */
+        localizedSlugs?: Record<string, string>;
         /**
          * `true` = render `noindex, follow`. Set on a parent product that colour
          * cards have taken over, so it stops competing with its own cards.
@@ -907,6 +966,8 @@ interface ProductDetail extends ProductListItem {
      * active digital asset (PDF, MP3, ...) delivered instantly after purchase.
      */
     isDigital?: boolean;
+    /** Independent of attached digital content. */
+    requiresShipping?: boolean;
 }
 interface Category {
     id: string;
@@ -1167,6 +1228,27 @@ interface AuthTokens {
     accessToken: string;
     refreshToken: string;
 }
+/** Checkout-only response. The guest token reads exactly the newly created order
+ * for 30 minutes. Keep it out of URLs and analytics; prefer an HttpOnly cookie. */
+interface CheckoutPreview {
+    currency: string;
+    subtotal: number;
+    taxTotal: number;
+    shippingTotal: number;
+    paymentFee: number;
+    /** Includes loyaltyDiscount and giftCardDeducted; do not subtract them twice. */
+    discountTotal: number;
+    loyaltyPointsUsed: number;
+    loyaltyDiscount: number;
+    giftCardDeducted: number;
+    roundingAdjustment: number;
+    grandTotal: number;
+    previewToken: string;
+    expiresAt: number;
+}
+interface CheckoutResult extends OrderDetail {
+    orderAccessToken?: string | null;
+}
 /**
  * Result of a registration. When the eshop requires admin approval,
  * `pendingApproval` is true and the tokens are null (the account is created but
@@ -1175,6 +1257,8 @@ interface AuthTokens {
  */
 interface RegisterResult {
     pendingApproval: boolean;
+    /** Account created, but no session until the e-mail link is verified. */
+    pendingEmailVerification?: boolean;
     accessToken: string | null;
     refreshToken: string | null;
 }
@@ -1183,6 +1267,18 @@ interface RegisterInput {
     password: string;
     firstName?: string;
     lastName?: string;
+    /** B2B sign-up: company name. */
+    company?: string;
+    /** Company registration number. */
+    companyId?: string;
+    /**
+     * VAT ID. EU numbers are verified in VIES on the server; a confirmed one
+     * creates a default billing address and can auto-join the merchant's
+     * "EU companies" customer group.
+     */
+    vatId?: string;
+    /** ISO-2 country of the company (VIES fallback when `vatId` has no prefix). */
+    country?: string;
 }
 interface LoginInput {
     email: string;
@@ -1209,7 +1305,7 @@ interface CartItemProduct {
     sku: string;
     imageUrl?: string;
     inStock: boolean;
-    currentPrice: number;
+    currentPrice: number | null;
     /** Minimum order quantity (units); null = no minimum. Clamp the cart
      *  stepper's lower bound to this (GAP-48). */
     minOrderQuantity?: number | null;
@@ -1219,6 +1315,14 @@ interface CartItemProduct {
 }
 interface CartItem {
     id: string;
+    /** A retained row can be unavailable after the merchant changes its offer. */
+    isPurchasable: boolean;
+    unavailableReason: "CURRENCY_UNAVAILABLE" | "ITEM_UNAVAILABLE" | "QUANTITY_UNAVAILABLE" | null;
+    /** Valid adjacent line quantities, including units in bundles. Older servers omit it. */
+    quantityControls?: {
+        decreaseTo: number | null;
+        increaseTo: number | null;
+    };
     /**
      * Eshop product ID of the sellable unit on this line. A variant is its own
      * product, so this is the exact product/variant the customer added — use it
@@ -1227,19 +1331,19 @@ interface CartItem {
     productId: string;
     product: CartItemProduct;
     quantity: number;
-    unitPrice: number;
-    totalPrice: number;
+    unitPrice: number | null;
+    totalPrice: number | null;
     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;
+    netAmount: number | null;
     /** VAT amount for this line at `taxRate`. */
-    taxAmount: number;
+    taxAmount: number | null;
     /** Gross amount for this line (net + VAT). */
-    grossAmount: number;
+    grossAmount: number | null;
 }
 /** One VAT rate's slice of a cart or order (GAP-30). Render "DPH {rate} %:
  *  {taxAmount}" summary rows from these. `netAmount + taxAmount = grossAmount`. */
@@ -1268,6 +1372,19 @@ interface CartPromotion {
     discountAmount: number;
 }
 interface Cart {
+    /** Hide payable amounts and block checkout while an unavailable line remains. */
+    totalsAvailable: boolean;
+    /** Physical delivery required by any cart or bundle product. Assume true when omitted by older APIs. */
+    requiresShipping?: boolean;
+    /** Delivery threshold basis after product promotions and before order coupons/loyalty/gift cards, in displayed price mode and cart currency. Includes bundles. */
+    shippingSubtotal?: number;
+    /** A currently applicable FREE_SHIPPING promotion waives delivery at checkout. */
+    shippingPromotionApplied?: boolean;
+    /** Authoritative admin limits converted to cart currency. Compare subtotal before shipping/codes. */
+    checkoutLimits?: {
+        minOrderValue: number | null;
+        maxOrderValue: number | null;
+    };
     id: string;
     sessionToken?: string;
     items: CartItem[];
@@ -1337,8 +1454,20 @@ interface CartBundleLine {
     bundleSlug: string;
     bundleName: string;
     quantity: number;
-    /** Snapshot of the bundle's per-unit price when it was added. */
-    bundlePriceSnapshot: number;
+    /** Current per-unit offer in cart currency; the API keeps this legacy name.
+     * Reading the cart does not rewrite stored cart/order snapshots. */
+    bundlePriceSnapshot: number | null;
+    isPurchasable: boolean;
+    unavailableReason: "CURRENCY_UNAVAILABLE" | "OFFER_UNAVAILABLE" | "QUANTITY_UNAVAILABLE" | "ITEM_UNAVAILABLE" | null;
+    priceChanged: boolean;
+    /** Adjacent valid quantities across every component, other cart line and shared stock. Older servers omit this field. */
+    quantityControls?: {
+        decreaseTo: number | null;
+        increaseTo: number | null;
+    };
+    minQuantity: number;
+    maxQuantity: number | null;
+    remainingStock: number | null;
     currency: string;
     items: CartBundleLineItem[];
 }
@@ -1376,13 +1505,15 @@ interface CheckoutAddress {
     phone?: string;
 }
 interface CheckoutInput {
+    /** Five-minute token from checkout.preview; stale prices or choices fail closed. */
+    previewToken?: string;
     /**
      * Consent-gated Behio Analytics visitor id (behio_visitor_id). Optional;
      * lets the backend attribute the order to the visitor journey. Send it only
      * when the visitor granted analytics consent.
      */
     analyticsVisitorId?: string;
-    shippingAddress: CheckoutAddress;
+    shippingAddress?: CheckoutAddress;
     billingAddress: CheckoutAddress;
     email: string;
     phone?: string;
@@ -1506,6 +1637,10 @@ interface OrderStatusHistory {
     createdAt: number;
 }
 interface OrderDetail extends OrderListItem {
+    /** Payment is recorded; access delivery will retry automatically. Do not place a duplicate order. */
+    contentDeliveryPending?: boolean;
+    /** False for an order without physical delivery. */
+    requiresShipping?: boolean;
     items: OrderItem[];
     shippingAddress: CheckoutAddress;
     billingAddress: CheckoutAddress;
@@ -1520,6 +1655,10 @@ interface OrderDetail extends OrderListItem {
     /** DOMESTIC, OSS, REVERSE_CHARGE (no VAT, buyer accounts for it) or EXPORT (no VAT, outside EU). SDK 1.17.0. */
     vatMode?: "DOMESTIC" | "OSS" | "REVERSE_CHARGE" | "EXPORT" | null;
     shippingTotal: number;
+    paymentFee?: number | null;
+    roundingAdjustment?: number | null;
+    loyaltyDiscount?: number | null;
+    giftCardDeducted?: number | null;
     discountTotal: number;
     fulfillmentStatus: FulfillmentStatus;
     statusHistory: OrderStatusHistory[];
@@ -1558,6 +1697,8 @@ interface OrderAccessVerifyResponse {
  * (null = unlimited), optional `expiresAt`.
  */
 interface DigitalDownload {
+    /** Asset disabled or order no longer grants access. */
+    isRevoked?: boolean;
     id: string;
     /** Order this grant originates from (null for legacy/manual grants). */
     orderId: string | null;
@@ -1601,6 +1742,8 @@ interface CourseListItem {
     /** Access expiry (epoch ms, null = never expires). */
     expiresAt: number | null;
     isExpired: boolean;
+    /** Access was withdrawn; another paid, unexpired purchase keeps access active. */
+    isRevoked?: boolean;
     /**
      * Course content opens at this time (epoch ms); null/undefined = already
      * open. While in the future, render "Startujeme ..." + countdown.
@@ -2137,6 +2280,11 @@ interface ProductGroup {
     description: string | null;
     items: ProductListItem[];
 }
+interface BundleCatalogQuery {
+    locale?: string;
+    currency?: string;
+    country?: string;
+}
 interface BundleItem {
     productId: string;
     slug: string | null;
@@ -2151,17 +2299,30 @@ interface Bundle {
     slug: string;
     name: string;
     description: string | null;
-    /** `null` when the eshop hides prices from guests and this visitor has no price entitlement. */
+    /** `null` when prices are hidden or the bundle has no active offer in the requested currency. */
     bundlePrice: number | null;
+    /** Requested currency. Only explicitly active bundle prices are purchasable. */
     currency: string;
+    priceHidden: boolean;
+    isPurchasable: boolean;
+    unavailableReason: "PRICE_HIDDEN" | "CURRENCY_UNAVAILABLE" | "QUANTITY_UNAVAILABLE" | "ITEM_UNAVAILABLE" | null;
+    activeCurrencies: string[];
     coverImage: string | null;
     endsAt: number | null;
-    /** `null` when prices are hidden (see `bundlePrice`). */
+    /** `null` when any component has no comparable price in the requested currency, or prices are hidden. */
     itemsSum: number | null;
-    /** Absolute saving vs buying the components separately, in `currency`. `null` when prices are hidden. */
+    /** Absolute saving vs buying the components separately, in `currency`. `null` when the offer or any comparable component price is unavailable. */
     savings: number | null;
-    /** Percentage saving, 0–100. 0 when `itemsSum` is zero. `null` when prices are hidden. */
+    /** Percentage saving, 0–100. 0 when `itemsSum` is zero. `null` when the offer or any comparable component price is unavailable. */
     savingsPercent: number | null;
+    /** Valid additional quantities for the current basket; null means no compatible range.
+     * Hidden inventory counts do not appear as a numerical stock ceiling.
+     * Send the current cart session. A stale offer is still rechecked on mutation. */
+    quantityRules?: {
+        minimum: number;
+        maximum: number | null;
+        step: number;
+    } | null;
     /** Minimum bundles per order. Default 1. */
     minQuantity: number;
     /** Maximum bundles per order. `null` = uncapped. */
@@ -2221,6 +2382,12 @@ interface ShippingQuoteInput {
         quantity: number;
         weightKg?: number;
     }>;
+    /**
+     * @deprecated Ignored by the API. The free-shipping threshold is computed
+     * from the visitor's cart (the `X-Cart-Session` the client already sends)
+     * or from `items`; a client-supplied total was never trusted. Kept only so
+     * existing storefronts keep compiling.
+     */
     cartTotal?: number;
     currency?: string;
 }
@@ -2364,14 +2531,17 @@ interface CrossSellItem {
     /** Price in the requested currency (or eshop default), including any price
      * list override for the authenticated customer. `null` when hidden (B2B). */
     price: number | null;
+    /** Render priceFrom with an "from" label for a variant-only family. */
+    variantsOnly?: boolean;
+    priceFrom?: ProductPrice | null;
     /** Original (crossed-out) price in the same currency, when on sale. */
     compareAtPrice: number | null;
     /** Currency code the `price` / `compareAtPrice` are expressed in. */
     currency: string;
     imageUrl: string | null;
-    /** Cached stock quantity of the recommended product. */
-    stockCached: number;
-    /** Convenience flag: `stockCached > 0`. */
+    /** Selected-warehouse quantity; null when the merchant hides exact stock. */
+    stockCached: number | null;
+    /** Availability follows the shop's stock mode and published variants. */
     inStock: boolean;
     /** Merchant-editable note ("proč se to hodí") resolved for the requested
      * locale (falls back to the eshop default language). `null` when unset. */
@@ -2645,6 +2815,8 @@ interface SubmitQuoteInput {
 }
 /** One URL for the sitemap. Added in SDK 1.4.0. */
 interface SitemapEntry {
+    /** Actual translated slugs in enabled languages. Never reuse one locale slug for all URLs. */
+    localizedSlugs?: Record<string, string>;
     /** Slug without any prefix; the template builds the path. */
     slug: string;
     /** Last change (epoch ms) for `lastmod`. */
@@ -2833,6 +3005,10 @@ declare class BehioStorefront {
     setCurrency(currency: string | undefined): void;
     /** Get the current default currency, if any. */
     getCurrency(): string | undefined;
+    private defaultCountry?;
+    /** Set the catalog's delivery country. Use cart.setDestination separately for the cart. */
+    setCountry(country: string | undefined): void;
+    getCountry(): string | undefined;
     /** Set the default locale sent on every catalog request (per-call wins). */
     setLocale(locale: string | undefined): void;
     /** Get the current default locale, if any. */
@@ -2921,6 +3097,7 @@ declare class CatalogModule {
     getFeatured(options?: {
         locale?: string;
         currency?: string;
+        country?: string;
     }): Promise<SdkResult<PaginatedResponse<ProductListItem>>>;
     /**
      * Available filters for a dynamic filter UI.
@@ -2968,11 +3145,11 @@ declare class CatalogModule {
         limit?: number;
     }): Promise<SdkResult<PaginatedResponse<ProductListItem>>>;
     /** List all active bundles */
-    getBundles(): Promise<SdkResult<{
+    getBundles(options?: BundleCatalogQuery): Promise<SdkResult<{
         items: Bundle[];
     }>>;
     /** Get a single bundle by slug */
-    getBundle(slug: string): Promise<SdkResult<Bundle>>;
+    getBundle(slug: string, options?: BundleCatalogQuery): Promise<SdkResult<Bundle>>;
     /**
      * One product group ("collection") by slug with its products as standard
      * list items. Groups are curated in the admin; use this to render curated
@@ -2982,6 +3159,7 @@ declare class CatalogModule {
     getProductGroup(slug: string, options?: {
         locale?: string;
         currency?: string;
+        country?: string;
     }): Promise<SdkResult<ProductGroup>>;
     /**
      * Cross-sell / related / upsell products for a product. Returns three
@@ -2993,6 +3171,7 @@ declare class CatalogModule {
     getCrossSell(productSlug: string, options?: {
         locale?: string;
         currency?: string;
+        country?: string;
     }): Promise<SdkResult<{
         related: CrossSellItem[];
         upsell: CrossSellItem[];
@@ -3128,10 +3307,10 @@ declare class CartModule {
     } | {
         slug: string;
     }, quantity?: number): Promise<SdkResult<Cart>>;
-    /** Update quantity of a bundle already in the cart */
-    updateBundleQuantity(bundleId: string, quantity: number): Promise<SdkResult<Cart>>;
-    /** Remove a bundle from the cart */
-    removeBundle(bundleId: string): Promise<SdkResult<Cart>>;
+    /** Update by CartBundleLine.id; legacy catalog bundle IDs are accepted by the API */
+    updateBundleQuantity(lineId: string, quantity: number): Promise<SdkResult<Cart>>;
+    /** Remove by CartBundleLine.id; scoped to the current visitor cart */
+    removeBundle(lineId: string): Promise<SdkResult<Cart>>;
     /** Merge anonymous cart into authenticated customer cart */
     merge(): Promise<SdkResult<Cart>>;
     /** Apply discount code */
@@ -3142,8 +3321,12 @@ declare class CartModule {
 declare class CheckoutModule {
     private client;
     constructor(client: BehioStorefront);
+    /** Recalculate the current cart including shipping, fees, benefits and rounding.
+     * No order, stock claim, payment or gift-card redemption is created. Required
+     * legal consents are enforced only on createOrder, not while quoting. */
+    preview(input: CheckoutInput): Promise<SdkResult<CheckoutPreview>>;
     /** Create order from cart */
-    createOrder(input: CheckoutInput): Promise<SdkResult<OrderDetail>>;
+    createOrder(input: CheckoutInput): Promise<SdkResult<CheckoutResult>>;
 }
 declare class OrdersModule {
     private client;
@@ -3565,6 +3748,8 @@ declare class NewsletterModule {
 interface BehioContextValue {
     client: BehioStorefront;
     storage: StorageAdapter;
+    /** Browser storage has been restored; server-rendered query data is usable before this. */
+    sessionRestored: boolean;
     /**
      * The shopper's actively selected currency, or undefined when none has been
      * chosen (the shop's default currency is used server-side). This is sent on
@@ -4335,10 +4520,19 @@ declare function useOrderAccess(): {
 };
 
 declare function useCheckout(): {
-    createOrder: (input: CheckoutInput) => Promise<OrderDetail>;
+    createOrder: (input: CheckoutInput) => Promise<CheckoutResult>;
     isCreating: boolean;
     error: Error | null;
-    order: OrderDetail | null;
+    order: CheckoutResult | null;
+    reset: () => void;
+};
+/** A preview is transient, never cached by cart ID or reused after input edits.
+ * On expiry/change request another preview and ask the shopper to review it. */
+declare function useCheckoutPreview(): {
+    preview: _tanstack_react_query.UseMutateAsyncFunction<CheckoutPreview, Error, CheckoutInput, unknown>;
+    data: CheckoutPreview | undefined;
+    isPreviewing: boolean;
+    error: Error | null;
     reset: () => void;
 };
 
@@ -4407,6 +4601,7 @@ declare function useShopInfo(options?: UseShopInfoOptions): _tanstack_react_quer
 
 interface UseShopScriptsOptions {
     enabled?: boolean;
+    initialData?: ShopScripts;
 }
 /**
  * Fetch the merchant-defined storefront scripts (analytics, pixels, custom
@@ -4506,6 +4701,8 @@ interface CurrencySwitcherProps {
 declare function CurrencySwitcher({ className, labels, showWhenSingle, ariaLabel, children, }: CurrencySwitcherProps): react_jsx_runtime.JSX.Element | null;
 
 interface StorefrontScriptsProps {
+    /** Server-loaded settings: avoids fetching our own database after hydration. */
+    initialScripts?: ShopScript[];
     /** Override the visitor id; defaults to the `behio_visitor_id` localStorage value. */
     visitorId?: string;
 }
@@ -4516,7 +4713,7 @@ interface StorefrontScriptsProps {
  * analytics cookie consent; the rest are injected on mount. Mount once in the
  * root layout, inside the BehioProvider.
  */
-declare function StorefrontScripts({ visitorId: visitorIdProp }?: StorefrontScriptsProps): null;
+declare function StorefrontScripts({ visitorId: visitorIdProp, initialScripts }?: StorefrontScriptsProps): null;
 
 /**
  * Behio Analytics auto-tracker. Mount ONCE in the root layout (next to
@@ -4540,7 +4737,7 @@ declare function StorefrontScripts({ visitorId: visitorIdProp }?: StorefrontScri
 declare function BehioAnalyticsTracker(): null;
 
 /** List all active bundles. */
-declare function useBundles(options?: {
+declare function useBundles(options?: BundleCatalogQuery & {
     enabled?: boolean;
     initialData?: {
         items: Bundle[];
@@ -4549,7 +4746,7 @@ declare function useBundles(options?: {
     items: Bundle[];
 }>, Error>;
 /** Get a single bundle by slug. */
-declare function useBundle(slug: string | undefined, options?: {
+declare function useBundle(slug: string | undefined, options?: BundleCatalogQuery & {
     enabled?: boolean;
     initialData?: Bundle;
 }): _tanstack_react_query.UseQueryResult<NoInfer<Bundle>, Error>;
@@ -4855,6 +5052,7 @@ declare function useProductReviews(productId: string | undefined, options?: {
     page?: number;
     limit?: number;
     enabled?: boolean;
+    initialData?: ProductReviewsResponse;
 }): _tanstack_react_query.UseQueryResult<NoInfer<ProductReviewsResponse>, Error>;
 declare function useSubmitReview(): _tanstack_react_query.UseMutationResult<{
     id: string;
@@ -5081,7 +5279,7 @@ declare function useBehioClient(): BehioStorefront;
  * @param locale - BCP 47 locale string (e.g. "cs", "en", "de"). Defaults to "cs".
  * @returns Formatted price string (e.g. "1 499 Kč", "24,99 €")
  */
-declare function formatPrice(amount: number, currency: string, locale?: string): string;
+declare function formatPrice(amount: number, currency: string, locale?: string, display?: "SYMBOL_BEFORE" | "SYMBOL_AFTER" | "CODE"): string;
 
 /**
  * GA4 e-commerce event helper.
@@ -5196,4 +5394,4 @@ declare function revokeAnalyticsConsent(client: BehioStorefront): Promise<SdkRes
     success: boolean;
 }>>;
 
-export { type ActivePromotion, type AddToCartInput, type AnalyticsEventInput, type AuthTokens, BehioAnalyticsTracker, BehioApiError, BehioProvider, type BehioProviderProps, type Blog, type BlogPostDetail, type BlogPostListItem, type BlogPostsPage, type BlogPostsQuery, type BlogSettings, type BlogTag, type Bundle, type BundleItem, type Cart, type CartDiscount, type CartItem, type Category, type CategoryDetail, type CheckoutAddress, type CheckoutInput, type CheckoutPaymentMethod, type CookieConsent, type CookieConsentInput, type CrossSellItem, CurrencySwitcher, type CurrencySwitcherProps, type CurrencySwitcherRenderProps, type CustomerAddress, type CustomerProfile, type EcommerceEventName, type EcommerceItem, type EcommercePayload, type Facet, type FacetRange, type FacetValue, type FacetsResponse, type FilterField, type FulfillmentStatus, type GiftCardBalance, type LoginInput, type MessageResponse, type OrderDetail, type OrderItem, type OrderListItem, type OrderStatus, type Page, type PageDetail, type PaginatedResponse, type PaymentInstrument, type PaymentStatus, type PaymentSwift, type PersonalOffer, type ProductDetail, type ProductLabel, type ProductListItem, type ProductParameter, type ProductParameterGroup, type ProductParametersResponse, type ProductPrice, type ProductReview, type ProductReviewsResponse, type ProductVariant, type ProductsQuery, type QuoteRequest, type RegisterInput, type ReturnRequest, type ShopInfo, type ShopSeo, type SiteFormField, type SiteFormFieldOption, type SiteFormFieldType, type StorageAdapter, type StorefrontForm, type StorefrontFormFieldError, type StorefrontFormFieldErrorCode, type StorefrontFormSettings, type StorefrontFormSubmitInput, type StorefrontFormSubmitResult, StorefrontScripts, type StorefrontScriptsProps, type SubmitQuoteInput, type SubmitReturnInput, type SubmitReviewInput, type UseAddressAutocompleteOptions, type UseAddressAutocompleteReturn, type UseAddressesOptions, type UseBlogPostOptions, type UseBlogPostsOptions, type UseBlogsOptions, type UseCartCountOptions, type UseCartOptions, type UseCategoriesOptions, type UseCategoryOptions, type UseCertificateVerificationOptions, type UseCourseCertificatesOptions, type UseCourseOptions, type UseCoursesOptions, type UseCurrencyResult, type UseCustomerOptions, type UseFacetsOptions, type UseFeaturedOptions, type UseFiltersOptions, type UseLabelsOptions, type UseLessonCommentsOptions, type UseLessonNoteOptions, type UseLessonQuizOptions, type UseLessonTutorOptions, type UseLoyaltyOptions, type UseMenuOptions, type UseOrderOptions, type UseOrdersOptions, type UsePageOptions, type UsePagesOptions, type UsePaymentMethodsOptions, type UsePersonalOffersOptions, type UseProductOptions, type UseProductParametersOptions, type UseProductsOptions, type UseSearchOptions, type UseShippingMethodsOptions, type UseShippingQuoteOptions, type UseShopInfoOptions, type UseShopScriptsOptions, type UseShopSeoOptions, type UseSiteFormOptions, type UseSubscriptionsOptions, type UseVisitorMessagesOptions, type VisitorMessage, type WishlistItem, cookieStorage, createMemoryStorage, detectStorage, formatPrice, generateVisitorId, getStoredVisitorId, grantAnalyticsConsent, localStorageAdapter, memoryStorage, revokeAnalyticsConsent, trackEcommerceEvent, useAddressAutocomplete, useAddresses, useAnalyticsEvents, useAuth, useBehio, useBehioClient, useBlogPost, useBlogPosts, useBlogs, useBundle, useBundles, useCart, useCartCount, useCategories, useCategory, useCertificateVerification, useCheckout, useCookieConsent, useCourse, useCourseCertificates, useCourses, useCrossSell, useCurrency, useCustomer, useFacets, useFeatured, useFilters, useGiftCardBalance, useIsInWishlist, useLabels, useLessonComments, useLessonNote, useLessonQuiz, useLessonTutor, useLookupReturnableOrder, useLoyalty, useMenu, useNewsletterSubscribe, useNewsletterUnsubscribe, useNotifyWhenAvailable, useOrder, useOrderAccess, useOrders, usePage, usePages, usePaymentMethods, usePersonalOffers, usePickupPoints, useProduct, useProductGroup, useProductParameters, useProductPromotions, useProductReviews, useProducts, useQuoteStatus, useReturnStatus, useSearch, useShippingMethods, useShippingQuote, useShopInfo, useShopScripts, useShopSeo, useSiteForm, useSiteFormSubmit, useSubmitQuote, useSubmitReturn, useSubmitReview, useSubscriptions, useVisitorMessages, useWishlist };
+export { type ActivePromotion, type AddToCartInput, type AnalyticsEventInput, type AuthTokens, BehioAnalyticsTracker, BehioApiError, BehioProvider, type BehioProviderProps, type Blog, type BlogPostDetail, type BlogPostListItem, type BlogPostsPage, type BlogPostsQuery, type BlogSettings, type BlogTag, type Bundle, type BundleItem, type Cart, type CartDiscount, type CartItem, type Category, type CategoryDetail, type CheckoutAddress, type CheckoutInput, type CheckoutPaymentMethod, type CookieConsent, type CookieConsentInput, type CrossSellItem, CurrencySwitcher, type CurrencySwitcherProps, type CurrencySwitcherRenderProps, type CustomerAddress, type CustomerProfile, type EcommerceEventName, type EcommerceItem, type EcommercePayload, type Facet, type FacetRange, type FacetValue, type FacetsResponse, type FilterField, type FulfillmentStatus, type GiftCardBalance, type LoginInput, type MessageResponse, type OrderDetail, type OrderItem, type OrderListItem, type OrderStatus, type Page, type PageDetail, type PaginatedResponse, type PaymentInstrument, type PaymentStatus, type PaymentSwift, type PersonalOffer, type ProductDetail, type ProductLabel, type ProductListItem, type ProductParameter, type ProductParameterGroup, type ProductParametersResponse, type ProductPrice, type ProductReview, type ProductReviewsResponse, type ProductVariant, type ProductsQuery, type QuoteRequest, type RegisterInput, type ReturnRequest, type ShopInfo, type ShopSeo, type SiteFormField, type SiteFormFieldOption, type SiteFormFieldType, type StorageAdapter, type StorefrontForm, type StorefrontFormFieldError, type StorefrontFormFieldErrorCode, type StorefrontFormSettings, type StorefrontFormSubmitInput, type StorefrontFormSubmitResult, StorefrontScripts, type StorefrontScriptsProps, type SubmitQuoteInput, type SubmitReturnInput, type SubmitReviewInput, type UseAddressAutocompleteOptions, type UseAddressAutocompleteReturn, type UseAddressesOptions, type UseBlogPostOptions, type UseBlogPostsOptions, type UseBlogsOptions, type UseCartCountOptions, type UseCartOptions, type UseCategoriesOptions, type UseCategoryOptions, type UseCertificateVerificationOptions, type UseCourseCertificatesOptions, type UseCourseOptions, type UseCoursesOptions, type UseCurrencyResult, type UseCustomerOptions, type UseFacetsOptions, type UseFeaturedOptions, type UseFiltersOptions, type UseLabelsOptions, type UseLessonCommentsOptions, type UseLessonNoteOptions, type UseLessonQuizOptions, type UseLessonTutorOptions, type UseLoyaltyOptions, type UseMenuOptions, type UseOrderOptions, type UseOrdersOptions, type UsePageOptions, type UsePagesOptions, type UsePaymentMethodsOptions, type UsePersonalOffersOptions, type UseProductOptions, type UseProductParametersOptions, type UseProductsOptions, type UseSearchOptions, type UseShippingMethodsOptions, type UseShippingQuoteOptions, type UseShopInfoOptions, type UseShopScriptsOptions, type UseShopSeoOptions, type UseSiteFormOptions, type UseSubscriptionsOptions, type UseVisitorMessagesOptions, type VisitorMessage, type WishlistItem, cookieStorage, createMemoryStorage, detectStorage, formatPrice, generateVisitorId, getStoredVisitorId, grantAnalyticsConsent, localStorageAdapter, memoryStorage, revokeAnalyticsConsent, trackEcommerceEvent, useAddressAutocomplete, useAddresses, useAnalyticsEvents, useAuth, useBehio, useBehioClient, useBlogPost, useBlogPosts, useBlogs, useBundle, useBundles, useCart, useCartCount, useCategories, useCategory, useCertificateVerification, useCheckout, useCheckoutPreview, useCookieConsent, useCourse, useCourseCertificates, useCourses, useCrossSell, useCurrency, useCustomer, useFacets, useFeatured, useFilters, useGiftCardBalance, useIsInWishlist, useLabels, useLessonComments, useLessonNote, useLessonQuiz, useLessonTutor, useLookupReturnableOrder, useLoyalty, useMenu, useNewsletterSubscribe, useNewsletterUnsubscribe, useNotifyWhenAvailable, useOrder, useOrderAccess, useOrders, usePage, usePages, usePaymentMethods, usePersonalOffers, usePickupPoints, useProduct, useProductGroup, useProductParameters, useProductPromotions, useProductReviews, useProducts, useQuoteStatus, useReturnStatus, useSearch, useShippingMethods, useShippingQuote, useShopInfo, useShopScripts, useShopSeo, useSiteForm, useSiteFormSubmit, useSubmitQuote, useSubmitReturn, useSubmitReview, useSubscriptions, useVisitorMessages, useWishlist };