@wix/headless-bookings 1.0.4 → 1.0.5

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

@@ -0,0 +1,22 @@
+/**
+ * Creates the booking(s) needed for cart construction.
+ *
+ * Branches on the service selection:
+ * - DAY-range path with 1 picked slot   -> `bulkCreateBooking`
+ * - DAY-range path with 2..8 picked slots -> `createMultiServiceBooking`
+ * - default path                        -> `createBooking`
+ *
+ * All branches return the same shape so `executeBookAction` can stay
+ * branchless from cart-creation onwards. Cart construction reads each
+ * single-service booking ID — per SDK guidance, never the
+ * `multiServiceBooking._id`.
+ */
+import type { ContactDetails } from '@wix/auto_sdk_bookings_bookings';
+import type { BookActionParams } from './types.js';
+export interface CreatedBookings {
+    /** One ID per single-service booking. >=1 on success. */
+    bookingIds: string[];
+    /** Canonical contact details echoed by the server (read from the first booking). */
+    contactDetails?: ContactDetails;
+}
+export declare function createBookingsForCart(params: BookActionParams): Promise<CreatedBookings>;

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

@@ -0,0 +1,69 @@
+"use strict";
+/**
+ * Creates the booking(s) needed for cart construction.
+ *
+ * Branches on the service selection:
+ * - DAY-range path with 1 picked slot   -> `bulkCreateBooking`
+ * - DAY-range path with 2..8 picked slots -> `createMultiServiceBooking`
+ * - default path                        -> `createBooking`
+ *
+ * All branches return the same shape so `executeBookAction` can stay
+ * branchless from cart-creation onwards. Cart construction reads each
+ * single-service booking ID — per SDK guidance, never the
+ * `multiServiceBooking._id`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createBookingsForCart = createBookingsForCart;
+const index_js_1 = require("../../../api/create-booking/index.js");
+const index_js_2 = require("../../../api/create-bulk-booking/index.js");
+const index_js_3 = require("../../../api/create-multi-service-booking/index.js");
+const buildBookingRequest_js_1 = require("./buildBookingRequest.js");
+const buildDayRangeBookingRequest_js_1 = require("./buildDayRangeBookingRequest.js");
+const dayRange_js_1 = require("./dayRange.js");
+async function createBookingsForCart(params) {
+    const firstSelection = params.serviceSelections[0];
+    if (!firstSelection) {
+        throw new Error('No service selection provided');
+    }
+    if ((0, dayRange_js_1.isDayRangeService)(firstSelection.service)) {
+        const req = (0, buildDayRangeBookingRequest_js_1.buildDayRangeBookingRequest)(params);
+        // TODO(createAsOneBooking): when the server flag lands, branch here:
+        //   if (createAsOneBooking) -> createBooking({ ...wideRange, fullDay: true })
+        // collapsing all slots into one combined Booking. Until then, we always
+        // use one Booking per picked slot.
+        if (req.bookings.length === 1) {
+            const response = await (0, index_js_2.bulkCreateBooking)([{ booking: req.bookings[0] }], {
+                participantNotification: req.participantNotification,
+                sendSmsReminder: req.sendSmsReminder,
+            });
+            const results = response.results ?? [];
+            return {
+                bookingIds: results.map((r) => r.item?._id).filter(Boolean),
+                // All N daily bookings share the same customer; read from the first.
+                contactDetails: results[0]?.item?.contactDetails,
+            };
+        }
+        const response = await (0, index_js_3.createMultiServiceBooking)(req.bookings, {
+            participantNotification: req.participantNotification,
+            sendSmsReminder: req.sendSmsReminder,
+        });
+        const bookings = response.multiServiceBooking?.bookings ?? [];
+        return {
+            bookingIds: bookings
+                .map((b) => b.booking?._id)
+                .filter(Boolean),
+            contactDetails: bookings[0]?.booking?.contactDetails,
+        };
+    }
+    const createBookingRequest = (0, buildBookingRequest_js_1.buildBookingRequest)(params);
+    const bookingResponse = await (0, index_js_1.createBooking)(createBookingRequest.booking, {
+        participantNotification: createBookingRequest.participantNotification,
+        sendSmsReminder: createBookingRequest.sendSmsReminder,
+        formSubmission: createBookingRequest.formSubmission,
+    });
+    const bookingId = bookingResponse.booking?._id;
+    return {
+        bookingIds: bookingId ? [bookingId] : [],
+        contactDetails: bookingResponse.booking?.contactDetails,
+    };
+}

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

@@ -0,0 +1,34 @@
+/**
+ * DAY-range service helpers.
+ *
+ * APPOINTMENT services whose schedule has a `durationRange` with
+ * `unitType === DAY` route through the per-day slot path:
+ *   - 1 picked slot  -> `bulkCreateBooking`
+ *   - 2..8 picked slots -> `createMultiServiceBooking`
+ *
+ * CLASS/COURSE selections and HOUR-range / fixed-duration APPOINTMENT
+ * selections keep using the existing `createBooking` path.
+ */
+import { type Service } from '@wix/auto_sdk_bookings_services';
+/**
+ * Returns true when the given service is an APPOINTMENT whose duration is
+ * configured as a DAY range. Useful at the UI layer (e.g. routing) to know
+ * before a slot has been picked whether the selection will go through the
+ * DAY-range create path.
+ */
+export declare function isDayRangeService(service: Service): boolean;
+/**
+ * Bounds (in days) that a customer may pick for a DAY-range service.
+ * Both bounds are inclusive. The server enforces 1..8 per `DailyConfig` (SDK);
+ * this helper just exposes whatever the configured values are.
+ */
+export type DayRangeBounds = {
+    min: number;
+    max: number;
+};
+/**
+ * Returns the configured min/max day bounds for a DAY-range service, or
+ * `null` if the service is not DAY-range. Falls back to `min = 1` / `max = min`
+ * when the service is missing `dayOptions` configuration values.
+ */
+export declare function getDayRangeBounds(service: Service): DayRangeBounds | null;

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

