@resira/ui 0.4.11 → 0.4.12

package/dist/index.d.cts

@@ -256,6 +256,27 @@ interface DeeplinkGuest {
     /** Notes. */
     notes?: string;
 }
+/** Promoter mode settings for fast, low-bandwidth on-the-spot booking. */
+interface PromoterModeConfig {
+    /** Enable promoter optimizations. */
+    enabled?: boolean;
+    /** Guest contact requirement strategy. @default "phone-required" */
+    contactMode?: "email-required" | "phone-required" | "either";
+    /** Hide service/resource images to reduce network usage. @default true */
+    disableImages?: boolean;
+    /** Skip live promo-code validation call until booking submit. @default true */
+    disablePromoValidation?: boolean;
+    /** Hide promo field entirely for ultra-fast flows. @default false */
+    hidePromoInput?: boolean;
+    /** Cache TTL for availability/resources/products in milliseconds. @default 300000 */
+    cacheTtlMs?: number;
+    /** Use stale cached data when network requests fail. @default true */
+    useStaleDataOnError?: boolean;
+    /** Auto-advance from availability as soon as selection is made. @default true */
+    autoAdvanceAvailability?: boolean;
+    /** Override step-indicator visibility specifically for promoter mode. @default false */
+    showStepIndicator?: boolean;
+}
 /** Configuration passed to ResiraProvider. */
 interface ResiraProviderConfig {
     /** Theme overrides. */
@@ -309,6 +330,8 @@ interface ResiraProviderConfig {
     }) => void;
     /** Called when an error occurs during the booking flow. */
     onError?: (code: string, message: string) => void;
+    /** Promoter mode configuration for fast in-person bookings. */
+    promoterMode?: PromoterModeConfig;
 }
 /** Props for the ResiraProvider component. */
 interface ResiraProviderProps {
@@ -396,6 +419,8 @@ interface ResiraContextValue {
     onError?: (code: string, message: string) => void;
     /** Checkout session token — when provided, the widget skips to checkout. */
     checkoutSessionToken?: string;
+    /** Resolved promoter-mode behavior flags. */
+    promoterMode: Required<PromoterModeConfig>;
 }
 /** Steps in the booking flow. */
 type BookingStep = "resource" | "availability" | "details" | "terms" | "payment" | "confirmation" | "checkout";
@@ -545,7 +570,7 @@ declare function validateGuestForm(values: GuestFormValues, labels: {
     required: string;
     invalidEmail: string;
     contactRequired?: string;
-}, contactMode?: "email-required" | "either"): GuestFormErrors;
+}, contactMode?: "email-required" | "phone-required" | "either"): GuestFormErrors;
 interface GuestFormProps {
     values: GuestFormValues;
     onChange: (values: GuestFormValues) => void;
@@ -562,8 +587,10 @@ interface WaiverConsentProps {
     onDiscountCodeChange: (code: string) => void;
     onPromoValidated?: (result: ValidatePromoCodeResponse) => void;
     error?: string;
+    disablePromoValidation?: boolean;
+    hidePromoInput?: boolean;
 }
-declare function WaiverConsent({ termsAccepted, onTermsChange, waiverAccepted, onWaiverChange, discountCode, onDiscountCodeChange, onPromoValidated, error, }: WaiverConsentProps): react_jsx_runtime.JSX.Element;
+declare function WaiverConsent({ termsAccepted, onTermsChange, waiverAccepted, onWaiverChange, discountCode, onDiscountCodeChange, onPromoValidated, error, disablePromoValidation, hidePromoInput, }: WaiverConsentProps): react_jsx_runtime.JSX.Element;
 
 interface PaymentFormProps {
     /** Stripe client secret from the payment intent. */
@@ -942,4 +969,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 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 };
+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, type PromoterModeConfig, 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

@@ -256,6 +256,27 @@ interface DeeplinkGuest {
     /** Notes. */
     notes?: string;
 }
+/** Promoter mode settings for fast, low-bandwidth on-the-spot booking. */
+interface PromoterModeConfig {
+    /** Enable promoter optimizations. */
+    enabled?: boolean;
+    /** Guest contact requirement strategy. @default "phone-required" */
+    contactMode?: "email-required" | "phone-required" | "either";
+    /** Hide service/resource images to reduce network usage. @default true */
+    disableImages?: boolean;
+    /** Skip live promo-code validation call until booking submit. @default true */
+    disablePromoValidation?: boolean;
+    /** Hide promo field entirely for ultra-fast flows. @default false */
+    hidePromoInput?: boolean;
+    /** Cache TTL for availability/resources/products in milliseconds. @default 300000 */
+    cacheTtlMs?: number;
+    /** Use stale cached data when network requests fail. @default true */
+    useStaleDataOnError?: boolean;
+    /** Auto-advance from availability as soon as selection is made. @default true */
+    autoAdvanceAvailability?: boolean;
+    /** Override step-indicator visibility specifically for promoter mode. @default false */
+    showStepIndicator?: boolean;
+}
 /** Configuration passed to ResiraProvider. */
 interface ResiraProviderConfig {
     /** Theme overrides. */
@@ -309,6 +330,8 @@ interface ResiraProviderConfig {
     }) => void;
     /** Called when an error occurs during the booking flow. */
     onError?: (code: string, message: string) => void;
+    /** Promoter mode configuration for fast in-person bookings. */
+    promoterMode?: PromoterModeConfig;
 }
 /** Props for the ResiraProvider component. */
 interface ResiraProviderProps {
@@ -396,6 +419,8 @@ interface ResiraContextValue {
     onError?: (code: string, message: string) => void;
     /** Checkout session token — when provided, the widget skips to checkout. */
     checkoutSessionToken?: string;
+    /** Resolved promoter-mode behavior flags. */
+    promoterMode: Required<PromoterModeConfig>;
 }
 /** Steps in the booking flow. */
 type BookingStep = "resource" | "availability" | "details" | "terms" | "payment" | "confirmation" | "checkout";
@@ -545,7 +570,7 @@ declare function validateGuestForm(values: GuestFormValues, labels: {
     required: string;
     invalidEmail: string;
     contactRequired?: string;
-}, contactMode?: "email-required" | "either"): GuestFormErrors;
+}, contactMode?: "email-required" | "phone-required" | "either"): GuestFormErrors;
 interface GuestFormProps {
     values: GuestFormValues;
     onChange: (values: GuestFormValues) => void;
@@ -562,8 +587,10 @@ interface WaiverConsentProps {
     onDiscountCodeChange: (code: string) => void;
     onPromoValidated?: (result: ValidatePromoCodeResponse) => void;
     error?: string;
+    disablePromoValidation?: boolean;
+    hidePromoInput?: boolean;
 }
-declare function WaiverConsent({ termsAccepted, onTermsChange, waiverAccepted, onWaiverChange, discountCode, onDiscountCodeChange, onPromoValidated, error, }: WaiverConsentProps): react_jsx_runtime.JSX.Element;
+declare function WaiverConsent({ termsAccepted, onTermsChange, waiverAccepted, onWaiverChange, discountCode, onDiscountCodeChange, onPromoValidated, error, disablePromoValidation, hidePromoInput, }: WaiverConsentProps): react_jsx_runtime.JSX.Element;
 
 interface PaymentFormProps {
     /** Stripe client secret from the payment intent. */
@@ -942,4 +969,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 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 };
+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, type PromoterModeConfig, 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 };