@behio/storefront-sdk 0.12.0 → 0.14.0

package/dist/index.d.ts

@@ -1,1340 +1,13 @@
-interface BehioStorefrontConfig {
-    /** API key (public: pk_live_xxx or private: sk_live_xxx) */
-    apiKey: string;
-    /** Backend base URL. Default: https://api.behio.com */
-    baseUrl?: string;
-    /**
-     * The domain this storefront is served on (e.g. "mujshop.cz"), sent as
-     * X-Shop-Domain. Only needed when ONE deployment serves several domains with
-     * a single "all domains" API key (e.g. a Vercel app behind mujshop.cz +
-     * mujshop.sk) AND there's no Origin header (server-side rendering). A
-     * domain-bound key, or a browser request (Origin), doesn't need it.
-     */
-    shopDomain?: string;
-    /** Default locale for catalog requests. Default: none (uses shop default) */
-    locale?: string;
-    /** Default currency for price resolution. Default: none (uses shop default) */
-    currency?: string;
-    /** Custom fetch implementation (for Node.js < 18 or testing) */
-    fetch?: typeof fetch;
-    /** Request timeout in milliseconds. Default: 30000 (30s) */
-    timeout?: number;
-    /** Number of retries on network/5xx errors. Default: 1 */
-    retries?: number;
-    /** Base delay between retries in ms (multiplied by attempt). Default: 1000 */
-    retryDelay?: number;
-}
-interface PaginatedResponse<T> {
-    items: T[];
-    total: number;
-    page: number;
-    limit: number;
-    totalPages: number;
-}
-interface MessageResponse {
-    message: string;
-}
-interface ShopInfo {
-    id: string;
-    name: string;
-    domain: string;
-    logo?: string;
-    favicon?: string;
-    isActive: boolean;
-    defaultLanguage: string;
-    supportedLanguages: string[];
-    defaultCurrency: string;
-    supportedCurrencies: string[];
-    metaTitle?: string;
-    metaDescription?: string;
-    allowGuestCheckout: boolean;
-}
-interface ShopSeo {
-    locale: string;
-    title: string | null;
-    description: string | null;
-    keywords: string | null;
-    ogTitle: string | null;
-    ogDescription: string | null;
-    ogImage: string | null;
-}
-/**
- * Money amount displayed to a customer in a chosen currency.
- *
- * Two cases:
- *  - **Fixed price** (preferred): merchant configured an explicit price for
- *    this currency. `isApproximate` is `false`/absent and `fxSource` is `null`.
- *  - **Approximate / FX-converted**: no fixed price for the requested
- *    currency, so Behio converted from the eshop's default currency using
- *    today's rate from `fxSource` (CNB or Frankfurter/ECB) plus the eshop's
- *    safety margin. UI should show a `≈` hint and offer the base price too.
- */
-/**
- * Payment method available at checkout. Returned by
- * `GET /storefront/v1/catalog/payment-methods` filtered for the customer's
- * chosen currency. Credentials (API keys, merchant ids) stay server-side
- * — only customer-safe fields appear here.
- */
-interface CheckoutPaymentMethod {
-    id: string;
-    /** Merchant-chosen label, e.g. "Kartou (Stripe)" or "Převodem na účet". */
-    name: string;
-    description?: string | null;
-    /** Provider id: "stripe" | "gopay" | "comgate" | "bank_transfer" | "cod" | "custom". */
-    provider: string;
-    /** Currencies this method accepts. Empty = any. */
-    currencies: string[];
-    /** Optional fee added to the order total (e.g. COD surcharge). */
-    fee?: number | null;
-    feeCurrency?: string | null;
-    /** Customer-safe slice of config: bank account, IBAN, instructions, … */
-    publicConfig?: Record<string, unknown>;
-}
-interface ProductPrice {
-    amount: number;
-    currency: string;
-    compareAtPrice?: number | null;
-    /** `true` when this amount was FX-converted from the eshop default currency. */
-    isApproximate?: boolean;
-    /** Provider id ("cnb" | "frankfurter" | "manual") when FX-converted. */
-    fxSource?: string | null;
-    /** Original amount in the eshop default currency before conversion. */
-    baseAmount?: number | null;
-    /** ISO code of the currency `baseAmount` is denominated in. */
-    baseCurrency?: string | null;
-}
-interface ProductVolumePrice {
-    minQuantity: number;
-    price: number;
-    currency?: string;
-}
-interface ProductVariant {
-    id: string;
-    sku: string;
-    name: string;
-    attributes: Record<string, string>;
-    price: ProductPrice;
-    inStock: boolean;
-    stockQuantity?: number;
-    /**
-     * Cover image URL for the variant. Falls back to the parent product's
-     * cover when the variant has no photo of its own — see `imageIsInherited`.
-     */
-    imageUrl?: string | null;
-    /**
-     * `true` when `imageUrl` is borrowed from the parent product because the
-     * variant has no cover image of its own. Use this to render a hint like
-     * "default photo" or to render the picture in a subtler style.
-     */
-    imageIsInherited: boolean;
-}
-interface ProductLabel {
-    id: string;
-    slug: string;
-    name: string;
-    color?: string;
-}
-interface ProductListItem {
-    id: string;
-    slug: string;
-    name: string;
-    shortDescription?: string;
-    sku: string;
-    gtin?: string;
-    price: ProductPrice;
-    inStock: boolean;
-    stockQuantity?: number;
-    image?: string | null;
-    labels: ProductLabel[];
-    isFeatured: boolean;
-}
-/** A single responsive derivative (size + format) of a media image. */
-interface ProductMediaVariant {
-    variant: 'thumb' | 'medium' | 'large' | 'xlarge';
-    format: 'jpeg' | 'webp' | 'avif';
-    url: string;
-    width: number;
-    height: number;
-}
-/**
- * A product gallery entry (image or video), sourced from the inventory item
- * so it is shared across every storefront listing the product. Images carry
- * responsive `variants` (webp/avif/jpeg in three sizes) for fast LCP; pick
- * the smallest format the client supports.
- */
-interface ProductMedia {
-    id: string;
-    type: 'IMAGE' | 'VIDEO';
-    /** Original uploaded file URL. */
-    url: string;
-    alt?: string | null;
-    isCover: boolean;
-    order: number;
-    variants: ProductMediaVariant[];
-}
-interface ProductDetail extends ProductListItem {
-    longDescription?: string;
-    /** @deprecated Legacy per-listing images. Prefer `media`. */
-    images: Array<{
-        url: string;
-        alt?: string;
-        order: number;
-    }>;
-    /** Product gallery (images + videos) with responsive derivatives. */
-    media: ProductMedia[];
-    categories: Array<{
-        id: string;
-        slug: string;
-        name: string;
-    }>;
-    variants: ProductVariant[];
-    volumePricing: ProductVolumePrice[];
-    customFields: Record<string, unknown>;
-    seo: {
-        title?: string | null;
-        description?: string | null;
-        keywords?: string | null;
-    };
-    productGroups?: Array<{
-        slug: string;
-        name: string;
-        products: ProductListItem[];
-    }>;
-    /** Product weight (from warehouse item) */
-    weight?: number | null;
-    /** Weight unit: GRAM, KILOGRAM, TONNE */
-    weightUnit?: string | null;
-}
-interface Category {
-    id: string;
-    slug: string;
-    name: string;
-    description?: string;
-    imageUrl?: string;
-    children: Category[];
-    productCount?: number;
-}
-interface CategoryDetail extends Category {
-    seoTitle?: string;
-    seoDescription?: string;
-}
-type DataGroupFieldType = "TEXT" | "NUMBER" | "DECIMAL" | "BOOLEAN" | "DATE" | "TIME" | "DATETIME" | "PERCENTAGE" | "MONEY" | "ASSET" | "ITEM_LIST" | "DYNAMIC_NUMBER_CALCULATION_FROM_OTHERS";
-interface FilterField {
-    key: string;
-    name: string;
-    type: DataGroupFieldType | string;
-    groupKey: string;
-    groupName: string;
-    values?: string[];
-}
-declare const ProductSort: {
-    readonly PRICE_ASC: "price_asc";
-    readonly PRICE_DESC: "price_desc";
-    readonly NAME_ASC: "name_asc";
-    readonly NAME_DESC: "name_desc";
-    readonly NEWEST: "newest";
-    readonly FEATURED: "featured";
-};
-type ProductSortValue = (typeof ProductSort)[keyof typeof ProductSort];
-declare const OrderStatuses: {
-    readonly PENDING: "PENDING";
-    readonly CONFIRMED: "CONFIRMED";
-    readonly PROCESSING: "PROCESSING";
-    readonly SHIPPED: "SHIPPED";
-    readonly DELIVERED: "DELIVERED";
-    readonly CANCELLED: "CANCELLED";
-    readonly REFUNDED: "REFUNDED";
-};
-declare const PaymentStatuses: {
-    readonly UNPAID: "UNPAID";
-    readonly PAID: "PAID";
-    readonly PARTIALLY_REFUNDED: "PARTIALLY_REFUNDED";
-    readonly REFUNDED: "REFUNDED";
-};
-declare const FulfillmentStatuses: {
-    readonly UNFULFILLED: "UNFULFILLED";
-    readonly PARTIALLY_FULFILLED: "PARTIALLY_FULFILLED";
-    readonly FULFILLED: "FULFILLED";
-};
-declare const AddressTypes: {
-    readonly SHIPPING: "SHIPPING";
-    readonly BILLING: "BILLING";
-};
-type AddressType = (typeof AddressTypes)[keyof typeof AddressTypes];
-interface ProductsQuery {
-    page?: number;
-    limit?: number;
-    /** Single category slug (OR logic with categories array) */
-    category?: string;
-    /** Multiple category slugs (OR logic — product in ANY of these categories) */
-    categories?: string[];
-    /** Single label slug */
-    label?: string;
-    priceMin?: number;
-    priceMax?: number;
-    currency?: string;
-    locale?: string;
-    sort?: ProductSortValue;
-    inStock?: boolean;
-    search?: string;
-    customFields?: Record<string, unknown>;
-    /** Filter by specific product IDs (comma-separated in URL) */
-    ids?: string[];
-    /** Filter by specific product slugs */
-    slugs?: string[];
-    /** Multiple labels (AND logic — product must have ALL) */
-    labels?: string[];
-    /** Exclude specific product IDs (e.g. for "related products" excluding current) */
-    excludeIds?: string[];
-    /** Exclude products in specific categories */
-    excludeCategories?: string[];
-    /** Only products with compareAtPrice (on sale) */
-    hasDiscount?: boolean;
-    /** Only featured products */
-    isFeatured?: boolean;
-    /** Products created after timestamp (epoch ms) */
-    createdAfter?: number;
-}
-interface AuthTokens {
-    accessToken: string;
-    refreshToken: string;
-}
-interface RegisterInput {
-    email: string;
-    password: string;
-    firstName?: string;
-    lastName?: string;
-}
-interface LoginInput {
-    email: string;
-    password: string;
-}
-interface CartItemProduct {
-    slug: string;
-    name: string;
-    sku: string;
-    imageUrl?: string;
-    inStock: boolean;
-    currentPrice: number;
-}
-interface CartItem {
-    id: string;
-    product: CartItemProduct;
-    quantity: number;
-    unitPrice: number;
-    totalPrice: number;
-    priceChanged: boolean;
-    volumePriceApplied: boolean;
-}
-interface CartDiscount {
-    code: string;
-    type: string;
-    value: number;
-}
-interface Cart {
-    id: string;
-    sessionToken?: string;
-    items: CartItem[];
-    subtotal: number;
-    discountTotal: number;
-    discount?: CartDiscount;
-    grandTotal: number;
-    currency: string;
-    itemCount: number;
-}
-interface AddToCartInput {
-    /** Product ID (eshop product ID or warehouse item ID) */
-    productId: string;
-    quantity: number;
-}
-interface CheckoutAddress {
-    firstName: string;
-    lastName: string;
-    company?: string;
-    street: string;
-    city: string;
-    zip: string;
-    country: string;
-    phone?: string;
-}
-interface CheckoutInput {
-    shippingAddress: CheckoutAddress;
-    billingAddress: CheckoutAddress;
-    email: string;
-    phone?: string;
-    customerNote?: string;
-    /**
-     * Chosen shipping method. Required whenever the eshop has at least one
-     * enabled shipping method — the backend rejects the order without it.
-     * Prefer also sending `shippingQuoteId` from `shipping.quote()`; with only
-     * the method id the backend re-quotes the cart server-side.
-     */
-    shippingMethodId?: string;
-    /**
-     * Quote id from `shipping.quote()` — pins the exact server-computed price
-     * the customer saw. Expired quotes are re-quoted automatically; a consumed
-     * or foreign quote is rejected.
-     */
-    shippingQuoteId?: string;
-    paymentMethodId?: string;
-}
-type OrderStatus = (typeof OrderStatuses)[keyof typeof OrderStatuses];
-type PaymentStatus = (typeof PaymentStatuses)[keyof typeof PaymentStatuses];
-type FulfillmentStatus = (typeof FulfillmentStatuses)[keyof typeof FulfillmentStatuses];
-interface OrderListItem {
-    id: string;
-    orderNumber: string;
-    status: OrderStatus;
-    paymentStatus: PaymentStatus;
-    grandTotal: number;
-    currency: string;
-    itemCount: number;
-    createdAt: number;
-}
-interface OrderItem {
-    productName: string;
-    sku: string;
-    imageUrl?: string;
-    quantity: number;
-    unitPrice: number;
-    totalPrice: number;
-    totalPriceWithTax: number;
-}
-/**
- * PII-minimized order view returned by `orders.track(token)`. The tracking
- * token is shared in URLs and e-mails, so this deliberately omits full
- * address, phone, billing and customer note, and masks the email.
- */
-interface OrderTracking {
-    orderNumber: string;
-    status: OrderStatus;
-    paymentStatus: PaymentStatus;
-    fulfillmentStatus: FulfillmentStatus;
-    currency: string;
-    grandTotal: number;
-    /** Masked, e.g. "j***@e***.cz" */
-    emailMasked: string;
-    shippingCity: string | null;
-    shippingCountry: string | null;
-    items: OrderItem[];
-    createdAt: number;
-}
-interface OrderStatusHistory {
-    fromStatus?: OrderStatus;
-    toStatus: OrderStatus;
-    note?: string;
-    changedBy?: string;
-    createdAt: number;
-}
-interface OrderDetail extends OrderListItem {
-    items: OrderItem[];
-    shippingAddress: CheckoutAddress;
-    billingAddress: CheckoutAddress;
-    email: string;
-    phone?: string;
-    customerNote?: string;
-    subtotal: number;
-    taxTotal: number;
-    shippingTotal: number;
-    discountTotal: number;
-    fulfillmentStatus: FulfillmentStatus;
-    statusHistory: OrderStatusHistory[];
-    trackingToken?: string;
-    /**
-     * For redirect payment gateways (GoPay, ...), the hosted URL the
-     * storefront must send the customer to in order to pay. Present only on
-     * the order returned by `checkout.createOrder()`. Null/absent for
-     * offline methods (bank transfer, COD) and zero-total orders.
-     */
-    paymentRedirectUrl?: string | null;
-}
-/** Generic response to `orders.requestAccessCode` — never reveals existence. */
-interface OrderAccessRequestResponse {
-    success: boolean;
-    message: string;
-}
-/** Response to a successful `orders.verifyAccessCode`. */
-interface OrderAccessVerifyResponse {
-    /** Short-lived JWT scoped to this single order (use with `getByAccessToken`). */
-    accessToken: string;
-    /** Token lifetime in seconds. */
-    expiresIn: number;
-    order: OrderDetail;
-}
-interface CustomerProfile {
-    id: string;
-    email: string;
-    firstName?: string;
-    lastName?: string;
-    phone?: string;
-    emailVerified: boolean;
-}
-interface CustomerAddress {
-    id: string;
-    type: AddressType;
-    isDefault: boolean;
-    firstName: string;
-    lastName: string;
-    company?: string;
-    street: string;
-    city: string;
-    zip: string;
-    country: string;
-    phone?: string;
-}
-interface Page {
-    slug: string;
-    title: string;
-    isActive: boolean;
-}
-interface PageDetail {
-    slug: string;
-    title: string;
-    content: unknown;
-    seoTitle?: string;
-    seoDescription?: string;
-    /** Downloadable files attached to the page (e.g. legal form PDFs). */
-    attachments: PageAttachment[];
-}
-interface PageAttachment {
-    name: string;
-    description: string | null;
-    url: string;
-    mimeType: string;
-    fileSize: number;
-}
-type BehioErrorCode = "UNAUTHORIZED" | "FORBIDDEN" | "NOT_FOUND" | "VALIDATION_ERROR" | "CONFLICT" | "RATE_LIMITED" | "CART_EMPTY" | "PRODUCT_NOT_FOUND" | "INVALID_CREDENTIALS" | "INVALID_DISCOUNT" | "DISCOUNT_EXPIRED" | "TOKEN_EXPIRED" | "TOKEN_INVALID" | "EMAIL_ALREADY_EXISTS" | "ORDER_NOT_CANCELLABLE" | "INTERNAL_ERROR" | "NETWORK_ERROR" | "TIMEOUT" | "UNKNOWN";
-declare class BehioApiError extends Error {
-    readonly code: BehioErrorCode;
-    readonly status: number;
-    readonly body: unknown;
-    readonly isRetryable: boolean;
-    constructor(status: number, body: unknown, message?: string);
-    static resolveCode(status: number, body: unknown): BehioErrorCode;
-    /** Check if this is a specific error type */
-    is(code: BehioErrorCode): boolean;
-}
-declare class BehioNetworkError extends Error {
-    readonly code: "NETWORK_ERROR" | "TIMEOUT";
-    readonly isRetryable = true;
-    constructor(message: string, isTimeout?: boolean);
-}
-/**
- * Shape every SDK call returns. Destructure `{data, error}` — exactly
- * one of them is non-null on any given call. No more try/catch for
- * expected failures; the type system forces you to handle `error`
- * before touching `data`.
- *
- *   const {data, error} = await behio.catalog.getProduct(slug);
- *   if (error) return <ErrorState code={error.code} />;
- *   return <ProductView product={data} />;
- */
-type SdkResult<T> = {
-    data: T;
-    error: null;
-} | {
-    data: null;
-    error: SdkError;
-};
-/**
- * Canonical error shape returned from every SDK call. Always carries a
- * `code` you can branch on without parsing messages.
- */
-interface SdkError {
-    /**
-     * High-level category. `BehioErrorCode` covers API errors; additional
-     * buckets are network/timeout/abort/unknown.
-     */
-    code: BehioErrorCode;
-    /** Human-readable message (fallback for unknown codes / dev logging). */
-    message: string;
-    /** HTTP status, if the error came from the API. Null for network / abort. */
-    status: number | null;
-    /** Raw API body, if present. */
-    body?: unknown;
-    /** Whether the operation is safe to retry (true for 5xx / 429 / network). */
-    isRetryable: boolean;
-    /** Preserves the original thrown instance for stack traces + rethrows. */
-    cause?: unknown;
-}
-declare function ok<T>(data: T): SdkResult<T>;
-declare function err<T = never>(error: SdkError): SdkResult<T>;
-/**
- * Converts any thrown value into a canonical SdkError. Used by the
- * request wrapper when catching internal throws.
- */
-declare function toSdkError(err: unknown): SdkError;
-type BehioEventType = "auth:login" | "auth:logout" | "auth:token-refresh" | "auth:token-refresh-failed" | "cart:updated" | "cart:cleared" | "order:created" | "error" | "request" | "response" | "rate-limit-warning";
-type BehioEventHandler = (data?: unknown) => void;
-interface RequestInterceptorConfig {
-    url: string;
-    method: string;
-    headers: Record<string, string>;
-    body?: string;
-}
-interface RequestInterceptor {
-    (config: RequestInterceptorConfig): RequestInterceptorConfig | Promise<RequestInterceptorConfig>;
-}
-interface ResponseInterceptorData {
-    status: number;
-    data: unknown;
-    headers: Headers;
-}
-interface ResponseInterceptor {
-    (response: ResponseInterceptorData): void | Promise<void>;
-}
-interface BundleItem {
-    productId: string;
-    slug: string | null;
-    name: string;
-    sku: string;
-    quantity: number;
-    imageUrl: string | null;
-    defaultPrice: number | null;
-}
-interface Bundle {
-    id: string;
-    slug: string;
-    name: string;
-    description: string | null;
-    bundlePrice: number;
-    currency: string;
-    coverImage: string | null;
-    endsAt: number | null;
-    itemsSum: number;
-    /** Absolute saving vs buying the components separately, in `currency`. */
-    savings: number;
-    /** Percentage saving, 0–100. 0 when `itemsSum` is zero. */
-    savingsPercent: number;
-    /** Minimum bundles per order. Default 1. */
-    minQuantity: number;
-    /** Maximum bundles per order. `null` = uncapped. */
-    maxQuantity: number | null;
-    /** Lifetime stock limit. `null` = uncapped. Once exceeded, add-to-cart fails. */
-    stockLimit: number | null;
-    /** Lifetime units sold (materialized counter). Used for "X sold" badges. */
-    soldCount: number;
-    items: BundleItem[];
-}
-/**
- * Shape returned by `behio.shipping.listMethods()` — the merchant's
- * configured shipping methods filtered by cart currency + destination
- * country. Use this for the "always-on" picker; for live quotes, prefer
- * `behio.shipping.quote()` which can dispatch to the meta-provider
- * (Zaslat, Shippo, …) for a live carrier rate per address.
- */
-interface ShippingMethodSummary {
-    id: string;
-    name: string;
-    description: string | null;
-    /** Internal routing id ("zaslat", "ppl_direct", "manual", …). Not for display. */
-    provider: string;
-    /** "fixed" = price known upfront; "live_quote" = must call shipping.quote() with address. */
-    priceStrategy: "fixed" | "live_quote";
-    currency: string | null;
-    /** Final customer-facing price. Null for live_quote methods (call quote() to resolve). */
-    price: number | null;
-    /** Per-currency base price from the merchant's config. Null for live_quote. */
-    basePrice: number | null;
-    isFreeShipping: boolean;
-    freeShippingThreshold: number | null;
-    /** "address" | "pickup_point" | "in_store" | "digital". */
-    deliveryType: string;
-    supportsPickupPoints: boolean;
-    etaDaysMin: number | null;
-    etaDaysMax: number | null;
-    allowedCountries: string[];
-    /** Customer-safe config fields the merchant filled in (pickup address, instructions). */
-    publicConfig: Record<string, unknown>;
-}
-/**
- * Input for `behio.shipping.quote()`. At minimum requires the destination
- * country — passing more (zip, weight per item, cart total) lets the
- * meta-provider return better-fitting carriers and triggers free-shipping
- * thresholds correctly.
- */
-interface ShippingQuoteInput {
-    destinationAddress: {
-        country: string;
-        zip?: string;
-        city?: string;
-        street?: string;
-    };
-    items?: Array<{
-        whItemId: string;
-        quantity: number;
-        weightKg?: number;
-    }>;
-    cartTotal?: number;
-    currency?: string;
-}
-/**
- * One option returned by `behio.shipping.quote()`. Methods configured for
- * fixed pricing always come back with `available: true` and the merchant's
- * configured price. Methods configured for live quoting come back available
- * only when the upstream meta-provider returned a rate for the destination
- * — otherwise `available: false` with a `reason` (e.g. `"no_rate_returned"`,
- * `"live_quote_not_implemented"`). Filter `available: true` in your
- * checkout picker.
- */
-interface ShippingQuote extends ShippingMethodSummary {
-    /** `"fixed"` uses `pricing` rows; `"live_quote"` came from the upstream provider. */
-    strategy: "fixed" | "live_quote";
-    available: boolean;
-    reason: string | null;
-    /** Server-generated quote ID. Null for fixed-price methods. Pass to checkout for tamper-proof pricing. */
-    quoteId: string | null;
-    /** Quote expiry (epoch ms). Null for fixed-price methods. */
-    expiresAt: number | null;
-}
-interface CrossSellItem {
-    productId: string;
-    slug: string | null;
-    name: string;
-    sku: string;
-    price: number | null;
-    imageUrl: string | null;
-    stockCached: number;
-}
-interface ActivePromotion {
-    id: string;
-    name: string;
-    slug: string;
-    type: string;
-    discountType: string;
-    discountValue: number;
-    startsAt: number;
-    endsAt: number | null;
-    badgeText: string | null;
-    badgeColor: string | null;
-    showCountdown: boolean;
-    couponRequired: boolean;
-}
-interface GiftCardBalance {
-    valid: boolean;
-    balance: number;
-    currency: string;
-}
-interface WishlistItem {
-    id: string;
-    productId: string;
-    productName: string;
-    productSku: string;
-    productSlug: string | null;
-    imageUrl: string | null;
-    price: number | null;
-    stockCached: number;
-    createdAt: number;
-}
-interface ProductReview {
-    id: string;
-    authorName: string;
-    rating: number;
-    title: string | null;
-    content: string | null;
-    imageUrls: string[];
-    isVerifiedPurchase: boolean;
-    helpfulCount: number;
-    unhelpfulCount: number;
-    replyContent: string | null;
-    replyAt: number | null;
-    createdAt: number;
-}
-interface ProductReviewsResponse {
-    reviews: ProductReview[];
-    total: number;
-    page: number;
-    limit: number;
-    averageRating: number;
-    reviewCount: number;
-}
-/** Returned by `catalog.notifyWhenAvailable()` — back-in-stock subscription. */
-interface BackInStockSubscription {
-    id: string;
-    eshopId: string;
-    productId: string;
-    email: string;
-    createdAt: number;
-}
-interface SubmitReviewInput {
-    productId: string;
-    rating: number;
-    title?: string;
-    content?: string;
-    authorName: string;
-    authorEmail?: string;
-    imageUrls?: string[];
-}
-interface ReturnableOrderItem {
-    orderItemId: string;
-    productName: string;
-    /** Quantity ordered */
-    quantity: number;
-    /** Units still returnable (ordered minus active return claims) */
-    returnableQuantity: number;
-}
-/**
- * Result of the guest order lookup used by the EU withdrawal form:
- * the customer enters their order number + email and gets back the
- * internal ids needed to submit a return. No account required.
- */
-interface ReturnableOrder {
-    orderId: string;
-    orderNumber: string;
-    status: string;
-    items: ReturnableOrderItem[];
-    createdAt: number;
-}
-interface ReturnRequestItem {
-    id: string;
-    orderItemId: string;
-    productName: string;
-    quantity: number;
-    reason: string | null;
-    imageUrls: string[];
-}
-/** Returned by `returns.submit()` — the acknowledged withdrawal request. */
-interface ReturnRequest {
-    id: string;
-    eshopId: string;
-    orderId: string;
-    /** REQUESTED | APPROVED | SHIPPED_BACK | RECEIVED | REFUNDED | REJECTED | CLOSED */
-    status: string;
-    reason: string;
-    customerNote: string | null;
-    items: ReturnRequestItem[];
-    createdAt: number;
-}
-interface ReturnStatusItem {
-    id: string;
-    productName: string;
-    quantity: number;
-    reason: string | null;
-}
-/** Returned by `returns.getStatus()` — the full public view of a return. */
-interface ReturnStatus {
-    id: string;
-    orderNumber: string;
-    /** REQUESTED | APPROVED | SHIPPED_BACK | RECEIVED | REFUNDED | REJECTED | CLOSED */
-    status: string;
-    reason: string;
-    customerNote: string | null;
-    refundMethod: string | null;
-    refundAmount: number | null;
-    refundedAt: number | null;
-    returnTrackingNumber: string | null;
-    items: ReturnStatusItem[];
-    createdAt: number;
-    updatedAt: number;
-}
-interface SubmitReturnInput {
-    orderId: string;
-    /**
-     * Email used on the order. Required — it is the ownership gate for guest
-     * withdrawals; the backend rejects submissions whose email doesn't match.
-     */
-    email: string;
-    reason: string;
-    customerNote?: string;
-    items: {
-        orderItemId: string;
-        productName: string;
-        quantity: number;
-        reason?: string;
-        imageUrls?: string[];
-    }[];
-}
-interface CookieConsent {
-    necessary: boolean;
-    analytics: boolean;
-    marketing: boolean;
-    preferences: boolean;
-    consentedAt: number;
-}
-interface CookieConsentInput {
-    visitorId: string;
-    analytics: boolean;
-    marketing: boolean;
-    preferences: boolean;
-}
-interface QuoteItem {
-    productId: string;
-    quantity: number;
-    requestedPrice: number | null;
-    quotedPrice: number | null;
-}
-interface QuoteRequest {
-    id: string;
-    /** PENDING | QUOTED | ACCEPTED | REJECTED | EXPIRED */
-    status: string;
-    contactName: string;
-    contactEmail: string;
-    companyName: string | null;
-    quotedTotal: number | null;
-    quotedCurrency: string | null;
-    quotedNote: string | null;
-    expiresAt: number | null;
-    items: QuoteItem[];
-    createdAt: number;
-}
-interface SubmitQuoteInput {
-    contactName: string;
-    contactEmail: string;
-    contactPhone?: string;
-    companyName?: string;
-    companyIco?: string;
-    message?: string;
-    items: {
-        productId: string;
-        quantity: number;
-        requestedPrice?: number;
-    }[];
-}
+export { t as ActivePromotion, J as AddToCartInput, j as AddressDetail, A as AddressSuggestion, a3 as AddressType, a4 as AddressTypes, K as AuthTokens, I as BackInStockSubscription, L as BehioApiError, a5 as BehioErrorCode, a6 as BehioEventHandler, a7 as BehioEventType, a8 as BehioNetworkError, a as BehioStorefront, B as BehioStorefrontConfig, r as Bundle, M as BundleItem, g as Cart, N as CartDiscount, T as CartItem, a9 as CartItemProduct, C as Category, e as CategoryDetail, U as CheckoutAddress, n as CheckoutInput, aa as CheckoutPaymentMethod, D as CookieConsent, E as CookieConsentInput, s as CrossSellItem, i as CustomerAddress, h as CustomerProfile, ab as DataGroupFieldType, F as FilterField, V as FulfillmentStatus, ac as FulfillmentStatuses, G as GiftCardBalance, X as LoginInput, Y as MessageResponse, l as OrderAccessRequestResponse, m as OrderAccessVerifyResponse, k as OrderDetail, Z as OrderItem, O as OrderListItem, _ as OrderStatus, ad as OrderStatusHistory, ae as OrderStatuses, af as OrderTracking, p as Page, ag as PageAttachment, o as PageDetail, b as PaginatedResponse, $ as PaymentStatus, ah as PaymentStatuses, d as ProductDetail, f as ProductLabel, c as ProductListItem, ai as ProductMedia, aj as ProductMediaVariant, a0 as ProductPrice, a1 as ProductReview, u as ProductReviewsResponse, ak as ProductSort, al as ProductSortValue, a2 as ProductVariant, am as ProductVolumePrice, P as ProductsQuery, an as QuoteItem, Q as QuoteRequest, R as RegisterInput, ao as RequestInterceptor, ap as RequestInterceptorConfig, aq as ResponseInterceptor, ar as ResponseInterceptorData, y as ReturnRequest, as as ReturnRequestItem, x as ReturnStatus, at as ReturnStatusItem, w as ReturnableOrder, au as ReturnableOrderItem, av as SdkError, aw as SdkResult, ax as ShippingMethodSummary, ay as ShippingQuote, az as ShippingQuoteInput, S as ShopInfo, q as ShopSeo, H as SubmitQuoteInput, z as SubmitReturnInput, v as SubmitReviewInput, W as WishlistItem, aA as err, aB as ok, aC as toSdkError } from './client-tINA5Ntn.js';
 
