@wix/headless-bookings 0.0.27 → 0.0.29

package/cjs/dist/__mocks__/booking.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Shared mock data for booking service tests
+ */
+import type { Resource } from '@wix/auto_sdk_bookings_availability-time-slots';
+import type { FormValues } from '@wix/form-public';
+import type { ServiceSelection, ServiceSelectionTimeSlot, Location, BookingServiceConfig } from '../services/booking/booking.js';
+/**
+ * Mock time slot data
+ */
+export declare const mockTimeSlot: ServiceSelectionTimeSlot;
+/**
+ * Mock time slot for afternoon
+ */
+export declare const mockTimeSlotAfternoon: ServiceSelectionTimeSlot;
+/**
+ * Mock resource (staff member)
+ */
+export declare const mockResource: Resource;
+/**
+ * Mock resource (another staff member)
+ */
+export declare const mockResourceTwo: Resource;
+/**
+ * Mock resource (room)
+ */
+export declare const mockResourceRoom: Resource;
+/**
+ * Mock service selection with all data
+ */
+export declare const mockServiceSelection: ServiceSelection;
+/**
+ * Mock service selection without time slot (incomplete)
+ */
+export declare const mockServiceSelectionWithoutTimeSlot: ServiceSelection;
+/**
+ * Mock service selection for class
+ */
+export declare const mockServiceSelectionClass: ServiceSelection;
+/**
+ * Mock location
+ */
+export declare const mockLocation: Location;
+/**
+ * Mock location (second)
+ */
+export declare const mockLocationTwo: Location;
+/**
+ * Mock form submission (contact info)
+ */
+export declare const mockFormSubmission: FormValues;
+/**
+ * Mock form submission (minimal)
+ */
+export declare const mockFormSubmissionMinimal: FormValues;
+/**
+ * Mock form submission with custom fields
+ */
+export declare const mockFormSubmissionWithCustomFields: FormValues;
+/**
+ * Default timezone for tests
+ */
+export declare const mockTimezone = "America/New_York";
+/**
+ * Mock booking service config (empty)
+ */
+export declare const mockEmptyBookingConfig: BookingServiceConfig;
+/**
+ * Mock booking service config with initial data
+ */
+export declare const mockBookingConfigWithData: BookingServiceConfig;
+/**
+ * Mock booking service config with multiple selections
+ */
+export declare const mockBookingConfigMultipleSelections: BookingServiceConfig;
+/**
+ * Helper to create a service selection with custom instanceId
+ */
+export declare function createMockServiceSelection(overrides?: Partial<ServiceSelection>): Omit<ServiceSelection, 'instanceId'>;
+/**
+ * Helper to create multiple service selections
+ */
+export declare function createMockServiceSelections(count: number): ServiceSelection[];

package/cjs/dist/__mocks__/booking.js

