@riverbankcms/sdk 0.143.0 → 0.145.0

package/dist/_dts/blocks/src/system/manifest/schema.d.ts

@@ -10,7 +10,7 @@ export type DisplayMediaKind = (typeof DISPLAY_MEDIA_KINDS)[number];
 export declare const DEFAULT_MEDIA_FIELD_KINDS: readonly ["image"];
 export declare const PUBLIC_FILE_FIELD_KINDS: readonly ["document", "spreadsheet", "archive", "audio"];
 export type FileFieldKind = (typeof PUBLIC_FILE_FIELD_KINDS)[number];
-export declare const siteOptionSources: readonly ["eventCategories", "eventSeries", "venues", "staffMembers"];
+export declare const siteOptionSources: readonly ["eventCategories", "eventSeries", "venues", "staffMembers", "appointmentServiceCategories"];
 export type SiteOptionSource = (typeof siteOptionSources)[number];
 declare const selectOptionSchema: z.ZodObject<{
     value: z.ZodString;
@@ -27,6 +27,7 @@ declare const selectSourceSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         eventCategories: "eventCategories";
         venues: "venues";
         staffMembers: "staffMembers";
+        appointmentServiceCategories: "appointmentServiceCategories";
     }>;
 }, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<"sdk">;
@@ -210,6 +211,7 @@ declare const uiSchema: z.ZodObject<{
         eventCategories: "eventCategories";
         venues: "venues";
         staffMembers: "staffMembers";
+        appointmentServiceCategories: "appointmentServiceCategories";
     }>>>;
     searchThreshold: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
     renderInHeader: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
@@ -399,6 +401,7 @@ declare const baseFieldSchema: z.ZodObject<{
             eventCategories: "eventCategories";
             venues: "venues";
             staffMembers: "staffMembers";
+            appointmentServiceCategories: "appointmentServiceCategories";
         }>>>;
         searchThreshold: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
         renderInHeader: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
@@ -589,6 +592,7 @@ declare const textFieldSchema: z.ZodObject<{
             eventCategories: "eventCategories";
             venues: "venues";
             staffMembers: "staffMembers";
+            appointmentServiceCategories: "appointmentServiceCategories";
         }>>>;
         searchThreshold: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
         renderInHeader: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
@@ -782,6 +786,7 @@ declare const richTextFieldSchema: z.ZodObject<{
             eventCategories: "eventCategories";
             venues: "venues";
             staffMembers: "staffMembers";
+            appointmentServiceCategories: "appointmentServiceCategories";
         }>>>;
         searchThreshold: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
         renderInHeader: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
@@ -973,6 +978,7 @@ declare const inlineTextFieldSchema: z.ZodObject<{
             eventCategories: "eventCategories";
             venues: "venues";
             staffMembers: "staffMembers";
+            appointmentServiceCategories: "appointmentServiceCategories";
         }>>>;
         searchThreshold: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
         renderInHeader: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
@@ -1166,6 +1172,7 @@ declare const mediaFieldSchema: z.ZodObject<{
             eventCategories: "eventCategories";
             venues: "venues";
             staffMembers: "staffMembers";
+            appointmentServiceCategories: "appointmentServiceCategories";
         }>>>;
         searchThreshold: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
         renderInHeader: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
@@ -1366,6 +1373,7 @@ declare const fileFieldSchema: z.ZodObject<{
             eventCategories: "eventCategories";
             venues: "venues";
             staffMembers: "staffMembers";
+            appointmentServiceCategories: "appointmentServiceCategories";
         }>>>;
         searchThreshold: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
         renderInHeader: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
@@ -1563,6 +1571,7 @@ declare const booleanFieldSchema: z.ZodObject<{
             eventCategories: "eventCategories";
             venues: "venues";
             staffMembers: "staffMembers";
+            appointmentServiceCategories: "appointmentServiceCategories";
         }>>>;
         searchThreshold: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
         renderInHeader: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
@@ -1754,6 +1763,7 @@ declare const dateFieldSchema: z.ZodObject<{
             eventCategories: "eventCategories";
             venues: "venues";
             staffMembers: "staffMembers";
+            appointmentServiceCategories: "appointmentServiceCategories";
         }>>>;
         searchThreshold: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
         renderInHeader: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
@@ -1945,6 +1955,7 @@ declare const timeFieldSchema: z.ZodObject<{
             eventCategories: "eventCategories";
             venues: "venues";
             staffMembers: "staffMembers";
+            appointmentServiceCategories: "appointmentServiceCategories";
         }>>>;
         searchThreshold: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
         renderInHeader: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
@@ -2136,6 +2147,7 @@ declare const dateTimeFieldSchema: z.ZodObject<{
             eventCategories: "eventCategories";
             venues: "venues";
             staffMembers: "staffMembers";
+            appointmentServiceCategories: "appointmentServiceCategories";
         }>>>;
         searchThreshold: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
         renderInHeader: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
@@ -2327,6 +2339,7 @@ declare const slugFieldSchema: z.ZodObject<{
             eventCategories: "eventCategories";
             venues: "venues";
             staffMembers: "staffMembers";
+            appointmentServiceCategories: "appointmentServiceCategories";
         }>>>;
         searchThreshold: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
         renderInHeader: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
