@riverbankcms/sdk 0.142.0 → 0.143.0

package/dist/_dts/api/src/endpoints.d.ts

@@ -5832,6 +5832,13 @@ export declare const API_ENDPOINTS: {
         auth: "public";
         responseKind: "json";
     };
+    readonly checkPublicEventRegistrationNextStep: {
+        path: "/public/sites/{siteId}/events/registration-next-step";
+        method: "POST";
+        auth: "public";
+        responseKind: "json";
+        errors: ("auth:forbidden" | "validation:invalid_input" | "server:internal_error")[];
+    };
     readonly listPublicEventCalendarWindow: {
         path: "/public/sites/{siteId}/events/calendar-window";
         method: "GET";

package/dist/_dts/api/src/publicEventEndpointDefinitions.d.ts

@@ -1,4 +1,11 @@
 export declare const PUBLIC_EVENT_ENDPOINT_DEFINITIONS: {
+    checkPublicEventRegistrationNextStep: {
+        path: "/public/sites/{siteId}/events/registration-next-step";
+        method: "POST";
+        auth: "public";
+        responseKind: "json";
+        errors: ("auth:forbidden" | "validation:invalid_input" | "server:internal_error")[];
+    };
     listPublicEventCalendarWindow: {
         path: "/public/sites/{siteId}/events/calendar-window";
         method: "GET";

package/dist/_dts/api/src/publicExperience/eventEndpoints.d.ts

@@ -7,7 +7,8 @@ import type { EventRegistrationOptionsRequest, EventRegistrationOptionsResponse
 import type { PublicWaitlistClaimResponse } from '../../../commerce/src/index';
 import type { APIEndpoint } from '../apiEndpointTypes';
 import type { DirectCheckoutCollectionOptionKind, EventAttendanceMode } from '../bookingConfig';
-import type { EventTicketLineSummaryResponse, EventTicketSelectionRequest, PublicEventLoaderParams } from './sharedTypes';
+import type { EventTicketSelectionRequest, PublicEventLoaderParams } from './sharedTypes';
+import type { EventRegisterResponse as EventRegistrationOutcome, EventRegistrationPaymentSubject, EventRegistrationNextStepRequest, EventRegistrationNextStepResponse } from '../../../blocks/src/system/runtime/api/types';
 /**
  * The canonical public Event record.
  *
@@ -95,6 +96,12 @@ export type PublicEventAPIEndpoints = {
          * The single-occurrence commit is keyed on it; see #1273.
          */
         registrationCommandId: string;
+        checkout?: {
+            successUrl: string;
+            cancelUrl: string;
+            discountCode?: string;
+            collectionOptionKind?: DirectCheckoutCollectionOptionKind;
+        };
         subject: {
             kind: 'occurrence';
             occurrenceId: string;
@@ -126,51 +133,13 @@ export type PublicEventAPIEndpoints = {
         }>;
     }, {
         siteId: string;
-    }, {
-        success: boolean;
-        scope: 'occurrence';
-        attendeeId: string;
-        status: 'confirmed';
-        paymentMethod: 'free' | 'pass' | 'membership' | 'stripe' | 'pass_bundle' | 'membership_bundle';
-        pendingPayment: boolean;
-        passCreditsUsed?: number;
-        passCreditsRemaining?: number;
-        alreadyRegistered?: boolean;
-        ticketLines: EventTicketLineSummaryResponse[];
-        message: string;
-    } | {
-        success: boolean;
-        scope: 'occurrence';
-        attendeeId: string;
-        status: 'waitlist';
-        waitlistPosition: number | null;
-        alreadyRegistered?: boolean;
-        message: string;
-    } | {
-        success: boolean;
-        scope: 'wholeSeries';
-        registrationId: string;
-        status: 'confirmed';
-        paymentMethod: 'free' | 'membership';
-        pendingPayment: false;
-        alreadyRegistered?: boolean;
-        ticketLines: EventTicketLineSummaryResponse[];
-        message: string;
-    } | {
-        success: boolean;
-        scope: 'wholeSeries';
-        waitlistEntryId: string;
-        status: 'waitlist';
-        waitlistPosition: number | null;
-        alreadyRegistered?: boolean;
-        message: string;
-    }>;
+    }, EventRegistrationOutcome>;
     createPublicEventCheckout: APIEndpoint<{
         subject: {
             kind: 'occurrence';
             attendeeId: string;
         };
-        registrationCommandId?: string;
+        registrationCommandId: string;
         checkoutType?: 'event' | 'pass_bundle' | 'membership_bundle';
         productId?: string;
         discountCode?: string;
@@ -211,13 +180,27 @@ export type PublicEventAPIEndpoints = {
         checkoutUrl: string | null;
         sessionId: string | null;
         bypassed: boolean;
+        deferredBalance?: {
+            amountCents: number;
+            currency: string;
+        };
     } | {
         scope: 'wholeSeries';
         registrationId: string;
         checkoutAttemptId: string;
+        recoverableUntil?: string;
         checkoutUrl: string | null;
         sessionId: string | null;
         bypassed: boolean;
+        deferredBalance?: {
+            amountCents: number;
+            currency: string;
+        };
+    } | {
+        scope: 'wholeSeries';
+        status: 'paymentStatusRequired';
+        checkoutAttemptId: string;
+        recoverableUntil?: string;
     } | {
         scope: 'wholeSeries';
         status: 'waitlist';
@@ -228,6 +211,9 @@ export type PublicEventAPIEndpoints = {
     getPublicEventRegistrationOptions: APIEndpoint<PublicEventRegistrationOptionsRequest, {
         siteId: string;
     }, PublicEventRegistrationOptionsResponse>;
+    checkPublicEventRegistrationNextStep: APIEndpoint<EventRegistrationNextStepRequest, {
+        siteId: string;
+    }, EventRegistrationNextStepResponse>;
     getPublicEventRegistrationStatus: APIEndpoint<never, {
         siteId: string;
     } & ({
@@ -249,10 +235,17 @@ export type PublicEventAPIEndpoints = {
     } | {
         kind: 'abandon';
         checkoutAttemptId: string;
+    } | {
+        kind: 'checkStatus';
+        subject: EventRegistrationPaymentSubject;
     }, {
         siteId: string;
     }, {
         kind: 'resolved';
+        deferredBalance?: {
+            amountCents: number;
+            currency: string;
+        };
         reference: {
             scope: 'occurrence';
             attendeeId: string;
@@ -266,6 +259,20 @@ export type PublicEventAPIEndpoints = {
         kind: 'notFound';
     } | {
         kind: 'reconciliationRequired';
+    } | {
+        kind: 'paymentProcessing';
+        recoverableUntil?: string;
+    } | {
+        kind: 'paymentAvailable';
+        checkoutUrl: string;
+        recoverableUntil?: string;
+    } | {
+        kind: 'paymentRetryAvailable';
+    } | {
+        kind: 'paymentCheckUnavailable';
+        recoverableUntil?: string;
+    } | {
+        kind: 'paymentAssistanceRequired';
     }>;
     getPublicEventTicketQrSvg: APIEndpoint<never, {
         siteId: string;

package/dist/_dts/blocks/src/system/runtime/api/client.d.ts

@@ -4,7 +4,7 @@
  * Factory function for creating a typed API client for block client-side API calls.
  */
 import { type CalendarWindowPage, type CalendarWindowRequest } from '../../blocks/events/shared/calendarWindow';
-import type { BlockApiConfig, ApiFieldError, FormSubmitRequest, FormSubmitResponse, FormConfigResponse, BookingSubmitRequest, BookingPackageSubmitRequest, BookingSubmitResponse, EligibleAppointmentPackagesResponse, AppointmentBookingStatusRequest, AppointmentBookingStatusResponse, AvailableSlotsRequest, AvailableSlotsResponse, WeeklySlotAvailabilityRequest, WeeklySlotAvailabilityResponse, AvailableDatesRequest, AvailableDatesResponse, BookingServicesResponse, BookingServiceResponse, BookingResourcesResponse, PublicEventsRequest, PublicEvent, EventFiltersResponse, EventRegisterRequest, EventRegisterResponse, EventCheckoutRequest, EventCheckoutResponse, RegistrationOptionsRequest, RegistrationOptionsResponse, EventRegistrationStatusRequest, EventRegistrationStatusResponse, EventCheckoutReturnRequest, EventCheckoutReturnResponse, ResolveWaitlistClaimRequest, ResolveWaitlistClaimResponse, DiscountsAvailableRequest, DiscountsAvailableResponse, DiscountApplyRequest, DiscountApplyResponse, PublicProductsResponse, ShopCheckoutRequest, ShopCheckoutResponse, UnifiedCheckoutRequest, UnifiedCheckoutResponse, PublicGiftingOffersResponse, CreateGiftingCheckoutRequest, CreateGiftingCheckoutResponse, ClaimGiftCardRequest, ClaimGiftCardResponse, PortalMeResponse, CustomerProfile, CustomerOrder, PortalMeUpdateRequest, CustomerPass, CustomerMembership, CustomerEventRegistration, PortalEventTicket, CustomerAppointment, BookingQuestionsTaskDetail, CustomerEventSeriesRegistration, PortalCredit, PortalOrderCheckoutRequest, PortalOrderCheckoutResponse, PortalDigitalProductAccessResponse, PortalDigitalProductDownloadUrlResponse, PortalDigitalProductsResponse, PortalCancelWholeSeriesRegistrationRequest, PortalCancelWholeSeriesRegistrationResult, PortalCancelAppointmentRequest, PortalCancelAppointmentResult, PortalUpdateAppointmentBookingQuestionsRequest, PortalUpdateWholeSeriesBookingQuestionsRequest, PortalUpdateEventBookingQuestionsRequest, PortalCancelEventRegistrationRequest, PortalCancelEventRegistrationResult, PortalTransferEventRegistrationRequest, PortalTransferEventRegistrationResult, PortalRescheduleAppointmentRequest, PortalRescheduleAppointmentResponse, PortalCancelMembershipAtPeriodEndResult, MagicLinkRequest, EventGuest, UpdateEventGuestsRequest, NewsletterSubscribeRequest, NewsletterSubscribeResponse } from './types';
+import type { BlockApiConfig, ApiFieldError, FormSubmitRequest, FormSubmitResponse, FormConfigResponse, BookingSubmitRequest, BookingPackageSubmitRequest, BookingSubmitResponse, EligibleAppointmentPackagesResponse, AppointmentBookingStatusRequest, AppointmentBookingStatusResponse, AvailableSlotsRequest, AvailableSlotsResponse, WeeklySlotAvailabilityRequest, WeeklySlotAvailabilityResponse, AvailableDatesRequest, AvailableDatesResponse, BookingServicesResponse, BookingServiceResponse, BookingResourcesResponse, PublicEventsRequest, PublicEvent, EventFiltersResponse, EventRegisterRequest, EventRegisterResponse, EventCheckoutRequest, EventCheckoutResponse, RegistrationOptionsRequest, EventRegistrationNextStepRequest, EventRegistrationNextStepResponse, RegistrationOptionsResponse, EventRegistrationStatusRequest, EventRegistrationStatusResponse, EventCheckoutReturnRequest, EventCheckoutReturnResponse, ResolveWaitlistClaimRequest, ResolveWaitlistClaimResponse, DiscountsAvailableRequest, DiscountsAvailableResponse, DiscountApplyRequest, DiscountApplyResponse, PublicProductsResponse, ShopCheckoutRequest, ShopCheckoutResponse, UnifiedCheckoutRequest, UnifiedCheckoutResponse, PublicGiftingOffersResponse, CreateGiftingCheckoutRequest, CreateGiftingCheckoutResponse, ClaimGiftCardRequest, ClaimGiftCardResponse, PortalMeResponse, CustomerProfile, CustomerOrder, PortalMeUpdateRequest, CustomerPass, CustomerMembership, CustomerEventRegistration, PortalEventTicket, CustomerAppointment, BookingQuestionsTaskDetail, CustomerEventSeriesRegistration, PortalCredit, PortalOrderCheckoutRequest, PortalOrderCheckoutResponse, PortalDigitalProductAccessResponse, PortalDigitalProductDownloadUrlResponse, PortalDigitalProductsResponse, PortalCancelWholeSeriesRegistrationRequest, PortalCancelWholeSeriesRegistrationResult, PortalCancelAppointmentRequest, PortalCancelAppointmentResult, PortalUpdateAppointmentBookingQuestionsRequest, PortalUpdateWholeSeriesBookingQuestionsRequest, PortalUpdateEventBookingQuestionsRequest, PortalCancelEventRegistrationRequest, PortalCancelEventRegistrationResult, PortalTransferEventRegistrationRequest, PortalTransferEventRegistrationResult, PortalRescheduleAppointmentRequest, PortalRescheduleAppointmentResponse, PortalCancelMembershipAtPeriodEndResult, MagicLinkRequest, EventGuest, UpdateEventGuestsRequest, NewsletterSubscribeRequest, NewsletterSubscribeResponse } from './types';
 type WithoutSiteId<T> = T extends unknown ? Omit<T, 'siteId'> : never;
 type PublicProductCategorySelector = Readonly<{
     kind: 'category';
@@ -57,6 +57,7 @@ export interface BlockApiClient {
     registerForEvent(data: Omit<EventRegisterRequest, 'siteId'>): Promise<EventRegisterResponse>;
     createEventCheckout(data: WithoutSiteId<EventCheckoutRequest>): Promise<EventCheckoutResponse>;
     getRegistrationOptions(data: Omit<RegistrationOptionsRequest, 'siteId'>): Promise<RegistrationOptionsResponse>;
+    checkRegistrationNextStep(data: EventRegistrationNextStepRequest): Promise<EventRegistrationNextStepResponse>;
     getEventRegistrationStatus(params: WithoutSiteId<EventRegistrationStatusRequest>): Promise<EventRegistrationStatusResponse>;
     resolveEventCheckoutReturn(data: EventCheckoutReturnRequest): Promise<EventCheckoutReturnResponse>;
     resolveWaitlistClaim(data: Omit<ResolveWaitlistClaimRequest, 'siteId'>): Promise<ResolveWaitlistClaimResponse>;

package/dist/_dts/blocks/src/system/runtime/api/endpoints.d.ts

@@ -101,6 +101,10 @@ export declare const EVENTS: {
         method: "POST";
         authScope: "portal";
     };
+    registrationNextStep: {
+        path: string;
+        method: "POST";
+    };
     registrationStatus: {
         path: string;
         method: "GET";
@@ -432,6 +436,10 @@ export declare const ENDPOINTS: {
             method: "POST";
             authScope: "portal";
         };
+        registrationNextStep: {
+            path: string;
+            method: "POST";
+        };
         registrationStatus: {
             path: string;
             method: "GET";

package/dist/_dts/blocks/src/system/runtime/api/types/events.d.ts

@@ -101,6 +101,12 @@ export interface EventRegisterRequest {
      * server can replay a lost response instead of registering twice.
      */
     registrationCommandId: string;
+    checkout?: {
+        successUrl: string;
+        cancelUrl: string;
+        discountCode?: string;
+        collectionOptionKind?: DirectCheckoutCollectionOptionKind;
+    };
     subject: {
         kind: 'occurrence';
         occurrenceId: string;
@@ -129,44 +135,54 @@ export interface EventRegisterRequest {
     /** Guest details when "collect all attendee details" is enabled */
     guests?: EventRegisterGuest[];
 }
-export type EventRegisterResponse = {
-    success: boolean;
+export type EventRegistrationPaymentSubject = {
     scope: 'occurrence';
+    submissionId: string;
     attendeeId: string;
-    status: 'confirmed';
+} | {
+    scope: 'wholeSeries';
+    submissionId: string;
+};
+export type EventRegistrationSummary = {
     paymentMethod: PaymentMethod;
-    pendingPayment: boolean;
+    ticketLines?: readonly EventTicketLineSummary[];
+    message: string;
     passCreditsUsed?: number;
     passCreditsRemaining?: number;
-    alreadyRegistered?: boolean;
-    ticketLines: EventTicketLineSummary[];
-    message?: string;
+};
+export type EventRegisterResponse = {
+    kind: 'bookingComplete';
+    reference: EventRegistrationStatusReference;
+    summary: EventRegistrationSummary;
 } | {
-    success: boolean;
-    scope: 'occurrence';
-    attendeeId: string;
-    status: 'waitlist';
-    waitlistPosition: number | null;
-    alreadyRegistered?: boolean;
-    message?: string;
+    kind: 'paymentDeferred';
+    reference: EventRegistrationStatusReference;
+    summary: EventRegistrationSummary;
+    balance: {
+        amountCents: number;
+        currency: string;
+    };
 } | {
-    success: boolean;
-    scope: 'wholeSeries';
-    registrationId: string;
-    status: 'confirmed';
-    paymentMethod: 'free' | 'membership';
-    pendingPayment: false;
-    alreadyRegistered?: boolean;
-    ticketLines: EventTicketLineSummary[];
-    message?: string;
+    kind: 'checkoutRequired';
+    reference: EventRegistrationStatusReference;
+    checkoutUrl: string;
+    submissionId: string;
 } | {
-    success: boolean;
-    scope: 'wholeSeries';
-    waitlistEntryId: string;
-    status: 'waitlist';
-    waitlistPosition: number | null;
-    alreadyRegistered?: boolean;
-    message?: string;
+    kind: 'paymentStatusRequired';
+    subject: EventRegistrationPaymentSubject;
+} | {
+    kind: 'waitlisted';
+    waitlist: {
+        reference: {
+            scope: 'occurrence';
+            attendeeId: string;
+        } | {
+            scope: 'occurrence' | 'wholeSeries';
+            waitlistEntryId: string;
+        };
+        position: number | null;
+        message: string;
+    };
 };
 /** Type of checkout for event payment */
 export type EventCheckoutType = 'event' | 'pass_bundle' | 'membership_bundle';
@@ -182,7 +198,7 @@ export type EventCheckoutRequest = EventCheckoutRequestCommon & ({
         kind: 'occurrence';
         attendeeId: string;
     };
-    registrationCommandId?: string;
+    registrationCommandId: string;
     checkoutType?: EventCheckoutType;
     productId?: string;
 } | {
@@ -204,26 +220,36 @@ export type EventCheckoutRequest = EventCheckoutRequestCommon & ({
     waitlistEntryId?: string;
     checkoutAttemptId: string;
 });
-export type EventCheckoutResponse = {
+type OccurrenceCheckoutResponse = Readonly<{
     scope: 'occurrence';
     attendeeId: string;
     checkoutUrl: string | null;
     sessionId: string | null;
     bypassed: boolean;
-} | {
+}>;
+type WholeSeriesCheckoutResponse = Readonly<{
     scope: 'wholeSeries';
     registrationId: string;
     checkoutAttemptId: string;
+    recoverableUntil?: string;
     checkoutUrl: string | null;
     sessionId: string | null;
     bypassed: boolean;
-} | {
+}>;
+type WholeSeriesPaymentStatusRequired = Readonly<{
+    scope: 'wholeSeries';
+    status: 'paymentStatusRequired';
+    checkoutAttemptId: string;
+    recoverableUntil: string;
+}>;
+type WholeSeriesWaitlistResponse = Readonly<{
     scope: 'wholeSeries';
     status: 'waitlist';
     waitlistEntryId: string;
     waitlistPosition: number | null;
     alreadyRegistered?: boolean;
-};
+}>;
+export type EventCheckoutResponse = OccurrenceCheckoutResponse | WholeSeriesCheckoutResponse | WholeSeriesPaymentStatusRequired | WholeSeriesWaitlistResponse;
 export interface EligiblePass {
     customerPassId: string;
     passName: string;
@@ -255,6 +281,19 @@ export type RegistrationOptionsRequest = EventRegistrationOptionsRequest & {
     siteId: string;
 };
 export type RegistrationOptionsResponse = EventRegistrationOptionsResponse;
+export type EventRegistrationNextStepRequest = EventRegistrationOptionsRequest & {
+    email: string;
+    altchaSolution?: string | null;
+};
+/** Navigation only; the booking submission remains authoritative for admission. */
+export type EventRegistrationNextStepResponse = {
+    kind: 'continue';
+} | {
+    kind: 'waitlist';
+} | {
+    kind: 'unavailable';
+    message: string;
+};
 /** Payment status values returned by the backend */
 export type PaymentStatus = 'pending' | 'completed' | 'failed' | 'not_required' | 'refunded';
 /** Attendee status values returned by the backend */
@@ -282,15 +321,36 @@ export type EventCheckoutReturnRequest = {
 } | {
     kind: 'abandon';
     checkoutAttemptId: string;
+} | {
+    kind: 'checkStatus';
+    subject: EventRegistrationPaymentSubject;
 };
 export type EventCheckoutReturnResponse = {
     kind: 'resolved';
     reference: EventRegistrationStatusReference;
+    deferredBalance?: {
+        amountCents: number;
+        currency: string;
+    };
 } | {
     kind: 'abandoned';
 } | {
     kind: 'notFound';
 } | {
     kind: 'reconciliationRequired';
+} | {
+    kind: 'paymentProcessing';
+    recoverableUntil?: string;
+} | {
+    kind: 'paymentAvailable';
+    checkoutUrl: string;
+    recoverableUntil?: string;
+} | {
+    kind: 'paymentRetryAvailable';
+} | {
+    kind: 'paymentCheckUnavailable';
+    recoverableUntil?: string;
+} | {
+    kind: 'paymentAssistanceRequired';
 };
 export {};

package/dist/_dts/blocks/src/system/runtime/nodes/event-registration/PaymentStatusStep.d.ts

@@ -0,0 +1,10 @@
+import type { PaymentStatusRecoveryState } from './types';
+type PaymentStatusStepProps = Readonly<{
+    state: PaymentStatusRecoveryState;
+    onCheck: () => void;
+    onContinuePayment: () => void;
+    onReturnToPayment: () => void;
+    onReturnToBooking: () => void;
+}>;
+export declare function PaymentStatusStep(props: PaymentStatusStepProps): import("react").JSX.Element;
+export {};

package/dist/_dts/blocks/src/system/runtime/nodes/event-registration/TicketSelectionStep.d.ts

@@ -10,8 +10,6 @@ type TicketSelectionStepProps = {
     occurrenceContext?: OccurrenceContext | null;
     selectedAttendanceMode?: RegistrationAttendanceMode | null;
     onAttendanceModeChange?: (attendanceMode: RegistrationAttendanceMode) => void;
-    checkoutRecovery?: boolean;
-    onCheckoutRecovery?: () => void;
     ticketsCount: number;
     maxTickets: number;
     visibleTicketTypes?: ReturnType<typeof getVisibleTicketTypes>;

package/dist/_dts/blocks/src/system/runtime/nodes/event-registration/event-registration.headless.contract.d.ts

@@ -2,7 +2,7 @@ import type { DirectCheckoutCollectionOptionKind, PaymentMethod } from '../../ap
 import type { EventRegistrationErrorAction } from '../../../../../../commerce/src/purchase/index';
 import type { EventRegistrationDirectPaymentOption, EventRegistrationDirectPaymentSelectionState } from './eventPaymentOptions';
 import type { EventRegistrationPageSurfaceSubject } from './eventScope';
-import type { EligibilityData, EventTicketSelectionLine, FormData, Guest, GuestErrors, OccurrenceContext, PaymentSelection, PaymentStepState, PublicEvent, RegistrationEvent, RegistrationResult } from './types';
+import type { EligibilityData, EventTicketSelectionLine, FormData, Guest, GuestErrors, OccurrenceContext, PaymentSelection, PaymentStatusRecoveryState, PaymentStepState, PublicEvent, RegistrationEvent, RegistrationResult } from './types';
 import type { SelectableEventTicketType } from './utils';
 import type { BlockButtonRole } from '../../../constants/buttonRoles';
 import type { PortalAuthState, PortalProfile } from './hooks';
@@ -44,6 +44,9 @@ export type EventRegistrationFlowStatus = Readonly<{
     tag: 'verifying-payment';
 }> | Readonly<{
     tag: 'verifying-timeout';
+}> | Readonly<{
+    tag: 'payment-status';
+    state: PaymentStatusRecoveryState;
 }> | Readonly<{
     tag: 'payment-failed';
     message: string;
@@ -66,6 +69,9 @@ export type EventRegistrationFlowView = Readonly<{
 }> | Readonly<{
     kind: 'verifying';
     message: string;
+}> | Readonly<{
+    kind: 'payment-status';
+    state: PaymentStatusRecoveryState;
 }> | Readonly<{
     kind: 'success';
     result: RegistrationResult;
@@ -191,6 +197,7 @@ export type EventRegistrationTerminalModel = Readonly<{
     result: RegistrationResult | null;
     errorMessage: string;
     verification: UseEventRegistrationWizardResult['verification'];
+    paymentStatusRecovery: PaymentStatusRecoveryState | null;
 }>;
 export type EventRegistrationFlowActions = Readonly<{
     selectEvent: (event: RegistrationEvent) => void;
@@ -210,6 +217,10 @@ export type EventRegistrationFlowActions = Readonly<{
     back: () => void;
     submit: (options?: EventRegistrationSubmitOptions) => Promise<EventRegistrationSubmitResult>;
     retry: () => void;
+    checkPaymentStatus: () => void;
+    continueExistingPayment: () => void;
+    returnToPayment: () => void;
+    returnToBooking: () => void;
 }>;
 export type HeadlessEventRegistrationFlow = Readonly<{
     status: EventRegistrationFlowStatus;

package/dist/_dts/blocks/src/system/runtime/nodes/event-registration/event-registration.headless.planning.d.ts

@@ -10,8 +10,8 @@ export declare function resolveEventRegistrationSubmitPlan(input: Readonly<{
     eventRequiresPayment: boolean;
     canJoinWaitlist?: boolean | null;
 }>): EventRegistrationSubmitPlan;
-export declare function resolveHeadlessEventRegistrationStatus(wizard: Pick<UseEventRegistrationWizardResult, 'step' | 'registrationResult' | 'errorMessage'> & Partial<Pick<UseEventRegistrationWizardResult, 'errorAction'>>): EventRegistrationFlowStatus;
-export declare function resolveHeadlessEventRegistrationView(wizard: Readonly<Pick<UseEventRegistrationWizardResult, 'step' | 'scopedEvents' | 'occurrenceContext' | 'registrationResult' | 'errorMessage'> & {
+export declare function resolveHeadlessEventRegistrationStatus(wizard: Pick<UseEventRegistrationWizardResult, 'step' | 'registrationResult' | 'errorMessage'> & Partial<Pick<UseEventRegistrationWizardResult, 'errorAction' | 'paymentStatusRecovery'>>): EventRegistrationFlowStatus;
+export declare function resolveHeadlessEventRegistrationView(wizard: Readonly<Pick<UseEventRegistrationWizardResult, 'step' | 'scopedEvents' | 'occurrenceContext' | 'registrationResult' | 'errorMessage'> & Partial<Pick<UseEventRegistrationWizardResult, 'paymentStatusRecovery'>> & {
     api: Pick<UseEventRegistrationWizardResult['api'], 'config'>;
 }>): EventRegistrationFlowView;
 export declare function deriveEventRegistrationSteps(input: Readonly<{

package/dist/_dts/blocks/src/system/runtime/nodes/event-registration/registrationCompletion.d.ts

@@ -1,4 +1,5 @@
 import type { EligibilityData } from './types';
+export declare function isSelectionSoldOut(availability: EligibilityData['availability'] | undefined): boolean;
 export declare function resolveRegistrationAvailabilityBlocker(input: Readonly<{
     hasWaitlistClaim: boolean;
     eligibility: EligibilityData | null;
@@ -9,7 +10,3 @@ export declare function resolvePricingSelectionBlocker(input: Readonly<{
     hasValidSelection: boolean;
     slidingScaleSelectionMessage: string | null;
 }>): string | null;
-export declare function isSoldOutWithoutWaitlist(input: Readonly<{
-    hasWaitlistClaim: boolean;
-    eligibility: EligibilityData | null;
-}>): boolean;

package/dist/_dts/blocks/src/system/runtime/nodes/event-registration/registrationDerivations.d.ts

@@ -4,6 +4,18 @@ export type RegistrationTarget = Readonly<{
     subject: RegistrationSubject;
     selectedEventId: string | null;
 }>;
+/** Public requests share subject identity without copying the run's display sessions. */
+export declare function toRegistrationRequestSubject(subject: RegistrationSubject, attendanceMode: 'in_person' | 'online' | null | undefined): {
+    kind: "occurrence";
+    occurrenceId: string;
+    attendanceMode: "in_person" | "online" | undefined;
+    eventSeriesId?: undefined;
+} | {
+    kind: "wholeSeries";
+    eventSeriesId: string;
+    attendanceMode: "in_person" | "online" | undefined;
+    occurrenceId?: undefined;
+};
 export declare function eventMatchesOccurrenceId(event: Pick<RegistrationEvent, 'selectionId' | 'registrationSubject'>, occurrenceId: string): boolean;
 export declare function findEventByOccurrenceId(events: readonly RegistrationEvent[], occurrenceId: string): RegistrationEvent | null;
 export declare function findPreSelectedEvent(input: Readonly<{

package/dist/_dts/blocks/src/system/runtime/nodes/event-registration/registrationErrorRecovery.d.ts

@@ -15,7 +15,7 @@ export declare function resetRegistrationAfterExpiry(input: Readonly<{
     setErrorMessage: (message: string) => void;
     setPendingRegistrationReference: (reference: EventRegistrationStatusReference | null) => void;
 }>): void;
-/** Recovery never starts another payment. Unknown payment outcomes go to the portal. */
+/** Retry the retained submission in place; explicit payment uncertainty stays status-only. */
 export declare function recoverRegistrationError(action: EventRegistrationErrorAction, handlers: Readonly<{
     canJoinWaitlist?: boolean;
     refreshOptions: () => void;

package/dist/_dts/blocks/src/system/runtime/nodes/event-registration/sessionStorage.d.ts

@@ -17,6 +17,7 @@ type PendingRegistrationV5 = {
     formData: FormData;
     ticketSelections: EventTicketSelectionLine[];
     selectedEventId: string | null;
+    eventSeriesId?: string | null;
     selectedAttendanceMode?: 'in_person' | 'online' | null;
     paymentSelection: PaymentSelection & {
         method: Exclude<PaymentSelection['method'], null>;

package/dist/_dts/blocks/src/system/runtime/nodes/event-registration/ticketSelectionLines.d.ts

@@ -1,4 +1,7 @@
 import type { EventTicketSelectionLine } from './types';
+import type { PublicEventPricingOptionAvailability } from '../../../../../../core/src/index';
+/** Ticket selection requests a quote; only the server admits a booking. */
+export declare function canRequestTicketOption(availability: PublicEventPricingOptionAvailability): boolean;
 export declare function normalizeTicketSelectionLines(lines: readonly EventTicketSelectionLine[]): EventTicketSelectionLine[];
 export declare function getTicketSelectionTotal(lines: readonly EventTicketSelectionLine[]): number;
 export declare function getTicketLineQuantity(lines: readonly EventTicketSelectionLine[], pricingOptionId: string | null): number;
@@ -8,9 +11,7 @@ export declare function hasValidPricingOptionSelection(input: Readonly<{
     lines: readonly EventTicketSelectionLine[];
     visibleOptions: readonly Readonly<{
         pricingOptionId: string;
-        availability: Readonly<{
-            kind: 'available' | 'unavailable';
-        }>;
+        availability: PublicEventPricingOptionAvailability;
     }>[];
 }>): boolean;
 export declare function setTicketLineQuantity(input: Readonly<{
@@ -22,8 +23,6 @@ export declare function getTicketTypeLineMax(input: Readonly<{
     currentQuantity: number;
     totalSelectedQuantity: number;
     maxTickets: number;
-    availableSpots: number | null | undefined;
-    ticketTypeRemainingCapacity: number | null;
 }>): number;
 export type TicketSelectionSummaryLine = Readonly<{
     pricingOptionId: string | null;

package/dist/_dts/blocks/src/system/runtime/nodes/event-registration/types.d.ts

@@ -24,7 +24,7 @@ export type GuestErrors = Record<number, {
     /** Error message for name field */
     name?: string;
 }>;
-export type RegistrationStep = 'select-event' | 'select-tickets' | 'enter-details' | 'select-payment' | 'submitting' | 'redirecting' | 'verifying-payment' | 'verifying-timeout' | 'payment-failed' | 'success' | 'error';
+export type RegistrationStep = 'select-event' | 'select-tickets' | 'enter-details' | 'select-payment' | 'submitting' | 'redirecting' | 'verifying-payment' | 'verifying-timeout' | 'payment-status' | 'payment-failed' | 'success' | 'error';
 export type RegistrationResult = {
     status: 'confirmed' | 'waitlist';
     /**
@@ -35,6 +35,14 @@ export type RegistrationResult = {
     message?: string;
     variant?: 'success' | 'info';
 };
+export type PaymentStatusRecoveryState = Readonly<{
+    subject: import('../../api/types').EventRegistrationPaymentSubject;
+}> & (Readonly<{
+    kind: 'ready' | 'checking' | 'processing' | 'temporarilyUnavailable' | 'retryAvailable' | 'assistanceRequired';
+}> | Readonly<{
+    kind: 'paymentAvailable';
+    checkoutUrl: string;
+}>);
 export type RegistrationAttendanceMode = 'in_person' | 'online';
 export type EventTicketSelectionLine = Readonly<{
     pricingOptionId: string | null;
@@ -55,8 +63,6 @@ export type EligibilityData = {
     isFree: boolean;
     /** Site credit for the authenticated registration subject, if available. */
     credit?: import('../../api').PortalCredit | null;
-    /** Whether the user has any payment/registration options available */
-    eligible: boolean;
     /** Whether the selected event/ticket type currently requires payment. */
     requiresPayment: boolean;
     /** Persisted pricing mode for the underlying event series. */
@@ -69,12 +75,6 @@ export type EligibilityData = {
     ticketLines: EventTicketLineSummary[];
     /** Public ticket types available for selection in ticket-type mode. */
     ticketTypes: readonly EventRegistrationPricingOption[];
-    /** Whether the event is currently full for the requested ticket count */
-    isFull: boolean;
-    /** Whether waitlists are enabled for this event */
-    waitlistEnabled: boolean;
-    /** Whether this registration can join the waitlist instead of paying */
-    canJoinWaitlist: boolean;
     /** Event price in cents (null if free) */
     price: number | null;
     /** Price currency code */
@@ -94,8 +94,6 @@ export type EligibilityData = {
         id: string;
         membershipName: string;
     }>;
-    /** Whether the event accepts direct payment */
-    canPayDirectly: boolean;
     /** Whether the event accepts passes */
     eventAcceptsPasses: boolean;
     /** Whether the event accepts memberships */