@@ -0,0 +1,163 @@
+/**
+ * Shared mock data for booking service tests
+ */
+import { mockService, mockServiceClass } from './services.js';
+/**
+ * Mock time slot data
+ */
+export const mockTimeSlot = {
+    startDate: '2024-03-15T10:00:00Z',
+    endDate: '2024-03-15T11:00:00Z',
+    totalCapacity: 10,
+    remainingCapacity: 5,
+    scheduleId: 'schedule-123',
+};
+/**
+ * Mock time slot for afternoon
+ */
+export const mockTimeSlotAfternoon = {
+    startDate: '2024-03-15T14:00:00Z',
+    endDate: '2024-03-15T15:00:00Z',
+    totalCapacity: 10,
+    remainingCapacity: 8,
+    scheduleId: 'schedule-456',
+};
+/**
+ * Mock resource (staff member)
+ */
+export const mockResource = {
+    _id: 'resource-1',
+    name: 'John Doe',
+    email: 'john.doe@example.com',
+    tag: 'STAFF',
+};
+/**
+ * Mock resource (another staff member)
+ */
+export const mockResourceTwo = {
+    _id: 'resource-2',
+    name: 'Jane Smith',
+    email: 'jane.smith@example.com',
+    tag: 'STAFF',
+};
+/**
+ * Mock resource (room)
+ */
+export const mockResourceRoom = {
+    _id: 'resource-room-1',
+    name: 'Conference Room A',
+    tag: 'RESOURCE',
+};
+/**
+ * Mock service selection with all data
+ */
+export const mockServiceSelection = {
+    instanceId: 'instance-1',
+    service: mockService,
+    resources: [mockResource],
+    timeSlot: mockTimeSlot,
+    totalParticipants: 1,
+};
+/**
+ * Mock service selection without time slot (incomplete)
+ */
+export const mockServiceSelectionWithoutTimeSlot = {
+    instanceId: 'instance-2',
+    service: mockService,
+    resources: [],
+    totalParticipants: 1,
+};
+/**
+ * Mock service selection for class
+ */
+export const mockServiceSelectionClass = {
+    instanceId: 'instance-3',
+    service: mockServiceClass,
+    resources: [mockResource],
+    timeSlot: mockTimeSlotAfternoon,
+    totalParticipants: 3,
+};
+/**
+ * Mock location
+ */
+export const mockLocation = {
+    id: 'location-1',
+    name: 'Main Office',
+};
+/**
+ * Mock location (second)
+ */
+export const mockLocationTwo = {
+    id: 'location-2',
+    name: 'Downtown Branch',
+};
+/**
+ * Mock form submission (contact info)
+ */
+export const mockFormSubmission = {
+    firstName: 'John',
+    lastName: 'Doe',
+    email: 'john.doe@example.com',
+    phone: '+1234567890',
+};
+/**
+ * Mock form submission (minimal)
+ */
+export const mockFormSubmissionMinimal = {
+    email: 'test@example.com',
+};
+/**
+ * Mock form submission with custom fields
+ */
+export const mockFormSubmissionWithCustomFields = {
+    firstName: 'Jane',
+    lastName: 'Smith',
+    email: 'jane.smith@example.com',
+    notes: 'Please call before the appointment',
+    customField1: 'Custom value 1',
+};
+/**
+ * Default timezone for tests
+ */
+export const mockTimezone = 'America/New_York';
+/**
+ * Mock booking service config (empty)
+ */
+export const mockEmptyBookingConfig = {};
+/**
+ * Mock booking service config with initial data
+ */
+export const mockBookingConfigWithData = {
+    serviceSelections: [mockServiceSelection],
+    location: mockLocation,
+    timezone: mockTimezone,
+    formSubmission: mockFormSubmission,
+};
+/**
+ * Mock booking service config with multiple selections
+ */
+export const mockBookingConfigMultipleSelections = {
+    serviceSelections: [mockServiceSelection, mockServiceSelectionClass],
+    location: mockLocation,
+    timezone: mockTimezone,
+    formSubmission: mockFormSubmission,
+};
+/**
+ * Helper to create a service selection with custom instanceId
+ */
+export function createMockServiceSelection(overrides = {}) {
+    const { instanceId: _, ...base } = mockServiceSelection;
+    return {
+        ...base,
+        ...overrides,
+    };
+}
+/**
+ * Helper to create multiple service selections
+ */
+export function createMockServiceSelections(count) {
+    return Array.from({ length: count }, (_, i) => ({
+        ...mockServiceSelection,
+        instanceId: `instance-${i + 1}`,
+    }));
+}

package/cjs/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/cjs/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/cjs/dist/react/core/time-slot-list/TimeSlot.d.ts

@@ -6,7 +6,7 @@
  * which provides the TimeSlotProvider context.
  */
 import React from 'react';
-import { type TimeSlot as TimeSlotType } from '../../../services/time-slot-list/time-slot-list.def.js';
+import type { TimeSlot as TimeSlotType } from '@wix/auto_sdk_bookings_availability-time-slots';
 /**
  * Context value for TimeSlot components
  */
