@wodira/browser 0.1.0 → 0.3.0

package/CHANGELOG.md

@@ -0,0 +1,14 @@
+# Changelog
+
+## 0.3.0 — 2026-11-11
+
+### Added
+
+- Lit components for event discovery, registration, signature capture and registration receipts, with theme tokens and customization through slots and CSS parts.
+- Boxes widgets for calendars, plans and trial classes, with a versioned CDN bundle and integrity verification.
+- Registration support for category availability, supplements, custom fields, signatures and promotional codes.
+
+### Fixed
+
+- Published TypeScript declarations resolve correctly in strict NodeNext projects as well as frontend bundlers.
+- Registration components preserve API validation messages and recover when a promotional code is removed.

package/README.md

@@ -39,6 +39,30 @@ if (session.sessionUrl) window.location.href = session.sessionUrl;
 
 Las URLs de éxito/cancelación deben pertenecer a un origen permitido en la publishable key.
 
+## Widgets públicos de Boxes: `@wodira/browser/ui/boxes`
+
+Las instalaciones de Boxes se crean desde el constructor **Box → Widgets web**. Cada una entrega un `installation-id` y una clave publicable exclusiva para un origen.
+
+```ts
+import { defineWodiraBoxElements } from '@wodira/browser/ui/boxes';
+
+defineWodiraBoxElements();
+```
+
+```html
+<wodira-box-widget
+  installation-id="widget_..."
+  publishable-key="wpk_live_..."
+  locale="auto"
+></wodira-box-widget>
+```
+
+También están disponibles `<wodira-box-calendar>`, `<wodira-box-trial>` y `<wodira-box-plans>`. Aplican automáticamente logo, banner y colores del box; son responsive por contenedor; soportan `es`, `en` y `pt`; y permiten personalización con variables `--wodira-box-*` y partes como `shell`, `hero`, `logo`, `card`, `class-cta`, `trial-cta` y `plan-cta`.
+
+Las selecciones emiten `wodira:box-class-selected`, `wodira:box-trial-selected` y `wodira:box-plan-selected`. La identificación, confirmación y pago continúan en WODira Boxes; nunca se expone una clave secreta en el embed.
+
+La guía completa de instalación, CSP, privacidad y despliegue está en [`docs/boxes/public-widgets.md`](../../docs/boxes/public-widgets.md).
+
 ## Web Components: `@wodira/browser/ui`
 
 `@wodira/browser/ui` incluye Web Components basados en Lit para incrustar el embudo de inscripción en webs de organizadores. Los componentes usan publishable keys, CSS variables y `::part()` para personalización visual.
@@ -112,29 +136,198 @@ Atributos principales: `publishable-key`, `base-url`, `event-id`, `success-url`,
 ### Production notes
 
 - Los componentes hacen validación cliente antes de crear Checkout Session: comprador, atletas, campos obligatorios, términos y waivers requeridos.
+- En categorías de equipo elegibles, cada plaza salvo la del capitán permite elegir **Completar ahora** o **Invitar después**. Las plazas aplazadas conservan su género reservado y se completan mediante un enlace compartible después del pago.
+- La disponibilidad de **Invitar después** la decide `teamCompletion` en el resumen. No se ofrece para categorías individuales, cuando hay firmas obligatorias o cuando ha vencido el plazo de finalización.
+- Cuando quedan plazas pendientes, la sesión devuelve `participantDataStatus`, `pendingParticipantCount` y `teamManageToken`; en pagos Stripe, WODira añade además `teamToken` al fragmento de la URL de éxito para continuar la gestión del equipo.
 - Si el evento expone suplementos activos, el formulario renderiza extras y selecciona automáticamente los obligatorios.
 - El resumen de precio se recalcula con `getRegistrationSummary` cuando hay `purchaserEmail` válido, categoría y extras/promocode.
