@behio/storefront-sdk 1.9.0 → 1.18.0

package/dist/react.d.ts

@@ -156,6 +156,13 @@ interface CheckoutSettings {
     requireGdprConsent: boolean;
     /** Default state of the newsletter opt-in on the checkout (or hide it). */
     newsletterOptInDefault: NewsletterOptInDefault;
+    /**
+     * Merchant collects consent for marketing SMS in the checkout. When true,
+     * render an OPTIONAL, unchecked checkbox in the contact step and send the
+     * answer as `smsConsent` in `checkout.createOrder`. Never make it required:
+     * order updates are transactional and need no consent, marketing does.
+     */
+    collectSmsConsent: boolean;
     /** Minimum order value in the shop default currency, or null when unset. */
     minOrderValue: number | null;
     /** Maximum order value in the shop default currency, or null when unset. */
@@ -229,6 +236,21 @@ interface ShopInfo {
      * than hardcoded template config.
      */
     quotesEnabled: boolean;
+    /**
+     * Countries the shop delivers to, derived from the ENABLED shipping methods
+     * (union of their allowed countries). `null` = no restriction (some enabled
+     * method ships anywhere), `[]` = no enabled shipping method. Limit the
+     * checkout country select to this list so a shopper from an unserved
+     * country learns it up front, not at the shipping step. Optional because
+     * cached ShopInfo payloads predating SDK 1.15.0 may still be served.
+     */
+    shippingCountries?: string[] | null;
+    /**
+     * Default currency per delivery country, e.g. `{SK: "EUR"}`. When the
+     * shopper picks such a country, switch the cart with `cart.setCurrency()`
+     * (and the display currency) unless they chose one themselves. SDK 1.17.0.
+     */
+    currencyByCountry?: Record<string, string>;
     /** Full merchant checkout & cart contract. Honour these in cart + checkout. */
     checkout: CheckoutSettings;
     /**
@@ -325,6 +347,45 @@ interface CheckoutPaymentMethod {
     feeCurrency?: string | null;
     /** Customer-safe slice of config: bank account, IBAN, instructions, … */
     publicConfig?: Record<string, unknown>;
+    /**
+     * Concrete payment instruments the provider offers for this method
+     * (card, Google Pay, Apple Pay, bank transfer with a bank grid, ...).
+     * Gateways such as GoPay require the customer to choose the instrument
+     * ALREADY IN THE CHECKOUT, so render them as tiles under the selected method
+     * and send the chosen `code` as `paymentInstrument` in `createOrder` (plus
+     * `paymentSwift` for `BANK_ACCOUNT`). `null` = the provider has no
+     * instruments (cash on delivery, plain bank transfer, Stripe hosted page);
+     * render nothing extra and send nothing extra. SDK 1.14.0.
+     */
+    instruments?: PaymentInstrument[] | null;
+}
+/**
+ * One payment instrument of a gateway method (SDK 1.14.0). The first item is
+ * the sensible default (card for GoPay). `swifts` is non-empty only for
+ * `BANK_ACCOUNT`, where the customer additionally picks a bank.
+ */
+interface PaymentInstrument {
+    /** Provider code: "PAYMENT_CARD" | "BANK_ACCOUNT" | "GPAY" | "APPLE_PAY" | "PAYPAL" | ... */
+    code: string;
+    /** Localized label (requested `locale`), e.g. "Platební karta". */
+    label: string;
+    /** Small logo URL or null. */
+    image: string | null;
+    /** Larger logo URL or null. */
+    imageLarge: string | null;
+    /** Banks for `BANK_ACCOUNT`; empty for every other instrument. */
+    swifts: PaymentSwift[];
+}
+/** One bank of a `BANK_ACCOUNT` instrument (SDK 1.14.0). */
+interface PaymentSwift {
+    /** SWIFT/BIC, e.g. "FIOBCZPP". Send it as `paymentSwift`. */
+    code: string;
+    /** Localized bank name. */
+    label: string;
+    /** Bank logo URL or null. */
+    image: string | null;
+    /** Instant online bank payment; show these first. */
+    online: boolean;
 }
 interface ProductPrice {
     amount: number;
@@ -1052,6 +1113,12 @@ type AddressType = (typeof AddressTypes)[keyof typeof AddressTypes];
 interface ProductsQuery {
     page?: number;
     limit?: number;
+    /**
+     * Delivery country (ISO-2). Lets country-scoped price rules (for example a
+     * surcharge for SK) apply in the listing; the cart and checkout use the
+     * cart destination instead.
+     */
+    country?: string;
     /** Single category slug (OR logic with categories array) */
     category?: string;
     /** Multiple category slugs (OR logic — product in ANY of these categories) */
@@ -1204,20 +1271,48 @@ interface Cart {
     id: string;
     sessionToken?: string;
     items: CartItem[];
+    /** Sum of the lines at catalog prices: VAT included when the shop runs
+     *  `INCL_VAT`, VAT excluded when it runs `EXCL_VAT`. Not the payable amount,
+     *  that is `grandTotal`. */
     subtotal: number;
+    /** Discount from the applied code. Always based on `subtotal`, i.e. on the
+     *  prices the customer sees, so "10 % off 200" is 20 in both price modes. */
     discountTotal: number;
     discount?: CartDiscount;
     /** Auto-apply promotion discount lines (sale/BOGO). */
     appliedPromotions: CartPromotion[];
     /** Sum of `appliedPromotions[].discountAmount`; already reflected in `grandTotal`. */
     promotionDiscountTotal: number;
+    /** THE PAYABLE AMOUNT for the goods, VAT included, after discounts. This is
+     *  exactly what the customer pays for the cart lines, minus shipping and the
+     *  payment-method fee (both chosen at checkout and added to
+     *  `order.grandTotal`).
+     *
+     *  `grandTotal = netSubtotal + taxTotal - discounts` holds in BOTH price
+     *  modes: under `INCL_VAT` the VAT is extracted out of the price (the sum is
+     *  back to the catalog price), under `EXCL_VAT` it is added on top. Render
+     *  this as the cart total; do not add `taxTotal` to it. */
     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. */
+    /** VAT contained in the prices (`INCL_VAT`) or added on top of them
+     *  (`EXCL_VAT`), 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[];
+    /** Delivery country set via `cart.setDestination()`, null until known. SDK 1.17.0. */
+    shippingCountry: string | null;
+    /**
+     * Which VAT rule the cart uses: `DOMESTIC` (home rate), `OSS` (delivery
+     * country rate), `REVERSE_CHARGE` (EU business with a valid VAT ID, 0 %),
+     * `EXPORT` (outside the EU, 0 %). Show a note for the last two: the
+     * breakdown is empty then. SDK 1.17.0.
+     */
+    vatMode: "DOMESTIC" | "OSS" | "REVERSE_CHARGE" | "EXPORT";
+    /** B2B VAT ID set via `cart.setDestination()`. */
+    vatId: string | null;
+    /** VIES result for `vatId`: true valid, false invalid or unverifiable, null not given. */
+    vatIdValid: boolean | null;
     currency: string;
     itemCount: number;
     /** Applied gift cards (multi). They deduct at checkout (consumed in order, each
@@ -1275,6 +1370,8 @@ interface CheckoutAddress {
     street: string;
     city: string;
     zip: string;
+    /** State / province where the country needs it (US, CA, AU, BR, IN, MX). SDK 1.17.0. */
+    state?: string;
     country: string;
     phone?: string;
 }
@@ -1299,6 +1396,14 @@ interface CheckoutInput {
     termsConsent?: boolean;
     gdprConsent?: boolean;
     newsletterOptIn?: boolean;
+    /**
+     * Consent to marketing SMS, from the optional checkout checkbox. Render it
+     * only when `ShopInfo.checkout.collectSmsConsent` is true; shops that do not
+     * collect consent ignore the flag. The consent is stored against the phone
+     * number on the created order, so it needs a usable phone in the order or
+     * the shipping address, and it never blocks or fails the order.
+     */
+    smsConsent?: boolean;
     /**
      * Chosen shipping method. Required whenever the eshop has at least one
      * enabled shipping method — the backend rejects the order without it.
@@ -1318,7 +1423,33 @@ interface CheckoutInput {
      * the backend rejects the order without it. Snapshotted onto the order.
      */
     pickupPointId?: string;
+    /**
+     * Snapshot of the chosen point when it came from a carrier widget and may
+     * not be in Behio's cache yet (Packeta serves partner points too). Sent
+     * along with `pickupPointId`; ignored when the cache knows the point.
+     * SDK 1.16.0.
+     */
+    pickupPoint?: {
+        name: string;
+        street?: string;
+        city?: string;
+        zip?: string;
+        country?: string;
+    };
     paymentMethodId?: string;
+    /**
+     * Chosen instrument `code` of the payment method (SDK 1.14.0), e.g.
+     * "PAYMENT_CARD" | "GPAY" | "APPLE_PAY" | "BANK_ACCOUNT". Send it whenever the
+     * chosen method lists `instruments`; the gateway is then opened directly on
+     * that instrument. An instrument the method does not offer returns 400
+     * (`be.storefront.paymentInstrumentInvalid`).
+     */
+    paymentInstrument?: string;
+    /**
+     * Chosen bank SWIFT for `paymentInstrument: "BANK_ACCOUNT"` (SDK 1.14.0),
+     * from `PaymentInstrument.swifts[].code`. Ignored for other instruments.
+     */
+    paymentSwift?: string;
     /**
      * Loyalty points to redeem on this order. Validated server-side against the
      * customer's actual balance and the program's redemption cap; ignored for
@@ -1386,6 +1517,8 @@ interface OrderDetail extends OrderListItem {
     /** 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[];
+    /** 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;
     discountTotal: number;
     fulfillmentStatus: FulfillmentStatus;
@@ -1729,6 +1862,19 @@ interface CustomerAddress {
     city: string;
     zip: string;
     country: string;
+    /** State / region for countries that need it (US, CA, AU). */
+    state?: string | null;
+    /** Company registration number. */
+    companyId?: string | null;
+    /** VAT ID. EU numbers are verified in VIES when the address is saved. */
+    vatId?: string | null;
+    /**
+     * VIES result at save time: true = valid, false = not confirmed, null = no
+     * VAT ID or not an EU number. Read-only, the server sets it.
+     */
+    vatIdValid?: boolean | null;
+    /** When the VAT ID was last checked (ms). Read-only. */
+    vatIdCheckedAt?: number | null;
     phone?: string;
 }
 interface Page {
@@ -1757,6 +1903,159 @@ interface PageAttachment {
     mimeType: string;
     fileSize: number;
 }
+interface BlogSettings {
+    postsPerPage?: number;
+    showAuthor?: boolean;
+    showReadingTime?: boolean;
+    showTags?: boolean;
+    layout?: "grid" | "list" | "magazine";
+}
+/** One blog (a group of posts). A site can have several: news, recipes, stories. */
+interface Blog {
+    /** URL segment: /blog/{handle} */
+    handle: string;
+    name: string;
+    description: string | null;
+    postCount: number;
+    settings: BlogSettings;
+    /** Latest publish time (epoch ms), for sitemaps. */
+    updatedAt: number | null;
+}
+interface BlogTag {
+    slug: string;
+    name: string;
+}
+interface BlogPostListItem {
+    slug: string;
+    title: string;
+    excerpt: string | null;
+    coverUrl: string | null;
+    publishedAt: number | null;
+    readingTimeMin: number | null;
+    authorName: string | null;
+    isFeatured: boolean;
+    tags: BlogTag[];
+}
+interface BlogPostsPage {
+    items: BlogPostListItem[];
+    total: number;
+    page: number;
+    limit: number;
+    totalPages: number;
+    /** Tags of the blog (for a filter). */
+    tags: BlogTag[];
+}
+interface BlogPostDetail {
+    slug: string;
+    blogHandle: string;
+    blogName: string;
+    title: string;
+    excerpt: string | null;
+    /** `{format: "html", html}` sanitised by the API; render with RichText. */
+    content: {
+        format?: string;
+        html?: string;
+    } & Record<string, unknown>;
+    coverUrl: string | null;
+    publishedAt: number | null;
+    updatedAt: number | null;
+    readingTimeMin: number | null;
+    authorName: string | null;
+    tags: BlogTag[];
+    seoTitle: string | null;
+    seoDescription: string | null;
+    ogImage: string | null;
+    /** Other posts of the same blog. */
+    related: BlogPostListItem[];
+}
+interface BlogPostsQuery {
+    locale?: string;
+    page?: number;
+    limit?: number;
+    /** Filter by tag slug. */
+    tag?: string;
+}
+type SiteFormFieldType = "text" | "email" | "phone" | "textarea" | "number" | "select" | "radio" | "checkbox" | "multiselect" | "date"
+/** "HH:MM" */
+ | "time"
+/** "YYYY-MM-DDTHH:MM" without a zone, as `<input type="datetime-local">` */
+ | "datetime"
+/** http(s) address */
+ | "url" | "hidden";
+interface SiteFormFieldOption {
+    value: string;
+    label: string;
+}
+/** One field of a merchant-defined form; render it by `type`. */
+interface SiteFormField {
+    /** Key in the submitted `data` object (lowercase, underscores). */
+    key: string;
+    type: SiteFormFieldType;
+    label: string;
+    placeholder?: string;
+    /** Help line under the field. */
+    help?: string;
+    required: boolean;
+    /** Present for select / radio / multiselect. */
+    options?: SiteFormFieldOption[];
+    /** Number: min/max value. Text: min/max length. */
+    min?: number;
+    max?: number;
+    /** Regular expression for text fields (without slashes). */
+    pattern?: string;
+    /** Layout hint: "half" fields sit side by side on wide screens. */
+    width?: "full" | "half";
+    /** Value of hidden fields (source, campaign) or a prefill for visible ones. */
+    defaultValue?: string;
+}
+interface StorefrontFormSettings {
+    submitLabel?: string;
+    /** Shown after a successful submit (also returned as `message`). */
+    successMessage?: string;
+    /** When set, redirect the visitor here after a successful submit. */
+    redirectUrl?: string;
+    /** Text of the consent checkbox. */
+    consentText?: string;
+    /** When true, `consent: true` is required for the submit to pass. */
+    requireConsent?: boolean;
+}
+/** Public definition of a form (`GET /forms/{slug}`). */
+interface StorefrontForm {
+    slug: string;
+    name: string;
+    description: string | null;
+    fields: SiteFormField[];
+    settings: StorefrontFormSettings;
+}
+interface StorefrontFormSubmitInput {
+    /** `{fieldKey: value}`; unknown keys are dropped server-side. */
+    data: Record<string, unknown>;
+    locale?: string;
+    /** URL of the page the form was submitted from (context for the merchant). */
+    page?: string;
+    /** Consent checkbox state (required when `settings.requireConsent`). */
+    consent?: boolean;
+    /**
+     * Honeypot. Render it as a visually hidden input and pass its value through
+     * untouched: a filled value is answered like a success but stored nowhere.
+     */
+    website?: string;
+}
+interface StorefrontFormSubmitResult {
+    ok: boolean;
+    /** Id of the stored submission (null when the form does not store responses). */
+    id: string | null;
+    /** `settings.successMessage`, when set. */
+    message: string | null;
+    /** `settings.redirectUrl`, when set. */
+    redirectUrl: string | null;
+}
+type StorefrontFormFieldErrorCode = "required" | "invalid" | "tooShort" | "tooLong" | "min" | "max" | "notOption" | "pattern";
+/** One per-field validation error of a rejected submit (`be.forms.validationFailed`). */
+interface StorefrontFormFieldError {
+    key: string;
+    code: StorefrontFormFieldErrorCode;
+}
 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;
@@ -1944,11 +2243,6 @@ interface ShippingQuote extends ShippingMethodSummary {
     /** Quote expiry (epoch ms). Null for fixed-price methods. */
     expiresAt: number | null;
 }
-/**
- * A pickup point (parcel shop / locker) for a shipping method with
- * `supportsPickupPoints`. Fetch with `behio.shipping.getPickupPoints()`,
- * then send the chosen `externalId` as `checkout.pickupPointId`.
- */
 interface PickupPoint {
     /** Carrier-native id. Send this back as `checkout.pickupPointId`. */
     externalId: string;
@@ -2116,6 +2410,10 @@ interface GiftCardPurchaseInput {
     personalMessage?: string;
     /** Online payment method id (from listPaymentMethods) to start payment right away. */
     paymentMethodId?: string;
+    /** Instrument `code` of the chosen method (SDK 1.14.0), see `CheckoutInput.paymentInstrument`. */
+    paymentInstrument?: string;
+    /** Bank SWIFT for `paymentInstrument: "BANK_ACCOUNT"` (SDK 1.14.0). */
+    paymentSwift?: string;
     locale?: string;
 }
 interface GiftCardPurchaseResult {
@@ -2400,6 +2698,8 @@ declare class BehioStorefront {
     readonly orders: OrdersModule;
     readonly customer: CustomerModule;
     readonly pages: PagesModule;
+    readonly blog: BlogModule;
+    readonly forms: FormsModule;
     readonly wishlist: WishlistModule;
     readonly reviews: ReviewsModule;
     readonly returns: ReturnsModule;
@@ -2589,6 +2889,7 @@ declare class CatalogModule {
     getProduct(slug: string, options?: {
         locale?: string;
         currency?: string;
+        country?: string;
     }): Promise<SdkResult<ProductDetail>>;
     /**
      * URLs for the sitemap, already filtered by the merchant's indexing choice
@@ -2711,9 +3012,25 @@ declare class CatalogModule {
      * code is generated and emailed to the recipient once the order is paid.
      */
     purchaseGiftCard(input: GiftCardPurchaseInput): Promise<SdkResult<GiftCardPurchaseResult>>;
-    /** List configured payment methods (filtered by currency). */
+    /**
+     * List configured payment methods (filtered by currency). `locale` picks the
+     * language of `instruments[].label` / `swifts[].label` (SDK 1.14.0); pass the
+     * locale of the page so the instrument tiles read in the shopper's language.
+     */
     listPaymentMethods(opts?: {
         currency?: string;
+        locale?: string;
+        /** Delivery country (ISO): hides methods not valid there, orders them per country. SDK 1.15.0 */
+        country?: string;
+        /** Chosen shipping method: hides cash on delivery when the carrier cannot do it. SDK 1.15.0 */
+        shippingMethodId?: string;
+    }): Promise<SdkResult<{
+        items: CheckoutPaymentMethod[];
+    }>>;
+    /** Alias of `listPaymentMethods` (SDK 1.14.0). */
+    paymentMethods(opts?: {
+        currency?: string;
+        locale?: string;
     }): Promise<SdkResult<{
         items: CheckoutPaymentMethod[];
     }>>;
@@ -2763,6 +3080,22 @@ declare class CartModule {
      * ```
      */
     setCurrency(currency: string): Promise<SdkResult<Cart>>;
+    /**
+     * Tell the cart where the order will ship (and, for B2B, the buyer's VAT
+     * ID) so the VAT breakdown matches the checkout before the address form:
+     * destination-country rate (OSS), 0 % export outside the EU, or reverse
+     * charge for an EU business with a VIES-valid VAT ID. `cart.vatMode` says
+     * which rule applied. SDK 1.17.0.
+     *
+     * ```ts
+     * await client.cart.setDestination({ country: "SK" });
+     * await client.cart.setDestination({ vatId: "SK2020000001" }); // "" clears
+     * ```
+     */
+    setDestination(input: {
+        country?: string;
+        vatId?: string | null;
+    }): Promise<SdkResult<Cart>>;
     /** Update item quantity */
     updateQuantity(itemId: string, quantity: number): Promise<SdkResult<Cart>>;
     /** Remove item from cart */
@@ -2815,6 +3148,27 @@ declare class CheckoutModule {
 declare class OrdersModule {
     private client;
     constructor(client: BehioStorefront);
+    /**
+     * Ask the backend to re-check this order's payment with the gateway.
+     *
+     * Call it on the thank-you page the customer lands on after paying, BEFORE
+     * you read the order. Some gateways (Tatrapay+) have no server-to-server
+     * notification at all, so the customer's return is the only fast way the
+     * payment gets confirmed; for the others it is a safety net for a lost
+     * notification.
+     *
+     * The response is deliberately opaque (`{ok: true}` every time, even for an
+     * order number that does not exist): order numbers are sequential, so
+     * anything else would turn this into a probe for other people's orders.
+     * Read the actual state afterwards through a path that proves entitlement
+     * ({@link get}, {@link track} or the guest access-code flow).
+     *
+     * Never throws for a missing order and never blocks the page: treat a
+     * failure as "not confirmed yet", the backend poller catches up on its own.
+     */
+    syncPaymentOnReturn(orderNumber: string): Promise<SdkResult<{
+        ok: boolean;
+    }>>;
     /** List customer orders (requires auth) */
     list(options?: {
         page?: number;
@@ -2872,9 +3226,12 @@ declare class CustomerModule {
         items: CustomerAddress[];
     }>>;
     /** Create address */
-    createAddress(address: Omit<CustomerAddress, "id">): Promise<SdkResult<CustomerAddress>>;
-    /** Update address */
-    updateAddress(addressId: string, data: Partial<CustomerAddress>): Promise<SdkResult<CustomerAddress>>;
+    createAddress(address: Omit<CustomerAddress, "id" | "vatIdValid" | "vatIdCheckedAt">): Promise<SdkResult<CustomerAddress>>;
+    /**
+     * Update address. Partial: `{isDefault: true}` alone is a valid body. A
+     * changed `vatId` or `country` re-runs the VIES check on the server.
+     */
+    updateAddress(addressId: string, data: Partial<Omit<CustomerAddress, "id" | "vatIdValid" | "vatIdCheckedAt">>): Promise<SdkResult<CustomerAddress>>;
     /** Delete address */
     deleteAddress(addressId: string): Promise<SdkResult<void>>;
     /**
@@ -2995,6 +3352,37 @@ declare class PagesModule {
     /** Get page by slug */
     get(slug: string, locale?: string): Promise<SdkResult<PageDetail>>;
 }
+declare class BlogModule {
+    private client;
+    constructor(client: BehioStorefront);
+    /** List the site's blogs (active only). */
+    list(locale?: string): Promise<SdkResult<{
+        blogs: Blog[];
+    }>>;
+    /** Published posts of one blog, newest first (featured first), paginated. */
+    posts(handle: string, query?: BlogPostsQuery): Promise<SdkResult<BlogPostsPage>>;
+    /** One published post with sanitised HTML content and related posts. */
+    post(handle: string, slug: string, locale?: string): Promise<SdkResult<BlogPostDetail>>;
+}
+/**
+ * Merchant-defined forms (contact, demand, registration to an event...).
+ * The definition is public and cacheable; a submit is validated server-side
+ * against it, so the browser-side checks are only a courtesy. Works with
+ * website keys that have no e-shop attached.
+ */
+declare class FormsModule {
+    private client;
+    constructor(client: BehioStorefront);
+    /** Public definition of one form (fields + settings). 404 for an unknown or inactive slug. */
+    get(slug: string): Promise<SdkResult<StorefrontForm>>;
+    /**
+     * Submit a response. On `be.forms.validationFailed` the returned error
+     * carries per-field codes: read them with `formFieldErrors(error)`. Other
+     * rejections: `be.forms.consentRequired`, `be.forms.tooLarge`,
+     * `be.forms.formNotFound`; rate limit 10 submits per minute per visitor.
+     */
+    submit(slug: string, input: StorefrontFormSubmitInput): Promise<SdkResult<StorefrontFormSubmitResult>>;
+}
 declare class WishlistModule {
     private client;
     constructor(client: BehioStorefront);
@@ -3705,12 +4093,18 @@ interface UsePaymentMethodsOptions {
     /** ISO 4217 code; defaults to the active currency. Methods that do not
      *  support the currency are filtered out server-side. */
     currency?: string;
+    /** Language of `instruments[].label` / `swifts[].label` (SDK 1.14.0);
+     *  pass the page locale so instrument tiles read in the shopper's language. */
+    locale?: string;
     enabled?: boolean;
 }
 /**
  * Merchant payment methods for the checkout (GAP-20). `publicConfig` carries
  * customer-safe provider hints (e.g. `redirectFlow`, `offline`, bank account
- * for transfers); `fee` is the optional payment surcharge.
+ * for transfers); `fee` is the optional payment surcharge. `instruments`
+ * (SDK 1.14.0) lists the gateway's concrete instruments (card, Google Pay,
+ * Apple Pay, bank transfer with a bank grid) that the customer picks in the
+ * checkout; `null` means the method has none.
  */
 declare function usePaymentMethods(options?: UsePaymentMethodsOptions): {
     methods: CheckoutPaymentMethod[];
@@ -3957,6 +4351,55 @@ interface UsePageOptions {
 }
 declare function usePage(slug: string, locale?: string, options?: UsePageOptions): _tanstack_react_query.UseQueryResult<NoInfer<PageDetail>, Error>;
 
+interface UseBlogsOptions {
+    enabled?: boolean;
+}
+/** All active blogs of the site (a site can have several). */
+declare function useBlogs(locale?: string, options?: UseBlogsOptions): _tanstack_react_query.UseQueryResult<NoInfer<Blog[]>, Error>;
+interface UseBlogPostsOptions {
+    enabled?: boolean;
+}
+/** Published posts of one blog, paginated; `query.tag` filters by tag slug. */
+declare function useBlogPosts(handle: string, query?: BlogPostsQuery, options?: UseBlogPostsOptions): _tanstack_react_query.UseQueryResult<NoInfer<BlogPostsPage>, Error>;
+interface UseBlogPostOptions {
+    enabled?: boolean;
+}
+/** One published post (sanitised HTML content + related posts). */
+declare function useBlogPost(handle: string, slug: string, locale?: string, options?: UseBlogPostOptions): _tanstack_react_query.UseQueryResult<NoInfer<BlogPostDetail>, Error>;
+
+interface UseSiteFormOptions {
+    enabled?: boolean;
+}
+/** Public definition of a merchant-defined form (fields + settings). */
+declare function useSiteForm(slug: string, options?: UseSiteFormOptions): _tanstack_react_query.UseQueryResult<NoInfer<StorefrontForm>, Error>;
+/**
+ * Submit state of one form. `fieldErrors` maps a field key to its validation
+ * code (`required`, `invalid`, `tooShort`, `tooLong`, `min`, `max`,
+ * `notOption`, `pattern`) after a rejected submit; `errorCode` is the
+ * backend key (`be.forms.consentRequired`, `be.forms.validationFailed`, ...)
+ * for everything that is not tied to a single field.
+ *
+ *   const form = useSiteFormSubmit("contact");
+ *   await form.submit({data, consent, website: honeypot});
+ *   if (form.isSuccess) show(form.result?.message);
+ *   form.fieldErrors.email === "invalid"
+ */
+declare function useSiteFormSubmit(slug: string): {
+    /** Resolves to the result, or null when the submit was rejected (see `fieldErrors` / `errorCode`). */
+    submit: (input: StorefrontFormSubmitInput) => Promise<StorefrontFormSubmitResult | null>;
+    isSubmitting: boolean;
+    isSuccess: boolean;
+    /** `{ok, id, message, redirectUrl}` after a successful submit. */
+    result: StorefrontFormSubmitResult | null;
+    /** Field key -> validation code after a rejected submit. */
+    fieldErrors: Record<string, StorefrontFormFieldErrorCode>;
+    /** Backend error key (`be.forms.*`) or SDK code when the rejection is not per field. */
+    errorCode: string | null;
+    /** Raw SDK error (pass to `errorMessage(error, locale)` for a sentence). */
+    error: SdkError | null;
+    reset: () => void;
+};
+
 interface UseShopInfoOptions {
     enabled?: boolean;
 }
@@ -4753,4 +5196,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 Bundle, type BundleItem, type Cart, type CartDiscount, type CartItem, type Category, type CategoryDetail, type CheckoutAddress, type CheckoutInput, 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 PaymentStatus, 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 StorageAdapter, StorefrontScripts, type StorefrontScriptsProps, type SubmitQuoteInput, type SubmitReturnInput, type SubmitReviewInput, type UseAddressAutocompleteOptions, type UseAddressAutocompleteReturn, type UseAddressesOptions, 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 UseSubscriptionsOptions, type UseVisitorMessagesOptions, type VisitorMessage, type WishlistItem, cookieStorage, createMemoryStorage, detectStorage, formatPrice, generateVisitorId, getStoredVisitorId, grantAnalyticsConsent, localStorageAdapter, memoryStorage, revokeAnalyticsConsent, trackEcommerceEvent, useAddressAutocomplete, useAddresses, useAnalyticsEvents, useAuth, useBehio, useBehioClient, 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, 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, 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 };