@tebuto/react-booking-widget 1.2.0 → 1.3.0

package/dist/types.d.ts

@@ -347,8 +347,7 @@ type UseClaimSlotReturn = ClaimState & {
  */
 declare function useClaimSlot(): UseClaimSlotReturn;
 
-type BookingState = {
-    booking: BookingResponse | null;
+type BookingRequestState = {
     isLoading: boolean;
     error: Error | null;
     isSuccess: boolean;
@@ -358,44 +357,33 @@ type BookAppointmentParams = {
     client: ClientInfo;
     locationSelection?: AppointmentLocation;
 };
-type UseBookAppointmentReturn = BookingState & {
-    /** Book the appointment */
-    book: (params: BookAppointmentParams) => Promise<BookingResponse | null>;
-    /** Reset the booking state */
+type UseBookAppointmentReturn = BookingRequestState & {
+    /** Submit booking request - returns true on success */
+    book: (params: BookAppointmentParams) => Promise<boolean>;
+    /** Reset the state */
     reset: () => void;
-    /** Download the calendar file (.ics) */
-    downloadCalendar: () => void;
 };
 /**
- * useBookAppointment - Complete the booking process
+ * useBookAppointment - Submit a public booking request
  *
- * Submits the booking with client information and handles
- * the response including calendar download.
+ * Submits a booking request with client information. For public bookings,
+ * the client will receive a confirmation email to verify the appointment.
  *
  * @example
  * ```tsx
- * const { book, booking, isLoading, isSuccess, downloadCalendar, reset } = useBookAppointment()
+ * const { book, isLoading, isSuccess, error, reset } = useBookAppointment()
  *
  * const handleSubmit = async (clientInfo: ClientInfo) => {
- *   const result = await book({
+ *   const success = await book({
  *     slot: claimedSlot,
  *     client: clientInfo,
  *     locationSelection: selectedLocation
  *   })
  *
- *   if (result) {
+ *   if (success) {
  *     setStep('confirmation')
  *   }
  * }
- *
- * if (isSuccess) {
- *   return (
- *     <SuccessMessage>
- *       <button onClick={downloadCalendar}>Add to Calendar</button>
- *       <button onClick={reset}>Book Another</button>
- *     </SuccessMessage>
- *   )
- * }
  * ```
  */
 declare function useBookAppointment(): UseBookAppointmentReturn;
@@ -404,8 +392,8 @@ type BookingStep = 'loading' | 'date-selection' | 'time-selection' | 'booking-fo
 type UseBookingFlowOptions = {
     /** Categories to filter by */
     categories?: number[];
-    /** Callback when booking is complete */
-    onBookingComplete?: (booking: BookingResponse) => void;
+    /** Callback when booking request is submitted successfully */
+    onBookingComplete?: () => void;
     /** Callback on any error */
     onError?: (error: Error) => void;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@tebuto/react-booking-widget",
-    "version": "1.2.0",
+    "version": "1.3.0",
     "description": "React Component for the Tebuto Booking Widget",
     "author": "Tebuto GmbH",
     "homepage": "https://tebuto.de",