@wix/headless-bookings 0.0.47 → 0.0.49

package/cjs/dist/api/create-order/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Create Order API
+ * Wrapper for the Wix eCommerce createOrder SDK function
+ */
+import { type CreateOrderOptions, type CreateOrderResponse } from '@wix/auto_sdk_ecom_checkout';
+/**
+ * Creates an order from a checkout session
+ *
+ * @param checkoutId - The checkout session ID
+ * @param options - Optional additional order creation options
+ * @returns Promise resolving to the created order response
+ *
+ * @example
+ * ```typescript
+ * const response = await createOrder(checkoutId);
+ * const orderId = response.orderId;
+ * ```
+ */
+export declare function createOrder(checkoutId: string, options?: CreateOrderOptions): Promise<CreateOrderResponse>;
+export type { CreateOrderOptions, CreateOrderResponse };

package/cjs/dist/api/create-order/index.js

@@ -0,0 +1,21 @@
+/**
+ * Create Order API
+ * Wrapper for the Wix eCommerce createOrder SDK function
+ */
+import { createOrder as createOrderSdk, } from '@wix/auto_sdk_ecom_checkout';
+/**
+ * Creates an order from a checkout session
+ *
+ * @param checkoutId - The checkout session ID
+ * @param options - Optional additional order creation options
+ * @returns Promise resolving to the created order response
+ *
+ * @example
+ * ```typescript
+ * const response = await createOrder(checkoutId);
+ * const orderId = response.orderId;
+ * ```
+ */
+export async function createOrder(checkoutId, options) {
+    return createOrderSdk(checkoutId, options);
+}

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

