@wix/headless-bookings 1.0.4 → 1.0.5

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;

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

@@ -1,7 +1,28 @@
 import { ChannelType, } from '../../../api/create-cart/index.js';
 import { BOOKING_APP_ID } from '../../constants.js';
 export function buildCartRequest(params) {
-    const { bookingId, contactDetails, businessLocationId, appId } = params;
+    return {
+        catalogItems: [buildCatalogItem(params.bookingId, params.appId)],
+        cart: buildCartShape(params),
+    };
+}
+export 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 ?? BOOKING_APP_ID,
+        },
+    };
+}
+function buildCartShape(params) {
+    const { contactDetails, businessLocationId } = params;
     const cart = {
         source: { channelType: ChannelType.WEB },
     };
@@ -19,16 +40,5 @@ export function buildCartRequest(params) {
             };
         }
     }
-    return {
-        catalogItems: [
-            {
-                quantity: 1,
-                catalogReference: {
-                    catalogItemId: bookingId,
-                    appId: appId ?? BOOKING_APP_ID,
-                },
-            },
-        ],
-        cart,
-    };
+    return cart;
 }

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

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

@@ -0,0 +1,67 @@
+/**
+ * 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 { buildBookingRequest } from './buildBookingRequest.js';
+/**
+ * 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 function buildDayRangeBookingRequest(params) {
+    const item = params.serviceSelections[0];
+    if (!item) {
+        throw new Error('No service selection provided');
+    }
+    const slots = item.rangeTimeSlots && item.rangeTimeSlots.length > 0
+        ? item.rangeTimeSlots
+        : item.timeSlot
+            ? [item.timeSlot]
+            : [];
+    if (slots.length === 0) {
+        throw new Error('No time slot selected for service selection');
+    }
+    // Build the base Booking using the singular timeSlot path so that shared
+    // fields (service, resource, location, payment, participants) are derived
+    // exactly once and consistently. Each per-day Booking is then a shallow
+    // clone with only the slot start/end overridden from `slots[i]`.
+    const baseSelection = item.timeSlot ? item : { ...item, timeSlot: slots[0] };
+    const baseRequest = buildBookingRequest({
+        ...params,
+        serviceSelections: [baseSelection, ...params.serviceSelections.slice(1)],
+    });
+    const bookings = slots.map((slot) => ({
+        ...baseRequest.booking,
+        bookedEntity: {
+            ...baseRequest.booking.bookedEntity,
+            slot: {
+                ...baseRequest.booking.bookedEntity?.slot,
+                startDate: slot.startDate,
+                endDate: slot.endDate,
+            },
+        },
+    }));
+    // TODO(createAsOneBooking): when the server flag lands, this builder should
+    // optionally collapse all slots into a single Booking spanning
+    // `slots[0].startDate -> slots[N-1].endDate` with `fullDay: true`, and
+    // routing should use plain `createBooking` (not bulk / multi-service).
+    return {
+        bookings,
+        participantNotification: baseRequest.participantNotification,
+        sendSmsReminder: baseRequest.sendSmsReminder ?? true,
+    };
+}

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

@@ -14,7 +14,8 @@ export interface CanBookParams {
  * Validates if booking can be executed
  * Checks that all required data is present:
  * - At least one service selection
- * - Each service selection has a time slot selected
+ * - Each service selection has either a `timeSlot` or a non-empty
+ *   `rangeTimeSlots` (DAY-range path)
  * - Form submission filled
  *
  * @param params - The booking data to validate

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

@@ -5,7 +5,8 @@
  * Validates if booking can be executed
  * Checks that all required data is present:
  * - At least one service selection
- * - Each service selection has a time slot selected
+ * - Each service selection has either a `timeSlot` or a non-empty
+ *   `rangeTimeSlots` (DAY-range path)
  * - Form submission filled
  *
  * @param params - The booking data to validate
@@ -14,6 +15,7 @@
 export function canBook(params) {
     const { serviceSelections, formSubmission } = params;
     return (serviceSelections.length > 0 &&
-        serviceSelections.every((item) => item.timeSlot !== undefined) &&
+        serviceSelections.every((item) => item.timeSlot !== undefined ||
+            (item.rangeTimeSlots !== undefined && item.rangeTimeSlots.length > 0)) &&
         formSubmission !== null);
 }

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

@@ -0,0 +1,66 @@
+/**
+ * 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 { createBooking } from '../../../api/create-booking/index.js';
+import { bulkCreateBooking } from '../../../api/create-bulk-booking/index.js';
+import { createMultiServiceBooking } from '../../../api/create-multi-service-booking/index.js';
+import { buildBookingRequest } from './buildBookingRequest.js';
+import { buildDayRangeBookingRequest } from './buildDayRangeBookingRequest.js';
+import { isDayRangeService } from './dayRange.js';
+export async function createBookingsForCart(params) {
+    const firstSelection = params.serviceSelections[0];
+    if (!firstSelection) {
+        throw new Error('No service selection provided');
+    }
+    if (isDayRangeService(firstSelection.service)) {
+        const req = 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 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 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 = buildBookingRequest(params);
+    const bookingResponse = await 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/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/dist/services/booking/book-action/dayRange.js

@@ -0,0 +1,39 @@
+/**
+ * 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 { ServiceType, UnitType, } 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 function isDayRangeService(service) {
+    const isAppointment = service.type === ServiceType.APPOINTMENT;
+    const isDayRange = service.schedule?.availabilityConstraints?.durationRange?.unitType ===
+        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.
+ */
+export 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/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/dist/services/booking/book-action/index.js

