@riverbankcms/sdk 0.130.0 → 0.132.0

package/dist/_dts/blocks/src/system/runtime/nodes/booking-form.headless.state.d.ts

@@ -2,6 +2,7 @@ import type { AppointmentResourceId, AppointmentServiceId, Brand, CustomerPassId
 import type { BlockApiConfig, EligibleAppointmentPackage } from "../api/types";
 import type { TimeSlot } from "../api/types";
 import type { BookingFormConfig, BookingFormData, BookingFormField, BookingPaymentStepResolution, BookingFormServicesSource, BookingFormService, BookingSelectedCollectionOptionKind, BookingSubmissionData } from "./booking-form.state";
+import type { BookingValidationErrors } from "./booking-form.validationErrors";
 export type LoadState<T> = Readonly<{
     tag: "idle";
 }> | Readonly<{
@@ -25,10 +26,6 @@ export type BookingFlowStep = Readonly<{
     canEnter: boolean;
     canLeave: boolean;
 }>;
-export type BookingValidationErrors = Readonly<{
-    formError: string | null;
-    fieldErrors: Readonly<Record<string, string>>;
-}>;
 export type BookingFieldId = Brand<string, "BookingFieldId">;
 export declare const unsafeAsBookingFieldId: (id: string) => BookingFieldId;
 export type BookingFieldValue = string | number | boolean | readonly string[] | null;
@@ -173,6 +170,13 @@ export type BookingFlowReducerState = Readonly<{
     selectedSlot: BookingSlotView | null;
     fieldValues: Readonly<Record<string, BookingFieldValue>>;
     touchedFields: Readonly<Record<string, boolean>>;
+    /**
+     * Steps the user has tried to advance past. Step validation is derived
+     * continuously (it gates `canLeave`), but a step's errors are only ever
+     * *shown* once the step has been attempted — so a freshly mounted form is
+     * never scolded for input it has not had the chance to give yet.
+     */
+    attemptedStepIds: BookingAttemptedStepIds;
     discountCode: string;
     selectedSlidingAmountInput: string;
     selectedCollectionOptionKind?: BookingSelectedCollectionOptionKind;
@@ -200,6 +204,9 @@ export type BookingFlowEvent = Readonly<{
 }> | Readonly<{
     type: "field-touched";
     fieldId: BookingFieldId;
+}> | Readonly<{
+    type: "step-advance-attempted";
+    stepId: BookingFlowStepId;
 }> | Readonly<{
     type: "payment-option-selected";
     kind: BookingSelectedCollectionOptionKind | null;
@@ -256,6 +263,13 @@ export type BookingStepPlanItem = Readonly<{
     label: string;
     visible: boolean;
 }>;
+/**
+ * Steps the user has actually tried to advance past. Step validation is derived
+ * continuously (it gates whether a step can be left), but a step's errors are
+ * only ever *shown* once the step has been attempted — so a freshly mounted
+ * form is never scolded for input it has not had the chance to give yet.
+ */
+export type BookingAttemptedStepIds = Readonly<Partial<Record<BookingFlowStepId, boolean>>>;
 export type BookingStepValidationResult = Readonly<{
     ok: true;
 }> | Readonly<{
@@ -272,6 +286,12 @@ export type DeriveBookingFlowStepsInput = Readonly<{
     requiresServiceSelection?: boolean;
     requiresResourceSelection?: boolean;
     enableAppointmentPackages?: boolean;
+    /**
+     * Steps whose validation messaging has been earned by an advance attempt.
+     * Omitted means "none attempted yet", so callers that only need gating can
+     * keep ignoring it.
+     */
+    attemptedStepIds?: BookingAttemptedStepIds;
 }>;
 export type DerivedBookingFlowSteps = Readonly<{
     steps: readonly BookingFlowStep[];
@@ -416,10 +436,6 @@ export type AppointmentBookingOverrideInputResult = Readonly<{
     reason: "missing-site-id" | "missing-api-base-url" | "missing-form" | "missing-form-id" | "missing-services";
     message: string;
 }>;
-export declare function createEmptyBookingValidationErrors(): BookingValidationErrors;
-export declare function createFormBookingValidationError(formError: string): BookingValidationErrors;
-export declare function createFieldBookingValidationErrors(fieldErrors: Readonly<Record<string, string>>): BookingValidationErrors;
-export declare function hasBookingValidationErrors(errors: BookingValidationErrors): boolean;
 export declare function createInitialBookingFlowReducerState(input: Readonly<{
     defaultServiceId?: string;
     defaultResourceId?: string;

package/dist/_dts/blocks/src/system/runtime/nodes/booking-form.server.d.ts

@@ -8,6 +8,14 @@ type BookingFormProps = BookingFormSourceProps & Readonly<{
  * Server-safe placeholder for booking form.
  * Renders a stable shell plus the typed island envelope so hydration can attach
  * without pulling client hooks into the server graph.
+ *
+ * The island root carries mount identity only. The loading affordances — the
+ * `.rb-reg-surface` card, its `aria-busy` / `role="status"` announcement and the
+ * skeleton — live on a *child*, which the island mounter replaces wholesale when
+ * React takes over (it swaps the root's children, not the root). That keeps the
+ * card drawn exactly once after hydration, because the client wizard renders its
+ * own `.rb-reg-surface`, and leaves no stale loading state on the mounted form.
+ * `event-registration.server.tsx` follows the same shape.
  */
 export declare function BookingFormSSR({ blockId, siteId, apiBaseUrl, portalToken, formId, serviceId, resourceId, initialData, noticeMessage, requiresServiceSelection, requiresResourceSelection, shouldAutoSelectSingleResource, rebookContext, submitLabel, successMessage, form, services, spamProtectionEnabled, className, children, }: BookingFormProps): React.JSX.Element;
 export default BookingFormSSR;

package/dist/_dts/blocks/src/system/runtime/nodes/booking-form.validationErrors.d.ts

@@ -0,0 +1,17 @@
+/**
+ * The booking flow's validation vocabulary: what a step can complain about, and
+ * when the user has earned the right to be told.
+ *
+ * Split out of `booking-form.headless.state.ts` so the reducer file carries
+ * behaviour rather than this small closed value type and its constructors.
+ */
+export type BookingValidationErrors = Readonly<{
+    formError: string | null;
+    fieldErrors: Readonly<Record<string, string>>;
+}>;
+export declare function createEmptyBookingValidationErrors(): BookingValidationErrors;
+export declare function createFormBookingValidationError(formError: string): BookingValidationErrors;
+export declare function createFieldBookingValidationErrors(fieldErrors: Readonly<Record<string, string>>): BookingValidationErrors;
+export declare function hasBookingValidationErrors(errors: BookingValidationErrors): boolean;
+export declare function clearBookingFormError(errors: BookingValidationErrors): BookingValidationErrors;
+export declare function clearBookingFieldError(errors: BookingValidationErrors, fieldId: string): BookingValidationErrors;

package/dist/_dts/blocks/src/system/runtime/nodes/course-page-surface-scope.d.ts

@@ -1,4 +1,4 @@
-import { type EventPageSurfaceSubject, type EventPageSurfaceSubjectParseError } from '../../../../../core/src/index';
+import type { EventPageSurfaceSubject, EventPageSurfaceSubjectParseError } from '../../../../../core/src/index';
 import type { PublicCourse } from '../../blocks/courses/shared/types';
 export type CoursePageSurfaceScope = Readonly<{
     kind: 'absent';
@@ -10,8 +10,5 @@ export type CoursePageSurfaceScope = Readonly<{
     kind: 'unsupported';
     reason: EventPageSurfaceSubjectParseError['kind'];
 }>;
-/**
- * Resolves native course-page ownership without falling back to entry or slug
- * coincidence when a page-surface subject is present but invalid.
- */
+/** Temporary Course-block adapter over canonical Event run scoping. */
 export declare function resolveCoursePageSurfaceScope(courses: readonly PublicCourse[], subjectValue: unknown): CoursePageSurfaceScope;

package/dist/_dts/blocks/src/system/runtime/nodes/course-registration.client.d.ts

@@ -1,7 +1,9 @@
 import React from 'react';
-import type { CourseRegistrationClientProps as InternalCourseRegistrationClientProps } from './course-registration';
+import type { WholeSeriesRegistrationClientProps } from './event-registration/whole-series';
 import type { CourseRegistrationInteractiveIslandProps } from './course-registration.interactive';
-export type CourseRegistrationClientProps = InternalCourseRegistrationClientProps;
+export type CourseRegistrationClientProps = Omit<WholeSeriesRegistrationClientProps, 'runs'> & Readonly<{
+    courses?: WholeSeriesRegistrationClientProps['runs'];
+}>;
 export type CourseRegistrationIslandClientProps = CourseRegistrationInteractiveIslandProps;
 export declare function CourseRegistrationClient(props: CourseRegistrationClientProps): React.JSX.Element;
 export declare function CourseRegistrationIslandClient(props: CourseRegistrationIslandClientProps): React.JSX.Element;

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

@@ -1,6 +1,6 @@
 import type { BlockButtonRole } from '../../constants/buttonRoles';
 import type { PublicCourse } from '../../blocks/courses/shared/types';
-import type { CourseRegistrationClientProps as InternalCourseRegistrationClientProps } from './course-registration/types';
+import type { WholeSeriesRegistrationClientProps } from './event-registration/whole-series/types';
 import { type InteractiveIslandProps } from '../../../contracts/islands';
 import { type EventRegistrationPageSurfaceSubject } from './event-registration/eventScope';
 export type CourseRegistrationSourceProps = Readonly<{
@@ -27,7 +27,9 @@ export type CourseRegistrationDisplay = Readonly<{
     className: string | null;
     summaryButtonText: string;
 }>;
-export type CourseRegistrationHydration = Readonly<Omit<InternalCourseRegistrationClientProps, 'siteId' | 'stage' | 'buttonText' | 'className'>>;
+export type CourseRegistrationHydration = Readonly<Omit<WholeSeriesRegistrationClientProps, 'runs' | 'siteId' | 'stage' | 'buttonText' | 'className'> & {
+    courses?: PublicCourse[] | null;
+}>;
 type CourseRegistrationIslandMeta = Readonly<{
     siteId?: string;
     apiBaseUrl?: string;
@@ -62,7 +64,9 @@ export declare const courseRegistrationBlockRuntime: Readonly<{
             className: string | null;
             summaryButtonText: string;
         }>;
-        hydration: Readonly<Omit<InternalCourseRegistrationClientProps, "siteId" | "stage" | "className" | "buttonText">>;
+        hydration: Readonly<Omit<WholeSeriesRegistrationClientProps, "siteId" | "stage" | "className" | "buttonText" | "runs"> & {
+            courses?: PublicCourse[] | null;
+        }>;
     }>;
     contracts: Readonly<{
         source: Readonly<{
@@ -111,7 +115,9 @@ export declare const courseRegistrationBlockRuntime: Readonly<{
                     className: string | null;
                     summaryButtonText: string;
                 }>;
-                hydration: Readonly<Omit<InternalCourseRegistrationClientProps, "siteId" | "stage" | "className" | "buttonText">>;
+                hydration: Readonly<Omit<WholeSeriesRegistrationClientProps, "siteId" | "stage" | "className" | "buttonText" | "runs"> & {
+                    courses?: PublicCourse[] | null;
+                }>;
             }>) => unknown;
             decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<{
                 display: Readonly<{
@@ -120,7 +126,9 @@ export declare const courseRegistrationBlockRuntime: Readonly<{
                     className: string | null;
                     summaryButtonText: string;
                 }>;
-                hydration: Readonly<Omit<InternalCourseRegistrationClientProps, "siteId" | "stage" | "className" | "buttonText">>;
+                hydration: Readonly<Omit<WholeSeriesRegistrationClientProps, "siteId" | "stage" | "className" | "buttonText" | "runs"> & {
+                    courses?: PublicCourse[] | null;
+                }>;
             }>>;
         }>;
     }>;
@@ -142,7 +150,9 @@ export declare const courseRegistrationInteractiveIslandPropsCodec: Readonly<{
                 className: string | null;
                 summaryButtonText: string;
             }>;
-            hydration: Readonly<Omit<InternalCourseRegistrationClientProps, "siteId" | "stage" | "className" | "buttonText">>;
+            hydration: Readonly<Omit<WholeSeriesRegistrationClientProps, "siteId" | "stage" | "className" | "buttonText" | "runs"> & {
+                courses?: PublicCourse[] | null;
+            }>;
         }>>;
     }>) => unknown;
     decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<Readonly<{
@@ -161,7 +171,9 @@ export declare const courseRegistrationInteractiveIslandPropsCodec: Readonly<{
                 className: string | null;
                 summaryButtonText: string;
             }>;
-            hydration: Readonly<Omit<InternalCourseRegistrationClientProps, "siteId" | "stage" | "className" | "buttonText">>;
+            hydration: Readonly<Omit<WholeSeriesRegistrationClientProps, "siteId" | "stage" | "className" | "buttonText" | "runs"> & {
+                courses?: PublicCourse[] | null;
+            }>;
         }>>;
     }>>;
 }>;

package/dist/_dts/blocks/src/system/runtime/nodes/event-details/logic.d.ts

@@ -8,12 +8,33 @@ export type OccurrenceContextLike = {
     endsAt: string;
     timeZone: string;
 } | null;
-export type EventDetailsSelection = {
+type OrdinaryPublicEvent = PublicEvent & {
+    bookingScope: 'single_occurrence';
+};
+type WholeSeriesPublicEvent = PublicEvent & {
+    bookingScope: 'whole_series';
+};
+export type EventDetailsSelection = Readonly<{
+    kind: 'empty';
+    mode: 'next';
+    selected: null;
+    otherDates: readonly [];
+    timeZone: string;
+}> | Readonly<{
+    kind: 'ordinary';
+    mode: 'selected' | 'next';
+    selected: OrdinaryPublicEvent;
+    otherDates: OrdinaryPublicEvent[];
+    timeZone: string;
+}> | Readonly<{
+    kind: 'wholeSeries';
+    phase: 'upcoming' | 'inProgress' | 'completed';
     mode: 'selected' | 'next' | 'completed';
-    selected: PublicEvent | null;
-    otherDates: PublicEvent[];
+    selected: WholeSeriesPublicEvent;
+    otherDates: WholeSeriesPublicEvent[];
+    sessions: readonly [WholeSeriesPublicEvent, ...WholeSeriesPublicEvent[]];
     timeZone: string;
-};
+}>;
 export declare function selectEventDetails(args: {
     events: PublicEvent[] | null | undefined;
     occurrenceContext: OccurrenceContextLike | null | undefined;

package/dist/_dts/blocks/src/system/runtime/nodes/event-details/presentation.d.ts

@@ -0,0 +1,75 @@
+import type { EventAutoApplyDiscountPreview } from '../../../blocks/event-details';
+import type { PublicEvent } from '../../../blocks/events/shared/types';
+import type { PublicMembershipProductCollection, PublicPassProductCollection } from '../../../blocks/shop';
+import type { EventRegistrationPageSurfaceSubject } from '../event-registration/eventScope';
+import { type OccurrenceContextLike } from './logic';
+export type EventDetailsPresentationInput = Readonly<{
+    occurrenceContext?: OccurrenceContextLike | null;
+    subject?: EventRegistrationPageSurfaceSubject | null;
+    events?: PublicEvent[] | null;
+    showVenue?: boolean;
+    showMap?: boolean;
+    showOtherDates?: boolean;
+    otherDatesLimit?: string;
+    showCost?: boolean;
+    showTitle?: boolean;
+    showDescription?: boolean;
+    showCapacity?: boolean;
+    showAcceptedPasses?: boolean;
+    showAcceptedMemberships?: boolean;
+    sitePasses?: PublicPassProductCollection | null;
+    siteMemberships?: PublicMembershipProductCollection | null;
+    autoApplyDiscount?: EventAutoApplyDiscountPreview | null;
+    nowIso?: string;
+}>;
+export declare function resolveEventDetailsPresentation(input: EventDetailsPresentationInput): {
+    autoApplyDiscount: EventAutoApplyDiscountPreview | null;
+    applicablePasses: ({
+        purchaseAvailability: "purchasable";
+        id: string;
+        productUseCase: "event_pass" | "appointment_package";
+        name: string;
+        description: string | null;
+        price: number;
+        currency: string;
+        creditsTotal: number;
+        pricePerCredit: number;
+        validDays: number | null;
+        eligibleCategoryIds: string[];
+        eligibleCategoryNames: string[];
+    } | {
+        purchaseAvailability: "display_only";
+        unavailabilityReason: "online_payments_unavailable";
+        id: string;
+        productUseCase: "event_pass" | "appointment_package";
+        name: string;
+        description: string | null;
+        price: number;
+        currency: string;
+        creditsTotal: number;
+        pricePerCredit: number;
+        validDays: number | null;
+        eligibleCategoryIds: string[];
+        eligibleCategoryNames: string[];
+    })[];
+    applicableMemberships: {
+        id: string;
+        name: string;
+        description: string | null;
+        price: number;
+        currency: string;
+        billingInterval: "month" | "year";
+        eligibleCategoryIds: string[];
+        eligibleCategoryNames: string[];
+    }[];
+    showVenue: boolean;
+    showMap: boolean;
+    showOtherDates: boolean;
+    showCost: boolean;
+    showTitle: boolean;
+    showDescription: boolean;
+    showCapacity: boolean;
+    showAcceptedPasses: boolean;
+    showAcceptedMemberships: boolean;
+    selection: import("./logic").EventDetailsSelection;
+};

package/dist/_dts/blocks/src/system/runtime/nodes/event-details/view.d.ts

@@ -18,6 +18,9 @@ export type EventDetailsViewProps = {
     showMap: boolean;
     showOtherDates: boolean;
     showCost?: boolean;
+    showTitle?: boolean;
+    showDescription?: boolean;
+    showCapacity?: boolean;
     showAcceptedPasses?: boolean;
     showAcceptedMemberships?: boolean;
     applicablePasses?: PublicPassProduct[];
@@ -27,5 +30,5 @@ export type EventDetailsViewProps = {
     mapClassName?: string;
     renderVenueMap?: (args: RenderVenueMapArgs) => React.ReactNode;
 };
-export declare function EventDetailsView({ selection, showVenue, showMap, showOtherDates, showCost, showAcceptedPasses, showAcceptedMemberships, applicablePasses, applicableMemberships, autoApplyDiscount, mapHeight, mapClassName, renderVenueMap, }: EventDetailsViewProps): React.JSX.Element;
+export declare function EventDetailsView(props: EventDetailsViewProps): React.JSX.Element;
 export {};

package/dist/_dts/blocks/src/system/runtime/nodes/event-details.client.d.ts

@@ -4,7 +4,7 @@ import type { EventDetailsIslandProps } from '../../../contracts';
 import type { PublicEvent } from '../../blocks/events/shared/types';
 import type { EventRegistrationPageSurfaceSubject } from './event-registration/eventScope';
 import type { PublicMembershipProductCollection, PublicPassProductCollection } from '../../blocks/shop';
-import { type OccurrenceContextLike } from './event-details/logic';
+import type { OccurrenceContextLike } from './event-details/logic';
 export type EventDetailsClientProps = Readonly<{
     occurrenceContext?: OccurrenceContextLike | null;
     subject?: EventRegistrationPageSurfaceSubject | null;
@@ -14,6 +14,9 @@ export type EventDetailsClientProps = Readonly<{
     showOtherDates?: boolean;
     otherDatesLimit?: string;
     showCost?: boolean;
+    showTitle?: boolean;
+    showDescription?: boolean;
+    showCapacity?: boolean;
     showAcceptedPasses?: boolean;
     showAcceptedMemberships?: boolean;
     /** Response from listPublicPasses API. */
@@ -27,6 +30,6 @@ export type EventDetailsClientProps = Readonly<{
     children?: React.ReactNode;
 }>;
 export type EventDetailsIslandClientProps = EventDetailsIslandProps;
-export declare function EventDetailsClient({ occurrenceContext, subject, events, showVenue, showMap, showOtherDates, otherDatesLimit, showCost, showAcceptedPasses, showAcceptedMemberships, sitePasses, siteMemberships, autoApplyDiscount, className, nowIso, children, }: EventDetailsClientProps): React.JSX.Element;
+export declare function EventDetailsClient(props: EventDetailsClientProps): React.JSX.Element;
 export declare function EventDetailsIslandClient(props: EventDetailsIslandClientProps): React.JSX.Element;
 export default EventDetailsClient;

package/dist/_dts/blocks/src/system/runtime/nodes/event-details.server.d.ts

@@ -2,7 +2,7 @@ import React from 'react';
 import type { EventAutoApplyDiscountPreview } from '../../blocks/event-details';
 import type { PublicEvent } from '../../blocks/events/shared/types';
 import type { PublicMembershipProductCollection, PublicPassProductCollection } from '../../blocks/shop';
-import { type OccurrenceContextLike } from './event-details/logic';
+import type { OccurrenceContextLike } from './event-details/logic';
 type EventDetailsProps = {
     blockId?: string | null;
     occurrenceContext?: OccurrenceContextLike | null;
@@ -13,6 +13,9 @@ type EventDetailsProps = {
     showOtherDates?: boolean;
     otherDatesLimit?: string;
     showCost?: boolean;
+    showTitle?: boolean;
+    showDescription?: boolean;
+    showCapacity?: boolean;
     showAcceptedPasses?: boolean;
     showAcceptedMemberships?: boolean;
     /** Response from listPublicPasses API. */
@@ -24,5 +27,5 @@ type EventDetailsProps = {
     className?: string | null;
     children?: React.ReactNode;
 };
-export declare function EventDetailsSSR({ blockId, occurrenceContext, subject, events, showVenue, showMap, showOtherDates, otherDatesLimit, showCost, showAcceptedPasses, showAcceptedMemberships, sitePasses, siteMemberships, autoApplyDiscount, className, children, }: EventDetailsProps): React.JSX.Element;
+export declare function EventDetailsSSR(props: EventDetailsProps): React.JSX.Element;
 export default EventDetailsSSR;

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

@@ -10,6 +10,7 @@
 import React from 'react';
 import type { RegistrationEvent, OccurrenceContext, EligibilityData, PaymentSelection, PaymentStepState } from './types';
 import type { PaymentMethod } from '../../api/types';
+import type { PortalCreditState } from './hooks';
 export type { PaymentMethod };
 type PaymentSelectionStepProps = {
     event: RegistrationEvent | null;
@@ -18,6 +19,9 @@ type PaymentSelectionStepProps = {
     email: string;
     /** Whether the user is authenticated via portal bearer token */
     isAuthenticated?: boolean;
+    creditState?: PortalCreditState;
+    directPaymentTotalCents?: number;
+    manualDiscountPending?: boolean;
     /** Current canonical selection from wizard state */
     selectedSelection: PaymentSelection;
     /** Called whenever the user updates payment selection in this step */

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

@@ -0,0 +1,5 @@
+import React from 'react';
+export declare function RegistrationClosedState({ title, body, }: Readonly<{
+    title: string;
+    body: string;
+}>): React.JSX.Element;

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

@@ -0,0 +1,6 @@
+import React from 'react';
+import type { EventRegistrationSiteCreditPreview } from './siteCreditPreview';
+export declare function SiteCreditPreviewPanel(props: Readonly<{
+    preview: EventRegistrationSiteCreditPreview;
+    currency: string;
+}>): React.JSX.Element | null;

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

@@ -1,7 +1,7 @@
 import type { PaymentSelection, PublicEvent, RegistrationStep } from './types';
 import type { UseEventRegistrationWizardResult } from './useEventRegistrationWizard';
 import { type EventRegistrationFlowStatus, type EventRegistrationFlowStep, type EventRegistrationFlowView, type EventRegistrationPaymentSelection, type EventRegistrationSubmitPlan } from './event-registration.headless.contract';
-export declare function getRegistrableStatuses(isPreview: boolean | undefined): readonly PublicEvent['status'][];
+export declare function isEventRegistrationAvailable(event: Pick<PublicEvent, 'bookingAvailability'>): boolean;
 export declare function normalizeEventRegistrationMaxTickets(value: string | number | undefined): number;
 export declare function toHeadlessPaymentSelection(selection: PaymentSelection): EventRegistrationPaymentSelection;
 export declare function toInternalPaymentSelection(selection: EventRegistrationPaymentSelection): PaymentSelection;

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

@@ -8,6 +8,8 @@ type SupportedEventDirectPaymentOption = Extract<BlockBookingPaymentCollectionOp
 export type EventRegistrationDirectPaymentOption = Omit<BookingPaymentOptionViewModel, 'kind' | 'title'> & Readonly<{
     kind: Extract<DirectCheckoutCollectionOptionKind, SupportedEventDirectPaymentOption['kind']>;
     label: string;
+    totalCents: number;
+    configuredPaymentDueNowCents: number;
 }>;
 export type EventRegistrationPaymentOptionsViewModel = Readonly<{
     mode: 'single_option' | 'choice_required';

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

@@ -1,6 +1,6 @@
 import { type EventPageSurfaceSubject, type EventPageSurfaceSubjectParseError, type EventOfferingId, type EventSeriesId, type Result } from '../../../../../../core/src/index';
 import { z } from 'zod';
-export declare const unsupportedEventRegistrationPageSurfaceSubjectReasons: readonly ["unsupportedSubject", "invalidEventSeriesId", "invalidEventOfferingId"];
+export declare const unsupportedEventRegistrationPageSurfaceSubjectReasons: readonly ["unsupportedSubject", "invalidEventSeriesId", "invalidEventSeriesBookingScope", "invalidEventOfferingId"];
 export type UnsupportedEventRegistrationPageSurfaceSubjectReason = (typeof unsupportedEventRegistrationPageSurfaceSubjectReasons)[number];
 export type EventRegistrationPageSurfaceSubject = EventPageSurfaceSubject | Readonly<{
     kind: 'unsupported';

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

@@ -5,6 +5,7 @@
  * Extracted from the main EventRegistrationClient for better separation of concerns.
  */
 import { useBlockApi } from '../../api';
+import type { PortalCredit } from '../../api';
 import type { EventTicketSelectionLine } from './types';
 import { type EligibilityLookupState, type ExistingRegistrationLookupState } from './hooks.state';
 export type PortalAuthState = 'checking' | 'authenticated' | 'unauthenticated';
@@ -13,6 +14,20 @@ export type PortalProfile = {
     name: string;
     phone: string;
 };
+export type PortalCreditState = Readonly<{
+    kind: 'not_authenticated';
+}> | Readonly<{
+    kind: 'loading';
+    subjectEmail: string;
+}> | Readonly<{
+    kind: 'loaded';
+    subjectEmail: string;
+    credit: PortalCredit | null;
+}> | Readonly<{
+    kind: 'unavailable';
+    subjectEmail: string;
+}>;
+export declare function scopePortalCreditStateToSubject(state: PortalCreditState, subjectEmail: string | null): PortalCreditState;
 export type UsePortalAuthResult = {
     /** Current authentication state */
     authState: PortalAuthState;
@@ -22,6 +37,8 @@ export type UsePortalAuthResult = {
     isChecking: boolean;
     /** Portal profile data (only available when authenticated) */
     profile: PortalProfile | null;
+    /** Site credit loaded for the same authenticated portal identity. */
+    creditState: PortalCreditState;
     /** Logout function */
     logout: () => void;
 };

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

@@ -1,4 +1,4 @@
-import type { PublicCourse } from '../../../blocks/courses/shared/types';
+import type { PublicWholeSeriesOffering } from '../../../blocks/events/whole-series';
 import type { PublicEvent } from '../../../blocks/events/shared/types';
 import { type EventRegistrationPageSurfaceSubject } from './eventScope';
 export type EventRegistrationSurfacePlan = Readonly<{
@@ -6,7 +6,7 @@ export type EventRegistrationSurfacePlan = Readonly<{
     events: readonly PublicEvent[];
 }> | Readonly<{
     kind: 'wholeSeries';
-    offerings: readonly PublicCourse[];
+    offerings: readonly PublicWholeSeriesOffering[];
 }> | Readonly<{
     kind: 'unavailableWholeSeries';
 }> | Readonly<{
@@ -14,7 +14,7 @@ export type EventRegistrationSurfacePlan = Readonly<{
 }>;
 export declare function planEventRegistrationSurface(input: Readonly<{
     events: readonly PublicEvent[];
-    wholeSeriesOfferings: readonly PublicCourse[];
+    wholeSeriesOfferings: readonly PublicWholeSeriesOffering[];
     occurrenceContext?: Readonly<{
         id: string;
         seriesId: string;

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

@@ -0,0 +1,51 @@
+import type { PortalCreditState } from './hooks';
+import type { EventRegistrationDirectPaymentOption, EventRegistrationDirectPaymentSelectionState } from './eventPaymentOptions';
+export type EventRegistrationSiteCreditPreview = Readonly<{
+    kind: 'not_authenticated';
+}> | Readonly<{
+    kind: 'loading';
+}> | Readonly<{
+    kind: 'unavailable';
+}> | Readonly<{
+    kind: 'not_applicable';
+}> | Readonly<{
+    kind: 'no_credit';
+}> | Readonly<{
+    kind: 'currency_mismatch';
+    availableCreditCents: number;
+    creditCurrency: string;
+}> | Readonly<{
+    kind: 'applied';
+    outcome: 'credit_only' | 'mixed';
+    availableCreditCents: number;
+    appliedCreditCents: number;
+    cardDueNowCents: number;
+    laterBalanceCents: number;
+    remainingCreditCents: number;
+    manualDiscountPending: boolean;
+}>;
+export declare function calculateEventRegistrationPreviewTotal(input: Readonly<{
+    subtotalCents: number;
+    manualDiscountCode: string;
+    automaticDiscount?: Readonly<{
+        computedAmountCents: number;
+    }> | null;
+}>): number;
+export declare function buildEventRegistrationSiteCreditPreview(input: Readonly<{
+    option: EventRegistrationDirectPaymentOption | null;
+    currency: string;
+    creditState: PortalCreditState;
+    manualDiscountPending: boolean;
+}>): EventRegistrationSiteCreditPreview;
+export declare function buildSelectedSiteCreditPreview(input: Readonly<{
+    options: readonly EventRegistrationDirectPaymentOption[];
+    selectionState: EventRegistrationDirectPaymentSelectionState;
+    eligibility: Readonly<{
+        currency: string;
+    }> | null;
+    creditState: PortalCreditState;
+    manualDiscountPending: boolean;
+}>): EventRegistrationSiteCreditPreview;
+export declare function resolveDirectPaymentTotalCents(explicitTotalCents: number | undefined, eligibility: Readonly<{
+    price: number | null;
+}> | null): number;

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

@@ -1,7 +1,7 @@
 import type { PublicEvent, PublicEventTicketType, PublicEventTicketTypeAvailability } from '../../../blocks/events/shared/types';
 import type { OccurrenceContext } from '../../../blocks/event-registration.shared';
 import type { PublicMembershipProductCollection, PublicPassProductCollection } from '../../../blocks/shop.shared';
-import type { PublicCourse } from '../../../blocks/courses/shared/types';
+import type { PublicWholeSeriesOffering } from '../../../blocks/events/whole-series';
 import type { AvailablePass, AvailableMembership, DirectCheckoutCollectionOptionKind, EventTicketLineSummary, EligibilityEventTicketType } from '../../api/types';
 import type { EventRegistrationPageSurfaceSubject } from './eventScope';
 import type { BlockButtonRole } from '../../../constants/buttonRoles';
@@ -147,9 +147,9 @@ export type EventRegistrationClientProps = {
     subject?: EventRegistrationPageSurfaceSubject | null;
     events?: PublicEvent[] | null;
     /** Canonical whole-series runs used when the scoped Event books the full series. */
-    wholeSeriesOfferings?: PublicCourse[] | null;
+    wholeSeriesOfferings?: PublicWholeSeriesOffering[] | null;
     /** Targeted whole-series offering loaded for a native Event page surface. */
-    wholeSeriesOffering?: PublicCourse | null;
+    wholeSeriesOffering?: PublicWholeSeriesOffering | null;
     maxTickets?: string;
     showVenue?: boolean;
     showCapacity?: boolean;

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

@@ -104,6 +104,7 @@ export declare function useEventRegistrationWizard(options: UseEventRegistration
     setAltchaSolution: import("react").Dispatch<import("react").SetStateAction<string | null>>;
     portalAuthState: import("./hooks").PortalAuthState;
     portalProfile: import("./hooks").PortalProfile | null;
+    portalCreditState: import("./hooks").PortalCreditState;
     showMagicLinkModal: boolean;
     setShowMagicLinkModal: import("react").Dispatch<import("react").SetStateAction<boolean>>;
     handleLogout: () => void;
@@ -216,6 +217,7 @@ export declare function useEventRegistrationWizardWithDeps(options: UseEventRegi
     setAltchaSolution: import("react").Dispatch<import("react").SetStateAction<string | null>>;
     portalAuthState: import("./hooks").PortalAuthState;
     portalProfile: import("./hooks").PortalProfile | null;
+    portalCreditState: import("./hooks").PortalCreditState;
     showMagicLinkModal: boolean;
     setShowMagicLinkModal: import("react").Dispatch<import("react").SetStateAction<boolean>>;
     handleLogout: () => void;

package/dist/_dts/blocks/src/system/runtime/nodes/{course-registration → event-registration/whole-series}/BookingModeStep.d.ts

@@ -19,7 +19,7 @@ type BookingModeStepProps = {
     selectedMembershipId: string | null;
     /** Callback when selected membership changes */
     onMembershipSelect: (id: string | null) => void;
-    /** Course price in cents */
+    /** Run price in cents */
     priceCents: number | null;
     /** Currency code */
     currency: string;

package/dist/_dts/blocks/src/system/runtime/nodes/{course-registration → event-registration/whole-series}/CheckIcon.d.ts

@@ -1,4 +1,4 @@
 /**
  * Re-export shared CheckIcon component.
  */
-export { CheckIcon } from '../../shared';
+export { CheckIcon } from '../../../shared';