-declare class BehioStorefront {
-    private baseUrl;
-    private apiKey;
-    private shopDomain?;
-    private defaultLocale?;
-    private defaultCurrency?;
-    private fetchFn;
-    private timeout;
-    private retries;
-    private retryDelay;
-    private accessToken?;
-    private refreshToken?;
-    private isRefreshing;
-    private refreshPromise;
-    private cartSession?;
-    private listeners;
-    private requestInterceptors;
-    private responseInterceptors;
-    private rateLimitRemaining;
-    private rateLimitReset;
-    constructor(config: BehioStorefrontConfig);
-    readonly catalog: CatalogModule;
-    readonly auth: AuthModule;
-    readonly cart: CartModule;
-    readonly checkout: CheckoutModule;
-    readonly orders: OrdersModule;
-    readonly customer: CustomerModule;
-    readonly pages: PagesModule;
-    readonly wishlist: WishlistModule;
-    readonly reviews: ReviewsModule;
-    readonly returns: ReturnsModule;
-    readonly consent: ConsentModule;
-    readonly quotes: QuotesModule;
-    readonly addresses: AddressModule;
-    readonly shipping: ShippingModule;
-    /** Get basic shop info */
-    getShopInfo(): Promise<SdkResult<ShopInfo>>;
-    /** Get SEO metadata for the shop homepage in the given locale (defaults to shop default). */
-    getShopSeo(locale?: string): Promise<SdkResult<ShopSeo>>;
-    /** Set auth tokens (e.g. from localStorage) */
-    setTokens(tokens: {
-        accessToken: string;
-        refreshToken: string;
-    }): void;
-    /** Clear auth tokens */
-    clearTokens(): void;
-    /** Get current access token */
-    getAccessToken(): string | undefined;
-    /** Get current refresh token */
-    getRefreshToken(): string | undefined;
-    /** Set cart session token (e.g. from cookie) */
-    setCartSession(token: string): void;
-    /** Get cart session token */
-    getCartSession(): string | undefined;
-    /** Clear cart session */
-    clearCartSession(): void;
-    /**
-     * Set the default currency sent on every catalog request (unless a per-call
-     * `currency` overrides it). Read live at request time, so changing it takes
-     * effect immediately without rebuilding the client. Pass undefined to clear
-     * (falls back to the shop's default currency server-side).
-     */
-    setCurrency(currency: string | undefined): void;
-    /** Get the current default currency, if any. */
-    getCurrency(): 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. */
-    getLocale(): string | undefined;
-    /** Subscribe to SDK events. Returns an unsubscribe function. */
-    on(event: BehioEventType, handler: BehioEventHandler): () => void;
-    /** @internal Emit an event (fire-and-forget, handler errors are swallowed) */
-    emit(event: BehioEventType, data?: unknown): void;
-    /** Add a request interceptor. Returns an unsubscribe function. */
-    addRequestInterceptor(fn: RequestInterceptor): () => void;
-    /** Add a response interceptor. Returns an unsubscribe function. */
-    addResponseInterceptor(fn: ResponseInterceptor): () => void;
-    /** Get current rate limit info from latest response headers */
-    getRateLimitInfo(): {
-        remaining: number | null;
-        reset: number | null;
-    };
-    private handleTokenRefresh;
-    /**
-     * Every public module method funnels through here. Internally calls
-     * `rawRequest` (which throws on failure) and maps thrown errors to
-     * `SdkError` so the public surface can return `SdkResult<T>`.
-     *
-     * @internal — don't call from outside the SDK; use the typed module
-     * methods (behio.catalog.*, behio.cart.*, …) instead.
-     */
-    request<T>(method: string, path: string, options?: {
-        body?: unknown;
-        query?: Record<string, string | number | boolean | undefined | string[] | number[]>;
-        auth?: boolean;
-        signal?: AbortSignal;
-        headers?: Record<string, string>;
-    }): Promise<SdkResult<T>>;
-    /**
-     * Throws on failure (API error / network / timeout). Kept private so
-     * internal auth refresh recursion keeps its existing control flow —
-     * public callers must go through `request()` which returns Result.
-     */
-    private rawRequest;
-}
-declare class CatalogModule {
-    private client;
-    constructor(client: BehioStorefront);
-    /** List products with filtering, pagination, search */
-    getProducts(query?: ProductsQuery): Promise<SdkResult<PaginatedResponse<ProductListItem>>>;
-    /** Get product detail by slug */
-    getProduct(slug: string, options?: {
-        locale?: string;
-        currency?: string;
-    }): Promise<SdkResult<ProductDetail>>;
-    /** Get category tree */
-    getCategories(locale?: string): Promise<SdkResult<{
-        categories: Category[];
-    }>>;
-    /** Get category detail by slug */
-    getCategory(slug: string, locale?: string): Promise<SdkResult<CategoryDetail>>;
-    /** Get products in a category */
-    getCategoryProducts(slug: string, query?: ProductsQuery): Promise<SdkResult<PaginatedResponse<ProductListItem>>>;
-    /** Get all labels */
-    getLabels(locale?: string): Promise<SdkResult<{
-        labels: ProductLabel[];
-    }>>;
-    /** Get featured products */
-    getFeatured(options?: {
-        locale?: string;
-        currency?: string;
-    }): Promise<SdkResult<PaginatedResponse<ProductListItem>>>;
-    /** Get available filter fields for dynamic filter UI */
-    getFilters(): Promise<SdkResult<{
-        filters: FilterField[];
-    }>>;
-    /** Search products */
-    search(query: string, options?: {
-        page?: number;
-        limit?: number;
-    }): Promise<SdkResult<PaginatedResponse<ProductListItem>>>;
-    /** List all active bundles */
-    getBundles(): Promise<SdkResult<{
-        items: Bundle[];
-    }>>;
-    /** Get a single bundle by slug */
-    getBundle(slug: string): Promise<SdkResult<Bundle>>;
-    /** Cross-sell / related / upsell products for a product */
-    getCrossSell(productSlug: string): Promise<SdkResult<{
-        related: CrossSellItem[];
-        upsell: CrossSellItem[];
-        crossSell: CrossSellItem[];
-    }>>;
-    /** Active promotions applicable to a product (with countdown end time) */
-    /** Back-in-stock notification subscription for a sold-out product. */
-    notifyWhenAvailable(productId: string, email: string): Promise<SdkResult<BackInStockSubscription>>;
-    getProductPromotions(productSlug: string): Promise<SdkResult<{
-        items: ActivePromotion[];
-    }>>;
-    /** Check a gift card code — returns validity and remaining balance */
-    checkGiftCard(code: string): Promise<SdkResult<GiftCardBalance>>;
-    /** List configured payment methods (filtered by currency). */
-    listPaymentMethods(opts?: {
-        currency?: string;
-    }): Promise<SdkResult<{
-        items: CheckoutPaymentMethod[];
-    }>>;
-}
-declare class AuthModule {
-    private client;
-    constructor(client: BehioStorefront);
-    /** Register a new customer */
-    register(input: RegisterInput): Promise<SdkResult<AuthTokens>>;
-    /** Login with email and password */
-    login(input: LoginInput): Promise<SdkResult<AuthTokens>>;
-    /** Refresh access token using refresh token */
-    refresh(refreshToken?: string): Promise<SdkResult<AuthTokens>>;
-    /** Logout (invalidate refresh token) */
-    logout(refreshToken?: string): Promise<SdkResult<MessageResponse>>;
-    /** Request password reset email */
-    forgotPassword(email: string): Promise<SdkResult<MessageResponse>>;
-    /** Reset password with token */
-    resetPassword(token: string, newPassword: string): Promise<SdkResult<MessageResponse>>;
-    /** Verify email with token */
-    verifyEmail(token: string): Promise<SdkResult<MessageResponse>>;
-    /** Check if user is logged in (has access token) */
-    isLoggedIn(): boolean;
-}
-declare class CartModule {
-    private client;
-    constructor(client: BehioStorefront);
-    /** Get current cart */
-    get(): Promise<SdkResult<Cart>>;
-    /** Add item to cart */
-    addItem(input: AddToCartInput): Promise<SdkResult<Cart & {
-        newSessionToken?: string;
-    }>>;
-    /** Update item quantity */
-    updateQuantity(itemId: string, quantity: number): Promise<SdkResult<Cart>>;
-    /** Remove item from cart */
-    removeItem(itemId: string): Promise<SdkResult<Cart>>;
-    /** Clear entire cart */
-    clear(): Promise<SdkResult<void>>;
-    /** Apply a gift card code to the cart. Balance is deducted at checkout. */
-    applyGiftCard(code: string): Promise<SdkResult<Cart>>;
-    /** Remove a gift card from the cart */
-    removeGiftCard(): Promise<SdkResult<Cart>>;
-    /**
-     * Add a bundle to the cart. Price is snapshotted at the bundle's current
-     * price. Pass either the bundle id or its slug — slug is more ergonomic
-     * for static storefront wiring (`behio.cart.addBundle({slug: "morning-set"})`).
-     *
-     * Respects the bundle's `minQuantity`, `maxQuantity`, and `stockLimit`:
-     * the request rejects with HTTP 400 if the resulting cart line would
-     * violate any of them. The returned error includes the relevant field
-     * (`minQuantity`, `maxQuantity`, or `remaining`) so the storefront can
-     * surface a meaningful message.
-     *
-     * @param identifier Either `{id: bundleId}` or `{slug: bundleSlug}`. As a
-     *                   convenience, passing a plain string is treated as the
-     *                   bundle id for backwards compatibility.
-     * @param quantity   How many bundles to add (defaults to 1). Capped by
-     *                   the bundle's `maxQuantity` if set.
-     */
-    addBundle(identifier: string | {
-        id: string;
-    } | {
-        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>>;
-    /** Merge anonymous cart into authenticated customer cart */
-    merge(): Promise<SdkResult<Cart>>;
-    /** Apply discount code */
-    applyDiscount(code: string): Promise<SdkResult<Cart>>;
-    /** Remove discount code */
-    removeDiscount(): Promise<SdkResult<Cart>>;
-}
-declare class CheckoutModule {
-    private client;
-    constructor(client: BehioStorefront);
-    /** Create order from cart */
-    createOrder(input: CheckoutInput): Promise<SdkResult<OrderDetail>>;
-}
-declare class OrdersModule {
-    private client;
-    constructor(client: BehioStorefront);
-    /** List customer orders (requires auth) */
-    list(options?: {
-        page?: number;
-        limit?: number;
-    }): Promise<SdkResult<PaginatedResponse<OrderListItem>>>;
-    /** Get order detail (requires auth) */
-    get(orderNumber: string): Promise<SdkResult<OrderDetail>>;
-    /** Cancel a PENDING order (requires auth) */
-    cancel(orderNumber: string): Promise<SdkResult<OrderDetail>>;
-    /**
-     * Track an order by tracking token (no login, only API key). Returns a
-     * PII-minimized view: order status + items + masked email + destination
-     * city, never full address / phone / billing — the token travels in URLs
-     * and e-mails so it must not expose full personal data.
-     */
-    track(trackingToken: string): Promise<SdkResult<OrderTracking>>;
-    /**
-     * Step 1 of guest order-access: request a 6-digit code e-mailed to the
-     * address on the order. The response is always generic (success) regardless
-     * of whether the order number + e-mail match, so order numbers can't be
-     * enumerated. No login, only API key.
-     */
-    requestAccessCode(orderNumber: string, email: string): Promise<SdkResult<OrderAccessRequestResponse>>;
-    /**
-     * Step 2 of guest order-access: verify the e-mailed code. On success returns
-     * the FULL order detail plus a short-lived `accessToken` you can pass to
-     * {@link getByAccessToken} to re-fetch the detail without re-entering the
-     * code. No login, only API key.
-     */
-    verifyAccessCode(orderNumber: string, email: string, code: string): Promise<SdkResult<OrderAccessVerifyResponse>>;
-    /**
-     * Re-fetch a guest order's full detail using the `accessToken` returned by
-     * {@link verifyAccessCode}. The token is scoped to that single order and
-     * expires after 30 minutes.
-     */
-    getByAccessToken(accessToken: string): Promise<SdkResult<OrderDetail>>;
-}
-declare class CustomerModule {
-    private client;
-    constructor(client: BehioStorefront);
-    /** Get customer profile */
-    getProfile(): Promise<SdkResult<CustomerProfile>>;
-    /** Update customer profile */
-    updateProfile(data: Partial<Pick<CustomerProfile, "firstName" | "lastName" | "phone">>): Promise<SdkResult<CustomerProfile>>;
-    /** Change password */
-    changePassword(currentPassword: string, newPassword: string): Promise<SdkResult<MessageResponse>>;
-    /** List addresses */
-    getAddresses(): Promise<SdkResult<{
-        items: CustomerAddress[];
-    }>>;
-    /** Create address */
-    createAddress(address: Omit<CustomerAddress, "id">): Promise<SdkResult<CustomerAddress>>;
-    /** Update address */
-    updateAddress(addressId: string, data: Partial<CustomerAddress>): Promise<SdkResult<CustomerAddress>>;
-    /** Delete address */
-    deleteAddress(addressId: string): Promise<SdkResult<void>>;
-}
-declare class PagesModule {
-    private client;
-    constructor(client: BehioStorefront);
-    /** List CMS pages */
-    list(locale?: string): Promise<SdkResult<{
-        pages: Page[];
-    }>>;
-    /** Get page by slug */
-    get(slug: string, locale?: string): Promise<SdkResult<PageDetail>>;
-}
-declare class WishlistModule {
-    private client;
-    constructor(client: BehioStorefront);
-    get(): Promise<SdkResult<{
-        items: WishlistItem[];
-    }>>;
-    add(productId: string): Promise<SdkResult<{
-        success: boolean;
-    }>>;
-    remove(productId: string): Promise<SdkResult<{
-        success: boolean;
-    }>>;
-    isInWishlist(productId: string): Promise<SdkResult<{
-        inWishlist: boolean;
-    }>>;
-}
-declare class ReviewsModule {
-    private client;
-    constructor(client: BehioStorefront);
-    getProductReviews(productId: string, page?: number, limit?: number): Promise<SdkResult<ProductReviewsResponse>>;
-    submit(input: SubmitReviewInput): Promise<SdkResult<{
-        id: string;
-    }>>;
-    voteHelpful(reviewId: string, helpful: boolean): Promise<SdkResult<{
-        success: boolean;
-    }>>;
-}
-declare class ReturnsModule {
-    private client;
-    constructor(client: BehioStorefront);
-    /**
-     * Guest order lookup for the EU withdrawal form: order number + the email
-     * used on the order resolve to the order id and per-item returnable
-     * quantities. POST so the email never appears in a URL.
-     */
-    lookupOrder(orderNumber: string, email: string): Promise<SdkResult<ReturnableOrder>>;
-    submit(input: SubmitReturnInput): Promise<SdkResult<ReturnRequest>>;
-    /** Email is the ownership gate; POST so it never lands in a URL / log. */
-    getStatus(returnId: string, email: string): Promise<SdkResult<ReturnStatus>>;
-}
-declare class ConsentModule {
-    private client;
-    constructor(client: BehioStorefront);
-    record(input: CookieConsentInput): Promise<SdkResult<CookieConsent>>;
-    get(visitorId: string): Promise<SdkResult<CookieConsent | null>>;
-    revoke(visitorId: string): Promise<SdkResult<{
-        success: boolean;
-    }>>;
-}
-declare class QuotesModule {
-    private client;
-    constructor(client: BehioStorefront);
-    submit(input: SubmitQuoteInput): Promise<SdkResult<QuoteRequest>>;
-    accept(quoteId: string, email: string): Promise<SdkResult<QuoteRequest>>;
-    /** 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>>;
-}
-interface AddressSuggestion {
-    placeId: string;
-    description: string;
-    street: string;
-    city: string;
-    zip: string;
-    country: string;
-    countryCode: string;
-}
-interface AddressDetail {
-    street: string;
-    streetNumber: string;
-    city: string;
-    zip: string;
-    country: string;
-    countryCode: string;
-    formattedAddress: string;
-    lat: number;
-    lng: number;
-}
-declare class AddressModule {
-    private client;
-    constructor(client: BehioStorefront);
-    /** Search for address suggestions (debounce on your side, or use the React hook) */
-    autocomplete(query: string, country: string): Promise<SdkResult<{
-        suggestions: AddressSuggestion[];
-    }>>;
-    /** Get full structured address from a suggestion's placeId */
-    getDetail(placeId: string): Promise<SdkResult<AddressDetail>>;
-}
 /**
- * Storefront shipping module — list configured methods and fetch live
- * quotes for a destination + cart. Use `listMethods` for the always-on
- * picker (sidebar, info page) and `quote` once the customer enters a
- * destination address so live-quote providers (Zaslat etc.) can return
- * destination-specific prices.
+ * Format a price amount with currency using Intl.NumberFormat.
+ *
+ * @param amount - The price amount (e.g. 1499, 24.99)
+ * @param currency - ISO 4217 currency code (e.g. "CZK", "EUR", "USD")
+ * @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 class ShippingModule {
-    private client;
-    constructor(client: BehioStorefront);
-    /**
-     * Return the configured shipping methods that pass the current
-     * currency + country filter. Fixed-price methods come back with
-     * their `pricing[]` row resolved; live-quote methods come back with
-     * `price` 0 here — call `quote()` to get the real live price.
-     */
-    listMethods(opts?: {
-        currency?: string;
-        country?: string;
-        cartTotal?: number;
-        cartWeightKg?: number;
-    }): Promise<SdkResult<{
-        items: ShippingMethodSummary[];
-    }>>;
-    /**
-     * Quote shipping for a destination address + cart contents. Each
-     * configured method is evaluated:
-     *   - `priceStrategy="fixed"` → resolved from the merchant's per-currency
-     *     `pricing[]` rows + free-shipping threshold check.
-     *   - `priceStrategy="live_quote"` → dispatched to the upstream
-     *     meta-provider (Zaslat, future Shippo / Sendcloud / …) and run
-     *     through the merchant's markup/rounding rules.
-     *
-     * Filter `available: true` for the checkout picker; `available: false`
-     * rows carry a `reason` (`"no_rate_returned"`, `"live_quote_not_implemented"`,
-     * …) you can log but should not display.
-     */
-    quote(input: ShippingQuoteInput): Promise<SdkResult<{
-        items: ShippingQuote[];
-    }>>;
-}
+declare function formatPrice(amount: number, currency: string, locale?: string): string;
 
-export { type ActivePromotion, type AddToCartInput, type AddressDetail, type AddressSuggestion, type AddressType, AddressTypes, type AuthTokens, type BackInStockSubscription, BehioApiError, type BehioErrorCode, type BehioEventHandler, type BehioEventType, BehioNetworkError, BehioStorefront, type BehioStorefrontConfig, type Bundle, type BundleItem, type Cart, type CartDiscount, type CartItem, type CartItemProduct, type Category, type CategoryDetail, type CheckoutAddress, type CheckoutInput, type CheckoutPaymentMethod, type CookieConsent, type CookieConsentInput, type CrossSellItem, type CustomerAddress, type CustomerProfile, type DataGroupFieldType, type FilterField, type FulfillmentStatus, FulfillmentStatuses, type GiftCardBalance, type LoginInput, type MessageResponse, type OrderAccessRequestResponse, type OrderAccessVerifyResponse, type OrderDetail, type OrderItem, type OrderListItem, type OrderStatus, type OrderStatusHistory, OrderStatuses, type OrderTracking, type Page, type PageAttachment, type PageDetail, type PaginatedResponse, type PaymentStatus, PaymentStatuses, type ProductDetail, type ProductLabel, type ProductListItem, type ProductMedia, type ProductMediaVariant, type ProductPrice, type ProductReview, type ProductReviewsResponse, ProductSort, type ProductSortValue, type ProductVariant, type ProductVolumePrice, type ProductsQuery, type QuoteItem, type QuoteRequest, type RegisterInput, type RequestInterceptor, type RequestInterceptorConfig, type ResponseInterceptor, type ResponseInterceptorData, type ReturnRequest, type ReturnRequestItem, type ReturnStatus, type ReturnStatusItem, type ReturnableOrder, type ReturnableOrderItem, type SdkError, type SdkResult, type ShippingMethodSummary, type ShippingQuote, type ShippingQuoteInput, type ShopInfo, type ShopSeo, type SubmitQuoteInput, type SubmitReturnInput, type SubmitReviewInput, type WishlistItem, err, ok, toSdkError };
+export { formatPrice };