@wix/headless-bookings 0.0.62 → 0.0.63

package/cjs/dist/__mocks__/time-slots.js

@@ -112,5 +112,6 @@ export function createMockTimeSlotListService(config = {}) {
                 dateRangeSignal.set({ start, end });
             }),
         },
+        dispose: vi.fn(),
     };
 }

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

@@ -4,12 +4,12 @@
  *
  * @module API
  */
-export { getServiceById, getServiceBySlug, queryServices, type PagingMetadata, type ServiceListFilters, type QueryServicesRequest, } from './query-services/index.js';
+export { getServiceById, getServiceBySlug, queryServices, type PagingMetadata, type ServiceListFilters, 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 { queryLocations, type QueryLocationsResult, type LocationData, } from './query-locations/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:

package/cjs/dist/api/index.js

@@ -4,12 +4,12 @@
  *
  * @module API
  */
-export { getServiceById, getServiceBySlug, queryServices, } from './query-services/index.js';
+export { getServiceById, getServiceBySlug, queryServices, SYNTHETIC_CUSTOM_ID, SYNTHETIC_CUSTOMER_ID, } from './query-services/index.js';
 export { fetchAvailability } from './fetch-availability/index.js';
 export { createBooking, } from './create-booking/index.js';
 export { createCheckout, ChannelType, } from './create-checkout/index.js';
 export { createOrder, } from './create-order/index.js';
-export { queryLocations, } from './query-locations/index.js';
+export { queryLocations, getLocationById, } from './query-locations/index.js';
 export { queryCategories, } from './query-categories/index.js';
 /**
  * PagingMetadata includes:

package/cjs/dist/api/query-locations/index.d.ts

@@ -36,3 +36,17 @@ export interface QueryLocationsResult {
  * ```
  */
 export declare function queryLocations(): Promise<QueryLocationsResult>;
+/**
+ * Fetches a single location by its business location ID
+ * @param locationId - The business location ID (GUID)
+ * @returns Promise resolving to the location or null if not found
+ *
+ * @example
+ * ```ts
+ * const location = await getLocationById('12345678-1234-1234-1234-123456789012');
+ * if (location) {
+ *   console.log(location.business?.name);
+ * }
+ * ```
+ */
+export declare function getLocationById(locationId: string): Promise<LocationData | null>;

package/cjs/dist/api/query-locations/index.js

@@ -28,3 +28,30 @@ export async function queryLocations() {
         hasCustomerLocations: response.customerLocations?.exists || false,
     };
 }
+/**
+ * Fetches a single location by its business location ID
+ * @param locationId - The business location ID (GUID)
+ * @returns Promise resolving to the location or null if not found
+ *
+ * @example
+ * ```ts
+ * const location = await getLocationById('12345678-1234-1234-1234-123456789012');
+ * if (location) {
+ *   console.log(location.business?.name);
+ * }
+ * ```
+ */
+export async function getLocationById(locationId) {
+    try {
+        const response = await queryLocationsApi({
+            filter: {
+                businessLocationIds: [locationId],
+            },
+        });
+        return response.businessLocations?.locations?.[0] ?? null;
+    }
+    catch (error) {
+        console.error(`Failed to load location for id "${locationId}":`, error);
+        return null;
+    }
+}

package/cjs/dist/api/query-services/index.d.ts

@@ -3,6 +3,11 @@
  * Fetches single or multiple services with pagination and sorting
  */
 import { type Service, type Paging, type Sorting } from '@wix/auto_sdk_bookings_services';
+/**
+ * Synthetic location ID constants for non-business locations
+ */
+export declare const SYNTHETIC_CUSTOM_ID = "custom";
+export declare const SYNTHETIC_CUSTOMER_ID = "customer";
 /**
  * Paging metadata from query services response.
  * Extends the SDK's Paging type with hasNext flag to indicate if more services are available.

package/cjs/dist/api/query-services/index.js

@@ -10,8 +10,8 @@ const BOOKING_APP_ID = '13d21c63-b5ec-5912-8397-c3a5ddb27a97';
 /**
  * Synthetic location ID constants for non-business locations
  */
-const SYNTHETIC_CUSTOM_ID = '__synthetic_custom__';
-const SYNTHETIC_CUSTOMER_ID = '__synthetic_customer__';
+export const SYNTHETIC_CUSTOM_ID = 'custom';
+export const SYNTHETIC_CUSTOMER_ID = 'customer';
 /**
  * Fetches a service by its ID
  * @param id - The service ID

package/cjs/dist/react/core/location/Location.d.ts

@@ -27,6 +27,8 @@ export interface SyntheticLocation {
     synthetic: true;
     /** Optional ID for tracking (matches ServiceLocation._id) */
     _id?: string;