@@ -0,0 +1,43 @@
+"use strict";
+/**
+ * DAY-range service helpers.
+ *
+ * APPOINTMENT services whose schedule has a `durationRange` with
+ * `unitType === DAY` route through the per-day slot path:
+ *   - 1 picked slot  -> `bulkCreateBooking`
+ *   - 2..8 picked slots -> `createMultiServiceBooking`
+ *
+ * CLASS/COURSE selections and HOUR-range / fixed-duration APPOINTMENT
+ * selections keep using the existing `createBooking` path.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isDayRangeService = isDayRangeService;
+exports.getDayRangeBounds = getDayRangeBounds;
+const auto_sdk_bookings_services_1 = require("@wix/auto_sdk_bookings_services");
+/**
+ * Returns true when the given service is an APPOINTMENT whose duration is
+ * configured as a DAY range. Useful at the UI layer (e.g. routing) to know
+ * before a slot has been picked whether the selection will go through the
+ * DAY-range create path.
+ */
+function isDayRangeService(service) {
+    const isAppointment = service.type === auto_sdk_bookings_services_1.ServiceType.APPOINTMENT;
+    const isDayRange = service.schedule?.availabilityConstraints?.durationRange?.unitType ===
+        auto_sdk_bookings_services_1.UnitType.DAY;
+    return isAppointment && isDayRange;
+}
+/**
+ * Returns the configured min/max day bounds for a DAY-range service, or
+ * `null` if the service is not DAY-range. Falls back to `min = 1` / `max = min`
+ * when the service is missing `dayOptions` configuration values.
+ */
+function getDayRangeBounds(service) {
+    if (!isDayRangeService(service))
+        return null;
+    const dayOptions = service.schedule?.availabilityConstraints?.durationRange?.dayOptions;
+    const min = dayOptions?.minDurationInDays ?? 1;
+    const max = dayOptions?.maxDurationInDays ?? min;
+    if (max < min)
+        return null;
+    return { min, max };
+}

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

@@ -1,9 +1,12 @@
 /**
  * Book Action - Exports
  */
-export { executeBookAction } from './bookAction.js';
-export { canBook, type CanBookParams } from './canBook.js';
-export { buildBookingRequest } from './buildBookingRequest.js';
-export { buildCartRequest, type BuildCartParams } from './buildCartRequest.js';
-export { isCheckoutRequired } from './isCheckoutRequired.js';
-export { BookResultType, type BookProps, type BookResult, type BookingError, type BookActionParams, type BookChildProps, } from './types.js';
+export * from './bookAction.js';
+export * from './canBook.js';
+export * from './buildBookingRequest.js';
+export * from './buildDayRangeBookingRequest.js';
+export * from './buildCartRequest.js';
+export * from './createBookingsForCart.js';
+export * from './dayRange.js';
+export * from './isCheckoutRequired.js';
+export * from './types.js';

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

@@ -2,17 +2,27 @@
 /**
  * Book Action - Exports
  */
