@wix/headless-bookings 0.0.25 → 0.0.27

package/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/dist/services/booking/book-action/buildCheckoutRequest.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Builds the createCheckout request
+ */
+import { type CreateCheckoutRequest } from '../../../api/create-checkout/index.js';
+import type { ContactDetails } from '../../../api/create-booking/index.js';
+/**
+ * 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;

package/dist/services/booking/book-action/buildCheckoutRequest.js

@@ -0,0 +1,62 @@
+/**
+ * Builds the createCheckout request
+ */
+import { ChannelType, } from '../../../api/create-checkout/index.js';
+const BOOKINGS_APP_DEF_ID = '13d21c63-b5ec-5912-8397-c3a5ddb27a97';
+/**
+ * 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 function buildCheckoutRequest(params) {
+    const { bookingId, contactDetails, businessLocationId } = params;
+    // Build checkoutInfo incrementally for readability
+    const checkoutInfo = {};
+    // businessLocationId for multi-location support
+    if (businessLocationId) {
+        checkoutInfo.businessLocationId = businessLocationId;
+    }
+    // Billing info and shipping info from contact details
+    if (contactDetails) {
+        checkoutInfo.billingInfo = {
+            contactDetails,
+            ...(contactDetails.fullAddress?.country
+                ? { address: { ...contactDetails.fullAddress } }
+                : {}),
+        };
+        checkoutInfo.shippingInfo = {
+            shippingDestination: {
+                contactDetails,
+            },
+        };
+    }
+    // Buyer info with email and contactId
+    if (contactDetails?.email) {
+        checkoutInfo.buyerInfo = {
+            email: contactDetails.email,
+            ...(contactDetails.contactId
+                ? { contactId: contactDetails.contactId }
+                : {}),
+        };
+    }
+    return {
+        channelType: ChannelType.WEB,
+        lineItems: [
+            {
+                quantity: 1,
+                catalogReference: {
+                    catalogItemId: bookingId,
+                    appId: BOOKINGS_APP_DEF_ID,
+                },
+            },
+        ],
+        checkoutInfo,
+    };
+}

package/dist/services/booking/book-action/canBook.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Validation logic for the Book action
+ */
+import type { ServiceSelection } from '../booking.js';
+import type { FormValues } from '@wix/form-public';
+/**
+ * Parameters for canBook validation
+ */
+export interface CanBookParams {
+    serviceSelections: ServiceSelection[];
+    formSubmission: FormValues | null;
+}
+/**
+ * Validates if booking can be executed
+ * Checks that all required data is present:
+ * - At least one service selection
+ * - Each service selection has a time slot selected
+ * - Form submission filled
+ *
+ * @param params - The booking data to validate
+ * @returns true if booking can proceed, false otherwise
+ */
+export declare function canBook(params: CanBookParams): boolean;

package/dist/services/booking/book-action/canBook.js

@@ -0,0 +1,19 @@
+/**
+ * Validation logic for the Book action
+ */
+/**
+ * Validates if booking can be executed
+ * Checks that all required data is present:
+ * - At least one service selection
+ * - Each service selection has a time slot selected
+ * - Form submission filled
+ *
+ * @param params - The booking data to validate
+ * @returns true if booking can proceed, false otherwise
+ */
+export function canBook(params) {
+    const { serviceSelections, formSubmission } = params;
+    return (serviceSelections.length > 0 &&
+        serviceSelections.every((item) => item.timeSlot !== undefined) &&
+        formSubmission !== null);
+}

package/dist/services/booking/book-action/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Book Action - Exports
+ */
+export { executeBookAction } from './bookAction.js';
+export { canBook, type CanBookParams } from './canBook.js';
+export { buildBookingRequest } from './buildBookingRequest.js';
+export { buildCheckoutRequest, type BuildCheckoutParams, } from './buildCheckoutRequest.js';
+export type { BookProps, BookResult, BookingError, BookActionParams, BookChildProps, } from './types.js';

package/dist/services/booking/book-action/index.js

@@ -0,0 +1,7 @@
+/**
+ * Book Action - Exports
+ */
+export { executeBookAction } from './bookAction.js';
+export { canBook } from './canBook.js';
+export { buildBookingRequest } from './buildBookingRequest.js';
+export { buildCheckoutRequest, } from './buildCheckoutRequest.js';

package/dist/services/booking/book-action/types.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Types for the Book action
+ */
+import type { ServiceSelection, Location } from '../booking.js';
+import type { FormValues } from '@wix/form-public';
+/**
+ * Result returned from the book action
+ */
+export type BookResult = {
+    checkoutId: string;
+};
+/**
+ * Error object for booking errors
+ */
+export interface BookingError {
+    message: string;
+    errorObject: unknown;
+}
+/**
+ * Parameters for executing the book action
+ */
+export interface BookActionParams {
+    serviceSelections: ServiceSelection[];
+    location: Location | null;
+    formSubmission: FormValues | null;
+    timezone?: string;
+}
+/**
+ * Props passed to children of Book component
+ */
+export interface BookChildProps {
+    isLoading: boolean;
+    error: BookingError | null;
+    canBook: boolean;
+    onClick: () => void;
+    disabled: boolean;
+}
+/**
+ * Props for the Book headless 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;
+}

package/dist/services/booking/book-action/types.js

@@ -0,0 +1,4 @@
+/**
+ * Types for the Book action
+ */
+export {};

