@behio/storefront-sdk 2.23.0 → 2.25.1

package/dist/index.mjs

@@ -12,7 +12,7 @@ import {
   ok,
   publishCartSummary,
   toSdkError
-} from "./chunk-VHHDIU6J.mjs";
+} from "./chunk-GNWW2O3A.mjs";
 
 // src/react/utils/format-price.ts
 function formatPrice(amount, currency, locale, display) {
@@ -238,8 +238,25 @@ async function revokeAnalyticsConsent(client) {
 var ERROR_MESSAGES = {
   "cs": {
     "be.billing.apiDailyLimit": "Denn\xED limit vol\xE1n\xED API va\u0161eho tarifu ({limit}) je vy\u010Derpan\xFD. Obnov\xED se o p\u016Flnoci UTC, vy\u0161\u0161\xED tarif m\xE1 limit vy\u0161\u0161\xED.",
+    "be.bookings.bookingNotActive": "Rezervace u\u017E nen\xED aktivn\xED, tak\u017Ee ji nejde m\u011Bnit.",
+    "be.bookings.changeTooLate": "Na zm\u011Bnu nebo zru\u0161en\xED p\u0159es odkaz je u\u017E pozd\u011B. Ozv\u011Bte se n\xE1m pros\xEDm p\u0159\xEDmo.",
+    "be.bookings.manageNotFound": "Odkaz na rezervaci neplat\xED. Pou\u017Eijte pros\xEDm posledn\xED e-mail, kter\xFD v\xE1m p\u0159i\u0161el.",
+    "be.bookings.originNotAllowed": "Na tomto webu rezerva\u010Dn\xED widget nem\xE1 povolen\xED b\u011B\u017Eet.",
+    "be.bookings.rangeInvalid": "Konec obdob\xED je p\u0159ed za\u010D\xE1tkem.",
+    "be.bookings.rangeTooLong": "Vyberte nejv\xFD\u0161 {max} dn\xED.",
+    "be.bookings.rejected": "Rezervaci se nepoda\u0159ilo odeslat. Zkuste to pros\xEDm znovu.",
+    "be.bookings.serviceNotFound": "Slu\u017Eba nebyla nalezena nebo nen\xED dostupn\xE1.",
+    "be.bookings.servicesInvalid": "Vyberte aspo\u0148 jednu slu\u017Ebu.",
+    "be.bookings.servicesMixedCurrency": "Slu\u017Eby v jedn\xE9 rezervaci mus\xED m\xEDt stejnou m\u011Bnu.",
+    "be.bookings.slotTaken": "Tenhle term\xEDn si pr\xE1v\u011B n\u011Bkdo zarezervoval. Vyberte pros\xEDm jin\xFD.",
+    "be.bookings.staffCannotDoServices": "Vybran\xFD pracovn\xEDk tyto slu\u017Eby ned\u011Bl\xE1.",
+    "be.bookings.staffNotAvailable": "Vybran\xFD pracovn\xEDk te\u010F online rezervace nep\u0159ij\xEDm\xE1.",
+    "be.bookings.startInvalid": "Za\u010D\xE1tek rezervace nen\xED platn\xFD.",
+    "be.bookings.tooManyRequests": "P\u0159\xEDli\u0161 mnoho pokus\u016F. Zkuste to pros\xEDm za chv\xEDli.",
+    "be.bookings.widgetNotFound": "Rezervace tady nejsou dostupn\xE9.",
     "be.collections.collectionNotFound": "Kolekce nebyla nalezena.",
     "be.collections.itemNotFound": "Polo\u017Eka kolekce nebyla nalezena.",
+    "be.common.networkFailed": "Spojen\xED se serverem selhalo. Zkontrolujte p\u0159ipojen\xED a zkuste to znovu.",
     "be.common.notFound": "Tohle u\u017E neexistuje.",
     "be.forms.consentRequired": "Bez souhlasu nejde formul\xE1\u0159 odeslat.",
     "be.forms.fileFieldNotFound": "Formul\xE1\u0159 takov\xE9 pole pro soubor nem\xE1.",
@@ -262,6 +279,7 @@ var ERROR_MESSAGES = {
     "be.payments.goIdInvalid": "GoID nepat\u0159\xED k t\u011Bmto p\u0159\xEDstupov\xFDm \xFAdaj\u016Fm nebo neexistuje. Zkontrolujte GoID a tak\xE9 to, jestli sed\xED testovac\xED re\u017Eim.",
     "be.payments.returnNotFound": "N\xE1vratov\xE1 adresa z platebn\xED br\xE1ny nen\xED platn\xE1.",
     "be.payments.returnSecretMissing": "N\xE1vrat z platebn\xED br\xE1ny nen\xED na serveru nastaven\xFD.",
+    "be.payments.stripeAccountIncomplete": "Dokon\u010Dete aktivaci \xFA\u010Dtu ve Stripe. P\u0159ij\xEDm\xE1n\xED plateb nebo v\xFDplaty zat\xEDm nejsou povolen\xE9.",
     "be.payments.webhookMissingPaymentId": "Ozn\xE1men\xED od br\xE1ny {provider} neobsahuje identifik\xE1tor platby.",
     "be.payments.webhookSignatureInvalid": "Podpis platebn\xEDho ozn\xE1men\xED nen\xED platn\xFD.",
     "be.sms.accountInactive": "\xDA\u010Det u oper\xE1tora nen\xED aktivn\xED, tak\u017Ee p\u0159es n\u011Bj zpr\xE1vy neodejdou. Zkontrolujte ho v jeho administraci.",
@@ -485,6 +503,9 @@ var ERROR_MESSAGES = {
     "be.storefront.unknownPaymentProvider": "Nezn\xE1m\xFD poskytovatel plateb {provider}.",
     "be.storefront.variantsOnlyParent": "Produkt {name} nejde koupit p\u0159\xEDmo. Vyberte jednu z jeho variant.",
     "be.storefront.wishlistItemNotFound": "Polo\u017Eka obl\xEDben\xFDch nenalezena.",
+    "be.storefront.withdrawalAlreadySubmitted": "Od t\xE9to objedn\xE1vky u\u017E jste odstoupili, nebo u n\xED b\u011B\u017E\xED vr\xE1cen\xED v\u0161ech polo\u017Eek.",
+    "be.storefront.withdrawalDisabled": "Tento obchod online odstoupen\xED od smlouvy nenab\xEDz\xED. Napi\u0161te mu pros\xEDm e-mailem.",
+    "be.storefront.withdrawalNameRequired": "Vypl\u0148te pros\xEDm sv\xE9 jm\xE9no.",
     "be.web.webNotFound": "Web nebyl nalezen.",
     "be.validation.failed": "N\u011Bkter\xFD \xFAdaj nen\xED spr\xE1vn\u011B vypln\u011Bn\xFD. Zkontrolujte ho pros\xEDm.",
     "be.validation.required": "Toto pole je povinn\xE9.",
@@ -503,8 +524,25 @@ var ERROR_MESSAGES = {
   },
   "sk": {
     "be.billing.apiDailyLimit": "Denn\xFD limit volan\xED API v\xE1\u0161ho tarifu ({limit}) je vy\u010Derpan\xFD. Obnov\xED sa o polnoci UTC, vy\u0161\u0161\xED tarif m\xE1 vy\u0161\u0161\xED limit.",
+    "be.bookings.bookingNotActive": "Rezerv\xE1cia u\u017E nie je akt\xEDvna, tak\u017Ee ju nejde meni\u0165.",
+    "be.bookings.changeTooLate": "Na zmenu alebo zru\u0161enie cez odkaz je u\u017E neskoro. Ozvite sa n\xE1m pros\xEDm priamo.",
+    "be.bookings.manageNotFound": "Odkaz na rezerv\xE1ciu neplat\xED. Pou\u017Eite pros\xEDm posledn\xFD e-mail, ktor\xFD v\xE1m pri\u0161iel.",
+    "be.bookings.originNotAllowed": "Na tomto webe rezerva\u010Dn\xFD widget nem\xE1 povolenie be\u017Ea\u0165.",
+    "be.bookings.rangeInvalid": "Koniec obdobia je pred za\u010Diatkom.",
+    "be.bookings.rangeTooLong": "Vyberte najviac {max} dn\xED.",
+    "be.bookings.rejected": "Rezerv\xE1ciu sa nepodarilo odosla\u0165. Sk\xFAste to pros\xEDm znova.",
+    "be.bookings.serviceNotFound": "Slu\u017Eba nebola n\xE1jden\xE1 alebo nie je dostupn\xE1.",
+    "be.bookings.servicesInvalid": "Vyberte aspo\u0148 jednu slu\u017Ebu.",
+    "be.bookings.servicesMixedCurrency": "Slu\u017Eby v jednej rezerv\xE1cii musia ma\u0165 rovnak\xFA menu.",
+    "be.bookings.slotTaken": "Tento term\xEDn si pr\xE1ve niekto zarezervoval. Vyberte pros\xEDm in\xFD.",
+    "be.bookings.staffCannotDoServices": "Vybran\xFD pracovn\xEDk tieto slu\u017Eby nerob\xED.",
+    "be.bookings.staffNotAvailable": "Vybran\xFD pracovn\xEDk teraz online rezerv\xE1cie neprij\xEDma.",
+    "be.bookings.startInvalid": "Za\u010Diatok rezerv\xE1cie nie je platn\xFD.",
+    "be.bookings.tooManyRequests": "Pr\xEDli\u0161 ve\u013Ea pokusov. Sk\xFAste to pros\xEDm o chv\xED\u013Eu.",
+    "be.bookings.widgetNotFound": "Rezerv\xE1cie tu nie s\xFA dostupn\xE9.",
     "be.collections.collectionNotFound": "Kolekcia sa nena\u0161la.",
     "be.collections.itemNotFound": "Polo\u017Eka kolekcie sa nena\u0161la.",
+    "be.common.networkFailed": "Spojenie so serverom zlyhalo. Skontrolujte pripojenie a sk\xFAste to znova.",
     "be.common.notFound": "Toto u\u017E neexistuje.",
     "be.forms.consentRequired": "Bez s\xFAhlasu sa formul\xE1r ned\xE1 odosla\u0165.",
     "be.forms.fileFieldNotFound": "Formul\xE1r tak\xE9to pole pre s\xFAbor nem\xE1.",
@@ -527,6 +565,7 @@ var ERROR_MESSAGES = {
     "be.payments.goIdInvalid": "GoID nepatr\xED k t\xFDmto pr\xEDstupov\xFDm \xFAdajom alebo neexistuje. Skontrolujte GoID a tie\u017E to, \u010Di sed\xED testovac\xED re\u017Eim.",
     "be.payments.returnNotFound": "N\xE1vratov\xE1 adresa z platobnej br\xE1ny nie je platn\xE1.",
     "be.payments.returnSecretMissing": "N\xE1vrat z platobnej br\xE1ny nie je na serveri nastaven\xFD.",
+    "be.payments.stripeAccountIncomplete": "Dokon\u010Dite aktiv\xE1ciu \xFA\u010Dtu v Stripe. Prij\xEDmanie platieb alebo v\xFDplaty zatia\u013E nie s\xFA povolen\xE9.",
     "be.payments.webhookMissingPaymentId": "Ozn\xE1menie od br\xE1ny {provider} neobsahuje identifik\xE1tor platby.",
     "be.payments.webhookSignatureInvalid": "Podpis platobn\xE9ho ozn\xE1menia nie je platn\xFD.",
     "be.sms.accountInactive": "\xDA\u010Det u oper\xE1tora nie je akt\xEDvny, tak\u017Ee cez neho spr\xE1vy neod\xEDdu. Skontrolujte ho v jeho administr\xE1cii.",
@@ -750,6 +789,9 @@ var ERROR_MESSAGES = {
     "be.storefront.unknownPaymentProvider": "Nezn\xE1my poskytovate\u013E platieb {provider}.",
     "be.storefront.variantsOnlyParent": "Produkt {name} sa ned\xE1 k\xFApi\u0165 priamo. Vyberte jeden z jeho variantov.",
     "be.storefront.wishlistItemNotFound": "Polo\u017Eka ob\u013E\xFAben\xFDch sa nena\u0161la.",
+    "be.storefront.withdrawalAlreadySubmitted": "Od tejto objedn\xE1vky ste u\u017E odst\xFApili, alebo pri nej prebieha vr\xE1tenie v\u0161etk\xFDch polo\u017Eiek.",
+    "be.storefront.withdrawalDisabled": "Tento obchod online odst\xFApenie od zmluvy nepon\xFAka. Nap\xED\u0161te mu pros\xEDm e-mailom.",
+    "be.storefront.withdrawalNameRequired": "Vypl\u0148te pros\xEDm svoje meno.",
     "be.web.webNotFound": "Web sa nena\u0161iel.",
     "be.validation.failed": "Niektor\xFD \xFAdaj nie je spr\xE1vne vyplnen\xFD. Skontrolujte ho pros\xEDm.",
     "be.validation.required": "Toto pole je povinn\xE9.",
@@ -768,8 +810,25 @@ var ERROR_MESSAGES = {
   },
   "en": {
     "be.billing.apiDailyLimit": "Your plan's daily API limit ({limit} calls) has been reached. It resets at midnight UTC; higher plans have a higher limit.",
+    "be.bookings.bookingNotActive": "This booking is no longer active, so it cannot be changed.",
+    "be.bookings.changeTooLate": "It is too late to change or cancel through the link. Please contact us directly.",
+    "be.bookings.manageNotFound": "This booking link is not valid. Please use the latest e-mail you received.",
+    "be.bookings.originNotAllowed": "The booking widget is not allowed to run on this website.",
+    "be.bookings.rangeInvalid": "The end of the period is before its start.",
+    "be.bookings.rangeTooLong": "Choose at most {max} days.",
+    "be.bookings.rejected": "The booking could not be sent. Please try again.",
+    "be.bookings.serviceNotFound": "Service not found or not available.",
+    "be.bookings.servicesInvalid": "Choose at least one service.",
+    "be.bookings.servicesMixedCurrency": "Services in one booking must use the same currency.",
+    "be.bookings.slotTaken": "Someone has just booked this time. Please choose another one.",
+    "be.bookings.staffCannotDoServices": "The selected staff member does not provide these services.",
+    "be.bookings.staffNotAvailable": "The selected staff member is not taking online bookings right now.",
+    "be.bookings.startInvalid": "The booking start is not valid.",
+    "be.bookings.tooManyRequests": "Too many attempts. Please try again in a moment.",
+    "be.bookings.widgetNotFound": "Bookings are not available here.",
     "be.collections.collectionNotFound": "Collection not found.",
     "be.collections.itemNotFound": "Collection item not found.",
+    "be.common.networkFailed": "Connection to the server failed. Check your network and try again.",
     "be.common.notFound": "This no longer exists.",
     "be.forms.consentRequired": "The form cannot be sent without consent.",
     "be.forms.fileFieldNotFound": "This form has no such file field.",
@@ -792,6 +851,7 @@ var ERROR_MESSAGES = {
     "be.payments.goIdInvalid": "This GoID does not belong to these credentials or does not exist. Check the GoID, and check that test mode matches.",
     "be.payments.returnNotFound": "This payment return link is not valid.",
     "be.payments.returnSecretMissing": "Payment return is not configured on the server.",
+    "be.payments.stripeAccountIncomplete": "Complete your Stripe account activation. Payments or payouts are not enabled yet.",
     "be.payments.webhookMissingPaymentId": "The notification from {provider} does not contain a payment identifier.",
     "be.payments.webhookSignatureInvalid": "The payment notification signature is not valid.",
     "be.sms.accountInactive": "The operator account is not active, so nothing will go out through it. Check it in their administration.",
@@ -1015,6 +1075,9 @@ var ERROR_MESSAGES = {
     "be.storefront.unknownPaymentProvider": "Unknown payment provider",
     "be.storefront.variantsOnlyParent": "{name} cannot be purchased directly, choose one of its variants",
     "be.storefront.wishlistItemNotFound": "Wishlist item not found",
+    "be.storefront.withdrawalAlreadySubmitted": "You have already withdrawn from this order, or a return of every item is in progress.",
+    "be.storefront.withdrawalDisabled": "This shop does not offer online withdrawal. Please contact it by e-mail.",
+    "be.storefront.withdrawalNameRequired": "Please enter your name.",
     "be.web.webNotFound": "Website not found",
     "be.validation.failed": "Some of the details are not filled in correctly. Please check them.",
     "be.validation.required": "This field is required.",

package/dist/next.d.mts

@@ -1,4 +1,4 @@
-import { p as BehioStorefrontConfig, B as BehioStorefront } from './client-BeI4IFKu.mjs';
+import { p as BehioStorefrontConfig, B as BehioStorefront } from './client-Btc3Nduh.mjs';
 
 interface GetBehioOptions extends Partial<BehioStorefrontConfig> {
     /** Override the cart session cookie name (default: "behio_cart_session"). */

package/dist/next.d.ts

@@ -1,4 +1,4 @@
-import { p as BehioStorefrontConfig, B as BehioStorefront } from './client-BeI4IFKu.js';
+import { p as BehioStorefrontConfig, B as BehioStorefront } from './client-Btc3Nduh.js';
 
 interface GetBehioOptions extends Partial<BehioStorefrontConfig> {
     /** Override the cart session cookie name (default: "behio_cart_session"). */

package/dist/next.js

@@ -1,6 +1,6 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 
-var _chunkL7IIU5MZjs = require('./chunk-L7IIU5MZ.js');
+var _chunkIUC57IOBjs = require('./chunk-IUC57IOB.js');
 
 // src/next.ts
 var _headers = require('next/headers');
@@ -19,7 +19,7 @@ async function getBehio(options = {}) {
   const locale = _nullishCoalesce(options.locale, () => ( process.env.BEHIO_LOCALE));
   const currency = _nullishCoalesce(options.currency, () => ( process.env.BEHIO_CURRENCY));
   const cookieName = _nullishCoalesce(options.cartCookieName, () => ( CART_COOKIE_NAME));
-  const client = new (0, _chunkL7IIU5MZjs.BehioStorefront)({
+  const client = new (0, _chunkIUC57IOBjs.BehioStorefront)({
     apiKey,
     ...baseUrl ? { baseUrl } : {},
     ...locale ? { locale } : {},

package/dist/next.mjs

@@ -1,6 +1,6 @@
 import {
   BehioStorefront
-} from "./chunk-VHHDIU6J.mjs";
+} from "./chunk-GNWW2O3A.mjs";
 
 // src/next.ts
 import { cookies, headers } from "next/headers";

package/dist/react.d.mts

@@ -318,6 +318,20 @@ interface ShopInfo {
      * may still be served.
      */
     seo?: ShopSeoIdentity;
+    /**
+     * Online withdrawal function (Art. 11a Directive 2011/83/EU, mandatory in
+     * the EU from 19 Jun 2026). When `enabled`, render a clearly labelled link
+     * ("Withdraw from contract here") in the footer and in the customer account,
+     * leading to the withdrawal form (`returns.withdraw`). Optional because
+     * cached ShopInfo payloads predating the field may still be served (2.25.0).
+     */
+    withdrawal?: WithdrawalSettings;
+}
+/** Merchant setting of the online withdrawal function (2.25.0). */
+interface WithdrawalSettings {
+    enabled: boolean;
+    /** Withdrawal period in days from receipt of the goods (14 by law). */
+    periodDays: number;
 }
 interface ShopAppearance {
     primaryColor: string | null;
@@ -1843,7 +1857,22 @@ interface OrderPaymentInstructions {
     currency: string;
     instructions: string | null;
 }
+/** Issued document visible only to the authorized order owner. Its page offers a PDF download. */
+interface OrderDocument {
+    id: string;
+    number: string;
+    type: "INVOICE" | "PROFORMA" | "RECEIPT" | "CREDIT_NOTE";
+    currency: string;
+    totalAmount: number;
+    /** Actual invoice ledger amounts, independent of the order payment status. */
+    paidAmount: number;
+    remainingAmount: number;
+    /** Capability URL: do not expose in public tracking, analytics or logs. */
+    url: string;
+}
 interface OrderDetail extends OrderListItem {
+    /** Issued invoices/proformas/receipts/credit notes. Drafts and revoked links are excluded. */
+    documents?: OrderDocument[];
     /** Payment is recorded; access delivery will retry automatically. Do not place a duplicate order. */
     contentDeliveryPending?: boolean;
     /** False for an order without physical delivery. */
@@ -3147,9 +3176,70 @@ interface ReturnableOrder {
     orderId: string;
     orderNumber: string;
     status: string;
+    /** Name from the order billing address, to prefill the withdrawal form (2.25.0). */
+    customerName: string | null;
     items: ReturnableOrderItem[];
+    /** Withdrawal window of this order (2.25.0). */
+    withdrawal: WithdrawalWindow;
     createdAt: number;
 }
+/**
+ * What the withdrawal form should say about the period. The form stays
+ * usable outside the window: the consumer may always submit, the merchant
+ * decides. (2.25.0)
+ */
+interface WithdrawalWindow {
+    /** The e-shop offers the online withdrawal function. */
+    enabled: boolean;
+    periodDays: number;
+    /** Last moment of the period (ms). Null while it has not started or delivery is not recorded. */
+    deadlineAt: number | null;
+    /** False only when the period demonstrably ended. */
+    withinPeriod: boolean;
+    /** AFTER_DEADLINE | BEFORE_DISPATCH | DELIVERY_UNKNOWN | DIGITAL_CONTENT_CONSENT */
+    flags: WithdrawalFlag[];
+}
+type WithdrawalFlag = "AFTER_DEADLINE" | "BEFORE_DISPATCH" | "DELIVERY_UNKNOWN" | "DIGITAL_CONTENT_CONSENT";
+/**
+ * Input of `returns.withdraw()`: the withdrawal statement of Art. 11a(2):
+ * the consumer's name, the contract (order number) and the e-mail the
+ * acknowledgement goes to. Send it only after the consumer pressed the
+ * confirmation button ("Confirm withdrawal"), hence `confirmed: true`. (2.25.0)
+ */
+interface SubmitWithdrawalInput {
+    orderNumber: string;
+    /** Order e-mail: the ownership gate and where the acknowledgement is sent. */
+    email: string;
+    name: string;
+    /** Omit to withdraw from every still returnable item of the order. */
+    items?: {
+        orderItemId: string;
+        quantity: number;
+    }[];
+    note?: string;
+    confirmed: true;
+}
+/**
+ * Returned by `returns.withdraw()`. Show it as the acknowledgement: the same
+ * content with date and time also goes out by e-mail. `confirmationSent`
+ * says whether that e-mail really went out. (2.25.0)
+ */
+interface WithdrawalAcknowledgement {
+    id: string;
+    orderNumber: string;
+    customerName: string;
+    email: string;
+    /** Date and time of submission (ms). */
+    submittedAt: number;
+    items: {
+        productName: string;
+        quantity: number;
+    }[];
+    note: string | null;
+    deadlineAt: number | null;
+    withinPeriod: boolean;
+    confirmationSent: boolean;
+}
 interface ReturnRequestItem {
     id: string;
     orderItemId: string;
@@ -3180,6 +3270,8 @@ interface ReturnStatusItem {
 interface ReturnStatus {
     id: string;
     orderNumber: string;
+    /** WITHDRAWAL = withdrawal from the contract, RETURN = return or complaint (2.25.0). */
+    type: "RETURN" | "WITHDRAWAL";
     /** REQUESTED | APPROVED | SHIPPED_BACK | RECEIVED | REFUNDED | REJECTED | CLOSED */
     status: string;
     reason: string;
@@ -3339,6 +3431,145 @@ interface GamificationRefreshResult {
     awarded: number;
     completed: number;
 }
+type BookingLocale = "cs" | "sk" | "en";
+type BookingStatus = "PENDING" | "CONFIRMED" | "CANCELLED" | "NO_SHOW" | "COMPLETED";
+interface BookingService {
+    id: string;
+    categoryId: string | null;
+    name: string;
+    description: string | null;
+    durationMinutes: number;
+    /** Null = price on site (show it as such, never as 0). */
+    price: number | null;
+    /** ISO 4217 code (CZK, EUR, ...). */
+    currency: string;
+}
+interface BookingCategory {
+    id: string;
+    name: string;
+}
+interface BookingStaff {
+    id: string;
+    name: string;
+    title: string | null;
+    bio: string | null;
+    /** `#rrggbb` or null. */
+    color: string | null;
+    /** Services this person does. */
+    serviceIds: string[];
+}
+interface BookingLocation {
+    id: string;
+    name: string;
+    address: string | null;
+    timezone: string;
+}
+/** Public booking setup of the site owner (`GET /bookings/config`). */
+interface BookingConfig {
+    businessName: string;
+    intro: string | null;
+    /** `#rrggbb` brand colour of the widget, or null. */
+    accentColor: string | null;
+    defaultLocale: BookingLocale;
+    /** Offer a staff choice step (otherwise send `staffId: null`). */
+    allowStaffChoice: boolean;
+    /** New bookings start as PENDING and the business confirms them. */
+    requireApproval: boolean;
+    /** How many days ahead a customer may book. */
+    maxAdvanceDays: number;
+    /** Customer may change or cancel until this many hours before the start. */
+    customerCancelHours: number;
+    contactPhone: string | null;
+    contactEmail: string | null;
+    /**
+     * Online booking is paused (plan limit). Do not offer the flow, show the
+     * contact instead: `create` would answer `be.bookings.onlineLimitReached`.
+     */
+    onlinePaused: boolean;
+    /** IANA time zone of the branch; show every day and time in it. */
+    timezone: string;
+    locations: BookingLocation[];
+    categories: BookingCategory[];
+    services: BookingService[];
+    staff: BookingStaff[];
+}
+interface BookingSlot {
+    startMs: number;
+    endMs: number;
+}
+interface BookingSlots {
+    timezone: string;
+    /** Total length of the selected services. */
+    durationMinutes: number;
+    slots: BookingSlot[];
+}
+interface BookingSlotsQuery {
+    /** Selected services in the order they follow each other (1 to 10). */
+    serviceIds: string[];
+    /** Only this person; omit for anyone free. */
+    staffId?: string | null;
+    /** First day `YYYY-MM-DD` (branch time zone). */
+    from: string;
+    /** Last day `YYYY-MM-DD`, at most 31 days after `from`. */
+    to: string;
+}
+interface BookingManageSlotsQuery {
+    from: string;
+    to: string;
+}
+interface BookingCreateInput {
+    serviceIds: string[];
+    /** Null or omitted = anyone free. */
+    staffId?: string | null;
+    /** `startMs` of a slot from `getSlots`. */
+    startMs: number;
+    name: string;
+    email: string;
+    phone?: string | null;
+    note?: string | null;
+    /** Language of the confirmation email. */
+    locale?: BookingLocale;
+    /** Honeypot: render a hidden input and send its value; people leave it empty. */
+    website?: string;
+    /** Analytics visitor (consent-gated), only for the CRM. */
+    visitorId?: string | null;
+}
+/** One booking as the customer sees it. */
+interface Booking {
+    id: string;
+    /** Short code shown to the customer and in emails. */
+    code: string;
+    status: BookingStatus;
+    startMs: number;
+    endMs: number;
+    timezone: string;
+    businessName: string;
+    staffName: string;
+    locationName: string;
+    locationAddress: string | null;
+    services: string[];
+    serviceIds: string[];
+    /** Person chosen by the customer; null = anyone. */
+    staffId: string | null;
+    totalPrice: number | null;
+    currency: string;
+    customerName: string;
+    /** The customer may still change or cancel (deadline from the settings). */
+    canChange: boolean;
+    /** Until when (ms) the customer may change or cancel. */
+    changeDeadline: number | null;
+    /** Phone of the business to show once `canChange` is false. */
+    contactPhone: string | null;
+    locale: string;
+}
+interface BookingCreated {
+    booking: Booking;
+    /**
+     * Token for the change and cancel link (the same one the confirmation email
+     * carries). Treat it like a password: never put it in analytics or logs.
+     */
+    manageToken: string;
+}
 
 declare class BehioStorefront {
     private baseUrl;
@@ -3393,6 +3624,7 @@ declare class BehioStorefront {
     readonly forms: FormsModule;
     readonly collections: CollectionsModule;
     readonly faq: FaqModule;
+    readonly bookings: BookingsModule;
     readonly wishlist: WishlistModule;
     readonly reviews: ReviewsModule;
     readonly returns: ReturnsModule;
@@ -4146,6 +4378,49 @@ declare class FaqModule {
      */
     get(group: string, query?: StorefrontFaqQuery): Promise<SdkResult<StorefrontFaqGroup>>;
 }
+/**
+ * Online booking of the site owner's services (hair salon, clinic, lessons):
+ * the public setup, free times, a new booking, and the change and cancel flow
+ * behind the token from the confirmation email. Works with website keys that
+ * have no e-shop attached; the Bookings module must be on in the admin
+ * (otherwise 404 `be.bookings.widgetNotFound`).
+ *
+ * Days are `YYYY-MM-DD` in the branch time zone (`config.timezone`), not the
+ * visitor's; format times with `timeZone: config.timezone`.
+ *
+ * Errors worth handling: 409 `be.bookings.slotTaken` (someone was faster:
+ * reload the slots and let the customer pick again), 403
+ * `be.bookings.onlineLimitReached` (online booking paused, show the contact),
+ * 403 `be.bookings.changeTooLate` (too late to change, show
+ * `booking.contactPhone`), 404 `be.bookings.manageNotFound` (old or wrong
+ * token), 429 (rate limit: 10 new bookings and 20 changes per minute).
+ */
+declare class BookingsModule {
+    private client;
+    constructor(client: BehioStorefront);
+    /** Services, categories, staff, branches and rules of the booking flow. */
+    getConfig(): Promise<SdkResult<BookingConfig>>;
+    /** Free start times for the selected services (at most 31 days per call). */
+    getSlots(query: BookingSlotsQuery): Promise<SdkResult<BookingSlots>>;
+    /**
+     * Create a booking. Counts toward the monthly online limit of the plan.
+     * Keep `manageToken` only to link the customer to the change and cancel
+     * page; the same link arrives in the confirmation email.
+     */
+    create(input: BookingCreateInput): Promise<SdkResult<BookingCreated>>;
+    /** The booking behind the token from the confirmation email. */
+    getByToken(token: string): Promise<SdkResult<Booking>>;
+    /** Free times to move the booking to (same services and person rules). */
+    getManageSlots(token: string, query: BookingManageSlotsQuery): Promise<SdkResult<BookingSlots>>;
+    /** Cancel the booking (optional reason for the business). */
+    cancel(token: string, input?: {
+        reason?: string | null;
+    }): Promise<SdkResult<Booking>>;
+    /** Move the booking to `startMs` of a slot from `getManageSlots`. */
+    reschedule(token: string, input: {
+        startMs: number;
+    }): Promise<SdkResult<Booking>>;
+}
 /**
  * Merchant-defined forms (contact, demand, registration to an event...).
  * The definition is public and cacheable; a submit is validated server-side
@@ -4230,6 +4505,15 @@ declare class ReturnsModule {
      * quantities. POST so the email never appears in a URL.
      */
     lookupOrder(orderNumber: string, email: string): Promise<SdkResult<ReturnableOrder>>;
+    /**
+     * EU withdrawal function (Art. 11a Directive 2011/83/EU, 2.25.0). Two steps
+     * in the template: the form (name, order number, e-mail), then a summary
+     * with the "Confirm withdrawal" button that calls this. The result is the
+     * acknowledgement to show; the same content with date and time goes out by
+     * e-mail. Guests welcome, the order e-mail is the gate.
+     */
+    withdraw(input: SubmitWithdrawalInput): Promise<SdkResult<WithdrawalAcknowledgement>>;
+    /** Return or complaint. Reason CHANGED_MIND is recorded as a withdrawal on the server. */
     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>>;
@@ -5230,6 +5514,36 @@ declare function useSiteFormSubmit(slug: string): {
     reset: () => void;
 };
 
+interface UseBookingsOptions {
+    enabled?: boolean;
+}
+/** Public booking setup: services, staff, branches, rules (`client.bookings.getConfig`). */
+declare function useBookingConfig(options?: UseBookingsOptions): _tanstack_react_query.UseQueryResult<NoInfer<BookingConfig>, Error>;
+/**
+ * Free start times for the selected services. Disabled until at least one
+ * service is picked. Free times change with every booking, so the data is
+ * treated as stale after 30 seconds.
+ */
+declare function useBookingSlots(query: BookingSlotsQuery, options?: UseBookingsOptions): _tanstack_react_query.UseQueryResult<NoInfer<BookingSlots>, Error>;
+/**
+ * Create a booking. On 409 `be.bookings.slotTaken` the free times are
+ * refreshed automatically; show `errorMessage(error, locale)` and let the
+ * customer pick another time.
+ */
+declare function useCreateBooking(): _tanstack_react_query.UseMutationResult<BookingCreated, Error, BookingCreateInput, unknown>;
+/** The booking behind the token from the confirmation email. */
+declare function useManagedBooking(token: string, options?: UseBookingsOptions): _tanstack_react_query.UseQueryResult<NoInfer<Booking>, Error>;
+/** Free times to move a booking to. */
+declare function useManagedBookingSlots(token: string, query: BookingManageSlotsQuery, options?: UseBookingsOptions): _tanstack_react_query.UseQueryResult<NoInfer<BookingSlots>, Error>;
+/** Cancel the booking; the cached booking is replaced with the answer. */
+declare function useCancelBooking(token: string): _tanstack_react_query.UseMutationResult<Booking, Error, void | {
+    reason?: string | null;
+}, unknown>;
+/** Move the booking to a new start; the cached booking is replaced with the answer. */
+declare function useRescheduleBooking(token: string): _tanstack_react_query.UseMutationResult<Booking, Error, {
+    startMs: number;
+}, unknown>;
+
 interface UseShopInfoOptions {
     enabled?: boolean;
 }
@@ -5735,6 +6049,8 @@ declare function useLookupReturnableOrder(): _tanstack_react_query.UseMutationRe
     orderNumber: string;
     email: string;
 }, unknown>;
+/** EU withdrawal function: call after the consumer pressed "Confirm withdrawal" (2.25.0). */
+declare function useSubmitWithdrawal(): _tanstack_react_query.UseMutationResult<WithdrawalAcknowledgement, Error, SubmitWithdrawalInput, unknown>;
 declare function useSubmitReturn(): _tanstack_react_query.UseMutationResult<ReturnRequest, Error, SubmitReturnInput, unknown>;
 declare function useReturnStatus(returnId: string | undefined, email: string | undefined): _tanstack_react_query.UseQueryResult<NoInfer<ReturnStatus>, Error>;
 
@@ -6066,4 +6382,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 PageAttachment, 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, RichText, type RichTextProps, 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 UseCollectionOptions, type UseCourseCertificatesOptions, type UseCourseOptions, type UseCoursesOptions, type UseCurrencyResult, type UseCustomerOptions, type UseFacetsOptions, type UseFaqOptions, 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, useCollection, useCollectionItem, useCookieConsent, useCourse, useCourseCertificates, useCourses, useCrossSell, useCurrency, useCustomer, useFacets, useFaqGroup, useFaqGroups, 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 Booking, type BookingCategory, type BookingConfig, type BookingCreateInput, type BookingCreated, type BookingLocale, type BookingLocation, type BookingManageSlotsQuery, type BookingService, type BookingSlot, type BookingSlots, type BookingSlotsQuery, type BookingStaff, type BookingStatus, 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 PageAttachment, 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, RichText, type RichTextProps, 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 SubmitWithdrawalInput, type UseAddressAutocompleteOptions, type UseAddressAutocompleteReturn, type UseAddressesOptions, type UseBlogPostOptions, type UseBlogPostsOptions, type UseBlogsOptions, type UseBookingsOptions, type UseCartCountOptions, type UseCartOptions, type UseCategoriesOptions, type UseCategoryOptions, type UseCertificateVerificationOptions, type UseCollectionOptions, type UseCourseCertificatesOptions, type UseCourseOptions, type UseCoursesOptions, type UseCurrencyResult, type UseCustomerOptions, type UseFacetsOptions, type UseFaqOptions, 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, type WithdrawalAcknowledgement, type WithdrawalWindow, cookieStorage, createMemoryStorage, detectStorage, formatPrice, generateVisitorId, getStoredVisitorId, grantAnalyticsConsent, localStorageAdapter, memoryStorage, revokeAnalyticsConsent, trackEcommerceEvent, useAddressAutocomplete, useAddresses, useAnalyticsEvents, useAuth, useBehio, useBehioClient, useBlogPost, useBlogPosts, useBlogs, useBookingConfig, useBookingSlots, useBundle, useBundles, useCancelBooking, useCart, useCartCount, useCategories, useCategory, useCertificateVerification, useCheckout, useCheckoutPreview, useCollection, useCollectionItem, useCookieConsent, useCourse, useCourseCertificates, useCourses, useCreateBooking, useCrossSell, useCurrency, useCustomer, useFacets, useFaqGroup, useFaqGroups, useFeatured, useFilters, useGiftCardBalance, useIsInWishlist, useLabels, useLessonComments, useLessonNote, useLessonQuiz, useLessonTutor, useLookupReturnableOrder, useLoyalty, useManagedBooking, useManagedBookingSlots, useMenu, useNewsletterSubscribe, useNewsletterUnsubscribe, useNotifyWhenAvailable, useOrder, useOrderAccess, useOrders, usePage, usePages, usePaymentMethods, usePersonalOffers, usePickupPoints, useProduct, useProductGroup, useProductParameters, useProductPromotions, useProductReviews, useProducts, useQuoteStatus, useRescheduleBooking, useReturnStatus, useSearch, useShippingMethods, useShippingQuote, useShopInfo, useShopScripts, useShopSeo, useSiteForm, useSiteFormSubmit, useSubmitQuote, useSubmitReturn, useSubmitReview, useSubmitWithdrawal, useSubscriptions, useVisitorMessages, useWishlist };