+    /** Optional name/label for the location */
+    name?: string;
 }
 /**
  * Union type - location prop accepts Service or Synthetic location

package/cjs/dist/react/core/location/Location.js

@@ -106,10 +106,23 @@ function computeLocationRenderProps(rawLocation) {
     if (isSyntheticLocation(rawLocation)) {
         const syntheticLoc = rawLocation;
         const locationType = syntheticLoc.locationType;
+        // Use provided name or default based on location type
+        let name;
+        if (syntheticLoc.name) {
+            name = syntheticLoc.name;
+        }
+        else {
+            name =
+                locationType === LocationType.CUSTOM
+                    ? 'Custom Locations'
+                    : locationType === LocationType.CUSTOMER
+                        ? "Client's Place"
+                        : undefined;
+        }
         return {
             locationType,
             address: null,
-            name: undefined,
+            name,
             locationId: syntheticLoc._id,
             isCustomerLocation: locationType === LocationType.CUSTOMER,
             isCustomLocation: locationType === LocationType.CUSTOM,

package/cjs/dist/react/core/time-slot-list/TimeSlot.js

@@ -82,7 +82,6 @@ export function Info(props) {
     const endDate = new Date(timeSlot.localEndDate);
     const locationName = timeSlot.location?.name ?? '';
     const bookable = timeSlot.bookable ?? false;
-    // Calculate duration from start and end dates
     const durationInMinutes = Math.round((endDate.getTime() - startDate.getTime()) / (1000 * 60));
     return props.children({
         startDate,
@@ -166,7 +165,6 @@ export function StaffMembers(props) {
     const bookingService = useService(BookingServiceDefinition);
     const selectedStaffMemberId = bookingService.serviceSelections.get()[0]?.timeSlot?.resources?.[0]?._id;
     const staffMembers = timeSlot.availableResources[0].resources;
-    // Return null if only 1 staff member - nothing to choose from
     if (staffMembers.length <= 1) {
         return null;
     }

package/cjs/dist/react/core/time-slot-list/TimeSlotList.js

@@ -1,4 +1,9 @@
 import { jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
+/**
+ * Core TimeSlotList Components
+ * Provides low-level access to TimeSlotListService via render props
+ */
+import React from 'react';
 import { useService, WixServices } from '@wix/services-manager-react';
 import { createServicesMap } from '@wix/services-manager';
 import { TimeSlotListServiceDefinition, TimeSlotListService, } from '../../../services/time-slot-list/index.js';
