@wix/headless-bookings 0.0.117 → 1.0.0

package/cjs/dist/api/calculate-cart/index.d.ts

@@ -0,0 +1,3 @@
+import { type CalculateCartOptions, type CalculateCartResponse } from '@wix/auto_sdk_ecom_cart-v-2';
+export declare function calculateCart(cartId: string, options?: CalculateCartOptions): Promise<CalculateCartResponse>;
+export type { CalculateCartResponse, CartSummary, } from '@wix/auto_sdk_ecom_cart-v-2';

package/cjs/dist/api/calculate-cart/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calculateCart = calculateCart;
+const auto_sdk_ecom_cart_v_2_1 = require("@wix/auto_sdk_ecom_cart-v-2");
+async function calculateCart(cartId, options) {
+    return (0, auto_sdk_ecom_cart_v_2_1.calculateCart)(cartId, options);
+}

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

@@ -0,0 +1,3 @@
+import { type CreateCartOptions, type Cart } from '@wix/auto_sdk_ecom_cart-v-2';
+export declare function createCart(options?: CreateCartOptions): Promise<Cart>;
+export { ChannelType, type CreateCartOptions, type Cart, } from '@wix/auto_sdk_ecom_cart-v-2';

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

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChannelType = void 0;
+exports.createCart = createCart;
+const auto_sdk_ecom_cart_v_2_1 = require("@wix/auto_sdk_ecom_cart-v-2");
+async function createCart(options) {
+    return (0, auto_sdk_ecom_cart_v_2_1.createCart)(options);
+}
+var auto_sdk_ecom_cart_v_2_2 = require("@wix/auto_sdk_ecom_cart-v-2");
+Object.defineProperty(exports, "ChannelType", { enumerable: true, get: function () { return auto_sdk_ecom_cart_v_2_2.ChannelType; } });

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

@@ -7,14 +7,8 @@
 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 { createCheckout, ChannelType, type CreateCheckoutRequest, type CreateCheckoutResponse, } from './create-checkout/index.js';
-export { createOrder, type CreateOrderOptions, type CreateOrderResponse, } from './create-order/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';
 export { queryLocations, getLocationById, type QueryLocationsResult, type LocationData, } from './query-locations/index.js';
 export { queryCategories, type QueryCategoriesResult, type Category, } from './query-categories/index.js';
-/**
- * PagingMetadata includes:
- * - limit: Number of items per page
- * - offset: Number of items to skip
- * - count: Number of items returned in the current page
- * - hasNext: Whether there are more services available to load
- */

package/cjs/dist/api/index.js

@@ -6,7 +6,7 @@
  * @module API
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.queryCategories = exports.getLocationById = exports.queryLocations = exports.createOrder = exports.ChannelType = exports.createCheckout = exports.createBooking = exports.fetchAvailability = exports.SYNTHETIC_CUSTOMER_ID = exports.SYNTHETIC_CUSTOM_ID = exports.convertPlatformFilterToApiFilter = exports.queryServices = exports.getServiceBySlug = exports.getServiceById = void 0;
+exports.queryCategories = exports.getLocationById = exports.queryLocations = exports.placeOrder = exports.calculateCart = exports.ChannelType = exports.createCart = exports.createBooking = exports.fetchAvailability = exports.SYNTHETIC_CUSTOMER_ID = exports.SYNTHETIC_CUSTOM_ID = exports.convertPlatformFilterToApiFilter = exports.queryServices = exports.getServiceBySlug = exports.getServiceById = void 0;
 var index_js_1 = require("./query-services/index.js");
 Object.defineProperty(exports, "getServiceById", { enumerable: true, get: function () { return index_js_1.getServiceById; } });
 Object.defineProperty(exports, "getServiceBySlug", { enumerable: true, get: function () { return index_js_1.getServiceBySlug; } });
@@ -18,20 +18,15 @@ var index_js_2 = require("./fetch-availability/index.js");
 Object.defineProperty(exports, "fetchAvailability", { enumerable: true, get: function () { return index_js_2.fetchAvailability; } });
 var index_js_3 = require("./create-booking/index.js");
 Object.defineProperty(exports, "createBooking", { enumerable: true, get: function () { return index_js_3.createBooking; } });
-var index_js_4 = require("./create-checkout/index.js");
-Object.defineProperty(exports, "createCheckout", { enumerable: true, get: function () { return index_js_4.createCheckout; } });
+var index_js_4 = require("./create-cart/index.js");
+Object.defineProperty(exports, "createCart", { enumerable: true, get: function () { return index_js_4.createCart; } });
 Object.defineProperty(exports, "ChannelType", { enumerable: true, get: function () { return index_js_4.ChannelType; } });
