@riverbankcms/sdk 0.149.0 → 0.150.0

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

@@ -26,7 +26,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-status' | 'payment-failed' | 'success' | 'error';
+export type RegistrationStep = 'select-event' | 'select-tickets' | 'fully-booked' | 'enter-details' | 'select-payment' | 'submitting' | 'payment' | 'verifying-payment' | 'verifying-timeout' | 'payment-status' | 'payment-failed' | 'success' | 'error';
 export type RegistrationResult = {
     status: 'confirmed' | 'waitlist';
     /**
@@ -46,7 +46,7 @@ export type PaymentStatusRecoveryState = Readonly<{
     kind: 'ready' | 'checking' | 'processing' | 'temporarilyUnavailable' | 'retryAvailable' | 'assistanceRequired';
 }> | Readonly<{
     kind: 'paymentAvailable';
-    checkoutUrl: string;
+    checkout: import('../../api/types').EventEmbeddedCheckout;
 }>);
 export type RegistrationAttendanceMode = 'in_person' | 'online';
 export type EventTicketSelectionLine = Readonly<{
@@ -197,3 +197,20 @@ export type EventRegistrationClientProps = {
     mailingList?: MailingListRuntimeContext;
     siteName?: string;
 };
+export type EventPaymentState = Readonly<{
+    kind: 'idle';
+}> | Readonly<{
+    kind: 'payment';
+    checkout: import('../../api/types').EventEmbeddedCheckout;
+    subject: import('../../api/types').EventRegistrationPaymentSubject;
+}> | Readonly<{
+    kind: 'verifying';
+    request: import('../../api/types').EventCheckoutReturnRequest;
+    resumePayment: boolean;
+}> | Readonly<{
+    kind: 'abandoning';
+    subject: import('../../api/types').EventRegistrationPaymentSubject;
+}> | Readonly<{
+    kind: 'recovery';
+    state: PaymentStatusRecoveryState;
+}>;

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

@@ -1,42 +1,7 @@
-import { usePaymentVerification } from '../../hooks/usePaymentVerification';
-import type { BlockApiClient } from '../../api';
-import type { EventRegistrationStatusReference } from '../../api/types';
-import { scrollToBlock } from '../../shared';
-import { cleanupStaleRegistrations, clearPendingRegistration, getPendingRegistration } from './sessionStorage';
-import type { EventTicketSelectionLine, FormData, PaymentSelection, RegistrationEvent, RegistrationResult, RegistrationStep, RegistrationSubject } from './types';
-type EventRegistrationStripeReturnOptions = {
-    api: BlockApiClient;
-    events: RegistrationEvent[];
-    registrationSubject: RegistrationSubject | null;
-    step: RegistrationStep;
-    pendingRegistrationReference: EventRegistrationStatusReference | null;
-    setFormData: (data: FormData) => void;
-    setTicketsCount: (count: number) => void;
-    setTicketSelections: (lines: readonly EventTicketSelectionLine[]) => void;
-    setSelectedEvent: (event: RegistrationEvent | null) => void;
-    setSelectedAttendanceMode: (attendanceMode: 'in_person' | 'online' | null) => void;
-    setPaymentSelection: (selection: PaymentSelection) => void;
-    setPendingRegistrationReference: (reference: EventRegistrationStatusReference | null) => void;
-    setStep: (step: RegistrationStep) => void;
-    setRegistrationResult: (result: RegistrationResult) => void;
-    setErrorMessage: (message: string) => void;
-};
-export type EventRegistrationStripeReturnDeps = Readonly<{
-    usePaymentVerification: typeof usePaymentVerification;
-    readReturnParams: () => Readonly<{
-        registration: string | null;
-        registration_attempt: string | null;
-        session_id: string | null;
-    }>;
-    clearReturnParams: () => void;
-    scrollToBlock: typeof scrollToBlock;
-    cleanupStaleRegistrations: typeof cleanupStaleRegistrations;
-    clearPendingRegistration: typeof clearPendingRegistration;
-    getPendingRegistration: typeof getPendingRegistration;
-}>;
-export type EventRegistrationStripeReturnResult = ReturnType<typeof usePaymentVerification> & Readonly<{
-    retryReturn?: () => void;
-}>;
-export declare function useEventRegistrationStripeReturn(options: EventRegistrationStripeReturnOptions): EventRegistrationStripeReturnResult;
-export declare function useEventRegistrationStripeReturnWithDeps(options: EventRegistrationStripeReturnOptions, deps: EventRegistrationStripeReturnDeps): EventRegistrationStripeReturnResult;
-export {};
+import type { EventCheckoutReturnRequest } from '../../api/types';
+import type { PendingRegistration } from './sessionStorage';
+export declare function useEventRegistrationStripeReturn(options: Readonly<{
+    siteId: string | undefined;
+    restore: (pending: PendingRegistration) => void;
+    verify: (request: EventCheckoutReturnRequest) => void;
+}>): void;

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

@@ -1,13 +1,11 @@
+import type { BookingMailingListNote as BookingSignupNote } from '../../../../../../core/src/index';
 import { generateUuidV4 } from '../../../../../../core/src/index';
 import type { EventRegistrationErrorAction } from '../../../../../../commerce/src/purchase/index';
 import type { BlockApiClient } from '../../api';
-import type { EventRegistrationStatusReference, PaymentMethod } from '../../api/types';
+import type { EventEmbeddedCheckout, EventRegistrationPaymentSubject, PaymentMethod } from '../../api/types';
 import { type RegistrationTarget } from './registrationDerivations';
 import { savePendingRegistration } from './sessionStorage';
 import type { EventTicketSelectionLine, FormData, Guest, PaymentSelection, PaymentStatusRecoveryState, RegistrationResult, RegistrationStep } from './types';
-export type EventRegistrationSubmitOptions = Readonly<{
-    redirect?: 'auto' | 'manual';
-}>;
 export type EventRegistrationSubmitResult = Readonly<{
     ok: true;
     outcome: {
@@ -21,16 +19,18 @@ export type EventRegistrationSubmitResult = Readonly<{
 }> | Readonly<{
     ok: true;
     outcome: {
-        kind: 'checkout_redirect';
-        checkoutUrl: string;
+        kind: 'checkout_ready';
+        checkout: EventEmbeddedCheckout;
+        subject: EventRegistrationPaymentSubject;
     };
 }> | Readonly<{
     ok: false;
     reason: 'blocked' | 'missing-target' | 'submission-failed';
     message: string;
 }>;
-export type EventRegistrationSubmit = (method: PaymentMethod, passId?: string, membershipId?: string, selection?: PaymentSelection, submitOptions?: EventRegistrationSubmitOptions) => Promise<EventRegistrationSubmitResult>;
+export type EventRegistrationSubmit = (method: PaymentMethod, passId?: string, membershipId?: string, selection?: PaymentSelection) => Promise<EventRegistrationSubmitResult>;
 export type UseEventRegistrationSubmitInput = {
+    openPayment: (checkout: EventEmbeddedCheckout, subject: EventRegistrationPaymentSubject, note?: BookingSignupNote) => void;
     commandRef: EventRegistrationCommandRef;
     api: BlockApiClient;
     registrationTarget: RegistrationTarget | null;
@@ -47,7 +47,6 @@ export type UseEventRegistrationSubmitInput = {
     discountCode: string;
     claimToken: string | null;
     waitlistEntryId?: string | null;
-    setPendingRegistrationReference: (reference: EventRegistrationStatusReference) => void;
     setStep: (step: RegistrationStep) => void;
     setErrorAction?: (action: EventRegistrationErrorAction) => void;
     setRegistrationResult: (result: RegistrationResult) => void;

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

@@ -57,13 +57,16 @@ export declare function useEventRegistrationWizard(options: UseEventRegistration
     preSelectedEvent: RegistrationEvent | null;
     hasPreSelectedContext: boolean;
     step: RegistrationStep;
-    setStep: (nextStep: RegistrationStep) => void;
+    setStep: (next: RegistrationStep) => void;
+    admission: import("./registrationCompletion").RegistrationAdmission;
+    ticketContinuation: import("./registrationCompletion").RegistrationTicketContinuation;
+    handleTicketsComplete: () => import("./event-registration.headless.contract").EventRegistrationFlowActionResult;
     selectedEvent: RegistrationEvent | null;
-    setSelectedEvent: import("react").Dispatch<import("react").SetStateAction<RegistrationEvent | null>>;
+    setSelectedEvent: (value: Parameters<import("react").Dispatch<import("react").SetStateAction<RegistrationEvent | null>>>[0]) => void;
     ticketsCount: number;
-    setTicketsCount: (nextTicketsCount: number) => void;
+    setTicketsCount: (value: Parameters<(nextTicketsCount: number) => void>[0]) => void;
     selectedAttendanceMode: "in_person" | "online" | null;
-    setSelectedAttendanceMode: import("react").Dispatch<import("react").SetStateAction<"in_person" | "online" | null>>;
+    setSelectedAttendanceMode: (value: Parameters<import("react").Dispatch<import("react").SetStateAction<"in_person" | "online" | null>>>[0]) => void;
     ticketSelections: Readonly<{
         pricingOptionId: string | null;
         quantity: number;
@@ -74,7 +77,7 @@ export declare function useEventRegistrationWizard(options: UseEventRegistration
     }>[];
     setSelectedTicketLines: (lines: readonly EventTicketSelectionLine[]) => void;
     selectedSlidingAmountInput: string;
-    setSelectedSlidingAmountInput: import("react").Dispatch<import("react").SetStateAction<string>>;
+    setSelectedSlidingAmountInput: (value: Parameters<import("react").Dispatch<import("react").SetStateAction<string>>>[0]) => void;
     selectedSlidingAmount: number | null;
     selectedEventSlidingScale: Readonly<{
         minAmount: number;
@@ -99,10 +102,10 @@ export declare function useEventRegistrationWizard(options: UseEventRegistration
     mailingListSignup: Readonly<{
         siteName: string;
     }> | null;
-    setFormData: import("react").Dispatch<import("react").SetStateAction<FormData>>;
+    setFormData: (value: Parameters<import("react").Dispatch<import("react").SetStateAction<FormData>>>[0]) => void;
     errors: Partial<Record<keyof FormData, string>>;
     guests: Guest[];
-    setGuests: import("react").Dispatch<import("react").SetStateAction<Guest[]>>;
+    setGuests: (value: Parameters<import("react").Dispatch<import("react").SetStateAction<Guest[]>>>[0]) => void;
     guestErrors: GuestErrors;
     guestSectionShake: boolean;
     handleGuestShakeEnd: () => void;
@@ -119,7 +122,7 @@ export declare function useEventRegistrationWizard(options: UseEventRegistration
     handleLogout: () => void;
     paymentStepState: PaymentStepState;
     handlePaymentStepStateChange: (state: PaymentStepState) => void;
-    handlePaymentSelectionChange: (selection: PaymentSelection) => void;
+    handlePaymentSelectionChange: (value: Parameters<(selection: PaymentSelection) => void>[0]) => void;
     paymentSelection: PaymentSelection;
     isMembershipFastTrack: boolean;
     waitlistClaim: import("../../shared/useWaitlistClaim").UseWaitlistClaimResult;
@@ -143,7 +146,7 @@ export declare function useEventRegistrationWizard(options: UseEventRegistration
     hasMembershipEligibility: boolean;
     requireGuestDetails: boolean;
     discountCode: string;
-    setDiscountCode: (code: string) => void;
+    setDiscountCode: (value: string) => void;
     discountUiOpen: boolean;
     setDiscountUiOpen: (isOpen: boolean) => void;
     discountsAvailable: boolean;
@@ -152,18 +155,48 @@ export declare function useEventRegistrationWizard(options: UseEventRegistration
     discountsAvailableLoading: boolean;
     discountContext: import("../../api").DiscountContext | null;
     shouldShowDiscountToggle: boolean;
-    verification: import("./useEventRegistrationStripeReturn").EventRegistrationStripeReturnResult;
+    verification: {
+        retry: () => void;
+        retryReturn: () => void;
+        status: "idle" | "polling" | "completed" | "failed" | "timeout";
+        result: import("../../api").EventCheckoutReturnResponse | null;
+        error: Error | null;
+    };
+    paymentController: {
+        backToBooking: () => Promise<void>;
+        continuePayment: () => void;
+        returnToPayment: () => void;
+        returnToBooking: () => void;
+        check: () => void;
+        retryPaymentLoad: () => void;
+        verification: {
+            retry: () => void;
+            retryReturn: () => void;
+            status: "idle" | "polling" | "completed" | "failed" | "timeout";
+            result: import("../../api").EventCheckoutReturnResponse | null;
+            error: Error | null;
+        };
+        state: import("./types").EventPaymentState;
+        recovery: import("./types").PaymentStatusRecoveryState | null;
+        showRecovery: (next: import("./types").PaymentStatusRecoveryState | null) => void;
+        restoreMailingListNote: (value: import("./types").PaymentStatusRecoveryState["mailingListSignupNote"]) => void;
+        openPayment: (checkout: import("../../api/types").EventEmbeddedCheckout, subject: import("../../api/types").EventRegistrationPaymentSubject, mailingListSignupNote?: import("./types").PaymentStatusRecoveryState["mailingListSignupNote"]) => void;
+        verify: (request: import("../../api").EventCheckoutReturnRequest, resumePayment?: boolean) => void;
+    };
     paymentStatusRecovery: import("./types").PaymentStatusRecoveryState | null;
     handleCheckPaymentStatus: () => void;
     handleContinueExistingPayment: () => void;
     handleReturnToPayment: () => void;
     handleReturnToBooking: () => void;
+    recoveryMessage: string | null;
+    checkingNextStep: boolean;
+    handleRecoveryEmail: () => Promise<import("./event-registration.headless.contract").EventRegistrationFlowActionResult>;
     handleDetailsComplete: () => Promise<EventRegistrationDetailsCompleteResult>;
     handlePaymentSelect: () => Promise<void>;
     handleUseCardInsteadOfPass: () => void;
     handleBookForSomeoneElse: () => void;
-    handleSubmit: import("./useEventRegistrationSubmit").EventRegistrationSubmit;
-    handleEventSelect: (event: RegistrationEvent) => void;
+    handleSubmit: (method: import("./PaymentSelectionStep").PaymentMethod, passId?: string | undefined, membershipId?: string | undefined, selection?: PaymentSelection | undefined) => ReturnType<import("./useEventRegistrationSubmit").EventRegistrationSubmit>;
+    handleEventSelect: (value: Parameters<(event: RegistrationEvent) => void>[0]) => void;
     handleRetry: () => void;
 };
 export declare function useEventRegistrationWizardWithDeps(options: UseEventRegistrationWizardOptions, deps: EventRegistrationWizardDeps): {
@@ -190,13 +223,16 @@ export declare function useEventRegistrationWizardWithDeps(options: UseEventRegi
     preSelectedEvent: RegistrationEvent | null;
     hasPreSelectedContext: boolean;
     step: RegistrationStep;
-    setStep: (nextStep: RegistrationStep) => void;
+    setStep: (next: RegistrationStep) => void;
+    admission: import("./registrationCompletion").RegistrationAdmission;
+    ticketContinuation: import("./registrationCompletion").RegistrationTicketContinuation;
+    handleTicketsComplete: () => import("./event-registration.headless.contract").EventRegistrationFlowActionResult;
     selectedEvent: RegistrationEvent | null;
-    setSelectedEvent: import("react").Dispatch<import("react").SetStateAction<RegistrationEvent | null>>;
+    setSelectedEvent: (value: Parameters<import("react").Dispatch<import("react").SetStateAction<RegistrationEvent | null>>>[0]) => void;
     ticketsCount: number;
-    setTicketsCount: (nextTicketsCount: number) => void;
+    setTicketsCount: (value: Parameters<(nextTicketsCount: number) => void>[0]) => void;
     selectedAttendanceMode: "in_person" | "online" | null;
-    setSelectedAttendanceMode: import("react").Dispatch<import("react").SetStateAction<"in_person" | "online" | null>>;
+    setSelectedAttendanceMode: (value: Parameters<import("react").Dispatch<import("react").SetStateAction<"in_person" | "online" | null>>>[0]) => void;
     ticketSelections: Readonly<{
         pricingOptionId: string | null;
         quantity: number;
@@ -207,7 +243,7 @@ export declare function useEventRegistrationWizardWithDeps(options: UseEventRegi
     }>[];
     setSelectedTicketLines: (lines: readonly EventTicketSelectionLine[]) => void;
     selectedSlidingAmountInput: string;
-    setSelectedSlidingAmountInput: import("react").Dispatch<import("react").SetStateAction<string>>;
+    setSelectedSlidingAmountInput: (value: Parameters<import("react").Dispatch<import("react").SetStateAction<string>>>[0]) => void;
     selectedSlidingAmount: number | null;
     selectedEventSlidingScale: Readonly<{
         minAmount: number;
@@ -232,10 +268,10 @@ export declare function useEventRegistrationWizardWithDeps(options: UseEventRegi
     mailingListSignup: Readonly<{
         siteName: string;
     }> | null;
-    setFormData: import("react").Dispatch<import("react").SetStateAction<FormData>>;
+    setFormData: (value: Parameters<import("react").Dispatch<import("react").SetStateAction<FormData>>>[0]) => void;
     errors: Partial<Record<keyof FormData, string>>;
     guests: Guest[];
-    setGuests: import("react").Dispatch<import("react").SetStateAction<Guest[]>>;
+    setGuests: (value: Parameters<import("react").Dispatch<import("react").SetStateAction<Guest[]>>>[0]) => void;
     guestErrors: GuestErrors;
     guestSectionShake: boolean;
     handleGuestShakeEnd: () => void;
@@ -252,7 +288,7 @@ export declare function useEventRegistrationWizardWithDeps(options: UseEventRegi
     handleLogout: () => void;
     paymentStepState: PaymentStepState;
     handlePaymentStepStateChange: (state: PaymentStepState) => void;
-    handlePaymentSelectionChange: (selection: PaymentSelection) => void;
+    handlePaymentSelectionChange: (value: Parameters<(selection: PaymentSelection) => void>[0]) => void;
     paymentSelection: PaymentSelection;
     isMembershipFastTrack: boolean;
     waitlistClaim: import("../../shared/useWaitlistClaim").UseWaitlistClaimResult;
@@ -276,7 +312,7 @@ export declare function useEventRegistrationWizardWithDeps(options: UseEventRegi
     hasMembershipEligibility: boolean;
     requireGuestDetails: boolean;
     discountCode: string;
-    setDiscountCode: (code: string) => void;
+    setDiscountCode: (value: string) => void;
     discountUiOpen: boolean;
     setDiscountUiOpen: (isOpen: boolean) => void;
     discountsAvailable: boolean;
@@ -285,18 +321,48 @@ export declare function useEventRegistrationWizardWithDeps(options: UseEventRegi
     discountsAvailableLoading: boolean;
     discountContext: import("../../api").DiscountContext | null;
     shouldShowDiscountToggle: boolean;
-    verification: import("./useEventRegistrationStripeReturn").EventRegistrationStripeReturnResult;
+    verification: {
+        retry: () => void;
+        retryReturn: () => void;
+        status: "idle" | "polling" | "completed" | "failed" | "timeout";
+        result: import("../../api").EventCheckoutReturnResponse | null;
+        error: Error | null;
+    };
+    paymentController: {
+        backToBooking: () => Promise<void>;
+        continuePayment: () => void;
+        returnToPayment: () => void;
+        returnToBooking: () => void;
+        check: () => void;
+        retryPaymentLoad: () => void;
+        verification: {
+            retry: () => void;
+            retryReturn: () => void;
+            status: "idle" | "polling" | "completed" | "failed" | "timeout";
+            result: import("../../api").EventCheckoutReturnResponse | null;
+            error: Error | null;
+        };
+        state: import("./types").EventPaymentState;
+        recovery: import("./types").PaymentStatusRecoveryState | null;
+        showRecovery: (next: import("./types").PaymentStatusRecoveryState | null) => void;
+        restoreMailingListNote: (value: import("./types").PaymentStatusRecoveryState["mailingListSignupNote"]) => void;
+        openPayment: (checkout: import("../../api/types").EventEmbeddedCheckout, subject: import("../../api/types").EventRegistrationPaymentSubject, mailingListSignupNote?: import("./types").PaymentStatusRecoveryState["mailingListSignupNote"]) => void;
+        verify: (request: import("../../api").EventCheckoutReturnRequest, resumePayment?: boolean) => void;
+    };
     paymentStatusRecovery: import("./types").PaymentStatusRecoveryState | null;
     handleCheckPaymentStatus: () => void;
     handleContinueExistingPayment: () => void;
     handleReturnToPayment: () => void;
     handleReturnToBooking: () => void;
+    recoveryMessage: string | null;
+    checkingNextStep: boolean;
+    handleRecoveryEmail: () => Promise<import("./event-registration.headless.contract").EventRegistrationFlowActionResult>;
     handleDetailsComplete: () => Promise<EventRegistrationDetailsCompleteResult>;
     handlePaymentSelect: () => Promise<void>;
     handleUseCardInsteadOfPass: () => void;
     handleBookForSomeoneElse: () => void;
-    handleSubmit: import("./useEventRegistrationSubmit").EventRegistrationSubmit;
-    handleEventSelect: (event: RegistrationEvent) => void;
+    handleSubmit: (method: import("./PaymentSelectionStep").PaymentMethod, passId?: string | undefined, membershipId?: string | undefined, selection?: PaymentSelection | undefined) => ReturnType<import("./useEventRegistrationSubmit").EventRegistrationSubmit>;
+    handleEventSelect: (value: Parameters<(event: RegistrationEvent) => void>[0]) => void;
     handleRetry: () => void;
 };
 export type UseEventRegistrationWizardResult = ReturnType<typeof useEventRegistrationWizard>;

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

@@ -0,0 +1,30 @@
+import type { EventRegistrationNextStepResponse } from '../../api/types';
+import type { BoundBlockApiClient } from '../../api';
+import type { FormData, RegistrationStep, EventTicketSelectionLine, RegistrationAttendanceMode } from './types';
+import type { EventRegistrationFlowActionResult } from './event-registration.headless.contract';
+import { type RegistrationAdmission } from './registrationCompletion';
+import { type resolveRegistrationTarget } from './registrationDerivations';
+import type { PortalAuthState } from './hooks';
+type Input = Readonly<{
+    api: Pick<BoundBlockApiClient, 'checkRegistrationNextStep'>;
+    formData: FormData;
+    onRecoveryChecked: (outcome: EventRegistrationNextStepResponse) => void;
+    registrationTarget: ReturnType<typeof resolveRegistrationTarget>;
+    selectedAttendanceMode: RegistrationAttendanceMode | null;
+    ticketSelections: readonly EventTicketSelectionLine[];
+    selectedSlidingAmount: number | null;
+    altchaSolution: string | null;
+    step: RegistrationStep;
+    portalAuthState: PortalAuthState;
+    admission: RegistrationAdmission;
+    setErrors: (errors: Partial<Record<keyof FormData, string>>) => void;
+}>;
+/** Guest email is navigation permission only. Discard checks when the visitor
+ * changes identity or selection before the response arrives. */
+export declare function useGuestRegistrationRecovery(input: Input): {
+    checkingNextStep: boolean;
+    recoveryMessage: string | null;
+    checkDetailsNextStep: () => Promise<EventRegistrationNextStepResponse>;
+    handleRecoveryEmail: () => Promise<EventRegistrationFlowActionResult>;
+};
+export {};

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

@@ -1,23 +1,35 @@
 import { type Dispatch, type SetStateAction } from 'react';
 import type { BlockApiClient } from '../../api/client';
-import type { EventRegistrationStatusReference } from '../../api/types';
-import type { PaymentStatusRecoveryState, RegistrationResult, RegistrationStep } from './types';
-type PaymentStatusSetters = Readonly<{
-    setPendingRegistrationReference: Dispatch<SetStateAction<EventRegistrationStatusReference | null>>;
+import type { EventCheckoutReturnRequest, EventCheckoutReturnResponse, EventEmbeddedCheckout, EventRegistrationPaymentSubject } from '../../api/types';
+import type { EventPaymentState, PaymentStatusRecoveryState, RegistrationResult, RegistrationStep } from './types';
+type Options = Readonly<{
+    api: BlockApiClient;
+    beginNewSubmission: () => void;
     setRegistrationResult: Dispatch<SetStateAction<RegistrationResult | null>>;
     setOptionsRefreshKey: Dispatch<SetStateAction<number>>;
     setStep: (step: RegistrationStep) => void;
+    /** Whether this page still holds the booker's details; a restored page after a reload does not. */
+    detailsInPage: () => boolean;
 }>;
-type UsePaymentStatusRecoveryOptions = PaymentStatusSetters & Readonly<{
-    api: BlockApiClient;
-    beginNewSubmission: () => void;
-}>;
-export declare function usePaymentStatusRecovery(options: UsePaymentStatusRecoveryOptions): {
-    recovery: PaymentStatusRecoveryState | null;
-    showRecovery: (next: PaymentStatusRecoveryState | null) => void;
-    check: () => void;
+export declare function usePaymentStatusRecovery(options: Options): {
+    backToBooking: () => Promise<void>;
     continuePayment: () => void;
     returnToPayment: () => void;
     returnToBooking: () => void;
+    check: () => void;
+    retryPaymentLoad: () => void;
+    verification: {
+        retry: () => void;
+        retryReturn: () => void;
+        status: "idle" | "polling" | "completed" | "failed" | "timeout";
+        result: EventCheckoutReturnResponse | null;
+        error: Error | null;
+    };
+    state: EventPaymentState;
+    recovery: PaymentStatusRecoveryState | null;
+    showRecovery: (next: PaymentStatusRecoveryState | null) => void;
+    restoreMailingListNote: (value: PaymentStatusRecoveryState["mailingListSignupNote"]) => void;
+    openPayment: (checkout: EventEmbeddedCheckout, subject: EventRegistrationPaymentSubject, mailingListSignupNote?: PaymentStatusRecoveryState["mailingListSignupNote"]) => void;
+    verify: (request: EventCheckoutReturnRequest, resumePayment?: boolean) => void;
 };
 export {};

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

@@ -0,0 +1,18 @@
+import { type Dispatch } from 'react';
+import { resolveRegistrationAdmission } from './registrationCompletion';
+import type { RegistrationFlowAction } from './registrationStateMachine';
+import type { EventRegistrationFlowActionResult } from './event-registration.headless.contract';
+/** Owns admission and its navigation commands; renderers receive decisions. */
+export declare function useRegistrationAdmission(input: Parameters<typeof resolveRegistrationAdmission>[0] & Readonly<{
+    existingRegistrationLoading: boolean;
+    ticketSelectionRequired: boolean;
+    hasValidTicketSelection: boolean;
+    dispatchFlow: Dispatch<RegistrationFlowAction>;
+}>): {
+    admission: import("./registrationCompletion").RegistrationAdmission;
+    ticketContinuation: import("./registrationCompletion").RegistrationTicketContinuation;
+    handleTicketsComplete: () => EventRegistrationFlowActionResult;
+    onRecoveryChecked: (outcome: Extract<RegistrationFlowAction, {
+        type: "recovery-checked";
+    }>["outcome"]) => void;
+};

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

@@ -3,6 +3,11 @@ import type { RegistrationStep } from './types';
  * Steps that are part of the main wizard and should show the step indicator
  */
 export declare const WIZARD_STEPS: RegistrationStep[];
+/** Recovery uses the form surface without adding a progress step. */
+export declare function getRegistrationStepPresentation(step: RegistrationStep, progressSteps: readonly RegistrationStep[]): Readonly<{
+    isWizardStep: boolean;
+    totalSteps: number;
+}>;
 /**
  * Determine which wizard steps to show based on context and payment requirements.
  *
@@ -10,7 +15,7 @@ export declare const WIZARD_STEPS: RegistrationStep[];
  * @param needsPaymentStep - Whether user must complete payment method selection
  * @returns Array of wizard steps to display
  */
-export declare function getWizardStepsForContext(hasPreSelectedContext: boolean, needsPaymentStep: boolean): readonly RegistrationStep[];
+export declare function getWizardStepsForContext(hasPreSelectedContext: boolean, needsPaymentStep: boolean, paymentActive?: boolean): readonly RegistrationStep[];
 /**
  * Map wizard step to step number based on the active wizard steps
  */

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

@@ -9,7 +9,7 @@ import { type EventRegistrationPageSurfaceSubject } from './event-registration/e
 import { type InteractiveIslandProps } from '../../../contracts/islands';
 import { type EventRegistrationEventSource } from './event-registration/eventSourceRecovery';
 export declare const EVENT_REGISTRATION_GENERIC_SHELL_STEP_LABELS: readonly ["Date", "Tickets", "Details"];
-declare const EVENT_REGISTRATION_SHELL_STEP_LABELS: readonly ["Event", "Date", "Tickets", "Details", "Payment"];
+declare const EVENT_REGISTRATION_SHELL_STEP_LABELS: readonly ["Event", "Date", "Tickets", "Details", "Payment options", "Payment"];
 export type EventRegistrationGenericShellStepLabels = typeof EVENT_REGISTRATION_GENERIC_SHELL_STEP_LABELS;
 type EventRegistrationShellStepLabel = (typeof EVENT_REGISTRATION_SHELL_STEP_LABELS)[number];
 export type EventRegistrationSourceProps = Readonly<{

package/dist/_dts/blocks/src/system/runtime/shared/stripe/browserStripe.d.ts

@@ -0,0 +1,8 @@
+import type { Stripe } from '@stripe/stripe-js';
+import type { EmbeddedCheckoutBrowserContext } from '../../../../../../commerce/src/purchase/index';
+import type { BrowserStripeKey } from '../../../../../../commerce/src/purchase/index';
+export { checkBrowserStripeKey, type BrowserStripeKey } from '../../../../../../commerce/src/purchase/index';
+/** Pure entry loading stays inert until a payment surface calls this function. */
+export declare function loadBrowserStripe(context: EmbeddedCheckoutBrowserContext | Extract<BrowserStripeKey, {
+    tag: 'ready';
+}>): Promise<Stripe | null>;

package/dist/_dts/blocks/src/system/transforms/registry/eventCalendar.d.ts

@@ -20,4 +20,12 @@ declare const readJobSchema: z.ZodObject<{
 }, z.core.$strip>;
 export declare const eventCalendarReadProfile: TransformDefinition;
 export declare const eventCalendarReadEnabled: TransformDefinition<z.infer<typeof readJobSchema>>;
+/**
+ * The week board's authored band paints `surfaceAlt` across the whole
+ * section, under whatever foreground the section resolved. That foreground is
+ * the page's only when the section paints nothing itself, so the band is
+ * honoured on a plain section and dropped when a Look or override already
+ * paints one (light band text on a pale board band otherwise).
+ */
+export declare const eventCalendarBanded: TransformDefinition;
 export {};

package/dist/_dts/commerce/src/purchase/checkoutCopy.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Customer copy shared by checkout surfaces, so one approved wording reaches
+ * every place that shows it.
+ */
+export declare const checkoutCopy: {
+    /** A payment is still being confirmed; checking again is safe. */
+    readonly checkoutStillConfirming: "We’re still confirming your payment. This can take a minute – you can check again, and you won’t be charged twice.";
+    /** A previous attempt can't be confirmed automatically; the business needs to check it. */
+    readonly checkoutAssistanceRequired: "We can’t confirm your last payment attempt yet. Please don’t pay again – contact the business so they can check it.";
+};

package/dist/_dts/commerce/src/purchase/checkoutPresentation.d.ts

@@ -0,0 +1,49 @@
+/** Browser-safe Checkout contracts shared by payment owners. */
+type CheckoutPresentationFields = {
+    hosted: Readonly<{
+        successUrl: string;
+        cancelUrl: string;
+    }>;
+    embedded: Readonly<{
+        returnUrl: string;
+        redirectOnCompletion: 'always' | 'if_required';
+    }>;
+};
+type CheckoutSessionFields = {
+    hosted: Readonly<{
+        checkoutUrl: string;
+    }>;
+    embedded: Readonly<{
+        clientSecret: string;
+        livemode: boolean;
+    }>;
+};
+export type CheckoutMode = keyof CheckoutPresentationFields;
+export type CheckoutPresentation<M extends CheckoutMode = CheckoutMode> = {
+    [K in CheckoutMode]: Readonly<{
+        mode: K;
+    }> & CheckoutPresentationFields[K];
+}[M];
+export type CheckoutSessionHandle<M extends CheckoutMode = CheckoutMode> = {
+    [K in CheckoutMode]: Readonly<{
+        kind: K;
+        sessionId: string;
+    }> & CheckoutSessionFields[K];
+}[M];
+export type EmbeddedCheckoutBrowserContext = Readonly<{
+    kind: 'connect';
+    publishableKey: string;
+    accountId: string;
+}> | Readonly<{
+    kind: 'direct';
+    publishableKey: string;
+}>;
+export type BrowserStripeKey = Readonly<{
+    tag: 'ready';
+    publishableKey: string;
+}> | Readonly<{
+    tag: 'unavailable';
+    reason: 'missing_key' | 'invalid_key' | 'mode_mismatch';
+}>;
+export declare function checkBrowserStripeKey(publishableKey: string | undefined, livemode: boolean): BrowserStripeKey;
+export {};

package/dist/_dts/commerce/src/purchase/checkoutSessionMetadata.d.ts

@@ -32,9 +32,9 @@ export declare const OrderCheckoutSessionMetadataSchema: z.ZodUnion<readonly [z.
     credit_reserved_cents: z.ZodOptional<z.ZodString>;
     discount_code_amount_cents: z.ZodOptional<z.ZodString>;
     order_payment_reason: z.ZodOptional<z.ZodEnum<{
-        flexible_balance_paydown: "flexible_balance_paydown";
-        instalment_payoff: "instalment_payoff";
         flexible_balance_initial: "flexible_balance_initial";
+        instalment_payoff: "instalment_payoff";
+        flexible_balance_paydown: "flexible_balance_paydown";
     }>>;
     order_payment_plan_id: z.ZodOptional<z.ZodString>;
     order_flexible_balance_contract_id: z.ZodOptional<z.ZodString>;
@@ -63,9 +63,9 @@ export declare const OrderCheckoutSessionMetadataSchema: z.ZodUnion<readonly [z.
     credit_reserved_cents: z.ZodOptional<z.ZodString>;
     discount_code_amount_cents: z.ZodOptional<z.ZodString>;
     order_payment_reason: z.ZodOptional<z.ZodEnum<{
-        flexible_balance_paydown: "flexible_balance_paydown";
-        instalment_payoff: "instalment_payoff";
         flexible_balance_initial: "flexible_balance_initial";
+        instalment_payoff: "instalment_payoff";
+        flexible_balance_paydown: "flexible_balance_paydown";
     }>>;
     order_payment_plan_id: z.ZodOptional<z.ZodString>;
     order_flexible_balance_contract_id: z.ZodOptional<z.ZodString>;

package/dist/_dts/commerce/src/purchase/checkoutStripeFinalizationPlanning.d.ts

@@ -1,5 +1,9 @@
 export type CheckoutStripeFinalizationPaymentPlanKind = 'stripe' | 'instalment_plan' | 'flexible_balance';
-export type CheckoutStripeSessionRecordUpdateTarget = 'order' | 'order_payment_plan' | 'flexible_balance_contract';
+/**
+ * The records besides the order that follow a newly created Stripe session.
+ * The order's own session is bound by the initial-session binder, never here.
+ */
+export type CheckoutStripeSessionRecordUpdateTarget = 'order_payment_plan' | 'flexible_balance_contract';
 export type CheckoutStripeSessionRecordUpdatePlan = Readonly<{
     target: CheckoutStripeSessionRecordUpdateTarget;
     orderId: string;

package/dist/_dts/commerce/src/purchase/event-registration-errors.d.ts

@@ -1,4 +1,5 @@
 export type EventRegistrationErrorAction = 'none' | 'retry' | 'places' | 'start' | 'details' | 'payment-options' | 'portal' | 'event';
+export declare const unfinishedBookingAssistanceMessage = "We couldn\u2019t safely find your unfinished booking. Please contact the organiser before trying to book again.";
 export declare const eventRegistrationErrors: {
     readonly registrationClosed: {
         readonly message: "Booking is currently closed for this event. Please contact the organiser if you’d like to find out more.";
@@ -12,6 +13,14 @@ export declare const eventRegistrationErrors: {
         readonly message: "We couldn’t reach the payment provider. Please try again in a minute.";
         readonly action: "retry";
     };
+    readonly paymentHostUnavailable: {
+        readonly message: "Card payments aren’t available on this web address yet. Please contact the organiser to book.";
+        readonly action: "none";
+    };
+    readonly checkoutTemporarilyUnavailable: {
+        readonly message: "Event payments are temporarily unavailable while we make an update. Please try again later.";
+        readonly action: "retry";
+    };
     readonly paymentPageUnavailable: {
         readonly message: "We couldn’t open the payment page. Please refresh this page and try again. If this keeps happening, contact the organiser for help.";
         readonly action: "retry";