@riverbankcms/sdk 0.143.0 → 0.144.0

package/dist/_dts/blocks/src/contracts/proof-block-islands.d.ts

@@ -181,6 +181,7 @@ export declare const proofBlockIslandCodecs: {
             apiBaseUrl?: string;
             portalToken?: string | null;
             previewToken?: string | null;
+            readAuthority?: import("../api").BrowserReadAuthority;
             stage?: "preview" | "published";
         }> & {
             renderKind: "client-owned";
@@ -198,6 +199,7 @@ export declare const proofBlockIslandCodecs: {
             apiBaseUrl?: string;
             portalToken?: string | null;
             previewToken?: string | null;
+            readAuthority?: import("../api").BrowserReadAuthority;
             stage?: "preview" | "published";
         }> & {
             renderKind: "client-owned";
@@ -263,6 +265,7 @@ export declare const proofBlockIslandCodecs: {
         encode: (value: Readonly<Readonly<{
             siteId: string;
             apiBaseUrl?: string;
+            readAuthority?: import("../api").BrowserReadAuthority;
             stage?: "preview" | "published";
         }> & {
             renderKind: "progressive";
@@ -288,7 +291,6 @@ export declare const proofBlockIslandCodecs: {
                 }>;
                 hydration: Readonly<{
                     siteId: string;
-                    stage?: "preview" | "published";
                     eventsPerPage: import("../system/runtime/nodes/events/shared/listOptions").EventPageSize;
                     paginationAction: import("../system/runtime/nodes/events/shared/listOptions").EventListPaginationAction;
                     showFilters: boolean;
@@ -309,6 +311,7 @@ export declare const proofBlockIslandCodecs: {
         decode: (input: unknown) => import("./runtime").DecodeResult<Readonly<Readonly<{
             siteId: string;
             apiBaseUrl?: string;
+            readAuthority?: import("../api").BrowserReadAuthority;
             stage?: "preview" | "published";
         }> & {
             renderKind: "progressive";
@@ -334,7 +337,6 @@ export declare const proofBlockIslandCodecs: {
                 }>;
                 hydration: Readonly<{
                     siteId: string;
-                    stage?: "preview" | "published";
                     eventsPerPage: import("../system/runtime/nodes/events/shared/listOptions").EventPageSize;
                     paginationAction: import("../system/runtime/nodes/events/shared/listOptions").EventListPaginationAction;
                     showFilters: boolean;
@@ -357,6 +359,7 @@ export declare const proofBlockIslandCodecs: {
         encode: (value: Readonly<Readonly<{
             siteId: string;
             apiBaseUrl?: string;
+            readAuthority?: import("../api").BrowserReadAuthority;
             stage?: "preview" | "published";
         }> & {
             renderKind: "progressive";
@@ -367,7 +370,6 @@ export declare const proofBlockIslandCodecs: {
                 hydration: Readonly<{
                     calendarWindow?: import(".").CalendarWindowPage;
                     siteId: string;
-                    stage?: "preview" | "published";
                     prefetchedEvents: boolean;
                     eventSurface: import("..").EventSurfaceScope;
                     filterEventPresets: string | null;
@@ -386,6 +388,7 @@ export declare const proofBlockIslandCodecs: {
         decode: (input: unknown) => import("./runtime").DecodeResult<Readonly<Readonly<{
             siteId: string;
             apiBaseUrl?: string;
+            readAuthority?: import("../api").BrowserReadAuthority;
             stage?: "preview" | "published";
         }> & {
             renderKind: "progressive";
@@ -396,7 +399,6 @@ export declare const proofBlockIslandCodecs: {
                 hydration: Readonly<{
                     calendarWindow?: import(".").CalendarWindowPage;
                     siteId: string;
-                    stage?: "preview" | "published";
                     prefetchedEvents: boolean;
                     eventSurface: import("..").EventSurfaceScope;
                     filterEventPresets: string | null;
@@ -533,6 +535,7 @@ export declare const proofBlockIslandCodecs: {
         encode: (value: Readonly<Readonly<{
             siteId?: string;
             apiBaseUrl?: string;
+            readAuthority?: import("../api").BrowserReadAuthority;
             stage?: "preview" | "published";
         }> & {
             renderKind: "progressive";
@@ -579,6 +582,7 @@ export declare const proofBlockIslandCodecs: {
         decode: (input: unknown) => import("./runtime").DecodeResult<Readonly<Readonly<{
             siteId?: string;
             apiBaseUrl?: string;
+            readAuthority?: import("../api").BrowserReadAuthority;
             stage?: "preview" | "published";
         }> & {
             renderKind: "progressive";
@@ -627,6 +631,7 @@ export declare const proofBlockIslandCodecs: {
         encode: (value: Readonly<Readonly<{
             siteId?: string;
             apiBaseUrl?: string;
+            readAuthority?: import("../api").BrowserReadAuthority;
             stage?: "preview" | "published";
         }> & {
             renderKind: "progressive";
@@ -646,6 +651,7 @@ export declare const proofBlockIslandCodecs: {
         decode: (input: unknown) => import("./runtime").DecodeResult<Readonly<Readonly<{
             siteId?: string;
             apiBaseUrl?: string;
+            readAuthority?: import("../api").BrowserReadAuthority;
             stage?: "preview" | "published";
         }> & {
             renderKind: "progressive";
@@ -667,6 +673,7 @@ export declare const proofBlockIslandCodecs: {
         encode: (value: Readonly<Readonly<{
             siteId?: string;
             apiBaseUrl?: string;
+            readAuthority?: import("../api").BrowserReadAuthority;
             stage?: "preview" | "published";
         }> & {
             renderKind: "client-owned";
@@ -701,6 +708,7 @@ export declare const proofBlockIslandCodecs: {
         decode: (input: unknown) => import("./runtime").DecodeResult<Readonly<Readonly<{
             siteId?: string;
             apiBaseUrl?: string;
+            readAuthority?: import("../api").BrowserReadAuthority;
             stage?: "preview" | "published";
         }> & {
             renderKind: "client-owned";
@@ -737,6 +745,7 @@ export declare const proofBlockIslandCodecs: {
         encode: (value: Readonly<Readonly<{
             siteId?: string;
             apiBaseUrl?: string;
+            readAuthority?: import("../api").BrowserReadAuthority;
             stage?: "preview" | "published";
         }> & {
             renderKind: "client-owned";
@@ -760,6 +769,7 @@ export declare const proofBlockIslandCodecs: {
         decode: (input: unknown) => import("./runtime").DecodeResult<Readonly<Readonly<{
             siteId?: string;
             apiBaseUrl?: string;
+            readAuthority?: import("../api").BrowserReadAuthority;
             stage?: "preview" | "published";
         }> & {
             renderKind: "client-owned";
@@ -785,6 +795,7 @@ export declare const proofBlockIslandCodecs: {
         encode: (value: Readonly<Readonly<{
             siteId?: string;
             apiBaseUrl?: string;
+            readAuthority?: import("../api").BrowserReadAuthority;
             stage?: "preview" | "published";
         }> & {
             renderKind: "progressive";
@@ -836,6 +847,7 @@ export declare const proofBlockIslandCodecs: {
         decode: (input: unknown) => import("./runtime").DecodeResult<Readonly<Readonly<{
             siteId?: string;
             apiBaseUrl?: string;
+            readAuthority?: import("../api").BrowserReadAuthority;
             stage?: "preview" | "published";
         }> & {
             renderKind: "progressive";
@@ -891,6 +903,7 @@ export declare const runtimeIslandCodecs: {
         encode: (value: Readonly<Readonly<{
             siteId: string;
             apiBaseUrl?: string;
+            readAuthority?: import("../api").BrowserReadAuthority;
             stage?: "preview" | "published";
         }> & {
             renderKind: "progressive";
@@ -901,7 +914,6 @@ export declare const runtimeIslandCodecs: {
                 hydration: Readonly<{
                     calendarWindow?: import(".").CalendarWindowPage;
                     siteId: string;
-                    stage?: "preview" | "published";
                     prefetchedEvents: boolean;
                     eventSurface: import("..").EventSurfaceScope;
                     filterEventPresets: string | null;
@@ -920,6 +932,7 @@ export declare const runtimeIslandCodecs: {
         decode: (input: unknown) => import("./runtime").DecodeResult<Readonly<Readonly<{
             siteId: string;
             apiBaseUrl?: string;
+            readAuthority?: import("../api").BrowserReadAuthority;
             stage?: "preview" | "published";
         }> & {
             renderKind: "progressive";
@@ -930,7 +943,6 @@ export declare const runtimeIslandCodecs: {
                 hydration: Readonly<{
                     calendarWindow?: import(".").CalendarWindowPage;
                     siteId: string;
-                    stage?: "preview" | "published";
                     prefetchedEvents: boolean;
                     eventSurface: import("..").EventSurfaceScope;
                     filterEventPresets: string | null;
@@ -1119,6 +1131,7 @@ export declare const runtimeIslandCodecs: {
             apiBaseUrl?: string;
             portalToken?: string | null;
             previewToken?: string | null;
+            readAuthority?: import("../api").BrowserReadAuthority;
             stage?: "preview" | "published";
         }> & {
             renderKind: "client-owned";
@@ -1136,6 +1149,7 @@ export declare const runtimeIslandCodecs: {
             apiBaseUrl?: string;
             portalToken?: string | null;
             previewToken?: string | null;
+            readAuthority?: import("../api").BrowserReadAuthority;
             stage?: "preview" | "published";
         }> & {
             renderKind: "client-owned";
@@ -1201,6 +1215,7 @@ export declare const runtimeIslandCodecs: {
         encode: (value: Readonly<Readonly<{
             siteId: string;
             apiBaseUrl?: string;
+            readAuthority?: import("../api").BrowserReadAuthority;
             stage?: "preview" | "published";
         }> & {
             renderKind: "progressive";
@@ -1226,7 +1241,6 @@ export declare const runtimeIslandCodecs: {
                 }>;
                 hydration: Readonly<{
                     siteId: string;
-                    stage?: "preview" | "published";
                     eventsPerPage: import("../system/runtime/nodes/events/shared/listOptions").EventPageSize;
                     paginationAction: import("../system/runtime/nodes/events/shared/listOptions").EventListPaginationAction;
                     showFilters: boolean;
@@ -1247,6 +1261,7 @@ export declare const runtimeIslandCodecs: {
         decode: (input: unknown) => import("./runtime").DecodeResult<Readonly<Readonly<{
             siteId: string;
             apiBaseUrl?: string;
+            readAuthority?: import("../api").BrowserReadAuthority;
             stage?: "preview" | "published";
         }> & {
             renderKind: "progressive";
@@ -1272,7 +1287,6 @@ export declare const runtimeIslandCodecs: {
                 }>;
                 hydration: Readonly<{
                     siteId: string;
-                    stage?: "preview" | "published";
                     eventsPerPage: import("../system/runtime/nodes/events/shared/listOptions").EventPageSize;
                     paginationAction: import("../system/runtime/nodes/events/shared/listOptions").EventListPaginationAction;
                     showFilters: boolean;
@@ -1295,6 +1309,7 @@ export declare const runtimeIslandCodecs: {
         encode: (value: Readonly<Readonly<{
             siteId: string;
             apiBaseUrl?: string;
+            readAuthority?: import("../api").BrowserReadAuthority;
             stage?: "preview" | "published";
         }> & {
             renderKind: "progressive";
@@ -1305,7 +1320,6 @@ export declare const runtimeIslandCodecs: {
                 hydration: Readonly<{
                     calendarWindow?: import(".").CalendarWindowPage;
                     siteId: string;
-                    stage?: "preview" | "published";
                     prefetchedEvents: boolean;
                     eventSurface: import("..").EventSurfaceScope;
                     filterEventPresets: string | null;
@@ -1324,6 +1338,7 @@ export declare const runtimeIslandCodecs: {
         decode: (input: unknown) => import("./runtime").DecodeResult<Readonly<Readonly<{
             siteId: string;
             apiBaseUrl?: string;
+            readAuthority?: import("../api").BrowserReadAuthority;
             stage?: "preview" | "published";
         }> & {
             renderKind: "progressive";
@@ -1334,7 +1349,6 @@ export declare const runtimeIslandCodecs: {
                 hydration: Readonly<{
                     calendarWindow?: import(".").CalendarWindowPage;
                     siteId: string;
-                    stage?: "preview" | "published";
                     prefetchedEvents: boolean;
                     eventSurface: import("..").EventSurfaceScope;
                     filterEventPresets: string | null;
@@ -1471,6 +1485,7 @@ export declare const runtimeIslandCodecs: {
         encode: (value: Readonly<Readonly<{
             siteId?: string;
             apiBaseUrl?: string;
+            readAuthority?: import("../api").BrowserReadAuthority;
             stage?: "preview" | "published";
         }> & {
             renderKind: "progressive";
@@ -1517,6 +1532,7 @@ export declare const runtimeIslandCodecs: {
         decode: (input: unknown) => import("./runtime").DecodeResult<Readonly<Readonly<{
             siteId?: string;
             apiBaseUrl?: string;
+            readAuthority?: import("../api").BrowserReadAuthority;
             stage?: "preview" | "published";
         }> & {
             renderKind: "progressive";
@@ -1565,6 +1581,7 @@ export declare const runtimeIslandCodecs: {
         encode: (value: Readonly<Readonly<{
             siteId?: string;
             apiBaseUrl?: string;
+            readAuthority?: import("../api").BrowserReadAuthority;
             stage?: "preview" | "published";
         }> & {
             renderKind: "progressive";
@@ -1584,6 +1601,7 @@ export declare const runtimeIslandCodecs: {
         decode: (input: unknown) => import("./runtime").DecodeResult<Readonly<Readonly<{
             siteId?: string;
             apiBaseUrl?: string;
+            readAuthority?: import("../api").BrowserReadAuthority;
             stage?: "preview" | "published";
         }> & {
             renderKind: "progressive";
@@ -1605,6 +1623,7 @@ export declare const runtimeIslandCodecs: {
         encode: (value: Readonly<Readonly<{
             siteId?: string;
             apiBaseUrl?: string;
+            readAuthority?: import("../api").BrowserReadAuthority;
             stage?: "preview" | "published";
         }> & {
             renderKind: "client-owned";
@@ -1639,6 +1658,7 @@ export declare const runtimeIslandCodecs: {
         decode: (input: unknown) => import("./runtime").DecodeResult<Readonly<Readonly<{
             siteId?: string;
             apiBaseUrl?: string;
+            readAuthority?: import("../api").BrowserReadAuthority;
             stage?: "preview" | "published";
         }> & {
             renderKind: "client-owned";
@@ -1675,6 +1695,7 @@ export declare const runtimeIslandCodecs: {
         encode: (value: Readonly<Readonly<{
             siteId?: string;
             apiBaseUrl?: string;
+            readAuthority?: import("../api").BrowserReadAuthority;
             stage?: "preview" | "published";
         }> & {
             renderKind: "client-owned";
@@ -1698,6 +1719,7 @@ export declare const runtimeIslandCodecs: {
         decode: (input: unknown) => import("./runtime").DecodeResult<Readonly<Readonly<{
             siteId?: string;
             apiBaseUrl?: string;
+            readAuthority?: import("../api").BrowserReadAuthority;
             stage?: "preview" | "published";
         }> & {
             renderKind: "client-owned";
@@ -1723,6 +1745,7 @@ export declare const runtimeIslandCodecs: {
         encode: (value: Readonly<Readonly<{
             siteId?: string;
             apiBaseUrl?: string;
+            readAuthority?: import("../api").BrowserReadAuthority;
             stage?: "preview" | "published";
         }> & {
             renderKind: "progressive";
@@ -1774,6 +1797,7 @@ export declare const runtimeIslandCodecs: {
         decode: (input: unknown) => import("./runtime").DecodeResult<Readonly<Readonly<{
             siteId?: string;
             apiBaseUrl?: string;
+            readAuthority?: import("../api").BrowserReadAuthority;
             stage?: "preview" | "published";
         }> & {
             renderKind: "progressive";

package/dist/_dts/blocks/src/pageRendererContracts.d.ts

@@ -6,6 +6,7 @@ import type { MediaAssetIndexItem, ResolveImageUrlContext, ResolveImageUrlContex
 import type { RouteMap } from './system/transforms';
 import type { BookingOfferingPresetSummary } from './system/blocks/offerings-preview/model';
 import type { BlockLoaderFailures } from './system/data/types';
+import type { BrowserReadAuthority } from './system/runtime/api/types';
 /**
  * Occurrence context for event pages.
  * Passed through to blocks that need occurrence information (e.g., event-registration).
@@ -54,6 +55,7 @@ export type BlockOverrideProps<TContent = Record<string, unknown>> = {
     portalToken?: string | null;
     /** Preview bearer token for preview-aware block runtime calls. */
     previewToken?: string | null;
+    readAuthority?: BrowserReadAuthority;
     /** Render stage for preview-aware block runtime calls. */
     stage?: 'published' | 'preview';
     /** Event-occurrence context for template-aware block overrides. */
@@ -141,6 +143,7 @@ export type PageRendererDataContext = {
     loaderFailures?: BlockLoaderFailures;
     previewStage?: 'published' | 'preview';
     previewToken?: string | null;
+    readAuthority?: BrowserReadAuthority;
     routes?: RouteMap;
     pagesByIdentifier?: Record<string, string>;
     entriesByIdentifier?: Record<string, Record<string, string>>;

package/dist/_dts/blocks/src/system/constants/events.d.ts

@@ -47,6 +47,16 @@ export declare function normalizeEventCalendarDisplayMode(input: Readonly<{
     variant?: unknown;
     displayMode?: unknown;
 }>): EventCalendarDisplayMode | undefined;
+export type EventCalendarReadPlan = Readonly<{
+    mode: EventCalendarDisplayMode;
+    jobs: 'list' | 'calendar' | 'both';
+    readProfile: 'listing-card' | 'timetable';
+}>;
+/** One closed authority for the projections required by each rendered mode. */
+export declare function resolveEventCalendarReadPlan(input: Readonly<{
+    variant?: unknown;
+    displayMode?: unknown;
+}>): EventCalendarReadPlan;
 export declare function isEventCalendarDefaultView(value: unknown): value is EventCalendarDefaultView;
 export declare function isEventCalendarListLayout(value: unknown): value is EventCalendarListLayout;
 export declare function eventCalendarListLayoutAppliesToDisplayMode(displayMode: EventCalendarDisplayMode): boolean;

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

@@ -106,5 +106,10 @@ export interface BlockApiClient {
     sendMagicLink(data: Omit<MagicLinkRequest, 'siteId'>): Promise<void>;
     logout(): Promise<void>;
 }
+/** Components use provider-owned browsing mode, never per-call stage selection. */
+export type BoundBlockApiClient = Omit<BlockApiClient, 'getPublicEvents' | 'getPublicEventCalendarWindow'> & {
+    getPublicEvents(params?: Omit<PublicEventsRequest, 'siteId' | 'stage'>): Promise<PublicEvent[]>;
+    getPublicEventCalendarWindow(params?: Omit<CalendarWindowRequest, 'stage'>): Promise<CalendarWindowPage>;
+};
 export declare function createBlockApi(config: BlockApiConfig): BlockApiClient;
 export {};

package/dist/_dts/blocks/src/system/runtime/api/context.d.ts

@@ -4,7 +4,7 @@
  * Provider and hook for accessing the Block API Client in React components.
  */
 import React from 'react';
-import { type BlockApiClient } from './client';
+import { type BlockApiClient, type BoundBlockApiClient } from './client';
 import type { BlockApiConfig } from './types';
 declare global {
     var __RIVERBANK_BLOCK_API_CONTEXT__: React.Context<BlockApiClient | null> | undefined;
@@ -62,11 +62,11 @@ export declare function BlockApiProvider({ client, config, children, }: BlockApi
  * }
  * ```
  */
-export declare function useBlockApi(): BlockApiClient;
+export declare function useBlockApi(): BoundBlockApiClient;
 /**
  * Hook to optionally access the Block API Client
  *
  * Returns null if not within a BlockApiProvider.
  * Useful for components that can work with or without the API client.
  */
-export declare function useBlockApiOptional(): BlockApiClient | null;
+export declare function useBlockApiOptional(): BoundBlockApiClient | null;

package/dist/_dts/blocks/src/system/runtime/api/endpoints.d.ts

@@ -10,6 +10,8 @@ export interface EndpointDefinition {
     method: HttpMethod;
     authScope?: EndpointAuthScope;
     skipPreviewStage?: boolean;
+    /** This existing public endpoint supports authorized draft browsing. */
+    previewRead?: true;
 }
 /**
  * Build endpoint path with parameter substitution
@@ -77,14 +79,17 @@ export declare const EVENTS: {
     calendarWindow: {
         path: string;
         method: "GET";
+        previewRead: true;
     };
     list: {
         path: string;
         method: "GET";
+        previewRead: true;
     };
     filters: {
         path: string;
         method: "GET";
+        previewRead: true;
     };
     register: {
         path: string;
@@ -125,6 +130,7 @@ export declare const SHOP: {
     listProducts: {
         path: string;
         method: "GET";
+        previewRead: true;
     };
     checkout: {
         path: string;
@@ -412,14 +418,17 @@ export declare const ENDPOINTS: {
         calendarWindow: {
             path: string;
             method: "GET";
+            previewRead: true;
         };
         list: {
             path: string;
             method: "GET";
+            previewRead: true;
         };
         filters: {
             path: string;
             method: "GET";
+            previewRead: true;
         };
         register: {
             path: string;
@@ -460,6 +469,7 @@ export declare const ENDPOINTS: {
         listProducts: {
             path: string;
             method: "GET";
+            previewRead: true;
         };
         checkout: {
             path: string;

package/dist/_dts/blocks/src/system/runtime/api/index.d.ts

@@ -40,10 +40,11 @@
  * ```
  */
 export { createBlockApi, BlockApiError } from './client';
-export type { BlockApiClient } from './client';
+export type { BlockApiClient, BoundBlockApiClient } from './client';
+export { createHostedBlockApiConfig, getBlockApiReadStage } from './readAuthority';
 export { BlockApiProvider, useBlockApi, useBlockApiOptional } from './context';
 export type { BlockApiProviderProps } from './context';
-export type { BlockApiConfig, BlockApiAuth, ApiKeyAuth, BearerAuth, NoAuth, ApiResponse, ApiSuccessResponse, ApiErrorResponse, ApiFieldError, FormSubmitRequest, FormSubmitResponse, FormConfigResponse, FormField, BookingSubmitRequest, BookingSubmitResponse, AppointmentBookingStatusRequest, AppointmentBookingStatusResponse, AvailableSlotsRequest, AvailableSlotsResponse, TimeSlot, AvailableDatesRequest, AvailableDatesResponse, BookingService, BookingServicesRequest, BookingServicesResponse, BookingServiceResponse, BookingResource, BookingResourcesRequest, BookingResourcesResponse, PublicEvent, PublicEventsRequest, PublicEventsResponse, EventVenue, AccessRestriction, EventFilterCategory, EventFilterStaffMember, EventFilterVenue, EventFiltersResponse, EventRegisterRequest, EventRegisterResponse, EventCheckoutRequest, EventCheckoutResponse, EventCheckoutReturnRequest, EventCheckoutReturnResponse, PaymentMethod, EligiblePass, EligibleMembership, AvailablePass, AvailableMembership, DiscountContext, DiscountsAvailableRequest, DiscountsAvailableResponse, DiscountApplyLine, DiscountApplyRequest, DiscountApplyRejectedReason, DiscountApplyResponse, ShopCheckoutRequest, ShopCheckoutResponse, ShopDuplicateMembershipWarning, CustomerProfile, CustomerOrder, CustomerOrderFilter, CustomerOrderItem, CustomerOrderInstalmentPlan, CustomerOrderInstalmentPlanStatus, CustomerOrderInstalmentRow, CustomerOrderInstalmentStatus, CustomerOrderPaymentState, CustomerOrderRefund, EnabledModules, PortalMeResponse, PortalMeUpdateRequest, CustomerPass, CustomerPassCreditHistoryEntry, CustomerMembership, EventTicketBreakdownLine, CustomerEventRegistration, CustomerPortalWaitlistEntry, CustomerPortalWaitlistSubject, PortalEventTicket, CustomerAppointment, AppointmentBookingQuestionsTaskDetail, BookingQuestionsTaskDetail, BookingQuestionsAnswerValue, BookingQuestionsField, BookingQuestionsFieldOption, BookingQuestionsSection, BeforeYouComeTaskSummary, CustomerEventSeriesRegistration, EventGuest, PortalCredit, PortalCreditSummary, PortalCreditTransaction, PortalCreditResponse, PortalOrderCheckoutRequest, PortalOrderCheckoutResponse, PortalDigitalProduct, PortalDigitalProductFile, PortalDigitalProductsResponse, PortalDigitalProductAccessResponse, PortalDigitalProductDownloadUrlResponse, PortalAppointmentBookingQuestionsResponse, PortalCreateAppointmentBookingQuestionsUploadUrlRequest, PortalCreateAppointmentBookingQuestionsUploadUrlResponse, PortalFinalizeAppointmentBookingQuestionsUploadRequest, PortalFinalizeAppointmentBookingQuestionsUploadResponse, PortalUpdateAppointmentBookingQuestionsRequest, PortalUpdateAppointmentBookingQuestionsResponse, PortalEventBookingQuestionsResponse, PortalCreateEventBookingQuestionsUploadUrlRequest, PortalCreateEventBookingQuestionsUploadUrlResponse, PortalFinalizeEventBookingQuestionsUploadRequest, PortalFinalizeEventBookingQuestionsUploadResponse, PortalUpdateEventBookingQuestionsRequest, PortalUpdateEventBookingQuestionsResponse, PortalWholeSeriesBookingQuestionsResponse, PortalCreateWholeSeriesBookingQuestionsUploadUrlRequest, PortalCreateWholeSeriesBookingQuestionsUploadUrlResponse, PortalFinalizeWholeSeriesBookingQuestionsUploadRequest, PortalFinalizeWholeSeriesBookingQuestionsUploadResponse, PortalUpdateWholeSeriesBookingQuestionsRequest, PortalUpdateWholeSeriesBookingQuestionsResponse, UpdateEventGuestsRequest, EventGuestsResponse, PortalCancelWholeSeriesRegistrationRequest, PortalCancelWholeSeriesRegistrationResult, PortalCancelAppointmentRequest, PortalCancelAppointmentResult, PortalCancelEventRegistrationRequest, PortalRefundInfo, PortalCancelEventRegistrationResult, PortalTransferEventRegistrationRequest, PortalTransferEventRegistrationResult, PortalRescheduleAppointmentRequest, PortalRescheduleAppointmentResponse, PortalCancelMembershipAtPeriodEndResult, MagicLinkRequest, } from './types';
+export type { BlockApiConfig, BlockApiAuth, BrowserReadAuthority, ApiKeyAuth, BearerAuth, NoAuth, ApiResponse, ApiSuccessResponse, ApiErrorResponse, ApiFieldError, FormSubmitRequest, FormSubmitResponse, FormConfigResponse, FormField, BookingSubmitRequest, BookingSubmitResponse, AppointmentBookingStatusRequest, AppointmentBookingStatusResponse, AvailableSlotsRequest, AvailableSlotsResponse, TimeSlot, AvailableDatesRequest, AvailableDatesResponse, BookingService, BookingServicesRequest, BookingServicesResponse, BookingServiceResponse, BookingResource, BookingResourcesRequest, BookingResourcesResponse, PublicEvent, PublicEventsRequest, PublicEventsResponse, EventVenue, AccessRestriction, EventFilterCategory, EventFilterStaffMember, EventFilterVenue, EventFiltersResponse, EventRegisterRequest, EventRegisterResponse, EventCheckoutRequest, EventCheckoutResponse, EventCheckoutReturnRequest, EventCheckoutReturnResponse, PaymentMethod, EligiblePass, EligibleMembership, AvailablePass, AvailableMembership, DiscountContext, DiscountsAvailableRequest, DiscountsAvailableResponse, DiscountApplyLine, DiscountApplyRequest, DiscountApplyRejectedReason, DiscountApplyResponse, ShopCheckoutRequest, ShopCheckoutResponse, ShopDuplicateMembershipWarning, CustomerProfile, CustomerOrder, CustomerOrderFilter, CustomerOrderItem, CustomerOrderInstalmentPlan, CustomerOrderInstalmentPlanStatus, CustomerOrderInstalmentRow, CustomerOrderInstalmentStatus, CustomerOrderPaymentState, CustomerOrderRefund, EnabledModules, PortalMeResponse, PortalMeUpdateRequest, CustomerPass, CustomerPassCreditHistoryEntry, CustomerMembership, EventTicketBreakdownLine, CustomerEventRegistration, CustomerPortalWaitlistEntry, CustomerPortalWaitlistSubject, PortalEventTicket, CustomerAppointment, AppointmentBookingQuestionsTaskDetail, BookingQuestionsTaskDetail, BookingQuestionsAnswerValue, BookingQuestionsField, BookingQuestionsFieldOption, BookingQuestionsSection, BeforeYouComeTaskSummary, CustomerEventSeriesRegistration, EventGuest, PortalCredit, PortalCreditSummary, PortalCreditTransaction, PortalCreditResponse, PortalOrderCheckoutRequest, PortalOrderCheckoutResponse, PortalDigitalProduct, PortalDigitalProductFile, PortalDigitalProductsResponse, PortalDigitalProductAccessResponse, PortalDigitalProductDownloadUrlResponse, PortalAppointmentBookingQuestionsResponse, PortalCreateAppointmentBookingQuestionsUploadUrlRequest, PortalCreateAppointmentBookingQuestionsUploadUrlResponse, PortalFinalizeAppointmentBookingQuestionsUploadRequest, PortalFinalizeAppointmentBookingQuestionsUploadResponse, PortalUpdateAppointmentBookingQuestionsRequest, PortalUpdateAppointmentBookingQuestionsResponse, PortalEventBookingQuestionsResponse, PortalCreateEventBookingQuestionsUploadUrlRequest, PortalCreateEventBookingQuestionsUploadUrlResponse, PortalFinalizeEventBookingQuestionsUploadRequest, PortalFinalizeEventBookingQuestionsUploadResponse, PortalUpdateEventBookingQuestionsRequest, PortalUpdateEventBookingQuestionsResponse, PortalWholeSeriesBookingQuestionsResponse, PortalCreateWholeSeriesBookingQuestionsUploadUrlRequest, PortalCreateWholeSeriesBookingQuestionsUploadUrlResponse, PortalFinalizeWholeSeriesBookingQuestionsUploadRequest, PortalFinalizeWholeSeriesBookingQuestionsUploadResponse, PortalUpdateWholeSeriesBookingQuestionsRequest, PortalUpdateWholeSeriesBookingQuestionsResponse, UpdateEventGuestsRequest, EventGuestsResponse, PortalCancelWholeSeriesRegistrationRequest, PortalCancelWholeSeriesRegistrationResult, PortalCancelAppointmentRequest, PortalCancelAppointmentResult, PortalCancelEventRegistrationRequest, PortalRefundInfo, PortalCancelEventRegistrationResult, PortalTransferEventRegistrationRequest, PortalTransferEventRegistrationResult, PortalRescheduleAppointmentRequest, PortalRescheduleAppointmentResponse, PortalCancelMembershipAtPeriodEndResult, MagicLinkRequest, } from './types';
 export { discountAvailabilityAllowsManualEntry, discountAvailabilityHasDiscounts, getAutoAppliedDiscountPreview, } from './types';
 export type { BookingQuestionsDocumentAnswerValue } from '../../../portal/types';
 export { deriveCreditProductLabels, getCreditProductCreditUnit, getCreditProductTypeLabel, getPortalCreditProductCreditNoun, } from './creditProducts';

package/dist/_dts/blocks/src/system/runtime/api/readAuthority.d.ts

@@ -0,0 +1,11 @@
+import { z } from 'zod';
+import type { BlockApiConfig, BrowserReadAuthority } from './types';
+export declare const browserReadAuthoritySchema: z.ZodType<BrowserReadAuthority>;
+/** Generic SDK/editor configuration is projected here; hosted callers supply the closed union. */
+export declare function getBlockApiReadStage(config: BlockApiConfig): 'published' | 'preview';
+export declare function createHostedBlockApiConfig(input: Readonly<{
+    baseUrl: string;
+    siteId: string;
+    readAuthority: BrowserReadAuthority;
+    portalToken?: string | null;
+}>): BlockApiConfig;

package/dist/_dts/blocks/src/system/runtime/api/types/core.d.ts

@@ -20,6 +20,13 @@ export type NoAuth = {
 };
 /** Auth strategy for Block API Client */
 export type BlockApiAuth = ApiKeyAuth | BearerAuth | NoAuth;
+/** Serializable browsing authority. Customer identity is deliberately separate. */
+export type BrowserReadAuthority = Readonly<{
+    kind: "published";
+}> | Readonly<{
+    kind: "preview";
+    token: string;
+}>;
 /** Configuration for creating a Block API Client */
 export interface BlockApiConfig {
     /** Dashboard API URL (e.g., https://dashboard.example.com/api) */
@@ -41,6 +48,8 @@ export interface BlockApiConfig {
     siteId?: string;
     /** Include draft content (adds stage=preview param) */
     isPreview?: boolean;
+    /** Bound hosted browsing authority; legacy SDK auth/stage fields cannot override it. */
+    readAuthority?: BrowserReadAuthority;
 }
 /** API success response wrapper */
 export interface ApiSuccessResponse<T> {