@wix/headless-bookings 0.0.25 → 0.0.27

package/cjs/dist/api/create-booking/index.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Create Booking API
+ * Wrapper for the Wix Bookings createBooking SDK function
+ */
+import { type Booking, type CreateBookingResponse, type ParticipantNotification } from '@wix/auto_sdk_bookings_bookings';
+import type { FormValues } from '@wix/form-public';
+/**
+ * Options for creating a booking
+ */
+export interface CreateBookingOptions {
+    /** Notification settings for participants */
+    participantNotification?: ParticipantNotification;
+    /** Whether to send SMS reminder */
+    sendSmsReminder?: boolean;
+    /** Form submission data */
+    formSubmission?: FormValues;
+}
+/**
+ * Creates a booking with the specified booking data and options
+ *
+ * @param booking - The booking data
+ * @param options - Optional settings for notifications and form submission
+ * @returns Promise resolving to the created booking response
+ *
+ * @example
+ * ```typescript
+ * const response = await createBooking(
+ *   {
+ *     selectedPaymentOption: 'ONLINE',
+ *     totalParticipants: 1,
+ *     bookedEntity: { slot: { ... } }
+ *   },
+ *   {
+ *     participantNotification: { notifyParticipants: true },
+ *     sendSmsReminder: true,
+ *     formSubmission: formValues
+ *   }
+ * );
+ * ```
+ */
+export declare function createBooking(booking: Booking, options?: CreateBookingOptions): Promise<CreateBookingResponse>;
+export type { Booking, CreateBookingRequest, CreateBookingResponse, ParticipantNotification, ContactDetails, } from '@wix/auto_sdk_bookings_bookings';

package/cjs/dist/api/create-booking/index.js

@@ -0,0 +1,35 @@
+/**
+ * Create Booking API
+ * Wrapper for the Wix Bookings createBooking SDK function
+ */
+import { createBooking as createBookingSdk, } from '@wix/auto_sdk_bookings_bookings';
+/**
+ * Creates a booking with the specified booking data and options
+ *
+ * @param booking - The booking data
+ * @param options - Optional settings for notifications and form submission
+ * @returns Promise resolving to the created booking response
+ *
+ * @example
+ * ```typescript
+ * const response = await createBooking(
+ *   {
+ *     selectedPaymentOption: 'ONLINE',
+ *     totalParticipants: 1,
+ *     bookedEntity: { slot: { ... } }
+ *   },
+ *   {
+ *     participantNotification: { notifyParticipants: true },
+ *     sendSmsReminder: true,
+ *     formSubmission: formValues
+ *   }
+ * );
+ * ```
+ */
+export async function createBooking(booking, options) {
+    return createBookingSdk(booking, {
+        participantNotification: options?.participantNotification,
+        sendSmsReminder: options?.sendSmsReminder,
+        formSubmission: options?.formSubmission,
+    });
+}

package/cjs/dist/api/create-checkout/index.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Create Checkout API
+ * Wrapper for the Wix eCommerce createCheckout SDK function
+ */
+import { type CreateCheckoutRequest, type Checkout } from '@wix/auto_sdk_ecom_checkout';
+/**
+ * Response from createCheckout API
+ */
+export interface CreateCheckoutResponse {
+    /** The created checkout */
+    checkout?: Checkout;
+}
+/**
+ * Creates a checkout session with the specified request data
+ *
+ * @param request - The checkout request data including line items and checkout info
+ * @returns Promise resolving to the created checkout response
+ *
+ * @example
+ * ```typescript
+ * const response = await createCheckout({
+ *   channelType: ChannelType.WEB,
+ *   lineItems: [
+ *     {
+ *       quantity: 1,
+ *       catalogReference: {
+ *         catalogItemId: bookingId,
+ *         appId: BOOKINGS_APP_DEF_ID,
+ *       },
+ *     },
+ *   ],
+ *   checkoutInfo: {
+ *     businessLocationId,
+ *     billingInfo: { ... },
+ *   },
+ * });
+ * ```
+ */
+export declare function createCheckout(request: CreateCheckoutRequest): Promise<CreateCheckoutResponse>;
+export { ChannelType, type CreateCheckoutRequest, } from '@wix/auto_sdk_ecom_checkout';

