@riverbankcms/sdk 0.142.0 → 0.143.0

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

@@ -1,9 +1,9 @@
 import type { EventRegistrationErrorAction } from '../../../../../../commerce/src/purchase/index';
 import type { BlockApiClient } from '../../api';
 import type { EventRegistrationStatusReference, PaymentMethod } from '../../api/types';
-import type { RegistrationTarget } from './registrationDerivations';
+import { type RegistrationTarget } from './registrationDerivations';
 import { savePendingRegistration } from './sessionStorage';
-import type { EventTicketSelectionLine, FormData, Guest, PaymentSelection, RegistrationResult, RegistrationStep } from './types';
+import type { EventTicketSelectionLine, FormData, Guest, PaymentSelection, PaymentStatusRecoveryState, RegistrationResult, RegistrationStep } from './types';
 export type EventRegistrationSubmitOptions = Readonly<{
     redirect?: 'auto' | 'manual';
 }>;
@@ -12,6 +12,11 @@ export type EventRegistrationSubmitResult = Readonly<{
     outcome: {
         kind: 'completed';
     };
+}> | Readonly<{
+    ok: true;
+    outcome: {
+        kind: 'payment_status';
+    };
 }> | Readonly<{
     ok: true;
     outcome: {
@@ -25,6 +30,7 @@ export type EventRegistrationSubmitResult = Readonly<{
 }>;
 export type EventRegistrationSubmit = (method: PaymentMethod, passId?: string, membershipId?: string, selection?: PaymentSelection, submitOptions?: EventRegistrationSubmitOptions) => Promise<EventRegistrationSubmitResult>;
 export type UseEventRegistrationSubmitInput = {
+    commandRef: EventRegistrationCommandRef;
     api: BlockApiClient;
     registrationTarget: RegistrationTarget | null;
     selectedAttendanceMode: 'in_person' | 'online' | null;
@@ -42,6 +48,14 @@ export type UseEventRegistrationSubmitInput = {
     setErrorAction?: (action: EventRegistrationErrorAction) => void;
     setRegistrationResult: (result: RegistrationResult) => void;
     setErrorMessage: (message: string) => void;
+    setPaymentStatusRecovery: (state: PaymentStatusRecoveryState | null) => void;
+};
+/** Shared only with explicit start-again actions; uncertainty alone retains identity. */
+export type EventRegistrationCommandRef = {
+    current: Readonly<{
+        id: string;
+        intentKey: string;
+    }> | null;
 };
 export type EventRegistrationSubmitDeps = Readonly<{
     savePendingRegistration: typeof savePendingRegistration;
@@ -57,5 +71,45 @@ type ClientCommandIdCryptoSource = Readonly<{
 }>;
 export declare function createClientCommandId(cryptoSource?: ClientCommandIdCryptoSource): string;
 export declare function useEventRegistrationSubmit(options: UseEventRegistrationSubmitInput): EventRegistrationSubmit;
+/**
+ * Describe a completed registration to the success step.
+ *
+ * Only pass redemptions adopt the server's message: it names the credits spent
+ * and the balance left, which the block's copy cannot. Every other method keeps
+ * whatever success message the site configured.
+ */
 export declare function useEventRegistrationSubmitWithDeps(options: UseEventRegistrationSubmitInput, deps: EventRegistrationSubmitDeps): EventRegistrationSubmit;
+type SelectionSnapshot = Exclude<PaymentSelection, Readonly<{
+    method: null;
+}>>;
+/**
+ * Freeze everything this submission is about to send, including the command
+ * identity the server keys the commit on.
+ */
+declare function prepareSubmitContext(options: UseEventRegistrationSubmitInput, registrationCommandId: string, target: RegistrationTarget, method: PaymentMethod, passId: string | undefined, membershipId: string | undefined, selection: PaymentSelection | undefined): {
+    registrationCommandId: string;
+    ticketSelections: Readonly<{
+        pricingOptionId: string | null;
+        quantity: number;
+    }>[];
+    bundleProductId: string | undefined;
+    selectionSnapshot: SelectionSnapshot;
+    guestsPayload: {
+        name: string;
+        email: string | undefined;
+        phone: string | undefined;
+    }[] | undefined;
+    subject: {
+        kind: "occurrence";
+        occurrenceId: string;
+        attendanceMode: "in_person" | "online" | undefined;
+        eventSeriesId?: undefined;
+    } | {
+        kind: "wholeSeries";
+        eventSeriesId: string;
+        attendanceMode: "in_person" | "online" | undefined;
+        occurrenceId?: undefined;
+    };
+};
+export type PreparedSubmit = ReturnType<typeof prepareSubmitContext>;
 export {};

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

@@ -51,8 +51,6 @@ export declare function useEventRegistrationWizard(options: UseEventRegistration
     scopedEvents: RegistrationEvent[];
     preSelectedEvent: RegistrationEvent | null;
     hasPreSelectedContext: boolean;
-    checkoutRecovery: boolean;
-    startCheckoutRecovery: () => void;
     step: RegistrationStep;
     setStep: (nextStep: RegistrationStep) => void;
     selectedEvent: RegistrationEvent | null;
@@ -147,6 +145,11 @@ export declare function useEventRegistrationWizard(options: UseEventRegistration
     discountContext: import("../../api").DiscountContext | null;
     shouldShowDiscountToggle: boolean;
     verification: import("./useEventRegistrationStripeReturn").EventRegistrationStripeReturnResult;
+    paymentStatusRecovery: import("./types").PaymentStatusRecoveryState | null;
+    handleCheckPaymentStatus: () => void;
+    handleContinueExistingPayment: () => void;
+    handleReturnToPayment: () => void;
+    handleReturnToBooking: () => void;
     handleDetailsComplete: () => Promise<EventRegistrationDetailsCompleteResult>;
     handlePaymentSelect: () => Promise<void>;
     handleUseCardInsteadOfPass: () => void;
@@ -177,8 +180,6 @@ export declare function useEventRegistrationWizardWithDeps(options: UseEventRegi
     scopedEvents: RegistrationEvent[];
     preSelectedEvent: RegistrationEvent | null;
     hasPreSelectedContext: boolean;
-    checkoutRecovery: boolean;
-    startCheckoutRecovery: () => void;
     step: RegistrationStep;
     setStep: (nextStep: RegistrationStep) => void;
     selectedEvent: RegistrationEvent | null;
@@ -273,6 +274,11 @@ export declare function useEventRegistrationWizardWithDeps(options: UseEventRegi
     discountContext: import("../../api").DiscountContext | null;
     shouldShowDiscountToggle: boolean;
     verification: import("./useEventRegistrationStripeReturn").EventRegistrationStripeReturnResult;
+    paymentStatusRecovery: import("./types").PaymentStatusRecoveryState | null;
+    handleCheckPaymentStatus: () => void;
+    handleContinueExistingPayment: () => void;
+    handleReturnToPayment: () => void;
+    handleReturnToBooking: () => void;
     handleDetailsComplete: () => Promise<EventRegistrationDetailsCompleteResult>;
     handlePaymentSelect: () => Promise<void>;
     handleUseCardInsteadOfPass: () => void;

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

@@ -0,0 +1,23 @@
+import { type Dispatch, type SetStateAction } from 'react';
+import type { BlockApiClient } from '../../api/client';
+import type { EventRegistrationStatusReference } from '../../api/types';
+import type { PaymentStatusRecoveryState, RegistrationResult, RegistrationStep } from './types';
+type PaymentStatusSetters = Readonly<{
+    setPendingRegistrationReference: Dispatch<SetStateAction<EventRegistrationStatusReference | null>>;
+    setRegistrationResult: Dispatch<SetStateAction<RegistrationResult | null>>;
+    setOptionsRefreshKey: Dispatch<SetStateAction<number>>;
+    setStep: (step: RegistrationStep) => void;
+}>;
+type UsePaymentStatusRecoveryOptions = PaymentStatusSetters & Readonly<{
+    api: BlockApiClient;
+    beginNewSubmission: () => void;
+}>;
+export declare function usePaymentStatusRecovery(options: UsePaymentStatusRecoveryOptions): {
+    recovery: PaymentStatusRecoveryState | null;
+    showRecovery: (next: PaymentStatusRecoveryState | null) => void;
+    check: () => void;
+    continuePayment: () => void;
+    returnToPayment: () => void;
+    returnToBooking: () => void;
+};
+export {};

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

@@ -59,7 +59,7 @@ export declare function getVisibleTicketTypes(input: {
     eligibility: EligibilityData | null;
     selectedAttendanceMode?: 'in_person' | 'online' | null;
 }): SelectableEventTicketType[];
-export declare function getImplicitSingleAvailableTicketType(ticketTypes: readonly SelectableEventTicketType[]): SelectableEventTicketType | null;
+export declare function getImplicitSingleTicketType(ticketTypes: readonly SelectableEventTicketType[]): SelectableEventTicketType | null;
 export declare function findSelectedTicketType(input: {
     event: TicketTypeSourceEvent | null;
     eligibility: EligibilityData | null;

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

@@ -1,12 +1,12 @@
-export type EventRegistrationErrorAction = 'none' | 'retry' | 'places' | 'start' | 'details' | 'payment-options' | 'payment-status' | 'portal' | 'event';
+export type EventRegistrationErrorAction = 'none' | 'retry' | 'places' | 'start' | 'details' | 'payment-options' | 'portal' | 'event';
 export declare const eventRegistrationErrors: {
     readonly registrationClosed: {
         readonly message: "Booking is currently closed for this event. Please contact the organiser if you’d like to find out more.";
         readonly action: "none";
     };
-    readonly paymentUncertain: {
-        readonly 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.";
-        readonly action: "payment-status";
+    readonly paymentInvestigationRequired: {
+        readonly message: "We still can’t confirm your payment. Please don’t make another payment. Contact the organiser so they can check your booking.";
+        readonly action: "none";
     };
     readonly paymentProviderUnavailable: {
         readonly message: "We couldn’t reach the payment provider. Please try again in a minute.";

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

@@ -0,0 +1,8 @@
+export declare const EVENT_CHECKOUT_HOLD_DURATION_MS: number;
+export declare const EVENT_CHECKOUT_RECOVERY_GRACE_MS: number;
+export declare function eventCheckoutProvisionalRecoverableUntil(now: Date): string;
+export declare function eventCheckoutRecoverableUntil(input: Readonly<{
+    holdExpiresAt: string;
+    sessionExpiresAtEpochSeconds: number;
+}>): string | null;
+export declare function eventCheckoutRecoveryIsDiscoverable(recoverableUntil: string, now: Date): boolean;

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

@@ -56,4 +56,5 @@ export * from './stripeMinimumCharge';
 export * from './stripeCheckoutReturnUrl';
 export * from './stateTransitions';
 export * from './event-registration-errors';
-export { STRIPE_COMMISSION_FREE_REASONS, type StripeCommissionFreeReason } from './stripeCommissionMetadata';
+export * from './eventCheckoutRecoveryWindow';
+export { STRIPE_COMMISSION_FREE_REASONS, type StripeCommissionFreeReason, } from './stripeCommissionMetadata';

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

@@ -1,18 +1,8 @@
 import { type Result } from '../../../core/src/index';
-import type { CheckoutCommitFailureStep, CheckoutCommitState, CheckoutCompensationDecision, CheckoutPaymentRail, OrderCheckoutReconciliationState, OrderItemReconciliationState, DiscountRedemptionStatus, OrderItemCommitState, OrderStatus } from './orderTypes';
+import type { CheckoutCommitFailureStep, CheckoutCompensationDecision, CheckoutPaymentRail, DiscountRedemptionStatus, OrderStatus } from './orderTypes';
 export type OrderStatusEvent = 'checkout_failed' | 'stripe_payment_completed' | 'cancel' | 'partial_refund' | 'full_refund';
 export declare function advanceOrderStatus(from: OrderStatus, event: OrderStatusEvent): Result<OrderStatus, string>;
 export declare function transitionOrderStatusTo(from: OrderStatus, to: OrderStatus): Result<OrderStatus, string>;
-export type CheckoutCommitEvent = 'start' | 'complete' | 'compensate' | 'release';
-export declare function advanceCheckoutCommitState(from: CheckoutCommitState, event: CheckoutCommitEvent): Result<CheckoutCommitState, string>;
-export declare function transitionCheckoutCommitStateTo(from: CheckoutCommitState, to: CheckoutCommitState): Result<CheckoutCommitState, string>;
-export type OrderItemCommitEvent = 'commit' | 'compensate';
-export declare function advanceOrderItemCommitState(from: OrderItemCommitState, event: OrderItemCommitEvent): Result<OrderItemCommitState, string>;
-export declare function transitionOrderItemCommitStateTo(from: OrderItemCommitState, to: OrderItemCommitState): Result<OrderItemCommitState, string>;
-export type OrderCheckoutReconciliationEvent = 'defer_settlement_evidence' | 'commit_verified_settlement' | 'mark_needed';
-export declare function advanceOrderCheckoutReconciliationState(from: OrderCheckoutReconciliationState, event: OrderCheckoutReconciliationEvent): Result<OrderCheckoutReconciliationState, string>;
-export declare function transitionOrderCheckoutReconciliationStateTo(from: OrderCheckoutReconciliationState, to: OrderCheckoutReconciliationState): Result<OrderCheckoutReconciliationState, string>;
-export declare function transitionOrderItemReconciliationStateTo(from: OrderItemReconciliationState, to: OrderItemReconciliationState): Result<OrderItemReconciliationState, string>;
 export declare function classifyCheckoutCompensationDecision(input: {
     paymentRail: CheckoutPaymentRail;
     failedStep: CheckoutCommitFailureStep;
@@ -23,8 +13,6 @@ export type DiscountRedemptionEvent = 'redeem' | 'release' | 'expire';
 export declare function advanceDiscountRedemptionStatus(from: DiscountRedemptionStatus, event: DiscountRedemptionEvent): Result<DiscountRedemptionStatus, string>;
 export declare function transitionDiscountRedemptionStatusTo(from: DiscountRedemptionStatus, to: DiscountRedemptionStatus): Result<DiscountRedemptionStatus, string>;
 export type FulfillmentClaimState = 'unclaimed' | 'claimed' | 'claimed_stale' | 'fulfilled' | 'missing';
-export type FulfillmentClaimEvent = 'claim' | 'reclaim' | 'complete' | 'release';
-export declare function advanceFulfillmentClaimState(from: FulfillmentClaimState, event: FulfillmentClaimEvent): Result<FulfillmentClaimState, string>;
 export type OrderRefundStatus = 'pending' | 'succeeded' | 'failed' | 'reconciliation_needed';
 export type OrderRefundEvent = 'succeed' | 'fail' | 'mark_reconciliation_needed';
 export declare function advanceOrderRefundStatus(from: OrderRefundStatus, event: OrderRefundEvent): Result<OrderRefundStatus, string>;