@wix/headless-bookings 1.0.17 → 1.0.19

package/dist/__mocks__/services/services-mocks.js

@@ -535,6 +535,97 @@ export const mockServiceWithDeposit = {
         },
     },
 };
+/** Deposit set as a fixed amount under `depositDetails`, the newer field. */
+export const mockServiceDepositDetailsAmount = {
+    ...mockService,
+    _id: 'test-service-deposit-details-amount',
+    name: 'Deposit Details Amount Service',
+    payment: {
+        rateType: RateType.FIXED,
+        fixed: {
+            price: {
+                value: '100.00',
+                currency: 'USD',
+            },
+            depositDetails: {
+                amount: {
+                    value: '25.00',
+                    currency: 'USD',
+                },
+            },
+        },
+        options: {
+            online: true,
+            deposit: true,
+        },
+    },
+};
+/** Percentage deposit: `options.deposit` set, no amount anywhere on the entity. */
+export const mockServicePercentageDeposit = {
+    ...mockService,
+    _id: 'test-service-percentage-deposit',
+    name: 'Percentage Deposit Service',
+    payment: {
+        rateType: RateType.FIXED,
+        fixed: {
+            price: {
+                value: '10',
+                currency: 'USD',
+            },
+            fullUpfrontPaymentAllowed: true,
+        },
+        options: {
+            online: true,
+            inPerson: false,
+            deposit: true,
+        },
+    },
+};
+/**
+ * Mock service with a deposit that may also be paid in full upfront — the only
+ * configuration where `booking.depositSelected` may be `false`.
+ */
+export const mockServiceWithDepositFullUpfront = {
+    ...mockService,
+    _id: 'test-service-deposit-full-upfront',
+    name: 'Service with Deposit and Full Upfront Allowed',
+    payment: {
+        rateType: RateType.FIXED,
+        fixed: {
+            price: {
+                value: '100.00',
+                currency: 'USD',
+            },
+            deposit: {
+                value: '30.00',
+                currency: 'USD',
+            },
+            fullUpfrontPaymentAllowed: true,
+        },
+    },
+};
+/**
+ * Mock VARIED-rate service with a deposit (both under `payment.varied`).
+ */
+export const mockServiceVariedWithDeposit = {
+    ...mockService,
+    _id: 'test-service-varied-deposit',
+    name: 'Varied Service with Deposit',
+    payment: {
+        rateType: RateType.VARIED,
+        varied: {
+            defaultPrice: {
+                value: '80.00',
+                currency: 'USD',
+            },
+            deposit: {
+                value: '20.00',
+                currency: 'USD',
+            },
+            fullUpfrontPaymentAllowed: true,
+        },
+    },
+};
 /**
  * Mock service with in-person payment option
  */

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

@@ -45,6 +45,12 @@ export interface BookingData {
      * heuristic applies. Set via `actions.setSelectedPaymentOption`.
      */
     selectedPaymentOption: SelectedPaymentOption | undefined;
+    /**
+     * Deposit-vs-full-upfront choice. `true` pays only the deposit now, `false`
+     * pays the full price now, `undefined` means not chosen. Set via
+     * `actions.setDepositSelected`.
+     */
+    depositSelected: boolean | undefined;
     actions: BookingServiceActions;
 }
 /**

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

@@ -106,6 +106,7 @@ export function Data(props) {
     const timezone = bookingService.timezone.get();
     const formSubmission = bookingService.formSubmission.get();
     const selectedPaymentOption = bookingService.selectedPaymentOption.get();
+    const depositSelected = bookingService.depositSelected.get();
     const { actions } = bookingService;
     const location = resolveLocation(bookingLocation, serviceSelections);
     return children({
@@ -114,6 +115,7 @@ export function Data(props) {
         timezone,
         formSubmission,
         selectedPaymentOption,
+        depositSelected,
         actions,
     });
 }

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

@@ -172,7 +172,8 @@ export interface ServiceOptionsProps {
 }
 /**
  * Core component that exposes service payment options via render props.
- * Reads isOnline, isInPerson, isDeposit from the payment service signal.
+ * Reads isOnline, isInPerson, isDeposit, canPayFullUpfront from the payment
+ * service signal.
  *
  * @component
  */

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