package/cjs/dist/api/create-checkout/index.js

@@ -0,0 +1,37 @@
+/**
+ * Create Checkout API
+ * Wrapper for the Wix eCommerce createCheckout SDK function
+ */
+import { createCheckout as createCheckoutSdk, } from '@wix/auto_sdk_ecom_checkout';
+/**
+ * Creates a checkout session with the specified request data
+ *
+ * @param request - The checkout request data including line items and checkout info
+ * @returns Promise resolving to the created checkout response
+ *
+ * @example
+ * ```typescript
+ * const response = await createCheckout({
+ *   channelType: ChannelType.WEB,
+ *   lineItems: [
+ *     {
+ *       quantity: 1,
+ *       catalogReference: {
+ *         catalogItemId: bookingId,
+ *         appId: BOOKINGS_APP_DEF_ID,
+ *       },
+ *     },
+ *   ],
+ *   checkoutInfo: {
+ *     businessLocationId,
+ *     billingInfo: { ... },
+ *   },
+ * });
+ * ```
+ */
+export async function createCheckout(request) {
+    const checkout = await createCheckoutSdk(request);
+    return { checkout };
+}
+// Re-export types and constants that consumers may need
+export { ChannelType, } from '@wix/auto_sdk_ecom_checkout';

package/cjs/dist/api/fetch-availability/index.d.ts

@@ -2,15 +2,15 @@
  * Time Slot List API
  * Fetches available time slots for booking services from Wix Bookings
  */
-import { type Location, type CursorPaging, type CursorPagingMetadata } from '@wix/auto_sdk_bookings_availability-time-slots';
+import { type CursorPaging, type CursorPagingMetadata } from '@wix/auto_sdk_bookings_availability-time-slots';
 import { type Service } from '@wix/auto_sdk_bookings_services';