@@ -35,30 +35,6 @@ export interface TimeSlotProviderProps {
  * Not used directly by consumers - only by TimeSlotList.TimeSlotRepeater.
  */
 export declare function TimeSlotProvider(props: TimeSlotProviderProps): React.ReactNode;
-/**
- * Context value for Location components
- */
-export interface LocationContextValue {
-    location: LocationData;
-    selectLocation: () => void;
-}
-/**
- * Hook to access Location context
- * @throws Error if used outside of LocationProvider
- */
-export declare function useLocationContext(): LocationContextValue;
-/**
- * Props for LocationProvider
- */
-export interface LocationProviderProps {
-    children: React.ReactNode;
-    location: LocationData;
-}
-/**
- * Provider component used by LocationRepeater to provide context.
- * Not used directly by consumers - only by TimeSlot.LocationRepeater.
- */
-export declare function LocationProvider(props: LocationProviderProps): React.ReactNode;
 /**
  * Context value for StaffMember components
  */
@@ -94,6 +70,8 @@ export interface InfoProps {
         endDate: Date;
         /** Calculated duration in minutes */
         durationInMinutes: number;
+        /** Location name */
+        locationName: string;
         /** Whether the timeSlot is bookable */
         bookable: boolean;
         /** Whether this timeSlot is currently selected */
@@ -127,8 +105,8 @@ export interface ActionsProps {
     children: (data: {
         /** Action to select this timeSlot */
         selectTimeSlot: () => void;
-        /** Action to clear preferences */
-        clearPreferences?: () => void;
+        /** Action to clear staff selection */
+        clearStaffSelection?: () => void;
         /** The raw timeSlot object */
         timeSlot: TimeSlotType;
         /** Whether the timeSlot is bookable */
@@ -158,112 +136,6 @@ export interface ActionsProps {
  * ```
  */
 export declare function Actions(props: ActionsProps): React.ReactNode;
-/**
- * Location data with selection state
- */
-export interface LocationData {
-    /** Location ID */
-    id: string;
-    /** Location name */
-    name: string;
-    /** Whether this location is currently selected */
-    isSelected: boolean;
-    /** Whether this location is selectable (compatible with selected staff, or no staff selected) */
-    isSelectable: boolean;
-}
-/**
- * Props for Locations render prop component
- */
-export interface LocationsProps {
-    children: (data: {
-        /** Array of locations with selection state */
-        locations: LocationData[];
-        /** Action to select a location */
-        selectLocation: (locationId: string) => void;
-    }) => React.ReactNode;
-}
-/**
- * Core component that provides access to time slot locations via render props.
- * Extracts locations from slot.staffByLocation and enriches with name from originalSlots.
- * Each location includes isSelected and isSelectable based on current selection state.
- *
- * Returns null if there's only 1 location (nothing to choose from).
- *
- * @component
- * @example
- * ```tsx
- * <CoreTimeSlot.Locations>
- *   {({ locations, locationsCount, selectLocation }) => (
- *     <GenericList.Root items={locations}>
- *       {children}
- *     </GenericList.Root>
- *   )}
- * </CoreTimeSlot.Locations>
- * ```
- */
-export declare function Locations(props: LocationsProps): React.ReactNode;
-/**
- * Props for LocationInfo render prop component
- */
-export interface LocationInfoProps {
-    children: (data: {
-        /** Location name */
-        name: string;
-        /** Whether this location is currently selected */
-        isSelected: boolean;
-        /** Whether this location is selectable */
-        isSelectable: boolean;
-        /** The raw location object */
-        location: LocationData;
-    }) => React.ReactNode;
-}
-/**
- * Core component that provides access to location info via render props.
- * Must be used within LocationProvider.
- *
- * @component
- * @example
- * ```tsx
- * <LocationInfo>
- *   {({ name, isSelected, isSelectable }) => (
- *     <span>{name}</span>
- *   )}
- * </LocationInfo>
- * ```
- */
-export declare function LocationInfo(props: LocationInfoProps): React.ReactNode;
-/**
- * Props for LocationActions render prop component
- */
-export interface LocationActionsProps {
-    children: (data: {
-        /** Action to select this location */
-        selectLocation: () => void;
-        /** Whether this location is currently selected */
-        isSelected: boolean;
-        /** Whether this location is selectable */
-        isSelectable: boolean;
-        /** The raw location object */
-        location: LocationData;
-    }) => React.ReactNode;
-}
-/**
- * Core component that provides location actions via render props.
- * Must be used within LocationProvider.
- *
- * @component
- * @example
- * ```tsx
- * <LocationActions>
- *   {({ selectLocation, isSelected, isSelectable }) => (
- *     <button onClick={selectLocation} disabled={!isSelectable}>
- *       {isSelected ? 'Selected' : 'Select'}
- *     </button>
- *   )}
- * </LocationActions>
- * ```
- */
-export declare function LocationActions(props: LocationActionsProps): React.ReactNode;
 /**
  * Staff member data with selection state
  */
@@ -274,8 +146,6 @@ export interface StaffMemberData {
     name: string;
     /** Whether this staff member is currently selected */
     isSelected: boolean;
-    /** Whether this staff member is selectable (works at selected location, or no location selected) */
-    isSelectable: boolean;
 }
 /**
  * Props for StaffMembers render prop component
@@ -291,7 +161,7 @@ export interface StaffMembersProps {
 /**
  * Core component that provides access to time slot staff members via render props.
  * Extracts unique staff members from slot.staffByLocation (names already included).
- * Each staff member includes isSelected and isSelectable based on current selection state.
+ * Each staff member includes isSelected based on current selection state.
  *
  * Returns null if there's only 1 staff member (nothing to choose from).
  *
@@ -317,8 +187,6 @@ export interface StaffMemberInfoProps {
         name: string;
         /** Whether this staff member is currently selected */
         isSelected: boolean;
-        /** Whether this staff member is selectable */
-        isSelectable: boolean;
         /** The raw staff member object */
         staffMember: StaffMemberData;
     }) => React.ReactNode;
@@ -331,7 +199,7 @@ export interface StaffMemberInfoProps {
  * @example
  * ```tsx
  * <StaffMemberInfo>
- *   {({ name, isSelected, isSelectable }) => (
+ *   {({ name, isSelected }) => (
  *     <span>{name}</span>
  *   )}
  * </StaffMemberInfo>
@@ -347,8 +215,6 @@ export interface StaffMemberActionsProps {
         selectStaffMember: () => void;
         /** Whether this staff member is currently selected */
         isSelected: boolean;
-        /** Whether this staff member is selectable */
-        isSelectable: boolean;
         /** The raw staff member object */
         staffMember: StaffMemberData;
     }) => React.ReactNode;
@@ -361,8 +227,8 @@ export interface StaffMemberActionsProps {
  * @example
  * ```tsx
  * <StaffMemberActions>
- *   {({ selectStaffMember, isSelected, isSelectable }) => (
- *     <button onClick={selectStaffMember} disabled={!isSelectable}>
+ *   {({ selectStaffMember, isSelected }) => (
+ *     <button onClick={selectStaffMember}>
  *       {isSelected ? 'Selected' : 'Select'}
  *     </button>
  *   )}