@wix/headless-bookings 0.0.53 → 0.0.54

package/dist/react/staff-member/StaffMemberList.js

@@ -0,0 +1,168 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * StaffMemberList - High-level component for displaying staff member lists
+ * Follows the pattern from LocationList.tsx
+ *
+ * @module React/StaffMemberList
+ */
+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 { BookingServiceDefinition } from '../../services/booking/booking.js';
+import * as CoreStaffMemberList from '../core/staff-member-list/StaffMemberList.js';
+import * as StaffMember from './StaffMember.js';
+/** Resource type ID for staff members */
+const STAFF_MEMBER_RESOURCE_TYPE_ID = '1cd44cf8-756f-41c3-bd90-3e2ffcaf1155';
+// ============================================================================
+// TestIds
+// ============================================================================
+var TestIds;
+(function (TestIds) {
+    TestIds["staffMemberListRoot"] = "staff-member-list-root";
+    TestIds["staffMemberListStaffMembers"] = "staff-member-list-staff-members";
+    TestIds["staffMemberListStaffMember"] = "staff-member-list-staff-member";
+    TestIds["staffMemberListActionClear"] = "staff-member-list-action-clear";
+})(TestIds || (TestIds = {}));
+/**
+ * Root component that provides the StaffMemberList service context for rendering staff member lists.
+ *
+ * @component
+ * @example
+ * ```tsx
+ * import { StaffMemberList, StaffMember } from '@wix/bookings/react';
+ *
+ * function StaffMembersPage({ staffMemberListConfig }) {
+ *   return (
+ *     <StaffMemberList.Root staffMemberListConfig={staffMemberListConfig}>
+ *       <StaffMemberList.StaffMembers emptyState={<div>No staff members available</div>}>
+ *         <StaffMemberList.StaffMemberRepeater>
+ *           <StaffMember.Name />
+ *         </StaffMemberList.StaffMemberRepeater>
+ *       </StaffMemberList.StaffMembers>
+ *     </StaffMemberList.Root>
+ *   );
+ * }
+ * ```
+ */
+export const Root = React.forwardRef((props, ref) => {
+    const { children, staffMemberListConfig, className, variant } = props;
+    const config = staffMemberListConfig || {
+        staffMembers: [],
+    };
+    return (_jsx(CoreStaffMemberList.Root, { staffMemberListServiceConfig: config, children: _jsx(RootContent, { className: className, ref: ref, variant: variant, children: children }) }));
+});
+Root.displayName = 'StaffMemberList.Root';
+/**
+ * Internal component to handle the Root content with service access
+ */
+const RootContent = React.forwardRef((props, ref) => {
+    const { children, className, variant } = props;
+    return (_jsx(CoreStaffMemberList.StaffMembers, { children: ({ staffMembers, isLoading }) => {
+            // Add id to each staff member for GenericList (staffMemberId equals resource id)
+            const itemsWithId = staffMembers.map((staffMember, index) => ({
+                ...staffMember,
+                id: staffMember.staffMemberId || String(index),
+            }));
+            return (_jsx(GenericList.Root, { items: itemsWithId, hasMore: false, isLoading: isLoading, className: className, ref: ref, "data-testid": TestIds.staffMemberListRoot, variant: variant, children: children }));
+        } }));
+});
+RootContent.displayName = 'StaffMemberList.RootContent';
+/**
+ * Container for the staff members list with empty state support.
+ * Wraps GenericList.Items internally (no separate Items export).
+ *
+ * @component
+ * @example
+ * ```tsx
+ * <StaffMemberList.StaffMembers emptyState={<div>No staff members available</div>}>
+ *   <StaffMemberList.StaffMemberRepeater>
+ *     <StaffMember.Name />
+ *   </StaffMemberList.StaffMemberRepeater>
+ * </StaffMemberList.StaffMembers>
+ * ```
+ */
+export const StaffMembers = React.forwardRef((props, ref) => {
+    const { children, ...otherProps } = props;
+    return (_jsx(GenericList.Items, { ref: ref, "data-testid": TestIds.staffMemberListStaffMembers, ...otherProps, children: children }));
+});
+StaffMembers.displayName = 'StaffMemberList.StaffMembers';
+export const StaffMemberRepeater = React.forwardRef((props, ref) => {
+    const { children } = props;
+    // Custom itemWrapper that wraps each item in StaffMember.Root
+    const staffMemberItemWrapper = ({ item: staffMemberWithId, children: itemChildren, }) => {
+        return (_jsx(StaffMember.Root, { staffMember: staffMemberWithId, "data-testid": TestIds.staffMemberListStaffMember, "data-staff-member-id": staffMemberWithId.id, "data-item-id": staffMemberWithId.id, children: itemChildren }, staffMemberWithId.id));
+    };
+    return (_jsx(GenericList.Repeater, { ref: ref, itemWrapper: staffMemberItemWrapper, children: children }));
+});
+StaffMemberRepeater.displayName = 'StaffMemberList.StaffMemberRepeater';
+/**
+ * Displays the total count of staff members.
+ *
+ * @component
+ * @example
+ * ```tsx
+ * <StaffMemberList.Totals />
+ *
+ * // With asChild
+ * <StaffMemberList.Totals asChild>
+ *   {({ count }) => <span>{count} staff members available</span>}
+ * </StaffMemberList.Totals>
+ * ```
+ */
+export const Totals = React.forwardRef((props, ref) => {
+    const { asChild, children, className, ...attrs } = props;
+    return (_jsx(CoreStaffMemberList.StaffMembers, { children: ({ staffMembers, hasStaffMembers }) => {
+            const count = staffMembers.length;
+            return (_jsx(AsChildSlot, { ref: ref, asChild: asChild, className: className, customElement: children, customElementProps: { count, hasStaffMembers }, ...attrs, children: _jsx("span", { children: count }) }));
+        } }));
+});
+Totals.displayName = 'StaffMemberList.Totals';
+/**
+ * Button to clear the staff member selection.
+ * Clears the staff member resource from the BookingService.
+ *
+ * @component
+ * @example
+ * ```tsx
+ * // Default button with "Clear" label
+ * <StaffMemberList.Actions.Clear />
+ *
+ * // With custom label
+ * <StaffMemberList.Actions.Clear label="Clear selection" />
+ *
+ * // With asChild
+ * <StaffMemberList.Actions.Clear asChild>
+ *   <button className="btn-secondary">Clear staff</button>
+ * </StaffMemberList.Actions.Clear>
+ *
+ * // Using render prop pattern
+ * <StaffMemberList.Actions.Clear>
+ *   {({ onClick }) => <button onClick={onClick}>Clear selection</button>}
+ * </StaffMemberList.Actions.Clear>
+ * ```
+ */
+const Clear = React.forwardRef((props, ref) => {
+    const { asChild, children, className, label = 'Clear', onClicked } = props;
+    let bookingService = null;
+    try {
+        bookingService = useService(BookingServiceDefinition);
+    }
+    catch {
+        // BookingService not available - likely no ServiceManagerProvider
+    }
+    const handleClick = () => {
+        bookingService?.actions.clearResourceById(STAFF_MEMBER_RESOURCE_TYPE_ID);
+        onClicked?.();
+    };
+    return (_jsx(AsChildSlot, { ref: ref, asChild: asChild, className: className, "data-testid": TestIds.staffMemberListActionClear, customElement: children, customElementProps: {
+            onClick: handleClick,
+        }, children: _jsx("button", { type: "button", onClick: handleClick, children: label }) }));
+});
+Clear.displayName = 'StaffMemberList.Actions.Clear';
+/**
+ * Actions namespace for staff member list-level actions
+ */
+export const Actions = {
+    Clear,
+};

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

