@wix/headless-bookings 0.0.43 → 0.0.45

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

@@ -1,9 +1,14 @@
-/**
- * Shared mock data for booking service tests
- */
 import type { Resource } from '@wix/auto_sdk_bookings_availability-time-slots';
 import type { FormValues } from '@wix/form-public';
-import type { ServiceSelection, ServiceSelectionTimeSlot, BookingServiceConfig } from '../services/booking/booking.js';
+import type { ServiceSelection, ServiceSelectionTimeSlot, BookingServiceConfig, BookingService } from '../services/booking/booking.js';
+import type { Signal } from '@wix/services-definitions/core-services/signals';
+export declare function mockSignal<T>(initialValue: T): Signal<T>;
+export declare function createMockSignalsService(): {
+    signal: typeof mockSignal;
+    computed: <T>(fn: () => T) => Signal<T>;
+    effect: (fn: () => void) => void;
+};
+export declare function createMockBookingService(initialSelections?: ServiceSelection[]): BookingService;
 /**
  * Mock resource (staff member)
  */

package/cjs/dist/__mocks__/booking.js

@@ -1,7 +1,52 @@
-/**
- * Shared mock data for booking service tests
- */
 import { mockService, mockServiceClass } from './services.js';
+import { vi } from 'vitest';
+export function mockSignal(initialValue) {
+    let value = initialValue;
+    return {
+        get: () => value,
+        peek: () => value,
+        set: (newValue) => {
+            value = newValue;
+        },
+    };
+}
+export function createMockSignalsService() {
+    return {
+        signal: mockSignal,
+        computed: (fn) => mockSignal(fn()),
+        effect: vi.fn((fn) => {
+            fn();
+        }),
+    };
+}
+export function createMockBookingService(initialSelections = []) {
+    const serviceSelectionsSignal = mockSignal(initialSelections);
+    const locationSignal = mockSignal(null);
+    const timezoneSignal = mockSignal('UTC');
+    const formSubmissionSignal = mockSignal(null);
+    return {
+        serviceSelections: serviceSelectionsSignal,
+        location: locationSignal,
+        timezone: timezoneSignal,
+        formSubmission: formSubmissionSignal,
+        actions: {
+            updateItem: vi.fn(),
+            setItem: vi.fn(),
+            addItem: vi.fn(),
+            removeItem: vi.fn(),
+            clearItems: vi.fn(),
+            setResourceById: vi.fn(),
+            getResourceById: vi.fn(),
+            setLocation: vi.fn(),
+            clearLocation: vi.fn(),
+            setTimezone: vi.fn(),
+            setFormSubmission: vi.fn(),
+            clearFormSubmission: vi.fn(),
+            clearAll: vi.fn(),
+            book: vi.fn(),
+        },
+    };
+}
 /**
  * Mock resource (staff member)
  */

package/cjs/dist/__mocks__/time-slots.d.ts

@@ -0,0 +1,28 @@
+import type { TimeSlot } from '@wix/auto_sdk_bookings_availability-time-slots';
+import type { TimeSlotListServiceConfig, TimeSlotListServiceAPI } from '../services/time-slot-list/time-slot-list.def.js';
+import type { BookingService } from '../services/booking/booking.js';
+export declare function createTimeSlotListService(overrides?: Partial<TimeSlotListServiceConfig>): {
+    service: TimeSlotListServiceAPI;
+    bookingService: BookingService;
+};
+export declare function createTimeSlot(overrides?: Partial<TimeSlot>): TimeSlot;
+export declare function createTimeSlots(count: number): TimeSlot[];
+export declare function createTimeSlotListConfig(overrides?: Partial<TimeSlotListServiceConfig>): TimeSlotListServiceConfig;
+export declare const mockTimeSlot: TimeSlot;
+export declare const mockTimeSlotMultipleStaff: TimeSlot;
+export declare const mockTimeSlotNotBookable: TimeSlot;
+export declare const mockTimeSlots: TimeSlot[];
+export declare const mockStartDate: Date;
+export declare const mockEndDate: Date;
+export declare const mockTimezone = "America/New_York";
+export declare const mockTimeSlotListConfig: TimeSlotListServiceConfig;
+export declare const mockEmptyTimeSlotListConfig: TimeSlotListServiceConfig;
+export declare const mockCursorPagingMetadataWithMore: {
+    cursors: {
+        next: string;
+    };
+};
+export declare const mockCursorPagingMetadataNoMore: {
+    cursors: {};
+};
+export declare function createMockTimeSlotListService(config?: Partial<TimeSlotListServiceConfig>): TimeSlotListServiceAPI;

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

