@wix/headless-bookings 1.0.8 → 1.0.10

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

@@ -1,23 +1,12 @@
 import { type CreateCartOptions } from '../../../api/create-cart/index.js';
 import type { ContactDetails } from '@wix/auto_sdk_bookings_bookings';
 export interface BuildCartParams {
-    bookingId: string;
-    contactDetails?: ContactDetails;
-    /** `null` accepted so callers can forward SDK fields typed `string | null`. */
-    businessLocationId?: string | null;
-    /** Optional app ID override for the catalog reference. Defaults to BOOKING_APP_ID. */
-    appId?: string;
-}
-export declare function buildCartRequest(params: BuildCartParams): CreateCartOptions;
-/**
- * DAY-range variant of `buildCartRequest`. Takes the N booking IDs returned
- * by `bulkCreateBooking` (1 slot) or `createMultiServiceBooking` (2-8 slots)
- * and emits one catalog item per ID. Per SDK guidance, never use
- * `multiServiceBooking._id` here; always feed the per-day single-service
- * booking IDs into the cart.
- */
-export interface BuildDayRangeCartParams {
-    /** One catalog item per booking id. Bulk / multi-service responses produce N>=1 ids. */
+    /**
+     * One catalog item is emitted per booking id. Single-service and allDay
+     * bookings produce one id; DAY-range expansion produces one per day. Per SDK
+     * guidance, never use `multiServiceBooking._id` here; always feed the
+     * per-day single-service booking IDs into the cart.
+     */
     bookingIds: string[];
     contactDetails?: ContactDetails;
     /** `null` accepted so callers can forward SDK fields typed `string | null`. */
@@ -25,4 +14,4 @@ export interface BuildDayRangeCartParams {
     /** Optional app ID override for the catalog reference. Defaults to BOOKING_APP_ID. */
     appId?: string;
 }
-export declare function buildDayRangeCartRequest(params: BuildDayRangeCartParams): CreateCartOptions;
+export declare function buildCartRequest(params: BuildCartParams): CreateCartOptions;

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

@@ -1,16 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.buildCartRequest = buildCartRequest;
-exports.buildDayRangeCartRequest = buildDayRangeCartRequest;
 const index_js_1 = require("../../../api/create-cart/index.js");
 const constants_js_1 = require("../../constants.js");
 function buildCartRequest(params) {
-    return {
-        catalogItems: [buildCatalogItem(params.bookingId, params.appId)],
-        cart: buildCartShape(params),
-    };
-}
-function buildDayRangeCartRequest(params) {
     return {
         catalogItems: params.bookingIds.map((id) => buildCatalogItem(id, params.appId)),
         cart: buildCartShape(params),

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

@@ -6,9 +6,12 @@
  * and the picker emits one slot per day in `rangeTimeSlots`. The client just
  * packages them as one Booking each. Routing is decided by `bookings.length`
  * in `createBookingsForCart`:
- *   - length 1   -> `bulkCreateBooking`
+ *   - length 1   -> `createBooking`
  *   - length 2-8 -> `createMultiServiceBooking`
  *
+ * With `allDay`, the picked slots collapse into one Booking spanning the full
+ * range, so that case routes through `createBooking`.
+ *
  * The 8-day cap is enforced server-side; the builder does not gate on it.
  */
 import type { Booking, ParticipantNotification } from '@wix/auto_sdk_bookings_bookings';
@@ -17,9 +20,9 @@ import type { BookActionParams } from './types.js';
 export interface BuildDayRangeBookingRequest {
     /**
      * The Bookings to create. With `allDay`, this is a single Booking spanning
-     * the whole range, routed to plain `createBooking`. Otherwise it is one
-     * Booking per picked per-day slot: length 1 routes to bulkCreateBooking,
-     * length >=2 routes to createMultiServiceBooking.
+     * the whole range. Otherwise it is one Booking per picked per-day slot:
+     * length 1 routes to createBooking, length >=2 routes to
+     * createMultiServiceBooking.
      */
     bookings: Booking[];
     /** Notification settings forwarded to the server. */

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

@@ -7,9 +7,12 @@
  * and the picker emits one slot per day in `rangeTimeSlots`. The client just
  * packages them as one Booking each. Routing is decided by `bookings.length`
  * in `createBookingsForCart`:
- *   - length 1   -> `bulkCreateBooking`
+ *   - length 1   -> `createBooking`
  *   - length 2-8 -> `createMultiServiceBooking`
  *
+ * With `allDay`, the picked slots collapse into one Booking spanning the full
+ * range, so that case routes through `createBooking`.
+ *
  * The 8-day cap is enforced server-side; the builder does not gate on it.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
@@ -59,10 +62,6 @@ function buildDayRangeBookingRequest(params) {
             },
         },
     });
-    // `allDay`: collapse every picked slot into one Booking spanning the whole
-    // range (`slots[0].startDate -> slots[N-1].endDate`). `createBookingsForCart`
-    // then routes this single Booking through plain `createBooking` instead of
-    // bulk / multi-service. Otherwise, emit one Booking per picked slot.
     const bookings = params.allDay
         ? [buildBooking(slots[0].startDate, slots[slots.length - 1].endDate)]
         : slots.map((slot) => buildBooking(slot.startDate, slot.endDate));

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

@@ -2,9 +2,9 @@
  * Creates the booking(s) needed for cart construction.
  *
  * Branches on the service selection:
+ * - DAY-range path with 1 picked day     -> `createBooking`
  * - DAY-range path with `allDay`         -> `createBooking` (one combined Booking)
- * - DAY-range path with 1 picked slot    -> `bulkCreateBooking`
- * - DAY-range path with 2..8 picked slots -> `createMultiServiceBooking`
+ * - DAY-range path with 2..8 picked days -> `createMultiServiceBooking`
  * - default path                         -> `createBooking`
  *
  * All branches return the same shape so `executeBookAction` can stay

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

@@ -3,9 +3,9 @@
  * Creates the booking(s) needed for cart construction.
  *
  * Branches on the service selection:
+ * - DAY-range path with 1 picked day     -> `createBooking`
  * - DAY-range path with `allDay`         -> `createBooking` (one combined Booking)
- * - DAY-range path with 1 picked slot    -> `bulkCreateBooking`
- * - DAY-range path with 2..8 picked slots -> `createMultiServiceBooking`
+ * - DAY-range path with 2..8 picked days -> `createMultiServiceBooking`
  * - default path                         -> `createBooking`
  *
  * All branches return the same shape so `executeBookAction` can stay
@@ -16,8 +16,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createBookingsForCart = createBookingsForCart;
 const index_js_1 = require("../../../api/create-booking/index.js");
-const index_js_2 = require("../../../api/create-bulk-booking/index.js");
-const index_js_3 = require("../../../api/create-multi-service-booking/index.js");
+const index_js_2 = require("../../../api/create-multi-service-booking/index.js");
 const buildBookingRequest_js_1 = require("./buildBookingRequest.js");
 const buildDayRangeBookingRequest_js_1 = require("./buildDayRangeBookingRequest.js");
 const dayRange_js_1 = require("./dayRange.js");
@@ -28,9 +27,7 @@ async function createBookingsForCart(params) {
     }
     if ((0, dayRange_js_1.isDayRangeService)(firstSelection.service)) {
         const req = (0, buildDayRangeBookingRequest_js_1.buildDayRangeBookingRequest)(params);
-        // `allDay`: the builder has already collapsed the range into a single
-        // Booking. Create it with plain `createBooking` (not bulk / multi-service).
-        if (params.allDay) {
+        if (req.bookings.length === 1) {
             const bookingResponse = await (0, index_js_1.createBooking)(req.bookings[0], {
                 participantNotification: req.participantNotification,
                 sendSmsReminder: req.sendSmsReminder,
@@ -42,20 +39,7 @@ async function createBookingsForCart(params) {
                 contactDetails: bookingResponse.booking?.contactDetails,
             };
         }
-        if (req.bookings.length === 1) {
-            const response = await (0, index_js_2.bulkCreateBooking)([{ booking: req.bookings[0] }], {
-                participantNotification: req.participantNotification,
-                sendSmsReminder: req.sendSmsReminder,
-                formSubmission: req.formSubmission,
-            });
-            const results = response.results ?? [];
-            return {
-                bookingIds: results.map((r) => r.item?._id).filter(Boolean),
-                // All N daily bookings share the same customer; read from the first.
-                contactDetails: results[0]?.item?.contactDetails,
-            };
-        }
-        const response = await (0, index_js_3.createMultiServiceBooking)(req.bookings, {
+        const response = await (0, index_js_2.createMultiServiceBooking)(req.bookings, {
             participantNotification: req.participantNotification,
             sendSmsReminder: req.sendSmsReminder,
             formSubmission: req.formSubmission,

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

@@ -3,8 +3,9 @@
  *
  * APPOINTMENT services whose schedule has a `durationRange` with
  * `unitType === DAY` route through the per-day slot path:
- *   - 1 picked slot  -> `bulkCreateBooking`
+ *   - 1 picked slot  -> `createBooking`
  *   - 2..8 picked slots -> `createMultiServiceBooking`
+ *   - 2..8 picked slots with `allDay` -> `createBooking`
  *
  * CLASS/COURSE selections and HOUR-range / fixed-duration APPOINTMENT
  * selections keep using the existing `createBooking` path.

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

@@ -4,8 +4,9 @@
  *
  * APPOINTMENT services whose schedule has a `durationRange` with
  * `unitType === DAY` route through the per-day slot path:
- *   - 1 picked slot  -> `bulkCreateBooking`
+ *   - 1 picked slot  -> `createBooking`
  *   - 2..8 picked slots -> `createMultiServiceBooking`
+ *   - 2..8 picked slots with `allDay` -> `createBooking`
  *
  * CLASS/COURSE selections and HOUR-range / fixed-duration APPOINTMENT
  * selections keep using the existing `createBooking` path.

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

@@ -56,9 +56,8 @@ export interface BookActionParams {
     /**
      * DAY-range only. When `true`, the picked per-day slots are collapsed into a
      * single Booking spanning the whole range (`firstSlot.startDate ->
-     * lastSlot.endDate`) and created via plain `createBooking` — instead of the
-     * default per-slot expansion that routes to `bulkCreateBooking` (1 slot) or
-     * `createMultiServiceBooking` (2-8 slots). Ignored for non-DAY-range services.
+     * lastSlot.endDate`) and created via plain `createBooking`. Ignored for
+     * non-DAY-range services.
      */
     allDay?: boolean;
 }

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

@@ -48,8 +48,9 @@ export interface ServiceSelection {
      * picker after the customer picks a start + end date: one entry per day
      * in the picked range. When set, supersedes `timeSlot` for the DAY-range
      * builder, which produces one Booking per entry and routes via length:
-     *   - 1   -> bulkCreateBooking
+     *   - 1   -> createBooking
      *   - 2-8 -> createMultiServiceBooking
+     *   - 2-8 with allDay -> createBooking
      * Optional & additive: existing single-slot callers stay on `timeSlot`.
      */
     rangeTimeSlots?: ServiceSelectionTimeSlot[];
@@ -90,9 +91,8 @@ export interface BookingServiceActions {
     setSelectedPaymentOption(value: SelectedPaymentOption | null): void;
     /**
      * Toggle the DAY-range `allDay` flag. When `true`, `book()` collapses the
-     * picked per-day slots of a DAY-range service into a single Booking created
-     * via `createBooking` (instead of the per-slot bulk / multi-service path).
-     * Ignored for non-DAY-range services.
+     * picked per-day slots into one range-spanning Booking created via
+     * `createBooking`. Ignored for non-DAY-range services.
      */
     setAllDay(value: boolean): void;
     clearAll(): void;

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

@@ -5,6 +5,8 @@
  */
 /** Booking app definition ID */
 export declare const BOOKING_APP_ID = "13d21c63-b5ec-5912-8397-c3a5ddb27a97";
+/** Default page size for service queries (offset and cursor/availability modes) */
+export declare const DEFAULT_QUERY_LIMIT = 100;
 /** Resource type ID for staff members */
 export declare const STAFF_MEMBER_RESOURCE_TYPE_ID = "1cd44cf8-756f-41c3-bd90-3e2ffcaf1155";
 export declare const ClientServiceIds: {

package/cjs/dist/services/constants.js

@@ -5,9 +5,11 @@
  * @module Services/Constants
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ClientServiceIds = exports.STAFF_MEMBER_RESOURCE_TYPE_ID = exports.BOOKING_APP_ID = void 0;
+exports.ClientServiceIds = exports.STAFF_MEMBER_RESOURCE_TYPE_ID = exports.DEFAULT_QUERY_LIMIT = exports.BOOKING_APP_ID = void 0;
 /** Booking app definition ID */
 exports.BOOKING_APP_ID = '13d21c63-b5ec-5912-8397-c3a5ddb27a97';
+/** Default page size for service queries (offset and cursor/availability modes) */
+exports.DEFAULT_QUERY_LIMIT = 100;
 /** Resource type ID for staff members */
 exports.STAFF_MEMBER_RESOURCE_TYPE_ID = '1cd44cf8-756f-41c3-bd90-3e2ffcaf1155';
 exports.ClientServiceIds = {

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

@@ -5,9 +5,9 @@
 export { ServiceService, ServiceServiceDefinition, type ServiceServiceAPI, type ServiceServiceConfig, type ServiceActions, type ServicePaymentData, loadServiceServiceInitialData, type SuccessServiceServiceConfigResult, type NotFoundServiceServiceConfigResult, } from './service/service.js';
 export { BookingService, BookingServiceDefinition, type BookingServiceConfig, type BookingServiceActions, type ServiceSelection, type ServiceSelectionTimeSlot, } from './booking/booking.js';
 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, buildCartRequest, buildDayRangeCartRequest, buildDayRangeBookingRequest, createBookingsForCart, isDayRangeService, getDayRangeBounds, type CanBookParams, type BookResult, type BookingError, type BookActionParams, type BookChildProps, type BookProps, type BuildCartParams, type BuildDayRangeCartParams, type BuildDayRangeBookingRequest, type CreatedBookings, type DayRangeBounds, } from './booking/book-action/index.js';
+export { ServiceListService, ServiceListServiceDefinition, type ServiceListServiceAPI, type ServiceListServiceConfig, type ServiceListActions, type QueryOptions, loadServiceListServiceInitialData, type LoadServiceListServiceOptions, type SuccessServiceListServiceConfigResult, type ErrorServiceListServiceConfigResult, } from './service-list/service-list.js';
+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 { LocationListService, LocationListServiceDefinition, LocationType, loadLocationListServiceInitialData, locationListServiceBinding, type LocationListServiceAPI, type LocationListServiceConfig, type LocationListActions, type Location, type LoadLocationListServiceResult, getLocationById, } from './location-list/location-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.getDayRangeBounds = exports.isDayRangeService = exports.createBookingsForCart = exports.buildDayRangeBookingRequest = exports.buildDayRangeCartRequest = 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;
+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.getDayRangeBounds = exports.isDayRangeService = exports.createBookingsForCart = exports.buildDayRangeBookingRequest = exports.buildCartRequest = exports.buildBookingRequest = exports.canBook = exports.executeBookAction = exports.AvailabilityLocationType = 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; } });
@@ -26,12 +26,12 @@ Object.defineProperty(exports, "loadServiceListServiceInitialData", { enumerable
 var index_js_2 = require("../api/query-services/index.js");
 Object.defineProperty(exports, "SYNTHETIC_CUSTOM_ID", { enumerable: true, get: function () { return index_js_2.SYNTHETIC_CUSTOM_ID; } });
 Object.defineProperty(exports, "SYNTHETIC_CUSTOMER_ID", { enumerable: true, get: function () { return index_js_2.SYNTHETIC_CUSTOMER_ID; } });
+Object.defineProperty(exports, "AvailabilityLocationType", { enumerable: true, get: function () { return index_js_2.AvailabilityLocationType; } });
 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, "buildCartRequest", { enumerable: true, get: function () { return index_js_3.buildCartRequest; } });
-Object.defineProperty(exports, "buildDayRangeCartRequest", { enumerable: true, get: function () { return index_js_3.buildDayRangeCartRequest; } });
 Object.defineProperty(exports, "buildDayRangeBookingRequest", { enumerable: true, get: function () { return index_js_3.buildDayRangeBookingRequest; } });
 Object.defineProperty(exports, "createBookingsForCart", { enumerable: true, get: function () { return index_js_3.createBookingsForCart; } });
 Object.defineProperty(exports, "isDayRangeService", { enumerable: true, get: function () { return index_js_3.isDayRangeService; } });

package/cjs/dist/services/service-list/service-list.d.ts

@@ -1,22 +1,29 @@
 /**
  * ServiceList Service - Reactive service list data management
- * Handles querying and pagination of services list (NO selection management)
+ * Handles querying and pagination of services list (NO selection management).
+ *
+ * Availability is just part of the query: when the query options carry an
+ * `availabilityFilter`, the API layer queries services by real bookable
+ * availability (and each service gets an `available` flag); otherwise it runs the
+ * plain offset query. The service does not know or care which endpoint is used —
+ * that decision lives in {@link queryServices}.
  */
 import { type Signal, type ReadOnlySignal } from '@wix/services-definitions/core-services/signals';
-import type { Service } from '@wix/auto_sdk_bookings_services';
-import type { QueryServicesRequest, PagingMetadata } from '../../api/query-services/index.js';
+import type { Sorting } from '@wix/auto_sdk_bookings_services';
+import type { QueryServicesRequest, PagingMetadata, ServiceWithAvailabilityItem, AvailabilityFilter } from '../../api/query-services/index.js';
 import { type Category } from '../../api/query-categories/index.js';
 import type { FilterOption, FilterValue as Filter } from '@wix/headless-components/react';
 /**
- * Query options without paging metadata (user-controlled request params)
- * Effect subscribes to changes in this signal to trigger re-fetches
+ * Query options without paging metadata (user-controlled request params).
+ * Includes `filter` (category/location) and `availabilityFilter`; the effect
+ * subscribes to changes in this signal to trigger re-fetches.
  */
 export type QueryOptions = Omit<QueryServicesRequest, 'pagingMetadata'>;
 /**
  * Configuration for the ServiceList service
  */
 export interface ServiceListServiceConfig {
-    services?: Service[];
+    services?: ServiceWithAvailabilityItem[];
     categories?: Category[];
     options?: QueryServicesRequest;
 }
@@ -35,10 +42,10 @@ export interface ServiceListActions {
  */
 export interface ServiceListServiceAPI {
     /** Reactive signal containing the list of services */
-    servicesSignal: Signal<Service[]>;
-    /** Reactive signal containing current query options (appId, filter, sort) - changes trigger re-fetch */
+    servicesSignal: Signal<ServiceWithAvailabilityItem[]>;
+    /** Reactive signal containing current query options (appId, filter, availabilityFilter, sort) - changes trigger re-fetch */
     queryOptionsSignal: Signal<QueryOptions>;
-    /** Reactive signal containing pagination metadata (limit, offset, count, hasNext) - updated after fetches */
+    /** Reactive signal containing pagination metadata (limit, offset/cursor, count, hasNext) - updated after fetches */
     pagingMetadataSignal: Signal<PagingMetadata>;
     /** Reactive signal indicating if services are currently being loaded */
     isLoadingSignal: Signal<boolean>;
@@ -50,6 +57,8 @@ export interface ServiceListServiceAPI {
     filterOptionsSignal: ReadOnlySignal<FilterOption[]>;
     /** Computed signal indicating if any filters are active (from queryOptionsSignal.filter) */
     isFilteredSignal: ReadOnlySignal<boolean>;
+    /** Computed signal indicating whether an availability filter is currently applied */
+    hasAvailabilityFilterSignal: ReadOnlySignal<boolean>;
     /** Computed signal containing effective filter (queryOptions.filter + location from BookingService) */
     effectiveFilterSignal: ReadOnlySignal<Filter | undefined>;
     /** Actions object containing query actions */
@@ -91,7 +100,6 @@ export declare const ServiceListServiceDefinition: string & {
  *   const services = serviceListService.servicesSignal.get();
  *   const isLoading = serviceListService.isLoadingSignal.get();
  *   const error = serviceListService.errorSignal.get();
- *   const pagingMetadata = serviceListService.pagingMetadataSignal.get();
  *   const hasMore = serviceListService.hasMoreServicesSignal.get();
  *
  *   if (isLoading) return <div>Loading services...</div>;
@@ -110,9 +118,6 @@ export declare const ServiceListServiceDefinition: string & {
  *           Load More
  *         </button>
  *       )}
- *       {pagingMetadata.hasNext && (
- *         <span>More services available</span>
- *       )}
  *     </div>
  *   );
  * }
@@ -135,36 +140,40 @@ export type ErrorServiceListServiceConfigResult = {
     error: Error;
 };
 /**
- * Load service list configuration for Server-Side Rendering (SSR).
- * This function is designed to be called during the build or server-side rendering phase
- * to pre-fetch services data before the React components are hydrated on the client.
- * The returned config includes paging metadata with hasNext flag indicating if more services are available.
+ * Options for {@link loadServiceListServiceInitialData}.
+ * Pass an `availabilityFilter` to load availability-aware services.
+ */
+export interface LoadServiceListServiceOptions {
+    appId?: string;
+    filter?: Filter;
+    pagingMetadata?: PagingMetadata;
+    sort?: Sorting[];
+    availabilityFilter?: AvailabilityFilter;
+}
+/**
+ * Loads service list configuration for SSR, pre-fetching services and categories.
+ * Pass an `availabilityFilter` to query availability-aware services.
  *
- * @param options - Query options following QueryServicesRequest type, or a URL string (to be implemented)
- * @returns A promise that resolves to either a success result with the config or an error result
+ * @param options - Query options.
+ * @returns A success result with the config, or an error result.
  *
  * @example
  * ```ts
- * // In an Astro page or API route
- * import { loadServiceListServiceInitialData } from '@wix/bookings/services';
- *
- * // Load with query options
- * const serviceListResult = await loadServiceListServiceInitialData({
+ * // Plain offset query
+ * const result = await loadServiceListServiceInitialData({
  *   appId: '13d21c63-b5ec-5912-8397-c3a5ddb27a97',
  *   pagingMetadata: { limit: 20, offset: 0 },
  * });
  *
- * if (serviceListResult.type === 'error') {
- *   console.error('Failed to load services:', serviceListResult.error);
- *   return Astro.redirect('/500');
- * }
- *
- * const serviceListConfig = serviceListResult.config;
- *
- * // Check if more services are available
- * if (serviceListConfig.options?.pagingMetadata?.hasNext) {
- *   // More services can be loaded
- * }
+ * // Availability-aware query (cursor paging + `available` flag)
+ * const availabilityResult = await loadServiceListServiceInitialData({
+ *   availabilityFilter: {
+ *     localStartDate: '2026-06-01T09:00:00',
+ *     localEndDate: '2026-06-07T17:00:00',
+ *     timeZone: 'America/New_York',
+ *   },
+ *   pagingMetadata: { limit: 20 },
+ * });
  * ```
  */
-export declare function loadServiceListServiceInitialData(options: QueryServicesRequest): Promise<SuccessServiceListServiceConfigResult | ErrorServiceListServiceConfigResult>;
+export declare function loadServiceListServiceInitialData(options: LoadServiceListServiceOptions): Promise<SuccessServiceListServiceConfigResult | ErrorServiceListServiceConfigResult>;