@resira/ui 0.4.6 → 0.4.7

package/dist/index.d.cts

@@ -790,6 +790,119 @@ interface UseCheckoutSessionReturn {
  * ```
  */
 declare function useCheckoutSession(token: string | undefined): UseCheckoutSessionReturn;
+/** A single duration/price option for a service. */
+interface ServiceOption {
+    /** Duration in minutes. */
+    durationMinutes: number;
+    /** Human-readable duration label (e.g. "1h 30m"). */
+    durationLabel: string;
+    /** Price in minor units (cents). */
+    priceCents: number;
+    /** Formatted price string (e.g. "€50.00"). */
+    priceFormatted: string;
+}
+/** Enriched service data ready for display. */
+interface Service {
+    /** Unique service ID. */
+    id: string;
+    /** Service name. */
+    name: string;
+    /** Optional description. */
+    description?: string;
+    /** Image URL. */
+    imageUrl?: string;
+    /** ISO 4217 currency code. */
+    currency: string;
+    /** Whether the service is active. */
+    active: boolean;
+    /** Pricing model: "per_session" | "per_person" | "per_rider". */
+    pricingModel: string;
+    /** Default/base price in minor units. */
+    priceCents: number;
+    /** Formatted base price (e.g. "€50.00"). */
+    priceFormatted: string;
+    /** Lowest price across all options (for "from €X" display). */
+    lowestPriceCents: number;
+    /** Formatted lowest price. */
+    lowestPriceFormatted: string;
+    /** Whether multiple duration/price options exist. */
+    hasMultipleOptions: boolean;
+    /** Default duration in minutes. */
+    durationMinutes: number;
+    /** Human-readable default duration (e.g. "2h"). */
+    durationLabel: string;
+    /** All available duration/price options. */
+    options: ServiceOption[];
+    /** Maximum party/group size. */
+    maxPartySize?: number;
+    /** IDs of linked equipment/resources. */
+    equipmentIds: string[];
+    /** Names of linked equipment/resources. */
+    equipmentNames?: string[];
+    /** Display color. */
+    serviceColor?: string;
+    /** Sort order. */
+    sortOrder?: number;
+    /** Raw product object from the API. */
+    raw: Product;
+}
+interface UseServicesReturn {
+    /** Enriched service list. */
+    services: Service[];
+    /** Whether loading. */
+    loading: boolean;
+    /** Error message. */
+    error: string | null;
+    /** Re-fetch services. */
+    refetch: () => void;
+}
+/**
+ * Fetch all services for the organisation with enriched display data.
+ *
+ * Returns formatted prices, duration labels, and "from €X" logic
+ * so you can render service cards with your own styling.
+ *
+ * Requires `<ResiraProvider>` ancestor.
+ *
+ * ```tsx
+ * const { services, loading, error } = useServices();
+ *
+ * return services.map(s => (
+ *   <div key={s.id}>
+ *     <h3>{s.name}</h3>
+ *     <img src={s.imageUrl} alt={s.name} />
+ *     <p>{s.hasMultipleOptions ? `from ${s.lowestPriceFormatted}` : s.priceFormatted}</p>
+ *     <p>{s.durationLabel}</p>
+ *     {s.options.map(opt => (
+ *       <span key={opt.durationMinutes}>{opt.durationLabel} — {opt.priceFormatted}</span>
+ *     ))}
+ *   </div>
+ * ));
+ * ```
+ */
+declare function useServices(): UseServicesReturn;
+/**
+ * Fetch all services for an organisation — standalone, no React needed.
+ *
+ * Use this in non-React contexts, server components, scripts, or
+ * when you want full control over rendering.
+ *
+ * ```ts
+ * import { fetchServices } from "@resira/ui";
+ *
+ * const services = await fetchServices("your-api-key");
+ * services.forEach(s => {
+ *   console.log(s.name, s.lowestPriceFormatted, s.options);
+ * });
+ * ```
+ *
+ * @param apiKey  Your Resira public API key
+ * @param opts    Optional: baseUrl override
+ * @returns       Array of enriched Service objects
+ */
+declare function fetchServices(apiKey: string, opts?: {
+    baseUrl?: string;
+}): Promise<Service[]>;
 
 /** Default theme values. */
 declare const DEFAULT_THEME: Required<ResiraTheme>;
@@ -829,4 +942,4 @@ declare function TagIcon({ size, className }: IconProps): react_jsx_runtime.JSX.
 declare function CubeIcon({ size, className }: IconProps): react_jsx_runtime.JSX.Element;
 declare function ViewfinderIcon({ size, className }: IconProps): react_jsx_runtime.JSX.Element;
 
-export { AlertCircleIcon, BookingCalendar, BookingModal, type BookingSelection, type BookingStep, CalendarIcon, CheckCircleIcon, CheckIcon, type CheckoutSessionErrorCode, ChevronLeftIcon, ChevronRightIcon, ClockIcon, ConfirmationView, CreditCardIcon, CubeIcon, DEFAULT_LOCALE, DEFAULT_THEME, type DeeplinkGuest, type DeeplinkSelection, DishShowcase, type DishShowcaseProps, type DomainConfig, GuestForm, type GuestFormErrors, type GuestFormValues, LockIcon, MailIcon, MinusIcon, NoteIcon, PaymentForm, PhoneIcon, PlusIcon, ProductSelector, ResiraBookingWidget, type ResiraClassNames, type ResiraContextValue, type ResiraDomain, type ResiraLocale, ResiraProvider, type ResiraProviderConfig, type ResiraProviderProps, type ResiraTheme, ResourcePicker, type ServiceLayout, ShieldIcon, SummaryPreview, TagIcon, TimeSlotPicker, UserIcon, UsersIcon, ViewfinderIcon, WaiverConsent, XIcon, resolveTheme, themeToCSS, useAvailability, useCheckoutSession, useDish, useDishes, usePaymentIntent, useProducts, useReservation, useResira, useResources, validateGuestForm };
+export { AlertCircleIcon, BookingCalendar, BookingModal, type BookingSelection, type BookingStep, CalendarIcon, CheckCircleIcon, CheckIcon, type CheckoutSessionErrorCode, ChevronLeftIcon, ChevronRightIcon, ClockIcon, ConfirmationView, CreditCardIcon, CubeIcon, DEFAULT_LOCALE, DEFAULT_THEME, type DeeplinkGuest, type DeeplinkSelection, DishShowcase, type DishShowcaseProps, type DomainConfig, GuestForm, type GuestFormErrors, type GuestFormValues, LockIcon, MailIcon, MinusIcon, NoteIcon, PaymentForm, PhoneIcon, PlusIcon, ProductSelector, ResiraBookingWidget, type ResiraClassNames, type ResiraContextValue, type ResiraDomain, type ResiraLocale, ResiraProvider, type ResiraProviderConfig, type ResiraProviderProps, type ResiraTheme, ResourcePicker, type Service, type ServiceLayout, type ServiceOption, ShieldIcon, SummaryPreview, TagIcon, TimeSlotPicker, type UseServicesReturn, UserIcon, UsersIcon, ViewfinderIcon, WaiverConsent, XIcon, fetchServices, resolveTheme, themeToCSS, useAvailability, useCheckoutSession, useDish, useDishes, usePaymentIntent, useProducts, useReservation, useResira, useResources, useServices, validateGuestForm };

package/dist/index.d.ts

@@ -790,6 +790,119 @@ interface UseCheckoutSessionReturn {
  * ```
  */
 declare function useCheckoutSession(token: string | undefined): UseCheckoutSessionReturn;
+/** A single duration/price option for a service. */
+interface ServiceOption {
+    /** Duration in minutes. */
+    durationMinutes: number;
+    /** Human-readable duration label (e.g. "1h 30m"). */
+    durationLabel: string;
+    /** Price in minor units (cents). */
+    priceCents: number;
+    /** Formatted price string (e.g. "€50.00"). */
+    priceFormatted: string;
+}
+/** Enriched service data ready for display. */
+interface Service {
+    /** Unique service ID. */
+    id: string;
+    /** Service name. */
+    name: string;
+    /** Optional description. */
+    description?: string;
+    /** Image URL. */
+    imageUrl?: string;
+    /** ISO 4217 currency code. */
+    currency: string;
+    /** Whether the service is active. */
+    active: boolean;
+    /** Pricing model: "per_session" | "per_person" | "per_rider". */
+    pricingModel: string;
+    /** Default/base price in minor units. */
+    priceCents: number;
+    /** Formatted base price (e.g. "€50.00"). */
+    priceFormatted: string;
+    /** Lowest price across all options (for "from €X" display). */
+    lowestPriceCents: number;
+    /** Formatted lowest price. */
+    lowestPriceFormatted: string;
+    /** Whether multiple duration/price options exist. */
+    hasMultipleOptions: boolean;
+    /** Default duration in minutes. */
+    durationMinutes: number;
+    /** Human-readable default duration (e.g. "2h"). */
+    durationLabel: string;
+    /** All available duration/price options. */
+    options: ServiceOption[];
+    /** Maximum party/group size. */
+    maxPartySize?: number;
+    /** IDs of linked equipment/resources. */
+    equipmentIds: string[];
+    /** Names of linked equipment/resources. */
+    equipmentNames?: string[];
+    /** Display color. */
+    serviceColor?: string;
+    /** Sort order. */
+    sortOrder?: number;
+    /** Raw product object from the API. */
+    raw: Product;
+}
+interface UseServicesReturn {
+    /** Enriched service list. */
+    services: Service[];
+    /** Whether loading. */
+    loading: boolean;
+    /** Error message. */
+    error: string | null;
+    /** Re-fetch services. */
+    refetch: () => void;
+}
+/**
+ * Fetch all services for the organisation with enriched display data.
+ *
+ * Returns formatted prices, duration labels, and "from €X" logic
+ * so you can render service cards with your own styling.
+ *
+ * Requires `<ResiraProvider>` ancestor.
+ *
+ * ```tsx
+ * const { services, loading, error } = useServices();
+ *
+ * return services.map(s => (
+ *   <div key={s.id}>
+ *     <h3>{s.name}</h3>
+ *     <img src={s.imageUrl} alt={s.name} />
+ *     <p>{s.hasMultipleOptions ? `from ${s.lowestPriceFormatted}` : s.priceFormatted}</p>
+ *     <p>{s.durationLabel}</p>
+ *     {s.options.map(opt => (
+ *       <span key={opt.durationMinutes}>{opt.durationLabel} — {opt.priceFormatted}</span>
+ *     ))}
+ *   </div>
+ * ));
+ * ```
+ */
+declare function useServices(): UseServicesReturn;
+/**
+ * Fetch all services for an organisation — standalone, no React needed.
+ *
+ * Use this in non-React contexts, server components, scripts, or
+ * when you want full control over rendering.
+ *
+ * ```ts
+ * import { fetchServices } from "@resira/ui";
+ *
+ * const services = await fetchServices("your-api-key");
+ * services.forEach(s => {
+ *   console.log(s.name, s.lowestPriceFormatted, s.options);
+ * });
+ * ```
+ *
+ * @param apiKey  Your Resira public API key
+ * @param opts    Optional: baseUrl override
+ * @returns       Array of enriched Service objects
+ */
+declare function fetchServices(apiKey: string, opts?: {
+    baseUrl?: string;
+}): Promise<Service[]>;
 
 /** Default theme values. */
 declare const DEFAULT_THEME: Required<ResiraTheme>;
@@ -829,4 +942,4 @@ declare function TagIcon({ size, className }: IconProps): react_jsx_runtime.JSX.
 declare function CubeIcon({ size, className }: IconProps): react_jsx_runtime.JSX.Element;
 declare function ViewfinderIcon({ size, className }: IconProps): react_jsx_runtime.JSX.Element;
 
-export { AlertCircleIcon, BookingCalendar, BookingModal, type BookingSelection, type BookingStep, CalendarIcon, CheckCircleIcon, CheckIcon, type CheckoutSessionErrorCode, ChevronLeftIcon, ChevronRightIcon, ClockIcon, ConfirmationView, CreditCardIcon, CubeIcon, DEFAULT_LOCALE, DEFAULT_THEME, type DeeplinkGuest, type DeeplinkSelection, DishShowcase, type DishShowcaseProps, type DomainConfig, GuestForm, type GuestFormErrors, type GuestFormValues, LockIcon, MailIcon, MinusIcon, NoteIcon, PaymentForm, PhoneIcon, PlusIcon, ProductSelector, ResiraBookingWidget, type ResiraClassNames, type ResiraContextValue, type ResiraDomain, type ResiraLocale, ResiraProvider, type ResiraProviderConfig, type ResiraProviderProps, type ResiraTheme, ResourcePicker, type ServiceLayout, ShieldIcon, SummaryPreview, TagIcon, TimeSlotPicker, UserIcon, UsersIcon, ViewfinderIcon, WaiverConsent, XIcon, resolveTheme, themeToCSS, useAvailability, useCheckoutSession, useDish, useDishes, usePaymentIntent, useProducts, useReservation, useResira, useResources, validateGuestForm };
+export { AlertCircleIcon, BookingCalendar, BookingModal, type BookingSelection, type BookingStep, CalendarIcon, CheckCircleIcon, CheckIcon, type CheckoutSessionErrorCode, ChevronLeftIcon, ChevronRightIcon, ClockIcon, ConfirmationView, CreditCardIcon, CubeIcon, DEFAULT_LOCALE, DEFAULT_THEME, type DeeplinkGuest, type DeeplinkSelection, DishShowcase, type DishShowcaseProps, type DomainConfig, GuestForm, type GuestFormErrors, type GuestFormValues, LockIcon, MailIcon, MinusIcon, NoteIcon, PaymentForm, PhoneIcon, PlusIcon, ProductSelector, ResiraBookingWidget, type ResiraClassNames, type ResiraContextValue, type ResiraDomain, type ResiraLocale, ResiraProvider, type ResiraProviderConfig, type ResiraProviderProps, type ResiraTheme, ResourcePicker, type Service, type ServiceLayout, type ServiceOption, ShieldIcon, SummaryPreview, TagIcon, TimeSlotPicker, type UseServicesReturn, UserIcon, UsersIcon, ViewfinderIcon, WaiverConsent, XIcon, fetchServices, resolveTheme, themeToCSS, useAvailability, useCheckoutSession, useDish, useDishes, usePaymentIntent, useProducts, useReservation, useResira, useResources, useServices, validateGuestForm };