@@ -0,0 +1,116 @@
+import { vi } from 'vitest';
+import { TimeSlotListService } from '../services/time-slot-list/time-slot-list.js';
+import { createMockBookingService, createMockSignalsService, mockSignal, } from './booking.js';
+export function createTimeSlotListService(overrides = {}) {
+    const config = createTimeSlotListConfig(overrides);
+    const mockBookingService = createMockBookingService();
+    const mockSignalsService = createMockSignalsService();
+    const getService = (definition) => {
+        const def = definition;
+        if (def.name === 'signals') {
+            return mockSignalsService;
+        }
+        if (def.name === 'booking') {
+            return mockBookingService;
+        }
+        throw new Error(`Unknown service: ${def.name}`);
+    };
+    const service = TimeSlotListService({
+        getService,
+        config,
+    });
+    return {
+        service,
+        bookingService: mockBookingService,
+    };
+}
+export function createTimeSlot(overrides = {}) {
+    return {
+        localStartDate: '2024-01-15T10:00:00',
+        localEndDate: '2024-01-15T11:00:00',
+        bookable: true,
+        totalCapacity: 10,
+        remainingCapacity: 5,
+        scheduleId: 'schedule-1',
+        location: { _id: 'loc-1', name: 'Main Office' },
+        availableResources: [{ resources: [{ _id: 'staff-1', name: 'John Doe' }] }],
+        ...overrides,
+    };
+}
+export function createTimeSlots(count) {
+    return Array.from({ length: count }, (_, i) => createTimeSlot({
+        localStartDate: `2024-01-15T${String(9 + (i % 8)).padStart(2, '0')}:00:00`,
+        localEndDate: `2024-01-15T${String(10 + (i % 8)).padStart(2, '0')}:00:00`,
+        scheduleId: `schedule-${i}`,
+    }));
+}
+export function createTimeSlotListConfig(overrides = {}) {
+    const { startDate = new Date('2024-01-15T00:00:00'), endDate = new Date('2024-01-22T00:00:00'), timezone = 'America/New_York', timeSlots, ...rest } = overrides;
+    return {
+        startDate,
+        endDate,
+        timezone,
+        ...rest,
+        ...(timeSlots !== undefined ? { timeSlots } : {}),
+    };
+}
+export const mockTimeSlot = createTimeSlot();
+export const mockTimeSlotMultipleStaff = createTimeSlot({
+    availableResources: [
+        {
+            resources: [
+                { _id: 'staff-1', name: 'John Doe' },
+                { _id: 'staff-2', name: 'Jane Smith' },
+            ],
+        },
+    ],
+});
+export const mockTimeSlotNotBookable = createTimeSlot({
+    localStartDate: '2024-01-15T14:00:00',
+    localEndDate: '2024-01-15T15:00:00',
+    bookable: false,
+    remainingCapacity: 0,
+    location: { _id: 'loc-2', name: 'Downtown Branch' },
+});
+export const mockTimeSlots = [
+    mockTimeSlot,
+    mockTimeSlotMultipleStaff,
+    mockTimeSlotNotBookable,
+];
+export const mockStartDate = new Date('2024-01-15T00:00:00');
+export const mockEndDate = new Date('2024-01-22T00:00:00');
+export const mockTimezone = 'America/New_York';
+export const mockTimeSlotListConfig = createTimeSlotListConfig({
+    timeSlots: mockTimeSlots,
+});
+export const mockEmptyTimeSlotListConfig = createTimeSlotListConfig();
+export const mockCursorPagingMetadataWithMore = {
+    cursors: { next: 'next-cursor-token' },
+};
+export const mockCursorPagingMetadataNoMore = { cursors: {} };
+export function createMockTimeSlotListService(config = {}) {
+    const timeSlotsSignal = mockSignal(config.timeSlots || []);
+    const isLoadingSignal = mockSignal(false);
+    const errorSignal = mockSignal(null);
+    const hasMoreSignal = mockSignal(false);
+    const dateRangeSignal = mockSignal({
+        start: config.startDate || mockStartDate,
+        end: config.endDate || mockEndDate,
+    });
+    return {
+        timeSlots: timeSlotsSignal,
+        isLoading: isLoadingSignal,
+        error: errorSignal,
+        hasMore: hasMoreSignal,
+        dateRange: dateRangeSignal,
+        actions: {
+            selectSlot: vi.fn(),
+            selectStaffMember: vi.fn(),
+            clearStaffSelection: vi.fn(),
+            loadMore: vi.fn(),
+            setDateRange: vi.fn((start, end) => {
+                dateRangeSignal.set({ start, end });
+            }),
+        },
+    };
+}

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