@@ -28,18 +33,20 @@ export function Root(props) {
  * Internal component that wraps navigateToBookingForm to handle optional parameters
  */
 function RootContent({ navigateToBookingForm: providedNavigateToBookingForm, children, }) {
-    // Get BookingService to use when timeSlot/service are not provided
+    const timeSlotListService = useService(TimeSlotListServiceDefinition);
+    React.useEffect(() => {
+        return () => {
+            timeSlotListService.dispose();
+        };
+    }, [timeSlotListService]);
     let bookingService = null;
     try {
         bookingService = useService(BookingServiceDefinition);
     }
     catch {
-        // BookingService not available - that's ok, user must provide timeSlot/service
         bookingService = null;
     }
-    // Wrap the provided navigateToBookingForm to handle optional parameters
     const navigateToBookingForm = async ({ timeSlot, service, }) => {
-        // If timeSlot or service are not provided, try to get them from BookingService
         let resolvedTimeSlot = timeSlot;
         let resolvedService = service;
         if ((!resolvedTimeSlot || !resolvedService) && bookingService) {
@@ -52,14 +59,12 @@ function RootContent({ navigateToBookingForm: providedNavigateToBookingForm, chi
                 }
             }
         }
-        // Validate that we have both timeSlot and service
         if (!resolvedTimeSlot) {
             throw new Error('timeSlot is required. Either provide it as a parameter or ensure BookingService has a service selection with a timeSlot.');
         }
         if (!resolvedService) {
             throw new Error('service is required. Either provide it as a parameter or ensure BookingService has a service selection.');
         }
-        // Call the provided function with resolved values
         return providedNavigateToBookingForm({
             timeSlot: resolvedTimeSlot,
             service: resolvedService,

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

@@ -1,5 +1,4 @@
 export * as Booking from './booking/Booking.js';
-export * as BookingForm from './booking-form/BookingForm.js';
 export * as Service from './service/Service.js';
 export * as ServiceMedia from './service/ServiceMedia.js';
 export * as TimeSlotList from './time-slot-list/TimeSlotList.js';

package/cjs/dist/react/index.js

@@ -1,5 +1,5 @@
 export * as Booking from './booking/Booking.js';
-export * as BookingForm from './booking-form/BookingForm.js';
+// export * as BookingForm from './booking-form/BookingForm.js';
 export * as Service from './service/Service.js';
 export * as ServiceMedia from './service/ServiceMedia.js';
 export * as TimeSlotList from './time-slot-list/TimeSlotList.js';

package/cjs/dist/react/location/Location.d.ts

@@ -23,6 +23,10 @@ export interface RootProps {
     children?: React.ReactNode | AsChildChildren<CoreLocation.LocationRenderProps>;
     /** CSS class name */
     className?: string;
+    /** Custom label for CUSTOM location type */
+    customLocationLabel?: string;
+    /** Custom label for CUSTOMER location type */
+    customerLocationLabel?: string;
     /** Data attributes */
     [key: `data-${string}`]: string | undefined;
 }

package/cjs/dist/react/location/Location.js

@@ -9,6 +9,7 @@ import React from 'react';
 import * as CoreLocation from '../core/location/Location.js';
 import { AsChildSlot } from '@wix/headless-utils/react';
 import { Address } from '@wix/headless-components/react';
+import { LocationType } from '../../services/location-list/location-list.def.js';
 // Re-export useLocationContext from core
 export { useLocationContext } from '../core/location/Location.js';
 // ==========================================
@@ -63,10 +64,27 @@ const useLocationContext = CoreLocation.useLocationContext;
  * ```
  */
 export const Root = React.forwardRef((props, ref) => {
-    const { location, asChild, children, className, ...attrs } = props;
+    const { location, asChild, children, className, customLocationLabel, customerLocationLabel, ...attrs } = props;
     // Extract data-* attributes
     const dataAttrs = Object.fromEntries(Object.entries(attrs).filter(([key]) => key.startsWith('data-')));
-    return (_jsx(CoreLocation.Root, { location: location, children: _jsx(CoreLocation.Data, { children: (renderProps) => (_jsx(AsChildSlot, { ref: ref, asChild: asChild, className: className, "data-testid": TestIds.locationRoot, "data-location-type": renderProps.locationType, customElement: children, customElementProps: renderProps, ...dataAttrs, children: children })) }) }));
+    // If location is synthetic and labels are provided, update the synthetic location's name
+    let processedLocation = location;
+    if (location && 'synthetic' in location && location.synthetic === true) {
+        const syntheticLoc = location;
+        const shouldUpdateName = (syntheticLoc.locationType === LocationType.CUSTOM &&
+            customLocationLabel !== undefined) ||
+            (syntheticLoc.locationType === LocationType.CUSTOMER &&
+                customerLocationLabel !== undefined);
+        if (shouldUpdateName) {
+            processedLocation = {
+                ...syntheticLoc,
+                name: syntheticLoc.locationType === LocationType.CUSTOM
+                    ? customLocationLabel
+                    : customerLocationLabel,
+            };
+        }
+    }
+    return (_jsx(CoreLocation.Root, { location: processedLocation, children: _jsx(CoreLocation.Data, { children: (renderProps) => (_jsx(AsChildSlot, { ref: ref, asChild: asChild, className: className, "data-testid": TestIds.locationRoot, "data-location-type": renderProps.locationType, customElement: children, customElementProps: renderProps, ...dataAttrs, children: children })) }) }));
 });
 Root.displayName = 'Location.Root';
 /**

package/cjs/dist/react/location/LocationList.d.ts

@@ -17,6 +17,10 @@ export interface RootProps {
     locationListConfig?: LocationListServiceConfig;
     className?: string;
     variant?: ListVariant;
+    /** Custom label for CUSTOM location type */
+    customLocationLabel?: string;
+    /** Custom label for CUSTOMER location type */
+    customerLocationLabel?: string;
 }
 /**
  * Root component that provides the LocationList service context for rendering locations lists.

package/cjs/dist/react/location/LocationList.js

@@ -9,9 +9,15 @@ import React from 'react';
 import { GenericList, } from '@wix/headless-components/react';
 import { AsChildSlot } from '@wix/headless-utils/react';
 import { useService } from '@wix/services-manager-react';
+import { LocationType, } from '../../services/location-list/location-list.def.js';
 import { BookingServiceDefinition } from '../../services/booking/booking.js';
 import * as CoreLocationList from '../core/location-list/LocationList.js';
 import * as Location from './Location.js';
+const LocationLabelsContext = React.createContext(null);
+function useLocationLabelsContext() {
+    const context = React.useContext(LocationLabelsContext);
+    return context || {};
+}
 // ============================================================================
 // TestIds
 // ============================================================================
@@ -45,11 +51,11 @@ var TestIds;
  * ```
  */
 export const Root = React.forwardRef((props, ref) => {
-    const { children, locationListConfig, className, variant } = props;
+    const { children, locationListConfig, className, variant, customLocationLabel, customerLocationLabel, } = props;
     const config = locationListConfig || {
         locations: [],
     };
-    return (_jsx(CoreLocationList.Root, { locationListServiceConfig: config, children: _jsx(RootContent, { className: className, ref: ref, variant: variant, children: children }) }));
+    return (_jsx(LocationLabelsContext.Provider, { value: { customLocationLabel, customerLocationLabel }, children: _jsx(CoreLocationList.Root, { locationListServiceConfig: config, children: _jsx(RootContent, { className: className, ref: ref, variant: variant, children: children }) }) }));
 });
 Root.displayName = 'LocationList.Root';
 /**
@@ -85,15 +91,35 @@ export const Locations = React.forwardRef((props, ref) => {
 Locations.displayName = 'LocationList.Locations';
 export const LocationRepeater = React.forwardRef((props, ref) => {
     const { children } = props;
+    const { customLocationLabel, customerLocationLabel } = useLocationLabelsContext();
     // Custom itemWrapper that wraps each item in Location.Root
     const locationItemWrapper = ({ item: displayLocation, children: itemChildren, }) => {
         // Convert DisplayLocation to LocationInput
         // If location is null, create a SyntheticLocation
-        const location = displayLocation.location ?? {
-            locationType: displayLocation.type,
-            synthetic: true,
-            _id: displayLocation.id,
-        };
+        let location;
+        if (displayLocation.location) {
+            location = displayLocation.location;
+        }
+        else {
+            const locationType = displayLocation.type;
+            // Determine the name based on labels or defaults
+            let name;
+            if (locationType === LocationType.CUSTOM &&
+                customLocationLabel !== undefined) {
+                name = customLocationLabel;
+            }
+            else if (locationType === LocationType.CUSTOMER &&
+                customerLocationLabel !== undefined) {
+                name = customerLocationLabel;
+            }
+            // If no label provided, name will be undefined and defaults will be used in computeLocationRenderProps
+            location = {
+                locationType,
+                synthetic: true,
+                _id: displayLocation.id,
+                name,
+            };
+        }
         return (_jsx(Location.Root, { location: location, "data-testid": TestIds.locationListLocation, "data-location-id": displayLocation.id, "data-location-type": displayLocation.type, "data-item-id": displayLocation.id, children: itemChildren }, displayLocation.id));
     };
     return (_jsx(GenericList.Repeater, { ref: ref, itemWrapper: locationItemWrapper, children: children }));

package/cjs/dist/react/time-slot-list/TimeSlotList.js

@@ -86,12 +86,8 @@ Timezone.displayName = 'TimeSlotList.Timezone';
  */
 export const Root = React.forwardRef((props, ref) => {
     const { children, config, className, variant, navigateToBookingForm: providedNavigateToBookingForm, } = props;
-    // Wrap defaultNavigateToBookingForm to match optional parameter signature
-    // The core component will handle getting timeSlot/service from BookingService if not provided
     const navigateToBookingForm = providedNavigateToBookingForm ||
         (async ({ timeSlot, service, }) => {
-            // This will be handled by the core component's wrapper
-            // which will resolve timeSlot/service from BookingService if needed
             if (!timeSlot || !service) {
                 throw new Error('timeSlot and service are required when using default navigation. Either provide them or ensure BookingService has service selections.');
             }

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

@@ -6,8 +6,9 @@ export { ServiceService, ServiceServiceDefinition, type ServiceServiceAPI, type
 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 ServiceListFilters, 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 { BookingFormService, BookingFormServiceDefinition, type BookingFormServiceAPI, type BookingFormServiceConfig, type BookingFormServiceInternalAPI, type ValidationResult, } 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 { LocationListService, LocationListServiceDefinition, LocationType, loadLocationListServiceInitialData, locationListServiceBinding, type LocationListServiceAPI, type LocationListServiceConfig, type LocationListActions, type LocationData, type DisplayLocation, type LoadLocationListServiceResult, } from './location-list/location-list.js';
+export { LocationListService, LocationListServiceDefinition, LocationType, loadLocationListServiceInitialData, locationListServiceBinding, type LocationListServiceAPI, type LocationListServiceConfig, type LocationListActions, type LocationData, type DisplayLocation, 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

@@ -6,8 +6,9 @@ export { ServiceService, ServiceServiceDefinition, loadServiceServiceInitialData
 export { BookingService, BookingServiceDefinition, } from './booking/booking.js';
 export { TimeSlotListService, TimeSlotListServiceDefinition, TimeSlotService, TimeSlotServiceDefinition, ViewMode, loadTimeSlotListConfig, } from './time-slot-list/index.js';
 export { ServiceListService, ServiceListServiceDefinition, loadServiceListServiceInitialData, } from './service-list/service-list.js';
+export { SYNTHETIC_CUSTOM_ID, SYNTHETIC_CUSTOMER_ID, } from '../api/query-services/index.js';
 export { executeBookAction, canBook, buildBookingRequest, buildCheckoutRequest, } from './booking/book-action/index.js';
 export { BookingFormService, BookingFormServiceDefinition, } from './booking-form/booking-form.js';
 export { PaymentService, PaymentServiceDefinition, loadPaymentConfig, } from './payment/payment.js';
-export { LocationListService, LocationListServiceDefinition, LocationType, loadLocationListServiceInitialData, locationListServiceBinding, } from './location-list/location-list.js';
+export { LocationListService, LocationListServiceDefinition, LocationType, loadLocationListServiceInitialData, locationListServiceBinding, getLocationById, } from './location-list/location-list.js';
 export { StaffMemberListService, StaffMemberListServiceDefinition, loadStaffMemberListServiceInitialData, staffMemberListServiceBinding, } from './staff-member-list/staff-member-list.js';

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

@@ -6,6 +6,7 @@
  */
 import type { ServiceFactoryConfig } from '@wix/services-definitions';
 import { type LocationData } from './location-list.def.js';
+export { getLocationById } from '../../api/query-locations/index.js';
 /**
  * Configuration interface for LocationListService
  */

package/cjs/dist/services/location-list/location-list.js

@@ -10,14 +10,15 @@ import { LocationType } from '@wix/auto_sdk_bookings_services';
 import { LocationListServiceDefinition, } from './location-list.def.js';
 import { BookingServiceDefinition } from '../booking/booking.js';
 import { queryLocations } from '../../api/query-locations/index.js';
+export { getLocationById } from '../../api/query-locations/index.js';
 // ============================================================================
 // Constants
 // ============================================================================
 /**
  * Synthetic location IDs for non-business locations
  */
-const SYNTHETIC_CUSTOM_ID = '__synthetic_custom__';
-const SYNTHETIC_CUSTOMER_ID = '__synthetic_customer__';
+const SYNTHETIC_CUSTOM_ID = 'custom';
+const SYNTHETIC_CUSTOMER_ID = 'customer';
 // ============================================================================
 // Helper Functions
 // ============================================================================

package/cjs/dist/services/time-slot-list/time-slot-list.def.d.ts

@@ -88,6 +88,7 @@ export interface TimeSlotListServiceAPI {
     hasMore: Signal<boolean>;
     dateRange: Signal<DateRange>;
     actions: TimeSlotListServiceActions;
+    dispose: () => void;
 }
 export declare const TimeSlotListServiceDefinition: string & {
     __api: TimeSlotListServiceAPI;

package/cjs/dist/services/time-slot-list/time-slot-list.js

@@ -19,15 +19,12 @@ function getClientTimezone() {
 // Service Implementation
 // ============================================================================
 export const TimeSlotListService = implementService.withConfig()(TimeSlotListServiceDefinition, ({ getService, config }) => {
-    // Get dependent services
     const signalsService = getService(SignalsServiceDefinition);
     const bookingService = getService(BookingServiceDefinition);
-    // Initialize Signals
     const timeSlotsSignal = signalsService.signal(config.timeSlots || []);
     const isLoadingSignal = signalsService.signal(false);
     const errorSignal = signalsService.signal(null);
     const hasMoreSignal = signalsService.signal(false);
-    // Internal only - viewMode is auto-detected based on service types
     const viewModeSignal = signalsService.signal(ViewMode.CLASSIC);
     const dateRangeSignal = signalsService.signal({
         start: config.startDate,
@@ -201,8 +198,7 @@ export const TimeSlotListService = implementService.withConfig()(TimeSlotListSer
             : undefined;
     });
     let isFirstRun = true;
-    signalsService.effect(() => {
-        // Dependencies - trigger refetch when these change
+    const dispose = signalsService.effect(() => {
         dateRangeSignal.get();
         bookingService.timezone.get();
         bookingService.location.get();
@@ -215,16 +211,12 @@ export const TimeSlotListService = implementService.withConfig()(TimeSlotListSer
         }
         fetchTimeSlots();
     });
-    // Return service API
     return {
-        // State Signals
         timeSlots: timeSlotsSignal,
         isLoading: isLoadingSignal,
         error: errorSignal,
         hasMore: hasMoreSignal,
-        // Configuration Signals (viewMode is internal only)
         dateRange: dateRangeSignal,
-        // Actions
         actions: {
             selectSlot,
             selectStaffMember,
@@ -232,6 +224,7 @@ export const TimeSlotListService = implementService.withConfig()(TimeSlotListSer
             loadMore,
             setDateRange,
         },
+        dispose,
     };
 });
 /**

package/dist/__mocks__/time-slots.js

@@ -112,5 +112,6 @@ export function createMockTimeSlotListService(config = {}) {
                 dateRangeSignal.set({ start, end });
             }),
         },
+        dispose: vi.fn(),
     };
 }

package/dist/api/index.d.ts

@@ -4,12 +4,12 @@
  *
  * @module API
  */
-export { getServiceById, getServiceBySlug, queryServices, type PagingMetadata, type ServiceListFilters, type QueryServicesRequest, } from './query-services/index.js';
+export { getServiceById, getServiceBySlug, queryServices, type PagingMetadata, type ServiceListFilters, 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 { queryLocations, type QueryLocationsResult, type LocationData, } from './query-locations/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:

package/dist/api/index.js

@@ -4,12 +4,12 @@
  *
  * @module API
  */
-export { getServiceById, getServiceBySlug, queryServices, } from './query-services/index.js';
+export { getServiceById, getServiceBySlug, queryServices, SYNTHETIC_CUSTOM_ID, SYNTHETIC_CUSTOMER_ID, } from './query-services/index.js';
 export { fetchAvailability } from './fetch-availability/index.js';
 export { createBooking, } from './create-booking/index.js';
 export { createCheckout, ChannelType, } from './create-checkout/index.js';
 export { createOrder, } from './create-order/index.js';
-export { queryLocations, } from './query-locations/index.js';
+export { queryLocations, getLocationById, } from './query-locations/index.js';
 export { queryCategories, } from './query-categories/index.js';
 /**
  * PagingMetadata includes:

package/dist/api/query-locations/index.d.ts

@@ -36,3 +36,17 @@ export interface QueryLocationsResult {
  * ```
  */
 export declare function queryLocations(): Promise<QueryLocationsResult>;
+/**
+ * Fetches a single location by its business location ID
+ * @param locationId - The business location ID (GUID)
+ * @returns Promise resolving to the location or null if not found
+ *
+ * @example
+ * ```ts
+ * const location = await getLocationById('12345678-1234-1234-1234-123456789012');
+ * if (location) {
+ *   console.log(location.business?.name);
+ * }
+ * ```
+ */
+export declare function getLocationById(locationId: string): Promise<LocationData | null>;

package/dist/api/query-locations/index.js

@@ -28,3 +28,30 @@ export async function queryLocations() {
         hasCustomerLocations: response.customerLocations?.exists || false,
     };
 }
+/**
+ * Fetches a single location by its business location ID
+ * @param locationId - The business location ID (GUID)
+ * @returns Promise resolving to the location or null if not found
+ *
+ * @example
+ * ```ts
+ * const location = await getLocationById('12345678-1234-1234-1234-123456789012');
+ * if (location) {
+ *   console.log(location.business?.name);
+ * }
+ * ```
+ */
+export async function getLocationById(locationId) {
+    try {
+        const response = await queryLocationsApi({
+            filter: {
+                businessLocationIds: [locationId],
+            },
+        });
+        return response.businessLocations?.locations?.[0] ?? null;
+    }
+    catch (error) {
+        console.error(`Failed to load location for id "${locationId}":`, error);
+        return null;
+    }
+}

package/dist/api/query-services/index.d.ts

@@ -3,6 +3,11 @@
  * Fetches single or multiple services with pagination and sorting
  */
 import { type Service, type Paging, type Sorting } from '@wix/auto_sdk_bookings_services';
+/**
+ * Synthetic location ID constants for non-business locations
+ */
+export declare const SYNTHETIC_CUSTOM_ID = "custom";
+export declare const SYNTHETIC_CUSTOMER_ID = "customer";
 /**
  * Paging metadata from query services response.
  * Extends the SDK's Paging type with hasNext flag to indicate if more services are available.

package/dist/api/query-services/index.js

@@ -10,8 +10,8 @@ const BOOKING_APP_ID = '13d21c63-b5ec-5912-8397-c3a5ddb27a97';
 /**
  * Synthetic location ID constants for non-business locations
  */
-const SYNTHETIC_CUSTOM_ID = '__synthetic_custom__';
-const SYNTHETIC_CUSTOMER_ID = '__synthetic_customer__';
+export const SYNTHETIC_CUSTOM_ID = 'custom';
+export const SYNTHETIC_CUSTOMER_ID = 'customer';
 /**
  * Fetches a service by its ID
  * @param id - The service ID

package/dist/react/core/location/Location.d.ts

@@ -27,6 +27,8 @@ export interface SyntheticLocation {
     synthetic: true;
     /** Optional ID for tracking (matches ServiceLocation._id) */
     _id?: string;
+    /** Optional name/label for the location */
+    name?: string;
 }
 /**
  * Union type - location prop accepts Service or Synthetic location

package/dist/react/core/location/Location.js

@@ -106,10 +106,23 @@ function computeLocationRenderProps(rawLocation) {
     if (isSyntheticLocation(rawLocation)) {
         const syntheticLoc = rawLocation;
         const locationType = syntheticLoc.locationType;
+        // Use provided name or default based on location type
+        let name;
+        if (syntheticLoc.name) {
+            name = syntheticLoc.name;
+        }
+        else {
+            name =
+                locationType === LocationType.CUSTOM
+                    ? 'Custom Locations'
+                    : locationType === LocationType.CUSTOMER
+                        ? "Client's Place"
+                        : undefined;
+        }
         return {
             locationType,
             address: null,
-            name: undefined,
+            name,
             locationId: syntheticLoc._id,
             isCustomerLocation: locationType === LocationType.CUSTOMER,
             isCustomLocation: locationType === LocationType.CUSTOM,

package/dist/react/core/time-slot-list/TimeSlot.js

@@ -82,7 +82,6 @@ export function Info(props) {
     const endDate = new Date(timeSlot.localEndDate);
     const locationName = timeSlot.location?.name ?? '';
     const bookable = timeSlot.bookable ?? false;
-    // Calculate duration from start and end dates
     const durationInMinutes = Math.round((endDate.getTime() - startDate.getTime()) / (1000 * 60));
     return props.children({
         startDate,
@@ -166,7 +165,6 @@ export function StaffMembers(props) {
     const bookingService = useService(BookingServiceDefinition);
     const selectedStaffMemberId = bookingService.serviceSelections.get()[0]?.timeSlot?.resources?.[0]?._id;
     const staffMembers = timeSlot.availableResources[0].resources;
-    // Return null if only 1 staff member - nothing to choose from
     if (staffMembers.length <= 1) {
         return null;
     }

package/dist/react/core/time-slot-list/TimeSlotList.js

@@ -1,4 +1,9 @@
 import { jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
+/**
+ * Core TimeSlotList Components
+ * Provides low-level access to TimeSlotListService via render props
+ */
+import React from 'react';
 import { useService, WixServices } from '@wix/services-manager-react';
 import { createServicesMap } from '@wix/services-manager';
 import { TimeSlotListServiceDefinition, TimeSlotListService, } from '../../../services/time-slot-list/index.js';
@@ -28,18 +33,20 @@ export function Root(props) {
  * Internal component that wraps navigateToBookingForm to handle optional parameters
  */
 function RootContent({ navigateToBookingForm: providedNavigateToBookingForm, children, }) {
-    // Get BookingService to use when timeSlot/service are not provided
+    const timeSlotListService = useService(TimeSlotListServiceDefinition);
+    React.useEffect(() => {
+        return () => {
+            timeSlotListService.dispose();
+        };
+    }, [timeSlotListService]);
     let bookingService = null;
     try {
         bookingService = useService(BookingServiceDefinition);
     }
     catch {
-        // BookingService not available - that's ok, user must provide timeSlot/service
         bookingService = null;
     }
-    // Wrap the provided navigateToBookingForm to handle optional parameters
     const navigateToBookingForm = async ({ timeSlot, service, }) => {
-        // If timeSlot or service are not provided, try to get them from BookingService
         let resolvedTimeSlot = timeSlot;
         let resolvedService = service;
         if ((!resolvedTimeSlot || !resolvedService) && bookingService) {
@@ -52,14 +59,12 @@ function RootContent({ navigateToBookingForm: providedNavigateToBookingForm, chi
                 }
             }
         }
-        // Validate that we have both timeSlot and service
         if (!resolvedTimeSlot) {
             throw new Error('timeSlot is required. Either provide it as a parameter or ensure BookingService has a service selection with a timeSlot.');
         }
         if (!resolvedService) {
             throw new Error('service is required. Either provide it as a parameter or ensure BookingService has a service selection.');
         }
-        // Call the provided function with resolved values
         return providedNavigateToBookingForm({
             timeSlot: resolvedTimeSlot,
             service: resolvedService,

package/dist/react/index.d.ts

@@ -1,5 +1,4 @@
 export * as Booking from './booking/Booking.js';
-export * as BookingForm from './booking-form/BookingForm.js';
 export * as Service from './service/Service.js';
 export * as ServiceMedia from './service/ServiceMedia.js';
 export * as TimeSlotList from './time-slot-list/TimeSlotList.js';

package/dist/react/index.js

@@ -1,5 +1,5 @@
 export * as Booking from './booking/Booking.js';
-export * as BookingForm from './booking-form/BookingForm.js';
+// export * as BookingForm from './booking-form/BookingForm.js';
 export * as Service from './service/Service.js';
 export * as ServiceMedia from './service/ServiceMedia.js';
 export * as TimeSlotList from './time-slot-list/TimeSlotList.js';

package/dist/react/location/Location.d.ts

@@ -23,6 +23,10 @@ export interface RootProps {
     children?: React.ReactNode | AsChildChildren<CoreLocation.LocationRenderProps>;
     /** CSS class name */
     className?: string;
+    /** Custom label for CUSTOM location type */
+    customLocationLabel?: string;
+    /** Custom label for CUSTOMER location type */
+    customerLocationLabel?: string;
     /** Data attributes */
     [key: `data-${string}`]: string | undefined;
 }

package/dist/react/location/Location.js

@@ -9,6 +9,7 @@ import React from 'react';
 import * as CoreLocation from '../core/location/Location.js';
 import { AsChildSlot } from '@wix/headless-utils/react';
 import { Address } from '@wix/headless-components/react';
+import { LocationType } from '../../services/location-list/location-list.def.js';
 // Re-export useLocationContext from core
 export { useLocationContext } from '../core/location/Location.js';
 // ==========================================
@@ -63,10 +64,27 @@ const useLocationContext = CoreLocation.useLocationContext;
  * ```
  */
 export const Root = React.forwardRef((props, ref) => {
-    const { location, asChild, children, className, ...attrs } = props;
+    const { location, asChild, children, className, customLocationLabel, customerLocationLabel, ...attrs } = props;
     // Extract data-* attributes
     const dataAttrs = Object.fromEntries(Object.entries(attrs).filter(([key]) => key.startsWith('data-')));
-    return (_jsx(CoreLocation.Root, { location: location, children: _jsx(CoreLocation.Data, { children: (renderProps) => (_jsx(AsChildSlot, { ref: ref, asChild: asChild, className: className, "data-testid": TestIds.locationRoot, "data-location-type": renderProps.locationType, customElement: children, customElementProps: renderProps, ...dataAttrs, children: children })) }) }));
+    // If location is synthetic and labels are provided, update the synthetic location's name
+    let processedLocation = location;
+    if (location && 'synthetic' in location && location.synthetic === true) {
+        const syntheticLoc = location;
+        const shouldUpdateName = (syntheticLoc.locationType === LocationType.CUSTOM &&
+            customLocationLabel !== undefined) ||
+            (syntheticLoc.locationType === LocationType.CUSTOMER &&
+                customerLocationLabel !== undefined);
+        if (shouldUpdateName) {
+            processedLocation = {
+                ...syntheticLoc,
+                name: syntheticLoc.locationType === LocationType.CUSTOM
+                    ? customLocationLabel
+                    : customerLocationLabel,
+            };
+        }
+    }
+    return (_jsx(CoreLocation.Root, { location: processedLocation, children: _jsx(CoreLocation.Data, { children: (renderProps) => (_jsx(AsChildSlot, { ref: ref, asChild: asChild, className: className, "data-testid": TestIds.locationRoot, "data-location-type": renderProps.locationType, customElement: children, customElementProps: renderProps, ...dataAttrs, children: children })) }) }));
 });
 Root.displayName = 'Location.Root';
 /**

package/dist/react/location/LocationList.d.ts

@@ -17,6 +17,10 @@ export interface RootProps {
     locationListConfig?: LocationListServiceConfig;
     className?: string;
     variant?: ListVariant;
+    /** Custom label for CUSTOM location type */
+    customLocationLabel?: string;
+    /** Custom label for CUSTOMER location type */
+    customerLocationLabel?: string;
 }
 /**
  * Root component that provides the LocationList service context for rendering locations lists.

package/dist/react/location/LocationList.js

@@ -9,9 +9,15 @@ import React from 'react';
 import { GenericList, } from '@wix/headless-components/react';
 import { AsChildSlot } from '@wix/headless-utils/react';
 import { useService } from '@wix/services-manager-react';
+import { LocationType, } from '../../services/location-list/location-list.def.js';
 import { BookingServiceDefinition } from '../../services/booking/booking.js';
 import * as CoreLocationList from '../core/location-list/LocationList.js';
 import * as Location from './Location.js';
+const LocationLabelsContext = React.createContext(null);
+function useLocationLabelsContext() {
+    const context = React.useContext(LocationLabelsContext);
+    return context || {};
+}
 // ============================================================================
 // TestIds
 // ============================================================================
@@ -45,11 +51,11 @@ var TestIds;
  * ```
  */
 export const Root = React.forwardRef((props, ref) => {
-    const { children, locationListConfig, className, variant } = props;
+    const { children, locationListConfig, className, variant, customLocationLabel, customerLocationLabel, } = props;
     const config = locationListConfig || {
         locations: [],
     };
-    return (_jsx(CoreLocationList.Root, { locationListServiceConfig: config, children: _jsx(RootContent, { className: className, ref: ref, variant: variant, children: children }) }));
+    return (_jsx(LocationLabelsContext.Provider, { value: { customLocationLabel, customerLocationLabel }, children: _jsx(CoreLocationList.Root, { locationListServiceConfig: config, children: _jsx(RootContent, { className: className, ref: ref, variant: variant, children: children }) }) }));
 });
 Root.displayName = 'LocationList.Root';
 /**
@@ -85,15 +91,35 @@ export const Locations = React.forwardRef((props, ref) => {
 Locations.displayName = 'LocationList.Locations';
 export const LocationRepeater = React.forwardRef((props, ref) => {
     const { children } = props;
+    const { customLocationLabel, customerLocationLabel } = useLocationLabelsContext();
     // Custom itemWrapper that wraps each item in Location.Root
     const locationItemWrapper = ({ item: displayLocation, children: itemChildren, }) => {
         // Convert DisplayLocation to LocationInput
         // If location is null, create a SyntheticLocation
-        const location = displayLocation.location ?? {
-            locationType: displayLocation.type,
-            synthetic: true,
-            _id: displayLocation.id,
-        };
+        let location;
+        if (displayLocation.location) {
+            location = displayLocation.location;
+        }
+        else {
+            const locationType = displayLocation.type;
+            // Determine the name based on labels or defaults
+            let name;
+            if (locationType === LocationType.CUSTOM &&
+                customLocationLabel !== undefined) {
+                name = customLocationLabel;
+            }
+            else if (locationType === LocationType.CUSTOMER &&
+                customerLocationLabel !== undefined) {
+                name = customerLocationLabel;
+            }
+            // If no label provided, name will be undefined and defaults will be used in computeLocationRenderProps
+            location = {
+                locationType,
+                synthetic: true,
+                _id: displayLocation.id,
+                name,
+            };
+        }
         return (_jsx(Location.Root, { location: location, "data-testid": TestIds.locationListLocation, "data-location-id": displayLocation.id, "data-location-type": displayLocation.type, "data-item-id": displayLocation.id, children: itemChildren }, displayLocation.id));
     };
     return (_jsx(GenericList.Repeater, { ref: ref, itemWrapper: locationItemWrapper, children: children }));

package/dist/react/time-slot-list/TimeSlotList.js

@@ -86,12 +86,8 @@ Timezone.displayName = 'TimeSlotList.Timezone';
  */
 export const Root = React.forwardRef((props, ref) => {
     const { children, config, className, variant, navigateToBookingForm: providedNavigateToBookingForm, } = props;
-    // Wrap defaultNavigateToBookingForm to match optional parameter signature
-    // The core component will handle getting timeSlot/service from BookingService if not provided
     const navigateToBookingForm = providedNavigateToBookingForm ||
         (async ({ timeSlot, service, }) => {
-            // This will be handled by the core component's wrapper
-            // which will resolve timeSlot/service from BookingService if needed
             if (!timeSlot || !service) {
                 throw new Error('timeSlot and service are required when using default navigation. Either provide them or ensure BookingService has service selections.');
             }

package/dist/services/index.d.ts

@@ -6,8 +6,9 @@ export { ServiceService, ServiceServiceDefinition, type ServiceServiceAPI, type
 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 ServiceListFilters, 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 { BookingFormService, BookingFormServiceDefinition, type BookingFormServiceAPI, type BookingFormServiceConfig, type BookingFormServiceInternalAPI, type ValidationResult, } 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 { LocationListService, LocationListServiceDefinition, LocationType, loadLocationListServiceInitialData, locationListServiceBinding, type LocationListServiceAPI, type LocationListServiceConfig, type LocationListActions, type LocationData, type DisplayLocation, type LoadLocationListServiceResult, } from './location-list/location-list.js';
+export { LocationListService, LocationListServiceDefinition, LocationType, loadLocationListServiceInitialData, locationListServiceBinding, type LocationListServiceAPI, type LocationListServiceConfig, type LocationListActions, type LocationData, type DisplayLocation, 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/index.js

@@ -6,8 +6,9 @@ export { ServiceService, ServiceServiceDefinition, loadServiceServiceInitialData
 export { BookingService, BookingServiceDefinition, } from './booking/booking.js';
 export { TimeSlotListService, TimeSlotListServiceDefinition, TimeSlotService, TimeSlotServiceDefinition, ViewMode, loadTimeSlotListConfig, } from './time-slot-list/index.js';
 export { ServiceListService, ServiceListServiceDefinition, loadServiceListServiceInitialData, } from './service-list/service-list.js';
+export { SYNTHETIC_CUSTOM_ID, SYNTHETIC_CUSTOMER_ID, } from '../api/query-services/index.js';
 export { executeBookAction, canBook, buildBookingRequest, buildCheckoutRequest, } from './booking/book-action/index.js';
 export { BookingFormService, BookingFormServiceDefinition, } from './booking-form/booking-form.js';
 export { PaymentService, PaymentServiceDefinition, loadPaymentConfig, } from './payment/payment.js';
-export { LocationListService, LocationListServiceDefinition, LocationType, loadLocationListServiceInitialData, locationListServiceBinding, } from './location-list/location-list.js';
+export { LocationListService, LocationListServiceDefinition, LocationType, loadLocationListServiceInitialData, locationListServiceBinding, getLocationById, } from './location-list/location-list.js';
 export { StaffMemberListService, StaffMemberListServiceDefinition, loadStaffMemberListServiceInitialData, staffMemberListServiceBinding, } from './staff-member-list/staff-member-list.js';

package/dist/services/location-list/location-list.d.ts

@@ -6,6 +6,7 @@
  */
 import type { ServiceFactoryConfig } from '@wix/services-definitions';
 import { type LocationData } from './location-list.def.js';
+export { getLocationById } from '../../api/query-locations/index.js';
 /**
  * Configuration interface for LocationListService
  */

package/dist/services/location-list/location-list.js

@@ -10,14 +10,15 @@ import { LocationType } from '@wix/auto_sdk_bookings_services';
 import { LocationListServiceDefinition, } from './location-list.def.js';
 import { BookingServiceDefinition } from '../booking/booking.js';
 import { queryLocations } from '../../api/query-locations/index.js';
+export { getLocationById } from '../../api/query-locations/index.js';
 // ============================================================================
 // Constants
 // ============================================================================
 /**
  * Synthetic location IDs for non-business locations
  */
-const SYNTHETIC_CUSTOM_ID = '__synthetic_custom__';
-const SYNTHETIC_CUSTOMER_ID = '__synthetic_customer__';
+const SYNTHETIC_CUSTOM_ID = 'custom';
+const SYNTHETIC_CUSTOMER_ID = 'customer';
 // ============================================================================
 // Helper Functions
 // ============================================================================

package/dist/services/time-slot-list/time-slot-list.def.d.ts

@@ -88,6 +88,7 @@ export interface TimeSlotListServiceAPI {
     hasMore: Signal<boolean>;
     dateRange: Signal<DateRange>;
     actions: TimeSlotListServiceActions;
+    dispose: () => void;
 }
 export declare const TimeSlotListServiceDefinition: string & {
     __api: TimeSlotListServiceAPI;

package/dist/services/time-slot-list/time-slot-list.js

@@ -19,15 +19,12 @@ function getClientTimezone() {
 // Service Implementation
 // ============================================================================
 export const TimeSlotListService = implementService.withConfig()(TimeSlotListServiceDefinition, ({ getService, config }) => {
-    // Get dependent services
     const signalsService = getService(SignalsServiceDefinition);
     const bookingService = getService(BookingServiceDefinition);
-    // Initialize Signals
     const timeSlotsSignal = signalsService.signal(config.timeSlots || []);
     const isLoadingSignal = signalsService.signal(false);
     const errorSignal = signalsService.signal(null);
     const hasMoreSignal = signalsService.signal(false);
-    // Internal only - viewMode is auto-detected based on service types
     const viewModeSignal = signalsService.signal(ViewMode.CLASSIC);
     const dateRangeSignal = signalsService.signal({
         start: config.startDate,
@@ -201,8 +198,7 @@ export const TimeSlotListService = implementService.withConfig()(TimeSlotListSer
             : undefined;
     });
     let isFirstRun = true;
-    signalsService.effect(() => {
-        // Dependencies - trigger refetch when these change
+    const dispose = signalsService.effect(() => {
         dateRangeSignal.get();
         bookingService.timezone.get();
         bookingService.location.get();
@@ -215,16 +211,12 @@ export const TimeSlotListService = implementService.withConfig()(TimeSlotListSer
         }
         fetchTimeSlots();
     });
-    // Return service API
     return {
-        // State Signals
         timeSlots: timeSlotsSignal,
         isLoading: isLoadingSignal,
         error: errorSignal,
         hasMore: hasMoreSignal,
-        // Configuration Signals (viewMode is internal only)
         dateRange: dateRangeSignal,
-        // Actions
         actions: {
             selectSlot,
             selectStaffMember,
@@ -232,6 +224,7 @@ export const TimeSlotListService = implementService.withConfig()(TimeSlotListSer
             loadMore,
             setDateRange,
         },
+        dispose,
     };
 });
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/headless-bookings",
-  "version": "0.0.62",
+  "version": "0.0.63",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -72,5 +72,5 @@
       "groupId": "com.wixpress.headless-components"
     }
   },
-  "falconPackageHash": "a7ee3575b035403add534d60cde7f1bc57053324c9c08aa82811ca8b"
+  "falconPackageHash": "96083b204b0065686724c6e3b5716295e35a12be6db784974a6c924d"
 }