@behio/storefront-sdk 2.23.0 → 2.25.0

package/dist/react.mjs

@@ -173,6 +173,7 @@ var BehioStorefront = class {
     this.forms = new FormsModule(this);
     this.collections = new CollectionsModule(this);
     this.faq = new FaqModule(this);
+    this.bookings = new BookingsModule(this);
     this.wishlist = new WishlistModule(this);
     this.reviews = new ReviewsModule(this);
     this.returns = new ReturnsModule(this);
@@ -1849,6 +1850,60 @@ var FaqModule = class {
     });
   }
 };
+var BookingsModule = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /** Services, categories, staff, branches and rules of the booking flow. */
+  async getConfig() {
+    return this.client.request("GET", "/bookings/config", { auth: false });
+  }
+  /** Free start times for the selected services (at most 31 days per call). */
+  async getSlots(query) {
+    return this.client.request("GET", "/bookings/slots", {
+      query: {
+        serviceIds: query.serviceIds.join(","),
+        staffId: query.staffId ?? void 0,
+        from: query.from,
+        to: query.to
+      },
+      auth: false
+    });
+  }
+  /**
+   * 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.
+   */
+  async create(input) {
+    return this.client.request("POST", "/bookings", { body: input, auth: false });
+  }
+  /** The booking behind the token from the confirmation email. */
+  async getByToken(token) {
+    return this.client.request("GET", `/bookings/manage/${encodeURIComponent(token)}`, { auth: false });
+  }
+  /** Free times to move the booking to (same services and person rules). */
+  async getManageSlots(token, query) {
+    return this.client.request("GET", `/bookings/manage/${encodeURIComponent(token)}/slots`, {
+      query: { from: query.from, to: query.to },
+      auth: false
+    });
+  }
+  /** Cancel the booking (optional reason for the business). */
+  async cancel(token, input) {
+    return this.client.request("POST", `/bookings/manage/${encodeURIComponent(token)}/cancel`, {
+      body: { reason: input?.reason ?? null },
+      auth: false
+    });
+  }
+  /** Move the booking to `startMs` of a slot from `getManageSlots`. */
+  async reschedule(token, input) {
+    return this.client.request("POST", `/bookings/manage/${encodeURIComponent(token)}/reschedule`, {
+      body: { startMs: input.startMs },
+      auth: false
+    });
+  }
+};
 var FormsModule = class {
   constructor(client) {
     this.client = client;
@@ -2012,6 +2067,19 @@ var ReturnsModule = class {
       }
     );
   }