-var index_js_5 = require("./create-order/index.js");
-Object.defineProperty(exports, "createOrder", { enumerable: true, get: function () { return index_js_5.createOrder; } });
-var index_js_6 = require("./query-locations/index.js");
-Object.defineProperty(exports, "queryLocations", { enumerable: true, get: function () { return index_js_6.queryLocations; } });
-Object.defineProperty(exports, "getLocationById", { enumerable: true, get: function () { return index_js_6.getLocationById; } });
-var index_js_7 = require("./query-categories/index.js");
-Object.defineProperty(exports, "queryCategories", { enumerable: true, get: function () { return index_js_7.queryCategories; } });
-/**
- * PagingMetadata includes:
- * - limit: Number of items per page
- * - offset: Number of items to skip
- * - count: Number of items returned in the current page
- * - hasNext: Whether there are more services available to load
- */
+var index_js_5 = require("./calculate-cart/index.js");
+Object.defineProperty(exports, "calculateCart", { enumerable: true, get: function () { return index_js_5.calculateCart; } });
+var index_js_6 = require("./place-order/index.js");
+Object.defineProperty(exports, "placeOrder", { enumerable: true, get: function () { return index_js_6.placeOrder; } });
+var index_js_7 = require("./query-locations/index.js");
+Object.defineProperty(exports, "queryLocations", { enumerable: true, get: function () { return index_js_7.queryLocations; } });
+Object.defineProperty(exports, "getLocationById", { enumerable: true, get: function () { return index_js_7.getLocationById; } });
+var index_js_8 = require("./query-categories/index.js");
+Object.defineProperty(exports, "queryCategories", { enumerable: true, get: function () { return index_js_8.queryCategories; } });

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

@@ -0,0 +1,3 @@
+import { type PlaceOrderOptions, type PlaceOrderResponse } from '@wix/auto_sdk_ecom_cart-v-2';
+export declare function placeOrder(cartId: string, options?: PlaceOrderOptions): Promise<PlaceOrderResponse>;
+export type { PlaceOrderOptions, PlaceOrderResponse, } from '@wix/auto_sdk_ecom_cart-v-2';

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

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.placeOrder = placeOrder;
+const auto_sdk_ecom_cart_v_2_1 = require("@wix/auto_sdk_ecom_cart-v-2");
+async function placeOrder(cartId, options) {
+    return (0, auto_sdk_ecom_cart_v_2_1.placeOrder)(cartId, options);
+}

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