@@ -2521,6 +2534,7 @@ declare const urlFieldSchema: z.ZodObject<{
             eventCategories: "eventCategories";
             venues: "venues";
             staffMembers: "staffMembers";
+            appointmentServiceCategories: "appointmentServiceCategories";
         }>>>;
         searchThreshold: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
         renderInHeader: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
@@ -2713,6 +2727,7 @@ declare const linkFieldSchema: z.ZodObject<{
             eventCategories: "eventCategories";
             venues: "venues";
             staffMembers: "staffMembers";
+            appointmentServiceCategories: "appointmentServiceCategories";
         }>>>;
         searchThreshold: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
         renderInHeader: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
@@ -2904,6 +2919,7 @@ declare const selectFieldSchema: z.ZodObject<{
             eventCategories: "eventCategories";
             venues: "venues";
             staffMembers: "staffMembers";
+            appointmentServiceCategories: "appointmentServiceCategories";
         }>>>;
         searchThreshold: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
         renderInHeader: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
@@ -2934,6 +2950,7 @@ declare const selectFieldSchema: z.ZodObject<{
             eventCategories: "eventCategories";
             venues: "venues";
             staffMembers: "staffMembers";
+            appointmentServiceCategories: "appointmentServiceCategories";
         }>;
     }, z.core.$strip>, z.ZodObject<{
         kind: z.ZodLiteral<"sdk">;
@@ -3115,6 +3132,7 @@ declare const referenceFieldSchema: z.ZodObject<{
             eventCategories: "eventCategories";
             venues: "venues";
             staffMembers: "staffMembers";
+            appointmentServiceCategories: "appointmentServiceCategories";
         }>>>;
         searchThreshold: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
         renderInHeader: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
@@ -3318,6 +3336,7 @@ declare const repeaterFieldSchema: z.ZodObject<{
             eventCategories: "eventCategories";
             venues: "venues";
             staffMembers: "staffMembers";
+            appointmentServiceCategories: "appointmentServiceCategories";
         }>>>;
         searchThreshold: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
         renderInHeader: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
@@ -3526,6 +3545,7 @@ declare const groupFieldSchema: z.ZodObject<{
             eventCategories: "eventCategories";
             venues: "venues";
             staffMembers: "staffMembers";
+            appointmentServiceCategories: "appointmentServiceCategories";
         }>>>;
         searchThreshold: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
         renderInHeader: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
@@ -3720,6 +3740,7 @@ declare const modalFieldSchema: z.ZodObject<{
             eventCategories: "eventCategories";
             venues: "venues";
             staffMembers: "staffMembers";
+            appointmentServiceCategories: "appointmentServiceCategories";
         }>>>;
         searchThreshold: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
         renderInHeader: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
@@ -3914,6 +3935,7 @@ declare const numberFieldSchema: z.ZodObject<{
             eventCategories: "eventCategories";
             venues: "venues";
             staffMembers: "staffMembers";
+            appointmentServiceCategories: "appointmentServiceCategories";
         }>>>;
         searchThreshold: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
         renderInHeader: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
@@ -4108,6 +4130,7 @@ declare const tabGroupFieldSchema: z.ZodObject<{
             eventCategories: "eventCategories";
             venues: "venues";
             staffMembers: "staffMembers";
+            appointmentServiceCategories: "appointmentServiceCategories";
         }>>>;
         searchThreshold: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
         renderInHeader: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
@@ -4312,6 +4335,7 @@ declare const presetOrCustomFieldSchema: z.ZodObject<{
             eventCategories: "eventCategories";
             venues: "venues";
             staffMembers: "staffMembers";
+            appointmentServiceCategories: "appointmentServiceCategories";
         }>>>;
         searchThreshold: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
         renderInHeader: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
@@ -4512,6 +4536,7 @@ declare const contentTypeSelectFieldSchema: z.ZodObject<{
             eventCategories: "eventCategories";
             venues: "venues";
             staffMembers: "staffMembers";
+            appointmentServiceCategories: "appointmentServiceCategories";
         }>>>;
         searchThreshold: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
         renderInHeader: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
@@ -4708,6 +4733,7 @@ declare const entryPickerFieldSchema: z.ZodObject<{
             eventCategories: "eventCategories";
             venues: "venues";
             staffMembers: "staffMembers";
+            appointmentServiceCategories: "appointmentServiceCategories";
         }>>>;
         searchThreshold: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
         renderInHeader: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
@@ -4933,8 +4959,8 @@ export declare const previewCustomizeManifestCurationSchema: z.ZodObject<{
 export type PreviewCustomizeManifestCuration = z.infer<typeof previewCustomizeManifestCurationSchema>;
 export declare const blockCategoryEnum: z.ZodEnum<{
     content: "content";
-    media: "media";
     layout: "layout";
+    media: "media";
     marketing: "marketing";
     blog: "blog";
     interactive: "interactive";
@@ -5050,8 +5076,8 @@ export declare const manifestSchema: z.ZodObject<{
     }, z.core.$strip>>>>;
     category: z.ZodOptional<z.ZodEnum<{
         content: "content";
-        media: "media";
         layout: "layout";
+        media: "media";
         marketing: "marketing";
         blog: "blog";
         interactive: "interactive";

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> {

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;