@wix/auto_sdk_bookings_availability-time-slots 1.0.252 → 1.0.254

package/build/cjs/index.d.ts

@@ -1,6 +1,6 @@
 import { HttpClient, NonNullablePaths, MaybeContext, BuildRESTFunction } from '@wix/sdk-types';
-import { ListAvailabilityTimeSlotsOptions, ListAvailabilityTimeSlotsResponse, ListAvailabilityTimeSlotsApplicationErrors, Location, GetAvailabilityTimeSlotOptions, GetAvailabilityTimeSlotResponse, GetAvailabilityTimeSlotApplicationErrors } from './index.typings.js';
-export { AvailableResources, BookingPolicyViolations, CursorPaging, CursorPagingMetadata, Cursors, CustomerChoices, DiagnoseAvailabilityRequest, DiagnoseAvailabilityResponse, DiagnosisReason, EventInfo, GetAvailabilityTimeSlotRequest, GetAvailabilityTimeSlotRequestCustomerChoices, GetEventTimeSlotRequest, GetEventTimeSlotResponse, GetMultiServiceAvailabilityTimeSlotRequest, GetMultiServiceAvailabilityTimeSlotResponse, ListAvailabilityTimeSlotEndOptions, ListAvailabilityTimeSlotEndOptionsApplicationErrors, ListAvailabilityTimeSlotEndOptionsRequest, ListAvailabilityTimeSlotEndOptionsResponse, ListAvailabilityTimeSlotsRequest, ListEventTimeSlotsRequest, ListEventTimeSlotsResponse, ListMultiServiceAvailabilityTimeSlotsRequest, ListMultiServiceAvailabilityTimeSlotsResponse, LocationType, LocationTypeWithLiterals, NestedTimeSlot, NonBookableReasons, ReasonCode, ReasonCodeWithLiterals, ResolvedContext, Resource, ResourceType, Service, SuggestedAction, SuggestedActionWithLiterals, TimeSlot, V2CustomerChoices, WaitingList } from './index.typings.js';
+import { ListAvailabilityTimeSlotsOptions, ListAvailabilityTimeSlotsResponse, ListAvailabilityTimeSlotsApplicationErrors, ListAvailabilityTimeSlotEndOptions, ListAvailabilityTimeSlotEndOptionsResponse, ListAvailabilityTimeSlotEndOptionsApplicationErrors, Location, GetAvailabilityTimeSlotOptions, GetAvailabilityTimeSlotResponse, GetAvailabilityTimeSlotApplicationErrors } from './index.typings.js';
+export { AvailableResources, BookingPolicyViolations, CursorPaging, CursorPagingMetadata, Cursors, CustomerChoices, DiagnoseAvailabilityRequest, DiagnoseAvailabilityResponse, DiagnosisReason, EventInfo, GetAvailabilityTimeSlotRequest, GetAvailabilityTimeSlotRequestCustomerChoices, GetEventTimeSlotRequest, GetEventTimeSlotResponse, GetMultiServiceAvailabilityTimeSlotRequest, GetMultiServiceAvailabilityTimeSlotResponse, ListAvailabilityTimeSlotEndOptionsRequest, ListAvailabilityTimeSlotsRequest, ListEventTimeSlotsRequest, ListEventTimeSlotsResponse, ListMultiServiceAvailabilityTimeSlotsRequest, ListMultiServiceAvailabilityTimeSlotsResponse, LocationType, LocationTypeWithLiterals, NestedTimeSlot, NonBookableReasons, ReasonCode, ReasonCodeWithLiterals, ResolvedContext, Resource, ResourceType, Service, SuggestedAction, SuggestedActionWithLiterals, TimeSlot, V2CustomerChoices, WaitingList } from './index.typings.js';
 
 declare function listAvailabilityTimeSlots$1(httpClient: HttpClient): ListAvailabilityTimeSlotsSignature;
 interface ListAvailabilityTimeSlotsSignature {
@@ -55,6 +55,8 @@ interface ListAvailabilityTimeSlotsSignature {
      *
      * Use `customerChoices` to calculate availability based on the customer's selected service duration or add-ons.
      *
+     * `customerChoices` is not supported for services configured with a duration range (`availabilityConstraints.durationRange`). For these services, availability is calculated based on the duration range configuration.
+     *
      * When using [add-ons](https://dev.wix.com/docs/api-reference/business-solutions/bookings/services/add-ons/introduction), we recommend passing only `addOnIds` in `customerChoices` and omitting `durationInMinutes`. Wix Bookings then calculates the total duration automatically. If you specify both `addOnIds` and `durationInMinutes`, `durationInMinutes` must equal the service duration plus all selected add-on durations.
      *
      * ### Business hours exception
@@ -72,6 +74,36 @@ interface ListAvailabilityTimeSlotsSignature {
         __applicationErrorsType?: ListAvailabilityTimeSlotsApplicationErrors;
     }>;
 }
+declare function listAvailabilityTimeSlotEndOptions$1(httpClient: HttpClient): ListAvailabilityTimeSlotEndOptionsSignature;
+interface ListAvailabilityTimeSlotEndOptionsSignature {
+    /**
+     * Retrieves the available end times for a selected start time of an appointment-based service configured with a duration range.
+     *
+     *
+     * Call this after the customer selects a start time with [List Availability Time Slots](https://dev.wix.com/docs/api-reference/business-solutions/bookings/time-slots/time-slots-v2/list-availability-time-slots). Each returned entry is a `TimeSlot` that shares the requested `localStartDate` and differs only in `localEndDate`. The response doesn't include resource lists.
+     *
+     * Only supported for hourly duration-range services (services with `availabilityConstraints.durationRange.hourConfig` configured in [Services V2](https://dev.wix.com/docs/api-reference/business-solutions/bookings/services/services-v2/introduction)). Calling this for a fixed-duration or daily duration-range service returns `END_OPTIONS_NOT_SUPPORTED`.
+     *
+     * ### Resource selection
+     *
+     * Resource selection depends on the booking flow:
+     * - If the customer hasn't selected a resource yet, call [Get Availability Time Slot](https://dev.wix.com/docs/api-reference/business-solutions/bookings/time-slots/time-slots-v2/get-availability-time-slot) with the selected `localEndDate` to retrieve candidate resources before booking.
+     * - If the customer selected a resource before the end time, pass that resource in `resourceTypes` so the response only includes end times that the selected resource can cover.
+     *
+     * ### Time slot shape
+     *
+     * The response uses the `TimeSlot` model with constrained semantics:
+     * - `localStartDate` and `location` are identical on every entry, echoing the request.
+     * - `localEndDate` varies across entries and represents each end option.
+     * - `availableResources` is always empty. Use [Get Availability Time Slot](https://dev.wix.com/docs/api-reference/business-solutions/bookings/time-slots/time-slots-v2/get-availability-time-slot) to retrieve resources for a selected end time.
+     * - `eventInfo`, `nestedTimeSlots`, and `allDay` are not populated.
+     * - `totalCapacity` is always `1`.
+     * @param - [Service](https://dev.wix.com/docs/api-reference/business-solutions/bookings/services/services-v2/introduction) ID. Must be an appointment-based service configured with `availabilityConstraints.durationRange.hourConfig`.
+     */
+    (serviceId: string, options?: NonNullablePaths<ListAvailabilityTimeSlotEndOptions, `localStartDate` | `location`, 2>): Promise<NonNullablePaths<ListAvailabilityTimeSlotEndOptionsResponse, `endOptions` | `endOptions.${number}.location.locationType`, 5> & {
+        __applicationErrorsType?: ListAvailabilityTimeSlotEndOptionsApplicationErrors;
+    }>;
+}
 declare function getAvailabilityTimeSlot$1(httpClient: HttpClient): GetAvailabilityTimeSlotSignature;
 interface GetAvailabilityTimeSlotSignature {
     /**
@@ -85,7 +117,7 @@ interface GetAvailabilityTimeSlotSignature {
      * Get Availability Time Slot uses the following defaults:
      *
      * - Returns all available resources unless filtered by `resourceIds` or `includeResourceTypeIds`.
-     * - Includes full booking status and capacity details
+     * - Includes full booking status and capacity details.
      *
      * ### Service type limitations
      *
@@ -95,6 +127,10 @@ interface GetAvailabilityTimeSlotSignature {
      *
      * To retrieve course availability, you can follow the [End-to-End Booking Flow for courses](https://dev.wix.com/docs/api-reference/business-solutions/bookings/end-to-end-booking-flows#book-a-course).
      *
+     * ### Duration-range services
+     *
+     * For services configured with a duration range (`availabilityConstraints.durationRange`), `customerChoices` is not supported. The duration is derived from the `localStartDate` and `localEndDate` specified in the request.
+     *
      * ### Business hours exception
      *
      * Wix Bookings disregards business opening hours when all of the following conditions are met:
@@ -126,6 +162,7 @@ interface GetAvailabilityTimeSlotSignature {
 }
 
 declare const listAvailabilityTimeSlots: MaybeContext<BuildRESTFunction<typeof listAvailabilityTimeSlots$1> & typeof listAvailabilityTimeSlots$1>;
+declare const listAvailabilityTimeSlotEndOptions: MaybeContext<BuildRESTFunction<typeof listAvailabilityTimeSlotEndOptions$1> & typeof listAvailabilityTimeSlotEndOptions$1>;
 declare const getAvailabilityTimeSlot: MaybeContext<BuildRESTFunction<typeof getAvailabilityTimeSlot$1> & typeof getAvailabilityTimeSlot$1>;
 
-export { GetAvailabilityTimeSlotApplicationErrors, GetAvailabilityTimeSlotOptions, GetAvailabilityTimeSlotResponse, ListAvailabilityTimeSlotsApplicationErrors, ListAvailabilityTimeSlotsOptions, ListAvailabilityTimeSlotsResponse, Location, getAvailabilityTimeSlot, listAvailabilityTimeSlots };
+export { GetAvailabilityTimeSlotApplicationErrors, GetAvailabilityTimeSlotOptions, GetAvailabilityTimeSlotResponse, ListAvailabilityTimeSlotEndOptions, ListAvailabilityTimeSlotEndOptionsApplicationErrors, ListAvailabilityTimeSlotEndOptionsResponse, ListAvailabilityTimeSlotsApplicationErrors, ListAvailabilityTimeSlotsOptions, ListAvailabilityTimeSlotsResponse, Location, getAvailabilityTimeSlot, listAvailabilityTimeSlotEndOptions, listAvailabilityTimeSlots };