@@ -8,6 +8,7 @@ export { getServiceById, getServiceBySlug, queryServices, type PagingMetadata, t
 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 { queryLocations, type QueryLocationsResult, type LocationData, } from './query-locations/index.js';
 /**
  * PagingMetadata includes:
  * - limit: Number of items per page

package/cjs/dist/api/index.js

@@ -8,6 +8,7 @@ export { getServiceById, getServiceBySlug, queryServices, } from './query-servic
 export { fetchAvailability } from './fetch-availability/index.js';
 export { createBooking, } from './create-booking/index.js';
 export { createCheckout, ChannelType, } from './create-checkout/index.js';
+export { queryLocations, } from './query-locations/index.js';
 /**
  * PagingMetadata includes:
  * - limit: Number of items per page

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

@@ -0,0 +1,38 @@
+/**
+ * Query Locations API
+ * Fetches business locations from Wix Bookings Services
+ *
+ * @module API/QueryLocations
+ */
+import type { Service } from '@wix/auto_sdk_bookings_services';
+/**
+ * LocationData type - from Service['locations'][number]
+ */
+export type LocationData = NonNullable<Service['locations']>[number];
+/**
+ * Result from querying locations
+ */
+export interface QueryLocationsResult {
+    /** Business locations array */
+    locations: LocationData[];
+    /** Whether custom locations exist for any service */
+    hasCustomLocations: boolean;
+    /** Whether customer locations (at customer's place) exist for any service */
+    hasCustomerLocations: boolean;
+}
+/**
+ * Query all locations connected to services.
+ * Returns business locations array and existence flags for custom/customer locations.
+ *
+ * @returns Promise resolving to locations and existence flags
+ *
+ * @example
+ * ```ts
+ * const { locations, hasCustomLocations, hasCustomerLocations } = await queryLocations();
+ *
+ * // locations contains all business locations
+ * // hasCustomLocations indicates if any service uses custom locations
+ * // hasCustomerLocations indicates if any service is at customer's place
+ * ```
+ */
+export declare function queryLocations(): Promise<QueryLocationsResult>;

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

@@ -0,0 +1,30 @@
+/**
+ * Query Locations API
+ * Fetches business locations from Wix Bookings Services
+ *
+ * @module API/QueryLocations
+ */
+import { queryLocations as queryLocationsApi, } from '@wix/auto_sdk_bookings_services';
+/**
+ * Query all locations connected to services.
+ * Returns business locations array and existence flags for custom/customer locations.
+ *
+ * @returns Promise resolving to locations and existence flags
+ *
+ * @example
+ * ```ts
+ * const { locations, hasCustomLocations, hasCustomerLocations } = await queryLocations();
+ *
+ * // locations contains all business locations
+ * // hasCustomLocations indicates if any service uses custom locations
+ * // hasCustomerLocations indicates if any service is at customer's place
+ * ```
+ */
+export async function queryLocations() {
+    const response = await queryLocationsApi();
+    return {
+        locations: (response.businessLocations?.locations || []),
+        hasCustomLocations: response.customLocations?.exists || false,
+        hasCustomerLocations: response.customerLocations?.exists || false,
+    };
+}

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

@@ -2,6 +2,8 @@
  * Core Location Component - Parses service location data
  * Handles business, custom, and customer location types
  * Converts location data to Address component format
+ *
+ * @module Core/Location
  */
 import React from 'react';
 import { LocationType, type Service } from '@wix/auto_sdk_bookings_services';
@@ -10,35 +12,132 @@ import type { AddressData as AddressDataType } from '@wix/headless-components/re
  * Re-export AddressData type from Address component for convenience
  */
 export type AddressData = AddressDataType;
+/**
+ * Service location type - from Service['locations'][number]
+ */
+export type ServiceLocation = NonNullable<Service['locations']>[number];
+/**
+ * Synthetic location - represents a location type without real data
+ * Used for CUSTOMER or CUSTOM locations when no real location data exists
+ */
+export interface SyntheticLocation {
+    /** Location type */
+    locationType: LocationType.CUSTOMER | LocationType.CUSTOM;
+    /** Marker to identify synthetic locations */
+    synthetic: true;
+    /** Optional ID for tracking */
+    id?: string;
+}
+/**
+ * Union type - location prop accepts Service or Synthetic location
+ */
+export type LocationInput = ServiceLocation | SyntheticLocation;
 /**
  * Location render props passed to children
  */
 export interface LocationRenderProps {
+    /** Location type */
     locationType: LocationType;
+    /** Parsed address data compatible with Address.Root, null if not available */
     address: AddressData | null;
+    /** Location name (business.name or custom name) */
+    name: string | undefined;
+    /** Location ID */
+    locationId: string | undefined;
+    /** Whether this is a customer location */
+    isCustomerLocation: boolean;
+    /** Whether this is a custom location */
+    isCustomLocation: boolean;
+    /** Whether this is a synthetic entry (not from array) */
+    isSynthetic: boolean;
+    /** Phone number (only for BUSINESS ServiceLocations) */
+    phone: string | undefined;
+    /** Email address (only for BUSINESS ServiceLocations) */
+    email: string | undefined;
+    /** Raw location object (Service or Synthetic location) */
+    rawLocation: LocationInput | null;
 }
 /**
- * Props for the core Location component
+ * Props for the Core Location Root component
  */
-export interface LocationProps {
-    location: NonNullable<Service['locations']>[number];
+export interface RootProps {
+    /** Raw location data - accepts Service or Synthetic location */
+    location?: LocationInput;
+    /** Children */
+    children: React.ReactNode;
+}
+/**
+ * Props for the Core Location Data component
+ */
+export interface DataProps {
+    /** Children render prop that receives location data */
     children: (props: LocationRenderProps) => React.ReactNode;
 }
 /**
- * Core Location component that parses service location data
- * and provides location type and address data to children
+ * Hook to access location context from CoreLocation.Root
+ * @throws Error if used outside of CoreLocation.Root
+ */
+export declare function useLocationContext(): LocationRenderProps;
+/**
+ * Core Location Root component that provides location context.
+ * Parses location data and makes it available to all child components via context.
+ *
+ * @component
+ * @example
+ * ```tsx
+ * <CoreLocation.Root location={serviceLocation}>
+ *   <Location.Name />
+ *   <Location.Address />
+ * </CoreLocation.Root>
+ * ```
+ */
+export declare function Root(props: RootProps): React.ReactNode;
+/**
+ * Core Location Data component that exposes location data via render props.
+ * Must be used within a CoreLocation.Root component.
+ *
+ * @component
+ * @example
+ * ```tsx
+ * <CoreLocation.Root location={serviceLocation}>
+ *   <CoreLocation.Data>
+ *     {({ displayName, address }) => (
+ *       <div>
+ *         <span>{displayName}</span>
+ *         {address && <Address.Formatted address={address} />}
+ *       </div>
+ *     )}
+ *   </CoreLocation.Data>
+ * </CoreLocation.Root>
+ * ```
+ */
+export declare function Data(props: DataProps): React.ReactNode;
+/**
+ * Props for Actions render prop component
+ */
+export interface ActionsProps {
+    children: (actions: {
+        select: () => void;
+        rawLocation: LocationInput | null;
+        selected: boolean;
+    }) => React.ReactNode;
+}
+/**
+ * Core component that provides location selection actions via render props.
+ * Sets the location in BookingService when select is called.
  *
  * @component
  * @example
  * ```tsx
- * <CoreLocation location={serviceLocation}>
- *   {({ locationType, address }) => (
- *     <div>
- *       <span>Type: {locationType}</span>
- *       {address && <Address.Root address={address}><Address.Formatted /></Address.Root>}
- *     </div>
- *   )}
- * </CoreLocation>
+ * <CoreLocation.Root location={serviceLocation}>
+ *   <CoreLocation.Actions>
+ *     {({ select, selected, rawLocation }) => (
+ *       <button onClick={select}>
+ *         {selected ? 'Selected' : 'Select'}
+ *       </button>
+ *     )}
+ *   </CoreLocation.Actions>
+ * </CoreLocation.Root>
  * ```
  */
-export declare function Location(props: LocationProps): React.ReactNode;
+export declare function Actions(props: ActionsProps): React.ReactNode;