@riverbankcms/sdk 0.136.0 → 0.137.0

package/dist/client/{eventRegistration-D-j8eNy2.mjs → eventRegistration-bPQo3kVw.mjs}

@@ -1,10 +1,11 @@
 "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-DCch21a6.mjs";
-import { $t as publicEventScalarPrice, At as assertNever, Bt as formatBookingDateTime, C as getStepNumber, Ht as formatBookingTime, Jt as toBookingTimeZone, O as resolveEventRegistrationScopedEvents, Qt as publicEventPricingType, S as WIZARD_STEPS, T as planEventRegistrationSurface, V as formatEventPriceDisplay, Xt as publicEventPricingCurrency, Y as resolveRuntimeEventPricing, Yt as toScheduledBookingDateTime, Zt as publicEventPricingMode, _ as findEventByOccurrenceId, b as resolveEventRequiresPayment, en as publicEventTicketTypes, g as toWholeSeriesRegistrationEvents, h as toRegistrationEvents, st as themeButtonClassName, t as defineIslandPropsDecoder, tn as formatCurrencyAmount, v as findPreSelectedEvent, w as getWizardStepsForContext, x as resolveRegistrationTarget, y as resolveDiscountContext, zt as formatBookingDate } from "./propsDecoder-pzBeCh14.mjs";
-import { n as useBlockApi, t as BlockApiProvider } from "./context-BImarOAq.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--_fUCZe-.mjs";
+import { At as formatBookingDateTime, B as formatEventPriceDisplay, Bt as toScheduledBookingDateTime, C as getStepNumber, Gt as publicEventTicketTypes, Ht as publicEventPricingMode, Kt as formatCurrencyAmount, Mt as formatBookingTime, O as resolveEventRegistrationScopedEvents, Ot as formatBookingDate, Rt as toBookingTimeZone, S as WIZARD_STEPS, T as planEventRegistrationSurface, Ut as publicEventPricingType, V as resolveRuntimeEventPricing, Vt as publicEventPricingCurrency, Wt as publicEventScalarPrice, X as themeButtonClassName, _ as findEventByOccurrenceId, b as resolveEventRequiresPayment, g as toWholeSeriesRegistrationEvents, h as toRegistrationEvents, t as defineIslandPropsDecoder, v as findPreSelectedEvent, w as getWizardStepsForContext, x as resolveRegistrationTarget, y as resolveDiscountContext, yt as assertNever } from "./propsDecoder-pYvx_Srl.mjs";
+import { a as formatTicketTypeRemaining, d as selectEventCapacitySource, f as selectMostOpenCapacitySource, i as formatRemainingPlaces, l as getRemainingPlaces, n as canJoinEventWaitlistOnAnyMode, r as formatEventRemainingPlaces, s as getEventAvailability, t as canJoinEventWaitlist, u as isEventFull } from "./capacity-BW00PO7s.mjs";
+import { n as useBlockApi, r as BlockApiError, t as BlockApiProvider } from "./context-DCkiHVdD.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-CduAKf8T.mjs";
-import { t as DiscountCodeDisclosure } from "./DiscountCodeDisclosure-DIj1T59K.mjs";
+import { a as CheckIcon, i as StateIcon, n as useDiscountCodeUi, r as TerminalPanel, t as scrollToBlock } from "./scrollToBlock-ByQv96M2.mjs";
+import { t as DiscountCodeDisclosure } from "./DiscountCodeDisclosure-BMipSoDJ.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";
@@ -713,10 +714,12 @@ const EventSelectionStep = ({ events, selectedEvent, onSelect, showVenue, showCa
 			className: "er-event-grid",
 			children: events.map((event) => {
 				const isSelected = selectedEvent?.selectionId === event.selectionId;
-				const isSoldOut = event.capacity !== null && event.availableSpots === 0;
-				const canJoinWaitlist = isSoldOut && event.waitlistEnabled === true;
+				const remaining = getRemainingPlaces(selectMostOpenCapacitySource(event));
+				const isSoldOut = isEventFull(event);
+				const canJoinWaitlist = canJoinEventWaitlistOnAnyMode(event);
 				const isUnavailable = isSoldOut && !canJoinWaitlist;
-				const isLowCapacity = event.availableSpots !== null && event.availableSpots <= 5 && !isSoldOut;
+				const isLowCapacity = remaining.kind === "low";
+				const capacityLabel = formatEventRemainingPlaces(event, { full: "Sold out" });
 				const timeZone = event.timeZone ?? null;
 				const cardClasses = [
 					"er-event-card",
@@ -748,9 +751,9 @@ const EventSelectionStep = ({ events, selectedEvent, onSelect, showVenue, showCa
 									children: " · "
 								}), event.venue.name] })]
 							})]
-						}), showCapacity && event.capacity !== null && /* @__PURE__ */ jsx("span", {
+						}), showCapacity && capacityLabel && /* @__PURE__ */ jsx("span", {
 							className: badgeClasses,
-							children: canJoinWaitlist ? "Waitlist" : isUnavailable ? "Sold Out" : `${event.availableSpots ?? 0} spots left`
+							children: capacityLabel
 						})]
 					})
 				}, event.selectionId);
@@ -759,6 +762,61 @@ const EventSelectionStep = ({ events, selectedEvent, onSelect, showVenue, showCa
 	});
 };
 //#endregion
+//#region ../blocks/src/system/runtime/nodes/event-registration/registrationErrorRecovery.ts
+function resolveRegistrationRecoveryAction(step, action) {
+	if (step === "payment-failed") return "payment-options";
+	if (step === "verifying-payment" || step === "verifying-timeout" || step === "redirecting") return "payment-status";
+	return action;
+}
+function canRecoverToWaitlist(eligibility) {
+	return Boolean(eligibility?.isFull && eligibility.canJoinWaitlist);
+}
+function shouldRefreshAfterRegistrationError(step, action, enabled) {
+	return enabled || step === "error" && action === "places";
+}
+function resetRegistrationAfterExpiry(input) {
+	input.dispatchFlow({
+		type: "reset",
+		hasPreSelectedContext: input.hasPreSelectedContext
+	});
+	input.setSelectedTicketLines([]);
+	input.setSelectedSlidingAmountInput("");
+	const mode = input.preSelectedEvent?.deliveryMode;
+	input.setSelectedAttendanceMode(mode === "online" || mode === "in_person" ? mode : null);
+	input.setErrorMessage("");
+	input.setPendingRegistrationReference(null);
+}
+/** Recovery never starts another payment. Unknown payment outcomes go to the portal. */
+function recoverRegistrationError(action, handlers) {
+	switch (action) {
+		case "none": return;
+		case "portal":
+		case "payment-status":
+			window.location.assign("/portal");
+			return;
+		case "event":
+			window.location.assign(window.location.pathname);
+			return;
+		case "retry":
+			window.location.reload();
+			return;
+		case "details":
+			handlers.clearError();
+			handlers.setStep("enter-details");
+			return;
+		case "payment-options":
+		case "places":
+			handlers.refreshOptions();
+			handlers.clearError();
+			handlers.setStep(action === "places" ? handlers.canJoinWaitlist ? "enter-details" : "select-tickets" : "select-payment");
+			return;
+		case "start":
+			handlers.refreshOptions();
+			handlers.reset();
+			return;
+	}
+}
+//#endregion
 //#region ../blocks/src/system/runtime/nodes/event-registration/validation.ts
 function createInitialRegistrationFormData() {
 	return {
@@ -1002,11 +1060,11 @@ function useEligibilityWithDeps(params, deps) {
 					type: "resolved",
 					eligibility: transformRegistrationOptionsResponse(result)
 				});
-			} catch (err) {
+			} catch {
 				if (cancelled || requestIdRef.current !== requestId) return;
 				dispatch({
 					type: "failed",
-					message: err instanceof Error ? err.message : "Failed to check eligibility"
+					message: "We couldn’t load the booking options for this event. Please refresh this page and try again. If this keeps happening, contact the organiser for help."
 				});
 			}
 		}
