@riverbankcms/sdk 0.143.0 → 0.144.0

package/dist/_dts/blocks/src/system/runtime/components/registry.client.d.ts

@@ -228,7 +228,6 @@ export declare const runtimeBackedBlockClientEntries: {
                 }>;
                 hydration: Readonly<{
                     siteId: string;
-                    stage?: "preview" | "published";
                     eventsPerPage: import("../nodes/events/shared/listOptions").EventPageSize;
                     paginationAction: import("../nodes/events/shared/listOptions").EventListPaginationAction;
                     showFilters: boolean;
@@ -271,7 +270,6 @@ export declare const runtimeBackedBlockClientEntries: {
                         }>;
                         hydration: Readonly<{
                             siteId: string;
-                            stage?: "preview" | "published";
                             eventsPerPage: import("../nodes/events/shared/listOptions").EventPageSize;
                             paginationAction: import("../nodes/events/shared/listOptions").EventListPaginationAction;
                             showFilters: boolean;
@@ -308,7 +306,6 @@ export declare const runtimeBackedBlockClientEntries: {
                         }>;
                         hydration: Readonly<{
                             siteId: string;
-                            stage?: "preview" | "published";
                             eventsPerPage: import("../nodes/events/shared/listOptions").EventPageSize;
                             paginationAction: import("../nodes/events/shared/listOptions").EventListPaginationAction;
                             showFilters: boolean;
@@ -353,7 +350,6 @@ export declare const runtimeBackedBlockClientEntries: {
                     }>;
                     hydration: Readonly<{
                         siteId: string;
-                        stage?: "preview" | "published";
                         eventsPerPage: import("../nodes/events/shared/listOptions").EventPageSize;
                         paginationAction: import("../nodes/events/shared/listOptions").EventListPaginationAction;
                         showFilters: boolean;
@@ -396,7 +392,6 @@ export declare const runtimeBackedBlockClientEntries: {
                             }>;
                             hydration: Readonly<{
                                 siteId: string;
-                                stage?: "preview" | "published";
                                 eventsPerPage: import("../nodes/events/shared/listOptions").EventPageSize;
                                 paginationAction: import("../nodes/events/shared/listOptions").EventListPaginationAction;
                                 showFilters: boolean;
@@ -433,7 +428,6 @@ export declare const runtimeBackedBlockClientEntries: {
                             }>;
                             hydration: Readonly<{
                                 siteId: string;
-                                stage?: "preview" | "published";
                                 eventsPerPage: import("../nodes/events/shared/listOptions").EventPageSize;
                                 paginationAction: import("../nodes/events/shared/listOptions").EventListPaginationAction;
                                 showFilters: boolean;
@@ -466,7 +460,6 @@ export declare const runtimeBackedBlockClientEntries: {
                 hydration: Readonly<{
                     calendarWindow?: import("../../../contracts").CalendarWindowPage;
                     siteId: string;
-                    stage?: "preview" | "published";
                     prefetchedEvents: boolean;
                     eventSurface: import("../..").EventSurfaceScope;
                     filterEventPresets: string | null;
@@ -492,7 +485,6 @@ export declare const runtimeBackedBlockClientEntries: {
                         hydration: Readonly<{
                             calendarWindow?: import("../../../contracts").CalendarWindowPage;
                             siteId: string;
-                            stage?: "preview" | "published";
                             prefetchedEvents: boolean;
                             eventSurface: import("../..").EventSurfaceScope;
                             filterEventPresets: string | null;
@@ -512,7 +504,6 @@ export declare const runtimeBackedBlockClientEntries: {
                         hydration: Readonly<{
                             calendarWindow?: import("../../../contracts").CalendarWindowPage;
                             siteId: string;
-                            stage?: "preview" | "published";
                             prefetchedEvents: boolean;
                             eventSurface: import("../..").EventSurfaceScope;
                             filterEventPresets: string | null;
@@ -540,7 +531,6 @@ export declare const runtimeBackedBlockClientEntries: {
                     hydration: Readonly<{
                         calendarWindow?: import("../../../contracts").CalendarWindowPage;
                         siteId: string;
-                        stage?: "preview" | "published";
                         prefetchedEvents: boolean;
                         eventSurface: import("../..").EventSurfaceScope;
                         filterEventPresets: string | null;
@@ -566,7 +556,6 @@ export declare const runtimeBackedBlockClientEntries: {
                             hydration: Readonly<{
                                 calendarWindow?: import("../../../contracts").CalendarWindowPage;
                                 siteId: string;
-                                stage?: "preview" | "published";
                                 prefetchedEvents: boolean;
                                 eventSurface: import("../..").EventSurfaceScope;
                                 filterEventPresets: string | null;
@@ -586,7 +575,6 @@ export declare const runtimeBackedBlockClientEntries: {
                             hydration: Readonly<{
                                 calendarWindow?: import("../../../contracts").CalendarWindowPage;
                                 siteId: string;
-                                stage?: "preview" | "published";
                                 prefetchedEvents: boolean;
                                 eventSurface: import("../..").EventSurfaceScope;
                                 filterEventPresets: string | null;
@@ -1559,6 +1547,7 @@ export declare const runtimeBackedBlockClientEntries: {
                 apiBaseUrl?: string;
                 portalToken?: string | null;
                 previewToken?: string | null;
+                readAuthority?: import("../api").BrowserReadAuthority;
                 occurrenceContext?: import("../..").OccurrenceContext | null;
                 subject?: import("../nodes/event-registration/eventScope").EventRegistrationPageSurfaceSubject | null;
                 events?: import("../../../../../api/src/index").PublicEvent[] | null;
@@ -1594,6 +1583,7 @@ export declare const runtimeBackedBlockClientEntries: {
                         apiBaseUrl?: string;
                         portalToken?: string | null;
                         previewToken?: string | null;
+                        readAuthority?: import("../api").BrowserReadAuthority;
                         occurrenceContext?: import("../..").OccurrenceContext | null;
                         subject?: import("../nodes/event-registration/eventScope").EventRegistrationPageSurfaceSubject | null;
                         events?: import("../../../../../api/src/index").PublicEvent[] | null;
@@ -1622,6 +1612,7 @@ export declare const runtimeBackedBlockClientEntries: {
                         apiBaseUrl?: string;
                         portalToken?: string | null;
                         previewToken?: string | null;
+                        readAuthority?: import("../api").BrowserReadAuthority;
                         occurrenceContext?: import("../..").OccurrenceContext | null;
                         subject?: import("../nodes/event-registration/eventScope").EventRegistrationPageSurfaceSubject | null;
                         events?: import("../../../../../api/src/index").PublicEvent[] | null;
@@ -1672,6 +1663,7 @@ export declare const runtimeBackedBlockClientEntries: {
                     apiBaseUrl?: string;
                     portalToken?: string | null;
                     previewToken?: string | null;
+                    readAuthority?: import("../api").BrowserReadAuthority;
                     occurrenceContext?: import("../..").OccurrenceContext | null;
                     subject?: import("../nodes/event-registration/eventScope").EventRegistrationPageSurfaceSubject | null;
                     events?: import("../../../../../api/src/index").PublicEvent[] | null;
@@ -1707,6 +1699,7 @@ export declare const runtimeBackedBlockClientEntries: {
                             apiBaseUrl?: string;
                             portalToken?: string | null;
                             previewToken?: string | null;
+                            readAuthority?: import("../api").BrowserReadAuthority;
                             occurrenceContext?: import("../..").OccurrenceContext | null;
                             subject?: import("../nodes/event-registration/eventScope").EventRegistrationPageSurfaceSubject | null;
                             events?: import("../../../../../api/src/index").PublicEvent[] | null;
@@ -1735,6 +1728,7 @@ export declare const runtimeBackedBlockClientEntries: {
                             apiBaseUrl?: string;
                             portalToken?: string | null;
                             previewToken?: string | null;
+                            readAuthority?: import("../api").BrowserReadAuthority;
                             occurrenceContext?: import("../..").OccurrenceContext | null;
                             subject?: import("../nodes/event-registration/eventScope").EventRegistrationPageSurfaceSubject | null;
                             events?: import("../../../../../api/src/index").PublicEvent[] | null;
@@ -2145,6 +2139,7 @@ export declare const clientComponentRegistryEntries: {
         component: React.ComponentType<Readonly<Readonly<{
             siteId: string;
             apiBaseUrl?: string;
+            readAuthority?: import("../api").BrowserReadAuthority;
             stage?: "preview" | "published";
         }> & {
             renderKind: "progressive";
@@ -2155,7 +2150,6 @@ export declare const clientComponentRegistryEntries: {
                 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/components/runtime-backed-blocks.d.ts

@@ -128,7 +128,6 @@ export declare const runtimeBackedBlockServerEntries: {
                 }>;
                 hydration: Readonly<{
                     siteId: string;
-                    stage?: "preview" | "published";
                     eventsPerPage: import("../nodes/events/shared/listOptions").EventPageSize;
                     paginationAction: import("../nodes/events/shared/listOptions").EventListPaginationAction;
                     showFilters: boolean;
@@ -171,7 +170,6 @@ export declare const runtimeBackedBlockServerEntries: {
                         }>;
                         hydration: Readonly<{
                             siteId: string;
-                            stage?: "preview" | "published";
                             eventsPerPage: import("../nodes/events/shared/listOptions").EventPageSize;
                             paginationAction: import("../nodes/events/shared/listOptions").EventListPaginationAction;
                             showFilters: boolean;
@@ -208,7 +206,6 @@ export declare const runtimeBackedBlockServerEntries: {
                         }>;
                         hydration: Readonly<{
                             siteId: string;
-                            stage?: "preview" | "published";
                             eventsPerPage: import("../nodes/events/shared/listOptions").EventPageSize;
                             paginationAction: import("../nodes/events/shared/listOptions").EventListPaginationAction;
                             showFilters: boolean;
@@ -239,7 +236,6 @@ export declare const runtimeBackedBlockServerEntries: {
                 hydration: Readonly<{
                     calendarWindow?: import("../../../contracts").CalendarWindowPage;
                     siteId: string;
-                    stage?: "preview" | "published";
                     prefetchedEvents: boolean;
                     eventSurface: import("../..").EventSurfaceScope;
                     filterEventPresets: string | null;
@@ -265,7 +261,6 @@ export declare const runtimeBackedBlockServerEntries: {
                         hydration: Readonly<{
                             calendarWindow?: import("../../../contracts").CalendarWindowPage;
                             siteId: string;
-                            stage?: "preview" | "published";
                             prefetchedEvents: boolean;
                             eventSurface: import("../..").EventSurfaceScope;
                             filterEventPresets: string | null;
@@ -285,7 +280,6 @@ export declare const runtimeBackedBlockServerEntries: {
                         hydration: Readonly<{
                             calendarWindow?: import("../../../contracts").CalendarWindowPage;
                             siteId: string;
-                            stage?: "preview" | "published";
                             prefetchedEvents: boolean;
                             eventSurface: import("../..").EventSurfaceScope;
                             filterEventPresets: string | null;
@@ -782,6 +776,7 @@ export declare const runtimeBackedBlockServerEntries: {
                 apiBaseUrl?: string;
                 portalToken?: string | null;
                 previewToken?: string | null;
+                readAuthority?: import("../api").BrowserReadAuthority;
                 occurrenceContext?: import("../..").OccurrenceContext | null;
                 subject?: import("../nodes/event-registration/eventScope").EventRegistrationPageSurfaceSubject | null;
                 events?: import("../../../../../api/src/index").PublicEvent[] | null;
@@ -817,6 +812,7 @@ export declare const runtimeBackedBlockServerEntries: {
                         apiBaseUrl?: string;
                         portalToken?: string | null;
                         previewToken?: string | null;
+                        readAuthority?: import("../api").BrowserReadAuthority;
                         occurrenceContext?: import("../..").OccurrenceContext | null;
                         subject?: import("../nodes/event-registration/eventScope").EventRegistrationPageSurfaceSubject | null;
                         events?: import("../../../../../api/src/index").PublicEvent[] | null;
@@ -845,6 +841,7 @@ export declare const runtimeBackedBlockServerEntries: {
                         apiBaseUrl?: string;
                         portalToken?: string | null;
                         previewToken?: string | null;
+                        readAuthority?: import("../api").BrowserReadAuthority;
                         occurrenceContext?: import("../..").OccurrenceContext | null;
                         subject?: import("../nodes/event-registration/eventScope").EventRegistrationPageSurfaceSubject | null;
                         events?: import("../../../../../api/src/index").PublicEvent[] | null;

package/dist/_dts/blocks/src/system/runtime/hooks/useCalendarEvents.d.ts

@@ -23,8 +23,6 @@ type UseCalendarEventsOptions = {
     preloadMonths?: number;
     /** Block-level filters to apply to all calendar fetches */
     filters?: EventRuntimeFilters;
-    /** Fetch stage (preview vs published) */
-    stage?: 'preview' | 'published';
     calendarContext: Readonly<{
         timeZone: BookingTimeZone;
         initialToday: CalendarDate;
@@ -84,14 +82,21 @@ type UseCalendarEventCacheOptions = Readonly<{
     calendarWindow?: CalendarWindowPage;
     preloadMonths?: number;
     filters?: EventRuntimeFilters;
-    stage?: 'preview' | 'published';
     timeZone: BookingTimeZone;
 }>;
+type CalendarReadPreparation = Readonly<{
+    kind: 'ready';
+    key: string;
+}> | Readonly<{
+    kind: 'missing-site-config';
+    error: Error;
+}>;
+export declare function prepareCalendarRead(siteId: string | undefined, stage: 'preview' | 'published' | undefined, filters: EventRuntimeFilters | undefined, readProfile: CalendarReadProfile): CalendarReadPreparation;
 /**
  * The reducer owns month data and request ownership. The hook only performs I/O.
  * Requests for other months remain useful until the query context changes.
  */
-export declare function useCalendarEventCache({ readProfile, viewDate, calendarWindow, preloadMonths, filters, stage, timeZone, }: UseCalendarEventCacheOptions): Readonly<{
+export declare function useCalendarEventCache({ readProfile, viewDate, calendarWindow, preloadMonths, filters, timeZone, }: UseCalendarEventCacheOptions): Readonly<{
     events: PublicEvent[];
     loadState: CalendarViewLoadState;
     retryCurrentView: () => void;

package/dist/_dts/blocks/src/system/runtime/hooks/useCalendarEvents.state.d.ts

@@ -43,7 +43,6 @@ export type CalendarCacheAction = Readonly<{
     error: Error;
     cursor?: CalendarSourceCursor;
 }>;
-export declare function calendarMonthKey(date: CalendarDate): string;
 export declare function calendarWindowMonths(date: CalendarDate, radius: number): readonly string[];
 export declare function seedCalendarWindow(page: CalendarWindowPage): CalendarCacheState;
 export declare function planCalendarRequest(state: CalendarCacheState, months: readonly string[], retry: boolean): CalendarRequest | null;

package/dist/_dts/blocks/src/system/runtime/hooks/useEventPagination.d.ts

@@ -18,8 +18,6 @@ type UseEventPaginationOptions = {
     filters?: EventRuntimeFilters;
     /** Number of events per page */
     pageSize?: number;
-    /** Fetch stage (preview vs published) */
-    stage?: 'preview' | 'published';
 };
 type EventPaginationResult = {
     /** All loaded events */
@@ -49,5 +47,5 @@ type EventPaginationResult = {
  * ```
  */
 export declare function useEventPagination({ siteId: _siteId, // Deprecated: siteId now comes from BlockApiProvider context
-initialEvents, fetchInitialOnMount, initialFilters, filters, pageSize, stage, }: UseEventPaginationOptions): EventPaginationResult;
+initialEvents, fetchInitialOnMount, initialFilters, filters, pageSize, }: UseEventPaginationOptions): EventPaginationResult;
 export default useEventPagination;

package/dist/_dts/blocks/src/system/runtime/nodes/basic.d.ts

@@ -11,11 +11,7 @@ export type TextNodeProps = {
     children?: React.ReactNode;
 };
 export declare const TextNode: React.FC<TextNodeProps & {
-    blockId?: string;
-    blockKind?: string;
     blockContent?: unknown;
-    fragmentRegistry?: unknown;
-    pathBase?: string;
 }>;
 export type RichTextNodeProps = {
     value?: unknown;
@@ -25,20 +21,19 @@ export type RichTextNodeProps = {
     children?: React.ReactNode;
 };
 export declare const RichTextNode: React.FC<RichTextNodeProps & {
-    blockId?: string;
     blockKind?: string;
-    blockContent?: unknown;
-    fragmentRegistry?: unknown;
-    pathBase?: string;
 }>;
 export type ButtonNodeProps = {
-    value?: React.ReactNode;
+    value?: string | number;
     href?: string;
     'aria-label'?: string;
+    'data-testid'?: string;
+    /** Editor interception and explicit control handlers. */
+    onClick?: React.MouseEventHandler<HTMLElement>;
     className?: string;
     target?: string;
     rel?: string;
-    children?: React.ReactNode;
+    children?: string | number;
     /** Button variant ID (reads from theme.buttons.variants) */
     variantId?: string;
     /** Button size (reads from theme.buttons.sizes via .btn-{size}) */
@@ -55,13 +50,7 @@ export type ButtonNodeProps = {
      */
     trailingIcon?: string;
 };
-export declare const ButtonNode: React.FC<ButtonNodeProps & {
-    blockId?: string;
-    blockKind?: string;
-    blockContent?: unknown;
-    fragmentRegistry?: unknown;
-    pathBase?: string;
-}>;
+export declare const ButtonNode: React.FC<ButtonNodeProps>;
 export type LinkNodeProps = {
     href?: string;
     className?: string;
@@ -71,10 +60,4 @@ export type LinkNodeProps = {
     /** When true, hide the link if href is missing */
     linkRequired?: boolean;
 };
-export declare const LinkNode: React.FC<LinkNodeProps & {
-    blockId?: string;
-    blockKind?: string;
-    blockContent?: unknown;
-    fragmentRegistry?: unknown;
-    pathBase?: string;
-}>;
+export declare const LinkNode: React.FC<LinkNodeProps>;

package/dist/_dts/blocks/src/system/runtime/nodes/cart.server.d.ts

@@ -4,6 +4,7 @@ type CartProps = Readonly<{
     blockId?: string | null;
     siteId?: string;
     apiBaseUrl?: string;
+    readAuthority?: import('../api/types').BrowserReadAuthority;
     stage?: 'preview' | 'published';
     children?: React.ReactNode;
 }> & ShopDisplayConfig;

package/dist/_dts/blocks/src/system/runtime/nodes/checkout.server.d.ts

@@ -4,6 +4,7 @@ type CheckoutProps = Readonly<{
     blockId?: string | null;
     siteId?: string;
     apiBaseUrl?: string;
+    readAuthority?: import('../api/types').BrowserReadAuthority;
     stage?: 'preview' | 'published';
     children?: React.ReactNode;
 }> & ShopDisplayConfig;

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

@@ -1,5 +1,6 @@
 import React from 'react';
 import type { RegistrationTicketType } from './types';
+import type { ThemeButtonVariantId } from '../../../../../../theme-core/src/buttons/index';
 export declare function EventRegistrationBookingLayer(props: Readonly<{
     registrationRootClassName: string;
     portalRoot: HTMLElement | null;
@@ -9,7 +10,7 @@ export declare function EventRegistrationBookingLayer(props: Readonly<{
     availabilityLabel: string | null;
     ticketTypes: readonly RegistrationTicketType[];
     ticketCurrency: string | null;
-    buttonClass: string;
+    buttonVariant: ThemeButtonVariantId;
     formatTicketPrice: (ticketType: RegistrationTicketType) => string;
     onOpen: () => void;
     onClose: () => void;

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

@@ -1,4 +1,5 @@
 import type { UseEventRegistrationWizardResult } from './useEventRegistrationWizard';
+import type { ThemeButtonVariantId } from '../../../../../../theme-core/src/buttons/index';
 export type EventPortalAuthCopy = Readonly<{
     title: string;
     description: string;
@@ -17,7 +18,7 @@ export declare function EventRegistrationSurface(props: Readonly<{
     showCapacity: boolean;
     showSpamProtection: boolean;
     buttonText: string;
-    buttonClass: string;
+    buttonVariant: ThemeButtonVariantId;
     supportEmail?: string;
     successMessage: string;
 }>): import("react").JSX.Element;

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

@@ -1,5 +1,6 @@
 import React from 'react';
 import type { UseEventRegistrationWizardResult } from './useEventRegistrationWizard';
+import type { ThemeButtonVariantId } from '../../../../../../theme-core/src/buttons/index';
 /**
  * Label for the button that submits the details step.
  *
@@ -15,7 +16,7 @@ export declare function resolveDetailsButtonText(input: Readonly<{
 type WizardActionsProps = Readonly<{
     wizard: UseEventRegistrationWizardResult;
     buttonText: string;
-    buttonClass: string;
+    buttonVariant: ThemeButtonVariantId;
 }>;
 export declare function EventRegistrationWizardActions(props: WizardActionsProps): React.JSX.Element | null;
 export {};

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

@@ -262,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;
@@ -272,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/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;
@@ -159,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;

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;