@wix/headless-bookings 0.0.26 → 0.0.28

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

@@ -10,37 +10,11 @@ import { BookingServiceDefinition, ANY_STAFF_MEMBER_ID, } from '../booking/booki
 // ============================================================================
 // Helpers
 // ============================================================================
-function getDefaultEndDate() {
-    return new Date(Date.now() + 7 * 24 * 60 * 60 * 1000);
-}
 function getClientTimezone() {
     return typeof Intl !== 'undefined'
         ? Intl.DateTimeFormat().resolvedOptions().timeZone
         : undefined;
 }
-/**
- * Merges new grouped slots with existing ones
- * Slots with the same start time are merged
- */
-function mergeGroupedSlots(existing, newSlots) {
-    const mergedMap = new Map();
-    for (const slot of existing) {
-        mergedMap.set(slot.localStartDate, slot);
-    }
-    for (const newSlot of newSlots) {
-        const key = newSlot.localStartDate;
-        const existingSlot = mergedMap.get(key);
-        if (existingSlot) {
-            // Merge staffByLocation and originalSlots
-            existingSlot.staffByLocation.push(...newSlot.staffByLocation);
-            existingSlot.originalSlots.push(...newSlot.originalSlots);
-        }
-        else {
-            mergedMap.set(key, newSlot);
-        }
-    }
-    return Array.from(mergedMap.values());
-}
 // ============================================================================
 // Service Implementation
 // ============================================================================
