@wix/headless-bookings 0.0.15 → 0.0.16

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

@@ -3,8 +3,8 @@
  * Provides low-level access to BookingService via render props and service setup
  */
 import React from 'react';
-import { type BookingServiceConfig, type BookingSelection } from '../../../services/booking/booking.js';
-import type { TimeSlot } from '@wix/auto_sdk_bookings_availability-time-slots';
+import { type BookingServiceConfig, type BookingItem, type Location, type BookingServiceActions } from '../../../services/booking/booking.js';
+import type { FormValues } from '@wix/form-public';
 /**
  * Props for Booking.Root component
  */
@@ -28,14 +28,22 @@ export interface RootProps {
  * ```
  */
 export declare function Root(props: RootProps): React.ReactNode;
+/**
+ * Data exposed by Booking.Data component
+ * Mirrors BookingServiceConfig structure with actions
+ */
+export interface BookingData {
+    bookingItems: BookingItem[];
+    location: Location | null;
+    formValues: FormValues | null;
+    numberOfParticipants: number;
+    actions: BookingServiceActions;
+}
 /**
  * Props for Data render prop component
  */
 export interface DataProps {
-    children: (data: {
-        bookingSelections: BookingSelection[];
-        selectedTimeSlot: TimeSlot | null;
-    }) => React.ReactNode;
+    children: (data: BookingData) => React.ReactNode;
 }
 /**
  * Core component that provides access to booking data via render props.
@@ -45,9 +53,9 @@ export interface DataProps {
  * @example
  * ```tsx
  * <Booking.Data>
- *   {({ bookingSelections }) => (
- *     bookingSelections.length > 0 ? (
- *       <div>{bookingSelections.map(s => s.service.name).join(', ')}</div>
+ *   {({ bookingItems, location, formValues, numberOfParticipants, actions }) => (
+ *     bookingItems.length > 0 ? (
+ *       <div>{bookingItems.map(item => item.service.name).join(', ')}</div>
  *     ) : (
  *       <div>No services selected</div>
  *     )

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

@@ -28,9 +28,9 @@ export function Root(props) {
  * @example
  * ```tsx
  * <Booking.Data>
- *   {({ bookingSelections }) => (
- *     bookingSelections.length > 0 ? (
- *       <div>{bookingSelections.map(s => s.service.name).join(', ')}</div>
+ *   {({ bookingItems, location, formValues, numberOfParticipants, actions }) => (
+ *     bookingItems.length > 0 ? (
+ *       <div>{bookingItems.map(item => item.service.name).join(', ')}</div>
  *     ) : (
  *       <div>No services selected</div>
  *     )
@@ -41,10 +41,16 @@ export function Root(props) {
 export function Data(props) {
     const { children } = props;
     const bookingService = useService(BookingServiceDefinition);
-    const bookingSelections = bookingService.bookingSelections.get();
-    const selectedTimeSlot = bookingService.timeSlot.get();
+    const bookingItems = bookingService.bookingItems.get();
+    const location = bookingService.location.get();
+    const formValues = bookingService.formValues.get();
+    const numberOfParticipants = bookingService.numberOfParticipants.get();
+    const { actions } = bookingService;
     return children({
-        bookingSelections,
-        selectedTimeSlot,
+        bookingItems,
+        location,
+        formValues,
+        numberOfParticipants,
+        actions,
     });
 }

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

@@ -5,19 +5,31 @@
  */
 import { type Signal } from '@wix/services-definitions/core-services/signals';
 import type { Service } from '@wix/auto_sdk_bookings_services';
-import type { TimeSlot, Resource, NestedTimeSlot } from '@wix/auto_sdk_bookings_availability-time-slots';
+import type { Resource, EventInfo } from '@wix/auto_sdk_bookings_availability-time-slots';
 import type { FormValues } from '@wix/form-public';
 /**
- * BookingSelection contains the service AND its related selections
+ * Minimal time slot data for booking items
  */
-export interface BookingSelection {
+export interface BookingItemTimeSlot {
+    startDate: string;
+    endDate: string;
+    totalCapacity?: number;
+    remainingCapacity?: number;
+    scheduleId?: string;
+    eventInfo?: EventInfo;
+}
+/**
+ * BookingItem contains the service AND its related selections
+ */
+export interface BookingItem {
     /** Unique identifier for this booking instance (allows same service multiple times) */
     instanceId: string;
+    /** The selected service */
     service: Service;
     /** Selected resources (staff members, rooms, etc.) */
-    staff?: Resource;
-    /** Per-service slot data from nested slots (for multi-service bookings) */
-    nestedSlotData?: NestedTimeSlot;
+    resources: Resource[];
+    /** Per-item time slot data */
+    timeSlot?: BookingItemTimeSlot;
 }
 export interface Location {
     id: string;
@@ -27,21 +39,25 @@ export interface Location {
  * BookingService actions - setters only, no API calls
  */
 export interface BookingServiceActions {
-    /** Clears all booking selections and sets a single service (instanceId is auto-generated) */
-    setService(service: Omit<BookingSelection, 'instanceId'>): string;
-    /** Adds a service and returns the generated instanceId */
-    addService(service: Omit<BookingSelection, 'instanceId'>): string;
-    /** Updates a booking selection. If no instanceId provided, updates the first selection. */
-    updateBookingSelection(updates: Partial<Omit<BookingSelection, 'instanceId'>>, instanceId?: string): void;
-    /** Removes a booking selection. If no instanceId provided, removes the first selection. */
-    removeBookingSelection(instanceId?: string): void;
-    clearServices(): void;
-    setTimeSlot(slot: TimeSlot | null): void;
-    clearTimeSlot(): void;
+    /** Clears all booking items and sets a single item (instanceId is auto-generated) */
+    setItem(item: Omit<BookingItem, 'instanceId'>): string;
+    /** Adds an item and returns the generated instanceId */
+    addItem(item: Omit<BookingItem, 'instanceId'>): string;
+    /** Updates a booking item. If no instanceId provided, updates the first item. */
+    updateItem(updates: Partial<Omit<BookingItem, 'instanceId'>>, instanceId?: string): void;
+    /** Removes a booking item. If no instanceId provided, removes the first item. */
+    removeItem(instanceId?: string): void;
+    /** Clears all booking items */
+    clearItems(): void;
+    /** Sets a resource by ID within a booking item. If no instanceId provided, uses the first item. */
+    setResourceById(resourceId: string, resource: Resource, instanceId?: string): void;
+    /** Gets a resource by ID from a booking item. If no instanceId provided, uses the first item. */
+    getResourceById(resourceId: string, instanceId?: string): Resource | undefined;
     setLocation(location: Location | null): void;
     clearLocation(): void;
     setFormValues(values: FormValues | null): void;
     clearFormValues(): void;
+    setNumberOfParticipants(count: number): void;
     clearAll(): void;
 }
 /**
@@ -49,14 +65,14 @@ export interface BookingServiceActions {
  * Pure state management - no API calls
  */
 export interface BookingService {
-    /** Signal containing the booking selections (services with their related data) */
-    bookingSelections: Signal<BookingSelection[]>;
-    /** Signal containing the currently selected time slot */
-    timeSlot: Signal<TimeSlot | null>;
-    /** Signal containing the selected location (derived from timeSlot) */
+    /** Signal containing the booking items (services with their related data) */
+    bookingItems: Signal<BookingItem[]>;
+    /** Signal containing the selected location */
     location: Signal<Location | null>;
     /** Signal containing the form values */
     formValues: Signal<FormValues | null>;
+    /** Signal containing the number of participants */
+    numberOfParticipants: Signal<number>;
     /** Actions for modifying booking state */
     actions: BookingServiceActions;
 }
@@ -70,15 +86,17 @@ export declare const BookingServiceDefinition: string & {
 } & BookingService;
 /**
  * Configuration interface for BookingService
- * Note: location is NOT in config - it's derived internally from timeSlot
+ * Mirrors BookingService structure (without actions and Signal wrappers)
  */
 export interface BookingServiceConfig {
-    /** Optional initial booking selections to pre-populate */
-    initialBookingSelections?: BookingSelection[];
-    /** Optional initial time slot to pre-populate */
-    initialTimeSlot?: TimeSlot | null;
+    /** Optional initial booking items to pre-populate */
+    bookingItems?: BookingItem[];
+    /** Optional initial location */
+    location?: Location | null;
     /** Optional initial form values */
-    initialFormValues?: FormValues | null;
+    formValues?: FormValues | null;
+    /** Optional initial number of participants (defaults to 1) */
+    numberOfParticipants?: number;
 }
 /**
  * Implementation of BookingService
@@ -98,8 +116,8 @@ export interface BookingServiceConfig {
  *
  * // In any page - access booking data
  * <Booking.Data>
- *   {({ services, timeSlot, location, formValues, actions }) => (
- *     <div>{services.map(s => s.service.name).join(', ')}</div>
+ *   {({ bookingItems, location, formValues, actions }) => (
+ *     <div>{bookingItems.map(item => item.service.name).join(', ')}</div>
  *   )}
  * </Booking.Data>
  * ```

package/cjs/dist/services/booking/booking.js

@@ -9,7 +9,7 @@ import { SignalsServiceDefinition, } from '@wix/services-definitions/core-servic
 // Types
 // ============================================================================
 /**
- * Generates a unique instance ID for service selections
+ * Generates a unique instance ID for booking items
  */
 function generateInstanceId() {
     return crypto.randomUUID();
@@ -39,8 +39,8 @@ export const BookingServiceDefinition = defineService('booking');
  *
  * // In any page - access booking data
  * <Booking.Data>
- *   {({ services, timeSlot, location, formValues, actions }) => (
- *     <div>{services.map(s => s.service.name).join(', ')}</div>
+ *   {({ bookingItems, location, formValues, actions }) => (
+ *     <div>{bookingItems.map(item => item.service.name).join(', ')}</div>
  *   )}
  * </Booking.Data>
  * ```
@@ -48,67 +48,93 @@ export const BookingServiceDefinition = defineService('booking');
 export const BookingService = implementService.withConfig()(BookingServiceDefinition, ({ getService, config }) => {
     const signalsService = getService(SignalsServiceDefinition);
     // Initialize signals with config values
-    // Ensure all initial booking selections have instanceIds
-    const initialSelectionsWithIds = (config.initialBookingSelections || []).map((s) => ({
-        ...s,
-        instanceId: s.instanceId || generateInstanceId(),
+    // Ensure all initial booking items have instanceIds
+    const initialItemsWithIds = (config.bookingItems || []).map((item) => ({
+        ...item,
+        instanceId: item.instanceId || generateInstanceId(),
     }));
-    const bookingSelectionsSignal = signalsService.signal(initialSelectionsWithIds);
-    const timeSlotSignal = signalsService.signal(config.initialTimeSlot || null);
-    // Location is derived internally - initialize as null
-    const locationSignal = signalsService.signal(null);
-    const formValuesSignal = signalsService.signal(config.initialFormValues || null);
+    const bookingItemsSignal = signalsService.signal(initialItemsWithIds);
+    const locationSignal = signalsService.signal(config.location || null);
+    const formValuesSignal = signalsService.signal(config.formValues || null);
+    const numberOfParticipantsSignal = signalsService.signal(config.numberOfParticipants ?? 1);
     // ========================================================================
     // Actions Implementation
     // ========================================================================
     const actions = {
-        // Services actions
-        setService(service) {
+        // Item management actions
+        setItem(item) {
             const instanceId = generateInstanceId();
-            const newSelection = {
-                ...service,
+            const newItem = {
+                ...item,
                 instanceId,
             };
-            bookingSelectionsSignal.set([newSelection]);
+            bookingItemsSignal.set([newItem]);
             return instanceId;
         },
-        addService(service) {
+        addItem(item) {
             const instanceId = generateInstanceId();
-            const current = bookingSelectionsSignal.get();
-            const newSelection = {
-                ...service,
+            const current = bookingItemsSignal.get();
+            const newItem = {
+                ...item,
                 instanceId,
             };
-            bookingSelectionsSignal.set([...current, newSelection]);
+            bookingItemsSignal.set([...current, newItem]);
             return instanceId;
         },
-        updateBookingSelection(updates, instanceId) {
-            const current = bookingSelectionsSignal.get();
-            // If no instanceId provided, update the first selection (index 0)
+        updateItem(updates, instanceId) {
+            const current = bookingItemsSignal.get();
+            // If no instanceId provided, update the first item (index 0)
             const targetId = instanceId ?? current[0]?.instanceId;
-            const updated = current.map((s) => s.instanceId === targetId ? { ...s, ...updates } : s);
-            bookingSelectionsSignal.set(updated);
+            const updated = current.map((item) => item.instanceId === targetId ? { ...item, ...updates } : item);
+            bookingItemsSignal.set(updated);
         },
-        removeBookingSelection(instanceId) {
-            const current = bookingSelectionsSignal.get();
+        removeItem(instanceId) {
+            const current = bookingItemsSignal.get();
             if (!instanceId) {
-                // Remove first selection if no instanceId provided
-                bookingSelectionsSignal.set(current.slice(1));
+                // Remove first item if no instanceId provided
+                bookingItemsSignal.set(current.slice(1));
             }
             else {
-                const filtered = current.filter((s) => s.instanceId !== instanceId);
-                bookingSelectionsSignal.set(filtered);
+                const filtered = current.filter((item) => item.instanceId !== instanceId);
+                bookingItemsSignal.set(filtered);
             }
         },
-        clearServices() {
-            bookingSelectionsSignal.set([]);
+        clearItems() {
+            bookingItemsSignal.set([]);
         },
-        // Time Slot actions
-        setTimeSlot(slot) {
-            timeSlotSignal.set(slot);
+        // Resource helpers
+        setResourceById(resourceId, resource, instanceId) {
+            const current = bookingItemsSignal.get();
+            // If no instanceId provided, use the first item
+            const targetId = instanceId ?? current[0]?.instanceId;
+            if (!targetId)
+                return;
+            const updated = current.map((item) => {
+                if (item.instanceId !== targetId)
+                    return item;
+                // Find and replace resource by ID, or add if not found
+                const existingIndex = item.resources.findIndex((r) => r._id === resourceId);
+                const newResources = [...item.resources];
+                if (existingIndex >= 0) {
+                    newResources[existingIndex] = resource;
+                }
+                else {
+                    newResources.push(resource);
+                }
+                return { ...item, resources: newResources };
+            });
+            bookingItemsSignal.set(updated);
         },
-        clearTimeSlot() {
-            timeSlotSignal.set(null);
+        getResourceById(resourceId, instanceId) {
+            const current = bookingItemsSignal.get();
+            // If no instanceId provided, use the first item
+            const targetId = instanceId ?? current[0]?.instanceId;
+            if (!targetId)
+                return undefined;
+            const targetItem = current.find((item) => item.instanceId === targetId);
+            if (!targetItem)
+                return undefined;
+            return targetItem.resources.find((r) => r._id === resourceId);
         },
         // Location actions
         setLocation(location) {
@@ -124,19 +150,23 @@ export const BookingService = implementService.withConfig()(BookingServiceDefini
         clearFormValues() {
             formValuesSignal.set(null);
         },
+        // Number of Participants actions
+        setNumberOfParticipants(count) {
+            numberOfParticipantsSignal.set(count);
+        },
         // Clear all
         clearAll() {
-            bookingSelectionsSignal.set([]);
-            timeSlotSignal.set(null);
+            bookingItemsSignal.set([]);
             locationSignal.set(null);
             formValuesSignal.set(null);
+            numberOfParticipantsSignal.set(1);
         },
     };
     return {
-        bookingSelections: bookingSelectionsSignal,
-        timeSlot: timeSlotSignal,
+        bookingItems: bookingItemsSignal,
         location: locationSignal,
         formValues: formValuesSignal,
+        numberOfParticipants: numberOfParticipantsSignal,
         actions,
     };
 });

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

@@ -3,6 +3,6 @@
  * Main export file for all service definitions and implementations
  */
 export { ServiceService, ServiceServiceDefinition, type ServiceServiceAPI, type ServiceServiceConfig, type ServiceActions, type ServicePaymentData, loadServiceServiceInitialData, type SuccessServiceServiceConfigResult, type NotFoundServiceServiceConfigResult, } from './service/service.js';
-export { BookingService, BookingServiceDefinition, type BookingServiceConfig, type BookingSelection, type Location, type BookingServiceActions, } from './booking/booking.js';
+export { BookingService, BookingServiceDefinition, type BookingServiceConfig, type Location, type BookingServiceActions, } from './booking/booking.js';
 export { TimeSlotListService, TimeSlotListServiceDefinition, ViewMode, loadTimeSlotListConfig, type TimeSlotListServiceAPI, type TimeSlotListServiceActions, type TimeSlotListServiceConfig, type SlotSelection, type LoadTimeSlotListConfigOptions, type LoadTimeSlotListConfigResult, } from './time-slot-list/index.js';
 export { ServiceListService, ServiceListServiceDefinition, type ServiceListServiceAPI, type ServiceListServiceConfig, type ServiceListActions, type QueryOptions, loadServiceListServiceInitialData, type SuccessServiceListServiceConfigResult, type ErrorServiceListServiceConfigResult, } from './service-list/service-list.js';

package/cjs/dist/services/service/service.js

@@ -81,8 +81,8 @@ export const ServiceService = implementService.withConfig()(ServiceServiceDefini
         const currentService = serviceSignal.get();
         if (!currentService._id)
             return false;
-        const selections = bookingService.bookingSelections.get();
-        return selections.some((selection) => selection.service._id === currentService._id);
+        const bookingItems = bookingService.bookingItems.get();
+        return bookingItems.some(({ service }) => service._id === currentService._id);
     });
     // requiresAvailability signal - true for APPOINTMENT and CLASS types
     const requiresAvailabilitySignal = signalsService.computed(() => {
@@ -185,25 +185,28 @@ export const ServiceService = implementService.withConfig()(ServiceServiceDefini
             if (!bookableSignal.get() || !bookingService)
                 return;
             const currentService = serviceSignal.get();
-            bookingService.actions.setService({ service: currentService });
+            bookingService.actions.updateItem({ service: currentService });
         },
         add: () => {
             if (!bookableSignal.get() || !bookingService)
                 return;
             const currentService = serviceSignal.get();
-            bookingService.actions.addService({ service: currentService });
+            bookingService.actions.addItem({
+                service: currentService,
+                resources: [],
+            });
         },
         remove: () => {
             if (!bookableSignal.get() || !bookingService)
                 return;
             const currentService = serviceSignal.get();
             // Remove all instances of this service (by serviceId)
-            const selections = bookingService.bookingSelections.get();
-            const instancesToRemove = selections
+            const bookingItems = bookingService.bookingItems.get();
+            const instancesToRemove = bookingItems
                 .filter((s) => s.service._id === currentService._id)
                 .map((s) => s.instanceId);
             instancesToRemove.forEach((instanceId) => {
-                bookingService.actions.removeBookingSelection(instanceId);
+                bookingService.actions.removeItem(instanceId);
             });
         },
     };