+  /**
+   * 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.
+   */
+  async withdraw(input) {
+    return this.client.request("POST", "/returns/withdrawal", {
+      body: input
+    });
+  }
+  /** Return or complaint. Reason CHANGED_MIND is recorded as a withdrawal on the server. */
   async submit(input) {
     return this.client.request("POST", "/returns", {
       body: input
@@ -4139,11 +4207,73 @@ function useSiteFormSubmit(slug) {
   };
 }
 
+// src/react/hooks/use-bookings.ts
+import { useMutation as useMutation16, useQuery as useQuery34, useQueryClient as useQueryClient16 } from "@tanstack/react-query";
+function useBookingConfig(options) {
+  const { client } = useBehio();
+  return useQuery34({
+    queryKey: ["behio", "bookings", "config"],
+    queryFn: () => unwrap(client.bookings.getConfig()),
+    enabled: options?.enabled !== false
+  });
+}
+function useBookingSlots(query, options) {
+  const { client } = useBehio();
+  return useQuery34({
+    queryKey: ["behio", "bookings", "slots", query.serviceIds.join(","), query.staffId ?? null, query.from, query.to],
+    queryFn: () => unwrap(client.bookings.getSlots(query)),
+    enabled: options?.enabled !== false && query.serviceIds.length > 0,
+    staleTime: 3e4
+  });
+}
+function useCreateBooking() {
+  const { client } = useBehio();
+  const queryClient = useQueryClient16();
+  return useMutation16({
+    mutationFn: (input) => unwrap(client.bookings.create(input)),
+    onSettled: () => queryClient.invalidateQueries({ queryKey: ["behio", "bookings", "slots"] })
+  });
+}
+function useManagedBooking(token, options) {
+  const { client } = useBehio();
+  return useQuery34({
+    queryKey: ["behio", "bookings", "manage", token],
+    queryFn: () => unwrap(client.bookings.getByToken(token)),
+    enabled: options?.enabled !== false && !!token
+  });
+}
+function useManagedBookingSlots(token, query, options) {
+  const { client } = useBehio();
+  return useQuery34({
+    queryKey: ["behio", "bookings", "manage", token, "slots", query.from, query.to],
+    queryFn: () => unwrap(client.bookings.getManageSlots(token, query)),
+    enabled: options?.enabled !== false && !!token,
+    staleTime: 3e4
+  });
+}
+function useCancelBooking(token) {
+  const { client } = useBehio();
+  const queryClient = useQueryClient16();
+  return useMutation16({
+    mutationFn: (input) => unwrap(client.bookings.cancel(token, input ?? void 0)),
+    onSuccess: (booking) => queryClient.setQueryData(["behio", "bookings", "manage", token], booking)
+  });
+}
+function useRescheduleBooking(token) {
+  const { client } = useBehio();
+  const queryClient = useQueryClient16();
+  return useMutation16({
+    mutationFn: (input) => unwrap(client.bookings.reschedule(token, input)),
+    onSuccess: (booking) => queryClient.setQueryData(["behio", "bookings", "manage", token], booking),
+    onSettled: () => queryClient.invalidateQueries({ queryKey: ["behio", "bookings", "manage", token, "slots"] })
+  });
+}
+
 // src/react/hooks/use-shop-info.ts
-import { useQuery as useQuery34 } from "@tanstack/react-query";
+import { useQuery as useQuery35 } from "@tanstack/react-query";
 function useShopInfo(options) {
   const { client } = useBehio();
-  return useQuery34({
+  return useQuery35({
     queryKey: ["behio", "shop-info"],
     queryFn: () => unwrap(client.getShopInfo()),
     enabled: options?.enabled !== false
@@ -4151,10 +4281,10 @@ function useShopInfo(options) {
 }
 
 // src/react/hooks/use-shop-scripts.ts
-import { useQuery as useQuery35 } from "@tanstack/react-query";
+import { useQuery as useQuery36 } from "@tanstack/react-query";
 function useShopScripts(options) {
   const { client } = useBehio();
-  return useQuery35({
+  return useQuery36({
     queryKey: ["behio", "shop-scripts"],
     queryFn: () => unwrap(client.getShopScripts()),
     enabled: options?.enabled !== false,
@@ -4163,11 +4293,11 @@ function useShopScripts(options) {
 }
 
 // src/react/hooks/use-shop-seo.ts
-import { useQuery as useQuery36 } from "@tanstack/react-query";
+import { useQuery as useQuery37 } from "@tanstack/react-query";
 function useShopSeo(options) {
   const { client } = useBehio();
   const { locale, initialData, enabled = true } = options ?? {};
-  return useQuery36({
+  return useQuery37({
     queryKey: ["behio", "shop-seo", locale ?? "_default"],
     queryFn: () => unwrap(client.getShopSeo(locale)),
     initialData,
@@ -4230,20 +4360,20 @@ function CurrencySwitcher({
 import { useEffect as useEffect7, useMemo as useMemo5, useRef as useRef4, useState as useState10 } from "react";
 
 // src/react/hooks/use-consent.ts
-import { useQuery as useQuery37, useMutation as useMutation16, useQueryClient as useQueryClient16 } from "@tanstack/react-query";
+import { useQuery as useQuery38, useMutation as useMutation17, useQueryClient as useQueryClient17 } from "@tanstack/react-query";
 function useCookieConsent(visitorId) {
   const { client } = useBehio();
-  const qc = useQueryClient16();
-  const query = useQuery37({
+  const qc = useQueryClient17();
+  const query = useQuery38({
     queryKey: ["behio", "consent", visitorId],
     queryFn: () => unwrap(client.consent.get(visitorId)),
     enabled: Boolean(visitorId)
   });
-  const recordMutation = useMutation16({
+  const recordMutation = useMutation17({
     mutationFn: (input) => unwrap(client.consent.record(input)),
     onSuccess: () => qc.invalidateQueries({ queryKey: ["behio", "consent"] })
   });
-  const revokeMutation = useMutation16({
+  const revokeMutation = useMutation17({
     mutationFn: () => unwrap(client.consent.revoke(visitorId)),
     onSuccess: () => qc.invalidateQueries({ queryKey: ["behio", "consent"] })
   });
@@ -4622,11 +4752,11 @@ function RichText({ html, className, as = "div" }) {
 }
 
 // src/react/hooks/use-bundles.ts
-import { useQuery as useQuery38 } from "@tanstack/react-query";
+import { useQuery as useQuery39 } from "@tanstack/react-query";
 function useBundles(options) {
   const { client, sessionRestored } = useBehio();
   const query = { locale: options?.locale ?? client.getLocale(), currency: options?.currency ?? client.getCurrency(), country: options?.country ?? client.getCountry() };
-  return useQuery38({
+  return useQuery39({
     queryKey: ["behio", "bundles", query],
     queryFn: () => unwrap(client.catalog.getBundles(query)),
     enabled: sessionRestored && (options?.enabled ?? true),
@@ -4636,7 +4766,7 @@ function useBundles(options) {
 function useBundle(slug, options) {
   const { client, sessionRestored } = useBehio();
   const query = { locale: options?.locale ?? client.getLocale(), currency: options?.currency ?? client.getCurrency(), country: options?.country ?? client.getCountry() };
-  return useQuery38({
+  return useQuery39({
     queryKey: ["behio", "bundle", slug, query],
     queryFn: () => unwrap(client.catalog.getBundle(slug, query)),
     enabled: sessionRestored && Boolean(slug) && (options?.enabled ?? true),
@@ -4645,10 +4775,10 @@ function useBundle(slug, options) {
 }
 
 // src/react/hooks/use-product-group.ts
-import { useQuery as useQuery39 } from "@tanstack/react-query";
+import { useQuery as useQuery40 } from "@tanstack/react-query";
 function useProductGroup(slug, options) {
   const { client } = useBehio();
-  return useQuery39({
+  return useQuery40({
     queryKey: ["behio", "product-group", slug, options?.locale, options?.currency],
     queryFn: () => unwrap(
       client.catalog.getProductGroup(slug, {
@@ -4662,10 +4792,10 @@ function useProductGroup(slug, options) {
 }
 
 // src/react/hooks/use-cross-sell.ts
-import { useQuery as useQuery40 } from "@tanstack/react-query";
+import { useQuery as useQuery41 } from "@tanstack/react-query";
 function useCrossSell(productSlug, options) {
   const { client } = useBehio();
-  return useQuery40({
+  return useQuery41({
     queryKey: ["behio", "cross-sell", productSlug, options?.locale, options?.currency],
     queryFn: () => unwrap(
       client.catalog.getCrossSell(productSlug, {
@@ -4679,10 +4809,10 @@ function useCrossSell(productSlug, options) {
 }
 
 // src/react/hooks/use-product-promotions.ts
-import { useQuery as useQuery41 } from "@tanstack/react-query";
+import { useQuery as useQuery42 } from "@tanstack/react-query";
 function useProductPromotions(productSlug, options) {
   const { client } = useBehio();
-  return useQuery41({
+  return useQuery42({
     queryKey: ["behio", "product-promotions", productSlug],
     queryFn: () => unwrap(client.catalog.getProductPromotions(productSlug)),
     enabled: Boolean(productSlug) && (options?.enabled ?? true),
@@ -4691,11 +4821,11 @@ function useProductPromotions(productSlug, options) {
 }
 
 // src/react/hooks/use-gift-card.ts
-import { useQuery as useQuery42 } from "@tanstack/react-query";
+import { useQuery as useQuery43 } from "@tanstack/react-query";
 function useGiftCardBalance(code, options) {
   const { client } = useBehio();
   const trimmed = code?.trim();
-  return useQuery42({
+  return useQuery43({
     queryKey: ["behio", "gift-card-balance", trimmed],
     queryFn: () => unwrap(client.catalog.checkGiftCard(trimmed)),
     enabled: Boolean(trimmed && trimmed.length >= 6) && (options?.enabled ?? true)
@@ -4703,20 +4833,20 @@ function useGiftCardBalance(code, options) {
 }
 
 // src/react/hooks/use-wishlist.ts
-import { useQuery as useQuery43, useMutation as useMutation17, useQueryClient as useQueryClient17 } from "@tanstack/react-query";
+import { useQuery as useQuery44, useMutation as useMutation18, useQueryClient as useQueryClient18 } from "@tanstack/react-query";
 function useWishlist(options) {
   const { client } = useBehio();
-  const qc = useQueryClient17();
-  const query = useQuery43({
+  const qc = useQueryClient18();
+  const query = useQuery44({
     queryKey: ["behio", "wishlist"],
     queryFn: () => unwrap(client.wishlist.get()),
     enabled: options?.enabled ?? true
   });
-  const addMutation = useMutation17({
+  const addMutation = useMutation18({
     mutationFn: (productId) => unwrap(client.wishlist.add(productId)),
     onSuccess: () => qc.invalidateQueries({ queryKey: ["behio", "wishlist"] })
   });
-  const removeMutation = useMutation17({
+  const removeMutation = useMutation18({
     mutationFn: (productId) => unwrap(client.wishlist.remove(productId)),
     onSuccess: () => qc.invalidateQueries({ queryKey: ["behio", "wishlist"] })
   });
@@ -4730,7 +4860,7 @@ function useWishlist(options) {
 }
 function useIsInWishlist(productId) {
   const { client } = useBehio();
-  return useQuery43({
+  return useQuery44({
     queryKey: ["behio", "wishlist-check", productId],
     queryFn: () => unwrap(client.wishlist.isInWishlist(productId)),
     enabled: Boolean(productId)
@@ -4738,10 +4868,10 @@ function useIsInWishlist(productId) {
 }
 
 // src/react/hooks/use-reviews.ts
-import { useQuery as useQuery44, useMutation as useMutation18, useQueryClient as useQueryClient18 } from "@tanstack/react-query";
+import { useQuery as useQuery45, useMutation as useMutation19, useQueryClient as useQueryClient19 } from "@tanstack/react-query";
 function useProductReviews(productId, options) {
   const { client } = useBehio();
-  return useQuery44({
+  return useQuery45({
     queryKey: ["behio", "reviews", productId, options?.page ?? 1, options?.limit ?? 20],
     queryFn: () => unwrap(client.reviews.getProductReviews(productId, options?.page, options?.limit)),
     initialData: options?.initialData,
@@ -4751,30 +4881,36 @@ function useProductReviews(productId, options) {
 }
 function useSubmitReview() {
   const { client } = useBehio();
-  const qc = useQueryClient18();
-  return useMutation18({
+  const qc = useQueryClient19();
+  return useMutation19({
     mutationFn: (input) => unwrap(client.reviews.submit(input)),
     onSuccess: (_, input) => qc.invalidateQueries({ queryKey: ["behio", "reviews", input.productId] })
   });
 }
 
 // src/react/hooks/use-returns.ts
-import { useQuery as useQuery45, useMutation as useMutation19 } from "@tanstack/react-query";
+import { useQuery as useQuery46, useMutation as useMutation20 } from "@tanstack/react-query";
 function useLookupReturnableOrder() {
   const { client } = useBehio();
-  return useMutation19({
+  return useMutation20({
     mutationFn: ({ orderNumber, email }) => unwrap(client.returns.lookupOrder(orderNumber, email))
   });
 }
+function useSubmitWithdrawal() {
+  const { client } = useBehio();
+  return useMutation20({
+    mutationFn: (input) => unwrap(client.returns.withdraw(input))
+  });
+}
 function useSubmitReturn() {
   const { client } = useBehio();
-  return useMutation19({
+  return useMutation20({
     mutationFn: (input) => unwrap(client.returns.submit(input))
   });
 }
 function useReturnStatus(returnId, email) {
   const { client } = useBehio();
-  return useQuery45({
+  return useQuery46({
     queryKey: ["behio", "return-status", returnId],
     queryFn: () => unwrap(client.returns.getStatus(returnId, email)),
     enabled: Boolean(returnId && email)
@@ -4782,16 +4918,16 @@ function useReturnStatus(returnId, email) {
 }
 
 // src/react/hooks/use-quotes.ts
-import { useMutation as useMutation20, useQuery as useQuery46 } from "@tanstack/react-query";
+import { useMutation as useMutation21, useQuery as useQuery47 } from "@tanstack/react-query";
 function useSubmitQuote() {
   const { client } = useBehio();
-  return useMutation20({
+  return useMutation21({
     mutationFn: (input) => unwrap(client.quotes.submit(input))
   });
 }
 function useQuoteStatus(quoteId, email) {
   const { client } = useBehio();
-  return useQuery46({
+  return useQuery47({
     queryKey: ["behio", "quote-status", quoteId],
     queryFn: () => unwrap(client.quotes.getStatus(quoteId, email)),
     enabled: Boolean(quoteId && email)
@@ -4799,10 +4935,10 @@ function useQuoteStatus(quoteId, email) {
 }
 
 // src/react/hooks/use-back-in-stock.ts
-import { useMutation as useMutation21 } from "@tanstack/react-query";
+import { useMutation as useMutation22 } from "@tanstack/react-query";
 function useNotifyWhenAvailable() {
   const { client } = useBehio();
-  return useMutation21({
+  return useMutation22({
     mutationFn: ({ productId, email }) => unwrap(client.catalog.notifyWhenAvailable(productId, email))
   });
 }
@@ -4950,8 +5086,11 @@ export {
   useBlogPost,
   useBlogPosts,
   useBlogs,
+  useBookingConfig,
+  useBookingSlots,
   useBundle,
   useBundles,
+  useCancelBooking,
   useCart,
   useCartCount,
   useCategories,
@@ -4965,6 +5104,7 @@ export {
   useCourse,
   useCourseCertificates,
   useCourses,
+  useCreateBooking,
   useCrossSell,
   useCurrency,
   useCustomer,
@@ -4982,6 +5122,8 @@ export {
   useLessonTutor,
   useLookupReturnableOrder,
   useLoyalty,
+  useManagedBooking,
+  useManagedBookingSlots,
   useMenu,
   useNewsletterSubscribe,
   useNewsletterUnsubscribe,
@@ -5001,6 +5143,7 @@ export {
   useProductReviews,
   useProducts,
   useQuoteStatus,
+  useRescheduleBooking,
   useReturnStatus,
   useSearch,
   useShippingMethods,
@@ -5013,6 +5156,7 @@ export {
   useSubmitQuote,
   useSubmitReturn,
   useSubmitReview,
+  useSubmitWithdrawal,
   useSubscriptions,
   useVisitorMessages,
   useWishlist

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@behio/storefront-sdk",
-  "version": "2.23.0",
+  "version": "2.25.0",
   "description": "TypeScript SDK for Behio headless e-commerce: core client + React hooks",
   "author": "Behio",
   "license": "MIT",