@@ -1,9 +1,12 @@
 /**
  * Book Action - Exports
  */
-export { executeBookAction } from './bookAction.js';
-export { canBook } from './canBook.js';
-export { buildBookingRequest } from './buildBookingRequest.js';
-export { buildCartRequest } from './buildCartRequest.js';
-export { isCheckoutRequired } from './isCheckoutRequired.js';
-export { BookResultType, } 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/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/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/dist/services/index.js

@@ -7,7 +7,7 @@ export { BookingService, BookingServiceDefinition, } from './booking/booking.js'
 export { TimeSlotListService, TimeSlotListServiceDefinition, TimeSlotService, TimeSlotServiceDefinition, ViewMode, loadTimeSlotListConfig, } from './time-slot-list/index.js';
 export { ServiceListService, ServiceListServiceDefinition, loadServiceListServiceInitialData, } from './service-list/service-list.js';
 export { SYNTHETIC_CUSTOM_ID, SYNTHETIC_CUSTOMER_ID, } from '../api/query-services/index.js';
-export { executeBookAction, canBook, buildBookingRequest, buildCartRequest, } from './booking/book-action/index.js';
+export { executeBookAction, canBook, buildBookingRequest, buildCartRequest, buildDayRangeCartRequest, buildDayRangeBookingRequest, createBookingsForCart, isDayRangeService, getDayRangeBounds, } from './booking/book-action/index.js';
 export { BookingFormService, BookingFormServiceDefinition, } from './booking-form/booking-form.js';
 export { PaymentService, PaymentServiceDefinition, loadPaymentConfig, } from './payment/payment.js';
 export { LocationListService, LocationListServiceDefinition, LocationType, loadLocationListServiceInitialData, locationListServiceBinding, getLocationById, } from './location-list/location-list.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/headless-bookings",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "type": "module",
   "license": "MIT",
   "scripts": {
@@ -75,5 +75,5 @@
       "groupId": "com.wixpress.headless-components"
     }
   },
-  "falconPackageHash": "dec47e7070b4b0988f6a3174a24135c58fd38c13c4a9d098bd0e9d99"
+  "falconPackageHash": "874dff357223e1f787076e35a7a2f3268eeb3e12e98104b2a779ebf8"
 }