-- `locale="en-US"` cambia los textos base a inglés; cualquier otro locale usa español por defecto y se usa para fecha/moneda.
+- `locale` explícito tiene prioridad sobre el idioma del documento anfitrión; `en`/`en-*` usa inglés y los idiomas no soportados usan español. Fechas e importes utilizan `Intl`.
 - `auto-redirect` está activo por defecto; si se desactiva, escucha `wodira:checkout-created` o `wodira:redirect` para gestionar la navegación.
 
 ### CSS variables soportadas
 
-| Variable                                 | Uso                  |
-| ---------------------------------------- | -------------------- |
-| `--wodira-color-primary`                 | Botones principales  |
-| `--wodira-color-primary-contrast`        | Texto sobre primario |
-| `--wodira-color-accent`                  | Precios y foco       |
-| `--wodira-color-surface`                 | Tarjetas e inputs    |
-| `--wodira-color-muted`                   | Fondos secundarios   |
-| `--wodira-color-border`                  | Bordes               |
-| `--wodira-color-text`                    | Texto principal      |
-| `--wodira-color-text-muted`              | Texto secundario     |
-| `--wodira-color-danger`                  | Errores              |
-| `--wodira-radius` / `--wodira-radius-sm` | Radios               |
-| `--wodira-space`                         | Espaciado base       |
-| `--wodira-font-family`                   | Tipografía           |
-| `--wodira-shadow`                        | Sombra de tarjetas   |
+| Variable                                 | Uso                                             |
+| ---------------------------------------- | ----------------------------------------------- |
+| `--wodira-color-primary`                 | Botones principales                             |
+| `--wodira-color-primary-contrast`        | Texto sobre primario                            |
+| `--wodira-color-accent`                  | Precios y foco                                  |
+| `--wodira-color-accent-contrast`         | Texto sobre acento                              |
+| `--wodira-color-surface`                 | Tarjetas e inputs                               |
+| `--wodira-color-muted`                   | Fondos secundarios                              |
+| `--wodira-color-border`                  | Bordes                                          |
+| `--wodira-color-text`                    | Texto principal                                 |
+| `--wodira-color-text-muted`              | Texto secundario                                |
+| `--wodira-color-danger`                  | Errores                                         |
+| `--wodira-color-success`                 | Confirmaciones                                  |
+| `--wodira-radius` / `--wodira-radius-sm` | Radios                                          |
+| `--wodira-space`                         | Espaciado base                                  |
+| `--wodira-font-family`                   | Tipografía                                      |
+| `--wodira-font-size`                     | Tamaño base (1rem)                              |
+| `--wodira-color-scheme`                  | Esquema de controles nativos (`light` / `dark`) |
+| `--wodira-shadow`                        | Sombra de tarjetas                              |
+| `--wodira-control-height`                | Altura mínima de controles (2.75rem)            |
+| `--wodira-card-padding`                  | Espacio interior de tarjetas                    |
+| `--wodira-grid-min`                      | Ancho mínimo de columna, limitado al contenedor |
+| `--wodira-content-width`                 | Ancho máximo del checkout (76rem)               |
+| `--wodira-summary-width`                 | Ancho del resumen lateral (21rem)               |
+| `--wodira-sticky-offset`                 | Separación superior del resumen lateral (1rem)  |
 
 ### Parts principales
 
