@wix/headless-bookings 0.0.25 → 0.0.26

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/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 @wix/auto_sdk_bookings_bookings
+ * 3. Creates a checkout via createCheckout() from @wix/auto_sdk_ecom_checkout
+ * 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>;

package/cjs/dist/services/booking/book-action/bookAction.js

@@ -0,0 +1,59 @@
+/**
+ * Book Action - Orchestrates the booking flow
+ *
+ * 1. Validates booking data with canBook()
+ * 2. Creates a booking via createBooking() from @wix/auto_sdk_bookings_bookings
+ * 3. Creates a checkout via createCheckout() from @wix/auto_sdk_ecom_checkout
+ * 4. Returns the checkoutId for navigation
+ */
+import { createBooking } from '@wix/auto_sdk_bookings_bookings';
+import { createCheckout } from '@wix/auto_sdk_ecom_checkout';
+import { buildBookingRequest } from './buildBookingRequest.js';
+import { buildCheckoutRequest } from './buildCheckoutRequest.js';
+import { canBook } from './canBook.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 async function executeBookAction(params) {
+    // Step 0: Validate
+    if (!canBook({
+        serviceSelections: params.serviceSelections,
+        formSubmission: params.formSubmission,
+    })) {
+        throw new Error('Cannot book: missing required data');
+    }
+    // Step 1: Create booking
+    const createBookingRequest = buildBookingRequest(params);
+    const bookingResponse = await createBooking(createBookingRequest.booking, {
+        participantNotification: createBookingRequest.participantNotification,
+        sendSmsReminder: createBookingRequest.sendSmsReminder,
+        formSubmission: createBookingRequest.formSubmission,
+    });
+    const bookingId = bookingResponse.booking?._id;
+    const contactDetails = bookingResponse.booking?.contactDetails;
+    if (!bookingId) {
+        throw new Error('Failed to create booking');
+    }
+    // Step 2: Create checkout
+    // businessLocationId comes from location.id for multi-location support
+    const businessLocationId = params.location?.id ?? undefined;
+    const checkoutRequest = buildCheckoutRequest({
+        bookingId,
+        contactDetails,
+        businessLocationId,
+    });
+    const checkoutResponse = await createCheckout(checkoutRequest);
+    const checkoutId = checkoutResponse._id;
+    if (!checkoutId) {
+        throw new Error('Failed to create checkout');
+    }
+    return { checkoutId };
+}

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

@@ -0,0 +1,22 @@
+/**
+ * Builds the createBooking request from BookActionParams
+ */
+import type { CreateBookingRequest } from '@wix/auto_sdk_bookings_bookings';
+import type { BookActionParams } from './types.js';
+/**
+ * Builds a CreateBookingRequest from the booking action parameters
+ *
+ * Maps ServiceSelection data to the Booking API's slot format:
+ * - serviceId: from serviceSelection.service._id
+ * - scheduleId: from serviceSelection.timeSlot.scheduleId
+ * - startDate: from serviceSelection.timeSlot.startDate
+ * - endDate: from serviceSelection.timeSlot.endDate
+ * - timezone: from serviceSelection.timezone
+ * - eventId: from serviceSelection.timeSlot.eventInfo.eventId (for classes)
+ * - location: from location param
+ * - resource: from serviceSelection.resources[0]
+ *
+ * @param params - The booking action parameters
+ * @returns CreateBookingRequest ready to be sent to the API
+ */
+export declare function buildBookingRequest(params: BookActionParams): CreateBookingRequest;

package/cjs/dist/services/booking/book-action/buildBookingRequest.js

@@ -0,0 +1,81 @@
+/**
+ * Builds the createBooking request from BookActionParams
+ */
+/**
+ * Derives the selected payment option from service payment settings.
+ * Maps service.payment.options to booking API's selectedPaymentOption.
+ *
+ * @param service - The service containing payment options
+ * @returns 'ONLINE' or 'OFFLINE' based on available payment methods
+ */
+function deriveSelectedPaymentOption(service) {
+    const options = service.payment?.options;
+    // Only online payment available
+    if (options?.online && !options?.inPerson) {
+        return 'ONLINE';
+    }
+    // Only offline payment available
+    if (!options?.online && options?.inPerson) {
+        return 'OFFLINE';
+    }
+    // Both available or neither specified - default to ONLINE
+    return 'ONLINE';
+}
+/**
+ * Builds a CreateBookingRequest from the booking action parameters
+ *
+ * Maps ServiceSelection data to the Booking API's slot format:
+ * - serviceId: from serviceSelection.service._id
+ * - scheduleId: from serviceSelection.timeSlot.scheduleId
+ * - startDate: from serviceSelection.timeSlot.startDate
+ * - endDate: from serviceSelection.timeSlot.endDate
+ * - timezone: from serviceSelection.timezone
+ * - eventId: from serviceSelection.timeSlot.eventInfo.eventId (for classes)
+ * - location: from location param
+ * - resource: from serviceSelection.resources[0]
+ *
+ * @param params - The booking action parameters
+ * @returns CreateBookingRequest ready to be sent to the API
+ */
+export function buildBookingRequest(params) {
+    const { serviceSelections, location, formSubmission } = params;
+    const item = serviceSelections[0]; // Single booking focus
+    if (!item) {
+        throw new Error('No service selection provided');
+    }
+    if (!item.timeSlot) {
+        throw new Error('No time slot selected for service selection');
+    }
+    // Get resource from service selection
+    const resource = item.resources?.[0];
+    return {
+        booking: {
+            // Payment option derived from service payment settings
+            selectedPaymentOption: deriveSelectedPaymentOption(item.service),
+            // Participants
+            totalParticipants: item.totalParticipants || 1,
+            // Booked entity slot
+            bookedEntity: {
+                slot: {
+                    serviceId: item.service._id ?? undefined,
+                    scheduleId: item.timeSlot.scheduleId ?? undefined,
+                    startDate: item.timeSlot.startDate,
+                    endDate: item.timeSlot.endDate,
+                    timezone: params.timezone,
+                    eventId: item.timeSlot.eventInfo?.eventId ?? undefined,
+                    resource: resource
+                        ? { _id: resource._id, name: resource.name }
+                        : undefined,
+                    location: location
+                        ? { _id: location.id, name: location.name }
+                        : undefined,
+                },
+            },
+        },
+        participantNotification: {
+            notifyParticipants: true,
+        },
+        sendSmsReminder: true,
+        formSubmission: formSubmission ?? undefined,
+    };
+}

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

@@ -0,0 +1,26 @@
+/**
+ * Builds the createCheckout request
+ */
+import type { CreateCheckoutRequest } from '@wix/auto_sdk_ecom_checkout';
+import type { ContactDetails } from '@wix/auto_sdk_bookings_bookings';
+/**
+ * Parameters for building checkout request
+ */
+export interface BuildCheckoutParams {
+    bookingId: string;
+    contactDetails?: ContactDetails;
+    businessLocationId?: string;
+}
+/**
+ * Builds a checkout request from the booking ID and contact details
+ *
+ * Contact details come from the booking response and are used to populate:
+ * - billingInfo.contactDetails (firstName, lastName, phone)
+ * - billingInfo.address (from fullAddress if available)
+ * - shippingInfo.shippingDestination.contactDetails
+ * - buyerInfo (email, contactId)
+ *
+ * @param params - The checkout parameters
+ * @returns CreateCheckoutRequest ready to be sent to the API
+ */
+export declare function buildCheckoutRequest(params: BuildCheckoutParams): CreateCheckoutRequest;