@wix/headless-bookings 0.0.11 → 0.0.13

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

@@ -4,15 +4,20 @@
  * Persists across page navigation in SPA until page refresh
  */
 import { type Signal } from '@wix/services-definitions/core-services/signals';
-import type { services, availabilityTimeSlots } from '@wix/bookings';
+import type { Service } from '@wix/auto_sdk_bookings_services';
+import type { TimeSlot, Resource, NestedTimeSlot } from '@wix/auto_sdk_bookings_availability-time-slots';
 import type { FormValues } from '@wix/form-public';
 /**
- * ServiceSelection contains the service AND its related selections
+ * BookingSelection contains the service AND its related selections
  */
-export interface ServiceSelection {
-    service: services.Service;
+export interface BookingSelection {
+    /** Unique identifier for this booking instance (allows same service multiple times) */
+    instanceId: string;
+    service: Service;
     /** Selected resources (staff members, rooms, etc.) */
-    resources?: availabilityTimeSlots.Resource[];
+    staff?: Resource;
+    /** Per-service slot data from nested slots (for multi-service bookings) */
+    nestedSlotData?: NestedTimeSlot;
 }
 export interface Location {
     id: string;
@@ -22,12 +27,16 @@ export interface Location {
  * BookingService actions - setters only, no API calls
  */
 export interface BookingServiceActions {
-    setServices(services: ServiceSelection[]): void;
-    addService(service: ServiceSelection): void;
-    updateService(serviceId: string, updates: Partial<ServiceSelection>): void;
-    removeService(serviceId: string): void;
+    /** 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: availabilityTimeSlots.TimeSlot | null): void;
+    setTimeSlot(slot: TimeSlot | null): void;
     clearTimeSlot(): void;
     setLocation(location: Location | null): void;
     clearLocation(): void;
@@ -40,10 +49,10 @@ export interface BookingServiceActions {
  * Pure state management - no API calls
  */
 export interface BookingService {
-    /** Signal containing the currently selected services with their selections */
-    services: Signal<ServiceSelection[]>;
+    /** Signal containing the booking selections (services with their related data) */
+    bookingSelections: Signal<BookingSelection[]>;
     /** Signal containing the currently selected time slot */
-    timeSlot: Signal<availabilityTimeSlots.TimeSlot | null>;
+    timeSlot: Signal<TimeSlot | null>;
     /** Signal containing the selected location (derived from timeSlot) */
     location: Signal<Location | null>;
     /** Signal containing the form values */
@@ -64,10 +73,10 @@ export declare const BookingServiceDefinition: string & {
  * Note: location is NOT in config - it's derived internally from timeSlot
  */
 export interface BookingServiceConfig {
-    /** Optional initial services to pre-populate */
-    initialServices?: ServiceSelection[];
+    /** Optional initial booking selections to pre-populate */
+    initialBookingSelections?: BookingSelection[];
     /** Optional initial time slot to pre-populate */
-    initialTimeSlot?: availabilityTimeSlots.TimeSlot | null;
+    initialTimeSlot?: TimeSlot | null;
     /** Optional initial form values */
     initialFormValues?: FormValues | null;
 }

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

@@ -5,6 +5,15 @@
  */
 import { defineService, implementService } from '@wix/services-definitions';
 import { SignalsServiceDefinition, } from '@wix/services-definitions/core-services/signals';
+// ============================================================================
+// Types
+// ============================================================================
+/**
+ * Generates a unique instance ID for service selections
+ */
+function generateInstanceId() {
+    return crypto.randomUUID();
+}
 /**
  * Service definition for Booking
  */
@@ -39,7 +48,12 @@ export const BookingServiceDefinition = defineService('booking');
 export const BookingService = implementService.withConfig()(BookingServiceDefinition, ({ getService, config }) => {
     const signalsService = getService(SignalsServiceDefinition);
     // Initialize signals with config values
-    const servicesSignal = signalsService.signal(config.initialServices || []);
+    // Ensure all initial booking selections have instanceIds
+    const initialSelectionsWithIds = (config.initialBookingSelections || []).map((s) => ({
+        ...s,
+        instanceId: s.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);
@@ -49,25 +63,45 @@ export const BookingService = implementService.withConfig()(BookingServiceDefini
     // ========================================================================
     const actions = {
         // Services actions
-        setServices(newServices) {
-            servicesSignal.set(newServices);
+        setService(service) {
+            const instanceId = generateInstanceId();
+            const newSelection = {
+                ...service,
+                instanceId,
+            };
+            bookingSelectionsSignal.set([newSelection]);
+            return instanceId;
         },
         addService(service) {
-            const current = servicesSignal.get();
-            servicesSignal.set([...current, service]);
+            const instanceId = generateInstanceId();
+            const current = bookingSelectionsSignal.get();
+            const newSelection = {
+                ...service,
+                instanceId,
+            };
+            bookingSelectionsSignal.set([...current, newSelection]);
+            return instanceId;
         },
-        updateService(serviceId, updates) {
-            const current = servicesSignal.get();
-            const updated = current.map((s) => s.service._id === serviceId ? { ...s, ...updates } : s);
-            servicesSignal.set(updated);
+        updateBookingSelection(updates, instanceId) {
+            const current = bookingSelectionsSignal.get();
+            // If no instanceId provided, update the first selection (index 0)
+            const targetId = instanceId ?? current[0]?.instanceId;
+            const updated = current.map((s) => s.instanceId === targetId ? { ...s, ...updates } : s);
+            bookingSelectionsSignal.set(updated);
         },
-        removeService(serviceId) {
-            const current = servicesSignal.get();
-            const filtered = current.filter((s) => s.service._id !== serviceId);
-            servicesSignal.set(filtered);
+        removeBookingSelection(instanceId) {
+            const current = bookingSelectionsSignal.get();
+            if (!instanceId) {
+                // Remove first selection if no instanceId provided
+                bookingSelectionsSignal.set(current.slice(1));
+            }
+            else {
+                const filtered = current.filter((s) => s.instanceId !== instanceId);
+                bookingSelectionsSignal.set(filtered);
+            }
         },
         clearServices() {
-            servicesSignal.set([]);
+            bookingSelectionsSignal.set([]);
         },
         // Time Slot actions
         setTimeSlot(slot) {
@@ -92,14 +126,14 @@ export const BookingService = implementService.withConfig()(BookingServiceDefini
         },
         // Clear all
         clearAll() {
-            servicesSignal.set([]);
+            bookingSelectionsSignal.set([]);
             timeSlotSignal.set(null);
             locationSignal.set(null);
             formValuesSignal.set(null);
         },
     };
     return {
-        services: servicesSignal,
+        bookingSelections: bookingSelectionsSignal,
         timeSlot: timeSlotSignal,
         location: locationSignal,
         formValues: formValuesSignal,

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

@@ -3,5 +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 ServiceSelection, type Location, type BookingServiceActions, } from './booking/booking.js';
+export { BookingService, BookingServiceDefinition, type BookingServiceConfig, type BookingSelection, 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/index.js

@@ -4,4 +4,5 @@
  */
 export { ServiceService, ServiceServiceDefinition, loadServiceServiceInitialData, } from './service/service.js';
 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';

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

@@ -3,7 +3,7 @@
  * Handles loading and managing a single service's data, loading state, and errors.
  */
 import { type Signal, type ReadOnlySignal } from '@wix/services-definitions/core-services/signals';
-import { services } from '@wix/bookings';
+import { type Service, type Payment } from '@wix/auto_sdk_bookings_services';
 import type { MoneyData } from '@wix/headless-components/react';
 /**
  * Actions object for service selection
@@ -23,9 +23,9 @@ export interface ServiceActions {
  */
 export interface ServicePaymentData {
     /** The service payment information from the service */
-    servicePayment: services.Payment | undefined;
+    servicePayment: Payment | undefined;
     /** The rate type of the service (FIXED, VARIED, CUSTOM, NO_FEE, etc.) */
-    rateType: services.Payment['rateType'] | undefined;
+    rateType: Payment['rateType'] | undefined;
     /** Primary price (used for FIXED or VARIED default) */
     money: MoneyData | null;
     /** Minimum price (used for VARIED) */
@@ -46,7 +46,7 @@ export interface ServicePaymentData {
  */
 export interface ServiceServiceAPI {
     /** Reactive signal containing the current service data */
-    serviceSignal: Signal<services.Service>;
+    serviceSignal: Signal<Service>;
     /** Reactive signal indicating if a service is currently being loaded */
     isLoadingSignal: Signal<boolean>;
     /** Reactive signal containing any error message, or null if no error */
@@ -83,7 +83,7 @@ export declare const ServiceServiceDefinition: string & {
  */
 export interface ServiceServiceConfig {
     /** The initial service data to configure the service with */
-    service?: services.Service;
+    service?: Service;
     /** The service ID to load if no initial service is provided */
     serviceId?: string;
     /** The service slug to load if no initial service is provided */

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

@@ -4,9 +4,9 @@
  */
 import { defineService, implementService } from '@wix/services-definitions';
 import { SignalsServiceDefinition, } from '@wix/services-definitions/core-services/signals';
-import { services } from '@wix/bookings';
+import { ServiceType, RateType, } from '@wix/auto_sdk_bookings_services';
 import { getServiceById, getServiceBySlug, } from '../../api/query-services/index.js';
-import { BookingServiceDefinition, } from '../booking/booking.js';
+import { BookingServiceDefinition } from '../booking/booking.js';
 import { convertToMoneyData } from '../../utils/money.js';
 /**
  * Booking app ID constant
@@ -81,15 +81,15 @@ export const ServiceService = implementService.withConfig()(ServiceServiceDefini
         const currentService = serviceSignal.get();
         if (!currentService._id)
             return false;
-        const services = bookingService.services.get();
-        return services.some((selection) => selection.service._id === currentService._id);
+        const selections = bookingService.bookingSelections.get();
+        return selections.some((selection) => selection.service._id === currentService._id);
     });
     // requiresAvailability signal - true for APPOINTMENT and CLASS types
     const requiresAvailabilitySignal = signalsService.computed(() => {
         const currentService = serviceSignal.get();
         const serviceType = currentService.type;
-        return (serviceType === services.ServiceType.APPOINTMENT ||
-            serviceType === services.ServiceType.CLASS);
+        return (serviceType === ServiceType.APPOINTMENT ||
+            serviceType === ServiceType.CLASS);
     });
     // paymentData signal - computed payment data from service
     const paymentDataSignal = signalsService.computed(() => {
@@ -104,21 +104,21 @@ export const ServiceService = implementService.withConfig()(ServiceServiceDefini
         // Extract pricing based on rate type
         if (payment) {
             switch (rateType) {
-                case services.RateType.FIXED:
+                case RateType.FIXED:
                     // FIXED: Use payment.fixed.price
                     money = convertToMoneyData(payment.fixed?.price);
                     break;
-                case services.RateType.VARIED:
+                case RateType.VARIED:
                     // VARIED: Use defaultPrice as money, plus min/max for range
                     money = convertToMoneyData(payment.varied?.defaultPrice);
                     minPrice = convertToMoneyData(payment.varied?.minPrice);
                     maxPrice = convertToMoneyData(payment.varied?.maxPrice);
                     break;
-                case services.RateType.CUSTOM:
+                case RateType.CUSTOM:
                     // CUSTOM: Use description text (no numeric price)
                     priceDescription = payment.custom?.description || null;
                     break;
-                case services.RateType.NO_FEE:
+                case RateType.NO_FEE:
                     // NO_FEE: Free service (amount = 0)
                     money = { amount: 0, currency: 'USD' };
                     break;
@@ -185,27 +185,26 @@ export const ServiceService = implementService.withConfig()(ServiceServiceDefini
             if (!bookableSignal.get() || !bookingService)
                 return;
             const currentService = serviceSignal.get();
-            const selection = {
-                service: currentService,
-            };
-            bookingService.actions.setServices([selection]);
+            bookingService.actions.setService({ service: currentService });
         },
         add: () => {
             if (!bookableSignal.get() || !bookingService)
                 return;
             const currentService = serviceSignal.get();
-            const selection = {
-                service: currentService,
-            };
-            bookingService.actions.addService(selection);
+            bookingService.actions.addService({ service: currentService });
         },
         remove: () => {
             if (!bookableSignal.get() || !bookingService)
                 return;
             const currentService = serviceSignal.get();
-            if (currentService._id) {
-                bookingService.actions.removeService(currentService._id);
-            }
+            // Remove all instances of this service (by serviceId)
+            const selections = bookingService.bookingSelections.get();
+            const instancesToRemove = selections
+                .filter((s) => s.service._id === currentService._id)
+                .map((s) => s.instanceId);
+            instancesToRemove.forEach((instanceId) => {
+                bookingService.actions.removeBookingSelection(instanceId);
+            });
         },
     };
     return {

package/cjs/dist/services/service-list/service-list.d.ts

@@ -3,7 +3,7 @@
  * Handles querying and pagination of services list (NO selection management)
  */
 import { type Signal, type ReadOnlySignal } from '@wix/services-definitions/core-services/signals';
-import { services } from '@wix/bookings';
+import type { Service } from '@wix/auto_sdk_bookings_services';
 import type { QueryServicesRequest, PagingMetadata } from '../../api/query-services/index.js';
 export type { ServiceListFilters } from '../../api/query-services/index.js';
 /**
@@ -15,7 +15,7 @@ export type QueryOptions = Omit<QueryServicesRequest, 'pagingMetadata'>;
  * Configuration for the ServiceList service
  */
 export interface ServiceListServiceConfig {
-    services?: services.Service[];
+    services?: Service[];
     options?: QueryServicesRequest;
 }
 /**
@@ -30,7 +30,7 @@ export interface ServiceListActions {
  */
 export interface ServiceListServiceAPI {
     /** Reactive signal containing the list of services */
-    servicesSignal: Signal<services.Service[]>;
+    servicesSignal: Signal<Service[]>;
     /** Reactive signal containing current query options (appId, filters, sort) - changes trigger re-fetch */
     queryOptionsSignal: Signal<QueryOptions>;
     /** Reactive signal containing pagination metadata (limit, offset, count, hasNext) - updated after fetches */

package/cjs/dist/services/time-slot-list/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * TimeSlotList Service
+ * Main export file for time slot list service
+ */
+export { TimeSlotListServiceDefinition, ViewMode, type TimeSlotListServiceAPI, type TimeSlotListServiceActions, type TimeSlotListServiceConfig, type SlotSelection, } from './time-slot-list.def.js';
+export { TimeSlotListService, loadTimeSlotListConfig, type LoadTimeSlotListConfigOptions, type LoadTimeSlotListConfigResult, } from './time-slot-list.js';

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

@@ -0,0 +1,6 @@
+/**
+ * TimeSlotList Service
+ * Main export file for time slot list service
+ */
+export { TimeSlotListServiceDefinition, ViewMode, } from './time-slot-list.def.js';
+export { TimeSlotListService, loadTimeSlotListConfig, } from './time-slot-list.js';

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

@@ -0,0 +1,58 @@
+/**
+ * TimeSlotList Service Implementation
+ * Manages time slot fetching, selection, and state
+ */
+import type { Service } from '@wix/auto_sdk_bookings_services';
+import { type TimeSlotListServiceConfig, ViewMode } from './time-slot-list.def.js';
+export declare const TimeSlotListService: import("@wix/services-definitions").ServiceFactory<string & {
+    __api: import("./time-slot-list.def.js").TimeSlotListServiceAPI;
+    __config: {};
+    isServiceDefinition?: boolean;
+} & import("./time-slot-list.def.js").TimeSlotListServiceAPI, TimeSlotListServiceConfig>;
+/**
+ * Options for loading time slots configuration on the server
+ */
+export interface LoadTimeSlotListConfigOptions {
+    /** Services to fetch time slots for */
+    services?: Service[];
+    /** Start date for the time range (defaults to current date) */
+    startDate?: Date;
+    /** End date for the time range (defaults to 7 days from start) */
+    endDate?: Date;
+    /** Timezone for formatting (defaults to UTC) */
+    timezone?: string;
+    /** View mode (defaults to CLASSIC) */
+    viewMode?: ViewMode;
+}
+/**
+ * Result type for SSR loader - either success with config or error
+ */
+export type LoadTimeSlotListConfigResult = {
+    type: 'success';
+    config: TimeSlotListServiceConfig;
+} | {
+    type: 'error';
+    error: string;
+};
+/**
+ * SSR Loader: Pre-fetches time slots for server-side rendering
+ * Use this in Astro/Next.js getServerSideProps or page loaders
+ *
+ * @example
+ * ```typescript
+ * // In Astro page
+ * const loadResult = await loadTimeSlotListConfig({
+ *   services: bookingServices,
+ *   startDate: new Date(),
+ *   endDate: addDays(new Date(), 7),
+ *   timezone: 'America/New_York',
+ * });
+ *
+ * if (loadResult.type === 'error') {
+ *   // Handle error
+ * }
+ *
+ * const timeSlotListConfig = loadResult.config;
+ * ```
+ */
+export declare function loadTimeSlotListConfig(options: LoadTimeSlotListConfigOptions): Promise<LoadTimeSlotListConfigResult>;

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

@@ -0,0 +1,84 @@
+/**
+ * TimeSlotList Service Definition
+ * Defines interfaces and service contract for time slot management
+ */
+import type { Signal } from '@wix/services-definitions/core-services/signals';
+import type { TimeSlot as ApiTimeSlot } from '@wix/auto_sdk_bookings_availability-time-slots';
+import type { Service } from '@wix/auto_sdk_bookings_services';
+export declare enum ViewMode {
+    CLASSIC = "classic",
+    AGENDA = "agenda"
+}
+/**
+ * Maps a location to its available staff members
+ */
+export interface StaffByLocation {
+    location: {
+        id: string;
+        name: string;
+    };
+    staffMembers: {
+        id: string;
+        name: string;
+    }[];
+}
+/**
+ * Grouped time slot that represents a unique time with all available locations/staff
+ * Extends the API TimeSlot type but replaces location-specific fields with aggregated data
+ */
+export interface TimeSlot extends Omit<ApiTimeSlot, 'location' | 'availableResources'> {
+    /** Maps each location to its available staff members */
+    staffByLocation: StaffByLocation[];
+    /** Original API slots for this time (needed for booking service) */
+    originalSlots: ApiTimeSlot[];
+    /** Unique identifier for the time slot */
+    id: string;
+}
+/**
+ * User's selection state
+ */
+export interface SlotSelection {
+    slot: TimeSlot;
+    locationId: string | null;
+    staffMemberId: string | null;
+}
+export interface TimeSlotListServiceConfig {
+    /** Services to fetch time slots for */
+    services?: Service[];
+    /** Pre-loaded time slots (from SSR) - already grouped by time */
+    timeSlots?: TimeSlot[];
+    /** Start date for the time range */
+    startDate?: Date;
+    /** End date for the time range */
+    endDate?: Date;
+    /** Timezone for formatting */
+    timezone?: string;
+    /** View mode */
+    viewMode?: ViewMode;
+}
+export interface TimeSlotListServiceActions {
+    selectSlot: (slot: TimeSlot) => void;
+    selectLocation: (locationId: string) => void;
+    selectStaffMember: (staffMemberId: string) => void;
+    clearPreferences: () => void;
+    loadMore: () => Promise<void>;
+    setDateRange: (start: Date, end: Date) => void;
+    setTimezone: (tz: string) => void;
+}
+export interface TimeSlotListServiceAPI {
+    timeSlots: Signal<TimeSlot[]>;
+    selection: Signal<SlotSelection | null>;
+    isLoading: Signal<boolean>;
+    error: Signal<string | null>;
+    hasMore: Signal<boolean>;
+    viewMode: Signal<ViewMode>;
+    startDate: Signal<Date>;
+    endDate: Signal<Date>;
+    timezone: Signal<string | undefined>;
+    actions: TimeSlotListServiceActions;
+}
+export declare const TimeSlotListServiceDefinition: string & {
+    __api: TimeSlotListServiceAPI;
+    __config: {};
+    isServiceDefinition?: boolean;
+} & TimeSlotListServiceAPI;

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

@@ -0,0 +1,17 @@
+/**
+ * TimeSlotList Service Definition
+ * Defines interfaces and service contract for time slot management
+ */
+import { defineService } from '@wix/services-definitions';
+// ============================================================================
+// Enums
+// ============================================================================
+export var ViewMode;
+(function (ViewMode) {
+    ViewMode["CLASSIC"] = "classic";
+    ViewMode["AGENDA"] = "agenda";
+})(ViewMode || (ViewMode = {}));
+// ============================================================================
+// Service Definition
+// ============================================================================
+export const TimeSlotListServiceDefinition = defineService('time-slot-list');