+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.BookResultType = exports.isCheckoutRequired = exports.buildCartRequest = exports.buildBookingRequest = exports.canBook = exports.executeBookAction = void 0;
-var bookAction_js_1 = require("./bookAction.js");
-Object.defineProperty(exports, "executeBookAction", { enumerable: true, get: function () { return bookAction_js_1.executeBookAction; } });
-var canBook_js_1 = require("./canBook.js");
-Object.defineProperty(exports, "canBook", { enumerable: true, get: function () { return canBook_js_1.canBook; } });
-var buildBookingRequest_js_1 = require("./buildBookingRequest.js");
-Object.defineProperty(exports, "buildBookingRequest", { enumerable: true, get: function () { return buildBookingRequest_js_1.buildBookingRequest; } });
-var buildCartRequest_js_1 = require("./buildCartRequest.js");
-Object.defineProperty(exports, "buildCartRequest", { enumerable: true, get: function () { return buildCartRequest_js_1.buildCartRequest; } });
-var isCheckoutRequired_js_1 = require("./isCheckoutRequired.js");
-Object.defineProperty(exports, "isCheckoutRequired", { enumerable: true, get: function () { return isCheckoutRequired_js_1.isCheckoutRequired; } });
-var types_js_1 = require("./types.js");
-Object.defineProperty(exports, "BookResultType", { enumerable: true, get: function () { return types_js_1.BookResultType; } });
+__exportStar(require("./bookAction.js"), exports);
+__exportStar(require("./canBook.js"), exports);
+__exportStar(require("./buildBookingRequest.js"), exports);
+__exportStar(require("./buildDayRangeBookingRequest.js"), exports);
+__exportStar(require("./buildCartRequest.js"), exports);
+__exportStar(require("./createBookingsForCart.js"), exports);
+__exportStar(require("./dayRange.js"), exports);
+__exportStar(require("./isCheckoutRequired.js"), exports);
+__exportStar(require("./types.js"), exports);

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

@@ -40,8 +40,18 @@ export interface ServiceSelection {
     service: Service;
     /** Selected resources (staff members, rooms, etc.) with type information */
     resources: ExtendedResource[];
-    /** Per-item time slot data */
+    /** Per-item time slot data (single-slot path; existing behavior). */
     timeSlot?: ServiceSelectionTimeSlot;
+    /**
+     * Per-day slots for DAY-range services. Populated by the availability
+     * picker after the customer picks a start + end date: one entry per day
+     * in the picked range. When set, supersedes `timeSlot` for the DAY-range
+     * builder, which produces one Booking per entry and routes via length:
+     *   - 1   -> bulkCreateBooking
+     *   - 2-8 -> createMultiServiceBooking
+     * Optional & additive: existing single-slot callers stay on `timeSlot`.
+     */
+    rangeTimeSlots?: ServiceSelectionTimeSlot[];
     /** Number of participants for this service selection */
     totalParticipants?: number;
 }

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