-import { ViewMode, type TimeSlot } from '../../services/time-slot-list/time-slot-list.def.js';
+import { ViewMode, type TimeSlot, type Location } from '../../services/time-slot-list/time-slot-list.def.js';
 export interface FetchAvailabilityOptions {
     services: Service[];
     fromLocalDate?: string | null;
     toLocalDate?: string | null;
     timeZone?: string | null;
-    locations?: Location[];
+    location?: Location;
     /** Filter by specific staff member IDs (passed as resourceIds to API) */
     staffMemberIds?: string[];
     cursorPaging?: CursorPaging;
@@ -52,12 +52,12 @@ export interface FetchAvailabilityResponse {
  * // response.timeSlots are grouped by time
  * ```
  */
-export declare function fetchAvailability({ services: selectedServices, viewMode, fromLocalDate, toLocalDate, timeZone, locations, staffMemberIds, cursor, slotsPerPage, bookable, bookingPolicyViolations, timeSlotsPerDay, }: {
+export declare function fetchAvailability({ services: selectedServices, viewMode, fromLocalDate, toLocalDate, timeZone, location, staffMemberIds, cursor, slotsPerPage, bookable, bookingPolicyViolations, timeSlotsPerDay, }: {
     services: Service[];
     fromLocalDate: Date;
     toLocalDate: Date;
     timeZone?: string;
-    locations?: Location[];
+    location?: Location;
     staffMemberIds?: string[];
     cursor?: string;
     viewMode?: ViewMode;

package/cjs/dist/api/fetch-availability/index.js

@@ -115,7 +115,7 @@ function detectFlow(bookingServices, viewMode) {
  * // response.timeSlots are grouped by time
  * ```
  */
-export async function fetchAvailability({ services: selectedServices, viewMode = ViewMode.CLASSIC, fromLocalDate, toLocalDate, timeZone, locations, staffMemberIds, cursor, slotsPerPage, bookable, bookingPolicyViolations, timeSlotsPerDay, }) {
+export async function fetchAvailability({ services: selectedServices, viewMode = ViewMode.CLASSIC, fromLocalDate, toLocalDate, timeZone, location, staffMemberIds, cursor, slotsPerPage, bookable, bookingPolicyViolations, timeSlotsPerDay, }) {
     const flow = detectFlow(selectedServices, viewMode);
     const serviceIds = selectedServices.map((s) => s._id);
     // Convert Date objects to local ISO strings
@@ -138,6 +138,12 @@ export async function fetchAvailability({ services: selectedServices, viewMode =
                 },
             ]
             : undefined;
+        const includeResourceTypeIds = isAnyStaffMemberSelected || isFetchAvailabileDays
+            ? undefined
+            : [STAFF_RESOURCE_TYPE_ID];
+        const locations = location
+            ? [{ _id: location.id, locationType: location.locationType }]
+            : undefined;
         const response = await listAvailabilityTimeSlots({
             serviceId: serviceIds[0],
             fromLocalDate: fromLocalDateStr,
@@ -148,9 +154,7 @@ export async function fetchAvailability({ services: selectedServices, viewMode =
             resourceTypes,
             bookable,
             bookingPolicyViolations,
-            includeResourceTypeIds: isAnyStaffMemberSelected || isFetchAvailabileDays
-                ? undefined
-                : [STAFF_RESOURCE_TYPE_ID],
+            includeResourceTypeIds,
             timeSlotsPerDay,
         });
         return {
@@ -164,7 +168,7 @@ export async function fetchAvailability({ services: selectedServices, viewMode =
     }
     if (flow === FlowType.CLASS) {
         // Build eventFilter for location and staff filtering
-        const locationIds = locations?.map((l) => l._id);
+        const locationIds = location ? [location.id] : undefined;
         const eventFilter = {};
         if (locationIds?.length) {
             eventFilter['location.id'] = locationIds;
@@ -185,7 +189,6 @@ export async function fetchAvailability({ services: selectedServices, viewMode =
         });
         return {
             timeSlots: groupTimeSlotsByTime(response.timeSlots || []),
-            // Note: listEventTimeSlots uses pagingMetadata instead of cursorPagingMetadata
             cursorPagingMetadata: response.pagingMetadata,
         };
     }

package/cjs/dist/api/index.d.ts

@@ -6,6 +6,8 @@
  */
 export { getServiceById, getServiceBySlug, queryServices, type PagingMetadata, type ServiceListFilters, type QueryServicesRequest, } from './query-services/index.js';
 export { fetchAvailability } from './fetch-availability/index.js';
+export { createBooking, type CreateBookingOptions, type Booking, type CreateBookingRequest, type CreateBookingResponse, type ParticipantNotification, type ContactDetails, } from './create-booking/index.js';
+export { createCheckout, ChannelType, type CreateCheckoutRequest, type CreateCheckoutResponse, } from './create-checkout/index.js';
 /**
  * PagingMetadata includes:
  * - limit: Number of items per page

package/cjs/dist/api/index.js

@@ -6,6 +6,8 @@
  */
 export { getServiceById, getServiceBySlug, queryServices, } from './query-services/index.js';
 export { fetchAvailability } from './fetch-availability/index.js';
+export { createBooking, } from './create-booking/index.js';
+export { createCheckout, ChannelType, } from './create-checkout/index.js';
 /**
  * PagingMetadata includes:
  * - limit: Number of items per page

package/cjs/dist/react/booking/Book.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Book - High-level headless component for the book action button
+ * Wraps core Book with AsChildSlot pattern for customization
+ */
+import React from 'react';
+import type { BookChildProps, BookResult, BookingError } from '../../services/booking/book-action/types.js';
+/**
+ * Props for the high-level Book component
+ */
+export interface BookProps {
+    asChild?: boolean;
+    children?: React.ReactNode | ((props: BookChildProps) => React.ReactNode);
+    className?: string;
+    label?: string;
+    loadingState?: string;
+    disabled?: boolean;
+    onCheckoutRequired?: (result: BookResult) => void;
+    onError?: (error: BookingError) => void;
+}
+/**
+ * Book action button component with AsChildSlot pattern
+ *
+ * @example
+ * ```tsx
+ * // Simple usage
+ * <Booking.Actions.Book />
+ *
+ * // With callbacks
+ * <Booking.Actions.Book
+ *   onCheckoutRequired={({ checkoutId }) => router.push(`/checkout?id=${checkoutId}`)}
+ *   onError={(error) => console.error(error.message)}
+ * />
+ *
+ * // With render function
+ * <Booking.Actions.Book onCheckoutRequired={handleCheckout}>
+ *   {({ isLoading, error, canBook, onClick, disabled }) => (
+ *     <button onClick={onClick} disabled={disabled}>
+ *       {isLoading ? <Spinner /> : 'Book Now'}
+ *     </button>
+ *   )}
+ * </Booking.Actions.Book>
+ *
+ * // With asChild
+ * <Booking.Actions.Book asChild onCheckoutRequired={handleCheckout}>
+ *   <CustomBookButton />
+ * </Booking.Actions.Book>
+ * ```
+ */
+export declare const Book: React.ForwardRefExoticComponent<BookProps & React.RefAttributes<HTMLButtonElement>>;

package/cjs/dist/react/booking/Book.js

@@ -0,0 +1,46 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Book - High-level headless component for the book action button
+ * Wraps core Book with AsChildSlot pattern for customization
+ */
+import React from 'react';
+import { AsChildSlot } from '@wix/headless-utils/react';
+import * as CoreBook from '../core/booking/Book.js';
+var TestIds;
+(function (TestIds) {
+    TestIds["bookingActionBook"] = "booking-action-book";
+})(TestIds || (TestIds = {}));
+/**
+ * Book action button component with AsChildSlot pattern
+ *
+ * @example
+ * ```tsx
+ * // Simple usage
+ * <Booking.Actions.Book />
+ *
+ * // With callbacks
+ * <Booking.Actions.Book
+ *   onCheckoutRequired={({ checkoutId }) => router.push(`/checkout?id=${checkoutId}`)}
+ *   onError={(error) => console.error(error.message)}
+ * />
+ *
+ * // With render function
+ * <Booking.Actions.Book onCheckoutRequired={handleCheckout}>
+ *   {({ isLoading, error, canBook, onClick, disabled }) => (
+ *     <button onClick={onClick} disabled={disabled}>
+ *       {isLoading ? <Spinner /> : 'Book Now'}
+ *     </button>
+ *   )}
+ * </Booking.Actions.Book>
+ *
+ * // With asChild
+ * <Booking.Actions.Book asChild onCheckoutRequired={handleCheckout}>
+ *   <CustomBookButton />
+ * </Booking.Actions.Book>
+ * ```
+ */
+export const Book = React.forwardRef((props, ref) => {
+    const { asChild, children, className, label = 'Book Now', loadingState = 'Booking...', disabled, onCheckoutRequired, onError, } = props;
+    return (_jsx(CoreBook.Book, { onCheckoutRequired: onCheckoutRequired, onError: onError, disabled: disabled, children: (childProps) => (_jsx(AsChildSlot, { ref: ref, asChild: asChild, className: className, "data-testid": TestIds.bookingActionBook, "data-in-progress": childProps.isLoading, customElement: children, customElementProps: childProps, children: _jsx("button", { onClick: childProps.onClick, disabled: childProps.disabled, children: childProps.isLoading ? loadingState : label }) })) }));
+});
+Book.displayName = 'Booking.Actions.Book';

package/cjs/dist/react/booking/Booking.d.ts

@@ -34,3 +34,21 @@ export declare const Root: {
     (props: BookingRootProps): React.ReactNode;
     displayName: string;
 };
+/**
+ * Actions namespace containing action components for booking
+ *
+ * @example
+ * ```tsx
+ * // Simple usage
+ * <Booking.Actions.Book />
+ *
+ * // With callbacks
+ * <Booking.Actions.Book
+ *   onCheckoutRequired={({ checkoutId }) => router.push(`/checkout?id=${checkoutId}`)}
+ *   onError={(error) => toast.error(error)}
+ * />
+ * ```
+ */
+export declare const Actions: {
+    Book: React.ForwardRefExoticComponent<import("./Book.js").BookProps & React.RefAttributes<HTMLButtonElement>>;
+};

package/cjs/dist/react/booking/Booking.js

@@ -1,5 +1,6 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import * as CoreBooking from '../core/booking/Booking.js';
+import { Book } from './Book.js';
 /**
  * Root component that provides booking context to the entire app.
  *
@@ -23,3 +24,21 @@ export const Root = (props) => {
     return (_jsx(CoreBooking.Root, { bookingServiceConfig: bookingServiceConfig, children: children }));
 };
 Root.displayName = 'Booking.Root';
+/**
+ * Actions namespace containing action components for booking
+ *
+ * @example
+ * ```tsx
+ * // Simple usage
+ * <Booking.Actions.Book />
+ *
+ * // With callbacks
+ * <Booking.Actions.Book
+ *   onCheckoutRequired={({ checkoutId }) => router.push(`/checkout?id=${checkoutId}`)}
+ *   onError={(error) => toast.error(error)}
+ * />
+ * ```
+ */
+export const Actions = {
+    Book,
+};

package/cjs/dist/react/core/booking/Book.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Core Book - Provides book action data via render props
+ * NO AsChildSlot, NO asChild - that belongs in high-level component
+ */
+import React from 'react';
+import type { BookResult, BookingError } from '../../../services/booking/book-action/types.js';
+/**
+ * Data exposed by Book component via render props
+ */
+export interface BookData {
+    isLoading: boolean;
+    error: BookingError | null;
+    canBook: boolean;
+    onClick: () => Promise<void>;
+    disabled: boolean;
+}
+/**
+ * Props for core Book component
+ */
+export interface BookProps {
+    children: (data: BookData) => React.ReactNode;
+    onCheckoutRequired?: (result: BookResult) => void;
+    onError?: (error: BookingError) => void;
+    disabled?: boolean;
+}
+/**
+ * Core Book component - provides book action data via render props.
+ * Used internally by higher-level Booking.Actions.Book component.
+ *
+ * @example
+ * ```tsx
+ * <Book onCheckoutRequired={handleCheckout}>
+ *   {({ isLoading, error, canBook, onClick, disabled }) => (
+ *     <button onClick={onClick} disabled={disabled}>
+ *       {isLoading ? 'Booking...' : 'Book Now'}
+ *     </button>
+ *   )}
+ * </Book>
+ * ```
+ */
+export declare function Book(props: BookProps): React.ReactNode;

package/cjs/dist/react/core/booking/Book.js

@@ -0,0 +1,59 @@
+/**
+ * Core Book - Provides book action data via render props
+ * NO AsChildSlot, NO asChild - that belongs in high-level component
+ */
+import { useState } from 'react';
+import { useService } from '@wix/services-manager-react';
+import { BookingServiceDefinition } from '../../../services/booking/booking.js';
+import { canBook } from '../../../services/booking/book-action/canBook.js';
+/**
+ * Core Book component - provides book action data via render props.
+ * Used internally by higher-level Booking.Actions.Book component.
+ *
+ * @example
+ * ```tsx
+ * <Book onCheckoutRequired={handleCheckout}>
+ *   {({ isLoading, error, canBook, onClick, disabled }) => (
+ *     <button onClick={onClick} disabled={disabled}>
+ *       {isLoading ? 'Booking...' : 'Book Now'}
+ *     </button>
+ *   )}
+ * </Book>
+ * ```
+ */
+export function Book(props) {
+    const { children, onCheckoutRequired, onError, disabled } = props;
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const bookingService = useService(BookingServiceDefinition);
+    const serviceSelections = bookingService.serviceSelections.get();
+    const formSubmission = bookingService.formSubmission.get();
+    const canBookValue = canBook({ serviceSelections, formSubmission });
+    const handleClick = async () => {
+        setIsLoading(true);
+        setError(null);
+        try {
+            const result = await bookingService.actions.book();
+            onCheckoutRequired?.(result);
+        }
+        catch (e) {
+            const bookingError = {
+                message: e instanceof Error ? e.message : 'Booking failed',
+                errorObject: e,
+            };
+            setError(bookingError);
+            onError?.(bookingError);
+        }
+        finally {
+            setIsLoading(false);
+        }
+    };
+    const isDisabled = isLoading || disabled || !canBookValue;
+    return children({
+        isLoading,
+        error,
+        canBook: canBookValue,
+        onClick: handleClick,
+        disabled: isDisabled,
+    });
+}

package/cjs/dist/react/core/time-slot-list/TimeSlot.d.ts

@@ -89,11 +89,11 @@ export declare function StaffMemberProvider(props: StaffMemberProviderProps): Re
 export interface InfoProps {
     children: (data: {
         /** Parsed localStartDate as Date (constructed from the raw localStartDate string) */
-        startDate: Date | undefined;
+        startDate: Date;
         /** Parsed localEndDate as Date (constructed from the raw localEndDate string) */
-        endDate: Date | undefined;
-        /** Calculated duration in minutes (null if dates unavailable) */
-        durationInMinutes: number | null;
+        endDate: Date;
+        /** Calculated duration in minutes */
+        durationInMinutes: number;
         /** Whether the timeSlot is bookable */
         bookable: boolean;
         /** Whether this timeSlot is currently selected */

package/cjs/dist/react/core/time-slot-list/TimeSlot.js

@@ -116,18 +116,11 @@ export function StaffMemberProvider(props) {
  */
 export function Info(props) {
     const { timeSlot, isSelected } = useTimeSlotContext();
-    const startDate = timeSlot.localStartDate
-        ? new Date(timeSlot.localStartDate)
-        : undefined;
-    const endDate = timeSlot.localEndDate
-        ? new Date(timeSlot.localEndDate)
-        : undefined;
+    const startDate = new Date(timeSlot.localStartDate);
+    const endDate = new Date(timeSlot.localEndDate);
     const bookable = timeSlot.bookable ?? false;
     // Calculate duration from start and end dates
-    let durationInMinutes = null;
-    if (startDate && endDate) {
-        durationInMinutes = Math.round((endDate.getTime() - startDate.getTime()) / (1000 * 60));
-    }
+    const durationInMinutes = Math.round((endDate.getTime() - startDate.getTime()) / (1000 * 60));
     return props.children({
         startDate,
         endDate,

package/cjs/dist/react/time-slot-list/TimeSlot.d.ts

@@ -16,7 +16,7 @@ export type { LocationData, StaffMemberData, } from '../core/time-slot-list/Time
 export interface StartDateProps {
     asChild?: boolean;
     children?: AsChildChildren<{
-        startDate: Date | undefined;
+        startDate: Date;
     }>;
     className?: string;
 }
@@ -45,7 +45,7 @@ export declare const StartDate: React.ForwardRefExoticComponent<StartDateProps &
 export interface EndDateProps {
     asChild?: boolean;
     children?: AsChildChildren<{
-        endDate: Date | undefined;
+        endDate: Date;
     }>;
     className?: string;
 }
@@ -74,7 +74,7 @@ export declare const EndDate: React.ForwardRefExoticComponent<EndDateProps & Rea
 export interface DurationProps {
     asChild?: boolean;
     children?: AsChildChildren<{
-        durationInMinutes: number | null;
+        durationInMinutes: number;
     }>;
     className?: string;
 }

package/cjs/dist/react/time-slot-list/TimeSlot.js

@@ -53,7 +53,7 @@ var TestIds;
  */
 export const StartDate = React.forwardRef((props, ref) => {
     const { asChild, children, className } = props;
-    return (_jsx(CoreTimeSlot.Info, { children: ({ startDate }) => (_jsx(AsChildSlot, { ref: ref, asChild: asChild, className: className, "data-testid": TestIds.timeSlotStartDate, customElement: children, customElementProps: { startDate }, children: _jsx("span", { children: startDate?.toString() }) })) }));
+    return (_jsx(CoreTimeSlot.Info, { children: ({ startDate }) => (_jsx(AsChildSlot, { ref: ref, asChild: asChild, className: className, "data-testid": TestIds.timeSlotStartDate, customElement: children, customElementProps: { startDate }, children: _jsx("span", { children: startDate.toString() }) })) }));
 });
 StartDate.displayName = 'TimeSlot.StartDate';
 /**
@@ -76,7 +76,7 @@ StartDate.displayName = 'TimeSlot.StartDate';
  */
 export const EndDate = React.forwardRef((props, ref) => {
     const { asChild, children, className } = props;
-    return (_jsx(CoreTimeSlot.Info, { children: ({ endDate }) => (_jsx(AsChildSlot, { ref: ref, asChild: asChild, className: className, "data-testid": TestIds.timeSlotEndDate, customElement: children, customElementProps: { endDate }, children: _jsx("span", { children: endDate?.toString() }) })) }));
+    return (_jsx(CoreTimeSlot.Info, { children: ({ endDate }) => (_jsx(AsChildSlot, { ref: ref, asChild: asChild, className: className, "data-testid": TestIds.timeSlotEndDate, customElement: children, customElementProps: { endDate }, children: _jsx("span", { children: endDate.toString() }) })) }));
 });
 EndDate.displayName = 'TimeSlot.EndDate';
 /**
@@ -99,7 +99,7 @@ EndDate.displayName = 'TimeSlot.EndDate';
  */
 export const Duration = React.forwardRef((props, ref) => {
     const { asChild, children, className } = props;
-    return (_jsx(CoreTimeSlot.Info, { children: ({ durationInMinutes }) => (_jsx(AsChildSlot, { ref: ref, asChild: asChild, className: className, "data-testid": TestIds.timeSlotDuration, customElement: children, customElementProps: { durationInMinutes }, children: durationInMinutes && _jsx("span", { children: durationInMinutes }) })) }));
+    return (_jsx(CoreTimeSlot.Info, { children: ({ durationInMinutes }) => (_jsx(AsChildSlot, { ref: ref, asChild: asChild, className: className, "data-testid": TestIds.timeSlotDuration, customElement: children, customElementProps: { durationInMinutes }, children: _jsx("span", { children: durationInMinutes }) })) }));
 });
 Duration.displayName = 'TimeSlot.Duration';
 /**

package/cjs/dist/react/time-slot-list/TimeSlotList.d.ts

@@ -85,6 +85,8 @@ export interface TimeSlotsProps {
     emptyState?: React.ReactNode;
     /** Content to display while time slots are loading */
     loadingState?: React.ReactNode;
+    /** Content to display when an error occurs while loading time slots */
+    errorState?: React.ReactNode;
     className?: string;
 }
 /**
@@ -114,11 +116,11 @@ export interface TimeSlotRepeaterChildProps {
     /** Whether the slot can be booked */
     bookable: boolean;
     /** Start date/time as Date (constructed from the raw localStartDate string) */
-    startDate: Date | undefined;
+    startDate: Date;
     /** End date/time as Date (constructed from the raw localEndDate string) */
-    endDate: Date | undefined;
+    endDate: Date;
     /** Duration in minutes */
-    durationInMinutes: number | null;
+    durationInMinutes: number;
     /** The raw time slot data */
     timeSlot: TimeSlotType;
 }

package/cjs/dist/services/booking/book-action/bookAction.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Book Action - Orchestrates the booking flow
+ *
+ * 1. Validates booking data with canBook()
+ * 2. Creates a booking via createBooking() from API layer
+ * 3. Creates a checkout via createCheckout() from API layer
+ * 4. Returns the checkoutId for navigation
+ */
+import type { BookActionParams, BookResult } from './types.js';
+/**
+ * Executes the complete booking flow:
+ * 1. Validates that all required data is present
+ * 2. Creates a booking with the selected service, time slot, and form data
+ * 3. Creates a checkout session for payment (includes contact details from booking)
+ * 4. Returns the checkout ID for navigation to the checkout page
+ *
+ * @param params - The booking action parameters
+ * @returns BookResult with the checkoutId
+ * @throws Error if validation fails, or booking/checkout creation fails
+ */
+export declare function executeBookAction(params: BookActionParams): Promise<BookResult>;