@wix/headless-bookings 1.0.4 → 1.0.6

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

@@ -29,16 +29,18 @@ function createMockSignalsService() {
     };
 }
 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: vitest_1.vi.fn(),
             setItem: vitest_1.vi.fn(),
@@ -53,6 +55,7 @@ function createMockBookingService(config = {}) {
             setTimezone: vitest_1.vi.fn(),
             setFormSubmission: vitest_1.vi.fn(),
             clearFormSubmission: vitest_1.vi.fn(),
+            setSelectedPaymentOption: vitest_1.vi.fn(),
             clearAll: vitest_1.vi.fn(),
             book: vitest_1.vi.fn(),
         },

package/cjs/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/cjs/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/cjs/dist/api/create-bulk-booking/index.js

@@ -0,0 +1,54 @@
+"use strict";
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bulkCreateBooking = bulkCreateBooking;
+const auto_sdk_bookings_bookings_1 = require("@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);
+ * ```
+ */
+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 (0, auto_sdk_bookings_bookings_1.bulkCreateBooking)(enriched, {
+        returnFullEntity: true,
+    });
+}

package/cjs/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/cjs/dist/api/create-multi-service-booking/index.js

@@ -0,0 +1,47 @@
+"use strict";
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createMultiServiceBooking = createMultiServiceBooking;
+const auto_sdk_bookings_bookings_1 = require("@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);
+ * ```
+ */
+function createMultiServiceBooking(bookings, options) {
+    return (0, auto_sdk_bookings_bookings_1.createMultiServiceBooking)(bookings, {
+        participantNotification: options?.participantNotification,
+        sendSmsReminder: options?.sendSmsReminder,
+        returnFullEntity: true,
+    });
+}

package/cjs/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/cjs/dist/api/index.js

@@ -5,8 +5,22 @@
  *
  * @module API
  */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.queryCategories = exports.getLocationById = exports.queryLocations = exports.placeOrder = exports.calculateCart = exports.ChannelType = exports.createCart = exports.createBooking = exports.fetchAvailability = exports.SYNTHETIC_CUSTOMER_ID = exports.SYNTHETIC_CUSTOM_ID = exports.convertPlatformFilterToApiFilter = exports.queryServices = exports.getServiceBySlug = exports.getServiceById = void 0;
+exports.queryCategories = exports.getLocationById = exports.queryLocations = exports.placeOrder = exports.calculateCart = exports.ChannelType = exports.createCart = exports.createMultiServiceBooking = exports.bulkCreateBooking = exports.createBooking = exports.fetchAvailability = exports.SYNTHETIC_CUSTOMER_ID = exports.SYNTHETIC_CUSTOM_ID = exports.convertPlatformFilterToApiFilter = exports.queryServices = exports.getServiceBySlug = exports.getServiceById = void 0;
 var index_js_1 = require("./query-services/index.js");
 Object.defineProperty(exports, "getServiceById", { enumerable: true, get: function () { return index_js_1.getServiceById; } });
 Object.defineProperty(exports, "getServiceBySlug", { enumerable: true, get: function () { return index_js_1.getServiceBySlug; } });
@@ -16,17 +30,22 @@ Object.defineProperty(exports, "SYNTHETIC_CUSTOM_ID", { enumerable: true, get: f
 Object.defineProperty(exports, "SYNTHETIC_CUSTOMER_ID", { enumerable: true, get: function () { return index_js_1.SYNTHETIC_CUSTOMER_ID; } });
 var index_js_2 = require("./fetch-availability/index.js");
 Object.defineProperty(exports, "fetchAvailability", { enumerable: true, get: function () { return index_js_2.fetchAvailability; } });
+__exportStar(require("@wix/auto_sdk_bookings_bookings"), exports);
 var index_js_3 = require("./create-booking/index.js");
 Object.defineProperty(exports, "createBooking", { enumerable: true, get: function () { return index_js_3.createBooking; } });
-var index_js_4 = require("./create-cart/index.js");
-Object.defineProperty(exports, "createCart", { enumerable: true, get: function () { return index_js_4.createCart; } });
-Object.defineProperty(exports, "ChannelType", { enumerable: true, get: function () { return index_js_4.ChannelType; } });
-var index_js_5 = require("./calculate-cart/index.js");
-Object.defineProperty(exports, "calculateCart", { enumerable: true, get: function () { return index_js_5.calculateCart; } });
-var index_js_6 = require("./place-order/index.js");
-Object.defineProperty(exports, "placeOrder", { enumerable: true, get: function () { return index_js_6.placeOrder; } });
-var index_js_7 = require("./query-locations/index.js");
-Object.defineProperty(exports, "queryLocations", { enumerable: true, get: function () { return index_js_7.queryLocations; } });
-Object.defineProperty(exports, "getLocationById", { enumerable: true, get: function () { return index_js_7.getLocationById; } });
-var index_js_8 = require("./query-categories/index.js");
-Object.defineProperty(exports, "queryCategories", { enumerable: true, get: function () { return index_js_8.queryCategories; } });
+var index_js_4 = require("./create-bulk-booking/index.js");
+Object.defineProperty(exports, "bulkCreateBooking", { enumerable: true, get: function () { return index_js_4.bulkCreateBooking; } });
+var index_js_5 = require("./create-multi-service-booking/index.js");
+Object.defineProperty(exports, "createMultiServiceBooking", { enumerable: true, get: function () { return index_js_5.createMultiServiceBooking; } });
+var index_js_6 = require("./create-cart/index.js");
+Object.defineProperty(exports, "createCart", { enumerable: true, get: function () { return index_js_6.createCart; } });
+Object.defineProperty(exports, "ChannelType", { enumerable: true, get: function () { return index_js_6.ChannelType; } });
+var index_js_7 = require("./calculate-cart/index.js");
+Object.defineProperty(exports, "calculateCart", { enumerable: true, get: function () { return index_js_7.calculateCart; } });
+var index_js_8 = require("./place-order/index.js");
+Object.defineProperty(exports, "placeOrder", { enumerable: true, get: function () { return index_js_8.placeOrder; } });
+var index_js_9 = require("./query-locations/index.js");
+Object.defineProperty(exports, "queryLocations", { enumerable: true, get: function () { return index_js_9.queryLocations; } });
+Object.defineProperty(exports, "getLocationById", { enumerable: true, get: function () { return index_js_9.getLocationById; } });
+var index_js_10 = require("./query-categories/index.js");
+Object.defineProperty(exports, "queryCategories", { enumerable: true, get: function () { return index_js_10.queryCategories; } });

package/cjs/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/cjs/dist/react/core/booking/Booking.js

@@ -117,6 +117,7 @@ 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({
@@ -124,6 +125,7 @@ function Data(props) {
         location,
         timezone,
         formSubmission,
+        selectedPaymentOption,
         actions,
     });
 }

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

@@ -1,14 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.executeBookAction = executeBookAction;
-const index_js_1 = require("../../../api/create-booking/index.js");
-const index_js_2 = require("../../../api/create-cart/index.js");
-const index_js_3 = require("../../../api/calculate-cart/index.js");
-const index_js_4 = require("../../../api/place-order/index.js");
-const buildBookingRequest_js_1 = require("./buildBookingRequest.js");
+const index_js_1 = require("../../../api/create-cart/index.js");
+const index_js_2 = require("../../../api/calculate-cart/index.js");
+const index_js_3 = require("../../../api/place-order/index.js");
 const buildCartRequest_js_1 = require("./buildCartRequest.js");
 const canBook_js_1 = require("./canBook.js");
+const createBookingsForCart_js_1 = require("./createBookingsForCart.js");
 const isCheckoutRequired_js_1 = require("./isCheckoutRequired.js");
+const dayRange_js_1 = require("./dayRange.js");
 const types_js_1 = require("./types.js");
 async function executeBookAction(params) {
     if (!(0, canBook_js_1.canBook)({
@@ -17,46 +17,58 @@ async function executeBookAction(params) {
     })) {
         throw new Error('Cannot book: missing required data');
     }
-    // Step 1: Create booking
-    const createBookingRequest = (0, buildBookingRequest_js_1.buildBookingRequest)(params);
-    const bookingResponse = await (0, index_js_1.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 (0, createBookingsForCart_js_1.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 = (0, buildCartRequest_js_1.buildCartRequest)({
-        bookingId,
-        contactDetails,
-        businessLocationId,
-        appId: params.appId,
-    });
-    const cart = await (0, index_js_2.createCart)(cartRequest);
+    const isDayRange = (0, dayRange_js_1.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
+        ? (0, buildCartRequest_js_1.buildDayRangeCartRequest)({
+            bookingIds,
+            contactDetails,
+            businessLocationId,
+            appId: params.appId,
+        })
+        : (0, buildCartRequest_js_1.buildCartRequest)({
+            bookingId: bookingIds[0],
+            contactDetails,
+            businessLocationId,
+            appId: params.appId,
+        });
+    const cart = await (0, index_js_1.createCart)(cartRequest);
     if (!cart._id) {
         throw new Error('Failed to create cart');
     }
     // Step 3: Calculate cart to get totals (not stored on Cart V2 entity)
-    const { cart: calculatedCart, summary } = await (0, index_js_3.calculateCart)(cart._id);
+    const { cart: calculatedCart, summary } = await (0, index_js_2.calculateCart)(cart._id);
     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 ((0, isCheckoutRequired_js_1.isCheckoutRequired)(calculatedCart, summary, service)) {
         return { type: types_js_1.BookResultType.CheckoutRequired, cartId: cart._id };
     }
     // Step 5: Skip checkout — place order directly
-    const orderResponse = await (0, index_js_4.placeOrder)(cart._id);
+    const orderResponse = await (0, index_js_3.placeOrder)(cart._id);
     const orderId = orderResponse.orderId;
     if (!orderId) {
         throw new Error('Failed to place order');

package/cjs/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/cjs/dist/services/booking/book-action/buildBookingRequest.js

@@ -58,8 +58,10 @@ 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/cjs/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;

package/cjs/dist/services/booking/book-action/buildCartRequest.js

@@ -1,10 +1,32 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.buildCartRequest = buildCartRequest;
+exports.buildDayRangeCartRequest = buildDayRangeCartRequest;
 const index_js_1 = require("../../../api/create-cart/index.js");
 const constants_js_1 = require("../../constants.js");
 function buildCartRequest(params) {
-    const { bookingId, contactDetails, businessLocationId, appId } = params;
+    return {
+        catalogItems: [buildCatalogItem(params.bookingId, params.appId)],
+        cart: buildCartShape(params),
+    };
+}
+function buildDayRangeCartRequest(params) {
+    return {
+        catalogItems: params.bookingIds.map((id) => buildCatalogItem(id, params.appId)),
+        cart: buildCartShape(params),
+    };
+}
+function buildCatalogItem(bookingId, appId) {
+    return {
+        quantity: 1,
+        catalogReference: {
+            catalogItemId: bookingId,
+            appId: appId ?? constants_js_1.BOOKING_APP_ID,
+        },
+    };
+}
+function buildCartShape(params) {
+    const { contactDetails, businessLocationId } = params;
     const cart = {
         source: { channelType: index_js_1.ChannelType.WEB },
     };
@@ -22,16 +44,5 @@ function buildCartRequest(params) {
             };
         }
     }
-    return {
-        catalogItems: [
-            {
-                quantity: 1,
-                catalogReference: {
-                    catalogItemId: bookingId,
-                    appId: appId ?? constants_js_1.BOOKING_APP_ID,
-                },
-            },
-        ],
-        cart,
-    };
+    return cart;
 }

package/cjs/dist/services/booking/book-action/buildDayRangeBookingRequest.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Builds the request payload(s) for a single APPOINTMENT service whose
+ * duration is configured as a DAY range.
+ *
+ * The slot list comes from availability — the user picks a start + end date
+ * and the picker emits one slot per day in `rangeTimeSlots`. The client just
+ * packages them as one Booking each. Routing is decided by `bookings.length`
+ * in `createBookingsForCart`:
+ *   - length 1   -> `bulkCreateBooking`
+ *   - length 2-8 -> `createMultiServiceBooking`
+ *
+ * The 8-day cap is enforced server-side; the builder does not gate on it.
+ */
+import type { Booking, ParticipantNotification } from '@wix/auto_sdk_bookings_bookings';
+import type { BookActionParams } from './types.js';
+export interface BuildDayRangeBookingRequest {
+    /**
+     * One Booking per picked per-day slot. Length 1 routes to bulkCreateBooking,
+     * length >=2 routes to createMultiServiceBooking.
+     */
+    bookings: Booking[];
+    /** Notification settings forwarded to the server. */
+    participantNotification?: ParticipantNotification;
+    /** Whether to send SMS reminder. */
+    sendSmsReminder: boolean;
+}
+/**
+ * Builds N Bookings from a DAY-range selection.
+ *
+ * The base Booking (service, resource, location, payment, participants) is
+ * produced by `buildBookingRequest` from the singular `timeSlot`; per-slot
+ * cloning then overrides only `bookedEntity.slot.startDate` / `endDate` from
+ * the multi-slot input.
+ *
+ * @throws if no service selection or no slots are available.
+ */
+export declare function buildDayRangeBookingRequest(params: BookActionParams): BuildDayRangeBookingRequest;