@feelrift/react

SDK de React para la API de Experiences de Rift. Integra disponibilidad, reservaciones y checkout, incluyendo Stripe Elements para eventos de pago, con un conjunto pequeño de componentes y hooks tipados.

Dónde empezar

• Instalación - instala el paquete, sus dependencias peer, dónde montar el provider y cómo configurar las URL base.
• Tu primer checkout - recorrido completo desde mostrar el evento hasta crear una orden exitosa, con un ejemplo ejecutable.

Guías

Páginas prácticas para temas transversales que la referencia no cubre en un solo lugar.

• Manejo de errores - RiftApiError, el patrón de narrowing isRiftApiError(err, "code") y las extensiones tipadas por código.
• Renderizado del lado del servidor - Next.js App Router, islas de Astro y Vite SPA. Qué garantiza el SDK y qué necesita hacer el consumidor para conservar esas garantías.
• Proteger el token de estado de la orden - cómo cerrar rutas de fuga (historial, Referer, logs del servidor) cuando el JWT posterior al checkout viaja en el return_url de Stripe.
• Precios y estimaciones - el modelo de precios por waves, el desglose greedy-fill y el aviso que el SDK muestra por defecto.
• Temas - custom properties de CSS, la prop appearance, la variante oscura de tokens y por qué el wrapper no pinta por ti.
• Internacionalización - negociación de locale, overrides de strings por clave y el catálogo completo de claves.

Referencia de API

Una página por símbolo público. Cada página de referencia sigue la misma forma: introducción -> uso básico -> tabla de referencia -> ejemplos -> historial de versión.

• Componentes - los 9 componentes de React que necesita cada embed (<RiftProvider>, <RiftEvent>, <EventHeader>, <AvailabilityList>, <ReserveButton>, <ReservationSummary>, <Countdown>, <CaptchaWidget>, <CheckoutForm>).
• Hooks - useCheckout y useOrderStatus. El resto de la superficie de hooks (useConfig, useAvailability, useReservation, etc.) respalda los componentes y se exporta desde @feelrift/react con JSDoc completo.
• Errores - la clase RiftApiError, cada code registrado y las extensiones tipadas por código.

¿Buscas la API HTTP?

Esta es la referencia del SDK de React. Para formas de endpoints, esquemas de request/response y la especificación OpenAPI, consulta la documentación de Experiences API.

El SDK es un wrapper tipado sobre esa API. Cada componente y hook mapea a uno o más endpoints. Cuando el SDK no cubre un caso de uso, baja a createRiftClient(...) desde @feelrift/react/client y llama los métodos tipados directamente.