@@ -1018,6 +1076,7 @@ function useEligibilityWithDeps(params, deps) {
 	}, [
 		api,
 		params.enabled,
+		params.refreshKey,
 		params.subject?.kind,
 		params.subject?.kind === "occurrence" ? params.subject.occurrenceId : params.subject?.eventSeriesId,
 		params.attendanceMode,
@@ -1127,8 +1186,252 @@ function logoutPortal(anchorId) {
 	form.submit();
 }
 //#endregion
+//#region ../commerce/src/purchase/checkoutPaymentFlow.ts
+function planCheckoutPaymentFlow(options) {
+	const amountDueCents = toNonNegativeCents(options.amountDueCents);
+	const discountCents = toNonNegativeCents(options.discountCents);
+	const availableCreditCents = toNonNegativeCents(options.availableCreditCents);
+	const minimumStripeChargeCents = toNonNegativeCents(options.minimumStripeChargeCents ?? 0);
+	if (amountDueCents <= 0) return {
+		kind: "bypass",
+		bypassReason: discountCents > 0 ? "discount_free" : "free",
+		reserveCreditCents: 0
+	};
+	if (!options.creditCurrencyMatches || availableCreditCents <= 0) return {
+		kind: "stripe",
+		reserveCreditCents: toNonNegativeCents(0)
+	};
+	if (availableCreditCents >= amountDueCents) return {
+		kind: "store_credit_only",
+		reserveCreditCents: amountDueCents
+	};
+	return {
+		kind: "stripe",
+		reserveCreditCents: planMixedPaymentCreditReservation({
+			amountDueCents,
+			availableCreditCents,
+			minimumStripeChargeCents
+		})
+	};
+}
+function planMixedPaymentCreditReservation(input) {
+	const chargeAfterFullCredit = input.amountDueCents - input.availableCreditCents;
+	if (input.minimumStripeChargeCents <= 0 || chargeAfterFullCredit <= 0 || chargeAfterFullCredit >= input.minimumStripeChargeCents) return input.availableCreditCents;
+	if (input.amountDueCents < input.minimumStripeChargeCents) return toNonNegativeCents(0);
+	return toNonNegativeCents(input.amountDueCents - input.minimumStripeChargeCents);
+}
+/**
+* Apply site credit to a flexible-balance booking before card payment.
+*
+* Credit first reduces the configured payment due now. Once that payment is
+* covered, any remaining credit reduces the later balance. If a partial credit
+* application would leave a positive card charge below Stripe's minimum, less
+* credit is used so the configured payment can still be collected.
+*/
+function planFlexibleBalanceCreditFirst(input) {
+	const totalCents = toNonNegativeCents(input.totalAfterDiscountCents);
+	const configuredDueNowCents = toNonNegativeCents(Math.min(input.configuredPaymentDueNowCents, totalCents));
+	const availableCreditCents = toNonNegativeCents(input.creditCurrencyMatches ? input.availableCreditCents : 0);
+	const minimumStripeChargeCents = toNonNegativeCents(input.minimumStripeChargeCents ?? 0);
+	if (availableCreditCents >= totalCents && totalCents > 0) return {
+		kind: "credit_only",
+		reserveCreditCents: totalCents,
+		cardDueNowCents: toNonNegativeCents(0),
+		laterBalanceCents: toNonNegativeCents(0)
+	};
+	let reserveCreditCents = toNonNegativeCents(Math.min(availableCreditCents, totalCents));
+	if (reserveCreditCents >= configuredDueNowCents) return {
+		kind: "flexible_balance",
+		reserveCreditCents,
+		cardDueNowCents: toNonNegativeCents(0),
+		laterBalanceCents: toNonNegativeCents(totalCents - reserveCreditCents)
+	};
+	const plannedCardDueNowCents = toNonNegativeCents(configuredDueNowCents - reserveCreditCents);
+	if (plannedCardDueNowCents > 0 && plannedCardDueNowCents < minimumStripeChargeCents) {
+		if (configuredDueNowCents < minimumStripeChargeCents) return {
+			kind: "card_below_minimum",
+			reserveCreditCents: toNonNegativeCents(0),
+			cardDueNowCents: configuredDueNowCents,
+			laterBalanceCents: toNonNegativeCents(totalCents - configuredDueNowCents)
+		};
+		reserveCreditCents = toNonNegativeCents(configuredDueNowCents - minimumStripeChargeCents);
+	}
+	const cardDueNowCents = toNonNegativeCents(configuredDueNowCents - reserveCreditCents);
+	return {
+		kind: "flexible_balance",
+		reserveCreditCents,
+		cardDueNowCents,
+		laterBalanceCents: toNonNegativeCents(totalCents - reserveCreditCents - cardDueNowCents)
+	};
+}
+//#endregion
+//#region ../commerce/src/purchase/settlement.ts
+function normalizeCurrencyCode(raw) {
+	const normalized = raw.trim().toUpperCase();
+	if (!/^[A-Z]{3}$/.test(normalized)) throw new Error(`Invalid currency code: ${raw}`);
+	return normalized;
+}
+//#endregion
+//#region ../commerce/src/purchase/checkoutSessionMetadata.ts
+const datedOfferingSharedEngineMetadataShape = {
+	datedOfferingEngineContractVersion: z.literal("shared_v1"),
+	datedOfferingEngineRouteKind: z.literal("shared_whole_series_registration"),
+	datedOfferingCapacityHoldId: z.string().uuid(),
+	datedOfferingCapacityHoldAuditRef: z.string().uuid(),
+	customerId: z.string().uuid(),
+	eventSeriesId: z.string().uuid()
+};
+z.object(datedOfferingSharedEngineMetadataShape);
+const orderCheckoutSessionMetadataBaseShape = {
+	type: z.literal("order"),
+	site_id: z.string().uuid(),
+	order_id: z.string().uuid().optional(),
+	customer_email: z.string().email(),
+	customer_name: z.string().optional(),
+	product_id: z.string().uuid().optional(),
+	attendee_id: z.string().uuid().optional(),
+	occurrence_id: z.string().uuid().optional(),
+	tickets_count: z.string().optional(),
+	notes: z.string().optional(),
+	discount_redemption_id: z.string().uuid().optional(),
+	discount_code_id: z.string().uuid().optional(),
+	discount_code: z.string().optional(),
+	discount_public_label: z.string().optional(),
+	credit_reservation_id: z.string().uuid().optional(),
+	credit_reserved_cents: z.string().optional(),
+	discount_code_amount_cents: z.string().optional(),
+	order_payment_reason: z.enum([
+		"instalment_payoff",
+		"flexible_balance_initial",
+		"flexible_balance_paydown"
+	]).optional(),
+	order_payment_plan_id: z.string().uuid().optional(),
+	order_flexible_balance_contract_id: z.string().uuid().optional()
+};
+const absentDatedOfferingSharedEngineMetadataShape = {
+	datedOfferingEngineContractVersion: z.never().optional(),
+	datedOfferingEngineRouteKind: z.never().optional(),
+	datedOfferingCapacityHoldId: z.never().optional(),
+	datedOfferingCapacityHoldAuditRef: z.never().optional(),
+	customerId: z.never().optional(),
+	eventSeriesId: z.never().optional()
+};
+const LegacyOrderCheckoutSessionMetadataSchema = z.object({
+	...orderCheckoutSessionMetadataBaseShape,
+	...absentDatedOfferingSharedEngineMetadataShape
+});
+const SharedDatedOfferingOrderCheckoutSessionMetadataSchema = z.object({
+	...orderCheckoutSessionMetadataBaseShape,
+	...datedOfferingSharedEngineMetadataShape
+});
+z.union([SharedDatedOfferingOrderCheckoutSessionMetadataSchema, LegacyOrderCheckoutSessionMetadataSchema]);
+toNonNegativeCents(0);
+//#endregion
+//#region ../commerce/src/purchase/stripeMinimumCharge.ts
+const STRIPE_MINIMUM_CHARGE_CENTS_BY_CURRENCY = {
+	GBP: 30,
+	USD: 50,
+	EUR: 50,
+	AED: 200,
+	AUD: 50,
+	BGN: 100,
+	BRL: 50,
+	CAD: 50,
+	CHF: 50,
+	CZK: 1500,
+	DKK: 250,
+	HKD: 400,
+	HUF: 17500,
+	JPY: 50,
+	MXN: 1e3,
+	MYR: 200,
+	NOK: 300,
+	NZD: 50,
+	PLN: 200,
+	RON: 200,
+	SEK: 300,
+	SGD: 50,
+	THB: 1e3
+};
+function isStripeMinimumChargeCurrency(currency) {
+	return currency in STRIPE_MINIMUM_CHARGE_CENTS_BY_CURRENCY;
+}
+function getStripeMinimumChargeRequirement(rawCurrency) {
+	let currency;
+	try {
+		currency = normalizeCurrencyCode(rawCurrency);
+	} catch {
+		return null;
+	}
+	const currencyKey = currency;
+	if (!isStripeMinimumChargeCurrency(currencyKey)) return null;
+	return {
+		currency,
+		minimumAmountCents: STRIPE_MINIMUM_CHARGE_CENTS_BY_CURRENCY[currencyKey]
+	};
+}
+//#endregion
+//#region ../commerce/src/purchase/event-registration-errors.ts
+const eventRegistrationErrors = {
+	registrationClosed: {
+		message: "Booking is currently closed for this event. Please contact the organiser if you’d like to find out more.",
+		action: "none"
+	},
+	paymentUncertain: {
+		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"
+	},
+	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"
+	},
+	paymentUnavailable: {
+		message: "Online payment is not available for this event right now. Please contact the organiser for help with booking.",
+		action: "none"
+	},
+	capacityChanged: {
+		message: "Sorry, there aren’t enough places left for your selection. Please check the available places and choose again.",
+		action: "places"
+	},
+	selectionChanged: {
+		message: "The booking options for this event have changed. Please check the latest options and choose your places again.",
+		action: "places"
+	},
+	registrationPreparationChanged: {
+		message: "The booking options for this event have changed. Please check the latest options and choose your places again.",
+		action: "places"
+	},
+	registrationAlreadyExists: {
+		message: "You already have a booking for this event. Please check your bookings to see its status. If you need help, contact the organiser.",
+		action: "portal"
+	},
+	holdExpired: {
+		message: "Your reservation has timed out. Please check availability and choose your places again.",
+		action: "start"
+	},
+	waitlistUnavailable: {
+		message: "Sorry, the waiting list place offered in this invitation is no longer available. Please check the event for available places or contact the organiser for help.",
+		action: "event"
+	},
+	paymentContextMismatch: {
+		message: "The payment options for this event have changed. Please check the latest options before continuing.",
+		action: "payment-options"
+	},
+	idempotencyConflict: {
+		message: "You’ve already started booking this event. Please finish in the other tab if it’s still open, or check your booking status before starting again.",
+		action: "portal"
+	},
+	invalidCommitInput: {
+		message: "We couldn’t accept your booking details. Please check the information you entered and try again. If this keeps happening, contact the organiser for help.",
+		action: "details"
+	}
+};
+function parseEventRegistrationErrorReason(value) {
+	return typeof value === "string" && Object.prototype.hasOwnProperty.call(eventRegistrationErrors, value) ? value : null;
+}
+//#endregion
 //#region ../blocks/src/system/runtime/shared/useWaitlistClaim.state.ts
