@wix/himalaya-cli 0.1002.0 → 0.1004.0

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/stdlib/wix-sdk/bookings-v2/src/extensions.d.ts

@@ -263,8 +263,22 @@ export interface WixBookSlotOptions {
  *  for an OFFLINE booking, so do not read one as "charge now" and send a
  *  pay-in-person customer into the cashier.
  *
- *  Wix documents `selectedPaymentOption` as REQUIRED whenever the booking is paid
- *  through an eCommerce checkout, and it must be an option the service offers.
+ *  Wix's Create Booking reference says to specify `selectedPaymentOption` when the
+ *  customer pays through a Wix eCommerce checkout, and that the call fails
+ *  otherwise. That failure has not been observed. The member paid flow in the
+ *  `himi-booking-time` worker calls `bookSlot` with no option and then checks
+ *  out, and a live run of it created the booking, the checkout and the order.
+ *  That run never completed payment, though, so whether a booking made without
+ *  an option confirms once its order is paid is still unverified, and Wix does
+ *  not document what an omitted option defaults to. Pass it when you know how
+ *  the customer means to pay.
+ *
+ *  Any value you pass must be one the service offers. Wix exposes that on the
+ *  Services V2 service as `payment.options` (booleans `online`, `inPerson`,
+ *  `deposit`, `pricingPlan`). The `WixService` type here does not declare it
+ *  yet, so read it from the service response with a cast.
+ *  Do not hard-code `ONLINE`: a service can be set up for in-person payment
+ *  only, and then `ONLINE` is not one of its options.
  *  Leave `options` out and the request is the one this function always sent. */
 export declare function bookSlot(slot: WixBookingSlotFull, firstName: string, lastName: string, email: string, options?: WixBookSlotOptions): Promise<WixCreateBookingResponse>;
 export interface WixBookingAdditionalField {