@wix/headless-bookings 0.0.26 → 0.0.28

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

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>
  *   )}