@@ -8,6 +8,7 @@ export { getServiceById, getServiceBySlug, queryServices, type PagingMetadata, t
 export { fetchAvailability } from './fetch-availability/index.js';
 export { createBooking, type CreateBookingOptions, type Booking, type CreateBookingRequest, type CreateBookingResponse, type ParticipantNotification, type ContactDetails, } from './create-booking/index.js';
 export { createCheckout, ChannelType, type CreateCheckoutRequest, type CreateCheckoutResponse, } from './create-checkout/index.js';
+export { createOrder, type CreateOrderOptions, type CreateOrderResponse, } from './create-order/index.js';
 export { queryLocations, type QueryLocationsResult, type LocationData, } from './query-locations/index.js';
 export { queryCategories, type QueryCategoriesResult, type Category, } from './query-categories/index.js';
 /**

package/cjs/dist/api/index.js

@@ -8,6 +8,7 @@ export { getServiceById, getServiceBySlug, queryServices, } from './query-servic
 export { fetchAvailability } from './fetch-availability/index.js';
 export { createBooking, } from './create-booking/index.js';
 export { createCheckout, ChannelType, } from './create-checkout/index.js';
+export { createOrder, } from './create-order/index.js';
 export { queryLocations, } from './query-locations/index.js';
 export { queryCategories, } from './query-categories/index.js';
 /**

package/cjs/dist/react/booking/Book.d.ts

@@ -3,7 +3,7 @@
  * Wraps core Book with AsChildSlot pattern for customization
  */
 import React from 'react';
-import type { BookChildProps, BookResult, BookingError } from '../../services/booking/book-action/types.js';
+import type { BookChildProps, BookingError } from '../../services/booking/book-action/types.js';
 /**
  * Props for the high-level Book component
  */
@@ -14,7 +14,12 @@ export interface BookProps {
     label?: string;
     loadingState?: string;
     disabled?: boolean;
-    onCheckoutRequired?: (result: BookResult) => void;
+    onCheckout?: (result: {
+        checkoutId: string;
+    }) => void;
+    onComplete?: (result: {
+        orderId: string;
+    }) => void;
     onError?: (error: BookingError) => void;
 }
 /**
@@ -27,12 +32,16 @@ export interface BookProps {
  *
  * // With callbacks
  * <Booking.Actions.Book
- *   onCheckoutRequired={({ checkoutId }) => router.push(`/checkout?id=${checkoutId}`)}
+ *   onCheckout={({ checkoutId }) => router.push(`/checkout?id=${checkoutId}`)}
+ *   onComplete={({ orderId }) => router.push(`/thank-you?orderId=${orderId}`)}
  *   onError={(error) => console.error(error.message)}
  * />
  *
  * // With render function
- * <Booking.Actions.Book onCheckoutRequired={handleCheckout}>
+ * <Booking.Actions.Book
+ *   onCheckout={({ checkoutId }) => router.push(`/checkout?id=${checkoutId}`)}
+ *   onComplete={({ orderId }) => router.push(`/thank-you?orderId=${orderId}`)}
+ * >
  *   {({ isLoading, error, canBook, onClick, disabled }) => (
  *     <button onClick={onClick} disabled={disabled}>
  *       {isLoading ? <Spinner /> : 'Book Now'}
@@ -41,7 +50,11 @@ export interface BookProps {
  * </Booking.Actions.Book>
  *
  * // With asChild
- * <Booking.Actions.Book asChild onCheckoutRequired={handleCheckout}>
+ * <Booking.Actions.Book
+ *   asChild
+ *   onCheckout={({ checkoutId }) => router.push(`/checkout?id=${checkoutId}`)}
+ *   onComplete={({ orderId }) => router.push(`/thank-you?orderId=${orderId}`)}
+ * >
  *   <CustomBookButton />
  * </Booking.Actions.Book>
  * ```

package/cjs/dist/react/booking/Book.js

@@ -20,12 +20,16 @@ var TestIds;
  *
  * // With callbacks
  * <Booking.Actions.Book
- *   onCheckoutRequired={({ checkoutId }) => router.push(`/checkout?id=${checkoutId}`)}
+ *   onCheckout={({ checkoutId }) => router.push(`/checkout?id=${checkoutId}`)}
+ *   onComplete={({ orderId }) => router.push(`/thank-you?orderId=${orderId}`)}
  *   onError={(error) => console.error(error.message)}
  * />
  *
  * // With render function
- * <Booking.Actions.Book onCheckoutRequired={handleCheckout}>
+ * <Booking.Actions.Book
+ *   onCheckout={({ checkoutId }) => router.push(`/checkout?id=${checkoutId}`)}
+ *   onComplete={({ orderId }) => router.push(`/thank-you?orderId=${orderId}`)}
+ * >
  *   {({ isLoading, error, canBook, onClick, disabled }) => (
  *     <button onClick={onClick} disabled={disabled}>
  *       {isLoading ? <Spinner /> : 'Book Now'}
@@ -34,13 +38,17 @@ var TestIds;
  * </Booking.Actions.Book>
  *
  * // With asChild
- * <Booking.Actions.Book asChild onCheckoutRequired={handleCheckout}>
+ * <Booking.Actions.Book
+ *   asChild
+ *   onCheckout={({ checkoutId }) => router.push(`/checkout?id=${checkoutId}`)}
+ *   onComplete={({ orderId }) => router.push(`/thank-you?orderId=${orderId}`)}
+ * >
  *   <CustomBookButton />
  * </Booking.Actions.Book>
  * ```
  */
 export const Book = React.forwardRef((props, ref) => {
-    const { asChild, children, className, label = 'Book Now', loadingState = 'Booking...', disabled, onCheckoutRequired, onError, } = props;
-    return (_jsx(CoreBook.Book, { onCheckoutRequired: onCheckoutRequired, onError: onError, disabled: disabled, children: (childProps) => (_jsx(AsChildSlot, { ref: ref, asChild: asChild, className: className, "data-testid": TestIds.bookingActionBook, "data-in-progress": childProps.isLoading, customElement: children, customElementProps: childProps, children: _jsx("button", { onClick: childProps.onClick, disabled: childProps.disabled, children: childProps.isLoading ? loadingState : label }) })) }));
+    const { asChild, children, className, label = 'Book Now', loadingState = 'Booking...', disabled, onCheckout, onComplete, onError, } = props;
+    return (_jsx(CoreBook.Book, { onCheckout: onCheckout, onComplete: onComplete, onError: onError, disabled: disabled, children: (childProps) => (_jsx(AsChildSlot, { ref: ref, asChild: asChild, className: className, "data-testid": TestIds.bookingActionBook, "data-in-progress": childProps.isLoading, customElement: children, customElementProps: childProps, children: _jsx("button", { onClick: childProps.onClick, disabled: childProps.disabled, children: childProps.isLoading ? loadingState : label }) })) }));
 });
 Book.displayName = 'Booking.Actions.Book';

package/cjs/dist/react/core/booking/Book.d.ts

@@ -3,7 +3,7 @@
  * NO AsChildSlot, NO asChild - that belongs in high-level component
  */
 import React from 'react';
-import type { BookResult, BookingError } from '../../../services/booking/book-action/types.js';
+import { type BookingError } from '../../../services/booking/book-action/types.js';
 /**
  * Data exposed by Book component via render props
  */
@@ -19,7 +19,12 @@ export interface BookData {
  */
 export interface BookProps {
     children: (data: BookData) => React.ReactNode;
-    onCheckoutRequired?: (result: BookResult) => void;
+    onCheckout?: (result: {
+        checkoutId: string;
+    }) => void;
+    onComplete?: (result: {
+        orderId: string;
+    }) => void;
     onError?: (error: BookingError) => void;
     disabled?: boolean;
 }
@@ -29,7 +34,10 @@ export interface BookProps {
  *
  * @example
  * ```tsx
- * <Book onCheckoutRequired={handleCheckout}>
+ * <Book
+ *   onCheckout={({ checkoutId }) => navigate(`/checkout?id=${checkoutId}`)}
+ *   onComplete={({ orderId }) => navigate(`/thank-you?orderId=${orderId}`)}
+ * >
  *   {({ isLoading, error, canBook, onClick, disabled }) => (
  *     <button onClick={onClick} disabled={disabled}>
  *       {isLoading ? 'Booking...' : 'Book Now'}

package/cjs/dist/react/core/booking/Book.js

@@ -6,13 +6,17 @@ import { useState } from 'react';
 import { useService } from '@wix/services-manager-react';
 import { BookingServiceDefinition } from '../../../services/booking/booking.js';
 import { canBook } from '../../../services/booking/book-action/canBook.js';
+import { BookResultType, } from '../../../services/booking/book-action/types.js';
 /**
  * Core Book component - provides book action data via render props.
  * Used internally by higher-level Booking.Actions.Book component.
  *
  * @example
  * ```tsx
- * <Book onCheckoutRequired={handleCheckout}>
+ * <Book
+ *   onCheckout={({ checkoutId }) => navigate(`/checkout?id=${checkoutId}`)}
+ *   onComplete={({ orderId }) => navigate(`/thank-you?orderId=${orderId}`)}
+ * >
  *   {({ isLoading, error, canBook, onClick, disabled }) => (
  *     <button onClick={onClick} disabled={disabled}>
  *       {isLoading ? 'Booking...' : 'Book Now'}
@@ -22,7 +26,7 @@ import { canBook } from '../../../services/booking/book-action/canBook.js';
  * ```
  */
 export function Book(props) {
-    const { children, onCheckoutRequired, onError, disabled } = props;
+    const { children, onCheckout, onComplete, onError, disabled } = props;
     const [isLoading, setIsLoading] = useState(false);
     const [error, setError] = useState(null);
     const bookingService = useService(BookingServiceDefinition);
@@ -34,7 +38,12 @@ export function Book(props) {
         setError(null);
         try {
             const result = await bookingService.actions.book();
-            onCheckoutRequired?.(result);
+            if (result.type === BookResultType.CheckoutRequired) {
+                onCheckout?.({ checkoutId: result.checkoutId });
+            }
+            else {
+                onComplete?.({ orderId: result.orderId });
+            }
         }
         catch (e) {
             const bookingError = {

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

@@ -4,18 +4,21 @@
  * 1. Validates booking data with canBook()
  * 2. Creates a booking via createBooking() from API layer
  * 3. Creates a checkout via createCheckout() from API layer
- * 4. Returns the checkoutId for navigation
+ * 4. Determines if checkout is required or can be skipped
+ * 5. Returns appropriate result for navigation
  */
-import type { BookActionParams, BookResult } from './types.js';
+import { type BookActionParams, type BookResult } from './types.js';
 /**
  * Executes the complete booking flow:
  * 1. Validates that all required data is present
  * 2. Creates a booking with the selected service, time slot, and form data
  * 3. Creates a checkout session for payment (includes contact details from booking)
- * 4. Returns the checkout ID for navigation to the checkout page
+ * 4. Determines if checkout page is required or can be skipped
+ * 5. If checkout can be skipped (free/offline), creates order directly
+ * 6. Returns appropriate result for navigation
  *
  * @param params - The booking action parameters
- * @returns BookResult with the checkoutId
- * @throws Error if validation fails, or booking/checkout creation fails
+ * @returns BookResult with either checkoutId or orderId
+ * @throws Error if validation fails, or booking/checkout/order creation fails
  */
 export declare function executeBookAction(params: BookActionParams): Promise<BookResult>;

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

@@ -4,23 +4,29 @@
  * 1. Validates booking data with canBook()
  * 2. Creates a booking via createBooking() from API layer
  * 3. Creates a checkout via createCheckout() from API layer
- * 4. Returns the checkoutId for navigation
+ * 4. Determines if checkout is required or can be skipped
+ * 5. Returns appropriate result for navigation
  */
 import { createBooking } from '../../../api/create-booking/index.js';
 import { createCheckout } from '../../../api/create-checkout/index.js';
+import { createOrder } from '../../../api/create-order/index.js';
 import { buildBookingRequest } from './buildBookingRequest.js';
 import { buildCheckoutRequest } from './buildCheckoutRequest.js';
 import { canBook } from './canBook.js';
+import { isCheckoutRequired } from './isCheckoutRequired.js';
+import { BookResultType, } from './types.js';
 /**
  * Executes the complete booking flow:
  * 1. Validates that all required data is present
  * 2. Creates a booking with the selected service, time slot, and form data
  * 3. Creates a checkout session for payment (includes contact details from booking)
- * 4. Returns the checkout ID for navigation to the checkout page
+ * 4. Determines if checkout page is required or can be skipped
+ * 5. If checkout can be skipped (free/offline), creates order directly
+ * 6. Returns appropriate result for navigation
  *
  * @param params - The booking action parameters
- * @returns BookResult with the checkoutId
- * @throws Error if validation fails, or booking/checkout creation fails
+ * @returns BookResult with either checkoutId or orderId
+ * @throws Error if validation fails, or booking/checkout/order creation fails
  */
 export async function executeBookAction(params) {
     // Step 0: Validate
@@ -45,16 +51,30 @@ export async function executeBookAction(params) {
     // Step 2: Create checkout
     // businessLocationId: prefer timeSlot.location, fallback to global location
     const firstSelection = params.serviceSelections[0];
-    const businessLocationId = firstSelection?.timeSlot?.location?._id ?? undefined;
+    if (!firstSelection) {
+        throw new Error('No service selection found');
+    }
+    const businessLocationId = firstSelection.timeSlot?.location?._id ?? undefined;
     const checkoutRequest = buildCheckoutRequest({
         bookingId,
         contactDetails,
         businessLocationId,
     });
     const checkoutResponse = await createCheckout(checkoutRequest);
-    const checkoutId = checkoutResponse.checkout?._id;
-    if (!checkoutId) {
+    const checkout = checkoutResponse.checkout;
+    if (!checkout?._id) {
         throw new Error('Failed to create checkout');
     }
-    return { checkoutId };
+    // Step 3: Determine if checkout is required or can be skipped
+    const service = firstSelection.service;
+    if (isCheckoutRequired(checkout, service)) {
+        return { type: BookResultType.CheckoutRequired, checkoutId: checkout._id };
+    }
+    // Step 4: Skip checkout - create order directly
+    const orderResponse = await createOrder(checkout._id);
+    const orderId = orderResponse.orderId;
+    if (!orderId) {
+        throw new Error('Failed to create order');
+    }
+    return { type: BookResultType.CheckoutSkipped, orderId };
 }

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

@@ -1,6 +1,8 @@
 /**
  * Builds the createBooking request from BookActionParams
  */
+import { LocationType as TimeSlotLocationType } from '@wix/auto_sdk_bookings_availability-time-slots';
+import { LocationType as BookingLocationType } from '@wix/auto_sdk_bookings_bookings';
 /**
  * Derives the selected payment option from service payment settings.
  * Maps service.payment.options to booking API's selectedPaymentOption.
@@ -69,7 +71,11 @@ export function buildBookingRequest(params) {
                         ? { _id: resource._id, name: resource.name }
                         : undefined,
                     location: slotLocation
-                        ? { _id: slotLocation._id, name: slotLocation.name }
+                        ? {
+                            _id: slotLocation._id,
+                            name: slotLocation.name,
+                            locationType: mapTimeSlotLocationTypeToBookingLocationType(slotLocation.locationType),
+                        }
                         : undefined,
                 },
             },
@@ -81,3 +87,17 @@ export function buildBookingRequest(params) {
         formSubmission: formSubmission ?? undefined,
     };
 }
+function mapTimeSlotLocationTypeToBookingLocationType(slotLocationType) {
+    switch (slotLocationType) {
+        case TimeSlotLocationType.BUSINESS:
+            return BookingLocationType.OWNER_BUSINESS;
+        case TimeSlotLocationType.CUSTOMER:
+            return BookingLocationType.CUSTOM;
+        case TimeSlotLocationType.CUSTOM:
+            return BookingLocationType.OWNER_CUSTOM;
+        case TimeSlotLocationType.UNKNOWN_LOCATION_TYPE:
+            return BookingLocationType.UNDEFINED;
+        default:
+            return BookingLocationType.OWNER_BUSINESS;
+    }
+}

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

@@ -5,4 +5,5 @@ export { executeBookAction } from './bookAction.js';
 export { canBook, type CanBookParams } from './canBook.js';
 export { buildBookingRequest } from './buildBookingRequest.js';
 export { buildCheckoutRequest, type BuildCheckoutParams, } from './buildCheckoutRequest.js';
-export type { BookProps, BookResult, BookingError, BookActionParams, BookChildProps, } from './types.js';
+export { isCheckoutRequired } from './isCheckoutRequired.js';
+export { BookResultType, type BookProps, type BookResult, type BookingError, type BookActionParams, type BookChildProps, } from './types.js';

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

@@ -5,3 +5,5 @@ export { executeBookAction } from './bookAction.js';
 export { canBook } from './canBook.js';
 export { buildBookingRequest } from './buildBookingRequest.js';
 export { buildCheckoutRequest, } from './buildCheckoutRequest.js';
+export { isCheckoutRequired } from './isCheckoutRequired.js';
+export { BookResultType, } from './types.js';

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

@@ -0,0 +1,20 @@
+/**
+ * Determines if checkout page is required based on payment amounts
+ */
+import type { Checkout } from '@wix/auto_sdk_ecom_checkout';
+import type { Service } from '@wix/auto_sdk_bookings_services';
+/**
+ * Determines if checkout page is required based on payment amounts.
+ *
+ * Skip checkout when:
+ * - Free booking: payNow = 0 AND payLater = 0
+ * - Offline payment: payNow = 0
+ *
+ * Force checkout when:
+ * - Service has cancellation fee
+ *
+ * @param checkout - The checkout response from createCheckout
+ * @param service - The service being booked
+ * @returns true if checkout page is required, false if can skip to order
+ */
+export declare function isCheckoutRequired(checkout: Checkout, service: Service): boolean;

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

@@ -0,0 +1,32 @@
+/**
+ * Determines if checkout page is required based on payment amounts
+ */
+/**
+ * Determines if checkout page is required based on payment amounts.
+ *
+ * Skip checkout when:
+ * - Free booking: payNow = 0 AND payLater = 0
+ * - Offline payment: payNow = 0
+ *
+ * Force checkout when:
+ * - Service has cancellation fee
+ *
+ * @param checkout - The checkout response from createCheckout
+ * @param service - The service being booked
+ * @returns true if checkout page is required, false if can skip to order
+ */
+export function isCheckoutRequired(checkout, service) {
+    // Force checkout for cancellation fee
+    const hasCancellationFee = service.bookingPolicy?.cancellationPolicy?.enabled;
+    if (hasCancellationFee) {
+        return true;
+    }
+    const payNowAmount = Number(checkout.payNow?.total?.amount ?? 0);
+    const payLaterAmount = Number(checkout.payLater?.total?.amount ?? 0);
+    // Free or price plan: both amounts are 0
+    const isFreeOrPricePlan = payNowAmount === 0 && payLaterAmount === 0;
+    // Offline payment: payNow is 0
+    const isOfflinePayment = payNowAmount === 0;
+    // Skip checkout if free/price plan OR offline payment
+    return !(isFreeOrPricePlan || isOfflinePayment);
+}

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

@@ -4,11 +4,22 @@
 import type { ServiceSelection } from '../booking.js';
 import type { FormValues } from '@wix/form-public';
 import type { Location as TimeSlotLocationType } from '@wix/auto_sdk_bookings_availability-time-slots';
+/**
+ * Enum for book result types
+ */
+export declare enum BookResultType {
+    CheckoutRequired = "checkout_required",
+    CheckoutSkipped = "checkout_skipped"
+}
 /**
  * Result returned from the book action
  */
 export type BookResult = {
+    type: BookResultType.CheckoutRequired;
     checkoutId: string;
+} | {
+    type: BookResultType.CheckoutSkipped;
+    orderId: string;
 };
 /**
  * Error object for booking errors
@@ -46,6 +57,11 @@ export interface BookProps {
     label?: string;
     loadingState?: string;
     disabled?: boolean;
-    onCheckoutRequired?: (result: BookResult) => void;
+    onCheckout?: (result: {
+        checkoutId: string;
+    }) => void;
+    onComplete?: (result: {
+        orderId: string;
+    }) => void;
     onError?: (error: BookingError) => void;
 }

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

@@ -1,4 +1,11 @@
 /**
  * Types for the Book action
  */
-export {};
+/**
+ * Enum for book result types
+ */
+export var BookResultType;
+(function (BookResultType) {
+    BookResultType["CheckoutRequired"] = "checkout_required";
+    BookResultType["CheckoutSkipped"] = "checkout_skipped";
+})(BookResultType || (BookResultType = {}));

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

@@ -0,0 +1,20 @@
+/**
+ * Create Order API
+ * Wrapper for the Wix eCommerce createOrder SDK function
+ */
+import { type CreateOrderOptions, type CreateOrderResponse } from '@wix/auto_sdk_ecom_checkout';
+/**
+ * Creates an order from a checkout session
+ *
+ * @param checkoutId - The checkout session ID
+ * @param options - Optional additional order creation options
+ * @returns Promise resolving to the created order response
+ *
+ * @example
+ * ```typescript
+ * const response = await createOrder(checkoutId);
+ * const orderId = response.orderId;
+ * ```
+ */
+export declare function createOrder(checkoutId: string, options?: CreateOrderOptions): Promise<CreateOrderResponse>;
+export type { CreateOrderOptions, CreateOrderResponse };

package/dist/api/create-order/index.js

@@ -0,0 +1,21 @@
+/**
+ * Create Order API
+ * Wrapper for the Wix eCommerce createOrder SDK function
+ */
+import { createOrder as createOrderSdk, } from '@wix/auto_sdk_ecom_checkout';
+/**
+ * Creates an order from a checkout session
+ *
+ * @param checkoutId - The checkout session ID
+ * @param options - Optional additional order creation options
+ * @returns Promise resolving to the created order response
+ *
+ * @example
+ * ```typescript
+ * const response = await createOrder(checkoutId);
+ * const orderId = response.orderId;
+ * ```
+ */
+export async function createOrder(checkoutId, options) {
+    return createOrderSdk(checkoutId, options);
+}

package/dist/api/index.d.ts

@@ -8,6 +8,7 @@ export { getServiceById, getServiceBySlug, queryServices, type PagingMetadata, t
 export { fetchAvailability } from './fetch-availability/index.js';
 export { createBooking, type CreateBookingOptions, type Booking, type CreateBookingRequest, type CreateBookingResponse, type ParticipantNotification, type ContactDetails, } from './create-booking/index.js';
 export { createCheckout, ChannelType, type CreateCheckoutRequest, type CreateCheckoutResponse, } from './create-checkout/index.js';
+export { createOrder, type CreateOrderOptions, type CreateOrderResponse, } from './create-order/index.js';
 export { queryLocations, type QueryLocationsResult, type LocationData, } from './query-locations/index.js';
 export { queryCategories, type QueryCategoriesResult, type Category, } from './query-categories/index.js';
 /**

package/dist/api/index.js

@@ -8,6 +8,7 @@ export { getServiceById, getServiceBySlug, queryServices, } from './query-servic
 export { fetchAvailability } from './fetch-availability/index.js';
 export { createBooking, } from './create-booking/index.js';
 export { createCheckout, ChannelType, } from './create-checkout/index.js';
+export { createOrder, } from './create-order/index.js';
 export { queryLocations, } from './query-locations/index.js';
 export { queryCategories, } from './query-categories/index.js';
 /**

package/dist/react/booking/Book.d.ts

@@ -3,7 +3,7 @@
  * Wraps core Book with AsChildSlot pattern for customization
  */
 import React from 'react';
-import type { BookChildProps, BookResult, BookingError } from '../../services/booking/book-action/types.js';
+import type { BookChildProps, BookingError } from '../../services/booking/book-action/types.js';
 /**
  * Props for the high-level Book component
  */
@@ -14,7 +14,12 @@ export interface BookProps {
     label?: string;
     loadingState?: string;
     disabled?: boolean;
-    onCheckoutRequired?: (result: BookResult) => void;
+    onCheckout?: (result: {
+        checkoutId: string;
+    }) => void;
+    onComplete?: (result: {
+        orderId: string;
+    }) => void;
     onError?: (error: BookingError) => void;
 }
 /**
@@ -27,12 +32,16 @@ export interface BookProps {
  *
  * // With callbacks
  * <Booking.Actions.Book
- *   onCheckoutRequired={({ checkoutId }) => router.push(`/checkout?id=${checkoutId}`)}
+ *   onCheckout={({ checkoutId }) => router.push(`/checkout?id=${checkoutId}`)}
+ *   onComplete={({ orderId }) => router.push(`/thank-you?orderId=${orderId}`)}
  *   onError={(error) => console.error(error.message)}
  * />
  *
  * // With render function
- * <Booking.Actions.Book onCheckoutRequired={handleCheckout}>
+ * <Booking.Actions.Book
+ *   onCheckout={({ checkoutId }) => router.push(`/checkout?id=${checkoutId}`)}
+ *   onComplete={({ orderId }) => router.push(`/thank-you?orderId=${orderId}`)}
+ * >
  *   {({ isLoading, error, canBook, onClick, disabled }) => (
  *     <button onClick={onClick} disabled={disabled}>
  *       {isLoading ? <Spinner /> : 'Book Now'}
@@ -41,7 +50,11 @@ export interface BookProps {
  * </Booking.Actions.Book>
  *
  * // With asChild
- * <Booking.Actions.Book asChild onCheckoutRequired={handleCheckout}>
+ * <Booking.Actions.Book
+ *   asChild
+ *   onCheckout={({ checkoutId }) => router.push(`/checkout?id=${checkoutId}`)}
+ *   onComplete={({ orderId }) => router.push(`/thank-you?orderId=${orderId}`)}
+ * >
  *   <CustomBookButton />
  * </Booking.Actions.Book>
  * ```

package/dist/react/booking/Book.js

@@ -20,12 +20,16 @@ var TestIds;
  *
  * // With callbacks
  * <Booking.Actions.Book
- *   onCheckoutRequired={({ checkoutId }) => router.push(`/checkout?id=${checkoutId}`)}
+ *   onCheckout={({ checkoutId }) => router.push(`/checkout?id=${checkoutId}`)}
+ *   onComplete={({ orderId }) => router.push(`/thank-you?orderId=${orderId}`)}
  *   onError={(error) => console.error(error.message)}
  * />
  *
  * // With render function
- * <Booking.Actions.Book onCheckoutRequired={handleCheckout}>
+ * <Booking.Actions.Book
+ *   onCheckout={({ checkoutId }) => router.push(`/checkout?id=${checkoutId}`)}
+ *   onComplete={({ orderId }) => router.push(`/thank-you?orderId=${orderId}`)}
+ * >
  *   {({ isLoading, error, canBook, onClick, disabled }) => (
  *     <button onClick={onClick} disabled={disabled}>
  *       {isLoading ? <Spinner /> : 'Book Now'}
@@ -34,13 +38,17 @@ var TestIds;
  * </Booking.Actions.Book>
  *
  * // With asChild
- * <Booking.Actions.Book asChild onCheckoutRequired={handleCheckout}>
+ * <Booking.Actions.Book
+ *   asChild
+ *   onCheckout={({ checkoutId }) => router.push(`/checkout?id=${checkoutId}`)}
+ *   onComplete={({ orderId }) => router.push(`/thank-you?orderId=${orderId}`)}
+ * >
  *   <CustomBookButton />
  * </Booking.Actions.Book>
  * ```
  */
 export const Book = React.forwardRef((props, ref) => {
-    const { asChild, children, className, label = 'Book Now', loadingState = 'Booking...', disabled, onCheckoutRequired, onError, } = props;
-    return (_jsx(CoreBook.Book, { onCheckoutRequired: onCheckoutRequired, onError: onError, disabled: disabled, children: (childProps) => (_jsx(AsChildSlot, { ref: ref, asChild: asChild, className: className, "data-testid": TestIds.bookingActionBook, "data-in-progress": childProps.isLoading, customElement: children, customElementProps: childProps, children: _jsx("button", { onClick: childProps.onClick, disabled: childProps.disabled, children: childProps.isLoading ? loadingState : label }) })) }));
+    const { asChild, children, className, label = 'Book Now', loadingState = 'Booking...', disabled, onCheckout, onComplete, onError, } = props;
+    return (_jsx(CoreBook.Book, { onCheckout: onCheckout, onComplete: onComplete, onError: onError, disabled: disabled, children: (childProps) => (_jsx(AsChildSlot, { ref: ref, asChild: asChild, className: className, "data-testid": TestIds.bookingActionBook, "data-in-progress": childProps.isLoading, customElement: children, customElementProps: childProps, children: _jsx("button", { onClick: childProps.onClick, disabled: childProps.disabled, children: childProps.isLoading ? loadingState : label }) })) }));
 });
 Book.displayName = 'Booking.Actions.Book';

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

@@ -3,7 +3,7 @@
  * NO AsChildSlot, NO asChild - that belongs in high-level component
  */
 import React from 'react';
-import type { BookResult, BookingError } from '../../../services/booking/book-action/types.js';
+import { type BookingError } from '../../../services/booking/book-action/types.js';
 /**
  * Data exposed by Book component via render props
  */
@@ -19,7 +19,12 @@ export interface BookData {
  */
 export interface BookProps {
     children: (data: BookData) => React.ReactNode;
-    onCheckoutRequired?: (result: BookResult) => void;
+    onCheckout?: (result: {
+        checkoutId: string;
+    }) => void;
+    onComplete?: (result: {
+        orderId: string;
+    }) => void;
     onError?: (error: BookingError) => void;
     disabled?: boolean;
 }
@@ -29,7 +34,10 @@ export interface BookProps {
  *
  * @example
  * ```tsx
- * <Book onCheckoutRequired={handleCheckout}>
+ * <Book
+ *   onCheckout={({ checkoutId }) => navigate(`/checkout?id=${checkoutId}`)}
+ *   onComplete={({ orderId }) => navigate(`/thank-you?orderId=${orderId}`)}
+ * >
  *   {({ isLoading, error, canBook, onClick, disabled }) => (
  *     <button onClick={onClick} disabled={disabled}>
  *       {isLoading ? 'Booking...' : 'Book Now'}

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

@@ -6,13 +6,17 @@ import { useState } from 'react';
 import { useService } from '@wix/services-manager-react';
 import { BookingServiceDefinition } from '../../../services/booking/booking.js';
 import { canBook } from '../../../services/booking/book-action/canBook.js';
+import { BookResultType, } from '../../../services/booking/book-action/types.js';
 /**
  * Core Book component - provides book action data via render props.
  * Used internally by higher-level Booking.Actions.Book component.
  *
  * @example
  * ```tsx
- * <Book onCheckoutRequired={handleCheckout}>
+ * <Book
+ *   onCheckout={({ checkoutId }) => navigate(`/checkout?id=${checkoutId}`)}
+ *   onComplete={({ orderId }) => navigate(`/thank-you?orderId=${orderId}`)}
+ * >
  *   {({ isLoading, error, canBook, onClick, disabled }) => (
  *     <button onClick={onClick} disabled={disabled}>
  *       {isLoading ? 'Booking...' : 'Book Now'}
@@ -22,7 +26,7 @@ import { canBook } from '../../../services/booking/book-action/canBook.js';
  * ```
  */
 export function Book(props) {
-    const { children, onCheckoutRequired, onError, disabled } = props;
+    const { children, onCheckout, onComplete, onError, disabled } = props;
     const [isLoading, setIsLoading] = useState(false);
     const [error, setError] = useState(null);
     const bookingService = useService(BookingServiceDefinition);
@@ -34,7 +38,12 @@ export function Book(props) {
         setError(null);
         try {
             const result = await bookingService.actions.book();
-            onCheckoutRequired?.(result);
+            if (result.type === BookResultType.CheckoutRequired) {
+                onCheckout?.({ checkoutId: result.checkoutId });
+            }
+            else {
+                onComplete?.({ orderId: result.orderId });
+            }
         }
         catch (e) {
             const bookingError = {

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

@@ -4,18 +4,21 @@
  * 1. Validates booking data with canBook()
  * 2. Creates a booking via createBooking() from API layer
  * 3. Creates a checkout via createCheckout() from API layer
- * 4. Returns the checkoutId for navigation
+ * 4. Determines if checkout is required or can be skipped
+ * 5. Returns appropriate result for navigation
  */
-import type { BookActionParams, BookResult } from './types.js';
+import { type BookActionParams, type BookResult } from './types.js';
 /**
  * Executes the complete booking flow:
  * 1. Validates that all required data is present
  * 2. Creates a booking with the selected service, time slot, and form data
  * 3. Creates a checkout session for payment (includes contact details from booking)
- * 4. Returns the checkout ID for navigation to the checkout page
+ * 4. Determines if checkout page is required or can be skipped
+ * 5. If checkout can be skipped (free/offline), creates order directly
+ * 6. Returns appropriate result for navigation
  *
  * @param params - The booking action parameters
- * @returns BookResult with the checkoutId
- * @throws Error if validation fails, or booking/checkout creation fails
+ * @returns BookResult with either checkoutId or orderId
+ * @throws Error if validation fails, or booking/checkout/order creation fails
  */
 export declare function executeBookAction(params: BookActionParams): Promise<BookResult>;

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

@@ -4,23 +4,29 @@
  * 1. Validates booking data with canBook()
  * 2. Creates a booking via createBooking() from API layer
  * 3. Creates a checkout via createCheckout() from API layer
- * 4. Returns the checkoutId for navigation
+ * 4. Determines if checkout is required or can be skipped
+ * 5. Returns appropriate result for navigation
  */
 import { createBooking } from '../../../api/create-booking/index.js';
 import { createCheckout } from '../../../api/create-checkout/index.js';
+import { createOrder } from '../../../api/create-order/index.js';
 import { buildBookingRequest } from './buildBookingRequest.js';
 import { buildCheckoutRequest } from './buildCheckoutRequest.js';
 import { canBook } from './canBook.js';
+import { isCheckoutRequired } from './isCheckoutRequired.js';
+import { BookResultType, } from './types.js';
 /**
  * Executes the complete booking flow:
  * 1. Validates that all required data is present
  * 2. Creates a booking with the selected service, time slot, and form data
  * 3. Creates a checkout session for payment (includes contact details from booking)
- * 4. Returns the checkout ID for navigation to the checkout page
+ * 4. Determines if checkout page is required or can be skipped
+ * 5. If checkout can be skipped (free/offline), creates order directly
+ * 6. Returns appropriate result for navigation
  *
  * @param params - The booking action parameters
- * @returns BookResult with the checkoutId
- * @throws Error if validation fails, or booking/checkout creation fails
+ * @returns BookResult with either checkoutId or orderId
+ * @throws Error if validation fails, or booking/checkout/order creation fails
  */
 export async function executeBookAction(params) {
     // Step 0: Validate
@@ -45,16 +51,30 @@ export async function executeBookAction(params) {
     // Step 2: Create checkout
     // businessLocationId: prefer timeSlot.location, fallback to global location
     const firstSelection = params.serviceSelections[0];
-    const businessLocationId = firstSelection?.timeSlot?.location?._id ?? undefined;
+    if (!firstSelection) {
+        throw new Error('No service selection found');
+    }
+    const businessLocationId = firstSelection.timeSlot?.location?._id ?? undefined;
     const checkoutRequest = buildCheckoutRequest({
         bookingId,
         contactDetails,
         businessLocationId,
     });
     const checkoutResponse = await createCheckout(checkoutRequest);
-    const checkoutId = checkoutResponse.checkout?._id;
-    if (!checkoutId) {
+    const checkout = checkoutResponse.checkout;
+    if (!checkout?._id) {
         throw new Error('Failed to create checkout');
     }
-    return { checkoutId };
+    // Step 3: Determine if checkout is required or can be skipped
+    const service = firstSelection.service;
+    if (isCheckoutRequired(checkout, service)) {
+        return { type: BookResultType.CheckoutRequired, checkoutId: checkout._id };
+    }
+    // Step 4: Skip checkout - create order directly
+    const orderResponse = await createOrder(checkout._id);
+    const orderId = orderResponse.orderId;
+    if (!orderId) {
+        throw new Error('Failed to create order');
+    }
+    return { type: BookResultType.CheckoutSkipped, orderId };
 }

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

@@ -1,6 +1,8 @@
 /**
  * Builds the createBooking request from BookActionParams
  */
+import { LocationType as TimeSlotLocationType } from '@wix/auto_sdk_bookings_availability-time-slots';
+import { LocationType as BookingLocationType } from '@wix/auto_sdk_bookings_bookings';
 /**
  * Derives the selected payment option from service payment settings.
  * Maps service.payment.options to booking API's selectedPaymentOption.
@@ -69,7 +71,11 @@ export function buildBookingRequest(params) {
                         ? { _id: resource._id, name: resource.name }
                         : undefined,
                     location: slotLocation
-                        ? { _id: slotLocation._id, name: slotLocation.name }
+                        ? {
+                            _id: slotLocation._id,
+                            name: slotLocation.name,
+                            locationType: mapTimeSlotLocationTypeToBookingLocationType(slotLocation.locationType),
+                        }
                         : undefined,
                 },
             },
@@ -81,3 +87,17 @@ export function buildBookingRequest(params) {
         formSubmission: formSubmission ?? undefined,
     };
 }
+function mapTimeSlotLocationTypeToBookingLocationType(slotLocationType) {
+    switch (slotLocationType) {
+        case TimeSlotLocationType.BUSINESS:
+            return BookingLocationType.OWNER_BUSINESS;
+        case TimeSlotLocationType.CUSTOMER:
+            return BookingLocationType.CUSTOM;
+        case TimeSlotLocationType.CUSTOM:
+            return BookingLocationType.OWNER_CUSTOM;
+        case TimeSlotLocationType.UNKNOWN_LOCATION_TYPE:
+            return BookingLocationType.UNDEFINED;
+        default:
+            return BookingLocationType.OWNER_BUSINESS;
+    }
+}

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

@@ -5,4 +5,5 @@ export { executeBookAction } from './bookAction.js';
 export { canBook, type CanBookParams } from './canBook.js';
 export { buildBookingRequest } from './buildBookingRequest.js';
 export { buildCheckoutRequest, type BuildCheckoutParams, } from './buildCheckoutRequest.js';
-export type { BookProps, BookResult, BookingError, BookActionParams, BookChildProps, } from './types.js';
+export { isCheckoutRequired } from './isCheckoutRequired.js';
+export { BookResultType, type BookProps, type BookResult, type BookingError, type BookActionParams, type BookChildProps, } from './types.js';

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

@@ -5,3 +5,5 @@ export { executeBookAction } from './bookAction.js';
 export { canBook } from './canBook.js';
 export { buildBookingRequest } from './buildBookingRequest.js';
 export { buildCheckoutRequest, } from './buildCheckoutRequest.js';
+export { isCheckoutRequired } from './isCheckoutRequired.js';
+export { BookResultType, } from './types.js';

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

@@ -0,0 +1,20 @@
+/**
+ * Determines if checkout page is required based on payment amounts
+ */
+import type { Checkout } from '@wix/auto_sdk_ecom_checkout';
+import type { Service } from '@wix/auto_sdk_bookings_services';
+/**
+ * Determines if checkout page is required based on payment amounts.
+ *
+ * Skip checkout when:
+ * - Free booking: payNow = 0 AND payLater = 0
+ * - Offline payment: payNow = 0
+ *
+ * Force checkout when:
+ * - Service has cancellation fee
+ *
+ * @param checkout - The checkout response from createCheckout
+ * @param service - The service being booked
+ * @returns true if checkout page is required, false if can skip to order
+ */
+export declare function isCheckoutRequired(checkout: Checkout, service: Service): boolean;

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

@@ -0,0 +1,32 @@
+/**
+ * Determines if checkout page is required based on payment amounts
+ */
+/**
+ * Determines if checkout page is required based on payment amounts.
+ *
+ * Skip checkout when:
+ * - Free booking: payNow = 0 AND payLater = 0
+ * - Offline payment: payNow = 0
+ *
+ * Force checkout when:
+ * - Service has cancellation fee
+ *
+ * @param checkout - The checkout response from createCheckout
+ * @param service - The service being booked
+ * @returns true if checkout page is required, false if can skip to order
+ */
+export function isCheckoutRequired(checkout, service) {
+    // Force checkout for cancellation fee
+    const hasCancellationFee = service.bookingPolicy?.cancellationPolicy?.enabled;
+    if (hasCancellationFee) {
+        return true;
+    }
+    const payNowAmount = Number(checkout.payNow?.total?.amount ?? 0);
+    const payLaterAmount = Number(checkout.payLater?.total?.amount ?? 0);
+    // Free or price plan: both amounts are 0
+    const isFreeOrPricePlan = payNowAmount === 0 && payLaterAmount === 0;
+    // Offline payment: payNow is 0
+    const isOfflinePayment = payNowAmount === 0;
+    // Skip checkout if free/price plan OR offline payment
+    return !(isFreeOrPricePlan || isOfflinePayment);
+}

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

@@ -4,11 +4,22 @@
 import type { ServiceSelection } from '../booking.js';
 import type { FormValues } from '@wix/form-public';
 import type { Location as TimeSlotLocationType } from '@wix/auto_sdk_bookings_availability-time-slots';
+/**
+ * Enum for book result types
+ */
+export declare enum BookResultType {
+    CheckoutRequired = "checkout_required",
+    CheckoutSkipped = "checkout_skipped"
+}
 /**
  * Result returned from the book action
  */
 export type BookResult = {
+    type: BookResultType.CheckoutRequired;
     checkoutId: string;
+} | {
+    type: BookResultType.CheckoutSkipped;
+    orderId: string;
 };
 /**
  * Error object for booking errors
@@ -46,6 +57,11 @@ export interface BookProps {
     label?: string;
     loadingState?: string;
     disabled?: boolean;
-    onCheckoutRequired?: (result: BookResult) => void;
+    onCheckout?: (result: {
+        checkoutId: string;
+    }) => void;
+    onComplete?: (result: {
+        orderId: string;
+    }) => void;
     onError?: (error: BookingError) => void;
 }

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

@@ -1,4 +1,11 @@
 /**
  * Types for the Book action
  */
-export {};
+/**
+ * Enum for book result types
+ */
+export var BookResultType;
+(function (BookResultType) {
+    BookResultType["CheckoutRequired"] = "checkout_required";
+    BookResultType["CheckoutSkipped"] = "checkout_skipped";
+})(BookResultType || (BookResultType = {}));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/headless-bookings",
-  "version": "0.0.47",
+  "version": "0.0.49",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -72,5 +72,5 @@
       "groupId": "com.wixpress.headless-components"
     }
   },
-  "falconPackageHash": "b4efe3be968a8e8d6806b0e818d5e30742584c3d834296262bc1572f"
+  "falconPackageHash": "ce9857f84a2dc23726f81fe1b20c314c9c652cbe712b90742c92d448"
 }