@@ -81,10 +81,12 @@ export function Data(props) {
     const additionalInfoList = paymentDetails?.additionalInfo?.lineItems || [];
     const firstLineItemInfo = additionalInfoList[0];
     const customPrice = firstLineItemInfo?.customPrice || null;
-    // Computed flags
-    const hasTax = tax !== null && tax.amount > 0;
-    const hasDiscount = discount !== null && discount.amount > 0;
-    const isDeposit = payNow !== null && total !== null && payNow.amount < total.amount;
+    // Computed flags (amounts may be strings — compare numerically)
+    const hasTax = tax !== null && Number(tax.amount) > 0;
+    const hasDiscount = discount !== null && Number(discount.amount) > 0;
+    const isDeposit = payNow !== null &&
+        total !== null &&
+        Number(payNow.amount) < Number(total.amount);
     return props.children({
         subtotal,
         total,
@@ -190,7 +192,8 @@ export function LineItemProvider(props) {
 }
 /**
  * Core component that exposes service payment options via render props.
- * Reads isOnline, isInPerson, isDeposit from the payment service signal.
+ * Reads isOnline, isInPerson, isDeposit, canPayFullUpfront from the payment
+ * service signal.
  *
  * @component
  */
@@ -217,9 +220,9 @@ export function ServiceOptions(props) {
  */
 export function LineItemInfo(props) {
     const { lineItem, currency } = useLineItemContext();
-    // Computed flags
-    const hasDiscount = lineItem.discount !== null && lineItem.discount.amount > 0;
-    const hasDeposit = lineItem.deposit !== null && lineItem.deposit.amount > 0;
+    // Computed flags (amounts may be strings — compare numerically)
+    const hasDiscount = lineItem.discount !== null && Number(lineItem.discount.amount) > 0;
+    const hasDeposit = lineItem.deposit !== null && Number(lineItem.deposit.amount) > 0;
     return props.children({
         lineItem,
         currency,

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

@@ -210,7 +210,8 @@ export interface ServiceOptionsProps {
  *
  * 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=false, isDeposit=true, canPayFullUpfront=false` → Pay now + security deposit
+ * - `isOnline=true, isInPerson=false, isDeposit=true, canPayFullUpfront=true` → Radio: Pay deposit now / Pay in full now
  * - `isOnline=true, isInPerson=true` → Radio: Pay Online / Pay on Arrival
  * - `isOnline=false, isInPerson=true` → Pay on arrival only
  *
@@ -223,7 +224,7 @@ export interface ServiceOptionsProps {
  * @example
  * ```tsx
  * <Payment.ServiceOptions asChild>
- *   {({ isOnline, isInPerson, isDeposit }) => (
+ *   {({ isOnline, isInPerson, isDeposit, canPayFullUpfront }) => (
  *     // render the correct payment scenario
  *   )}
  * </Payment.ServiceOptions>

package/dist/react/payment/Payment.js

@@ -144,7 +144,7 @@ Total.displayName = 'Payment.Total';
  */
 export const PayNow = React.forwardRef((props, ref) => {
     const { asChild, children, className } = props;
-    return (_jsx(CorePayment.Data, { children: ({ payNow, isDeposit }) => (_jsx(AsChildSlot, { ref: ref, asChild: asChild, className: className, customElement: children, customElementProps: { payNow, isDeposit }, "data-testid": TestIds.paymentPayNow, "data-has-deposit": isDeposit, children: isDeposit && payNow && payNow.amount > 0 && (_jsx(Money, { money: payNow })) })) }));
+    return (_jsx(CorePayment.Data, { children: ({ payNow, isDeposit }) => (_jsx(AsChildSlot, { ref: ref, asChild: asChild, className: className, customElement: children, customElementProps: { payNow, isDeposit }, "data-testid": TestIds.paymentPayNow, "data-has-deposit": isDeposit, children: isDeposit && payNow && Number(payNow.amount) > 0 && (_jsx(Money, { money: payNow })) })) }));
 });
 PayNow.displayName = 'Payment.PayNow';
 /**
@@ -159,7 +159,7 @@ PayNow.displayName = 'Payment.PayNow';
  */
 export const PayLater = React.forwardRef((props, ref) => {
     const { asChild, children, className } = props;
-    return (_jsx(CorePayment.Data, { children: ({ payLater, isDeposit }) => (_jsx(AsChildSlot, { ref: ref, asChild: asChild, className: className, customElement: children, customElementProps: { payLater, isDeposit }, "data-testid": TestIds.paymentPayLater, "data-has-deposit": isDeposit, children: isDeposit && payLater && payLater.amount > 0 && (_jsx(Money, { money: payLater })) })) }));
+    return (_jsx(CorePayment.Data, { children: ({ payLater, isDeposit }) => (_jsx(AsChildSlot, { ref: ref, asChild: asChild, className: className, customElement: children, customElementProps: { payLater, isDeposit }, "data-testid": TestIds.paymentPayLater, "data-has-deposit": isDeposit, children: isDeposit && payLater && Number(payLater.amount) > 0 && (_jsx(Money, { money: payLater })) })) }));
 });
 PayLater.displayName = 'Payment.PayLater';
 /**
@@ -168,7 +168,8 @@ PayLater.displayName = 'Payment.PayLater';
  *
  * 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=false, isDeposit=true, canPayFullUpfront=false` → Pay now + security deposit
+ * - `isOnline=true, isInPerson=false, isDeposit=true, canPayFullUpfront=true` → Radio: Pay deposit now / Pay in full now
  * - `isOnline=true, isInPerson=true` → Radio: Pay Online / Pay on Arrival
  * - `isOnline=false, isInPerson=true` → Pay on arrival only
  *
@@ -181,7 +182,7 @@ PayLater.displayName = 'Payment.PayLater';
  * @example
  * ```tsx
  * <Payment.ServiceOptions asChild>
- *   {({ isOnline, isInPerson, isDeposit }) => (
+ *   {({ isOnline, isInPerson, isDeposit, canPayFullUpfront }) => (
  *     // render the correct payment scenario
  *   )}
  * </Payment.ServiceOptions>
@@ -189,7 +190,12 @@ PayLater.displayName = 'Payment.PayLater';
  */
 export const ServiceOptions = React.forwardRef((props, ref) => {
     const { asChild, children } = props;
-    return (_jsx(CorePayment.ServiceOptions, { children: ({ isOnline, isInPerson, isDeposit }) => (_jsx(AsChildSlot, { ref: ref, asChild: asChild, customElement: children, customElementProps: { isOnline, isInPerson, isDeposit }, "data-testid": TestIds.paymentServiceOptions, "data-is-online": isOnline, "data-is-in-person": isInPerson, "data-is-deposit": isDeposit, children: null })) }));
+    return (_jsx(CorePayment.ServiceOptions, { children: ({ isOnline, isInPerson, isDeposit, canPayFullUpfront }) => (_jsx(AsChildSlot, { ref: ref, asChild: asChild, customElement: children, customElementProps: {
+                isOnline,
+                isInPerson,
+                isDeposit,
+                canPayFullUpfront,
+            }, "data-testid": TestIds.paymentServiceOptions, "data-is-online": isOnline, "data-is-in-person": isInPerson, "data-is-deposit": isDeposit, "data-can-pay-full-upfront": canPayFullUpfront, children: null })) }));
 });
 ServiceOptions.displayName = 'Payment.ServiceOptions';
 /**

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

@@ -4,6 +4,7 @@
 import { LocationType as TimeSlotLocationType } from '@wix/auto_sdk_bookings_availability-time-slots';
 import { LocationType as BookingLocationType, SelectionMethod, } from '@wix/auto_sdk_bookings_bookings';
 import { STAFF_MEMBER_RESOURCE_TYPE_ID } from '../../constants.js';
+import { isFullUpfrontPaymentAllowed, requiresDeposit, } from '../../servicePayment.js';
 /**
  * Derives the selected payment option from service payment settings.
  * Maps service.payment.options to booking API's selectedPaymentOption.
@@ -53,12 +54,20 @@ export function buildBookingRequest(params) {
     const resource = item.timeSlot.resources?.[0] ?? item.resources?.[0];
     // Get location: prefer timeSlot.location, fallback to params.location
     const slotLocation = item.timeSlot.location ?? location;
+    // Consumer override (if set) wins over the service-config heuristic.
+    const selectedPaymentOption = params.selectedPaymentOption ?? deriveSelectedPaymentOption(item.service);
+    // The only state where the schema allows `false`. Outside it, omitting the key
+    // leaves the server default in place.
+    const depositSelectedApplies = params.depositSelected !== undefined &&
+        selectedPaymentOption === 'ONLINE' &&
+        requiresDeposit(item.service) &&
+        isFullUpfrontPaymentAllowed(item.service);
     return {
         booking: {
-            // Payment option: consumer override (if set) wins over the
-            // service-config heuristic.
-            selectedPaymentOption: params.selectedPaymentOption ??
-                deriveSelectedPaymentOption(item.service),
+            selectedPaymentOption,
+            ...(depositSelectedApplies && {
+                depositSelected: params.depositSelected,
+            }),
             // Participants
             totalParticipants: item.totalParticipants || 1,
             // App that created the booking (used to filter bookings by source app).

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

@@ -59,6 +59,12 @@ export interface BookActionParams {
      * service. When omitted, the existing service-config heuristic applies.
      */
     selectedPaymentOption?: SelectedPaymentOption;
+    /**
+     * Optional consumer choice: `true` pays only the deposit now, `false` pays the
+     * full price now. Dropped unless the booking is ONLINE and the service has a
+     * deposit with `fullUpfrontPaymentAllowed`. Omit to keep the server default.
+     */
+    depositSelected?: boolean;
     /**
      * DAY-range only. When `true`, the picked per-day slots are collapsed into a
      * single Booking spanning the whole range (`firstSlot.startDate ->

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

@@ -89,6 +89,12 @@ export interface BookingServiceActions {
      * is cleared and the heuristic applies again.
      */
     setSelectedPaymentOption(value: SelectedPaymentOption | null): void;
+    /**
+     * Set (or clear with `undefined`) the deposit-vs-full-upfront choice. `true`
+     * charges only the deposit now, `false` charges the full price now. Gate the UI
+     * on `Payment.ServiceOptions`' `isDeposit && canPayFullUpfront`.
+     */
+    setDepositSelected(value: boolean | undefined): void;
     /**
      * Toggle the DAY-range `allDay` flag. When `true`, `book()` collapses the
      * picked per-day slots into one range-spanning Booking created via
@@ -117,6 +123,12 @@ export interface BookingService {
      * service-config heuristic. Set to `'ONLINE'` or `'OFFLINE'` to override.
      */
     selectedPaymentOption: Signal<SelectedPaymentOption | undefined>;
+    /**
+     * Signal containing the deposit-vs-full-upfront choice. `true` pays only the
+     * deposit now, `false` pays the full price now. `undefined` means "not chosen"
+     * — `book()` omits the field and the preview keeps its deposit default.
+     */
+    depositSelected: Signal<boolean | undefined>;
     /** Actions for modifying booking state */
     actions: BookingServiceActions;
 }
@@ -146,6 +158,11 @@ export interface BookingServiceConfig {
      * service-config heuristic; set to `'ONLINE'` or `'OFFLINE'` to override.
      */
     selectedPaymentOption?: SelectedPaymentOption;
+    /**
+     * Optional initial deposit-vs-full-upfront choice. Omit to keep the server's
+     * default.
+     */
+    depositSelected?: boolean;
     /** Optional app ID override for the catalog reference. Defaults to the bookings app ID. */
     appId?: string;
     /**

package/dist/services/booking/booking.js

@@ -71,6 +71,7 @@ export const BookingService = implementService.withConfig()(BookingServiceDefini
     const timezoneSignal = signalsService.signal(config.timezone ?? getClientTimezone());
     const formSubmissionSignal = signalsService.signal(config.formSubmission || null);
     const selectedPaymentOptionSignal = signalsService.signal(config.selectedPaymentOption);
+    const depositSelectedSignal = signalsService.signal(config.depositSelected);
     // Internal-only signal: set via `setAllDay`, read by `book()`. Not
     // exposed on the service surface — consumers derive and push the value
     // (e.g. from the picker's selection mode), so there's no read-back.
@@ -173,6 +174,10 @@ export const BookingService = implementService.withConfig()(BookingServiceDefini
         setSelectedPaymentOption(value) {
             selectedPaymentOptionSignal.set(value ?? undefined);
         },
+        // Deposit vs full upfront action
+        setDepositSelected(value) {
+            depositSelectedSignal.set(value);
+        },
         // All-day (DAY-range) action
         setAllDay(value) {
             allDaySignal.set(value);
@@ -192,6 +197,7 @@ export const BookingService = implementService.withConfig()(BookingServiceDefini
             const location = locationSignal.get();
             const timezone = timezoneSignal.get();
             const selectedPaymentOption = selectedPaymentOptionSignal.get();
+            const depositSelected = depositSelectedSignal.get();
             const allDay = allDaySignal.get();
             // Validation happens inside executeBookAction
             return executeBookAction({
@@ -202,6 +208,7 @@ export const BookingService = implementService.withConfig()(BookingServiceDefini
                 appId: config.appId,
                 sourceAppId: config.sourceAppId,
                 selectedPaymentOption,
+                depositSelected,
                 allDay,
             });
         },
@@ -212,6 +219,7 @@ export const BookingService = implementService.withConfig()(BookingServiceDefini
         timezone: timezoneSignal,
         formSubmission: formSubmissionSignal,
         selectedPaymentOption: selectedPaymentOptionSignal,
+        depositSelected: depositSelectedSignal,
         actions,
     };
 });

package/dist/services/index.d.ts

@@ -9,6 +9,6 @@ export { ServiceListService, ServiceListServiceDefinition, type ServiceListServi
 export { SYNTHETIC_CUSTOM_ID, SYNTHETIC_CUSTOMER_ID, AvailabilityLocationType, type ServiceWithAvailabilityItem, type AvailabilityFilter, type Attribute, type AvailabilityLocation, } from '../api/query-services/index.js';
 export { executeBookAction, canBook, buildBookingRequest, buildCartRequest, buildDayRangeBookingRequest, createBookingsForCart, isDayRangeService, getDayRangeBounds, type CanBookParams, type BookResult, type BookingError, type BookActionParams, type BookChildProps, type BookProps, type BuildCartParams, 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 { PaymentService, PaymentServiceDefinition, type PaymentServiceAPI, type PaymentServiceConfig, type PaymentDetails, type PricingServiceSelection, type LineItemAdditionalInfo, type AppliedAdditionalFee, type PreviewPriceInfo, 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/dist/services/payment/payment.d.ts

@@ -5,7 +5,7 @@
  */
 import { type PaymentServiceConfig, type PaymentServiceInternalConfig, type PricingServiceSelection } from './payment.def.js';
 import type { SelectedPaymentOption } from '../booking/book-action/types.js';
-export { PaymentServiceDefinition, type PaymentServiceConfig, type PaymentDetails, type LineItemAdditionalInfo, type PricingServiceSelection, type ServicePaymentOptions, } from './payment.def.js';
+export { PaymentServiceDefinition, type PaymentServiceConfig, type PaymentDetails, type LineItemAdditionalInfo, type AppliedAdditionalFee, type PreviewPriceInfo, type PricingServiceSelection, type ServicePaymentOptions, } from './payment.def.js';
 export type { PaymentServiceAPI, PaymentServiceInternalConfig, } from './payment.def.js';
 export declare const PaymentService: import("@wix/services-definitions").ServiceFactory<string & {
     __api: import("./payment.def.js").PaymentServiceAPI;
@@ -28,9 +28,12 @@ export type ErrorPaymentConfigResult = {
  * @param params.totalParticipants - Number of participants (default: 1)
  * @param params.selectedPaymentOption - Optional consumer-selected payment option;
  *   overrides the service-config heuristic on each line item's `paymentOption`.
+ * @param params.depositSelected - Optional deposit-vs-full-upfront choice; `false`
+ *   resolves a deposit service to full payment. Omit to keep the deposit default.
  */
 export declare function loadPaymentConfig(params: {
     pricingServiceSelections: PricingServiceSelection[];
     totalParticipants?: number;
     selectedPaymentOption?: SelectedPaymentOption;
+    depositSelected?: boolean;
 }): Promise<SuccessPaymentConfigResult | ErrorPaymentConfigResult>;

package/dist/services/payment/payment.def.d.ts

@@ -5,6 +5,7 @@
 import type { Signal } from '@wix/services-definitions/core-services/signals';
 import type { CalculateTotalsResponse } from '@wix/auto_sdk_ecom_totals-calculator';
 import type { Service } from '@wix/auto_sdk_bookings_services';
+import type { BookingLineItem, PriceInfo } from '@wix/auto_sdk_bookings_pricing';
 import type { SelectedPaymentOption } from '../booking/book-action/types.js';
 import type { ServiceSelectionTimeSlot } from '../booking/booking.js';
 /**
@@ -16,13 +17,47 @@ export interface ServicePaymentOptions {
     isOnline: boolean;
     /** Customer can pay in person (on arrival) */
     isInPerson: boolean;
-    /** A deposit is required at booking time */
+    /**
+     * A deposit is required at booking time — including percentage deposits, which
+     * set no amount. For the amount use `Payment.PayNow` / `Payment.PayLater`.
+     */
     isDeposit: boolean;
+    /**
+     * Customers may pay the full price upfront instead of only the deposit.
+     * Meaningful only with `isDeposit`; together they gate the
+     * deposit-vs-pay-in-full toggle.
+     */
+    canPayFullUpfront: boolean;
 }
 /**
  * Payment option for line items
  */
 export type PaymentOption = 'FULL_PAYMENT_ONLINE' | 'FULL_PAYMENT_OFFLINE' | 'DEPOSIT_ONLINE';
+/**
+ * An additional fee pricing applied to a booking line, as served.
+ */
+export interface AppliedAdditionalFee {
+    /** The service's additional fee ID. */
+    feeId?: string;
+    /** Units the fee was charged for (1 for a per-reservation fee). */
+    units?: number;
+    /** The fee amount for this line. */
+    amount?: number;
+}
+/**
+ * `PriceInfo` with the additional-fee fields `previewPrice` serves, which the
+ * public pricing SDK types don't declare (they are `@internal` there). Types
+ * only: the values are the response as served.
+ */
+export interface PreviewPriceInfo extends PriceInfo {
+    bookingLineItems?: (BookingLineItem & {
+        additionalFees?: AppliedAdditionalFee[];
+    })[];
+    /** Sum of all lines' additional fees. */
+    totalAdditionalFees?: number | null;
+    /** `calculatedPrice` plus `totalAdditionalFees`. */
+    calculatedPriceWithFees?: number | null;
+}
 /**
  * Additional computed info for a line item (not in SDK response)
  */
@@ -31,6 +66,14 @@ export interface LineItemAdditionalInfo {
     lineItemId: string;
     /** Custom price (for CUSTOM rate type services) */
     customPrice?: string;
+    /**
+     * The raw `previewPrice` response for this line, as served — for fields the
+     * payment service does not read. Not the amounts charged: those (including
+     * a capped deposit) come from `response`. Set only when the line was priced
+     * by `previewPrice` (duration-range services, or a deposit the server
+     * resolves).
+     */
+    priceInfo?: PreviewPriceInfo;
 }
 /**
  * Payment calculation result with SDK response and additional computed info
@@ -83,6 +126,11 @@ export interface PaymentServiceInternalConfig extends PaymentServiceConfig {
      * set, overrides the service-config heuristic in line item `paymentOption`.
      */
     selectedPaymentOption?: SelectedPaymentOption;
+    /**
+     * Deposit-vs-full-upfront choice for lazy loading. `false` resolves a deposit
+     * service to full payment instead of `DEPOSIT_ONLINE`.
+     */
+    depositSelected?: boolean;
 }
 export interface PaymentServiceAPI {
     paymentDetailsSignal: Signal<PaymentDetails | null>;