package/dist/services/booking/booking.d.ts

@@ -7,6 +7,7 @@ import { type Signal } from '@wix/services-definitions/core-services/signals';
 import type { Service } from '@wix/auto_sdk_bookings_services';
 import type { Resource, EventInfo } from '@wix/auto_sdk_bookings_availability-time-slots';
 import type { FormValues } from '@wix/form-public';
+import type { BookResult } from './book-action/types.js';
 export declare const ANY_STAFF_MEMBER_ID = "__any_staff_member__";
 /**
  * Minimal time slot data for service selections
@@ -62,6 +63,7 @@ export interface BookingServiceActions {
     setFormSubmission(values: FormValues | null): void;
     clearFormSubmission(): void;
     clearAll(): void;
+    book(): Promise<BookResult>;
 }
 /**
  * Booking Service interface

package/dist/services/booking/booking.js

@@ -5,6 +5,7 @@
  */
 import { defineService, implementService } from '@wix/services-definitions';
 import { SignalsServiceDefinition, } from '@wix/services-definitions/core-services/signals';
+import { executeBookAction } from './book-action/bookAction.js';
 // ============================================================================
 // Constants
 // ============================================================================
@@ -174,6 +175,21 @@ export const BookingService = implementService.withConfig()(BookingServiceDefini
             locationSignal.set(null);
             formSubmissionSignal.set(null);
         },