@@ -99,7 +99,7 @@ exports.Book = react_1.default.forwardRef((props, ref) => {
     return ((0, jsx_runtime_1.jsx)(CoreBook.Book, { onCheckout: (result) => {
             // Create navigateToCheckout with checkoutId captured
             const navigateToCheckout = (options) => (0, navigation_js_1.navigateToCheckout)({
-                checkoutId: result.checkoutId,
+                cartId: result.cartId,
                 navigationInfo: { postFlowUrl: options.postFlowUrl },
             });
             // Return user's callback result so core can await it

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

@@ -24,7 +24,7 @@ export interface BookProps {
      * Return a Promise to keep loading state active until it resolves.
      */
     onCheckout?: (result: {
-        checkoutId: string;
+        cartId: string;
     }) => void | Promise<unknown>;
     /**
      * Called when booking completes without requiring checkout.

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

@@ -52,7 +52,7 @@ function Book(props) {
         try {
             const result = await bookingService.actions.book();
             if (result.type === types_js_1.BookResultType.CheckoutRequired) {
-                await onCheckout?.({ checkoutId: result.checkoutId });
+                await onCheckout?.({ cartId: result.cartId });
             }
             else {
                 await onComplete?.({ orderId: result.orderId });

package/cjs/dist/react/core/payment/Payment.d.ts

@@ -4,7 +4,7 @@
  * Note: Currently supports single service only
  */
 import React from 'react';
-import { type PaymentServiceConfig, type PricingServiceSelection } from '../../../services/payment/payment.js';
+import { type PaymentServiceConfig, type PricingServiceSelection, type ServicePaymentOptions } from '../../../services/payment/payment.js';
 import type { MoneyData } from '@wix/headless-components/react';
 /**
  * Props for Payment.Root component
@@ -164,6 +164,19 @@ export interface LineItemProviderProps {
  * ```
  */
 export declare function LineItemProvider(props: LineItemProviderProps): React.ReactNode;
+/**
+ * Props for ServiceOptions render prop component
+ */
+export interface ServiceOptionsProps {
+    children: (options: ServicePaymentOptions) => React.ReactNode;
+}
+/**
+ * Core component that exposes service payment options via render props.
+ * Reads isOnline, isInPerson, isDeposit from the payment service signal.
+ *
+ * @component
+ */
+export declare function ServiceOptions(props: ServiceOptionsProps): React.ReactNode;
 /**
  * Props for LineItemInfo render prop component
  */

package/cjs/dist/react/core/payment/Payment.js

@@ -8,6 +8,7 @@ exports.Data = Data;
 exports.LineItems = LineItems;
 exports.useLineItemContext = useLineItemContext;
 exports.LineItemProvider = LineItemProvider;
+exports.ServiceOptions = ServiceOptions;
 exports.LineItemInfo = LineItemInfo;
 const jsx_runtime_1 = require("react/jsx-runtime");
 /**
@@ -199,6 +200,17 @@ function LineItemProvider(props) {
     };
     return ((0, jsx_runtime_1.jsx)(LineItemContext.Provider, { value: contextValue, children: children }));
 }
+/**
+ * Core component that exposes service payment options via render props.
+ * Reads isOnline, isInPerson, isDeposit from the payment service signal.
+ *
+ * @component
+ */
+function ServiceOptions(props) {
+    const paymentService = (0, services_manager_react_1.useService)(payment_js_1.PaymentServiceDefinition);
+    const serviceOptions = paymentService.serviceOptionsSignal.get();
+    return props.children(serviceOptions);
+}
 /**
  * Core component that provides access to line item info via render props.
  * Must be used within LineItemProvider.

package/cjs/dist/react/payment/Payment.d.ts

@@ -5,7 +5,7 @@
 import React from 'react';
 import { AsChildChildren } from '@wix/headless-utils/react';
 import { MoneyData } from '@wix/headless-components/react';
-import type { PaymentServiceConfig, PricingServiceSelection } from '../../services/payment/payment.js';
+import type { PaymentServiceConfig, PricingServiceSelection, ServicePaymentOptions } from '../../services/payment/payment.js';
 export declare const TestIds: {
     readonly paymentRoot: "payment-root";
     readonly paymentSubtotal: "payment-subtotal";
@@ -19,6 +19,7 @@ export declare const TestIds: {
     readonly paymentLineItemTotal: "payment-line-item-total";
     readonly paymentLineItemSubtotal: "payment-line-item-subtotal";
     readonly paymentLineItemDeposit: "payment-line-item-deposit";
+    readonly paymentServiceOptions: "payment-service-options";
 };
 /**
  * Props for Payment.Root component
@@ -194,6 +195,41 @@ export interface PayLaterProps extends Omit<React.HTMLAttributes<HTMLElement>, '
  * ```
  */
 export declare const PayLater: React.ForwardRefExoticComponent<PayLaterProps & React.RefAttributes<HTMLElement>>;
+/**
+ * Props for Payment.ServiceOptions component
+ */
+export interface ServiceOptionsProps {
+    asChild?: boolean;
+    /** Render prop receiving service payment options. This component renders no
+     * visible DOM element by default — it is a flags-only data component. */
+    children?: AsChildChildren<ServicePaymentOptions>;
+}
+/**
+ * Exposes service payment options via render props.
+ * Use this to determine which payment scenario to render without reading the service entity directly.
+ *
+ * Payment scenarios:
+ * - `isOnline=true, isInPerson=false, isDeposit=false` → Pay now only (Due now = total)
+ * - `isOnline=true, isInPerson=false, isDeposit=true` → Pay now + security deposit
+ * - `isOnline=true, isInPerson=true` → Radio: Pay Online / Pay on Arrival
+ * - `isOnline=false, isInPerson=true` → Pay on arrival only
+ *
+ * @component
+ * Note: This component renders no visible DOM element. It is a flags-only data
+ * component — use `asChild` with a render function to consume the flags.
+ * For the actual split amounts (deposit / pay-later), use `Payment.PayNow` and
+ * `Payment.PayLater`.
+ *
+ * @example
+ * ```tsx
+ * <Payment.ServiceOptions asChild>
+ *   {({ isOnline, isInPerson, isDeposit }) => (
+ *     // render the correct payment scenario
+ *   )}
+ * </Payment.ServiceOptions>
+ * ```
+ */
+export declare const ServiceOptions: React.ForwardRefExoticComponent<ServiceOptionsProps & React.RefAttributes<HTMLElement>>;
 /**
  * Props for Payment.LineItems component (Container Level)
  */

package/cjs/dist/react/payment/Payment.js

@@ -36,7 +36,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LineItemDeposit = exports.LineItemSubtotal = exports.LineItemTotal = exports.LineItemRepeater = exports.LineItemsList = exports.LineItems = exports.PayLater = exports.PayNow = exports.Total = exports.Tax = exports.Subtotal = exports.Root = exports.TestIds = void 0;
+exports.LineItemDeposit = exports.LineItemSubtotal = exports.LineItemTotal = exports.LineItemRepeater = exports.LineItemsList = exports.LineItems = exports.ServiceOptions = exports.PayLater = exports.PayNow = exports.Total = exports.Tax = exports.Subtotal = exports.Root = exports.TestIds = void 0;
 const jsx_runtime_1 = require("react/jsx-runtime");
 /**
  * Payment - High-level component for displaying payment information
@@ -59,6 +59,7 @@ exports.TestIds = {
     paymentLineItemTotal: 'payment-line-item-total',
     paymentLineItemSubtotal: 'payment-line-item-subtotal',
     paymentLineItemDeposit: 'payment-line-item-deposit',
+    paymentServiceOptions: 'payment-service-options',
 };
 /**
  * Root component that provides payment context to the entire app.
@@ -200,6 +201,36 @@ exports.PayLater = react_1.default.forwardRef((props, ref) => {
     return ((0, jsx_runtime_1.jsx)(CorePayment.Data, { children: ({ payLater, isDeposit }) => ((0, jsx_runtime_1.jsx)(react_2.AsChildSlot, { ref: ref, asChild: asChild, className: className, customElement: children, customElementProps: { payLater, isDeposit }, "data-testid": exports.TestIds.paymentPayLater, "data-has-deposit": isDeposit, children: isDeposit && payLater && payLater.amount > 0 && ((0, jsx_runtime_1.jsx)(react_3.Money, { money: payLater })) })) }));
 });
 exports.PayLater.displayName = 'Payment.PayLater';
+/**
+ * Exposes service payment options via render props.
+ * Use this to determine which payment scenario to render without reading the service entity directly.
+ *
+ * Payment scenarios:
+ * - `isOnline=true, isInPerson=false, isDeposit=false` → Pay now only (Due now = total)
+ * - `isOnline=true, isInPerson=false, isDeposit=true` → Pay now + security deposit
+ * - `isOnline=true, isInPerson=true` → Radio: Pay Online / Pay on Arrival
+ * - `isOnline=false, isInPerson=true` → Pay on arrival only
+ *
+ * @component
+ * Note: This component renders no visible DOM element. It is a flags-only data
+ * component — use `asChild` with a render function to consume the flags.
+ * For the actual split amounts (deposit / pay-later), use `Payment.PayNow` and
+ * `Payment.PayLater`.
+ *
+ * @example
+ * ```tsx
+ * <Payment.ServiceOptions asChild>
+ *   {({ isOnline, isInPerson, isDeposit }) => (
+ *     // render the correct payment scenario
+ *   )}
+ * </Payment.ServiceOptions>
+ * ```
+ */
+exports.ServiceOptions = react_1.default.forwardRef((props, ref) => {
+    const { asChild, children } = props;
+    return ((0, jsx_runtime_1.jsx)(CorePayment.ServiceOptions, { children: ({ isOnline, isInPerson, isDeposit }) => ((0, jsx_runtime_1.jsx)(react_2.AsChildSlot, { ref: ref, asChild: asChild, customElement: children, customElementProps: { isOnline, isInPerson, isDeposit }, "data-testid": exports.TestIds.paymentServiceOptions, "data-is-online": isOnline, "data-is-in-person": isInPerson, "data-is-deposit": isDeposit, children: null })) }));
+});
+exports.ServiceOptions.displayName = 'Payment.ServiceOptions';
 /**
  * Container component for line items.
  * Follows the 3-level List/Options/Repeater pattern.

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

@@ -1,24 +1,2 @@
-/**
- * Book Action - Orchestrates the booking flow
- *
- * 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. Determines if checkout is required or can be skipped
- * 5. Returns appropriate result for navigation
- */
 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. 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 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

@@ -1,38 +1,16 @@
 "use strict";
-/**
- * Book Action - Orchestrates the booking flow
- *
- * 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. Determines if checkout is required or can be skipped
- * 5. Returns appropriate result for navigation
- */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.executeBookAction = executeBookAction;
 const index_js_1 = require("../../../api/create-booking/index.js");
-const index_js_2 = require("../../../api/create-checkout/index.js");
-const index_js_3 = require("../../../api/create-order/index.js");
+const index_js_2 = require("../../../api/create-cart/index.js");
+const index_js_3 = require("../../../api/calculate-cart/index.js");
+const index_js_4 = require("../../../api/place-order/index.js");
 const buildBookingRequest_js_1 = require("./buildBookingRequest.js");
-const buildCheckoutRequest_js_1 = require("./buildCheckoutRequest.js");
+const buildCartRequest_js_1 = require("./buildCartRequest.js");
 const canBook_js_1 = require("./canBook.js");
 const isCheckoutRequired_js_1 = require("./isCheckoutRequired.js");
 const types_js_1 = require("./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. 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 either checkoutId or orderId
- * @throws Error if validation fails, or booking/checkout/order creation fails
- */
 async function executeBookAction(params) {
-    // Step 0: Validate
     if (!(0, canBook_js_1.canBook)({
         serviceSelections: params.serviceSelections,
         formSubmission: params.formSubmission,
@@ -51,34 +29,37 @@ async function executeBookAction(params) {
     if (!bookingId) {
         throw new Error('Failed to create booking');
     }
-    // Step 2: Create checkout
-    // businessLocationId: prefer timeSlot.location, fallback to global location
+    // Step 2: Create cart
     const firstSelection = params.serviceSelections[0];
     if (!firstSelection) {
         throw new Error('No service selection found');
     }
     const businessLocationId = firstSelection.timeSlot?.location?._id ?? undefined;
-    const checkoutRequest = (0, buildCheckoutRequest_js_1.buildCheckoutRequest)({
+    const cartRequest = (0, buildCartRequest_js_1.buildCartRequest)({
         bookingId,
         contactDetails,
         businessLocationId,
         appId: params.appId,
     });
-    const checkoutResponse = await (0, index_js_2.createCheckout)(checkoutRequest);
-    const checkout = checkoutResponse.checkout;
-    if (!checkout?._id) {
-        throw new Error('Failed to create checkout');
+    const cart = await (0, index_js_2.createCart)(cartRequest);
+    if (!cart._id) {
+        throw new Error('Failed to create cart');
     }
-    // Step 3: Determine if checkout is required or can be skipped
+    // Step 3: Calculate cart to get totals (not stored on Cart V2 entity)
+    const { cart: calculatedCart, summary } = await (0, index_js_3.calculateCart)(cart._id);
+    if (!calculatedCart || !summary) {
+        throw new Error('Failed to calculate cart');
+    }
+    // Step 4: Determine if checkout is required or can be skipped
     const service = firstSelection.service;
-    if ((0, isCheckoutRequired_js_1.isCheckoutRequired)(checkout, service)) {
-        return { type: types_js_1.BookResultType.CheckoutRequired, checkoutId: checkout._id };
+    if ((0, isCheckoutRequired_js_1.isCheckoutRequired)(calculatedCart, summary, service)) {
+        return { type: types_js_1.BookResultType.CheckoutRequired, cartId: cart._id };
     }
-    // Step 4: Skip checkout - create order directly
-    const orderResponse = await (0, index_js_3.createOrder)(checkout._id);
+    // Step 5: Skip checkout — place order directly
+    const orderResponse = await (0, index_js_4.placeOrder)(cart._id);
     const orderId = orderResponse.orderId;
     if (!orderId) {
-        throw new Error('Failed to create order');
+        throw new Error('Failed to place order');
     }
     return { type: types_js_1.BookResultType.CheckoutSkipped, orderId };
 }

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

@@ -0,0 +1,10 @@
+import { type CreateCartOptions } from '../../../api/create-cart/index.js';
+import type { ContactDetails } from '../../../api/create-booking/index.js';
+export interface BuildCartParams {
+    bookingId: string;
+    contactDetails?: ContactDetails;
+    businessLocationId?: string;
+    /** Optional app ID override for the catalog reference. Defaults to BOOKING_APP_ID. */
+    appId?: string;
+}
+export declare function buildCartRequest(params: BuildCartParams): CreateCartOptions;

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

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildCartRequest = buildCartRequest;
+const index_js_1 = require("../../../api/create-cart/index.js");
+const constants_js_1 = require("../../constants.js");
+function buildCartRequest(params) {
+    const { bookingId, contactDetails, businessLocationId, appId } = params;
+    const cart = {
+        source: { channelType: index_js_1.ChannelType.WEB },
+    };
+    if (businessLocationId) {
+        cart.businessInfo = { locationId: businessLocationId };
+    }
+    if (contactDetails) {
+        cart.customerInfo = {
+            ...(contactDetails.email ? { email: contactDetails.email } : {}),
+        };
+        if (contactDetails.fullAddress?.country) {
+            cart.deliveryInfo = { address: { ...contactDetails.fullAddress } };
+            cart.paymentInfo = {
+                billingAddress: { ...contactDetails.fullAddress },
+            };
+        }
+    }
+    return {
+        catalogItems: [
+            {
+                quantity: 1,
+                catalogReference: {
+                    catalogItemId: bookingId,
+                    appId: appId ?? constants_js_1.BOOKING_APP_ID,
+                },
+            },
+        ],
+        cart,
+    };
+}

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

@@ -4,6 +4,6 @@
 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 { 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';

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

@@ -3,15 +3,15 @@
  * Book Action - Exports
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BookResultType = exports.isCheckoutRequired = exports.buildCheckoutRequest = exports.buildBookingRequest = exports.canBook = exports.executeBookAction = void 0;
+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 buildCheckoutRequest_js_1 = require("./buildCheckoutRequest.js");
-Object.defineProperty(exports, "buildCheckoutRequest", { enumerable: true, get: function () { return buildCheckoutRequest_js_1.buildCheckoutRequest; } });
+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");

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

@@ -1,20 +1,4 @@
-/**
- * Determines if checkout page is required based on payment amounts
- */
-import type { Checkout } from '@wix/auto_sdk_ecom_checkout';
+import type { Cart } from '../../../api/create-cart/index.js';
+import type { CartSummary } from '../../../api/calculate-cart/index.js';
 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 policy
- *
- * @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;
+export declare function isCheckoutRequired(cart: Cart, summary: CartSummary, service: Service): boolean;

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

@@ -1,35 +1,17 @@
 "use strict";
-/**
- * Determines if checkout page is required based on payment amounts
- */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isCheckoutRequired = isCheckoutRequired;
-/**
- * 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 policy
- *
- * @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
- */
-function isCheckoutRequired(checkout, service) {
-    // Force checkout for cancellation fee policy
-    const hasCancellationFee = service.bookingPolicy?.cancellationFeePolicy?.enabled;
-    if (hasCancellationFee) {
+function isCheckoutRequired(cart, summary, service) {
+    if (service.bookingPolicy?.cancellationFeePolicy?.enabled) {
         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);
+    const total = Number(summary.priceSummary?.total?.amount ?? 0);
+    if (total === 0) {
+        return false;
+    }
+    const paymentOption = cart.lineItems?.[0]?.paymentConfig?.paymentOption;
+    if (paymentOption === 'FULL_PAYMENT_OFFLINE') {
+        return false;
+    }
+    return true;
 }

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

@@ -16,7 +16,7 @@ export declare enum BookResultType {
  */
 export type BookResult = {
     type: BookResultType.CheckoutRequired;
-    checkoutId: string;
+    cartId: string;
 } | {
     type: BookResultType.CheckoutSkipped;
     orderId: string;

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

@@ -7,8 +7,8 @@ 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, buildCheckoutRequest, type CanBookParams, type BookResult, type BookingError, type BookActionParams, type BookChildProps, type BookProps, type BuildCheckoutParams, } from './booking/book-action/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 { 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, loadPaymentConfig, type SuccessPaymentConfigResult, type ErrorPaymentConfigResult, } from './payment/payment.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';
 export { StaffMemberListService, StaffMemberListServiceDefinition, loadStaffMemberListServiceInitialData, staffMemberListServiceBinding, type StaffMemberListServiceAPI, type StaffMemberListServiceConfig, type StaffMemberListActions, type StaffMemberData, type LoadStaffMemberListServiceResult, } from './staff-member-list/staff-member-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.buildCheckoutRequest = 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.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; } });
@@ -30,7 +30,7 @@ var index_js_3 = require("./booking/book-action/index.js");
 Object.defineProperty(exports, "executeBookAction", { enumerable: true, get: function () { return index_js_3.executeBookAction; } });
 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, "buildCheckoutRequest", { enumerable: true, get: function () { return index_js_3.buildCheckoutRequest; } });
+Object.defineProperty(exports, "buildCartRequest", { enumerable: true, get: function () { return index_js_3.buildCartRequest; } });
 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; } });