-`card`, `event-card`, `pricing-card`, `registration-form`, `summary`, `button`, `input`, `select`, `textarea`, `checkbox`, `label`, `title`, `price`, `meta`, `hint`, `error`, `field-error`, `loader`, `empty`, `waiver`, `supplement`.
+`card`, `event-card`, `pricing-card`, `registration-form`, `summary`, `button`, `input`, `select`, `textarea`, `checkbox`, `label`, `title`, `price`, `meta`, `hint`, `error`, `field-error`, `loader`, `empty`, `waiver`, `supplement`, `participant-mode`, `participant-mode-button`, `deferred-participant-hint`.
+
+También: `registration-layout`, `registration-fields`, `registration-title`, `checkout-sidebar`, `summary-row`, `summary-total`, `submit`, `progress`, `progress-step`, `step-number`, `eligibility-summary` y `gender-composition`. Los compuestos propagan las partes públicas de sus hijos con `exportparts`: `wodira-checkout-flow::part(submit)` alcanza el botón real dentro del formulario, y `wodira-box-widget::part(class-cta)` alcanza la reserva del calendario.
+
+### Temas heredables, sin recrear los componentes
+
+Los valores por defecto se resuelven como fallbacks: ningún componente sobrescribe las variables públicas del integrador. Puedes aplicar un tema al contenedor de varios widgets, a un widget concreto o con CSS. La fuente se hereda de la web anfitriona.
+
+```ts
+import { applyWodiraTheme, wodiraThemes, type WodiraTheme } from '@wodira/browser/ui';
+// También disponibles desde @wodira/browser/ui/boxes.
+
+const brand: WodiraTheme = {
+  ...wodiraThemes.light,
+  primary: '#00564b',
+  primaryContrast: '#ffffff',
+  accent: '#006b58',
+  radius: '0.5rem',
+  fontFamily: 'inherit',
+};
+applyWodiraTheme(container, brand);
+applyWodiraTheme(container, wodiraThemes.dark);
+applyWodiraTheme(container, { radius: null }); // Restaura la herencia/default.
+```
+
+`applyWodiraTheme` aplica un parche: las claves omitidas no cambian y `null` elimina sólo esa sobrescritura. `createWodiraCheckoutFlow(container, { ...options, theme: brand })` acepta el mismo objeto. No se pierden los datos del formulario al cambiar el tema. `wodiraThemeTokens` expone la correspondencia tipada entre las claves y sus variables CSS.
+
+En Boxes se mantiene la API `--wodira-box-*`. Precedencia: variable específica de Boxes → variable genérica `--wodira-*` → marca recibida del servidor (primario/acento) → valores por defecto. Los colores del servidor no pisan la personalización del integrador.
+
+Los presets claro y oscuro tienen colores de texto, error y acento coordinados. Si cambias colores, comprueba el contraste de texto (4.5:1 normal, 3:1 grande) y foco; no reduzcas los controles por debajo de un tamaño táctil cómodo. La densidad no oculta campos ni elimina validaciones.
+
+### Contenido mediante slots
+
+| Componente                             | Slots aditivos                                                            |
+| -------------------------------------- | ------------------------------------------------------------------------- |
+| `wodira-checkout-flow`                 | `header`, `footer`, `registration-intro`, `checkout-help`, `after-submit` |
+| `wodira-registration-form`             | `intro`, `checkout-help`, `after-submit`                                  |
+| `wodira-box-widget`                    | `header`, `footer`, `calendar-intro`, `trial-intro`, `plans-intro`        |
+| Calendario, prueba y planes standalone | `header`, `intro`, `footer`                                               |
+
+```html
+<wodira-checkout-flow publishable-key="wpk_live_..." event-id="evt_...">
+  <p slot="registration-intro">Ten a mano tus datos de participante.</p>
+  <p slot="checkout-help">¿Necesitas ayuda? Contacta con nuestro equipo.</p>
+</wodira-checkout-flow>
+```
+
+Los slots añaden contenido; no sustituyen campos, aceptación legal, waivers o atribución de WODira. Usa contenido de confianza y conserva los contratos de los eventos DOM existentes.
+
+### Layout, accesibilidad y catálogo local
+
+El registro separa los datos del resumen. A partir de **56rem de ancho del contenedor** el resumen queda en una columna lateral sticky; por debajo sigue el flujo del documento, sin barras fijas que tapen controles. Incluye progreso de pasos, foco en el formulario al seleccionar categoría y en el primer campo inválido al enviar. Respeta `prefers-reduced-motion` y mantiene los botones y pestañas operables con teclado.
+
+```bash
+pnpm --filter @wodira/browser preview:ui
+# http://127.0.0.1:4179 · Datos ficticios, sin llamadas a producción ni pagos.
+pnpm --filter @wodira/browser test
+pnpm --filter @wodira/browser test:ui:browser
+```
+
+El catálogo permite cambiar marca, tema claro/oscuro, acento, densidad, radios e idioma sobre los componentes reales. Las pruebas de Chromium cubren 320/768/1024/1440px, herencia a través de Shadow DOM, `::part()`, foco, teclado, estados y accesibilidad con axe. Requieren Chromium de Playwright instalado (`pnpm exec playwright install chromium`).
+
+El instalador CDN sigue fijado al artefacto publicado y su SRI. Antes de distribuir una nueva versión del paquete, publica con una **versión nueva** y actualiza conjuntamente `boxes-cdn-manifest.json` y el instalador de `apps/web`; no cambies el SRI de una URL versionada ya publicada.
+
+## Camiseta 3D y pujas en una web de evento
+
+`@wodira/browser/ui/shirt-sponsors` proporciona el componente Lit
+`<wodira-shirt-auction>`. La camiseta y los espacios se muestran en una vista
+WODira aislada; el inicio de sesión y Stripe Checkout se abren en ventanas.
+El visitante conserva abierta la web del evento. El componente espera la
+confirmación del servidor antes de mostrar una puja como pagada.
+
+```ts
+import { defineWodiraShirtElements } from '@wodira/browser/ui/shirt-sponsors';
+defineWodiraShirtElements();
+```
+
+```html
+<wodira-shirt-auction campaign-id="ID_DE_LA_CAMPANA" locale="es"></wodira-shirt-auction>
+```
+
+También queda registrado con `defineWodiraElements()` desde `@wodira/browser/ui`.
+Para HTML sin bundler, ejecuta `pnpm --filter @wodira/browser build`, copia
+`packages/browser/dist/ui/shirt-sponsors/cdn.js` a los recursos de tu web y carga:
+
+```html
+<script type="module" src="/assets/wodira-shirt-auction.js"></script>
+<wodira-shirt-auction campaign-id="ID_DE_LA_CAMPANA" locale="es"></wodira-shirt-auction>
+```
+
+| Atributo      | Uso                                                                      |
+| ------------- | ------------------------------------------------------------------------ |
+| `campaign-id` | ID de una campaña pública de patrocinio.                                 |
+| `locale`      | `es`, `en`, `pt` o `auto` (idioma de la página).                         |
+| `app-url`     | URL de WODira; por defecto `https://wodira.app`. HTTP solo en localhost. |
+
+La altura se adapta al contenido. Se exponen las partes CSS `container`, `frame`
+y `footer`; la camiseta y el formulario mantienen el diseño de WODira.
+Las variables `--wodira-primary`, `--wodira-text`, `--wodira-border`,
+`--wodira-background` y `--wodira-radius` personalizan el contenedor.
+
+```js
+document
+  .querySelector('wodira-shirt-auction')
+  .addEventListener('wodira:shirt:paid', ({ detail }) => {
+    console.log('Puja confirmada en la campaña', detail.campaignId);
+  });
+```
+
+Este evento es una señal de interfaz, no una prueba de pago para un servidor.
+No contiene email, tokens, datos de tarjeta ni identificadores privados de puja.
+La sesión se mantiene en memoria dentro del marco de WODira y se obtiene con una
+ventana del mismo origen; no depende de cookies de terceros ni se entrega a la
+web del evento. Si se recarga el componente hay que iniciar sesión de nuevo.
+
+### Desarrollo y despliegue
+
+- Vista: `/es/embed/shirt-sponsors/:id` (también `/en/` y `/pt/`).
+- En desarrollo sin localización: `/embed/shirt-sponsors/:id`.
+- Backend: aplicar `20260924190000_shirt_bid_checkout` antes de desplegar.
+- Configurar `FRONTEND_URL` con la URL pública de la app de WODira.
+- El webhook de Stripe debe entregar `checkout.session.completed`,
+  `checkout.session.async_payment_succeeded`, `checkout.session.async_payment_failed`
+  y `checkout.session.expired`, además de los eventos de pago ya utilizados.
+- La campaña debe estar publicada y el organizador conectado con Stripe.
+- La web que integra el componente debe permitir `frame-src https://wodira.app`
+  en su CSP y las ventanas de inicio de sesión/pago.
+- El bundle se distribuye con `@wodira/browser`; utiliza una versión publicada y conserva el SRI exacto de esa versión.
+
+Preview local: `pnpm --filter @wodira/browser preview:ui`, después abre
+`http://127.0.0.1:4179/shirt-auction?app-url=http://localhost:4200&campaign-id=ID`.
+Sin parámetros, la preview usa una campaña ficticia sin pagos.
+
+Prueba del flujo completo con la app local y Stripe/autenticación simulados:
+`pnpm exec node scripts/sponsor-studio/check-widget-flow.mjs` desde la raíz.
+Los argumentos opcionales son la URL de la app, del API y de la preview,
+respectivamente. Guarda capturas desktop/móvil en `output/tmp/shirt-widget`.
+Para producción, sirve también la web anfitriona por HTTPS.
+
+### Disponibilidad y formulario de inscripción
+
+El flujo Lit aplica la apertura y el cierre de inscripciones (incluido el cierre predeterminado
+anterior al inicio del evento), la venta por categoría y los cupos. El servidor vuelve a validar
+la disponibilidad al reservar las plazas. Los límites se actualizan automáticamente si la página
+permanece abierta durante el cambio de horario.
+
+Comprador e invitados tienen campos y suplementos independientes. Se admiten opciones de
+suplementos y cantidades, todos los tipos de campo configurables, documentos por categoría y
+firma electrónica con representación de menores. Las casillas obligatorias y las opciones
+configuradas se validan también en la API.
+
+El idioma por defecto es español; `locale` tiene prioridad sobre el idioma del documento anfitrión.
+Los reintentos de una misma compra conservan su identidad mientras no cambien los datos. No guardes
+ni publiques el secreto de reanudación que acompaña al intento de checkout.
+
+Consulta la revisión y su matriz de comprobaciones en
+[`docs/reviews/2026-11-10-lit-registration.md`](../../docs/reviews/2026-11-10-lit-registration.md).

