@riverbankcms/sdk 0.142.0 → 0.144.0

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

@@ -2,7 +2,7 @@ import type { DirectCheckoutCollectionOptionKind, PaymentMethod } from '../../ap
 import type { EventRegistrationErrorAction } from '../../../../../../commerce/src/purchase/index';
 import type { EventRegistrationDirectPaymentOption, EventRegistrationDirectPaymentSelectionState } from './eventPaymentOptions';
 import type { EventRegistrationPageSurfaceSubject } from './eventScope';
-import type { EligibilityData, EventTicketSelectionLine, FormData, Guest, GuestErrors, OccurrenceContext, PaymentSelection, PaymentStepState, PublicEvent, RegistrationEvent, RegistrationResult } from './types';
+import type { EligibilityData, EventTicketSelectionLine, FormData, Guest, GuestErrors, OccurrenceContext, PaymentSelection, PaymentStatusRecoveryState, PaymentStepState, PublicEvent, RegistrationEvent, RegistrationResult } from './types';
 import type { SelectableEventTicketType } from './utils';
 import type { BlockButtonRole } from '../../../constants/buttonRoles';
 import type { PortalAuthState, PortalProfile } from './hooks';
@@ -44,6 +44,9 @@ export type EventRegistrationFlowStatus = Readonly<{
     tag: 'verifying-payment';
 }> | Readonly<{
     tag: 'verifying-timeout';
+}> | Readonly<{
+    tag: 'payment-status';
+    state: PaymentStatusRecoveryState;
 }> | Readonly<{
     tag: 'payment-failed';
     message: string;
@@ -66,6 +69,9 @@ export type EventRegistrationFlowView = Readonly<{
 }> | Readonly<{
     kind: 'verifying';
     message: string;
+}> | Readonly<{
+    kind: 'payment-status';
+    state: PaymentStatusRecoveryState;
 }> | Readonly<{
     kind: 'success';
     result: RegistrationResult;
@@ -191,6 +197,7 @@ export type EventRegistrationTerminalModel = Readonly<{
     result: RegistrationResult | null;
     errorMessage: string;
     verification: UseEventRegistrationWizardResult['verification'];
+    paymentStatusRecovery: PaymentStatusRecoveryState | null;
 }>;
 export type EventRegistrationFlowActions = Readonly<{
     selectEvent: (event: RegistrationEvent) => void;
@@ -210,6 +217,10 @@ export type EventRegistrationFlowActions = Readonly<{
     back: () => void;
     submit: (options?: EventRegistrationSubmitOptions) => Promise<EventRegistrationSubmitResult>;
     retry: () => void;
+    checkPaymentStatus: () => void;
+    continueExistingPayment: () => void;
+    returnToPayment: () => void;
+    returnToBooking: () => void;
 }>;
 export type HeadlessEventRegistrationFlow = Readonly<{
     status: EventRegistrationFlowStatus;
@@ -251,6 +262,7 @@ export type EventRegistrationOverridePropsLike = Readonly<{
     apiBaseUrl?: string;
     portalToken?: string | null;
     previewToken?: string | null;
+    readAuthority?: import('../../api').BrowserReadAuthority;
     stage?: 'preview' | 'published';
     occurrenceContext?: OccurrenceContext | null;
     subject?: unknown;
@@ -261,6 +273,7 @@ export type EventRegistrationOverrideInput = Readonly<{
     apiBaseUrl: string;
     portalToken: string | null;
     previewToken: string | null;
+    readAuthority?: import('../../api').BrowserReadAuthority;
     stage?: 'preview' | 'published';
     occurrenceContext?: OccurrenceContext | null;
     subject?: EventRegistrationPageSurfaceSubject | null;

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

@@ -1,10 +1,11 @@
-import type { BlockApiConfig } from '../../api';
+import { type BlockApiConfig, type BrowserReadAuthority } from '../../api';
 import type { EventRegistrationOverrideInputResult, EventRegistrationOverridePropsLike } from './event-registration.headless.contract';
 export declare function createEventRegistrationBlockApiConfig(input: Readonly<{
     siteId: string;
     apiBaseUrl: string;
     portalToken?: string | null;
     previewToken?: string | null;
+    readAuthority?: BrowserReadAuthority;
     stage?: 'preview' | 'published';
 }>): BlockApiConfig;
 export declare function getEventRegistrationOverrideInput(props: EventRegistrationOverridePropsLike): EventRegistrationOverrideInputResult;

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

@@ -10,8 +10,8 @@ export declare function resolveEventRegistrationSubmitPlan(input: Readonly<{
     eventRequiresPayment: boolean;
     canJoinWaitlist?: boolean | null;
 }>): EventRegistrationSubmitPlan;
-export declare function resolveHeadlessEventRegistrationStatus(wizard: Pick<UseEventRegistrationWizardResult, 'step' | 'registrationResult' | 'errorMessage'> & Partial<Pick<UseEventRegistrationWizardResult, 'errorAction'>>): EventRegistrationFlowStatus;
-export declare function resolveHeadlessEventRegistrationView(wizard: Readonly<Pick<UseEventRegistrationWizardResult, 'step' | 'scopedEvents' | 'occurrenceContext' | 'registrationResult' | 'errorMessage'> & {
+export declare function resolveHeadlessEventRegistrationStatus(wizard: Pick<UseEventRegistrationWizardResult, 'step' | 'registrationResult' | 'errorMessage'> & Partial<Pick<UseEventRegistrationWizardResult, 'errorAction' | 'paymentStatusRecovery'>>): EventRegistrationFlowStatus;
+export declare function resolveHeadlessEventRegistrationView(wizard: Readonly<Pick<UseEventRegistrationWizardResult, 'step' | 'scopedEvents' | 'occurrenceContext' | 'registrationResult' | 'errorMessage'> & Partial<Pick<UseEventRegistrationWizardResult, 'paymentStatusRecovery'>> & {
     api: Pick<UseEventRegistrationWizardResult['api'], 'config'>;
 }>): EventRegistrationFlowView;
 export declare function deriveEventRegistrationSteps(input: Readonly<{

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

@@ -1,4 +1,5 @@
 import type { EligibilityData } from './types';
+export declare function isSelectionSoldOut(availability: EligibilityData['availability'] | undefined): boolean;
 export declare function resolveRegistrationAvailabilityBlocker(input: Readonly<{
     hasWaitlistClaim: boolean;
     eligibility: EligibilityData | null;
@@ -9,7 +10,3 @@ export declare function resolvePricingSelectionBlocker(input: Readonly<{
     hasValidSelection: boolean;
     slidingScaleSelectionMessage: string | null;
 }>): string | null;
-export declare function isSoldOutWithoutWaitlist(input: Readonly<{
-    hasWaitlistClaim: boolean;
-    eligibility: EligibilityData | null;
-}>): boolean;

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

@@ -4,6 +4,18 @@ export type RegistrationTarget = Readonly<{
     subject: RegistrationSubject;
     selectedEventId: string | null;
 }>;
+/** Public requests share subject identity without copying the run's display sessions. */
+export declare function toRegistrationRequestSubject(subject: RegistrationSubject, attendanceMode: 'in_person' | 'online' | null | undefined): {
+    kind: "occurrence";
+    occurrenceId: string;
+    attendanceMode: "in_person" | "online" | undefined;
+    eventSeriesId?: undefined;
+} | {
+    kind: "wholeSeries";
+    eventSeriesId: string;
+    attendanceMode: "in_person" | "online" | undefined;
+    occurrenceId?: undefined;
+};
 export declare function eventMatchesOccurrenceId(event: Pick<RegistrationEvent, 'selectionId' | 'registrationSubject'>, occurrenceId: string): boolean;
 export declare function findEventByOccurrenceId(events: readonly RegistrationEvent[], occurrenceId: string): RegistrationEvent | null;
 export declare function findPreSelectedEvent(input: Readonly<{

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

@@ -15,7 +15,7 @@ export declare function resetRegistrationAfterExpiry(input: Readonly<{
     setErrorMessage: (message: string) => void;
     setPendingRegistrationReference: (reference: EventRegistrationStatusReference | null) => void;
 }>): void;
-/** Recovery never starts another payment. Unknown payment outcomes go to the portal. */
+/** Retry the retained submission in place; explicit payment uncertainty stays status-only. */
 export declare function recoverRegistrationError(action: EventRegistrationErrorAction, handlers: Readonly<{
     canJoinWaitlist?: boolean;
     refreshOptions: () => void;

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

@@ -17,6 +17,7 @@ type PendingRegistrationV5 = {
     formData: FormData;
     ticketSelections: EventTicketSelectionLine[];
     selectedEventId: string | null;
+    eventSeriesId?: string | null;
     selectedAttendanceMode?: 'in_person' | 'online' | null;
     paymentSelection: PaymentSelection & {
         method: Exclude<PaymentSelection['method'], null>;

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

@@ -1,4 +1,7 @@
 import type { EventTicketSelectionLine } from './types';
+import type { PublicEventPricingOptionAvailability } from '../../../../../../core/src/index';
+/** Ticket selection requests a quote; only the server admits a booking. */
+export declare function canRequestTicketOption(availability: PublicEventPricingOptionAvailability): boolean;
 export declare function normalizeTicketSelectionLines(lines: readonly EventTicketSelectionLine[]): EventTicketSelectionLine[];
 export declare function getTicketSelectionTotal(lines: readonly EventTicketSelectionLine[]): number;
 export declare function getTicketLineQuantity(lines: readonly EventTicketSelectionLine[], pricingOptionId: string | null): number;
@@ -8,9 +11,7 @@ export declare function hasValidPricingOptionSelection(input: Readonly<{
     lines: readonly EventTicketSelectionLine[];
     visibleOptions: readonly Readonly<{
         pricingOptionId: string;
-        availability: Readonly<{
-            kind: 'available' | 'unavailable';
-        }>;
+        availability: PublicEventPricingOptionAvailability;
     }>[];
 }>): boolean;
 export declare function setTicketLineQuantity(input: Readonly<{
@@ -22,8 +23,6 @@ export declare function getTicketTypeLineMax(input: Readonly<{
     currentQuantity: number;
     totalSelectedQuantity: number;
     maxTickets: number;
-    availableSpots: number | null | undefined;
-    ticketTypeRemainingCapacity: number | null;
 }>): number;
 export type TicketSelectionSummaryLine = Readonly<{
     pricingOptionId: string | null;

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

@@ -24,7 +24,7 @@ export type GuestErrors = Record<number, {
     /** Error message for name field */
     name?: string;
 }>;
-export type RegistrationStep = 'select-event' | 'select-tickets' | 'enter-details' | 'select-payment' | 'submitting' | 'redirecting' | 'verifying-payment' | 'verifying-timeout' | 'payment-failed' | 'success' | 'error';
+export type RegistrationStep = 'select-event' | 'select-tickets' | 'enter-details' | 'select-payment' | 'submitting' | 'redirecting' | 'verifying-payment' | 'verifying-timeout' | 'payment-status' | 'payment-failed' | 'success' | 'error';
 export type RegistrationResult = {
     status: 'confirmed' | 'waitlist';
     /**
@@ -35,6 +35,14 @@ export type RegistrationResult = {
     message?: string;
     variant?: 'success' | 'info';
 };
+export type PaymentStatusRecoveryState = Readonly<{
+    subject: import('../../api/types').EventRegistrationPaymentSubject;
+}> & (Readonly<{
+    kind: 'ready' | 'checking' | 'processing' | 'temporarilyUnavailable' | 'retryAvailable' | 'assistanceRequired';
+}> | Readonly<{
+    kind: 'paymentAvailable';
+    checkoutUrl: string;
+}>);
 export type RegistrationAttendanceMode = 'in_person' | 'online';
 export type EventTicketSelectionLine = Readonly<{
     pricingOptionId: string | null;
@@ -55,8 +63,6 @@ export type EligibilityData = {
     isFree: boolean;
     /** Site credit for the authenticated registration subject, if available. */
     credit?: import('../../api').PortalCredit | null;
-    /** Whether the user has any payment/registration options available */
-    eligible: boolean;
     /** Whether the selected event/ticket type currently requires payment. */
     requiresPayment: boolean;
     /** Persisted pricing mode for the underlying event series. */
@@ -69,12 +75,6 @@ export type EligibilityData = {
     ticketLines: EventTicketLineSummary[];
     /** Public ticket types available for selection in ticket-type mode. */
     ticketTypes: readonly EventRegistrationPricingOption[];
-    /** Whether the event is currently full for the requested ticket count */
-    isFull: boolean;
-    /** Whether waitlists are enabled for this event */
-    waitlistEnabled: boolean;
-    /** Whether this registration can join the waitlist instead of paying */
-    canJoinWaitlist: boolean;
     /** Event price in cents (null if free) */
     price: number | null;
     /** Price currency code */
@@ -94,8 +94,6 @@ export type EligibilityData = {
         id: string;
         membershipName: string;
     }>;
-    /** Whether the event accepts direct payment */
-    canPayDirectly: boolean;
     /** Whether the event accepts passes */
     eventAcceptsPasses: boolean;
     /** Whether the event accepts memberships */

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

@@ -30,7 +30,7 @@ export type EventRegistrationWizardDeps = Readonly<{
     useDiscountCodeUi: typeof useDiscountCodeUi;
 }>;
 export declare function useEventRegistrationWizard(options: UseEventRegistrationWizardOptions): {
-    api: import("../../api").BlockApiClient;
+    api: import("../../api").BoundBlockApiClient;
     anchorId: string;
     occurrenceContext: {
         id: string;
@@ -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;
@@ -156,7 +159,7 @@ export declare function useEventRegistrationWizard(options: UseEventRegistration
     handleRetry: () => void;
 };
 export declare function useEventRegistrationWizardWithDeps(options: UseEventRegistrationWizardOptions, deps: EventRegistrationWizardDeps): {
-    api: import("../../api").BlockApiClient;
+    api: import("../../api").BoundBlockApiClient;
     anchorId: string;
     occurrenceContext: {
         id: string;
@@ -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/blocks/src/system/runtime/nodes/event-registration.interactive.d.ts

@@ -1,3 +1,4 @@
+import type { BrowserReadAuthority } from '../api/types';
 import type { BlockButtonRole } from '../../constants/buttonRoles';
 import type { PublicEvent } from '../../blocks/events/shared/types';
 import { type PublicMembershipProductCollection, type PublicPassProductCollection } from '../../blocks/shop.shared';
@@ -15,6 +16,7 @@ export type EventRegistrationSourceProps = Readonly<{
     apiBaseUrl?: string;
     portalToken?: string | null;
     previewToken?: string | null;
+    readAuthority?: BrowserReadAuthority;
     occurrenceContext?: OccurrenceContext | null;
     subject?: EventRegistrationPageSurfaceSubject | null;
     events?: PublicEvent[] | null;
@@ -58,6 +60,7 @@ type EventRegistrationIslandMeta = Readonly<{
     apiBaseUrl?: string;
     portalToken?: string | null;
     previewToken?: string | null;
+    readAuthority?: BrowserReadAuthority;
     stage?: 'preview' | 'published';
 }>;
 export declare function buildEventRegistrationDisplayFromScopedEvents(source: EventRegistrationSourceProps, scopedSourceEvents: readonly PublicEvent[]): EventRegistrationDisplay;
@@ -69,6 +72,7 @@ export declare const eventRegistrationBlockRuntime: Readonly<{
         apiBaseUrl?: string;
         portalToken?: string | null;
         previewToken?: string | null;
+        readAuthority?: BrowserReadAuthority;
         occurrenceContext?: OccurrenceContext | null;
         subject?: EventRegistrationPageSurfaceSubject | null;
         events?: PublicEvent[] | null;
@@ -105,6 +109,7 @@ export declare const eventRegistrationBlockRuntime: Readonly<{
                 apiBaseUrl?: string;
                 portalToken?: string | null;
                 previewToken?: string | null;
+                readAuthority?: BrowserReadAuthority;
                 occurrenceContext?: OccurrenceContext | null;
                 subject?: EventRegistrationPageSurfaceSubject | null;
                 events?: PublicEvent[] | null;
@@ -134,6 +139,7 @@ export declare const eventRegistrationBlockRuntime: Readonly<{
                 apiBaseUrl?: string;
                 portalToken?: string | null;
                 previewToken?: string | null;
+                readAuthority?: BrowserReadAuthority;
                 occurrenceContext?: OccurrenceContext | null;
                 subject?: EventRegistrationPageSurfaceSubject | null;
                 events?: PublicEvent[] | null;
@@ -181,6 +187,7 @@ export declare const eventRegistrationInteractiveIslandPropsCodec: Readonly<{
         apiBaseUrl?: string;
         portalToken?: string | null;
         previewToken?: string | null;
+        readAuthority?: BrowserReadAuthority;
         stage?: "preview" | "published";
     }> & {
         renderKind: "client-owned";
@@ -198,6 +205,7 @@ export declare const eventRegistrationInteractiveIslandPropsCodec: Readonly<{
         apiBaseUrl?: string;
         portalToken?: string | null;
         previewToken?: string | null;
+        readAuthority?: BrowserReadAuthority;
         stage?: "preview" | "published";
     }> & {
         renderKind: "client-owned";

package/dist/_dts/blocks/src/system/runtime/nodes/events/EventCalendar.interactive.d.ts

@@ -1,3 +1,4 @@
+import type { BrowserReadAuthority } from "../../api/types";
 import type { DisplayMode, EventLayout } from "../../../blocks/events/shared/types";
 import { type InteractiveIslandProps } from "../../../../contracts/islands";
 import type { EventListingDisplay, EventListingInteractiveIslandProps } from "./EventListing.interactive";
@@ -36,6 +37,7 @@ export type EventCalendarHydration = EventCollectionHydration;
 type EventCalendarIslandMeta = Readonly<{
     siteId: string;
     apiBaseUrl?: string;
+    readAuthority?: BrowserReadAuthority;
     stage?: "preview" | "published";
 }>;
 export declare function buildEventCalendarDisplay(source: EventCalendarSourceProps): EventCalendarDisplay;
@@ -52,7 +54,6 @@ export declare const eventCalendarBlockRuntime: Readonly<{
         hydration: Readonly<{
             calendarWindow?: import("../../../../contracts").CalendarWindowPage;
             siteId: string;
-            stage?: "preview" | "published";
             prefetchedEvents: boolean;
             eventSurface: import("../../..").EventSurfaceScope;
             filterEventPresets: string | null;
@@ -78,7 +79,6 @@ export declare const eventCalendarBlockRuntime: Readonly<{
                 hydration: Readonly<{
                     calendarWindow?: import("../../../../contracts").CalendarWindowPage;
                     siteId: string;
-                    stage?: "preview" | "published";
                     prefetchedEvents: boolean;
                     eventSurface: import("../../..").EventSurfaceScope;
                     filterEventPresets: string | null;
@@ -98,7 +98,6 @@ export declare const eventCalendarBlockRuntime: Readonly<{
                 hydration: Readonly<{
                     calendarWindow?: import("../../../../contracts").CalendarWindowPage;
                     siteId: string;
-                    stage?: "preview" | "published";
                     prefetchedEvents: boolean;
                     eventSurface: import("../../..").EventSurfaceScope;
                     filterEventPresets: string | null;
@@ -120,6 +119,7 @@ export declare const eventCalendarInteractiveIslandPropsCodec: Readonly<{
     encode: (value: Readonly<Readonly<{
         siteId: string;
         apiBaseUrl?: string;
+        readAuthority?: BrowserReadAuthority;
         stage?: "preview" | "published";
     }> & {
         renderKind: "progressive";
@@ -130,7 +130,6 @@ export declare const eventCalendarInteractiveIslandPropsCodec: Readonly<{
             hydration: Readonly<{
                 calendarWindow?: import("../../../../contracts").CalendarWindowPage;
                 siteId: string;
-                stage?: "preview" | "published";
                 prefetchedEvents: boolean;
                 eventSurface: import("../../..").EventSurfaceScope;
                 filterEventPresets: string | null;
@@ -149,6 +148,7 @@ export declare const eventCalendarInteractiveIslandPropsCodec: Readonly<{
     decode: (input: unknown) => import("../../../../contracts").DecodeResult<Readonly<Readonly<{
         siteId: string;
         apiBaseUrl?: string;
+        readAuthority?: BrowserReadAuthority;
         stage?: "preview" | "published";
     }> & {
         renderKind: "progressive";
@@ -159,7 +159,6 @@ export declare const eventCalendarInteractiveIslandPropsCodec: Readonly<{
             hydration: Readonly<{
                 calendarWindow?: import("../../../../contracts").CalendarWindowPage;
                 siteId: string;
-                stage?: "preview" | "published";
                 prefetchedEvents: boolean;
                 eventSurface: import("../../..").EventSurfaceScope;
                 filterEventPresets: string | null;

package/dist/_dts/blocks/src/system/runtime/nodes/events/EventCombined.client.d.ts

@@ -7,10 +7,9 @@ import type { EventCollectionHydration } from "./shared/eventCollectionContract"
 import { type CalendarDate, type CalendarViewport } from "./shared";
 import { type EventListPaginationAction, type EventPageSize } from "./shared/listOptions";
 import { type CalendarViewToggleOption } from "./shared/calendarViewOptions";
-export type EventCombinedClientProps = Readonly<{
+type EventCombinedControllerProps = Readonly<{
     events?: PublicEvent[] | null;
     siteId: string;
-    stage?: "preview" | "published";
     listLayout?: EventLayout;
     listColumns?: ColumnOption;
     eventsPerPage?: EventPageSize;
@@ -40,6 +39,12 @@ export type EventCombinedClientProps = Readonly<{
     calendarContext: EventCollectionHydration["calendarContext"];
     calendarWindow?: EventCollectionHydration["calendarWindow"];
 }>;
+/** External SDK prop shape retained at blocks/client/events; hosted controllers
+ * obtain read mode exclusively from their provider, never from this metadata. */
+export type EventCombinedClientProps = EventCombinedControllerProps & Readonly<{
+    /** @deprecated Configure browsing authority on BlockApiProvider instead. */
+    stage?: "preview" | "published";
+}>;
 export type EventCombinedIslandClientProps = EventCombinedInteractiveIslandProps;
 type EventCombinedCalendarTabProps = Readonly<{
     calendarTabViews: CalendarTabViews;