@@ -48,18 +22,15 @@ export const TimeSlotListService = implementService.withConfig()(TimeSlotListSer
     // Get dependent services
     const signalsService = getService(SignalsServiceDefinition);
     const bookingService = getService(BookingServiceDefinition);
-    // Initialize default values
-    const currentDate = new Date();
     // Initialize Signals
     const timeSlotsSignal = signalsService.signal(config.timeSlots || []);
-    const selectionSignal = signalsService.signal(null);
     const isLoadingSignal = signalsService.signal(false);
     const errorSignal = signalsService.signal(null);
     const hasMoreSignal = signalsService.signal(false);
     // Internal only - viewMode is auto-detected based on service types
     const viewModeSignal = signalsService.signal(ViewMode.CLASSIC);
-    const startDateSignal = signalsService.signal(config.startDate || currentDate);
-    const endDateSignal = signalsService.signal(config.endDate || getDefaultEndDate());
+    const startDateSignal = signalsService.signal(config.startDate);
+    const endDateSignal = signalsService.signal(config.endDate);
     const cursorSignal = signalsService.signal(undefined);
     /**
      * Helper: Get services from config or BookingService
@@ -110,16 +81,11 @@ export const TimeSlotListService = implementService.withConfig()(TimeSlotListSer
     };
     /**
      * Action: Select a time slot
-     * Auto-selects location/staff based on availability:
-     * - One location + one staff → auto-select both
-     * - One location + many staff → auto-select location only
-     * - Many locations + one staff → auto-select staff only
-     * - Many locations + many staff → don't auto-select anything
+     * Writes selection directly into BookingService (TimeSlotList does not track selection state)
+     * - Always sets booking location from slot.location (one location per slot)
+     * - Auto-selects staff only when there is exactly one staff option in this slot
      */
     const selectSlot = (slot) => {
-        const currentSelection = selectionSignal.get();
-        if (currentSelection?.slot?.id === slot.id)
-            return;
         const timeSlot = {
             startDate: slot.localStartDate,
             endDate: slot.localEndDate,
@@ -128,93 +94,34 @@ export const TimeSlotListService = implementService.withConfig()(TimeSlotListSer
             scheduleId: slot.scheduleId ?? undefined,
             eventInfo: slot.eventInfo ?? undefined,
         };
-        const hasOneLocation = slot.staffByLocation.length === 1;
-        // Collect all unique staff members across all locations
-        const allStaffMembers = slot.staffByLocation.flatMap((loc) => loc.staffMembers);
-        const uniqueStaffIds = new Set(allStaffMembers.map((s) => s.id));
-        const hasOneStaff = uniqueStaffIds.size === 1;
-        // Determine what to auto-select
-        let locationId = null;
-        let staffMemberId = null;
-        if (hasOneLocation) {
-            const { location } = slot.staffByLocation[0];
-            locationId = location.id;
-            bookingService.actions.setLocation(location);
-        }
-        else {
-            bookingService.actions.clearLocation();
-        }
-        if (hasOneStaff) {
-            const staffMember = allStaffMembers[0];
-            staffMemberId = staffMember.id;
-            bookingService.actions.updateItem({
-                timeSlot,
-                resources: [
-                    {
-                        _id: staffMemberId,
-                        name: staffMember.name,
-                    },
-                ],
-            });
-        }
-        else {
-            bookingService.actions.updateItem({
-                timeSlot,
-                resources: [],
-            });
-        }
-        selectionSignal.set({
-            slot,
-            locationId,
-            staffMemberId,
+        bookingService.actions.setLocation({
+            id: slot.location?._id,
+            name: slot.location?.name ?? undefined,
+        });
+        const staffMembersFromSlot = slot.availableResources[0].resources.map((r) => ({
+            id: r._id,
+            name: r.name,
+        }));
+        const resources = staffMembersFromSlot.length === 1 ? staffMembersFromSlot : [];
+        bookingService.actions.updateItem({
+            timeSlot,
+            resources,
         });
-    };
-    /**
-     * Action: Select a location for the current slot
-     * Updates the booking service with the location
-     * If the location has only one staff member, auto-selects that staff member too
-     */
-    const selectLocation = (locationId) => {
-        const currentSelections = selectionSignal.get();
-        if (!currentSelections?.slot)
-            return;
-        const slot = currentSelections.slot;
-        const locationEntry = slot.staffByLocation.find((loc) => loc.location.id === locationId);
-        if (!locationEntry)
-            return;
-        const { location, staffMembers } = locationEntry;
-        bookingService.actions.setLocation(location);
-        // If this location has only one staff member, auto-select them
-        const hasOneStaff = staffMembers.length === 1;
-        if (hasOneStaff) {
-            const staffMember = staffMembers[0];
-            selectionSignal.set({
-                ...currentSelections,
-                locationId,
-                staffMemberId: staffMember.id,
-            });
-            bookingService.actions.updateItem({
-                resources: [
-                    {
-                        _id: staffMember.id,
-                        name: staffMember.name,
-                    },
-                ],
-            });
-        }
-        else {
-            selectionSignal.set({ ...currentSelections, locationId });
-        }
     };
     /**
      * Action: Select a staff member for the current slot
      * Updates the booking service with the selected resource
-     * If the staff member is only available at one location, auto-selects that location too
      */
     const selectStaffMember = (staffMemberId) => {
-        const currentSelections = selectionSignal.get();
-        if (!currentSelections?.slot)
+        const selectedBookingTimeSlot = bookingService.serviceSelections.get()[0]?.timeSlot;
+        if (!selectedBookingTimeSlot)
             return;
+        const findStaffName = (id) => {
+            const slots = timeSlotsSignal.get();
+            return (slots
+                .flatMap((slot) => slot.availableResources[0].resources)
+                .find((r) => r._id === id)?.name ?? undefined);
+        };
         if (staffMemberId === ANY_STAFF_MEMBER_ID) {
             bookingService.actions.updateItem({
                 resources: [
@@ -224,54 +131,24 @@ export const TimeSlotListService = implementService.withConfig()(TimeSlotListSer
                     },
                 ],
             });
-            selectionSignal.set({ ...currentSelections, staffMemberId });
             return;
         }
-        const slot = currentSelections.slot;
-        // Find all locations that have this staff member
-        const locationsWithThisStaff = slot.staffByLocation.filter((loc) => loc.staffMembers.some((s) => s.id === staffMemberId));
-        // Find the staff member info
-        const staffMember = locationsWithThisStaff[0]?.staffMembers.find((s) => s.id === staffMemberId);
-        if (!staffMember)
-            return;
         bookingService.actions.updateItem({
             resources: [
                 {
-                    _id: staffMember.id,
-                    name: staffMember.name,
+                    _id: staffMemberId,
+                    name: findStaffName(staffMemberId),
                 },
             ],
         });
-        // If this staff member is only at one location, auto-select that location
-        const hasOneLocation = locationsWithThisStaff.length === 1;
-        if (hasOneLocation) {
-            const location = locationsWithThisStaff[0].location;
-            selectionSignal.set({
-                ...currentSelections,
-                staffMemberId,
-                locationId: location.id,
-            });
-            bookingService.actions.setLocation(location);
-        }
-        else {
-            selectionSignal.set({ ...currentSelections, staffMemberId });
-        }
     };
     /**
-     * Action: Clear preferences (location and staff) while keeping the slot selected
+     * Action: Clear staff selection while keeping the selected time slot
      */
-    const clearPreferences = () => {
-        const currentSelection = selectionSignal.get();
-        if (!currentSelection?.slot)
+    const clearStaffSelection = () => {
+        const selectedBookingTimeSlot = bookingService.serviceSelections.get()[0]?.timeSlot;
+        if (!selectedBookingTimeSlot)
             return;
-        // Keep the slot, but clear location and staff selections
-        selectionSignal.set({
-            slot: currentSelection.slot,
-            locationId: null,
-            staffMemberId: null,
-        });
-        // Clear selections in booking service
-        bookingService.actions.clearLocation();
         bookingService.actions.updateItem({
             resources: [],
         });
@@ -295,9 +172,10 @@ export const TimeSlotListService = implementService.withConfig()(TimeSlotListSer
                 viewMode: viewModeSignal.get(),
                 ...config.filters,
             });
-            // API returns grouped slots, merge with existing
-            const existing = timeSlotsSignal.get();
-            timeSlotsSignal.set(mergeGroupedSlots(existing, response.timeSlots));
+            timeSlotsSignal.set([
+                ...timeSlotsSignal.get(),
+                ...response.timeSlots,
+            ]);
             const nextCursor = response.cursorPagingMetadata?.cursors?.next ?? undefined;
             cursorSignal.set(nextCursor);
             hasMoreSignal.set(!!nextCursor);
@@ -345,7 +223,6 @@ export const TimeSlotListService = implementService.withConfig()(TimeSlotListSer
     return {
         // State Signals
         timeSlots: timeSlotsSignal,
-        selection: selectionSignal,
         isLoading: isLoadingSignal,
         error: errorSignal,
         hasMore: hasMoreSignal,
@@ -355,9 +232,8 @@ export const TimeSlotListService = implementService.withConfig()(TimeSlotListSer
         // Actions
         actions: {
             selectSlot,
-            selectLocation,
             selectStaffMember,
-            clearPreferences,
+            clearStaffSelection,
             loadMore,
             setDateRange,
         },
@@ -385,22 +261,17 @@ export const TimeSlotListService = implementService.withConfig()(TimeSlotListSer
  * ```
  */
 export async function loadTimeSlotListConfig(options) {
-    const now = new Date();
-    const startDate = options.startDate || now;
-    const endDate = options.endDate || getDefaultEndDate();
     try {
         const response = await fetchAvailability({
             services: options.services || [],
-            fromLocalDate: startDate,
-            toLocalDate: endDate,
+            fromLocalDate: options.startDate,
+            toLocalDate: options.endDate,
             timeZone: options.timezone ?? getClientTimezone(),
             ...options.filters,
         });
         const config = {
             ...options,
             timeSlots: response.timeSlots || [],
-            startDate,
-            endDate,
         };
         return { type: 'success', config };
     }

package/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/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/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/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/dist/api/fetch-availability/index.d.ts

@@ -2,9 +2,9 @@
  * Time Slot List API
  * Fetches available time slots for booking services from Wix Bookings
  */
-import { type CursorPaging, type CursorPagingMetadata } from '@wix/auto_sdk_bookings_availability-time-slots';
+import { type TimeSlot, 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, type Location } from '../../services/time-slot-list/time-slot-list.def.js';
+import { ViewMode, type Location } from '../../services/time-slot-list/time-slot-list.def.js';
 export interface FetchAvailabilityOptions {
     services: Service[];
     fromLocalDate?: string | null;
@@ -28,14 +28,14 @@ export interface FetchAvailabilityOptions {
  * Response from fetchAvailability with grouped time slots
  */
 export interface FetchAvailabilityResponse {
-    /** Grouped time slots (one per unique time) */
+    /** time slots */
     timeSlots: TimeSlot[];
     /** Cursor pagination metadata for loading more results */
     cursorPagingMetadata?: CursorPagingMetadata;
 }
 /**
  * Main entry point for fetching availability
- * Detects flow type, calls appropriate API, and groups slots by time
+ * Detects flow type and calls appropriate API
  *
  * @param options - Fetch options including services, date range, timezone, and view mode
  * @returns Promise with grouped time slots

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

@@ -29,50 +29,6 @@ function toLocalDateString(date) {
     return format(date, pattern);
 }
 // ============================================================================
-// Grouping Functions
-// ============================================================================
-/**
- * Groups API time slots by their start time
- * Multiple slots for the same time (different locations) are merged into one
- */
-function groupTimeSlotsByTime(apiSlots) {
-    const groupedMap = new Map();
-    for (const apiSlot of apiSlots) {
-        const key = apiSlot.localStartDate;
-        if (!groupedMap.has(key)) {
-            // Create new grouped slot - omit location and availableResources
-            const { location: _location, availableResources: _availableResources, ...rest } = apiSlot;
-            groupedMap.set(key, {
-                ...rest,
-                staffByLocation: [],
-                originalSlots: [],
-                id: apiSlot.localStartDate,
-            });
-        }
-        const groupedSlot = groupedMap.get(key);
-        // Extract staff members with IDs and names from availableResources
-        const staffMembers = (apiSlot.availableResources || [])
-            .flatMap((resourceGroup) => resourceGroup.resources || [])
-            .filter((resource) => resource._id && resource.name)
-            .map((resource) => ({
-            id: resource._id,
-            name: resource.name,
-        }));
-        // Add this slot's location/staff info
-        const staffByLocation = {
-            location: {
-                id: apiSlot.location?._id,
-                name: apiSlot.location?.name,
-            },
-            staffMembers,
-        };
-        groupedSlot.staffByLocation.push(staffByLocation);
-        // Store original slot for booking service
-        groupedSlot.originalSlots.push(apiSlot);
-    }
-    return Array.from(groupedMap.values());
-}
-// ============================================================================
 // Internal Flow Detection
 // ============================================================================
 /**
@@ -98,7 +54,7 @@ function detectFlow(bookingServices, viewMode) {
 }
 /**
  * Main entry point for fetching availability
- * Detects flow type, calls appropriate API, and groups slots by time
+ * Detects flow type and calls appropriate API
  *
  * @param options - Fetch options including services, date range, timezone, and view mode
  * @returns Promise with grouped time slots
@@ -158,7 +114,7 @@ export async function fetchAvailability({ services: selectedServices, viewMode =
             timeSlotsPerDay,
         });
         return {
-            timeSlots: groupTimeSlotsByTime(response.timeSlots || []),
+            timeSlots: response.timeSlots || [],
             cursorPagingMetadata: response.cursorPagingMetadata,
         };
     }
@@ -188,7 +144,7 @@ export async function fetchAvailability({ services: selectedServices, viewMode =
             maxSlotsPerDay: timeSlotsPerDay,
         });
         return {
-            timeSlots: groupTimeSlotsByTime(response.timeSlots || []),
+            timeSlots: response.timeSlots || [],
             cursorPagingMetadata: response.pagingMetadata,
         };
     }

package/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/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