package/dist/index.cjs

@@ -39,12 +39,11 @@ var __export = (target, all) => {
 // src/index.ts
 var exports_src = {};
 __export(exports_src, {
-  createWodiraBrowserClient: () => createWodiraBrowserClient,
+  WodiraBrowserApiError: () => WodiraBrowserApiError,
   WodiraBrowserClient: () => WodiraBrowserClient,
-  WodiraBrowserApiError: () => WodiraBrowserApiError
+  createWodiraBrowserClient: () => createWodiraBrowserClient
 });
 module.exports = __toCommonJS(exports_src);
-
 class WodiraBrowserApiError extends Error {
   status;
   statusText;
@@ -65,6 +64,7 @@ class WodiraBrowserClient {
   baseUrl;
   fetcher;
   headers;
+  checkoutSecrets = new Map;
   constructor(options) {
     if (!options.publishableKey?.trim()) {
       throw new Error("WodiraBrowserClient requires a publishableKey.");
@@ -98,9 +98,36 @@ class WodiraBrowserClient {
     });
   }
   createRegistrationCheckoutSession(input, signal) {
+    let secret = input.checkoutResumeSecret;
+    if (!secret && input.idempotencyKey) {
+      secret = this.checkoutSecrets.get(input.idempotencyKey);
+      if (!secret) {
+        secret = globalThis.crypto.randomUUID();
+        if (this.checkoutSecrets.size >= 128)
+          this.checkoutSecrets.delete(this.checkoutSecrets.keys().next().value);
+        this.checkoutSecrets.set(input.idempotencyKey, secret);
+      }
+    }
     return this.request("/checkout/registration/session", {
       method: "POST",
-      body: serializeRegistrationInput(input),
+      body: serializeRegistrationInput({
+        ...input,
+        ...secret ? { checkoutResumeSecret: secret } : {}
+      }),
+      signal
+    });
+  }
+  lookupRegistrationReceipts(eventId, input, signal) {
+    return this.request(`/events/${encodeURIComponent(eventId)}/registration-receipts/lookup`, {
+      method: "POST",
+      body: input,
+      signal
+    });
+  }
+  sendRegistrationReceipts(eventId, input, signal) {
+    return this.request(`/events/${encodeURIComponent(eventId)}/registration-receipts/send`, {
+      method: "POST",
+      body: input,
       signal
     });
   }
@@ -145,7 +172,8 @@ async function readResponsePayload(response) {
 function extractErrorMessage(payload, response) {
   if (typeof payload === "string")
     return payload;
-  const message = payload?.message;
+  const outerMessage = payload?.message;
+  const message = outerMessage !== null && typeof outerMessage === "object" && "message" in outerMessage ? outerMessage.message : outerMessage;
   if (typeof message === "string")
     return message;
   if (Array.isArray(message))

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import type { WodiraAthleteInput, WodiraCustomFieldInput, WodiraEvent, WodiraPaginatedResponse, WodiraPricingCardsResponse, WodiraSearchEventsInput } from './types';
-export type * from './types';
+import type { WodiraAthleteInput, WodiraCustomFieldInput, WodiraEvent, WodiraGender, WodiraPaginatedResponse, WodiraPricingCardsResponse, WodiraRegistrationReceiptLookup, WodiraRegistrationReceiptSendResult, WodiraSearchEventsInput, WodiraSupplementSelection } from './types.js';
+export type * from './types.js';
 export interface WodiraBrowserApiErrorPayload {
     message?: unknown;
     error?: unknown;
@@ -27,18 +27,37 @@ export interface WodiraBrowserClientOptions {
 export interface WodiraGuestRegistrationSummaryInput {
     categoryId: string;
     selectedSupplementIds?: string[];
+    supplementSelections?: WodiraSupplementSelection[];
 }
 export interface WodiraRegistrationSummaryInput {
     categoryId: string;
     purchaserEmail: string;
     promocode?: string;
     selectedSupplementIds?: string[];
+    supplementSelections?: WodiraSupplementSelection[];
     guestRegistrations?: WodiraGuestRegistrationSummaryInput[];
 }
 export interface WodiraBrowserAthleteInput extends WodiraAthleteInput {
     phone: string;
     idNumber: string;
 }
+export interface WodiraLegalSignatureInput {
+    signerName: string;
+    signerIdNumber: string;
+    authorityAccepted: true;
+    minorRelationship?: string;
+    guardianAuthorityAccepted?: true;
+    locale: 'es' | 'en' | 'pt';
+    waiverVersions: Array<{
+        waiverId: string;
+        version: number;
+    }>;
+    strokes: Array<Array<{
+        x: number;
+        y: number;
+        t: number;
+    }>>;
+}
 export interface WodiraGuestRegistrationInput {
     guestEmail: string;
     guestName: string;
@@ -49,6 +68,7 @@ export interface WodiraGuestRegistrationInput {
     customFields?: WodiraCustomFieldInput[];
     waiversAccepted?: Record<string, boolean>;
     selectedSupplementIds?: string[];
+    supplementSelections?: WodiraSupplementSelection[];
 }
 export interface WodiraRegistrationCheckoutSessionInput extends WodiraRegistrationSummaryInput {
     eventId: string;
@@ -56,14 +76,25 @@ export interface WodiraRegistrationCheckoutSessionInput extends WodiraRegistrati
     club?: string;
     purchaserName: string;
     athletes: WodiraBrowserAthleteInput[];
+    deferredTeamCompletion?: WodiraDeferredTeamCompletionInput;
     guestRegistrations?: WodiraGuestRegistrationInput[];
     customFields?: WodiraCustomFieldInput[];
     termsAccepted: boolean;
     waiversAccepted?: Record<string, boolean>;
+    legalSignature?: WodiraLegalSignatureInput;
     idempotencyKey?: string;
+    checkoutResumeSecret?: string;
     successUrl: string;
     cancelUrl: string;
 }
+export interface WodiraDeferredTeamCompletionInput {
+    pendingParticipantCount: number;
+    pendingParticipantPositions?: number[];
+    slotGenders?: WodiraGender[];
+    participantWaivers: Array<{
+        waiversAccepted: Record<string, boolean>;
+    }>;
+}
 export interface WodiraAppliedCoupon {
     code: string;
     discount: number;
@@ -83,6 +114,7 @@ export interface WodiraRegistrationSummary {
     applicationFee: number;
     applicationFeePercentage: number;
     processingFee: number;
+    checkoutFeePayer: 'BUYER' | 'ORGANIZER';
     total: number;
     organizerReceives: number;
     currency: string;
@@ -94,24 +126,40 @@ export interface WodiraRegistrationSummary {
         supplementsTotal: number;
         subtotal: number;
     }>;
+    teamCompletion?: WodiraTeamCompletionDecision;
+}
+export interface WodiraTeamCompletionDecision {
+    available: boolean;
+    deadlineAt?: string;
+    unavailableReason?: 'INDIVIDUAL_CATEGORY' | 'SIGNATURE_REQUIRED' | 'DEADLINE_PASSED';
 }
 export interface WodiraRegistrationCheckoutSession {
     sessionId: string | null;
     sessionUrl: string | null;
     orderId: string;
     completed: boolean;
+    receiptToken: string;
+    participantDataStatus?: 'READY' | 'PENDING_PARTICIPANTS';
+    pendingParticipantCount?: number;
+    teamManageToken?: string;
+}
+export interface WodiraRegistrationReceiptRequestInput {
+    email: string;
 }
 export declare class WodiraBrowserClient {
     private readonly publishableKey;
     private readonly baseUrl;
     private readonly fetcher;
     private readonly headers;
+    private readonly checkoutSecrets;
     constructor(options: WodiraBrowserClientOptions);
     searchEvents(input?: Omit<WodiraSearchEventsInput, 'status'>, signal?: AbortSignal): Promise<WodiraPaginatedResponse<WodiraEvent>>;
     getEvent(eventId: string, signal?: AbortSignal): Promise<WodiraEvent>;
     getPricingCards(eventId: string, signal?: AbortSignal): Promise<WodiraPricingCardsResponse>;
     getRegistrationSummary(input: WodiraRegistrationSummaryInput, signal?: AbortSignal): Promise<WodiraRegistrationSummary>;
     createRegistrationCheckoutSession(input: WodiraRegistrationCheckoutSessionInput, signal?: AbortSignal): Promise<WodiraRegistrationCheckoutSession>;
+    lookupRegistrationReceipts(eventId: string, input: WodiraRegistrationReceiptRequestInput, signal?: AbortSignal): Promise<WodiraRegistrationReceiptLookup>;
+    sendRegistrationReceipts(eventId: string, input: WodiraRegistrationReceiptRequestInput, signal?: AbortSignal): Promise<WodiraRegistrationReceiptSendResult>;
     private request;
 }
 export declare function createWodiraBrowserClient(options: WodiraBrowserClientOptions): WodiraBrowserClient;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,sBAAsB,EACtB,WAAW,EACX,uBAAuB,EACvB,0BAA0B,EAC1B,uBAAuB,EACxB,MAAM,SAAS,CAAC;AACjB,mBAAmB,SAAS,CAAC;AAE7B,MAAM,WAAW,4BAA4B;IAC3C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,4BAA4B,GAAG,MAAM,GAAG,IAAI,CAAC;gBAEnD,MAAM,EAAE;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,4BAA4B,GAAG,MAAM,GAAG,IAAI,CAAC;KACvD;CAOF;AAED,MAAM,MAAM,kBAAkB,GAAG,CAC/B,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,EAC7B,IAAI,CAAC,EAAE,WAAW,KACf,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEvB,MAAM,WAAW,0BAA0B;IACzC,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB;AAED,MAAM,WAAW,mCAAmC;IAClD,UAAU,EAAE,MAAM,CAAC;IACnB,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,8BAA8B;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;IACjC,kBAAkB,CAAC,EAAE,mCAAmC,EAAE,CAAC;CAC5D;AAED,MAAM,WAAW,yBAA0B,SAAQ,kBAAkB;IACnE,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,4BAA4B;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,yBAAyB,EAAE,CAAC;IACtC,YAAY,CAAC,EAAE,sBAAsB,EAAE,CAAC;IACxC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,sCAAuC,SAAQ,8BAA8B;IAC5F,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,yBAAyB,EAAE,CAAC;IACtC,kBAAkB,CAAC,EAAE,4BAA4B,EAAE,CAAC;IACpD,YAAY,CAAC,EAAE,sBAAsB,EAAE,CAAC;IACxC,aAAa,EAAE,OAAO,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,wBAAwB,EAAE,MAAM,CAAC;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,mBAAmB,EAAE,CAAC;IACtC,kBAAkB,CAAC,EAAE,KAAK,CAAC;QACzB,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;QACtB,gBAAgB,EAAE,MAAM,CAAC;QACzB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,iCAAiC;IAChD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;CACpB;AAWD,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0B;gBAEtC,OAAO,EAAE,0BAA0B;IAc/C,YAAY,CAAC,KAAK,GAAE,IAAI,CAAC,uBAAuB,EAAE,QAAQ,CAAM,EAAE,MAAM,CAAC,EAAE,WAAW;IAQtF,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW;IAI9C,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW;IAOrD,sBAAsB,CAAC,KAAK,EAAE,8BAA8B,EAAE,MAAM,CAAC,EAAE,WAAW;IAQlF,iCAAiC,CAC/B,KAAK,EAAE,sCAAsC,EAC7C,MAAM,CAAC,EAAE,WAAW;YASR,OAAO;CA0BtB;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,0BAA0B,uBAE5E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -19,6 +19,7 @@ class WodiraBrowserClient {
   baseUrl;
   fetcher;
   headers;
+  checkoutSecrets = new Map;
   constructor(options) {
     if (!options.publishableKey?.trim()) {
       throw new Error("WodiraBrowserClient requires a publishableKey.");
@@ -52,9 +53,36 @@ class WodiraBrowserClient {
     });
   }
   createRegistrationCheckoutSession(input, signal) {
+    let secret = input.checkoutResumeSecret;
+    if (!secret && input.idempotencyKey) {
+      secret = this.checkoutSecrets.get(input.idempotencyKey);
+      if (!secret) {
+        secret = globalThis.crypto.randomUUID();
+        if (this.checkoutSecrets.size >= 128)
+          this.checkoutSecrets.delete(this.checkoutSecrets.keys().next().value);
+        this.checkoutSecrets.set(input.idempotencyKey, secret);
+      }
+    }
     return this.request("/checkout/registration/session", {
       method: "POST",
-      body: serializeRegistrationInput(input),
+      body: serializeRegistrationInput({
+        ...input,
+        ...secret ? { checkoutResumeSecret: secret } : {}
+      }),
+      signal
+    });
+  }
+  lookupRegistrationReceipts(eventId, input, signal) {
+    return this.request(`/events/${encodeURIComponent(eventId)}/registration-receipts/lookup`, {
+      method: "POST",
+      body: input,
+      signal
+    });
+  }
+  sendRegistrationReceipts(eventId, input, signal) {
+    return this.request(`/events/${encodeURIComponent(eventId)}/registration-receipts/send`, {
+      method: "POST",
+      body: input,
       signal
     });
   }
@@ -99,7 +127,8 @@ async function readResponsePayload(response) {
 function extractErrorMessage(payload, response) {
   if (typeof payload === "string")
     return payload;
-  const message = payload?.message;
+  const outerMessage = payload?.message;
+  const message = outerMessage !== null && typeof outerMessage === "object" && "message" in outerMessage ? outerMessage.message : outerMessage;
   if (typeof message === "string")
     return message;
   if (Array.isArray(message))
@@ -127,7 +156,7 @@ function serializeAthleteInput(athlete) {
   };
 }
 export {
-  createWodiraBrowserClient,
+  WodiraBrowserApiError,
   WodiraBrowserClient,
-  WodiraBrowserApiError
+  createWodiraBrowserClient
 };