@@ -7,7 +7,7 @@ export { BookingService, BookingServiceDefinition, type BookingServiceConfig, ty
 export { TimeSlotListService, TimeSlotListServiceDefinition, TimeSlotService, TimeSlotServiceDefinition, ViewMode, loadTimeSlotListConfig, type TimeSlotListServiceAPI, type TimeSlotListServiceActions, type TimeSlotListServiceConfig, type TimeSlotServiceAPI, type TimeSlotServiceConfig, 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';
 export { SYNTHETIC_CUSTOM_ID, SYNTHETIC_CUSTOMER_ID, } from '../api/query-services/index.js';
-export { executeBookAction, canBook, buildBookingRequest, buildCartRequest, type CanBookParams, type BookResult, type BookingError, type BookActionParams, type BookChildProps, type BookProps, type BuildCartParams, } from './booking/book-action/index.js';
+export { executeBookAction, canBook, buildBookingRequest, buildCartRequest, buildDayRangeCartRequest, buildDayRangeBookingRequest, createBookingsForCart, isDayRangeService, getDayRangeBounds, type CanBookParams, type BookResult, type BookingError, type BookActionParams, type BookChildProps, type BookProps, type BuildCartParams, type BuildDayRangeCartParams, type BuildDayRangeBookingRequest, type CreatedBookings, type DayRangeBounds, } from './booking/book-action/index.js';
 export { BookingFormService, BookingFormServiceDefinition, type BookingFormServiceAPI, type BookingFormServiceConfig, } from './booking-form/booking-form.js';
 export { PaymentService, PaymentServiceDefinition, type PaymentServiceAPI, type PaymentServiceConfig, type PaymentDetails, type PricingServiceSelection, type LineItemAdditionalInfo, type ServicePaymentOptions, loadPaymentConfig, type SuccessPaymentConfigResult, type ErrorPaymentConfigResult, } from './payment/payment.js';
 export { LocationListService, LocationListServiceDefinition, LocationType, loadLocationListServiceInitialData, locationListServiceBinding, type LocationListServiceAPI, type LocationListServiceConfig, type LocationListActions, type Location, type LoadLocationListServiceResult, getLocationById, } from './location-list/location-list.js';

package/cjs/dist/services/index.js

@@ -4,7 +4,7 @@
  * Main export file for all service definitions and implementations
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.staffMemberListServiceBinding = exports.loadStaffMemberListServiceInitialData = exports.StaffMemberListServiceDefinition = exports.StaffMemberListService = exports.getLocationById = exports.locationListServiceBinding = exports.loadLocationListServiceInitialData = exports.LocationType = exports.LocationListServiceDefinition = exports.LocationListService = exports.loadPaymentConfig = exports.PaymentServiceDefinition = exports.PaymentService = exports.BookingFormServiceDefinition = exports.BookingFormService = exports.buildCartRequest = exports.buildBookingRequest = exports.canBook = exports.executeBookAction = exports.SYNTHETIC_CUSTOMER_ID = exports.SYNTHETIC_CUSTOM_ID = exports.loadServiceListServiceInitialData = exports.ServiceListServiceDefinition = exports.ServiceListService = exports.loadTimeSlotListConfig = exports.ViewMode = exports.TimeSlotServiceDefinition = exports.TimeSlotService = exports.TimeSlotListServiceDefinition = exports.TimeSlotListService = exports.BookingServiceDefinition = exports.BookingService = exports.loadServiceServiceInitialData = exports.ServiceServiceDefinition = exports.ServiceService = void 0;
+exports.staffMemberListServiceBinding = exports.loadStaffMemberListServiceInitialData = exports.StaffMemberListServiceDefinition = exports.StaffMemberListService = exports.getLocationById = exports.locationListServiceBinding = exports.loadLocationListServiceInitialData = exports.LocationType = exports.LocationListServiceDefinition = exports.LocationListService = exports.loadPaymentConfig = exports.PaymentServiceDefinition = exports.PaymentService = exports.BookingFormServiceDefinition = exports.BookingFormService = exports.getDayRangeBounds = exports.isDayRangeService = exports.createBookingsForCart = exports.buildDayRangeBookingRequest = exports.buildDayRangeCartRequest = exports.buildCartRequest = exports.buildBookingRequest = exports.canBook = exports.executeBookAction = exports.SYNTHETIC_CUSTOMER_ID = exports.SYNTHETIC_CUSTOM_ID = exports.loadServiceListServiceInitialData = exports.ServiceListServiceDefinition = exports.ServiceListService = exports.loadTimeSlotListConfig = exports.ViewMode = exports.TimeSlotServiceDefinition = exports.TimeSlotService = exports.TimeSlotListServiceDefinition = exports.TimeSlotListService = exports.BookingServiceDefinition = exports.BookingService = exports.loadServiceServiceInitialData = exports.ServiceServiceDefinition = exports.ServiceService = void 0;
 var service_js_1 = require("./service/service.js");
 Object.defineProperty(exports, "ServiceService", { enumerable: true, get: function () { return service_js_1.ServiceService; } });
 Object.defineProperty(exports, "ServiceServiceDefinition", { enumerable: true, get: function () { return service_js_1.ServiceServiceDefinition; } });
@@ -31,6 +31,11 @@ Object.defineProperty(exports, "executeBookAction", { enumerable: true, get: fun
 Object.defineProperty(exports, "canBook", { enumerable: true, get: function () { return index_js_3.canBook; } });
 Object.defineProperty(exports, "buildBookingRequest", { enumerable: true, get: function () { return index_js_3.buildBookingRequest; } });
 Object.defineProperty(exports, "buildCartRequest", { enumerable: true, get: function () { return index_js_3.buildCartRequest; } });
+Object.defineProperty(exports, "buildDayRangeCartRequest", { enumerable: true, get: function () { return index_js_3.buildDayRangeCartRequest; } });
+Object.defineProperty(exports, "buildDayRangeBookingRequest", { enumerable: true, get: function () { return index_js_3.buildDayRangeBookingRequest; } });
+Object.defineProperty(exports, "createBookingsForCart", { enumerable: true, get: function () { return index_js_3.createBookingsForCart; } });
+Object.defineProperty(exports, "isDayRangeService", { enumerable: true, get: function () { return index_js_3.isDayRangeService; } });
+Object.defineProperty(exports, "getDayRangeBounds", { enumerable: true, get: function () { return index_js_3.getDayRangeBounds; } });
 var booking_form_js_1 = require("./booking-form/booking-form.js");
 Object.defineProperty(exports, "BookingFormService", { enumerable: true, get: function () { return booking_form_js_1.BookingFormService; } });
 Object.defineProperty(exports, "BookingFormServiceDefinition", { enumerable: true, get: function () { return booking_form_js_1.BookingFormServiceDefinition; } });

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