@riverbankcms/sdk 0.139.0 → 0.140.0

package/dist/client/{eventRegistration-CYqtkCE_.mjs → eventRegistration-I6EaokFD.mjs}

@@ -1,14 +1,14 @@
 "use client";
-import { a as buildBookingPaymentSelectionViewModel, i as usePolling, n as StepIndicator$1, o as resolveBookingPaymentDueNowCents, r as SpinnerNode, s as formatPrice, t as BookingConsentAgreement } from "./BookingConsentAgreement-CZvTDtsK.mjs";
-import { C as WIZARD_STEPS, Jt as formatBookingTime, Kt as formatBookingDateTime, Nt as assertNever, O as resolveEventRegistrationScopedEvents, S as resolveRegistrationTarget, T as getWizardStepsForContext, Wt as formatBookingDate, _ as toWholeSeriesRegistrationEvents, at as groupPublicEventsByRun, b as resolveDiscountContext, cn as publicEventPricingOptions, dn as formatCurrencyAmount, en as toBookingTimeZone, fn as parseCurrencyCode, g as toRegistrationEvents, h as getRegistrationStartAt, ln as publicEventPricingStrategy, nn as toScheduledBookingDateTime, on as publicEventPricingCurrency, t as defineIslandPropsDecoder, un as publicEventPricingType, ut as themeButtonClassName, v as findEventByOccurrenceId, w as getStepNumber, x as resolveEventRequiresPayment, y as findPreSelectedEvent } from "./propsDecoder-DYzafZb2.mjs";
-import { a as canJoinEventWaitlistOnAnyMode, c as formatTicketTypeRemaining, f as getRemainingPlaces, h as selectMostOpenCapacitySource, i as canJoinEventWaitlist, m as selectEventCapacitySource, o as formatEventRemainingPlaces, p as isEventFull, r as formatEventPriceDisplay, s as formatRemainingPlaces, u as getEventAvailability } from "./pricing-Uzw-GQ6Y.mjs";
-import { n as useBlockApi, r as BlockApiError, t as BlockApiProvider } from "./context-DvU_WUmd.mjs";
+import { a as buildBookingPaymentSelectionViewModel, i as usePolling, n as StepIndicator$1, o as resolveBookingPaymentDueNowCents, r as SpinnerNode, s as formatPrice, t as BookingConsentAgreement } from "./BookingConsentAgreement-CuKa82V4.mjs";
+import { C as resolveRegistrationTarget, E as getWizardStepsForContext, Gt as formatBookingDate, Pt as assertNever, S as resolveEventRequiresPayment, T as getStepNumber, Yt as formatBookingTime, _ as toRegistrationEvents, b as findPreSelectedEvent, dn as publicEventPricingType, dt as themeButtonClassName, fn as formatCurrencyAmount, g as getRegistrationStartAt, h as buildEventRegistrationDisplayFromScopedEvents, k as resolveEventRegistrationScopedEvents, ln as publicEventPricingOptions, ot as groupPublicEventsByRun, pn as parseCurrencyCode, qt as formatBookingDateTime, rn as toScheduledBookingDateTime, sn as publicEventPricingCurrency, t as defineIslandPropsDecoder, tn as toBookingTimeZone, un as publicEventPricingStrategy, v as toWholeSeriesRegistrationEvents, w as WIZARD_STEPS, x as resolveDiscountContext, y as findEventByOccurrenceId } from "./propsDecoder-CB2KS_ko.mjs";
+import { a as canJoinEventWaitlistOnAnyMode, c as formatTicketTypeRemaining, f as getRemainingPlaces, h as selectMostOpenCapacitySource, i as canJoinEventWaitlist, m as selectEventCapacitySource, o as formatEventRemainingPlaces, p as isEventFull, r as formatEventPriceDisplay, s as formatRemainingPlaces, u as getEventAvailability } from "./pricing-Copadu-2.mjs";
+import { n as useBlockApi, r as BlockApiError, t as BlockApiProvider } from "./context-Cy1OayHx.mjs";
 import { n as isSpamProtectionEnabled, r as AltchaWidget, t as getChallengeUrl } from "./src-B833rYRr.mjs";
-import { a as CheckIcon, i as StateIcon, n as useDiscountCodeUi, r as TerminalPanel, t as scrollToBlock } from "./scrollToBlock-CvXszexS.mjs";
-import { t as DiscountCodeDisclosure } from "./DiscountCodeDisclosure-D-DsLCMU.mjs";
+import { a as CheckIcon, i as StateIcon, n as useDiscountCodeUi, r as TerminalPanel, t as scrollToBlock } from "./scrollToBlock-B1IS1_ua.mjs";
+import { t as DiscountCodeDisclosure } from "./DiscountCodeDisclosure-BbYieKWB.mjs";
 import { t as FeedbackMessage } from "./FeedbackMessage-CtLvvS_d.mjs";
 import { n as getFieldValidationControlProps, t as FieldValidationMessage } from "./FieldValidationMessage-AYanWFb-.mjs";
-import { t as buildCheckoutReturnUrls } from "./checkoutUrls-BuseL0dw.mjs";
+import { t as buildCheckoutReturnUrls } from "./checkoutUrls-FL6lRkrt.mjs";
 import { t as createBodyThemePortalRoot } from "./themePortalRoot-AGs4cE7t.mjs";
 import { n as consumeSearchParams } from "./urlParams-D71VXFGx.mjs";
 import { t as CrossIcon } from "./CrossIcon-Dn1KRKW5.mjs";
@@ -503,6 +503,90 @@ function missingPaymentSelection() {
 	};
 }
 //#endregion
