@resira/ui 0.4.19 → 0.4.20

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React from 'react';
-import { Product, WeightedBaseUrl, Resira, RefundRule, TimeSlotAvailability, DurationPrice, PublicResource, ValidatePromoCodeResponse, Reservation, AvailabilityParams, Availability, CheckoutSession, Dish, PaymentIntentResponse, CreatePaymentIntentRequest, CreateReservationRequest } from '@resira/sdk';
+import { Product, WeightedBaseUrl, Resira, RefundRule, TimeSlotAvailability, DurationPrice, PublicResource, ValidatePromoCodeResponse, Reservation, AvailabilityParams, Availability, CheckoutSession, Dish, PaymentIntentResponse, CreatePaymentIntentRequest, CreateReservationRequest, SlotHoldResponse } from '@resira/sdk';
 export { CheckoutConfig, CheckoutSession, CheckoutSessionResponse, ConfirmPaymentRequest, ConfirmPaymentResponse, CreateCheckoutSessionRequest, CreateCheckoutSessionResponse, CreatePaymentIntentRequest, Dish, DishListResponse, DishModel, DishResponse, DurationPrice, PaymentIntentResponse, PricingModel, Product, ProductCategory, ProductImage, ProductListResponse, ProductVariant, PublicResource, ResourceListResponse, RiderTierPrice } from '@resira/sdk';
 
 type ResiraDomain = "rental" | "restaurant" | "watersport" | "service";
@@ -190,6 +190,12 @@ interface ResiraLocale {
     reserveTable?: string;
     /** @default "Reservation for" */
     reservationFor?: string;
+    /** @default "Reserved for you" */
+    slotHoldReserved?: string;
+    /** @default "This slot just sold out. Pick another time." */
+    slotSoldOut?: string;
+    /** @default "Your hold expired. Please choose a time again." */
+    slotHoldExpired?: string;
 }
 /** Default English locale. */
 declare const DEFAULT_LOCALE: Required<ResiraLocale>;