+        // Book action - collects data from signals and delegates to executeBookAction
+        // Loading/error state management is handled in Book.tsx component
+        async book() {
+            const serviceSelections = serviceSelectionsSignal.get();
+            const formSubmission = formSubmissionSignal.get();
+            const location = locationSignal.get();
+            const timezone = timezoneSignal.get();
+            // Validation happens inside executeBookAction
+            return executeBookAction({
+                serviceSelections,
+                formSubmission,
+                location,
+                timezone,
+            });
+        },
     };
     return {
         serviceSelections: serviceSelectionsSignal,

package/dist/services/index.d.ts

@@ -6,4 +6,5 @@ export { ServiceService, ServiceServiceDefinition, type ServiceServiceAPI, type
 export { BookingService, BookingServiceDefinition, type BookingServiceConfig, type Location, type BookingServiceActions, type ServiceSelection, type ServiceSelectionTimeSlot, } from './booking/booking.js';
 export { TimeSlotListService, TimeSlotListServiceDefinition, ViewMode, loadTimeSlotListConfig, type TimeSlotListServiceAPI, type TimeSlotListServiceActions, type TimeSlotListServiceConfig, type SlotSelection, type TimeSlot, type LoadTimeSlotListConfigOptions, type LoadTimeSlotListConfigResult, } from './time-slot-list/index.js';
 export { ServiceListService, ServiceListServiceDefinition, type ServiceListServiceAPI, type ServiceListServiceConfig, type ServiceListFilters, type ServiceListActions, type QueryOptions, loadServiceListServiceInitialData, type SuccessServiceListServiceConfigResult, type ErrorServiceListServiceConfigResult, } from './service-list/service-list.js';
+export { executeBookAction, canBook, buildBookingRequest, buildCheckoutRequest, type CanBookParams, type BookResult, type BookingError, type BookActionParams, type BookChildProps, type BookProps, type BuildCheckoutParams, } from './booking/book-action/index.js';
 export { BookingFormService, BookingFormServiceDefinition, type BookingFormServiceAPI, type BookingFormServiceConfig, type BookingFormServiceInternalAPI, type ValidationResult, } from './booking-form/booking-form.js';

package/dist/services/index.js

@@ -6,4 +6,5 @@ export { ServiceService, ServiceServiceDefinition, loadServiceServiceInitialData
 export { BookingService, BookingServiceDefinition, } from './booking/booking.js';
 export { TimeSlotListService, TimeSlotListServiceDefinition, ViewMode, loadTimeSlotListConfig, } from './time-slot-list/index.js';
 export { ServiceListService, ServiceListServiceDefinition, loadServiceListServiceInitialData, } from './service-list/service-list.js';
+export { executeBookAction, canBook, buildBookingRequest, buildCheckoutRequest, } from './booking/book-action/index.js';
 export { BookingFormService, BookingFormServiceDefinition, } from './booking-form/booking-form.js';

package/dist/services/time-slot-list/time-slot-list.def.d.ts

@@ -3,8 +3,16 @@
  * Defines interfaces and service contract for time slot management
  */
 import type { Signal } from '@wix/services-definitions/core-services/signals';
-import type { TimeSlot as ApiTimeSlot, Location } from '@wix/auto_sdk_bookings_availability-time-slots';
+import type { TimeSlot as ApiTimeSlot, LocationTypeWithLiterals } from '@wix/auto_sdk_bookings_availability-time-slots';
 import type { Service } from '@wix/auto_sdk_bookings_services';
+/**
+ * Location filter input for availability calls.
+ * Require a stable `id` + `locationType` pair (no optional fields).
+ */
+export interface Location {
+    id: string;
+    locationType: LocationTypeWithLiterals;
+}
 export declare enum ViewMode {
     CLASSIC = "classic",
     AGENDA = "agenda"
@@ -48,7 +56,7 @@ export interface SlotSelection {
  */
 export interface TimeSlotsFilters {
     /** Filter by specific locations */
-    locations?: Location[];
+    location?: Location;
     /** Filter by specific staff member IDs */
     staffMemberIds?: string[];
     /** Filter by bookable status. If undefined, returns both bookable and non-bookable */

package/dist/services/time-slot-list/time-slot-list.js

@@ -65,31 +65,13 @@ export const TimeSlotListService = implementService.withConfig()(TimeSlotListSer
      * Helper: Get services from config or BookingService
      */
     const getServices = () => {
-        if (config.services?.length)
-            return config.services;
-        return bookingService.serviceSelections.get().map((s) => s.service);
-    };
-    /**
-     * Helper: Get filters from config or BookingService
-     */
-    const getFilters = () => {
-        // Get BookingService selections (these take priority)
-        const location = bookingService.location.get();
-        const serviceSelections = bookingService.serviceSelections.get();
-        const selectedStaffMemberIds = serviceSelections
-            .map((serviceSelection) => serviceSelection.resources.map((r) => r._id))
-            .flat();
-        const selectedLocation = location ? { _id: location.id } : null;
-        // Merge config filters with BookingService selections (selections win)
-        return {
-            ...config.filters,
-            locations: selectedLocation
-                ? [selectedLocation]
-                : config.filters?.locations,
-            staffMemberIds: selectedStaffMemberIds.length
-                ? selectedStaffMemberIds
-                : config.filters?.staffMemberIds,
-        };
+        const selectedServices = bookingService.serviceSelections
+            .get()
+            .map((s) => s.service);
+        if (selectedServices.length) {
+            return selectedServices;
+        }
+        return config.services ?? [];
     };
     /**
      * Fetch time slots from API
@@ -97,7 +79,6 @@ export const TimeSlotListService = implementService.withConfig()(TimeSlotListSer
      */
     const fetchTimeSlots = async () => {
         const selectedServices = getServices();
-        const filters = getFilters();
         isLoadingSignal.set(true);
         errorSignal.set(null);
         cursorSignal.set(undefined);
@@ -110,7 +91,7 @@ export const TimeSlotListService = implementService.withConfig()(TimeSlotListSer
                 timeZone: bookingService.timezone.get(),
                 viewMode: viewModeSignal.get(),
                 cursor: cursorSignal.get(),
-                ...filters,
+                ...config.filters,
             });
             timeSlotsSignal.set(response.timeSlots);
             const nextCursor = response.cursorPagingMetadata?.cursors?.next ?? undefined;
@@ -303,7 +284,6 @@ export const TimeSlotListService = implementService.withConfig()(TimeSlotListSer
         if (!cursor || isLoadingSignal.get())
             return;
         const selectedServices = getServices();
-        const filters = getFilters();
         isLoadingSignal.set(true);
         try {
             const response = await fetchAvailability({
@@ -313,7 +293,7 @@ export const TimeSlotListService = implementService.withConfig()(TimeSlotListSer
                 timeZone: bookingService.timezone.get(),
                 cursor,
                 viewMode: viewModeSignal.get(),
-                ...filters,
+                ...config.filters,
             });
             // API returns grouped slots, merge with existing
             const existing = timeSlotsSignal.get();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/headless-bookings",
-  "version": "0.0.25",
+  "version": "0.0.27",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -33,8 +33,9 @@
     }
   },
   "dependencies": {
+    "@wix/auto_sdk_bookings_bookings": "^1.0.103",
     "@wix/auto_sdk_bookings_event-time-slots": "^1.0.64",
-    "@wix/bookings": "^1.0.122",
+    "@wix/auto_sdk_ecom_checkout": "^1.0.104",
     "@wix/form-public": "^0.64.0",
     "@wix/headless-forms": "0.0.20",
     "@wix/headless-media": "0.0.18",
@@ -71,5 +72,5 @@
       "groupId": "com.wixpress.headless-components"
     }
   },
-  "falconPackageHash": "53ad05f1a9b4cbafe9436ee555493cc5284eb79a1b34b7f0ea78aa6a"
+  "falconPackageHash": "fcc6fed76998cb4042fc59d2b43ef150e4446496a06668af64c20b9b"
 }