@@ -57,6 +57,8 @@ export interface BookingServiceActions {
     setResourceById(resourceId: string, resource: Resource, instanceId?: string): void;
     /** Gets a resource by ID from a service selection. If no instanceId provided, uses the first item. */
     getResourceById(resourceId: string, instanceId?: string): Resource | undefined;
+    /** Clears a resource by ID from a service selection. If no instanceId provided, uses the first item. */
+    clearResourceById(resourceId: string, instanceId?: string): void;
     setLocation(location: ServiceLocationType | null): void;
     clearLocation(): void;
     setTimezone(timezone: string): void;

package/dist/services/booking/booking.js

@@ -149,6 +149,21 @@ export const BookingService = implementService.withConfig()(BookingServiceDefini
                 return undefined;
             return targetItem.resources.find((r) => r._id === resourceId);
         },
+        clearResourceById(resourceId, instanceId) {
+            const current = serviceSelectionsSignal.get();
+            // If no instanceId provided, use the first item
+            const targetId = instanceId ?? current[0]?.instanceId;
+            if (!targetId)
+                return;
+            const updated = current.map((item) => {
+                if (item.instanceId !== targetId)
+                    return item;
+                // Filter out the resource with matching ID
+                const newResources = item.resources.filter((r) => r._id !== resourceId);
+                return { ...item, resources: newResources };
+            });
+            serviceSelectionsSignal.set(updated);
+        },
         // Location actions
         setLocation(location) {
             locationSignal.set(location);

package/dist/services/index.d.ts

@@ -10,3 +10,4 @@ export { executeBookAction, canBook, buildBookingRequest, buildCheckoutRequest,
 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 SlotService, 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 { 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

@@ -10,3 +10,4 @@ export { executeBookAction, canBook, buildBookingRequest, buildCheckoutRequest,
 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 { StaffMemberListService, StaffMemberListServiceDefinition, loadStaffMemberListServiceInitialData, staffMemberListServiceBinding, } from './staff-member-list/staff-member-list.js';

package/dist/services/staff-member-list/staff-member-list.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Staff Member List Service Implementation
+ * Manages staff member state and BookingService integration
+ *
+ * @module Services/StaffMemberList
+ */
+import type { ServiceFactoryConfig } from '@wix/services-definitions';
+import { type StaffMemberData } from './staff-member-list.def.js';
+/**
+ * Configuration interface for StaffMemberListService
+ */
+export interface StaffMemberListServiceConfig {
+    /** Staff members array */
+    staffMembers?: StaffMemberData[];
+}
+/**
+ * Implementation of the StaffMemberList service
+ * Manages staff member state for display purposes
+ */
+export declare const StaffMemberListService: import("@wix/services-definitions").ServiceFactory<string & {
+    __api: import("./staff-member-list.def.js").StaffMemberListServiceAPI;
+    __config: {};
+    isServiceDefinition?: boolean;
+} & import("./staff-member-list.def.js").StaffMemberListServiceAPI, StaffMemberListServiceConfig>;
+/**
+ * Result type for SSR loader
+ */
+export type LoadStaffMemberListServiceResult = {
+    type: 'success';
+    config: StaffMemberListServiceConfig;
+} | {
+    type: 'error';
+    error: string;
+};
+/**
+ * SSR Loader: Creates configuration for server-side rendering.
+ *
+ * @param options - Optional configuration
+ * @returns Configuration result for StaffMemberListService
+ *
+ * @example
+ * ```typescript
+ * // Pass staff members directly (e.g., from service.staffMemberDetails.staffMembers)
+ * const result = await loadStaffMemberListServiceInitialData({
+ *   staffMembers: service.staffMemberDetails?.staffMembers,
+ * });
+ *
+ * if (result.type === 'error') {
+ *   return Astro.redirect('/500');
+ * }
+ *
+ * const staffMemberListConfig = result.config;
+ * ```
+ */
+export declare function loadStaffMemberListServiceInitialData(options?: {
+    /** Pass staff members directly */
+    staffMembers?: StaffMemberData[];
+}): Promise<LoadStaffMemberListServiceResult>;
+/**
+ * Service binding helper for StaffMemberListService.
+ * Bundles definition, implementation, and config for ServicesManager.
+ *
+ * @param servicesConfigs - Object containing StaffMemberListServiceDefinition config
+ * @returns Tuple of [Definition, Implementation, Config] for addService()
+ *
+ * @example
+ * ```typescript
+ * const servicesManager = createServicesManager(
+ *   createServicesMap()
+ *     .addService(...staffMemberListServiceBinding(configs))
+ * );
+ * ```
+ */
+export declare const staffMemberListServiceBinding: <T extends {
+    [key: string]: StaffMemberListServiceConfig;
+}>(servicesConfigs: T) => readonly [string & {
+    __api: import("./staff-member-list.def.js").StaffMemberListServiceAPI;
+    __config: {};
+    isServiceDefinition?: boolean;
+} & import("./staff-member-list.def.js").StaffMemberListServiceAPI, import("@wix/services-definitions").ServiceFactory<string & {
+    __api: import("./staff-member-list.def.js").StaffMemberListServiceAPI;
+    __config: {};
+    isServiceDefinition?: boolean;
+} & import("./staff-member-list.def.js").StaffMemberListServiceAPI, StaffMemberListServiceConfig>, StaffMemberListServiceConfig];
+export { StaffMemberListServiceDefinition, type StaffMemberData, type StaffMemberListActions, type StaffMemberListServiceAPI, } from './staff-member-list.def.js';

package/dist/services/staff-member-list/staff-member-list.def.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Staff Member List Service Definition
+ * Defines types and service interface for managing staff member lists
+ *
+ * @module Services/StaffMemberList/Definition
+ */
+import type { Signal, ReadOnlySignal } from '@wix/services-definitions/core-services/signals';
+import type { StaffMember } from '@wix/auto_sdk_bookings_services';
+/**
+ * StaffMemberData type - from Service['staffMemberDetails']['staffMembers'][number]
+ * Contains staffMemberId (which equals resource id), name, and mainMedia
+ */
+export type StaffMemberData = StaffMember;
+/**
+ * Actions interface for staff member list management
+ */
+export interface StaffMemberListActions {
+    /** Select a staff member */
+    select: (staffMember: StaffMemberData) => void;
+}
+/**
+ * API interface for the StaffMemberList service
+ */
+export interface StaffMemberListServiceAPI {
+    /** Reactive signal containing the staff members array */
+    staffMembers: Signal<StaffMemberData[]>;
+    /** Whether there are any staff members */
+    hasStaffMembers: ReadOnlySignal<boolean>;
+    /** Reactive signal indicating if staff members are loading */
+    isLoading: Signal<boolean>;
+    /** Reactive signal containing any error message */
+    error: Signal<string | null>;
+    /** Computed signal for selected staff member */
+    selectedStaffMember: ReadOnlySignal<StaffMemberData | null>;
+    /** Actions for staff member management */
+    actions: StaffMemberListActions;
+}
+/**
+ * Service definition for StaffMemberList
+ */
+export declare const StaffMemberListServiceDefinition: string & {
+    __api: StaffMemberListServiceAPI;
+    __config: {};
+    isServiceDefinition?: boolean;
+} & StaffMemberListServiceAPI;
+export type { StaffMember };

package/dist/services/staff-member-list/staff-member-list.def.js

@@ -0,0 +1,14 @@
+/**
+ * Staff Member List Service Definition
+ * Defines types and service interface for managing staff member lists
+ *
+ * @module Services/StaffMemberList/Definition
+ */
+import { defineService } from '@wix/services-definitions';
+// ============================================================================
+// Service Definition
+// ============================================================================
+/**
+ * Service definition for StaffMemberList
+ */
+export const StaffMemberListServiceDefinition = defineService('staff-member-list');

package/dist/services/staff-member-list/staff-member-list.js

@@ -0,0 +1,105 @@
+/**
+ * Staff Member List Service Implementation
+ * Manages staff member state and BookingService integration
+ *
+ * @module Services/StaffMemberList
+ */
+import { implementService } from '@wix/services-definitions';
+import { SignalsServiceDefinition, } from '@wix/services-definitions/core-services/signals';
+import { StaffMemberListServiceDefinition, } from './staff-member-list.def.js';
+// ============================================================================
+// Service Implementation
+// ============================================================================
+/**
+ * Implementation of the StaffMemberList service
+ * Manages staff member state for display purposes
+ */
+export const StaffMemberListService = implementService.withConfig()(StaffMemberListServiceDefinition, ({ getService, config }) => {
+    const signalsService = getService(SignalsServiceDefinition);
+    // Initialize staff members signal
+    const staffMembersSignal = signalsService.signal(config.staffMembers || []);
+    // Has staff members signal
+    const hasStaffMembersSignal = signalsService.computed(() => staffMembersSignal.get().length > 0);
+    const isLoadingSignal = signalsService.signal(false);
+    const errorSignal = signalsService.signal(null);
+    // Selected staff member - managed locally
+    const selectedStaffMemberSignal = signalsService.signal(null);
+    // Actions
+    const actions = {
+        select: (staffMember) => {
+            selectedStaffMemberSignal.set(staffMember);
+        },
+    };
+    return {
+        staffMembers: staffMembersSignal,
+        hasStaffMembers: hasStaffMembersSignal,
+        isLoading: isLoadingSignal,
+        error: errorSignal,
+        selectedStaffMember: selectedStaffMemberSignal,
+        actions,
+    };
+});
+/**
+ * SSR Loader: Creates configuration for server-side rendering.
+ *
+ * @param options - Optional configuration
+ * @returns Configuration result for StaffMemberListService
+ *
+ * @example
+ * ```typescript
+ * // Pass staff members directly (e.g., from service.staffMemberDetails.staffMembers)
+ * const result = await loadStaffMemberListServiceInitialData({
+ *   staffMembers: service.staffMemberDetails?.staffMembers,
+ * });
+ *
+ * if (result.type === 'error') {
+ *   return Astro.redirect('/500');
+ * }
+ *
+ * const staffMemberListConfig = result.config;
+ * ```
+ */
+export async function loadStaffMemberListServiceInitialData(options) {
+    try {
+        return {
+            type: 'success',
+            config: {
+                staffMembers: options?.staffMembers || [],
+            },
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Failed to load staff members';
+        console.error('loadStaffMemberListServiceInitialData error:', error);
+        return { type: 'error', error: message };
+    }
+}
+// ============================================================================
+// Service Binding Helper
+// ============================================================================
+/**
+ * Service binding helper for StaffMemberListService.
+ * Bundles definition, implementation, and config for ServicesManager.
+ *
+ * @param servicesConfigs - Object containing StaffMemberListServiceDefinition config
+ * @returns Tuple of [Definition, Implementation, Config] for addService()
+ *
+ * @example
+ * ```typescript
+ * const servicesManager = createServicesManager(
+ *   createServicesMap()
+ *     .addService(...staffMemberListServiceBinding(configs))
+ * );
+ * ```
+ */
+export const staffMemberListServiceBinding = (servicesConfigs) => {
+    return [
+        StaffMemberListServiceDefinition,
+        StaffMemberListService,
+        servicesConfigs['staff-member-list'],
+    ];
+};
+// ============================================================================
+// Re-exports
+// ============================================================================
+export { StaffMemberListServiceDefinition, } from './staff-member-list.def.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/headless-bookings",
-  "version": "0.0.53",
+  "version": "0.0.54",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -72,5 +72,5 @@
       "groupId": "com.wixpress.headless-components"
     }
   },
-  "falconPackageHash": "e2a82b9d4a1150c6bc5f6996ccc4f53eebcda6e1aa624a3eab20fbe7"
+  "falconPackageHash": "079a06fd7da27790c8fe3e4d05005528c07424a69a125f7f49da76e4"
 }