+//#region ../blocks/src/system/runtime/nodes/event-registration/checkoutRecovery.ts
+/** Recovery may select held places; checkout still owns admission and payment validation. */
+function checkoutRecoveryOptionAvailability(availability) {
+	if (availability.kind === "available" || availability.reason === "sold_out" || availability.reason === "overallCapacityUnavailable") return {
+		kind: "available",
+		remainingPlaces: null
+	};
+	return availability;
+}
+/**
+* A form-only projection for the explicit existing-checkout path. It permits
+* collecting the original selection without claiming a new place is available.
+* The public checkout service identifies the customer and remains the admission
+* authority; no reservation/customer data is exposed through this projection.
+*/
+function getCheckoutRecoveryFormEligibility(eligibility) {
+	if (!eligibility || eligibility.registration.kind !== "none" && eligibility.registration.kind !== "pending_payment" || eligibility.availability.kind === "unavailable" && eligibility.availability.reason !== "full" && eligibility.availability.reason !== "selectionRequired") return eligibility;
+	const amountCents = eligibility.price ?? 0;
+	if (amountCents <= 0 || !eligibility.currency || eligibility.availability.kind === "unavailable" && eligibility.availability.reason === "selectionRequired") return eligibility.registration.kind === "pending_payment" ? {
+		...eligibility,
+		registration: { kind: "none" },
+		ticketTypes: eligibility.ticketTypes.map((option) => ({
+			...option,
+			availability: checkoutRecoveryOptionAvailability(option.availability)
+		}))
+	} : eligibility;
+	const currency = eligibility.currency;
+	const paymentOptions = eligibility.paymentTerms.allowedOptions.map((option) => {
+		switch (option.kind) {
+			case "upfront": return {
+				kind: "payInFull",
+				amountCents,
+				currency
+			};
+			case "deferred_manual": return {
+				kind: "deferredManual",
+				amountCents,
+				currency
+			};
+			case "instalment_plan": return {
+				kind: "instalmentPlan",
+				amountCents,
+				currency
+			};
+			case "flexible_balance": return {
+				kind: "flexibleBalance",
+				amountCents,
+				currency
+			};
+		}
+	});
+	return {
+		...eligibility,
+		registration: { kind: "none" },
+		availability: {
+			kind: "available",
+			remainingPlaces: null,
+			waitlistEnabled: eligibility.waitlistEnabled
+		},
+		eligible: paymentOptions.length > 0,
+		isFull: false,
+		canJoinWaitlist: false,
+		isFree: false,
+		requiresPayment: true,
+		canPayDirectly: paymentOptions.length > 0,
+		paymentOptions,
+		eligiblePasses: [],
+		eligibleMemberships: [],
+		ticketTypes: eligibility.ticketTypes.map((option) => ({
+			...option,
+			availability: checkoutRecoveryOptionAvailability(option.availability)
+		}))
+	};
+}
+function isSoldOutEventSelectable(event, waitlistAvailable) {
+	return waitlistAvailable || canRecoverEventCheckout(event);
+}
+function canJoinWaitlistOutsideRecovery(event, attendanceMode, checkoutRecovery) {
+	return !checkoutRecovery && event !== null && canJoinEventWaitlist(event, { attendanceMode });
+}
+function canRecoverEventCheckout(event) {
+	return event !== null && (event.registrationSubject.kind === "wholeSeries" || event.pricing.kind !== "free" && event.pricing.kind !== "external");
+}
+//#endregion
 //#region ../blocks/src/system/runtime/nodes/event-registration/utils.ts
 function getPortalSubjectEmail(profile) {
 	return profile?.email ?? null;
@@ -688,7 +772,7 @@ const EventSelectionStep = ({ events, selectedEvent, onSelect, showVenue, showCa
 				const remaining = getRemainingPlaces(selectMostOpenCapacitySource(event));
 				const isSoldOut = isEventFull(event);
 				const canJoinWaitlist = canJoinEventWaitlistOnAnyMode(event);
-				const isUnavailable = isSoldOut && !canJoinWaitlist;
+				const isUnavailable = isSoldOut && !isSoldOutEventSelectable(event, canJoinWaitlist);
 				const isLowCapacity = remaining.kind === "low";
 				const capacityLabel = formatEventRemainingPlaces(event, { full: "Sold out" });
 				const timeZone = event.timeZone ?? null;
@@ -733,6 +817,33 @@ const EventSelectionStep = ({ events, selectedEvent, onSelect, showVenue, showCa
 	});
 };
 //#endregion
+//#region ../blocks/src/system/runtime/nodes/event-registration/useCheckoutRecovery.ts
+/** Recovery belongs to the selected booking subject; changing events resets its scope. */
+function useCheckoutRecovery(event, setStep) {
+	const [recoveryEventId, setRecoveryEventId] = useState(null);
+	return {
+		checkoutRecovery: event !== null && recoveryEventId === event.selectionId,
+		startCheckoutRecovery: useCallback(() => {
+			if (!event) return;
+			setRecoveryEventId(event.selectionId);
+			setStep("select-tickets");
+		}, [event, setStep])
+	};
+}
+/** Authenticated pending bookings enter the same form-only recovery path as guests. */
+function useCheckoutRecoveryEligibility(eligibility, step, checkoutRecovery, startCheckoutRecovery) {
+	const registrationKind = eligibility?.registration.kind;
+	useEffect(() => {
+		if ((step === "select-event" || step === "select-tickets" || step === "enter-details" || step === "select-payment") && registrationKind === "pending_payment" && !checkoutRecovery) startCheckoutRecovery();
+	}, [
+		registrationKind,
+		step,
+		checkoutRecovery,
+		startCheckoutRecovery
+	]);
+	return useMemo(() => checkoutRecovery ? getCheckoutRecoveryFormEligibility(eligibility) : eligibility, [checkoutRecovery, eligibility]);
+}
+//#endregion
 //#region ../blocks/src/system/runtime/nodes/event-registration/registrationErrorRecovery.ts
 function resolveRegistrationRecoveryAction(step, action) {
 	if (step === "payment-failed") return "payment-options";
@@ -1373,6 +1484,10 @@ const eventRegistrationErrors = {
 		message: "We’re checking your booking and payment. Please don’t try to book again yet. If you’ve already paid, you don’t need to pay again.",
 		action: "payment-status"
 	},
+	paymentProviderUnavailable: {
+		message: "We couldn’t reach the payment provider. Please try again in a minute.",
+		action: "retry"
+	},
 	paymentPageUnavailable: {
 		message: "We couldn’t open the payment page. Please refresh this page and try again. If this keeps happening, contact the organiser for help.",
 		action: "retry"
@@ -1495,11 +1610,6 @@ function ensureWaitlistClaimLocationTracking() {
 	} catch {}
 	window.addEventListener("popstate", emitWaitlistClaimLocationChange);
 }
-function getWaitlistClaimTokenFromUrl() {
-	if (typeof window === "undefined") return null;
-	const token = new URLSearchParams(window.location.search).get("waitlist_claim")?.trim() ?? "";
-	return token.length > 0 ? token : null;
-}
 const useWaitlistClaimDeps = { useBlockApi };
 function subscribeToWaitlistClaimToken(callback) {
 	if (typeof window === "undefined") return () => {};
@@ -1509,28 +1619,42 @@ function subscribeToWaitlistClaimToken(callback) {
 		window.removeEventListener(WAITLIST_CLAIM_LOCATION_EVENT, callback);
 	};
 }
-function getWaitlistClaimTokenSnapshot() {
-	return getWaitlistClaimTokenFromUrl();
+function getWaitlistClaimLocationSnapshot() {
+	return typeof window === "undefined" ? "" : window.location.search;
+}
+function parseWaitlistClaimCredential(search) {
+	const params = new URLSearchParams(search);
+	const token = params.get("waitlist_claim")?.trim();
+	if (token) return {
+		kind: "emailedToken",
+		token
+	};
+	const entryId = params.get("waitlistEntry")?.trim();
+	return entryId ? {
+		kind: "portalOwnedEntry",
+		entryId
+	} : null;
 }
 function useWaitlistClaim() {
 	return useWaitlistClaimWithDeps(useWaitlistClaimDeps);
 }
 function useWaitlistClaimWithDeps(deps) {
-	return useResolvedWaitlistClaim(deps, useSyncExternalStore(subscribeToWaitlistClaimToken, getWaitlistClaimTokenSnapshot, () => null));
+	const locationSearch = useSyncExternalStore(subscribeToWaitlistClaimToken, getWaitlistClaimLocationSnapshot, () => "");
+	return useResolvedWaitlistClaim(deps, useMemo(() => parseWaitlistClaimCredential(locationSearch), [locationSearch]));
 }
-function useResolvedWaitlistClaim(deps, token) {
+function useResolvedWaitlistClaim(deps, credential) {
 	const api = deps.useBlockApi();
-	const [state, dispatch] = useReducer(waitlistClaimReducer, Boolean(token), createInitialWaitlistClaimState);
+	const [state, dispatch] = useReducer(waitlistClaimReducer, Boolean(credential), createInitialWaitlistClaimState);
 	useEffect(() => {
 		let cancelled = false;
 		async function resolveClaim() {
-			if (!token) {
+			if (!credential) {
 				dispatch({ type: "cleared" });
 				return;
 			}
 			dispatch({ type: "started" });
 			try {
-				const result = await api.resolveWaitlistClaim({ claimToken: token });
+				const result = credential.kind === "portalOwnedEntry" ? await api.resolveWaitlistClaim({ waitlistEntryId: credential.entryId }) : await api.resolveWaitlistClaim({ claimToken: credential.token });
 				if (cancelled) return;
 				dispatch({
 					type: "resolved",
@@ -1548,9 +1672,10 @@ function useResolvedWaitlistClaim(deps, token) {
 		return () => {
 			cancelled = true;
 		};
-	}, [api, token]);
+	}, [api, credential]);
 	return {
-		token,
+		token: credential?.kind === "emailedToken" ? credential.token : null,
+		entryId: credential?.kind === "portalOwnedEntry" ? credential.entryId : null,
 		claim: getWaitlistClaim(state),
 		error: getWaitlistClaimError(state),
 		loginMessage: getWaitlistClaimLoginMessage(state),
@@ -2032,15 +2157,12 @@ function useEventRegistrationSubmitWithDeps(options, deps) {
 	* landed — a success, or a hand-off to checkout — because until then nobody
 	* knows whether the first one committed.
 	*
-	* Reusing it after a failure is safe even if the customer edits their
-	* details. The server consults the command record before it re-checks
-	* anything, so a submission that already booked is answered with the booking
-	* that exists — not refused for spending a credit or a claim that this very
-	* command already spent, and not treated as a second booking because a name
-	* or a note changed in between.
+	* Identical retries retain the command after a lost response. Changed form
+	* details get a new command so the server applies the new booking intent.
 	*/
-	const commandIdRef = useRef(null);
-	return async (method, passId, membershipId, selection, submitOptions) => {
+	const commandRef = useRef(null);
+	const inFlightRef = useRef(null);
+	const submit = async (method, passId, membershipId, selection, submitOptions) => {
 		const target = options.registrationTarget;
 		if (!target) return {
 			ok: false,
@@ -2048,44 +2170,34 @@ function useEventRegistrationSubmitWithDeps(options, deps) {
 			message: "Select an event to continue."
 		};
 		options.setStep("submitting");
-		const registrationCommandId = commandIdRef.current ?? deps.createClientCommandId();
-		commandIdRef.current = registrationCommandId;
+		const registrationCommandId = commandRef.current?.id ?? deps.createClientCommandId();
 		try {
-			const prepared = prepareSubmitContext(options, registrationCommandId, target, method, passId, membershipId, selection);
+			let prepared = prepareSubmitContext(options, registrationCommandId, target, method, passId, membershipId, selection);
 			if (prepared.subject.kind === "wholeSeries" && method === "stripe") {
-				commandIdRef.current = null;
+				commandRef.current = null;
 				return await submitWholeSeriesCheckout(options, deps, {
 					...prepared,
 					subject: prepared.subject
 				}, submitOptions);
 			}
+			const request = buildOccurrenceRegistrationRequest(options, prepared, method, passId, membershipId);
+			const intentKey = registrationRequestIntentKey(request);
+			if (commandRef.current !== null && commandRef.current.intentKey !== intentKey) prepared = {
+				...prepared,
+				registrationCommandId: deps.createClientCommandId()
+			};
+			commandRef.current = {
+				id: prepared.registrationCommandId,
+				intentKey
+			};
 			const result = await options.api.registerForEvent({
-				registrationCommandId: prepared.registrationCommandId,
-				subject: prepared.subject,
-				ticketSelections: toTicketSelectionRequests(prepared.ticketSelections),
-				selectedSlidingAmount: options.selectedSlidingAmount ?? void 0,
-				email: options.formData.email.trim().toLowerCase(),
-				name: options.formData.name.trim(),
-				phone: options.formData.phone.trim() || void 0,
-				notes: options.formData.notes.trim() || void 0,
-				consentAccepted: options.formData.consentAccepted,
-				altchaSolution: options.altchaSolution,
-				paymentMethod: method,
-				customerPassId: method === "pass" ? passId : void 0,
-				customerMembershipId: method === "membership" ? membershipId : void 0,
-				bundleProductId: prepared.bundleProductId,
-				claimToken: options.claimToken ?? void 0,
-				guests: prepared.guestsPayload
+				...request,
+				registrationCommandId: prepared.registrationCommandId
 			});
-			commandIdRef.current = null;
-			if (needsOccurrenceCheckout(result, method)) return await submitOccurrenceCheckout(options, deps, prepared, result, method, submitOptions);
-			options.setRegistrationResult(toRegistrationResult(result));
-			options.setStep("success");
-			return {
-				ok: true,
-				outcome: { kind: "completed" }
-			};
+			commandRef.current = null;
+			return await completeRegistrationSubmission(options, deps, prepared, result, method, submitOptions);
 		} catch (error) {
+			if (error instanceof BlockApiError && error.tag === "registrationPreparationChanged") commandRef.current = null;
 			const { message, action } = registrationErrorPresentation(error);
 			options.setErrorAction?.(action);
 			options.setErrorMessage(message);
@@ -2097,6 +2209,24 @@ function useEventRegistrationSubmitWithDeps(options, deps) {
 			};
 		}
 	};
+	return (...args) => {
+		if (inFlightRef.current) return inFlightRef.current;
+		const pending = Promise.resolve().then(() => submit(...args));
+		inFlightRef.current = pending;
+		pending.finally(() => {
+			if (inFlightRef.current === pending) inFlightRef.current = null;
+		});
+		return pending;
+	};
+}
+async function completeRegistrationSubmission(options, deps, prepared, result, method, submitOptions) {
+	if (needsOccurrenceCheckout(result, method)) return await submitOccurrenceCheckout(options, deps, prepared, result, method, submitOptions);
+	options.setRegistrationResult(toRegistrationResult(result));
+	options.setStep("success");
+	return {
+		ok: true,
+		outcome: { kind: "completed" }
+	};
 }
 function toTicketSelectionRequests(lines) {
 	return lines.map((line) => ({
@@ -2171,6 +2301,7 @@ async function submitWholeSeriesCheckout(options, deps, prepared, submitOptions)
 		altchaSolution: options.altchaSolution,
 		guests: prepared.guestsPayload,
 		claimToken: options.claimToken ?? void 0,
+		waitlistEntryId: options.waitlistEntryId ?? void 0,
 		discountCode: options.discountCode.trim() || void 0,
 		collectionOptionKind: prepared.selectionSnapshot.collectionOptionKind,
 		checkoutAttemptId,
@@ -2192,14 +2323,14 @@ async function submitWholeSeriesCheckout(options, deps, prepared, submitOptions)
 	}
 	if (result.bypassed) return completeBypassedCheckout(options);
 	if (!result.checkoutUrl) throw new Error("Checkout URL missing");
-	savePendingCheckout(options, deps, prepared, checkoutAttemptId, {
+	savePendingCheckout(options, deps, prepared, result.checkoutAttemptId, {
 		scope: "wholeSeries",
 		registrationId: result.registrationId
 	});
 	return redirectToCheckout(result.checkoutUrl, submitOptions);
 }
 function needsOccurrenceCheckout(result, method) {
-	return result.scope === "occurrence" && !result.alreadyRegistered && result.status === "confirmed" && result.pendingPayment && [
+	return result.scope === "occurrence" && result.status === "confirmed" && result.pendingPayment && [
 		"stripe",
 		"pass_bundle",
 		"membership_bundle"
@@ -2219,6 +2350,7 @@ async function submitOccurrenceCheckout(options, deps, prepared, registration, m
 			kind: "occurrence",
 			attendeeId: registration.attendeeId
 		},
+		registrationCommandId: prepared.registrationCommandId,
 		checkoutType: method === "pass_bundle" ? "pass_bundle" : method === "membership_bundle" ? "membership_bundle" : "event",
 		productId: prepared.bundleProductId,
 		discountCode: options.discountCode.trim() || void 0,
@@ -2261,6 +2393,31 @@ function redirectToCheckout(checkoutUrl, submitOptions) {
 		}
 	};
 }
+function registrationRequestIntentKey(request) {
+	const { registrationCommandId: _command, altchaSolution: _proof, ...intent } = request;
+	return JSON.stringify(intent);
+}
+function buildOccurrenceRegistrationRequest(options, prepared, method, passId, membershipId) {
+	return {
+		registrationCommandId: prepared.registrationCommandId,
+		subject: prepared.subject,
+		ticketSelections: toTicketSelectionRequests(prepared.ticketSelections),
+		selectedSlidingAmount: options.selectedSlidingAmount ?? void 0,
+		email: options.formData.email.trim().toLowerCase(),
+		name: options.formData.name.trim(),
+		phone: options.formData.phone.trim() || void 0,
+		notes: options.formData.notes.trim() || void 0,
+		consentAccepted: options.formData.consentAccepted,
+		altchaSolution: options.altchaSolution,
+		paymentMethod: method,
+		customerPassId: method === "pass" ? passId : void 0,
+		customerMembershipId: method === "membership" ? membershipId : void 0,
+		bundleProductId: prepared.bundleProductId,
+		claimToken: options.claimToken ?? void 0,
+		waitlistEntryId: options.waitlistEntryId ?? void 0,
+		guests: prepared.guestsPayload
+	};
+}
 //#endregion
 //#region ../blocks/src/system/runtime/nodes/event-registration/registrationWizardContext.ts
 function getEventSelectionDefaults(event) {
@@ -2499,14 +2656,28 @@ function useEventRegistrationWizardWithDeps(options, deps) {
 	}), [options.occurrenceContext, selectedEvent]);
 	const registrationOccurrenceId = getRegistrationOccurrenceId(registrationTarget);
 	const currentEvent = selectedEvent ?? preSelectedEvent;
+	const setStep = useCallback((nextStep) => {
+		dispatchFlow({
+			type: "set-step",
+			step: nextStep
+		});
+	}, []);
+	const { checkoutRecovery, startCheckoutRecovery } = useCheckoutRecovery(currentEvent, setStep);
 	const currentEventUsesTicketTypes = usesTieredPricing(currentEvent);
-	const currentCanJoinWaitlist = currentEvent ? canJoinEventWaitlist(currentEvent, { attendanceMode: selectedAttendanceMode }) : false;
+	const currentCanJoinWaitlist = canJoinWaitlistOutsideRecovery(currentEvent, selectedAttendanceMode, checkoutRecovery);
 	const usesTicketTypeSelections = currentEventUsesTicketTypes && !currentCanJoinWaitlist;
 	const eventTicketTypesForSelection = useMemo(() => getVisibleTicketTypes({
 		event: currentEvent,
 		eligibility: null,
 		selectedAttendanceMode
-	}), [currentEvent, selectedAttendanceMode]);
+	}).map((option) => checkoutRecovery ? {
+		...option,
+		availability: checkoutRecoveryOptionAvailability(option.availability)
+	} : option), [
+		currentEvent,
+		selectedAttendanceMode,
+		checkoutRecovery
+	]);
 	const normalizedSelectedTicketLines = useMemo(() => normalizeTicketSelectionLines(selectedTicketLines), [selectedTicketLines]);
 	const ticketTypeSelectionTotal = useMemo(() => getTicketSelectionTotal(normalizedSelectedTicketLines), [normalizedSelectedTicketLines]);
 	const ticketsCount = usesTicketTypeSelections ? ticketTypeSelectionTotal : flowState.ticketsCount;
@@ -2544,17 +2715,11 @@ function useEventRegistrationWizardWithDeps(options, deps) {
 		isAuthenticated: portalAuthState === "authenticated",
 		occurrenceId: registrationOccurrenceId
 	});
-	const eligibility = eligibilityResult.eligibility;
+	const eligibility = useCheckoutRecoveryEligibility(eligibilityResult.eligibility, step, checkoutRecovery, startCheckoutRecovery);
 	const eligibilityLoading = eligibilityResult.isLoading;
 	const eligibilityError = eligibilityResult.error;
 	const portalCreditState = eligibilityResult.creditState;
 	const registrationState = eligibility?.registration ?? { kind: "none" };
-	const setStep = useCallback((nextStep) => {
-		dispatchFlow({
-			type: "set-step",
-			step: nextStep
-		});
-	}, []);
 	const setTicketsCount = useCallback((nextTicketsCount) => {
 		dispatchFlow({
 			type: "set-tickets-count",
@@ -2662,10 +2827,14 @@ function useEventRegistrationWizardWithDeps(options, deps) {
 		event: currentEvent,
 		eligibility,
 		selectedAttendanceMode
-	}), [
+	}).map((option) => checkoutRecovery ? {
+		...option,
+		availability: checkoutRecoveryOptionAvailability(option.availability)
+	} : option), [
 		currentEvent,
 		selectedAttendanceMode,
-		eligibility
+		eligibility,
+		checkoutRecovery
 	]);
 	const singleSelectedPricingOptionId = getSingleSelectedPricingOptionId(normalizedSelectedTicketLines);
 	const selectedTicketType = useMemo(() => findSelectedTicketType({
@@ -2689,8 +2858,12 @@ function useEventRegistrationWizardWithDeps(options, deps) {
 		const event = currentEvent;
 		if (!usesTieredPricing(event)) return false;
 		if ((event.deliveryMode ?? "in_person") === "hybrid" && !selectedAttendanceMode) return false;
-		return !canJoinEventWaitlist(event, { attendanceMode: selectedAttendanceMode });
-	}, [currentEvent, selectedAttendanceMode]);
+		return checkoutRecovery || !canJoinEventWaitlist(event, { attendanceMode: selectedAttendanceMode });
+	}, [
+		currentEvent,
+		selectedAttendanceMode,
+		checkoutRecovery
+	]);
 	const hasValidTicketSelection = hasValidPricingOptionSelection({
 		selectionRequired: ticketTypeSelectionRequired,
 		lines: normalizedSelectedTicketLines,
@@ -2894,6 +3067,7 @@ function useEventRegistrationWizardWithDeps(options, deps) {
 		guests,
 		discountCode: discountUi.discountCode,
 		claimToken: waitlistClaim.token,
+		waitlistEntryId: waitlistClaim.entryId,
 		setPendingRegistrationReference,
 		setStep,
 		setRegistrationResult: (result) => setRegistrationResult(result),
@@ -2956,6 +3130,8 @@ function useEventRegistrationWizardWithDeps(options, deps) {
 		scopedEvents,
 		preSelectedEvent,
 		hasPreSelectedContext,
+		checkoutRecovery,
+		startCheckoutRecovery,
 		step,
 		setStep,
 		selectedEvent,
@@ -3159,6 +3335,51 @@ function getMagicLinkErrorMessage(error) {
 	return error instanceof Error ? error.message : "Failed to send. Please try again.";
 }
 //#endregion
+//#region ../blocks/src/system/runtime/nodes/event-registration/ErrorStep.tsx
+/**
+* Error Step
+*
+* Displays an error message with a retry button when registration fails.
+*/
+const labels = {
+	none: "",
+	retry: "Try again",
+	places: "Choose places",
+	start: "Start again",
+	details: "Check my details",
+	"payment-options": "View payment options",
+	"payment-status": "Check payment status",
+	portal: "View my bookings",
+	event: "View event"
+};
+const ErrorStep = ({ message, onRetry, action = "retry", canJoinWaitlist = false }) => {
+	const offerWaitlist = action === "places" && canJoinWaitlist;
+	return /* @__PURE__ */ jsx(TerminalPanel, {
+		tone: "error",
+		className: "er-center",
+		titleClassName: "er-title--lg er-message",
+		icon: /* @__PURE__ */ jsx(StateIcon, {
+			variant: "error",
+			children: /* @__PURE__ */ jsx(CrossIcon, {})
+		}),
+		title: "We couldn’t complete your booking",
+		body: /* @__PURE__ */ jsx("p", {
+			className: "er-text--muted er-message",
+			children: offerWaitlist ? "Sorry, this event is now full. You can join the waiting list, and we’ll email you if a place becomes available." : message
+		}),
+		actions: action === "none" ? void 0 : action === "portal" || action === "payment-status" ? /* @__PURE__ */ jsx("a", {
+			href: "/portal",
+			className: "er-retry-btn",
+			children: labels[action]
+		}) : /* @__PURE__ */ jsx("button", {
+			type: "button",
+			onClick: onRetry,
+			className: "er-retry-btn",
+			children: offerWaitlist ? "Join the waiting list" : labels[action]
+		})
+	});
+};
+//#endregion
 //#region ../blocks/src/system/runtime/nodes/event-registration/EventRegistrationSummaryBar.tsx
 function getScheduleSummary(wizard, summaryEvent) {
 	if (summaryEvent.registrationSubject.kind !== "wholeSeries") {
@@ -3442,7 +3663,7 @@ function SelectTicketsActions(props) {
 	const currentEvent = wizard.selectedEvent ?? wizard.preSelectedEvent;
 	const registrationOptionsPending = wizard.registrationOptionsState.tag === "idle" || wizard.registrationOptionsState.tag === "loading";
 	const registrationOptionsFailed = wizard.registrationOptionsState.tag === "failed";
-	const isSoldOutWithoutWaitlist = !hasWaitlistClaim && isFullWithNoWaitlist(currentEvent, wizard.selectedAttendanceMode);
+	const isSoldOutWithoutWaitlist = !wizard.checkoutRecovery && !hasWaitlistClaim && isFullWithNoWaitlist(currentEvent, wizard.selectedAttendanceMode);
 	const isCheckingExistingRegistration = wizard.portalAuthState === "authenticated" && wizard.existingRegistrationLoading;
 	const hasExistingRegistration = isExistingRegistrationBlocking$1(wizard);
 	const ticketTypeSelectionBlocked = wizard.ticketTypeSelectionRequired && !wizard.hasValidTicketSelection;
@@ -4032,6 +4253,31 @@ function resolveTicketSelectionPricing(event) {
 		currency: event ? publicEventPricingCurrency(event.pricing) : null
 	};
 }
+function CheckoutRecoveryEntry(props) {
+	return props.onContinue ? /* @__PURE__ */ jsx("button", {
+		type: "button",
+		className: "er-back-btn",
+		onClick: props.onContinue,
+		children: "Continue an existing booking"
+	}) : null;
+}
+function getTicketSelectionCapacity(event, attendanceMode, checkoutRecovery) {
+	if (checkoutRecovery) return {
+		availableSpots: null,
+		isSoldOut: false,
+		canJoinWaitlist: false,
+		eventAvailabilityLabel: null
+	};
+	const source = event ? selectEventCapacitySource(event, attendanceMode) : null;
+	const availability = source ? getEventAvailability(source) : null;
+	const canJoinWaitlist = source ? canJoinEventWaitlist(source) : false;
+	return {
+		availableSpots: availability?.available,
+		isSoldOut: availability?.isFull ?? false,
+		canJoinWaitlist,
+		eventAvailabilityLabel: !canJoinWaitlist && source ? formatRemainingPlaces(source) : null
+	};
+}
 /**
 * Ticket Selection Step
 *
@@ -4040,15 +4286,11 @@ function resolveTicketSelectionPricing(event) {
 *
 * Can use either a full PublicEvent or just occurrence context (when on event page).
 */
-const TicketSelectionStep = ({ event, occurrenceContext: _occurrenceContext, selectedAttendanceMode = null, onAttendanceModeChange, ticketsCount, maxTickets, visibleTicketTypes: visibleTicketTypesOverride, ticketSelections = [], onTicketSelectionsChange, slidingScale = null, selectedSlidingAmountInput = "", slidingScaleSelectionMessage = null, onSlidingAmountChange, onTicketsChange, bookingUnit = { kind: "ticket" } }) => {
+const TicketSelectionStep = ({ event, occurrenceContext: _occurrenceContext, selectedAttendanceMode = null, onAttendanceModeChange, ticketsCount, maxTickets, visibleTicketTypes: visibleTicketTypesOverride, ticketSelections = [], onTicketSelectionsChange, slidingScale = null, selectedSlidingAmountInput = "", slidingScaleSelectionMessage = null, onSlidingAmountChange, onTicketsChange, bookingUnit = { kind: "ticket" }, checkoutRecovery = false, onCheckoutRecovery }) => {
 	const unit = bookingUnit.kind;
 	const deliveryMode = event?.deliveryMode ?? "in_person";
 	const attendanceModes = event?.attendanceModes ?? [];
-	const capacitySource = event ? selectEventCapacitySource(event, selectedAttendanceMode) : null;
-	const availability = capacitySource ? getEventAvailability(capacitySource) : null;
-	const availableSpots = availability?.available;
-	const isSoldOut = availability?.isFull ?? false;
-	const canJoinWaitlist = capacitySource ? canJoinEventWaitlist(capacitySource) : false;
+	const { availableSpots, isSoldOut, canJoinWaitlist, eventAvailabilityLabel } = getTicketSelectionCapacity(event, selectedAttendanceMode, checkoutRecovery);
 	const { mode: eventPricingMode, currency: eventPricingCurrency } = resolveTicketSelectionPricing(event);
 	const usesTicketTypes = eventPricingMode === "tiered" && !canJoinWaitlist;
 	const visibleTicketTypes = usesTicketTypes ? visibleTicketTypesOverride ?? getVisibleTicketTypes({
@@ -4067,7 +4309,6 @@ const TicketSelectionStep = ({ event, occurrenceContext: _occurrenceContext, sel
 		selectedTicketTypeRemainingCapacity: implicitTicketType?.availability.remainingPlaces ?? null,
 		hasSelectedTicketType: implicitTicketType !== null
 	});
-	const eventAvailabilityLabel = !canJoinWaitlist && capacitySource ? formatRemainingPlaces(capacitySource) : null;
 	if (deliveryMode === "hybrid" && !selectedAttendanceMode) return /* @__PURE__ */ jsxs("div", {
 		className: "rb-reg-stack er-stack",
 		children: [
@@ -4088,13 +4329,17 @@ const TicketSelectionStep = ({ event, occurrenceContext: _occurrenceContext, sel
 	});
 	if (isSoldOut && !canJoinWaitlist) return /* @__PURE__ */ jsxs("div", {
 		className: "rb-reg-stack er-stack",
-		children: [/* @__PURE__ */ jsx("h3", {
-			className: "er-title",
-			children: "Sold out"
-		}), /* @__PURE__ */ jsx("p", {
-			className: "er-text er-text--muted",
-			children: "Sorry you missed out! This event is fully booked."
-		})]
+		children: [
+			/* @__PURE__ */ jsx("h3", {
+				className: "er-title",
+				children: "Sold out"
+			}),
+			/* @__PURE__ */ jsx("p", {
+				className: "er-text er-text--muted",
+				children: "Sorry you missed out! This event is fully booked."
+			}),
+			/* @__PURE__ */ jsx(CheckoutRecoveryEntry, { onContinue: onCheckoutRecovery })
+		]
 	});
 	if (!eventPricingCurrency) return /* @__PURE__ */ jsx("div", {
 		className: "rb-reg-stack er-stack",
@@ -4162,9 +4407,13 @@ const TicketSelectionStep = ({ event, occurrenceContext: _occurrenceContext, sel
 					})]
 				})
 			] }),
-			canJoinWaitlist && /* @__PURE__ */ jsx("p", {
+			canJoinWaitlist && /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx("p", {
 				className: "er-text er-text--muted",
 				children: "This event is currently full. Continue to join the waitlist if a place opens up."
+			}), /* @__PURE__ */ jsx(CheckoutRecoveryEntry, { onContinue: onCheckoutRecovery })] }),
+			checkoutRecovery && /* @__PURE__ */ jsx("p", {
+				className: "er-text er-text--muted",
+				children: "Enter the details from your earlier booking. We’ll check your checkout before continuing to payment."
 			})
 		]
 	});
@@ -5072,12 +5321,14 @@ function EventRegistrationWizardContent(props) {
 				onBookForSomeoneElse: wizard.handleBookForSomeoneElse
 			}), /* @__PURE__ */ jsx(TicketSelectionStep, {
 				event: wizard.selectedEvent,
+				checkoutRecovery: wizard.checkoutRecovery,
+				onCheckoutRecovery: canRecoverEventCheckout(wizard.selectedEvent) ? wizard.startCheckoutRecovery : void 0,
 				occurrenceContext: wizard.occurrenceContext,
 				selectedAttendanceMode: wizard.selectedAttendanceMode,
 				onAttendanceModeChange: wizard.setSelectedAttendanceMode,
 				ticketsCount: wizard.ticketsCount,
 				maxTickets: wizard.maxTicketsNum,
-				visibleTicketTypes: wizard.eligibility ? wizard.visibleTicketTypes : void 0,
+				visibleTicketTypes: wizard.visibleTicketTypes,
 				ticketSelections: wizard.selectedTicketLines,
 				onTicketSelectionsChange: wizard.setSelectedTicketLines,
 				slidingScale: wizard.selectedEventSlidingScale,
@@ -5096,66 +5347,6 @@ function EventRegistrationWizardContent(props) {
 	}
 }
 //#endregion
-//#region ../blocks/src/system/runtime/nodes/event-registration/StepIndicator.tsx
-/**
-* Step indicator component for the event registration wizard.
-* Thin wrapper around the shared StepIndicator: styled by the shared
-* registration-surface classes, with 'er'-prefixed classes kept in the
-* markup as the stable hook surface for per-site theme CSS.
-*/
-function StepIndicator(props) {
-	return /* @__PURE__ */ jsx(StepIndicator$1, {
-		...props,
-		classPrefix: "er",
-		emitSharedClasses: true
-	});
-}
-//#endregion
-//#region ../blocks/src/system/runtime/nodes/event-registration/ErrorStep.tsx
-/**
-* Error Step
-*
-* Displays an error message with a retry button when registration fails.
-*/
-const labels = {
-	none: "",
-	retry: "Try again",
-	places: "Choose places",
-	start: "Start again",
-	details: "Check my details",
-	"payment-options": "View payment options",
-	"payment-status": "Check payment status",
-	portal: "View my bookings",
-	event: "View event"
-};
-const ErrorStep = ({ message, onRetry, action = "retry", canJoinWaitlist = false }) => {
-	const offerWaitlist = action === "places" && canJoinWaitlist;
-	return /* @__PURE__ */ jsx(TerminalPanel, {
-		tone: "error",
-		className: "er-center",
-		titleClassName: "er-title--lg er-message",
-		icon: /* @__PURE__ */ jsx(StateIcon, {
-			variant: "error",
-			children: /* @__PURE__ */ jsx(CrossIcon, {})
-		}),
-		title: "We couldn’t complete your booking",
-		body: /* @__PURE__ */ jsx("p", {
-			className: "er-text--muted er-message",
-			children: offerWaitlist ? "Sorry, this event is now full. You can join the waiting list, and we’ll email you if a place becomes available." : message
-		}),
-		actions: action === "none" ? void 0 : action === "portal" || action === "payment-status" ? /* @__PURE__ */ jsx("a", {
-			href: "/portal",
-			className: "er-retry-btn",
-			children: labels[action]
-		}) : /* @__PURE__ */ jsx("button", {
-			type: "button",
-			onClick: onRetry,
-			className: "er-retry-btn",
-			children: offerWaitlist ? "Join the waiting list" : labels[action]
-		})
-	});
-};
-//#endregion
 //#region ../blocks/src/system/runtime/nodes/event-registration/PaymentFailedStep.tsx
 /**
 * Payment Failed Step
@@ -5186,6 +5377,21 @@ const PaymentFailedStep = ({ onRetry }) => {
 	});
 };
 //#endregion
+//#region ../blocks/src/system/runtime/nodes/event-registration/StepIndicator.tsx
+/**
+* Step indicator component for the event registration wizard.
+* Thin wrapper around the shared StepIndicator: styled by the shared
+* registration-surface classes, with 'er'-prefixed classes kept in the
+* markup as the stable hook surface for per-site theme CSS.
+*/
+function StepIndicator(props) {
+	return /* @__PURE__ */ jsx(StepIndicator$1, {
+		...props,
+		classPrefix: "er",
+		emitSharedClasses: true
+	});
+}
+//#endregion
 //#region ../blocks/src/system/runtime/nodes/event-registration/SuccessStep.tsx
 /**
 * Success Step
@@ -5458,7 +5664,8 @@ function EventRegistrationSurface(props) {
 		}), /* @__PURE__ */ jsx(EventRegistrationTerminalState, {
 			wizard,
 			supportEmail: props.supportEmail,
-			successMessage: props.successMessage
+			successMessage: props.successMessage,
+			buttonClass: props.buttonClass
 		})]
 	});
 }
@@ -5856,6 +6063,84 @@ function RegistrationClosedState({ title, body }) {
 	});
 }
 //#endregion
+//#region ../blocks/src/system/runtime/nodes/event-registration/useEventSourceRecovery.ts
+const RECOVERY_DELAYS_MS = [
+	0,
+	250,
+	750
+];
+const defaultRecoveryDeps = {
+	useApi: useBlockApi,
+	wait: waitForRetry
+};
+function useEventSourceRecovery(source, deps = defaultRecoveryDeps) {
+	const api = deps.useApi();
+	const wait = deps.wait;
+	const [cycle, setCycle] = useState(0);
+	const [state, setState] = useState(() => source.kind === "loaded" ? {
+		kind: "ready",
+		events: source.events
+	} : { kind: "loading" });
+	const retry = useCallback(() => {
+		setState({ kind: "loading" });
+		setCycle((value) => value + 1);
+	}, []);
+	useEffect(() => {
+		if (source.kind === "loaded") {
+			setState({
+				kind: "ready",
+				events: source.events
+			});
+			return;
+		}
+		if (!source.request) {
+			setState({
+				kind: "exhausted",
+				retry
+			});
+			return;
+		}
+		const controller = new AbortController();
+		const isCurrent = () => !controller.signal.aborted;
+		(async () => {
+			for (const delayMs of RECOVERY_DELAYS_MS) try {
+				await wait(delayMs, controller.signal);
+				const events = await api.getPublicEvents(source.request ?? void 0);
+				if (isCurrent()) setState({
+					kind: "ready",
+					events
+				});
+				return;
+			} catch {
+				if (!isCurrent()) return;
+			}
+			if (isCurrent()) setState({
+				kind: "exhausted",
+				retry
+			});
+		})();
+		return () => controller.abort();
+	}, [
+		api,
+		cycle,
+		retry,
+		source,
+		wait
+	]);
+	return state;
+}
+function waitForRetry(milliseconds, signal) {
+	if (signal.aborted) return Promise.reject(/* @__PURE__ */ new Error("Recovery aborted"));
+	if (milliseconds === 0) return Promise.resolve();
+	return new Promise((resolve, reject) => {
+		const timeout = setTimeout(resolve, milliseconds);
+		signal.addEventListener("abort", () => {
+			clearTimeout(timeout);
+			reject(/* @__PURE__ */ new Error("Recovery aborted"));
+		}, { once: true });
+	});
+}
+//#endregion
 //#region ../blocks/src/system/runtime/nodes/event-registration.client.tsx
 function toEventRegistrationClientProps(props, display) {
 	return {
@@ -5889,8 +6174,71 @@ const EventRegistrationIslandClient = (props) => {
 		title: props.render.display.titleText,
 		body: props.render.display.bodyText
 	});
-	return /* @__PURE__ */ jsx(EventRegistrationClient, { ...toEventRegistrationClientProps(props, props.render.display) });
+	return /* @__PURE__ */ jsx(RecoverableEventRegistrationClient, {
+		props,
+		display: props.render.display
+	});
 };
+function RecoverableEventRegistrationClient({ props, display }) {
+	const recovery = useEventSourceRecovery(props.render.hydration.eventSource);
+	if (recovery.kind === "loading") return /* @__PURE__ */ jsxs("div", {
+		id: EVENT_REGISTRATION_ANCHOR_ID,
+		className: "rb-reg-surface er-container er-registration-shell",
+		"aria-busy": "true",
+		role: "status",
+		children: [
+			/* @__PURE__ */ jsx("p", {
+				className: "er-registration-shell__eyebrow",
+				children: "Registration"
+			}),
+			/* @__PURE__ */ jsx("h3", {
+				className: "er-title er-registration-shell__title",
+				children: display.titleText
+			}),
+			/* @__PURE__ */ jsx("p", {
+				className: "er-text er-text--muted",
+				children: "Loading event dates…"
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: "er-event-grid er-registration-shell__cards",
+				"aria-hidden": "true",
+				children: [/* @__PURE__ */ jsx("div", { className: "er-event-card er-registration-shell__card" }), /* @__PURE__ */ jsx("div", { className: "er-event-card er-registration-shell__card" })]
+			})
+		]
+	});
+	if (recovery.kind === "exhausted") return /* @__PURE__ */ jsxs("div", {
+		id: EVENT_REGISTRATION_ANCHOR_ID,
+		className: "rb-reg-surface er-container er-registration-shell",
+		role: "alert",
+		children: [/* @__PURE__ */ jsx("p", { children: "We couldn’t load the event dates. Please try again." }), /* @__PURE__ */ jsx("button", {
+			type: "button",
+			className: themeButtonClassName({
+				variant: props.render.hydration.buttonVariant ?? "primary",
+				size: "md"
+			}),
+			onClick: recovery.retry,
+			children: "Try again"
+		})]
+	});
+	const events = resolveEventRegistrationScopedEvents(recovery.events, {
+		occurrenceContext: props.render.hydration.occurrenceContext,
+		subject: props.render.hydration.subject
+	});
+	const recoveredDisplay = buildEventRegistrationDisplayFromScopedEvents({
+		...props.render.hydration,
+		events,
+		className: display.className,
+		buttonText: display.summaryButtonText
+	}, events);
+	if (recoveredDisplay.state === "registration-closed") return /* @__PURE__ */ jsx(RegistrationClosedState, {
+		title: recoveredDisplay.titleText,
+		body: recoveredDisplay.bodyText
+	});
+	return /* @__PURE__ */ jsx(EventRegistrationClient, {
+		...toEventRegistrationClientProps(props, display),
+		events
+	});
+}
 //#endregion
 //#region src/rendering/islands/enhancers/eventRegistration.tsx
 const decode = defineIslandPropsDecoder("event-registration");