@@ -332,6 +338,11 @@ interface ResiraProviderConfig {
     onError?: (code: string, message: string) => void;
     /** Promoter mode configuration for fast in-person bookings. */
     promoterMode?: PromoterModeConfig;
+    /**
+     * When true (default), watersport/service flows create a short-lived slot hold after time selection.
+     * Disable on APIs that do not yet expose `POST /v2/public/products/.../slot-holds`.
+     */
+    slotHoldsEnabled?: boolean;
 }
 /** Props for the ResiraProvider component. */
 interface ResiraProviderProps {
@@ -421,6 +432,8 @@ interface ResiraContextValue {
     checkoutSessionToken?: string;
     /** Resolved promoter-mode behavior flags. */
     promoterMode: Required<PromoterModeConfig>;
+    /** Slot soft-hold API enabled (watersport/service). @default true */
+    slotHoldsEnabled: boolean;
 }
 /** Steps in the booking flow. */
 type BookingStep = "resource" | "availability" | "details" | "terms" | "payment" | "confirmation" | "checkout";
@@ -963,6 +976,48 @@ declare function resolveTheme(overrides?: ResiraTheme): Required<ResiraTheme>;
  */
 declare function themeToCSS(theme: Required<ResiraTheme>): Record<string, string>;
 
+/** Known hold / slot conflict signals from API error text or `body.code`. */
+type SlotHoldErrorCode = "SLOT_UNAVAILABLE" | "HOLD_EXPIRED" | "HOLD_MISMATCH" | "HOLD_NOT_FOUND" | "HOLD_NOT_ACTIVE" | "UNKNOWN";
+declare function parseSlotHoldError(err: unknown): {
+    code: SlotHoldErrorCode;
+    message: string;
+};
+interface UseSlotHoldOptions {
+    client: Resira;
+    /** Master switch (false = no API calls; use for legacy APIs). */
+    enabled: boolean;
+    productId: string | undefined;
+    startTime: string | undefined;
+    durationMinutes: number | undefined;
+    partySize: number | undefined;
+    resourceId: string | undefined;
+    sessionToken?: string | undefined;
+    /** When hold cannot be placed or slot is gone. */
+    onSlotUnavailable?: () => void;
+    /** When countdown reaches zero. */
+    onHoldExpired?: () => void;
+}
+interface UseSlotHoldReturn {
+    holdId: string | null;
+    holdExpiresAt: string | null;
+    heldResourceId: string | null;
+    /** Seconds left; null when no active hold. */
+    remainingSeconds: number | null;
+    /** True while POST /slot-holds is in flight. */
+    creating: boolean;
+    /** User-facing error message. */
+    error: string | null;
+    parsedErrorCode: SlotHoldErrorCode | null;
+    /** Whether the user can leave the slot step (hold succeeded or holds disabled). */
+    holdReady: boolean;
+    /** Best-effort release (e.g. on unmount). */
+    release: () => Promise<void>;
+    serverNow: string | null;
+    /** Full last hold response for debugging/UI. */
+    lastHold: SlotHoldResponse | null;
+}
+declare function useSlotHold(options: UseSlotHoldOptions): UseSlotHoldReturn;
+
 interface IconProps {
     size?: number;
     className?: string;
@@ -989,4 +1044,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, type PromoterModeConfig, ResiraBookingWidget, type ResiraClassNames, type ResiraContextValue, type ResiraDomain, type ResiraLocale, ResiraProvider, type ResiraProviderConfig, type ResiraProviderProps, type ResiraTheme, type ResolveServicePriceParams, type ResolvedServicePrice, ResourcePicker, type Service, type ServiceLayout, type ServiceOption, ShieldIcon, SummaryPreview, TagIcon, TimeSlotPicker, type UseServicesReturn, UserIcon, UsersIcon, ViewfinderIcon, WaiverConsent, XIcon, fetchServices, resolveServicePrice, 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, type ResolveServicePriceParams, type ResolvedServicePrice, ResourcePicker, type Service, type ServiceLayout, type ServiceOption, ShieldIcon, type SlotHoldErrorCode, SummaryPreview, TagIcon, TimeSlotPicker, type UseServicesReturn, type UseSlotHoldOptions, type UseSlotHoldReturn, UserIcon, UsersIcon, ViewfinderIcon, WaiverConsent, XIcon, fetchServices, parseSlotHoldError, resolveServicePrice, resolveTheme, themeToCSS, useAvailability, useCheckoutSession, useDish, useDishes, usePaymentIntent, useProducts, useReservation, useResira, useResources, useServices, useSlotHold, validateGuestForm };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React from 'react';
-import { Product, WeightedBaseUrl, Resira, RefundRule, TimeSlotAvailability, DurationPrice, PublicResource, ValidatePromoCodeResponse, Reservation, AvailabilityParams, Availability, CheckoutSession, Dish, PaymentIntentResponse, CreatePaymentIntentRequest, CreateReservationRequest } from '@resira/sdk';
+import { Product, WeightedBaseUrl, Resira, RefundRule, TimeSlotAvailability, DurationPrice, PublicResource, ValidatePromoCodeResponse, Reservation, AvailabilityParams, Availability, CheckoutSession, Dish, PaymentIntentResponse, CreatePaymentIntentRequest, CreateReservationRequest, SlotHoldResponse } from '@resira/sdk';
 export { CheckoutConfig, CheckoutSession, CheckoutSessionResponse, ConfirmPaymentRequest, ConfirmPaymentResponse, CreateCheckoutSessionRequest, CreateCheckoutSessionResponse, CreatePaymentIntentRequest, Dish, DishListResponse, DishModel, DishResponse, DurationPrice, PaymentIntentResponse, PricingModel, Product, ProductCategory, ProductImage, ProductListResponse, ProductVariant, PublicResource, ResourceListResponse, RiderTierPrice } from '@resira/sdk';
 
 type ResiraDomain = "rental" | "restaurant" | "watersport" | "service";
@@ -190,6 +190,12 @@ interface ResiraLocale {
     reserveTable?: string;
     /** @default "Reservation for" */
     reservationFor?: string;
+    /** @default "Reserved for you" */
+    slotHoldReserved?: string;
+    /** @default "This slot just sold out. Pick another time." */
+    slotSoldOut?: string;
+    /** @default "Your hold expired. Please choose a time again." */
+    slotHoldExpired?: string;
 }
 /** Default English locale. */
 declare const DEFAULT_LOCALE: Required<ResiraLocale>;
@@ -332,6 +338,11 @@ interface ResiraProviderConfig {
     onError?: (code: string, message: string) => void;
     /** Promoter mode configuration for fast in-person bookings. */
     promoterMode?: PromoterModeConfig;
+    /**
+     * When true (default), watersport/service flows create a short-lived slot hold after time selection.
+     * Disable on APIs that do not yet expose `POST /v2/public/products/.../slot-holds`.
+     */
+    slotHoldsEnabled?: boolean;
 }
 /** Props for the ResiraProvider component. */
 interface ResiraProviderProps {
@@ -421,6 +432,8 @@ interface ResiraContextValue {
     checkoutSessionToken?: string;
     /** Resolved promoter-mode behavior flags. */
     promoterMode: Required<PromoterModeConfig>;
+    /** Slot soft-hold API enabled (watersport/service). @default true */
+    slotHoldsEnabled: boolean;
 }
 /** Steps in the booking flow. */
 type BookingStep = "resource" | "availability" | "details" | "terms" | "payment" | "confirmation" | "checkout";
@@ -963,6 +976,48 @@ declare function resolveTheme(overrides?: ResiraTheme): Required<ResiraTheme>;
  */
 declare function themeToCSS(theme: Required<ResiraTheme>): Record<string, string>;
 
+/** Known hold / slot conflict signals from API error text or `body.code`. */
+type SlotHoldErrorCode = "SLOT_UNAVAILABLE" | "HOLD_EXPIRED" | "HOLD_MISMATCH" | "HOLD_NOT_FOUND" | "HOLD_NOT_ACTIVE" | "UNKNOWN";
+declare function parseSlotHoldError(err: unknown): {
+    code: SlotHoldErrorCode;
+    message: string;
+};
+interface UseSlotHoldOptions {
+    client: Resira;
+    /** Master switch (false = no API calls; use for legacy APIs). */
+    enabled: boolean;
+    productId: string | undefined;
+    startTime: string | undefined;
+    durationMinutes: number | undefined;
+    partySize: number | undefined;
+    resourceId: string | undefined;
+    sessionToken?: string | undefined;
+    /** When hold cannot be placed or slot is gone. */
+    onSlotUnavailable?: () => void;
+    /** When countdown reaches zero. */
+    onHoldExpired?: () => void;
+}
+interface UseSlotHoldReturn {
+    holdId: string | null;
+    holdExpiresAt: string | null;
+    heldResourceId: string | null;
+    /** Seconds left; null when no active hold. */
+    remainingSeconds: number | null;
+    /** True while POST /slot-holds is in flight. */
+    creating: boolean;
+    /** User-facing error message. */
+    error: string | null;
+    parsedErrorCode: SlotHoldErrorCode | null;
+    /** Whether the user can leave the slot step (hold succeeded or holds disabled). */
+    holdReady: boolean;
+    /** Best-effort release (e.g. on unmount). */
+    release: () => Promise<void>;
+    serverNow: string | null;
+    /** Full last hold response for debugging/UI. */
+    lastHold: SlotHoldResponse | null;
+}
+declare function useSlotHold(options: UseSlotHoldOptions): UseSlotHoldReturn;
+
 interface IconProps {
     size?: number;
     className?: string;
@@ -989,4 +1044,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, type PromoterModeConfig, ResiraBookingWidget, type ResiraClassNames, type ResiraContextValue, type ResiraDomain, type ResiraLocale, ResiraProvider, type ResiraProviderConfig, type ResiraProviderProps, type ResiraTheme, type ResolveServicePriceParams, type ResolvedServicePrice, ResourcePicker, type Service, type ServiceLayout, type ServiceOption, ShieldIcon, SummaryPreview, TagIcon, TimeSlotPicker, type UseServicesReturn, UserIcon, UsersIcon, ViewfinderIcon, WaiverConsent, XIcon, fetchServices, resolveServicePrice, 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, type ResolveServicePriceParams, type ResolvedServicePrice, ResourcePicker, type Service, type ServiceLayout, type ServiceOption, ShieldIcon, type SlotHoldErrorCode, SummaryPreview, TagIcon, TimeSlotPicker, type UseServicesReturn, type UseSlotHoldOptions, type UseSlotHoldReturn, UserIcon, UsersIcon, ViewfinderIcon, WaiverConsent, XIcon, fetchServices, parseSlotHoldError, resolveServicePrice, resolveTheme, themeToCSS, useAvailability, useCheckoutSession, useDish, useDishes, usePaymentIntent, useProducts, useReservation, useResira, useResources, useServices, useSlotHold, validateGuestForm };