@wix/headless-bookings 1.0.4 → 1.0.6

package/cjs/dist/services/payment/payment.js

@@ -57,7 +57,21 @@ function getAdditionalInfo(service, lineItemId) {
         : undefined;
     return { lineItemId, customPrice };
 }
-function getPaymentOption(service, hasDeposit) {
+/**
+ * Resolves the line item's `paymentOption`.
+ *
+ * Precedence: explicit consumer choice (`selectedPaymentOption`) wins over the
+ * service-config heuristic so the preview always agrees with what `book()`
+ * will send. When unset, the existing heuristic is preserved for backward
+ * compat.
+ */
+function getPaymentOption(service, hasDeposit, selectedPaymentOption) {
+    if (selectedPaymentOption === 'OFFLINE') {
+        return 'FULL_PAYMENT_OFFLINE';
+    }
+    if (selectedPaymentOption === 'ONLINE') {
+        return hasDeposit ? 'DEPOSIT_ONLINE' : 'FULL_PAYMENT_ONLINE';
+    }
     const options = service.payment?.options;
     if (options?.inPerson) {
         return 'FULL_PAYMENT_OFFLINE';
@@ -68,7 +82,7 @@ function getPaymentOption(service, hasDeposit) {
     }
     return 'FULL_PAYMENT_ONLINE';
 }
-function buildLineItem(service, totalParticipants, lineItemId) {
+function buildLineItem(service, totalParticipants, lineItemId, selectedPaymentOption) {
     // Get fixed price from service
     const servicePrice = service.payment?.fixed?.price?.value;
     const price = Number(servicePrice || 0) * totalParticipants;
@@ -79,7 +93,7 @@ function buildLineItem(service, totalParticipants, lineItemId) {
         ? Number(depositValue) * totalParticipants
         : undefined;
     // Get payment option from service configuration (pass hasDeposit for correct API behavior)
-    const paymentOption = getPaymentOption(service, hasDeposit);
+    const paymentOption = getPaymentOption(service, hasDeposit, selectedPaymentOption);
     return {
         _id: lineItemId,
         catalogReference: {
@@ -117,7 +131,7 @@ async function getPreviewedPrice(service, localStartDate, localEndDate, timeZone
         deposit: result.priceInfo?.deposit ?? null,
     };
 }
-async function buildLineItemWithPreview(item, totalParticipants) {
+async function buildLineItemWithPreview(item, totalParticipants, selectedPaymentOption) {
     if (item.localStartDate &&
         item.localEndDate &&
         getDurationRange(item.service)) {
@@ -142,18 +156,18 @@ async function buildLineItemWithPreview(item, totalParticipants) {
                 price: String(previewedPrice.price),
                 ...(deposit ? { depositAmount: String(deposit) } : {}),
                 quantity: 1,
-                paymentOption: getPaymentOption(item.service, hasDeposit),
+                paymentOption: getPaymentOption(item.service, hasDeposit, selectedPaymentOption),
             };
         }
     }
-    return buildLineItem(item.service, totalParticipants, item.lineItemId);
+    return buildLineItem(item.service, totalParticipants, item.lineItemId, selectedPaymentOption);
 }
-async function calculatePaymentDetails(pricingServiceSelections, totalParticipants) {
+async function calculatePaymentDetails(pricingServiceSelections, totalParticipants, selectedPaymentOption) {
     const data = pricingServiceSelections.map((selection) => ({
         ...selection,
         lineItemId: selection.lineItemId || (0, guid_js_1.generateLineItemId)(),
     }));
-    const lineItems = await Promise.all(data.map((item) => buildLineItemWithPreview(item, totalParticipants)));
+    const lineItems = await Promise.all(data.map((item) => buildLineItemWithPreview(item, totalParticipants, selectedPaymentOption)));
     const response = await (0, auto_sdk_ecom_totals_calculator_1.calculateTotals)({
         lineItems,
     });
@@ -184,7 +198,7 @@ exports.PaymentService = services_definitions_1.implementService.withConfig()(pa
     const errorSignal = signalsService.signal(null);
     const serviceOptionsSignal = signalsService.signal(config.serviceOptions || DEFAULT_SERVICE_OPTIONS);
     // Internal calculate function
-    const calculate = async (pricingServiceSelections, totalParticipants) => {
+    const calculate = async (pricingServiceSelections, totalParticipants, selectedPaymentOption) => {
         if (!pricingServiceSelections.length) {
             paymentDetailsSignal.set(null);
             return;
@@ -192,7 +206,7 @@ exports.PaymentService = services_definitions_1.implementService.withConfig()(pa
         isLoadingSignal.set(true);
         errorSignal.set(null);
         try {
-            const paymentDetails = await calculatePaymentDetails(pricingServiceSelections, totalParticipants);
+            const paymentDetails = await calculatePaymentDetails(pricingServiceSelections, totalParticipants, selectedPaymentOption);
             paymentDetailsSignal.set(paymentDetails);
         }
         catch (error) {
@@ -220,24 +234,30 @@ exports.PaymentService = services_definitions_1.implementService.withConfig()(pa
     // Mode 2: Lazy loading - pricingServiceSelections provided via internal config
     else if (config.pricingServiceSelections?.length) {
         serviceOptionsSignal.set(deriveServiceOptions(config.pricingServiceSelections));
-        void calculate(config.pricingServiceSelections, config.totalParticipants ?? 1);
+        void calculate(config.pricingServiceSelections, config.totalParticipants ?? 1, config.selectedPaymentOption);
     }
     // Mode 3: Reactive - observe BookingService signals (client-side only)
     else if (typeof window !== 'undefined' && bookingService) {
-        // Computed signal that changes when services or selected time slots change (not participants)
+        // Computed signal that changes when services, selected time slots, or
+        // the consumer-selected payment option change (not participants).
         const servicesKey = signalsService.computed(() => {
             const selections = bookingService?.serviceSelections.get() || [];
             const timezone = bookingService?.timezone.get();
+            const selectedPaymentOption = bookingService?.selectedPaymentOption.get();
             return (selections
                 .map((s) => `${s.service._id}:${s.timeSlot?.startDate ?? ''}:${s.timeSlot?.endDate ?? ''}`)
-                .join(',') + `:${timezone ?? ''}`);
+                .join(',') +
+                `:${timezone ?? ''}` +
+                `:${selectedPaymentOption ?? ''}`);
         });
         signalsService.effect(() => {
-            // Subscribe to servicesKey to trigger effect when service or time slot changes
+            // Subscribe to servicesKey to trigger effect when service, time
+            // slot, or selected payment option changes.
             servicesKey.get();
             // Read current selections without subscribing (peek)
             const selections = bookingService?.serviceSelections.peek() || [];
             const timezone = bookingService?.timezone.peek();
+            const selectedPaymentOption = bookingService?.selectedPaymentOption.peek();
             // For single service mode, take the first selection
             const firstSelection = selections[0];
             const numParticipants = firstSelection?.totalParticipants || 1;
@@ -251,7 +271,7 @@ exports.PaymentService = services_definitions_1.implementService.withConfig()(pa
             if (pricingServiceSelections.length) {
                 serviceOptionsSignal.set(deriveServiceOptions(pricingServiceSelections));
             }
-            void calculate(pricingServiceSelections, numParticipants);
+            void calculate(pricingServiceSelections, numParticipants, selectedPaymentOption);
         });
     }
     return {
@@ -267,10 +287,12 @@ exports.PaymentService = services_definitions_1.implementService.withConfig()(pa
  *
  * @param params.pricingServiceSelections - Pricing service selections for calculation
  * @param params.totalParticipants - Number of participants (default: 1)
+ * @param params.selectedPaymentOption - Optional consumer-selected payment option;
+ *   overrides the service-config heuristic on each line item's `paymentOption`.
  */
 async function loadPaymentConfig(params) {
     try {
-        const { pricingServiceSelections, totalParticipants = 1 } = params;
+        const { pricingServiceSelections, totalParticipants = 1, selectedPaymentOption, } = params;
         if (!pricingServiceSelections.length) {
             return {
                 type: 'success',
@@ -280,7 +302,7 @@ async function loadPaymentConfig(params) {
                 },
             };
         }
-        const paymentDetails = await calculatePaymentDetails(pricingServiceSelections, totalParticipants);
+        const paymentDetails = await calculatePaymentDetails(pricingServiceSelections, totalParticipants, selectedPaymentOption);
         return {
             type: 'success',
             config: {

package/dist/__mocks__/booking/booking-client-service.js

@@ -24,16 +24,18 @@ export function createMockSignalsService() {
     };
 }
 export function createMockBookingService(config = {}) {
-    const { serviceSelections = [], location = null, timezone = 'UTC', formSubmission = null, } = config;
+    const { serviceSelections = [], location = null, timezone = 'UTC', formSubmission = null, selectedPaymentOption, } = config;
     const serviceSelectionsSignal = mockSignal(serviceSelections);
     const locationSignal = mockSignal(location);
     const timezoneSignal = mockSignal(timezone);
     const formSubmissionSignal = mockSignal(formSubmission);
+    const selectedPaymentOptionSignal = mockSignal(selectedPaymentOption);
     return {
         serviceSelections: serviceSelectionsSignal,
         location: locationSignal,
         timezone: timezoneSignal,
         formSubmission: formSubmissionSignal,
+        selectedPaymentOption: selectedPaymentOptionSignal,
         actions: {
             updateItem: vi.fn(),
             setItem: vi.fn(),
@@ -48,6 +50,7 @@ export function createMockBookingService(config = {}) {
             setTimezone: vi.fn(),
             setFormSubmission: vi.fn(),
             clearFormSubmission: vi.fn(),
+            setSelectedPaymentOption: vi.fn(),
             clearAll: vi.fn(),
             book: vi.fn(),
         },

package/dist/api/create-booking/index.d.ts

@@ -5,15 +5,16 @@
 import { type Booking, type CreateBookingResponse, type ParticipantNotification } from '@wix/auto_sdk_bookings_bookings';
 import type { FormValues } from '@wix/forms/components';
 /**
- * Options for creating a booking
+ * Options for creating a booking. `null` is accepted on optional fields so
+ * callers can forward the SDK's `T | null` shape without coercion.
  */
 export interface CreateBookingOptions {
     /** Notification settings for participants */
     participantNotification?: ParticipantNotification;
     /** Whether to send SMS reminder */
-    sendSmsReminder?: boolean;
+    sendSmsReminder?: boolean | null;
     /** Form submission data */
-    formSubmission?: FormValues;
+    formSubmission?: FormValues | null;
 }
 /**
  * Creates a booking with the specified booking data and options
@@ -39,4 +40,3 @@ export interface CreateBookingOptions {
  * ```
  */
 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-bulk-booking/index.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Bulk Create Booking API
+ * Wrapper for the Wix Bookings bulkCreateBooking SDK function.
+ *
+ * Used for the 1-day case of the DAY-range expansion: a single APPOINTMENT
+ * service whose duration is configured as a DAY range, with exactly one
+ * per-day availability slot picked. The 2-8 day case is routed to
+ * createMultiServiceBooking.
+ */
+import { type CreateBookingInfo, type BulkCreateBookingResponse, type ParticipantNotification } from '@wix/auto_sdk_bookings_bookings';
+/**
+ * Options for creating bookings in bulk.
+ *
+ * `formSubmission` is intentionally absent: the SDK's
+ * `BulkCreateBookingOptions` does not accept it. Customer details flow
+ * through the cart layer instead. We always set `returnFullEntity: true` so
+ * the response includes per-booking entities (with `contactDetails`) for
+ * cart wiring.
+ */
+export interface BulkCreateBookingOptions {
+    /** Notification settings for participants. Applied to every entry. */
+    participantNotification?: ParticipantNotification;
+    /** Whether to send SMS reminder. Applied to every entry. */
+    sendSmsReminder?: boolean;
+}
+/**
+ * Creates 1-8 bookings in a single bulk call.
+ *
+ * Per the SDK contract, `createBookingsInfo` accepts 1-8 bookings. When the
+ * DAY-range routing picks exactly one per-day slot, this wrapper is invoked
+ * with a single-element array. Validation of constraints is delegated to the
+ * SDK; this wrapper only forwards the request and pins
+ * `returnFullEntity: true` so the caller can read
+ * `results[].item.contactDetails` for downstream cart construction.
+ *
+ * @param createBookingsInfo - 1-8 single-service booking specifications
+ * @param options - Optional notification / SMS settings (applied to every entry)
+ * @returns Promise resolving to the bulk-create response
+ *
+ * @example
+ * ```typescript
+ * const response = await bulkCreateBooking(
+ *   [{ booking: bookingDay1 }],
+ *   {
+ *     participantNotification: { notifyParticipants: true },
+ *     sendSmsReminder: true,
+ *   }
+ * );
+ * const ids = response.results
+ *   ?.map((r) => r.item?._id)
+ *   .filter(Boolean);
+ * ```
+ */
+export declare function bulkCreateBooking(createBookingsInfo: CreateBookingInfo[], options?: BulkCreateBookingOptions): Promise<BulkCreateBookingResponse>;

package/dist/api/create-bulk-booking/index.js

@@ -0,0 +1,51 @@
+/**
+ * Bulk Create Booking API
+ * Wrapper for the Wix Bookings bulkCreateBooking SDK function.
+ *
+ * Used for the 1-day case of the DAY-range expansion: a single APPOINTMENT
+ * service whose duration is configured as a DAY range, with exactly one
+ * per-day availability slot picked. The 2-8 day case is routed to
+ * createMultiServiceBooking.
+ */
+import { bulkCreateBooking as bulkCreateBookingSdk, } from '@wix/auto_sdk_bookings_bookings';
+/**
+ * Creates 1-8 bookings in a single bulk call.
+ *
+ * Per the SDK contract, `createBookingsInfo` accepts 1-8 bookings. When the
+ * DAY-range routing picks exactly one per-day slot, this wrapper is invoked
+ * with a single-element array. Validation of constraints is delegated to the
+ * SDK; this wrapper only forwards the request and pins
+ * `returnFullEntity: true` so the caller can read
+ * `results[].item.contactDetails` for downstream cart construction.
+ *
+ * @param createBookingsInfo - 1-8 single-service booking specifications
+ * @param options - Optional notification / SMS settings (applied to every entry)
+ * @returns Promise resolving to the bulk-create response
+ *
+ * @example
+ * ```typescript
+ * const response = await bulkCreateBooking(
+ *   [{ booking: bookingDay1 }],
+ *   {
+ *     participantNotification: { notifyParticipants: true },
+ *     sendSmsReminder: true,
+ *   }
+ * );
+ * const ids = response.results
+ *   ?.map((r) => r.item?._id)
+ *   .filter(Boolean);
+ * ```
+ */
+export function bulkCreateBooking(createBookingsInfo, options) {
+    // Apply the shared participantNotification / sendSmsReminder onto each
+    // CreateBookingInfo entry. The SDK's per-call options object only carries
+    // `returnFullEntity`, so notification settings live on each entry.
+    const enriched = createBookingsInfo.map((info) => ({
+        ...info,
+        participantNotification: info.participantNotification ?? options?.participantNotification,
+        sendSmsReminder: info.sendSmsReminder ?? options?.sendSmsReminder,
+    }));
+    return bulkCreateBookingSdk(enriched, {
+        returnFullEntity: true,
+    });
+}

package/dist/api/create-multi-service-booking/index.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Create Multi-Service Booking API
+ * Wrapper for the Wix Bookings createMultiServiceBooking SDK function.
+ *
+ * Used for the 2-8 day case of the DAY-range expansion: a single
+ * APPOINTMENT service whose duration is configured as a DAY range, with
+ * 2-8 per-day availability slots picked. One Booking entry is sent per
+ * picked slot.
+ */
+import { type Booking, type CreateMultiServiceBookingResponse, type ParticipantNotification } from '@wix/auto_sdk_bookings_bookings';
+/**
+ * Options for creating a multi-service booking.
+ *
+ * `formSubmission` is intentionally absent: the SDK's
+ * `CreateMultiServiceBookingOptions` does not accept it. Customer details
+ * flow through the cart layer instead. We always set `returnFullEntity: true`
+ * so the response includes per-booking entities (with `contactDetails`) for
+ * cart wiring.
+ */
+export interface CreateMultiServiceBookingOptions {
+    /** Notification settings for participants */
+    participantNotification?: ParticipantNotification;
+    /** Whether to send SMS reminder */
+    sendSmsReminder?: boolean;
+}
+/**
+ * Creates a multi-service booking from 2-8 single-service booking specs.
+ *
+ * Per the SDK contract, the bookings array must contain 2-8 APPOINTMENT
+ * bookings at the same location with sequential, gapless scheduling.
+ * Validation of those constraints is delegated to the SDK; this wrapper only
+ * forwards the request and pins `returnFullEntity: true` so the caller can
+ * read `bookings[].booking.contactDetails` for downstream cart construction.
+ *
+ * @param bookings - 2 to 8 single-service booking specifications
+ * @param options - Optional notification / SMS settings
+ * @returns Promise resolving to the created multi-service booking response
+ *
+ * @example
+ * ```typescript
+ * const response = await createMultiServiceBooking(
+ *   [bookingDay1, bookingDay2, bookingDay3],
+ *   {
+ *     participantNotification: { notifyParticipants: true },
+ *     sendSmsReminder: true,
+ *   }
+ * );
+ * const ids = response.multiServiceBooking?.bookings
+ *   ?.map((b) => b.bookingId)
+ *   .filter(Boolean);
+ * ```
+ */
+export declare function createMultiServiceBooking(bookings: Booking[], options?: CreateMultiServiceBookingOptions): Promise<CreateMultiServiceBookingResponse>;

package/dist/api/create-multi-service-booking/index.js

@@ -0,0 +1,44 @@
+/**
+ * Create Multi-Service Booking API
+ * Wrapper for the Wix Bookings createMultiServiceBooking SDK function.
+ *
+ * Used for the 2-8 day case of the DAY-range expansion: a single
+ * APPOINTMENT service whose duration is configured as a DAY range, with
+ * 2-8 per-day availability slots picked. One Booking entry is sent per
+ * picked slot.
+ */
+import { createMultiServiceBooking as createMultiServiceBookingSdk, } from '@wix/auto_sdk_bookings_bookings';
+/**
+ * Creates a multi-service booking from 2-8 single-service booking specs.
+ *
+ * Per the SDK contract, the bookings array must contain 2-8 APPOINTMENT
+ * bookings at the same location with sequential, gapless scheduling.
+ * Validation of those constraints is delegated to the SDK; this wrapper only
+ * forwards the request and pins `returnFullEntity: true` so the caller can
+ * read `bookings[].booking.contactDetails` for downstream cart construction.
+ *
+ * @param bookings - 2 to 8 single-service booking specifications
+ * @param options - Optional notification / SMS settings
+ * @returns Promise resolving to the created multi-service booking response
+ *
+ * @example
+ * ```typescript
+ * const response = await createMultiServiceBooking(
+ *   [bookingDay1, bookingDay2, bookingDay3],
+ *   {
+ *     participantNotification: { notifyParticipants: true },
+ *     sendSmsReminder: true,
+ *   }
+ * );
+ * const ids = response.multiServiceBooking?.bookings
+ *   ?.map((b) => b.bookingId)
+ *   .filter(Boolean);
+ * ```
+ */
+export function createMultiServiceBooking(bookings, options) {
+    return createMultiServiceBookingSdk(bookings, {
+        participantNotification: options?.participantNotification,
+        sendSmsReminder: options?.sendSmsReminder,
+        returnFullEntity: true,
+    });
+}

package/dist/api/index.d.ts

@@ -6,7 +6,10 @@
  */
 export { getServiceById, getServiceBySlug, queryServices, convertPlatformFilterToApiFilter, type PagingMetadata, type QueryServicesRequest, SYNTHETIC_CUSTOM_ID, SYNTHETIC_CUSTOMER_ID, } 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 * from '@wix/auto_sdk_bookings_bookings';
+export { createBooking, type CreateBookingOptions, } from './create-booking/index.js';
+export { bulkCreateBooking, type BulkCreateBookingOptions, } from './create-bulk-booking/index.js';
+export { createMultiServiceBooking, type CreateMultiServiceBookingOptions, } from './create-multi-service-booking/index.js';
 export { createCart, ChannelType, type CreateCartOptions, type Cart, } from './create-cart/index.js';
 export { calculateCart, type CalculateCartResponse, type CartSummary, } from './calculate-cart/index.js';
 export { placeOrder, type PlaceOrderOptions, type PlaceOrderResponse, } from './place-order/index.js';

package/dist/api/index.js

@@ -6,7 +6,10 @@
  */
 export { getServiceById, getServiceBySlug, queryServices, convertPlatformFilterToApiFilter, SYNTHETIC_CUSTOM_ID, SYNTHETIC_CUSTOMER_ID, } from './query-services/index.js';
 export { fetchAvailability } from './fetch-availability/index.js';
+export * from '@wix/auto_sdk_bookings_bookings';
 export { createBooking, } from './create-booking/index.js';
+export { bulkCreateBooking, } from './create-bulk-booking/index.js';
+export { createMultiServiceBooking, } from './create-multi-service-booking/index.js';
 export { createCart, ChannelType, } from './create-cart/index.js';
 export { calculateCart, } from './calculate-cart/index.js';
 export { placeOrder, } from './place-order/index.js';

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

@@ -3,7 +3,7 @@
  * Provides low-level access to BookingService via render props and service setup
  */
 import React from 'react';
-import { type BookingServiceConfig, type ServiceSelection, type BookingServiceActions } from '../../../services/booking/booking.js';
+import { type BookingServiceConfig, type ServiceSelection, type BookingServiceActions, type SelectedPaymentOption } from '../../../services/booking/booking.js';
 import type { FormValues } from '@wix/forms/components';
 import type { TimeSlot, Resource } from '@wix/auto_sdk_bookings_availability-time-slots';
 import { type Service, type V2Location as ServiceLocationType } from '@wix/auto_sdk_bookings_services';
@@ -40,6 +40,11 @@ export interface BookingData {
     location: ServiceLocationType | null;
     timezone: string | undefined;
     formSubmission: FormValues | null;
+    /**
+     * Consumer-selected payment option. `undefined` means the service-config
+     * heuristic applies. Set via `actions.setSelectedPaymentOption`.
+     */
+    selectedPaymentOption: SelectedPaymentOption | undefined;
     actions: BookingServiceActions;
 }
 /**

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

@@ -105,6 +105,7 @@ export function Data(props) {
     const bookingLocation = bookingService.location.get();
     const timezone = bookingService.timezone.get();
     const formSubmission = bookingService.formSubmission.get();
+    const selectedPaymentOption = bookingService.selectedPaymentOption.get();
     const { actions } = bookingService;
     const location = resolveLocation(bookingLocation, serviceSelections);
     return children({
@@ -112,6 +113,7 @@ export function Data(props) {
         location,
         timezone,
         formSubmission,
+        selectedPaymentOption,
         actions,
     });
 }

package/dist/services/booking/book-action/bookAction.js

@@ -1,11 +1,11 @@
-import { createBooking } from '../../../api/create-booking/index.js';
 import { createCart } from '../../../api/create-cart/index.js';
 import { calculateCart } from '../../../api/calculate-cart/index.js';
 import { placeOrder } from '../../../api/place-order/index.js';
-import { buildBookingRequest } from './buildBookingRequest.js';
-import { buildCartRequest } from './buildCartRequest.js';
+import { buildCartRequest, buildDayRangeCartRequest, } from './buildCartRequest.js';
 import { canBook } from './canBook.js';
+import { createBookingsForCart } from './createBookingsForCart.js';
 import { isCheckoutRequired } from './isCheckoutRequired.js';
+import { isDayRangeService } from './dayRange.js';
 import { BookResultType, } from './types.js';
 export async function executeBookAction(params) {
     if (!canBook({
@@ -14,30 +14,40 @@ export async function executeBookAction(params) {
     })) {
         throw new Error('Cannot book: missing required data');
     }
-    // Step 1: Create booking
-    const createBookingRequest = buildBookingRequest(params);
-    const bookingResponse = await createBooking(createBookingRequest.booking, {
-        participantNotification: createBookingRequest.participantNotification,
-        sendSmsReminder: createBookingRequest.sendSmsReminder ?? undefined,
-        formSubmission: createBookingRequest.formSubmission ?? undefined,
-    });
-    const bookingId = bookingResponse.booking?._id;
-    const contactDetails = bookingResponse.booking?.contactDetails;
-    if (!bookingId) {
+    // Step 1: Create booking(s). The helper picks single vs bulk vs
+    // multi-service (DAY-range routing) and returns a uniform
+    // { bookingIds, contactDetails } shape.
+    const { bookingIds, contactDetails } = await createBookingsForCart(params);
+    if (bookingIds.length === 0) {
         throw new Error('Failed to create booking');
     }
-    // Step 2: Create cart
+    // Step 2: Create cart. `firstSelection` is guaranteed non-empty because
+    // `canBook` already enforced `serviceSelections.length > 0` above.
     const firstSelection = params.serviceSelections[0];
     if (!firstSelection) {
         throw new Error('No service selection found');
     }
-    const businessLocationId = firstSelection.timeSlot?.location?._id ?? undefined;
-    const cartRequest = buildCartRequest({
-        bookingId,
-        contactDetails,
-        businessLocationId,
-        appId: params.appId,
-    });
+    const isDayRange = isDayRangeService(firstSelection.service);
+    const businessLocationId = isDayRange
+        ? // TODO: derive from the selected resource (staff member)'s location
+            // once the resource-location work lands. Until then, the DAY-range
+            // slot list doesn't reliably carry per-slot location, so we read
+            // it from the service's first configured location.
+            firstSelection.service.locations?.[0]?._id
+        : firstSelection.timeSlot?.location?._id;
+    const cartRequest = isDayRange
+        ? buildDayRangeCartRequest({
+            bookingIds,
+            contactDetails,
+            businessLocationId,
+            appId: params.appId,
+        })
+        : buildCartRequest({
+            bookingId: bookingIds[0],
+            contactDetails,
+            businessLocationId,
+            appId: params.appId,
+        });
     const cart = await createCart(cartRequest);
     if (!cart._id) {
         throw new Error('Failed to create cart');
@@ -47,7 +57,9 @@ export async function executeBookAction(params) {
     if (!calculatedCart || !summary) {
         throw new Error('Failed to calculate cart');
     }
-    // Step 4: Determine if checkout is required or can be skipped
+    // Step 4: Determine if checkout is required or can be skipped. For
+    // DAY-range expansion all N bookings are the same service, so reading the
+    // first selection's service is still correct.
     const service = firstSelection.service;
     if (isCheckoutRequired(calculatedCart, summary, service)) {
         return { type: BookResultType.CheckoutRequired, cartId: cart._id };

package/dist/services/booking/book-action/buildBookingRequest.d.ts

@@ -1,7 +1,7 @@
 /**
  * Builds the createBooking request from BookActionParams
  */
-import type { CreateBookingRequest } from '../../../api/create-booking/index.js';
+import { type CreateBookingRequest } from '@wix/auto_sdk_bookings_bookings';
 import type { BookActionParams } from './types.js';
 /**
  * Builds a CreateBookingRequest from the booking action parameters

package/dist/services/booking/book-action/buildBookingRequest.js

@@ -55,8 +55,10 @@ export function buildBookingRequest(params) {
     const slotLocation = item.timeSlot.location ?? location;
     return {
         booking: {
-            // Payment option derived from service payment settings
-            selectedPaymentOption: deriveSelectedPaymentOption(item.service),
+            // Payment option: consumer override (if set) wins over the
+            // service-config heuristic.
+            selectedPaymentOption: params.selectedPaymentOption ??
+                deriveSelectedPaymentOption(item.service),
             // Participants
             totalParticipants: item.totalParticipants || 1,
             // Booked entity slot

package/dist/services/booking/book-action/buildCartRequest.d.ts

@@ -1,10 +1,28 @@
 import { type CreateCartOptions } from '../../../api/create-cart/index.js';
-import type { ContactDetails } from '../../../api/create-booking/index.js';
+import type { ContactDetails } from '@wix/auto_sdk_bookings_bookings';
 export interface BuildCartParams {
     bookingId: string;
     contactDetails?: ContactDetails;
-    businessLocationId?: string;
+    /** `null` accepted so callers can forward SDK fields typed `string | null`. */
+    businessLocationId?: string | null;
     /** Optional app ID override for the catalog reference. Defaults to BOOKING_APP_ID. */
     appId?: string;
 }
 export declare function buildCartRequest(params: BuildCartParams): CreateCartOptions;
+/**
+ * DAY-range variant of `buildCartRequest`. Takes the N booking IDs returned
+ * by `bulkCreateBooking` (1 slot) or `createMultiServiceBooking` (2-8 slots)
+ * and emits one catalog item per ID. Per SDK guidance, never use
+ * `multiServiceBooking._id` here; always feed the per-day single-service
+ * booking IDs into the cart.
+ */
+export interface BuildDayRangeCartParams {
+    /** One catalog item per booking id. Bulk / multi-service responses produce N>=1 ids. */
+    bookingIds: string[];
+    contactDetails?: ContactDetails;
+    /** `null` accepted so callers can forward SDK fields typed `string | null`. */
+    businessLocationId?: string | null;
+    /** Optional app ID override for the catalog reference. Defaults to BOOKING_APP_ID. */
+    appId?: string;
+}
+export declare function buildDayRangeCartRequest(params: BuildDayRangeCartParams): CreateCartOptions;