-const DEFAULT_WAITLIST_CLAIM_ERROR = "Failed to resolve waitlist claim";
+const DEFAULT_WAITLIST_CLAIM_ERROR = "Online booking is unavailable right now. Please contact the organiser for help with booking.";
 function createInitialWaitlistClaimState(hasToken) {
 	return hasToken ? { kind: "resolving" } : { kind: "idle" };
 }
@@ -1144,14 +1447,13 @@ function waitlistClaimReducer(_state, action) {
 	}
 }
 function toWaitlistClaimResolveFailure(error) {
-	const message = error instanceof Error ? error.message : DEFAULT_WAITLIST_CLAIM_ERROR;
 	if (isUnauthorizedBlockApiError(error)) return {
 		kind: "portal-login-required",
-		message
+		message: "Please log in to continue with your waiting list invitation."
 	};
 	return {
 		kind: "error",
-		message
+		message: hasStatus(error) && (error.status === 404 || error.status === 409 || error.status === 410) ? eventRegistrationErrors.waitlistUnavailable.message : DEFAULT_WAITLIST_CLAIM_ERROR
 	};
 }
 function isUnauthorizedBlockApiError(error) {
@@ -1512,11 +1814,21 @@ function cleanupStaleRegistrations() {
 //#region ../blocks/src/system/runtime/nodes/event-registration/useEventRegistrationStripeReturn.ts
 const eventRegistrationStripeReturnDeps = {
 	usePaymentVerification,
-	consumeReturnParams: () => consumeSearchParams([
-		"registration",
-		EVENT_REGISTRATION_CHECKOUT_ATTEMPT_PARAM,
-		"session_id"
-	]),
+	readReturnParams: () => {
+		const params = new URLSearchParams(window.location.search);
+		return {
+			registration: params.get("registration"),
+			registration_attempt: params.get(EVENT_REGISTRATION_CHECKOUT_ATTEMPT_PARAM),
+			session_id: params.get("session_id")
+		};
+	},
+	clearReturnParams: () => {
+		consumeSearchParams([
+			"registration",
+			EVENT_REGISTRATION_CHECKOUT_ATTEMPT_PARAM,
+			"session_id"
+		]);
+	},
 	scrollToBlock,
 	cleanupStaleRegistrations,
 	clearPendingRegistration,
@@ -1537,52 +1849,66 @@ function showReturnReconciliation(options, message) {
 	options.setErrorMessage(message);
 	options.setStep("verifying-timeout");
 }
+function checkoutReturnCommand(params) {
+	const checkoutAttemptId = params.registration_attempt;
+	if (!checkoutAttemptId) return null;
+	if (params.registration === "cancelled") return {
+		kind: "abandon",
+		checkoutAttemptId
+	};
+	if (params.registration === "success" && params.session_id) return {
+		kind: "resolveSuccess",
+		checkoutAttemptId,
+		sessionId: params.session_id
+	};
+	return null;
+}
 async function handleCheckoutReturn(options, deps, checkoutAttemptIdRef) {
 	deps.cleanupStaleRegistrations();
-	const params = deps.consumeReturnParams();
-	if (params.registration !== "cancelled" && params.registration !== "success") return;
+	const params = deps.readReturnParams();
+	if (params.registration !== "cancelled" && params.registration !== "success") return "settled";
 	deps.scrollToBlock(EVENT_REGISTRATION_ANCHOR_ID);
 	const siteId = options.api.config.siteId;
-	const checkoutAttemptId = params.registration_attempt;
-	if (!siteId) return;
-	if (!checkoutAttemptId) {
-		showReturnReconciliation(options, "We could not identify this payment attempt. Please contact us before trying again.");
-		return;
+	const command = checkoutReturnCommand(params);
+	if (!siteId) return "settled";
+	if (!command) {
+		showReturnReconciliation(options, "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.");
+		return "settled";
 	}
+	const { checkoutAttemptId } = command;
 	const pending = deps.getPendingRegistration(siteId, checkoutAttemptId);
 	checkoutAttemptIdRef.current = checkoutAttemptId;
 	if (pending) restorePendingPresentation(options, pending);
+	options.setStep("verifying-payment");
 	try {
-		const outcome = params.registration === "success" ? params.session_id ? await options.api.resolveEventCheckoutReturn({
-			kind: "resolveSuccess",
-			checkoutAttemptId,
-			sessionId: params.session_id
-		}) : { kind: "notFound" } : await options.api.resolveEventCheckoutReturn({
-			kind: "abandon",
-			checkoutAttemptId
-		});
+		const outcome = await options.api.resolveEventCheckoutReturn(command);
 		switch (outcome.kind) {
 			case "resolved":
+				deps.clearReturnParams();
 				options.setPendingRegistrationReference(outcome.reference);
 				options.setStep("verifying-payment");
-				return;
+				return "settled";
 			case "abandoned":
+				deps.clearReturnParams();
 				options.setErrorMessage("Your payment was cancelled. You can choose a payment option and try again.");
 				options.setStep("select-payment");
-				return;
+				return "settled";
 			case "notFound":
 				if (params.registration === "cancelled" && (options.registrationSubject?.kind === "occurrence" || pending?.reference.scope === "occurrence")) {
+					deps.clearReturnParams();
 					options.setErrorMessage("Your payment was cancelled. You can choose a payment option and try again.");
 					options.setStep("select-payment");
-					return;
+					return "settled";
 				}
-				break;
+				showReturnReconciliation(options, "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.");
+				return "settled";
 			case "reconciliationRequired": break;
 		}
-		showReturnReconciliation(options, "We’re checking your payment. Please wait a moment before trying again.");
+		showReturnReconciliation(options, "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.");
 	} catch {
-		showReturnReconciliation(options, "We could not check your payment yet. Please try again shortly.");
+		showReturnReconciliation(options, "We couldn’t check your payment just now. Please check again in a moment. Don’t make another booking while we’re checking.");
 	}
+	return "retryable";
 }
 function useEventRegistrationStripeReturn(options) {
 	return useEventRegistrationStripeReturnWithDeps(options, eventRegistrationStripeReturnDeps);
@@ -1590,10 +1916,34 @@ function useEventRegistrationStripeReturn(options) {
 function useEventRegistrationStripeReturnWithDeps(options, deps) {
 	const { api, pendingRegistrationReference, setErrorMessage, setRegistrationResult, setStep, step } = options;
 	const checkoutAttemptIdRef = useRef(null);
+	const lookupInFlightRef = useRef(false);
+	const [lookupState, setLookupState] = useState("settled");
+	const resolveReturn = useCallback(async () => {
+		if (lookupInFlightRef.current) return;
+		lookupInFlightRef.current = true;
+		setLookupState("loading");
+		try {
+			setLookupState(await handleCheckoutReturn(options, deps, checkoutAttemptIdRef));
+		} finally {
+			lookupInFlightRef.current = false;
+		}
+	}, [options, deps]);
 	const verificationConfig = useMemo(() => step === "verifying-payment" && pendingRegistrationReference ? { reference: pendingRegistrationReference } : null, [step, pendingRegistrationReference]);
 	const verification = deps.usePaymentVerification(verificationConfig);
+	const hasVerificationTimeout = step === "verifying-timeout" && pendingRegistrationReference !== null;
+	const retry = useCallback(() => {
+		if (hasVerificationTimeout) {
+			setStep("verifying-payment");
+			return;
+		}
+		verification.retry();
+	}, [
+		hasVerificationTimeout,
+		setStep,
+		verification.retry
+	]);
 	useEffect(() => {
-		handleCheckoutReturn(options, deps, checkoutAttemptIdRef);
+		resolveReturn();
 	}, []);
 	useEffect(() => {
 		if (verification.status === "completed") {
@@ -1603,7 +1953,7 @@ function useEventRegistrationStripeReturnWithDeps(options, deps) {
 			setRegistrationResult({ status: "confirmed" });
 			setStep("success");
 		} else if (verification.status === "failed") {
-			setErrorMessage(verification.error ?? "Payment failed. Please try again.");
+			setErrorMessage("Please try again or choose another payment option. If this keeps happening, contact the organiser for help.");
 			setStep("payment-failed");
 		} else if (verification.status === "timeout") setStep("verifying-timeout");
 	}, [
@@ -1616,7 +1966,22 @@ function useEventRegistrationStripeReturnWithDeps(options, deps) {
 		setRegistrationResult,
 		setStep
 	]);
-	return verification;
+	return {
+		...verification,
+		status: hasVerificationTimeout ? "timeout" : verification.status,
+		retry,
+		retryReturn: lookupState === "retryable" ? () => {
+			resolveReturn();
+		} : void 0
+	};
+}
+//#endregion
+//#region ../blocks/src/system/runtime/nodes/event-registration/registrationErrorPresentation.ts
+function registrationErrorPresentation(error) {
+	const reason = error instanceof BlockApiError ? parseEventRegistrationErrorReason(error.tag) : null;
+	if (reason) return eventRegistrationErrors[reason];
+	if (error instanceof BlockApiError && error.status < 500) return eventRegistrationErrors.invalidCommitInput;
+	return eventRegistrationErrors.paymentUncertain;
 }
 //#endregion
 //#region ../blocks/src/system/runtime/nodes/event-registration/useEventRegistrationSubmit.ts
@@ -1705,7 +2070,8 @@ function useEventRegistrationSubmitWithDeps(options, deps) {
 				outcome: { kind: "completed" }
 			};
 		} catch (error) {
-			const message = error instanceof Error ? error.message : "Registration failed";
+			const { message, action } = registrationErrorPresentation(error);
+			options.setErrorAction?.(action);
 			options.setErrorMessage(message);
 			options.setStep("error");
 			return {
@@ -1870,6 +2236,13 @@ function redirectToCheckout(checkoutUrl, submitOptions) {
 }
 //#endregion
 //#region ../blocks/src/system/runtime/nodes/event-registration/registrationWizardContext.ts
+function getEventSelectionDefaults(event) {
+	const suggestedAmount = getSlidingScaleForEvent(event)?.suggestedAmount;
+	return {
+		slidingAmountInput: suggestedAmount == null ? "" : formatCentsAsCurrencyInput(suggestedAmount),
+		attendanceMode: event.deliveryMode === "hybrid" ? null : event.deliveryMode ?? "in_person"
+	};
+}
 function parseCurrencyInputToCents(value) {
 	const trimmed = value.trim();
 	if (!trimmed) return null;
@@ -1917,7 +2290,7 @@ function resolveWaitlistClaimRestoration(input) {
 		const event = findEventByOccurrenceId(input.scopedEvents, subject.occurrenceId);
 		if (!event && input.occurrenceContextId !== subject.occurrenceId) return {
 			ok: false,
-			message: "This waitlist claim is for a different event."
+			message: "This waiting list invitation is for a different event. Please open the link in your invitation email."
 		};
 		return {
 			ok: true,
@@ -1934,7 +2307,7 @@ function resolveWaitlistClaimRestoration(input) {
 	const event = input.scopedEvents.find((candidate) => candidate.registrationSubject.kind === "wholeSeries" && candidate.registrationSubject.eventSeriesId === subject.eventSeriesId);
 	if (!event) return {
 		ok: false,
-		message: "This waitlist claim is for a different event run."
+		message: "This waiting list invitation is for a different event. Please open the link in your invitation email."
 	};
 	return {
 		ok: true,
@@ -1967,6 +2340,7 @@ function useWaitlistClaimRestoration(input) {
 			occurrenceContextId: input.occurrenceContextId
 		});
 		if (!restoration.ok) {
+			input.setters.setErrorAction?.("none");
 			input.setters.setErrorMessage(restoration.message);
 			input.setters.setStep("error");
 			return;
@@ -2045,6 +2419,8 @@ function useEventRegistrationWizardWithDeps(options, deps) {
 	});
 	const [registrationResult, setRegistrationResult] = useState(null);
 	const [errorMessage, setErrorMessage] = useState("");
+	const [errorAction, setErrorAction] = useState("retry");
+	const [optionsRefreshKey, setOptionsRefreshKey] = useState(0);
 	const [altchaSolution, setAltchaSolution] = useState(null);
 	const { authState: portalAuthState, profile: portalProfile } = deps.usePortalAuth();
 	const waitlistClaim = deps.useWaitlistClaim();
@@ -2074,10 +2450,8 @@ function useEventRegistrationWizardWithDeps(options, deps) {
 	const currentEvent = selectedEvent ?? preSelectedEvent;
 	const currentEventPricing = currentEvent ? resolveRuntimeEventPricing(currentEvent) : null;
 	const currentEventUsesTicketTypes = currentEventPricing !== null && publicEventPricingMode(currentEventPricing) === "ticket_types";
-	const selectedModeAvailability = selectedAttendanceMode ? (currentEvent?.attendanceModes ?? []).find((mode) => mode.mode === selectedAttendanceMode) ?? null : null;
-	const currentAvailableSpots = selectedModeAvailability?.availableSpots ?? currentEvent?.availableSpots;
-	const currentWaitlistEnabled = selectedModeAvailability?.waitlistEnabled ?? currentEvent?.waitlistEnabled ?? false;
-	const usesTicketTypeSelections = currentEventUsesTicketTypes && !(currentAvailableSpots === 0 && currentWaitlistEnabled === true);
+	const currentCanJoinWaitlist = currentEvent ? canJoinEventWaitlist(currentEvent, { attendanceMode: selectedAttendanceMode }) : false;
+	const usesTicketTypeSelections = currentEventUsesTicketTypes && !currentCanJoinWaitlist;
 	const eventTicketTypesForSelection = useMemo(() => getVisibleTicketTypes({
 		event: currentEvent,
 		eligibility: null,
@@ -2108,7 +2482,8 @@ function useEventRegistrationWizardWithDeps(options, deps) {
 		});
 	}, [flowState.ticketsCount, ticketsCount]);
 	const eligibilityResult = deps.useEligibility({
-		enabled: shouldLoadRegistrationOptions(portalAuthState, step),
+		refreshKey: optionsRefreshKey,
+		enabled: shouldRefreshAfterRegistrationError(step, errorAction, shouldLoadRegistrationOptions(portalAuthState, step)),
 		subject: registrationTarget?.subject ?? null,
 		attendanceMode: selectedAttendanceMode,
 		ticketSelections,
@@ -2137,6 +2512,7 @@ function useEventRegistrationWizardWithDeps(options, deps) {
 		});
 	}, [waitlistClaim.claim]);
 	const waitlistRestorationSetters = useMemo(() => ({
+		setErrorAction,
 		setErrorMessage,
 		setStep,
 		setSelectedEvent,
@@ -2160,6 +2536,7 @@ function useEventRegistrationWizardWithDeps(options, deps) {
 		if (waitlistClaim.requiresPortalLogin) return;
 		if (!waitlistClaim.error) return;
 		setErrorMessage(waitlistClaim.error);
+		setErrorAction("event");
 		setStep("error");
 	}, [
 		waitlistClaim.error,
@@ -2262,8 +2639,7 @@ function useEventRegistrationWizardWithDeps(options, deps) {
 		const event = currentEvent;
 		if (!event || publicEventPricingMode(resolveRuntimeEventPricing(event)) !== "ticket_types") return false;
 		if ((event.deliveryMode ?? "in_person") === "hybrid" && !selectedAttendanceMode) return false;
-		const selectedModeAvailability = selectedAttendanceMode ? (event.attendanceModes ?? []).find((mode) => mode.mode === selectedAttendanceMode) ?? null : null;
-		return !((selectedModeAvailability?.availableSpots ?? event.availableSpots) === 0 && (selectedModeAvailability?.waitlistEnabled ?? event.waitlistEnabled) === true);
+		return !canJoinEventWaitlist(event, { attendanceMode: selectedAttendanceMode });
 	}, [currentEvent, selectedAttendanceMode]);
 	const hasValidTicketSelection = !ticketTypeSelectionRequired || normalizedSelectedTicketLines.length > 0 && normalizedSelectedTicketLines.every((line) => {
 		if (!line.ticketTypeId) return false;
@@ -2344,6 +2720,7 @@ function useEventRegistrationWizardWithDeps(options, deps) {
 	]);
 	const handleDetailsComplete = async () => {
 		if (ticketTypeSelectionRequired && !hasValidTicketSelection) {
+			setErrorAction("places");
 			const message = "Choose at least one available ticket to continue.";
 			setErrorMessage(message);
 			setStep("error");
@@ -2354,6 +2731,7 @@ function useEventRegistrationWizardWithDeps(options, deps) {
 			};
 		}
 		if (slidingScaleSelectionMessage) {
+			setErrorAction("places");
 			setErrorMessage(slidingScaleSelectionMessage);
 			setStep("error");
 			return {
@@ -2371,7 +2749,8 @@ function useEventRegistrationWizardWithDeps(options, deps) {
 			};
 		}
 		if (waitlistClaim.claim === null && eligibility?.isFull && !eligibility.canJoinWaitlist) {
-			const message = "This event is sold out.";
+			const message = "Sorry, there aren’t enough places left for your selection. Please check the available places and choose again.";
+			setErrorAction("places");
 			setErrorMessage(message);
 			setStep("error");
 			return {
@@ -2487,6 +2866,7 @@ function useEventRegistrationWizardWithDeps(options, deps) {
 	const selectionMethod = paymentSelection.method;
 	const shouldShowDiscountToggle = discountContext !== null && discountUi.manualCodeEntryAllowed && (selectionMethod === "stripe" || selectionMethod === "pass_bundle" || selectionMethod === "membership_bundle");
 	const handleSubmit = deps.useEventRegistrationSubmit({
+		setErrorAction,
 		api,
 		registrationTarget,
 		selectedAttendanceMode,
@@ -2509,26 +2889,31 @@ function useEventRegistrationWizardWithDeps(options, deps) {
 			...current,
 			consentAccepted: false
 		}));
-		const slidingScale = getSlidingScaleForEvent(event);
-		setSelectedSlidingAmountInput(slidingScale?.suggestedAmount !== null && slidingScale?.suggestedAmount !== void 0 ? formatCentsAsCurrencyInput(slidingScale.suggestedAmount) : "");
-		setSelectedAttendanceMode((event.deliveryMode ?? "in_person") === "hybrid" ? null : (event.deliveryMode ?? "in_person") === "online" ? "online" : "in_person");
+		const defaults = getEventSelectionDefaults(event);
+		setSelectedSlidingAmountInput(defaults.slidingAmountInput);
+		setSelectedAttendanceMode(defaults.attendanceMode);
 		setSelectedTicketLines([]);
 		dispatchFlow({
 			type: "event-changed",
 			hasPreSelectedContext: true
 		});
 	};
-	const handleRetry = () => {
-		dispatchFlow({
-			type: "reset",
-			hasPreSelectedContext
-		});
-		setSelectedTicketLines([]);
-		setSelectedSlidingAmountInput("");
-		setSelectedAttendanceMode(preSelectedEvent?.deliveryMode === "online" ? "online" : preSelectedEvent?.deliveryMode === "in_person" ? "in_person" : null);
-		setErrorMessage("");
-		setPendingRegistrationReference(null);
-	};
+	const handleRetry = () => recoverRegistrationError(resolveRegistrationRecoveryAction(step, errorAction), {
+		canJoinWaitlist: canRecoverToWaitlist(eligibility),
+		refreshOptions: () => setOptionsRefreshKey((value) => value + 1),
+		clearError: () => setErrorMessage(""),
+		setStep,
+		reset: () => resetRegistrationAfterExpiry({
+			hasPreSelectedContext,
+			preSelectedEvent,
+			dispatchFlow,
+			setSelectedTicketLines,
+			setSelectedSlidingAmountInput,
+			setSelectedAttendanceMode,
+			setErrorMessage,
+			setPendingRegistrationReference
+		})
+	});
 	const handlePaymentStepStateChange = useCallback((state) => {
 		setPaymentStepState(state);
 	}, []);
@@ -2591,6 +2976,7 @@ function useEventRegistrationWizardWithDeps(options, deps) {
 		handleGuestShakeEnd,
 		registrationResult,
 		errorMessage,
+		errorAction,
 		altchaSolution,
 		setAltchaSolution,
 		portalAuthState,
@@ -2997,11 +3383,11 @@ function EventRegistrationSummaryBar(props) {
 */
 function resolveDetailsButtonText(input) {
 	const { wizard } = input;
-	if (wizard.eligibility?.canJoinWaitlist) return "Join Waitlist";
+	if (wizard.eligibility?.canJoinWaitlist) return "Join waitlist";
 	if (!input.hasWaitlistClaim && wizard.eligibility?.isFull) return "Sold out";
 	if (wizard.paymentSelection.method === "pass") return "Book using class pass";
 	if (wizard.paymentSelection.method === "membership") return input.fallbackText;
-	return wizard.eventRequiresPayment ? "Continue to Payment" : input.fallbackText;
+	return wizard.eventRequiresPayment ? "Continue to payment" : input.fallbackText;
 }
 function resolveExistingRegistrationLabel(wizard) {
 	return wizard.registrationState.kind === "waitlisted" ? "Already on waitlist" : "Already registered";
@@ -3013,13 +3399,24 @@ function isExistingRegistrationBlocking$1(wizard) {
 		hasWaitlistClaim: wizard.waitlistClaim.claim !== null
 	});
 }
+/**
+* Full for the visitor's selected attendance mode (or the whole event when no
+* mode is chosen) with no waitlist to fall back on. Reads the same capacity
+* source as the steps above the action bar so the button never disagrees
+* with them on a hybrid event.
+*/
+function isFullWithNoWaitlist(event, attendanceMode) {
+	if (!event) return false;
+	const source = selectEventCapacitySource(event, attendanceMode);
+	return getEventAvailability(source).isFull && !source.waitlistEnabled;
+}
 function EventRegistrationWizardActions(props) {
 	const { wizard } = props;
 	const nextStepAfterTickets = "enter-details";
 	const prevStepForDetails = "select-tickets";
 	const hasWaitlistClaim = wizard.waitlistClaim.claim !== null;
 	const currentEvent = wizard.selectedEvent ?? wizard.preSelectedEvent;
-	const isSoldOutWithoutWaitlist = !hasWaitlistClaim && currentEvent?.availableSpots === 0 && currentEvent.waitlistEnabled !== true;
+	const isSoldOutWithoutWaitlist = !hasWaitlistClaim && isFullWithNoWaitlist(currentEvent, wizard.selectedAttendanceMode);
 	const getDetailsButtonText = () => resolveDetailsButtonText({
 		wizard,
 		hasWaitlistClaim,
@@ -3111,191 +3508,6 @@ function EventRegistrationWizardActions(props) {
 	}
 }
 //#endregion
-//#region ../commerce/src/purchase/checkoutPaymentFlow.ts
-function planCheckoutPaymentFlow(options) {
-	const amountDueCents = toNonNegativeCents(options.amountDueCents);
-	const discountCents = toNonNegativeCents(options.discountCents);
-	const availableCreditCents = toNonNegativeCents(options.availableCreditCents);
-	const minimumStripeChargeCents = toNonNegativeCents(options.minimumStripeChargeCents ?? 0);
-	if (amountDueCents <= 0) return {
-		kind: "bypass",
-		bypassReason: discountCents > 0 ? "discount_free" : "free",
-		reserveCreditCents: 0
-	};
-	if (!options.creditCurrencyMatches || availableCreditCents <= 0) return {
-		kind: "stripe",
-		reserveCreditCents: toNonNegativeCents(0)
-	};
-	if (availableCreditCents >= amountDueCents) return {
-		kind: "store_credit_only",
-		reserveCreditCents: amountDueCents
-	};
-	return {
-		kind: "stripe",
-		reserveCreditCents: planMixedPaymentCreditReservation({
-			amountDueCents,
-			availableCreditCents,
-			minimumStripeChargeCents
-		})
-	};
-}
-function planMixedPaymentCreditReservation(input) {
-	const chargeAfterFullCredit = input.amountDueCents - input.availableCreditCents;
-	if (input.minimumStripeChargeCents <= 0 || chargeAfterFullCredit <= 0 || chargeAfterFullCredit >= input.minimumStripeChargeCents) return input.availableCreditCents;
-	if (input.amountDueCents < input.minimumStripeChargeCents) return toNonNegativeCents(0);
-	return toNonNegativeCents(input.amountDueCents - input.minimumStripeChargeCents);
-}
-/**
-* Apply site credit to a flexible-balance booking before card payment.
-*
-* Credit first reduces the configured payment due now. Once that payment is
-* covered, any remaining credit reduces the later balance. If a partial credit
-* application would leave a positive card charge below Stripe's minimum, less
-* credit is used so the configured payment can still be collected.
-*/
-function planFlexibleBalanceCreditFirst(input) {
-	const totalCents = toNonNegativeCents(input.totalAfterDiscountCents);
-	const configuredDueNowCents = toNonNegativeCents(Math.min(input.configuredPaymentDueNowCents, totalCents));
-	const availableCreditCents = toNonNegativeCents(input.creditCurrencyMatches ? input.availableCreditCents : 0);
-	const minimumStripeChargeCents = toNonNegativeCents(input.minimumStripeChargeCents ?? 0);
-	if (availableCreditCents >= totalCents && totalCents > 0) return {
-		kind: "credit_only",
-		reserveCreditCents: totalCents,
-		cardDueNowCents: toNonNegativeCents(0),
-		laterBalanceCents: toNonNegativeCents(0)
-	};
-	let reserveCreditCents = toNonNegativeCents(Math.min(availableCreditCents, totalCents));
-	if (reserveCreditCents >= configuredDueNowCents) return {
-		kind: "flexible_balance",
-		reserveCreditCents,
-		cardDueNowCents: toNonNegativeCents(0),
-		laterBalanceCents: toNonNegativeCents(totalCents - reserveCreditCents)
-	};
-	const plannedCardDueNowCents = toNonNegativeCents(configuredDueNowCents - reserveCreditCents);
-	if (plannedCardDueNowCents > 0 && plannedCardDueNowCents < minimumStripeChargeCents) {
-		if (configuredDueNowCents < minimumStripeChargeCents) return {
-			kind: "card_below_minimum",
-			reserveCreditCents: toNonNegativeCents(0),
-			cardDueNowCents: configuredDueNowCents,
-			laterBalanceCents: toNonNegativeCents(totalCents - configuredDueNowCents)
-		};
-		reserveCreditCents = toNonNegativeCents(configuredDueNowCents - minimumStripeChargeCents);
-	}
-	const cardDueNowCents = toNonNegativeCents(configuredDueNowCents - reserveCreditCents);
-	return {
-		kind: "flexible_balance",
-		reserveCreditCents,
-		cardDueNowCents,
-		laterBalanceCents: toNonNegativeCents(totalCents - reserveCreditCents - cardDueNowCents)
-	};
-}
-//#endregion
-//#region ../commerce/src/purchase/settlement.ts
-function normalizeCurrencyCode(raw) {
-	const normalized = raw.trim().toUpperCase();
-	if (!/^[A-Z]{3}$/.test(normalized)) throw new Error(`Invalid currency code: ${raw}`);
-	return normalized;
-}
-//#endregion
-//#region ../commerce/src/purchase/checkoutSessionMetadata.ts
-const datedOfferingSharedEngineMetadataShape = {
-	datedOfferingEngineContractVersion: z.literal("shared_v1"),
-	datedOfferingEngineRouteKind: z.literal("shared_whole_series_registration"),
-	datedOfferingCapacityHoldId: z.string().uuid(),
-	datedOfferingCapacityHoldAuditRef: z.string().uuid(),
-	customerId: z.string().uuid(),
-	eventSeriesId: z.string().uuid()
-};
-z.object(datedOfferingSharedEngineMetadataShape);
-const orderCheckoutSessionMetadataBaseShape = {
-	type: z.literal("order"),
-	site_id: z.string().uuid(),
-	order_id: z.string().uuid().optional(),
-	customer_email: z.string().email(),
-	customer_name: z.string().optional(),
-	product_id: z.string().uuid().optional(),
-	attendee_id: z.string().uuid().optional(),
-	occurrence_id: z.string().uuid().optional(),
-	tickets_count: z.string().optional(),
-	notes: z.string().optional(),
-	discount_redemption_id: z.string().uuid().optional(),
-	discount_code_id: z.string().uuid().optional(),
-	discount_code: z.string().optional(),
-	discount_public_label: z.string().optional(),
-	credit_reservation_id: z.string().uuid().optional(),
-	credit_reserved_cents: z.string().optional(),
-	discount_code_amount_cents: z.string().optional(),
-	order_payment_reason: z.enum([
-		"instalment_payoff",
-		"flexible_balance_initial",
-		"flexible_balance_paydown"
-	]).optional(),
-	order_payment_plan_id: z.string().uuid().optional(),
-	order_flexible_balance_contract_id: z.string().uuid().optional()
-};
-const absentDatedOfferingSharedEngineMetadataShape = {
-	datedOfferingEngineContractVersion: z.never().optional(),
-	datedOfferingEngineRouteKind: z.never().optional(),
-	datedOfferingCapacityHoldId: z.never().optional(),
-	datedOfferingCapacityHoldAuditRef: z.never().optional(),
-	customerId: z.never().optional(),
-	eventSeriesId: z.never().optional()
-};
-const LegacyOrderCheckoutSessionMetadataSchema = z.object({
-	...orderCheckoutSessionMetadataBaseShape,
-	...absentDatedOfferingSharedEngineMetadataShape
-});
-const SharedDatedOfferingOrderCheckoutSessionMetadataSchema = z.object({
-	...orderCheckoutSessionMetadataBaseShape,
-	...datedOfferingSharedEngineMetadataShape
-});
-z.union([SharedDatedOfferingOrderCheckoutSessionMetadataSchema, LegacyOrderCheckoutSessionMetadataSchema]);
-toNonNegativeCents(0);
-//#endregion
-//#region ../commerce/src/purchase/stripeMinimumCharge.ts
-const STRIPE_MINIMUM_CHARGE_CENTS_BY_CURRENCY = {
-	GBP: 30,
-	USD: 50,
-	EUR: 50,
-	AED: 200,
-	AUD: 50,
-	BGN: 100,
-	BRL: 50,
-	CAD: 50,
-	CHF: 50,
-	CZK: 1500,
-	DKK: 250,
-	HKD: 400,
-	HUF: 17500,
-	JPY: 50,
-	MXN: 1e3,
-	MYR: 200,
-	NOK: 300,
-	NZD: 50,
-	PLN: 200,
-	RON: 200,
-	SEK: 300,
-	SGD: 50,
-	THB: 1e3
-};
-function isStripeMinimumChargeCurrency(currency) {
-	return currency in STRIPE_MINIMUM_CHARGE_CENTS_BY_CURRENCY;
-}
-function getStripeMinimumChargeRequirement(rawCurrency) {
-	let currency;
-	try {
-		currency = normalizeCurrencyCode(rawCurrency);
-	} catch {
-		return null;
-	}
-	const currencyKey = currency;
-	if (!isStripeMinimumChargeCurrency(currencyKey)) return null;
-	return {
-		currency,
-		minimumAmountCents: STRIPE_MINIMUM_CHARGE_CENTS_BY_CURRENCY[currencyKey]
-	};
-}
-//#endregion
 //#region ../blocks/src/system/runtime/nodes/event-registration/siteCreditPreview.ts
 function calculateEventRegistrationPreviewTotal(input) {
 	const discountCents = input.manualDiscountCode.trim() ? 0 : input.automaticDiscount?.computedAmountCents ?? 0;
@@ -3409,9 +3621,16 @@ function TicketCounter(props) {
 	});
 }
 function TicketCounterLimit(props) {
+	const showBookingLimit = !props.availabilityLabel || props.maxAllowed < (props.availableSpots ?? Infinity);
 	return /* @__PURE__ */ jsxs("p", {
 		className: "er-ticket-counter-limit",
-		children: [/* @__PURE__ */ jsx("span", { children: props.maximumLabel }), props.availabilityLabel ? /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx("br", {}), /* @__PURE__ */ jsx("span", { children: props.availabilityLabel })] }) : null]
+		children: [props.availabilityLabel ? /* @__PURE__ */ jsx("span", { children: props.availabilityLabel }) : null, showBookingLimit ? /* @__PURE__ */ jsxs(Fragment, { children: [props.availabilityLabel ? /* @__PURE__ */ jsx("br", {}) : null, /* @__PURE__ */ jsxs("span", { children: [
+			"Up to ",
+			props.maxAllowed,
+			" ",
+			props.quantityLabel,
+			" per booking."
+		] })] }) : null]
 	});
 }
 function BookingUnitSessionHint(props) {
@@ -3427,7 +3646,7 @@ function BookingUnitSessionHint(props) {
 }
 function bookingQuantityLabel(unit, waitlist) {
 	if (!waitlist) return pluralizeBookingUnit(unit, 2);
-	return unit === "place" ? "waitlist places" : "waitlist spots";
+	return "waitlist places";
 }
 function BookingQuantityPrompt(props) {
 	return /* @__PURE__ */ jsxs("h3", {
@@ -3486,6 +3705,7 @@ function SlidingScaleAmountField(props) {
 }
 function TicketTypeQuantityRows(props) {
 	const totalSelectedQuantity = getTicketSelectionTotal(props.ticketSelections);
+	const effectiveMaxTickets = props.availableSpots == null ? props.maxTickets : Math.min(props.maxTickets, props.availableSpots);
 	return /* @__PURE__ */ jsxs("div", {
 		className: "er-ticket-lines",
 		children: [
@@ -3497,6 +3717,7 @@ function TicketTypeQuantityRows(props) {
 					const quantity = getTicketLineQuantity(props.ticketSelections, ticketType.id);
 					const disabled = ticketType.availability.kind === "unavailable";
 					const availabilityLabel = getTicketTypeAvailabilityLabel(ticketType);
+					const ticketTypeRemainingLabel = formatTicketTypeRemaining(ticketType.availability.remainingCapacity);
 					const priceLabel = ticketType.priceAmount > 0 ? formatPrice(ticketType.priceAmount, props.currency) : "Free";
 					const maxAllowed = disabled ? 0 : getTicketTypeLineMax({
 						currentQuantity: quantity,
@@ -3528,9 +3749,9 @@ function TicketTypeQuantityRows(props) {
 								availabilityLabel ? /* @__PURE__ */ jsx("p", {
 									className: "er-ticket-line-detail",
 									children: availabilityLabel
-								}) : ticketType.availability.remainingCapacity !== null ? /* @__PURE__ */ jsxs("p", {
+								}) : ticketTypeRemainingLabel ? /* @__PURE__ */ jsx("p", {
 									className: "er-ticket-line-detail",
-									children: [ticketType.availability.remainingCapacity, " remaining for this ticket type"]
+									children: ticketTypeRemainingLabel
 								}) : null
 							]
 						}), /* @__PURE__ */ jsx(TicketCounter, {
@@ -3550,8 +3771,10 @@ function TicketTypeQuantityRows(props) {
 				})
 			}),
 			/* @__PURE__ */ jsx(TicketCounterLimit, {
-				maximumLabel: `${props.maxTickets} ${pluralizeBookingUnit(props.bookingUnit, props.maxTickets)} maximum`,
-				availabilityLabel: props.availableSpots != null ? `${props.availableSpots} spots available` : null
+				maxAllowed: effectiveMaxTickets,
+				quantityLabel: pluralizeBookingUnit(props.bookingUnit, effectiveMaxTickets),
+				availableSpots: props.availableSpots,
+				availabilityLabel: props.availabilityLabel
 			}),
 			totalSelectedQuantity === 0 && props.hasAvailableTicketTypes ? /* @__PURE__ */ jsxs("p", {
 				className: "er-text er-text--muted",
@@ -3572,9 +3795,13 @@ function TicketTypeQuantityRows(props) {
 	});
 }
 function getAttendanceModeDetail(attendanceMode) {
-	if (attendanceMode.availableSpots === null) return "Unlimited spots";
-	if (attendanceMode.availableSpots === 0) return attendanceMode.waitlistEnabled ? "Currently full, waitlist available" : "Currently full";
-	return `${attendanceMode.availableSpots} spots available`;
+	const remaining = getRemainingPlaces(attendanceMode);
+	switch (remaining.kind) {
+		case "unlimited": return "Unlimited places";
+		case "open": return "Places available";
+		case "low": return formatRemainingPlaces(attendanceMode);
+		case "full": return remaining.waitlist ? "Currently full, waitlist available" : "Currently full";
+	}
 }
 function AttendanceModeTiles(props) {
 	return /* @__PURE__ */ jsx("div", {
@@ -3620,11 +3847,11 @@ const TicketSelectionStep = ({ event, occurrenceContext: _occurrenceContext, sel
 	const unit = bookingUnit.kind;
 	const deliveryMode = event?.deliveryMode ?? "in_person";
 	const attendanceModes = event?.attendanceModes ?? [];
-	const selectedModeAvailability = selectedAttendanceMode ? attendanceModes.find((mode) => mode.mode === selectedAttendanceMode) ?? null : null;
-	const availableSpots = selectedModeAvailability?.availableSpots ?? event?.availableSpots;
-	const waitlistEnabled = selectedModeAvailability?.waitlistEnabled ?? event?.waitlistEnabled ?? false;
-	const isSoldOut = availableSpots === 0;
-	const canJoinWaitlist = isSoldOut && waitlistEnabled === true;
+	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 eventPricing = event ? resolveRuntimeEventPricing(event) : null;
 	const eventPricingMode = eventPricing ? publicEventPricingMode(eventPricing) : void 0;
 	const eventPricingCurrency = eventPricing ? publicEventPricingCurrency(eventPricing) : null;
@@ -3645,7 +3872,7 @@ const TicketSelectionStep = ({ event, occurrenceContext: _occurrenceContext, sel
 		selectedTicketTypeRemainingCapacity: implicitTicketType?.availability.remainingCapacity ?? null,
 		hasSelectedTicketType: implicitTicketType !== null
 	});
-	const eventAvailabilityLabel = !canJoinWaitlist && event?.availableSpots != null ? `${event.availableSpots} spots available` : null;
+	const eventAvailabilityLabel = !canJoinWaitlist && capacitySource ? formatRemainingPlaces(capacitySource) : null;
 	if (deliveryMode === "hybrid" && !selectedAttendanceMode) return /* @__PURE__ */ jsxs("div", {
 		className: "rb-reg-stack er-stack",
 		children: [
@@ -3668,7 +3895,7 @@ const TicketSelectionStep = ({ event, occurrenceContext: _occurrenceContext, sel
 		className: "rb-reg-stack er-stack",
 		children: [/* @__PURE__ */ jsx("h3", {
 			className: "er-title",
-			children: "Sold Out"
+			children: "Sold out"
 		}), /* @__PURE__ */ jsx("p", {
 			className: "er-text er-text--muted",
 			children: "Sorry you missed out! This event is fully booked."
@@ -3699,6 +3926,7 @@ const TicketSelectionStep = ({ event, occurrenceContext: _occurrenceContext, sel
 					ticketSelections,
 					maxTickets,
 					availableSpots,
+					availabilityLabel: eventAvailabilityLabel,
 					currency: eventPricingCurrency ?? "usd",
 					hasAvailableTicketTypes,
 					onTicketSelectionsChange,
@@ -3725,14 +3953,16 @@ const TicketSelectionStep = ({ event, occurrenceContext: _occurrenceContext, sel
 						label: bookingQuantityLabel(unit, canJoinWaitlist),
 						onTicketsChange
 					}), /* @__PURE__ */ jsx(TicketCounterLimit, {
-						maximumLabel: `${maxAllowed} ${canJoinWaitlist ? bookingQuantityLabel(unit, true) : pluralizeBookingUnit(unit, maxAllowed)} maximum`,
+						maxAllowed,
+						quantityLabel: canJoinWaitlist ? bookingQuantityLabel(unit, true) : pluralizeBookingUnit(unit, maxAllowed),
+						availableSpots: canJoinWaitlist ? null : availableSpots,
 						availabilityLabel: eventAvailabilityLabel
 					})]
 				})
 			] }),
 			canJoinWaitlist && /* @__PURE__ */ jsx("p", {
 				className: "er-text er-text--muted",
-				children: "This event is currently full. Continue to join the waitlist if a spot opens up."
+				children: "This event is currently full. Continue to join the waitlist if a place opens up."
 			})
 		]
 	});
@@ -4214,15 +4444,14 @@ function resolvePaymentStepStatus(input) {
 function shouldPromptForLogin(status, isAuthenticated, eligibility) {
 	return Boolean(status === "not-eligible" && !isAuthenticated && eligibility && (eligibility.requiresAuthForPasses || eligibility.requiresAuthForMemberships));
 }
-function MissingEligibilityPanel(props) {
-	const missing = [!props.occurrenceId && "occurrenceId", !props.email && "email"].filter((part) => Boolean(part));
+function MissingEligibilityPanel() {
 	return /* @__PURE__ */ jsx("div", {
 		className: "rb-reg-stack er-stack",
 		children: /* @__PURE__ */ jsx("div", {
 			className: "er-center",
-			children: /* @__PURE__ */ jsxs("p", {
+			children: /* @__PURE__ */ jsx("p", {
 				className: "er-text er-text--error",
-				children: ["Unable to determine payment options", missing.length > 0 && ` (missing: ${missing.join(", ")})`]
+				children: "We couldn’t load the booking options for this event. Please refresh this page and try again. If this keeps happening, contact the organiser for help."
 			})
 		})
 	});
@@ -4312,10 +4541,7 @@ function PaymentBlockingPanel(props) {
 			})
 		})
 	});
-	if (!props.eligibility) return /* @__PURE__ */ jsx(MissingEligibilityPanel, {
-		occurrenceId: props.occurrenceId,
-		email: props.email
-	});
+	if (!props.eligibility) return /* @__PURE__ */ jsx(MissingEligibilityPanel, {});
 	if (props.eligibility.registration.kind !== "none") {
 		const isBooked = props.eligibility.registration.kind === "booked";
 		return /* @__PURE__ */ jsxs("div", {
@@ -4323,12 +4549,16 @@ function PaymentBlockingPanel(props) {
 			children: [/* @__PURE__ */ jsx("h3", {
 				className: "er-title",
 				children: isBooked ? "Already booked" : "Already on the waitlist"
-			}), /* @__PURE__ */ jsx("div", {
+			}), /* @__PURE__ */ jsxs("div", {
 				className: "er-center",
-				children: /* @__PURE__ */ jsx("p", {
+				children: [/* @__PURE__ */ jsx("p", {
 					className: "er-text er-text--muted",
-					children: isBooked ? "You're already booked on this event." : "You're already on the waitlist for this event."
-				})
+					children: isBooked ? "You already have a booking for this event. Please check your bookings to see its status. If you need help, contact the organiser." : "You're already on the waitlist for this event."
+				}), /* @__PURE__ */ jsx("a", {
+					href: "/portal",
+					className: "er-retry-btn",
+					children: "View my bookings"
+				})]
 			})]
 		});
 	}
@@ -4451,7 +4681,7 @@ function resolvePaymentButtonText(method, siteCreditPreview, eligibility, select
 	const currency = eligibility?.currency ?? "GBP";
 	switch (method) {
 		case "stripe":
-			if (siteCreditPreview.kind !== "applied") return selectedDirectOption?.ctaLabel ?? "Continue to Payment";
+			if (siteCreditPreview.kind !== "applied") return selectedDirectOption?.ctaLabel ?? "Continue to payment";
 			if (siteCreditPreview.cardDueNowCents > 0) return `Pay ${formatPrice(siteCreditPreview.cardDueNowCents, currency)} by card`;
 			return `Book with ${formatPrice(siteCreditPreview.appliedCreditCents, currency)} site credit`;
 		case "pass": return "Book using class pass";
@@ -4827,7 +5057,19 @@ function StepIndicator(props) {
 *
 * Displays an error message with a retry button when registration fails.
 */
-const ErrorStep = ({ message, onRetry }) => {
+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",
@@ -4836,16 +5078,20 @@ const ErrorStep = ({ message, onRetry }) => {
 			variant: "error",
 			children: /* @__PURE__ */ jsx(CrossIcon, {})
 		}),
-		title: "Registration Failed",
+		title: "We couldn’t complete your booking",
 		body: /* @__PURE__ */ jsx("p", {
 			className: "er-text--muted er-message",
-			children: 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: /* @__PURE__ */ jsx("button", {
+		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: "Try Again"
+			children: offerWaitlist ? "Join the waiting list" : labels[action]
 		})
 	});
 };
@@ -4857,7 +5103,7 @@ const ErrorStep = ({ message, onRetry }) => {
 * Displays when the payment was definitively declined/failed.
 * Provides a retry option that returns to payment selection with form state preserved.
 */
-const PaymentFailedStep = ({ message, onRetry }) => {
+const PaymentFailedStep = ({ onRetry }) => {
 	return /* @__PURE__ */ jsx(TerminalPanel, {
 		tone: "error",
 		className: "er-center",
@@ -4866,16 +5112,16 @@ const PaymentFailedStep = ({ message, onRetry }) => {
 			variant: "error",
 			children: /* @__PURE__ */ jsx(CrossIcon, {})
 		}),
-		title: "Payment Failed",
+		title: "Your payment didn’t go through",
 		body: /* @__PURE__ */ jsx("p", {
 			className: "er-text--muted er-message",
-			children: message
+			children: "Please try again or choose another payment option. If this keeps happening, contact the organiser for help."
 		}),
 		actions: /* @__PURE__ */ jsx("button", {
 			type: "button",
 			onClick: onRetry,
 			className: "er-retry-btn",
-			children: "Try Again"
+			children: "View payment options"
 		})
 	});
 };
@@ -4970,7 +5216,7 @@ const VerifyingPaymentStep = () => {
 * - "Check Again" button to restart polling
 * - Contact support option for user reassurance
 */
-const VerifyingTimeoutStep = ({ onCheckAgain, supportEmail, title = "Your registration is saved", message = "We're still confirming your payment. This usually resolves within a few minutes. You'll receive a confirmation email once everything is verified." }) => {
+const VerifyingTimeoutStep = ({ onCheckAgain, supportEmail, title = "We’re checking your payment", message = "Your booking is not confirmed yet. Please don’t make another booking while we check. You can check your payment status again in a moment." }) => {
 	return /* @__PURE__ */ jsx(TerminalPanel, {
 		tone: "warning",
 		className: "er-center",
@@ -4989,8 +5235,12 @@ const VerifyingTimeoutStep = ({ onCheckAgain, supportEmail, title = "Your regist
 			type: "button",
 			onClick: onCheckAgain,
 			className: "er-btn er-btn--primary",
-			children: "Check Again"
-		}) : void 0,
+			children: "Check payment status"
+		}) : /* @__PURE__ */ jsx("a", {
+			href: "/portal",
+			className: "er-btn er-btn--primary",
+			children: "Check payment status"
+		}),
 		secondaryBody: supportEmail ? /* @__PURE__ */ jsxs("p", {
 			className: "er-text--sm er-text--muted er-message",
 			children: [
@@ -5086,7 +5336,7 @@ function EventRegistrationTerminalState(props) {
 			onRetry: () => wizard.setStep("select-payment")
 		});
 		case "verifying-timeout": return /* @__PURE__ */ jsx(VerifyingTimeoutStep, {
-			onCheckAgain: wizard.verification.status === "timeout" ? wizard.verification.retry : void 0,
+			onCheckAgain: wizard.verification.status === "timeout" ? wizard.verification.retry : wizard.verification.retryReturn,
 			title: wizard.verification.status === "timeout" ? void 0 : "We’re checking your payment",
 			message: wizard.verification.status === "timeout" ? void 0 : wizard.errorMessage,
 			supportEmail: props.supportEmail
@@ -5098,6 +5348,8 @@ function EventRegistrationTerminalState(props) {
 		}) : null;
 		case "error": return /* @__PURE__ */ jsx(ErrorStep, {
 			message: wizard.errorMessage,
+			action: wizard.errorAction,
+			canJoinWaitlist: wizard.eligibility?.isFull && wizard.eligibility.canJoinWaitlist,
 			onRetry: wizard.handleRetry
 		});
 		case "select-event":
@@ -5255,7 +5507,7 @@ const EVENT_PORTAL_AUTH_COPY = {
 		buttonText: "Email me a login link →"
 	},
 	"waitlist-claim": {
-		title: "Log in to claim your waitlist spot",
+		title: "Log in to claim your waitlist place",
 		buttonText: "Email me a login link to continue →"
 	}
 };
@@ -5265,11 +5517,12 @@ function getActiveTicketTypes(event) {
 function formatTicketTypePrice(ticketType, currency) {
 	return formatCurrencyAmount(ticketType.priceAmount, currency, { decimals: "auto" });
 }
-function getAvailabilityLabel(event) {
-	const availableSpots = event?.availableSpots;
-	if (availableSpots === null || availableSpots === void 0) return null;
-	if (availableSpots > 0) return `${availableSpots} spots left`;
-	return event?.waitlistEnabled ? "Waitlist available" : "Fully booked";
+function getAvailabilityLabel(event, attendanceMode) {
+	if (!event) return null;
+	return formatRemainingPlaces(selectEventCapacitySource(event, attendanceMode), {
+		full: "Fully booked",
+		waitlist: "Waitlist available"
+	});
 }
 function getWizardStepLabel(input) {
 	switch (input.step) {
@@ -5366,7 +5619,7 @@ function EventRegistrationWizard(props) {
 	const currentStepNumber = getStepNumber(wizard.step, activeWizardSteps);
 	const summaryEventPricingType = summaryEvent ? publicEventPricingType(summaryEvent.pricing) : "free";
 	const summaryPriceLabel = summaryEvent ? formatEventPriceDisplay(summaryEvent.pricing) : null;
-	const summaryAvailabilityLabel = getAvailabilityLabel(summaryEvent);
+	const summaryAvailabilityLabel = getAvailabilityLabel(summaryEvent, wizard.selectedAttendanceMode);
 	const waitlistClaimRequiresPortalLogin = wizard.waitlistClaim.requiresPortalLogin && wizard.portalAuthState !== "authenticated" && wizard.portalAuthState !== "checking";
 	const portalAuthCopy = waitlistClaimRequiresPortalLogin ? {
 		...EVENT_PORTAL_AUTH_COPY["waitlist-claim"],