@riverbankcms/sdk 0.136.0 → 0.138.0

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

@@ -3,7 +3,8 @@
  *
  * Factory function for creating a typed API client for block client-side API calls.
  */
-import type { BlockApiConfig, FormSubmitRequest, FormSubmitResponse, FormConfigResponse, BookingSubmitRequest, BookingPackageSubmitRequest, BookingSubmitResponse, EligibleAppointmentPackagesResponse, AppointmentBookingStatusRequest, AppointmentBookingStatusResponse, AvailableSlotsRequest, AvailableSlotsResponse, WeeklySlotAvailabilityRequest, WeeklySlotAvailabilityResponse, AvailableDatesRequest, AvailableDatesResponse, BookingServicesResponse, BookingServiceResponse, BookingResourcesResponse, PublicEventsRequest, PublicEvent, EventFiltersResponse, EventRegisterRequest, EventRegisterResponse, EventCheckoutRequest, EventCheckoutResponse, RegistrationOptionsRequest, RegistrationOptionsResponse, EventRegistrationStatusRequest, EventRegistrationStatusResponse, EventCheckoutReturnRequest, EventCheckoutReturnResponse, ResolveWaitlistClaimRequest, ResolveWaitlistClaimResponse, DiscountsAvailableRequest, DiscountsAvailableResponse, DiscountApplyRequest, DiscountApplyResponse, PublicProductsResponse, ShopCheckoutRequest, ShopCheckoutResponse, UnifiedCheckoutRequest, UnifiedCheckoutResponse, PublicGiftingOffersResponse, CreateGiftingCheckoutRequest, CreateGiftingCheckoutResponse, ClaimGiftCardRequest, ClaimGiftCardResponse, PortalMeResponse, CustomerProfile, CustomerOrder, PortalMeUpdateRequest, CustomerPass, CustomerMembership, CustomerEventRegistration, PortalEventTicket, CustomerAppointment, BookingQuestionsTaskDetail, CustomerEventSeriesRegistration, PortalCredit, PortalOrderCheckoutRequest, PortalOrderCheckoutResponse, PortalDigitalProductAccessResponse, PortalDigitalProductDownloadUrlResponse, PortalDigitalProductsResponse, PortalCancelWholeSeriesRegistrationRequest, PortalCancelWholeSeriesRegistrationResult, PortalCancelAppointmentRequest, PortalCancelAppointmentResult, PortalUpdateAppointmentBookingQuestionsRequest, PortalUpdateWholeSeriesBookingQuestionsRequest, PortalUpdateEventBookingQuestionsRequest, PortalCancelEventRegistrationRequest, PortalCancelEventRegistrationResult, PortalTransferEventRegistrationRequest, PortalTransferEventRegistrationResult, PortalRescheduleAppointmentRequest, PortalRescheduleAppointmentResponse, PortalCancelMembershipAtPeriodEndResult, MagicLinkRequest, EventGuest, UpdateEventGuestsRequest, NewsletterSubscribeRequest, NewsletterSubscribeResponse } from './types';
+import { type CalendarWindowPage, type CalendarWindowRequest } from '../../blocks/events/shared/calendarWindow';
+import type { BlockApiConfig, ApiFieldError, FormSubmitRequest, FormSubmitResponse, FormConfigResponse, BookingSubmitRequest, BookingPackageSubmitRequest, BookingSubmitResponse, EligibleAppointmentPackagesResponse, AppointmentBookingStatusRequest, AppointmentBookingStatusResponse, AvailableSlotsRequest, AvailableSlotsResponse, WeeklySlotAvailabilityRequest, WeeklySlotAvailabilityResponse, AvailableDatesRequest, AvailableDatesResponse, BookingServicesResponse, BookingServiceResponse, BookingResourcesResponse, PublicEventsRequest, PublicEvent, EventFiltersResponse, EventRegisterRequest, EventRegisterResponse, EventCheckoutRequest, EventCheckoutResponse, RegistrationOptionsRequest, RegistrationOptionsResponse, EventRegistrationStatusRequest, EventRegistrationStatusResponse, EventCheckoutReturnRequest, EventCheckoutReturnResponse, ResolveWaitlistClaimRequest, ResolveWaitlistClaimResponse, DiscountsAvailableRequest, DiscountsAvailableResponse, DiscountApplyRequest, DiscountApplyResponse, PublicProductsResponse, ShopCheckoutRequest, ShopCheckoutResponse, UnifiedCheckoutRequest, UnifiedCheckoutResponse, PublicGiftingOffersResponse, CreateGiftingCheckoutRequest, CreateGiftingCheckoutResponse, ClaimGiftCardRequest, ClaimGiftCardResponse, PortalMeResponse, CustomerProfile, CustomerOrder, PortalMeUpdateRequest, CustomerPass, CustomerMembership, CustomerEventRegistration, PortalEventTicket, CustomerAppointment, BookingQuestionsTaskDetail, CustomerEventSeriesRegistration, PortalCredit, PortalOrderCheckoutRequest, PortalOrderCheckoutResponse, PortalDigitalProductAccessResponse, PortalDigitalProductDownloadUrlResponse, PortalDigitalProductsResponse, PortalCancelWholeSeriesRegistrationRequest, PortalCancelWholeSeriesRegistrationResult, PortalCancelAppointmentRequest, PortalCancelAppointmentResult, PortalUpdateAppointmentBookingQuestionsRequest, PortalUpdateWholeSeriesBookingQuestionsRequest, PortalUpdateEventBookingQuestionsRequest, PortalCancelEventRegistrationRequest, PortalCancelEventRegistrationResult, PortalTransferEventRegistrationRequest, PortalTransferEventRegistrationResult, PortalRescheduleAppointmentRequest, PortalRescheduleAppointmentResponse, PortalCancelMembershipAtPeriodEndResult, MagicLinkRequest, EventGuest, UpdateEventGuestsRequest, NewsletterSubscribeRequest, NewsletterSubscribeResponse } from './types';
 type WithoutSiteId<T> = T extends unknown ? Omit<T, 'siteId'> : never;
 type PublicProductCategorySelector = Readonly<{
     kind: 'category';
@@ -13,12 +14,19 @@ type PublicProductCategorySelector = Readonly<{
     productCategoryEntryId: string;
 }>;
 /**
- * Error thrown when an API request fails
+ * Error thrown when an API request fails.
+ *
+ * `fieldErrors` mirrors the envelope's `error.fieldErrors` when the response
+ * carried one, so callers can render per-field detail instead of only the
+ * top-level message. It is always an array — empty when the response had no
+ * field detail, or when what it carried was not a well-formed field error list.
  */
 export declare class BlockApiError extends Error {
     readonly status: number;
     readonly code?: string | undefined;
-    constructor(message: string, status: number, code?: string | undefined);
+    readonly tag?: string | undefined;
+    readonly fieldErrors: readonly ApiFieldError[];
+    constructor(message: string, status: number, code?: string | undefined, tag?: string | undefined, fieldErrors?: readonly ApiFieldError[]);
 }
 /**
  * Block API Client interface
@@ -44,6 +52,7 @@ export interface BlockApiClient {
         serviceId: string;
     }): Promise<BookingResourcesResponse>;
     getPublicEvents(params?: Omit<PublicEventsRequest, 'siteId'>): Promise<PublicEvent[]>;
+    getPublicEventCalendarWindow(params?: CalendarWindowRequest): Promise<CalendarWindowPage>;
     getEventFilters(params?: Pick<PublicEventsRequest, 'categoryIds' | 'venueId' | 'staffMemberId' | 'eventSurface' | 'eventPresets' | 'scheduleScope'>): Promise<EventFiltersResponse>;
     registerForEvent(data: Omit<EventRegisterRequest, 'siteId'>): Promise<EventRegisterResponse>;
     createEventCheckout(data: WithoutSiteId<EventCheckoutRequest>): Promise<EventCheckoutResponse>;

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

@@ -74,6 +74,10 @@ export declare const BOOKINGS: {
     };
 };
 export declare const EVENTS: {
+    calendarWindow: {
+        path: string;
+        method: "GET";
+    };
     list: {
         path: string;
         method: "GET";
@@ -107,10 +111,6 @@ export declare const EVENTS: {
     };
 };
 export declare const WHOLE_SERIES: {
-    list: {
-        path: string;
-        method: "GET";
-    };
     waitlistClaimResolve: {
         path: string;
         method: "POST";
@@ -405,6 +405,10 @@ export declare const ENDPOINTS: {
         };
     };
     readonly events: {
+        calendarWindow: {
+            path: string;
+            method: "GET";
+        };
         list: {
             path: string;
             method: "GET";
@@ -438,10 +442,6 @@ export declare const ENDPOINTS: {
         };
     };
     readonly wholeSeries: {
-        list: {
-            path: string;
-            method: "GET";
-        };
         waitlistClaimResolve: {
             path: string;
             method: "POST";

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

@@ -43,7 +43,7 @@ export { createBlockApi, BlockApiError } from './client';
 export type { BlockApiClient } from './client';
 export { BlockApiProvider, useBlockApi, useBlockApiOptional } from './context';
 export type { BlockApiProviderProps } from './context';
-export type { BlockApiConfig, BlockApiAuth, ApiKeyAuth, BearerAuth, NoAuth, ApiResponse, ApiSuccessResponse, ApiErrorResponse, FormSubmitRequest, FormSubmitResponse, FormConfigResponse, FormField, BookingSubmitRequest, BookingSubmitResponse, AppointmentBookingStatusRequest, AppointmentBookingStatusResponse, AvailableSlotsRequest, AvailableSlotsResponse, TimeSlot, AvailableDatesRequest, AvailableDatesResponse, BookingService, BookingServicesRequest, BookingServicesResponse, BookingServiceResponse, BookingResource, BookingResourcesRequest, BookingResourcesResponse, PublicEvent, PublicEventsRequest, PublicEventsResponse, EventVenue, PricingType, 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, 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, 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, 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/types/core.d.ts

@@ -47,12 +47,25 @@ export interface ApiSuccessResponse<T> {
     success: true;
     data: T;
 }
+/**
+ * Field-level validation detail carried on an error envelope.
+ *
+ * The same shape as `FieldError` in `@riverbankcms/api` and
+ * `RiverbankApiError['fieldErrors']` in the SDK. Blocks does not depend on
+ * `@riverbankcms/api`, so the shape is restated here rather than imported.
+ */
+export interface ApiFieldError {
+    field: string;
+    code: string;
+    message: string;
+}
 /** API error response */
 export interface ApiErrorResponse {
     success: false;
     error: {
         message: string;
         code?: string;
+        fieldErrors?: ApiFieldError[];
     };
 }
 /** Standard API response */

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

@@ -5,28 +5,13 @@
  */
 import type { DirectCheckoutCollectionOptionKind } from './core';
 import type { EventRegistrationOptionsRequest, EventRegistrationOptionsResponse } from '../../../blocks/event-registration';
-import type { PublicEvent as _PublicEvent, EventVenue as _EventVenue, PricingType as _PricingType, AccessRestriction as _AccessRestriction, PublicEventTicketType as _PublicEventTicketType, PublicEventTicketTypeAvailability as _PublicEventTicketTypeAvailability } from '../../../blocks/events/shared/types';
+import type { PublicEvent as _PublicEvent, EventVenue as _EventVenue, AccessRestriction as _AccessRestriction, PublicEventPricingOption as _PublicEventPricingOption, PublicEventPricingOptionAvailability as _PublicEventPricingOptionAvailability } from '../../../blocks/events/shared/types';
 import type { EventScheduleScope, EventSurfaceScope } from '../../../blocks/events/shared/filtering';
 export type PublicEvent = _PublicEvent;
 export type EventVenue = _EventVenue;
-export type PricingType = _PricingType;
 export type AccessRestriction = _AccessRestriction;
-export type PublicEventTicketType = _PublicEventTicketType;
-export type PublicEventTicketTypeAvailability = _PublicEventTicketTypeAvailability;
-export interface EligibilityEventTicketType {
-    id: string;
-    name: string;
-    description: string | null;
-    priceAmount: number;
-    isActive: boolean;
-    sortOrder: number;
-    capacityMode: 'limited' | 'unlimited';
-    capacityLimit: number | null;
-    attendanceScope?: 'in_person' | 'online' | 'both';
-    saleStartsAt: string | null;
-    saleEndsAt: string | null;
-    availability: PublicEventTicketTypeAvailability;
-}
+export type PublicEventPricingOption = _PublicEventPricingOption;
+export type PublicEventPricingOptionAvailability = _PublicEventPricingOptionAvailability;
 export interface PublicEventsRequest {
     siteId: string;
     from?: string;
@@ -95,11 +80,11 @@ export interface EventRegisterGuest {
     phone?: string | null;
 }
 export interface EventTicketSelectionRequest {
-    ticketTypeId?: string | null;
+    pricingOptionId?: string | null;
     quantity: number;
 }
 export interface EventTicketLineSummary {
-    ticketTypeId: string | null;
+    pricingOptionId: string | null;
     label: string;
     description: string | null;
     quantity: number;
@@ -109,6 +94,13 @@ export interface EventTicketLineSummary {
 }
 export interface EventRegisterRequest {
     siteId: string;
+    /**
+     * Client-generated command identity for this submission (UUID).
+     *
+     * Generated once per submission and kept across transport retries so the
+     * server can replay a lost response instead of registering twice.
+     */
+    registrationCommandId: string;
     subject: {
         kind: 'occurrence';
         occurrenceId: string;

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

@@ -209,7 +209,7 @@ export declare const runtimeBackedBlockClientEntries: {
         definition: import("../..").SystemBlockDefinition<unknown, Readonly<{
             kind: "progressive";
             buildRender: (source: Readonly<{
-                events?: import("../..").PublicEvent[] | null;
+                events?: import("../../../../../api/src/index").PublicEvent[] | null;
                 siteId: string;
                 apiBaseUrl?: string;
                 stage?: "preview" | "published";
@@ -253,7 +253,7 @@ export declare const runtimeBackedBlockClientEntries: {
                     showMap: boolean;
                     showCapacity: boolean;
                     orientation: import("../..").CardOrientation;
-                    events: readonly import("../..").PublicEvent[];
+                    events: readonly import("../../../../../api/src/index").PublicEvent[];
                 }>;
                 hydration: Readonly<{
                     siteId: string;
@@ -276,7 +276,7 @@ export declare const runtimeBackedBlockClientEntries: {
             contracts: Readonly<{
                 source: Readonly<{
                     encode: (value: Readonly<{
-                        events?: import("../..").PublicEvent[] | null;
+                        events?: import("../../../../../api/src/index").PublicEvent[] | null;
                         siteId: string;
                         apiBaseUrl?: string;
                         stage?: "preview" | "published";
@@ -306,7 +306,7 @@ export declare const runtimeBackedBlockClientEntries: {
                         filterVenueId?: string | null;
                     }>) => unknown;
                     decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<{
-                        events?: import("../..").PublicEvent[] | null;
+                        events?: import("../../../../../api/src/index").PublicEvent[] | null;
                         siteId: string;
                         apiBaseUrl?: string;
                         stage?: "preview" | "published";
@@ -353,7 +353,7 @@ export declare const runtimeBackedBlockClientEntries: {
                             showMap: boolean;
                             showCapacity: boolean;
                             orientation: import("../..").CardOrientation;
-                            events: readonly import("../..").PublicEvent[];
+                            events: readonly import("../../../../../api/src/index").PublicEvent[];
                         }>;
                         hydration: Readonly<{
                             siteId: string;
@@ -389,7 +389,7 @@ export declare const runtimeBackedBlockClientEntries: {
                             showMap: boolean;
                             showCapacity: boolean;
                             orientation: import("../..").CardOrientation;
-                            events: readonly import("../..").PublicEvent[];
+                            events: readonly import("../../../../../api/src/index").PublicEvent[];
                         }>;
                         hydration: Readonly<{
                             siteId: string;
@@ -418,7 +418,7 @@ export declare const runtimeBackedBlockClientEntries: {
             runtime: Readonly<{
                 kind: "progressive";
                 buildRender: (source: Readonly<{
-                    events?: import("../..").PublicEvent[] | null;
+                    events?: import("../../../../../api/src/index").PublicEvent[] | null;
                     siteId: string;
                     apiBaseUrl?: string;
                     stage?: "preview" | "published";
@@ -462,7 +462,7 @@ export declare const runtimeBackedBlockClientEntries: {
                         showMap: boolean;
                         showCapacity: boolean;
                         orientation: import("../..").CardOrientation;
-                        events: readonly import("../..").PublicEvent[];
+                        events: readonly import("../../../../../api/src/index").PublicEvent[];
                     }>;
                     hydration: Readonly<{
                         siteId: string;
@@ -485,7 +485,7 @@ export declare const runtimeBackedBlockClientEntries: {
                 contracts: Readonly<{
                     source: Readonly<{
                         encode: (value: Readonly<{
-                            events?: import("../..").PublicEvent[] | null;
+                            events?: import("../../../../../api/src/index").PublicEvent[] | null;
                             siteId: string;
                             apiBaseUrl?: string;
                             stage?: "preview" | "published";
@@ -515,7 +515,7 @@ export declare const runtimeBackedBlockClientEntries: {
                             filterVenueId?: string | null;
                         }>) => unknown;
                         decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<{
-                            events?: import("../..").PublicEvent[] | null;
+                            events?: import("../../../../../api/src/index").PublicEvent[] | null;
                             siteId: string;
                             apiBaseUrl?: string;
                             stage?: "preview" | "published";
@@ -562,7 +562,7 @@ export declare const runtimeBackedBlockClientEntries: {
                                 showMap: boolean;
                                 showCapacity: boolean;
                                 orientation: import("../..").CardOrientation;
-                                events: readonly import("../..").PublicEvent[];
+                                events: readonly import("../../../../../api/src/index").PublicEvent[];
                             }>;
                             hydration: Readonly<{
                                 siteId: string;
@@ -598,7 +598,7 @@ export declare const runtimeBackedBlockClientEntries: {
                                 showMap: boolean;
                                 showCapacity: boolean;
                                 orientation: import("../..").CardOrientation;
-                                events: readonly import("../..").PublicEvent[];
+                                events: readonly import("../../../../../api/src/index").PublicEvent[];
                             }>;
                             hydration: Readonly<{
                                 siteId: string;
@@ -632,6 +632,7 @@ export declare const runtimeBackedBlockClientEntries: {
             buildRender: (source: import("../nodes/events/EventCalendar.interactive").EventCalendarSourceProps) => Readonly<{
                 display: import("../nodes/events/EventCalendar.interactive").EventCalendarDisplay;
                 hydration: Readonly<{
+                    calendarWindow?: import("../../../contracts").CalendarWindowPage;
                     siteId: string;
                     stage?: "preview" | "published";
                     prefetchedEvents: boolean;
@@ -657,6 +658,7 @@ export declare const runtimeBackedBlockClientEntries: {
                     encode: (value: Readonly<{
                         display: import("../nodes/events/EventCalendar.interactive").EventCalendarDisplay;
                         hydration: Readonly<{
+                            calendarWindow?: import("../../../contracts").CalendarWindowPage;
                             siteId: string;
                             stage?: "preview" | "published";
                             prefetchedEvents: boolean;
@@ -676,6 +678,7 @@ export declare const runtimeBackedBlockClientEntries: {
                     decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<{
                         display: import("../nodes/events/EventCalendar.interactive").EventCalendarDisplay;
                         hydration: Readonly<{
+                            calendarWindow?: import("../../../contracts").CalendarWindowPage;
                             siteId: string;
                             stage?: "preview" | "published";
                             prefetchedEvents: boolean;
@@ -703,6 +706,7 @@ export declare const runtimeBackedBlockClientEntries: {
                 buildRender: (source: import("../nodes/events/EventCalendar.interactive").EventCalendarSourceProps) => Readonly<{
                     display: import("../nodes/events/EventCalendar.interactive").EventCalendarDisplay;
                     hydration: Readonly<{
+                        calendarWindow?: import("../../../contracts").CalendarWindowPage;
                         siteId: string;
                         stage?: "preview" | "published";
                         prefetchedEvents: boolean;
@@ -728,6 +732,7 @@ export declare const runtimeBackedBlockClientEntries: {
                         encode: (value: Readonly<{
                             display: import("../nodes/events/EventCalendar.interactive").EventCalendarDisplay;
                             hydration: Readonly<{
+                                calendarWindow?: import("../../../contracts").CalendarWindowPage;
                                 siteId: string;
                                 stage?: "preview" | "published";
                                 prefetchedEvents: boolean;
@@ -747,6 +752,7 @@ export declare const runtimeBackedBlockClientEntries: {
                         decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<{
                             display: import("../nodes/events/EventCalendar.interactive").EventCalendarDisplay;
                             hydration: Readonly<{
+                                calendarWindow?: import("../../../contracts").CalendarWindowPage;
                                 siteId: string;
                                 stage?: "preview" | "published";
                                 prefetchedEvents: boolean;
@@ -1693,10 +1699,8 @@ export declare const runtimeBackedBlockClientEntries: {
                 previewToken?: string | null;
                 occurrenceContext?: import("../..").OccurrenceContext | null;
                 subject?: import("../nodes/event-registration/eventScope").EventRegistrationPageSurfaceSubject | null;
-                events?: import("../..").PublicEvent[] | null;
-                wholeSeriesOfferings?: import("../../blocks/events/whole-series").PublicWholeSeriesOffering[] | null;
-                wholeSeriesOffering?: import("../../blocks/events/whole-series").PublicWholeSeriesOffering | null;
-                subjectWholeSeriesOffering?: import("../../blocks/events/whole-series").PublicWholeSeriesOffering | null;
+                events?: import("../../../../../api/src/index").PublicEvent[] | null;
+                wholeSeriesRunEvents?: import("../../../../../api/src/index").PublicEvent[] | null;
                 className?: string | null;
                 buttonText?: string | null;
                 maxTickets?: string | null;
@@ -1727,10 +1731,8 @@ export declare const runtimeBackedBlockClientEntries: {
                         previewToken?: string | null;
                         occurrenceContext?: import("../..").OccurrenceContext | null;
                         subject?: import("../nodes/event-registration/eventScope").EventRegistrationPageSurfaceSubject | null;
-                        events?: import("../..").PublicEvent[] | null;
-                        wholeSeriesOfferings?: import("../../blocks/events/whole-series").PublicWholeSeriesOffering[] | null;
-                        wholeSeriesOffering?: import("../../blocks/events/whole-series").PublicWholeSeriesOffering | null;
-                        subjectWholeSeriesOffering?: import("../../blocks/events/whole-series").PublicWholeSeriesOffering | null;
+                        events?: import("../../../../../api/src/index").PublicEvent[] | null;
+                        wholeSeriesRunEvents?: import("../../../../../api/src/index").PublicEvent[] | null;
                         className?: string | null;
                         buttonText?: string | null;
                         maxTickets?: string | null;
@@ -1756,10 +1758,8 @@ export declare const runtimeBackedBlockClientEntries: {
                         previewToken?: string | null;
                         occurrenceContext?: import("../..").OccurrenceContext | null;
                         subject?: import("../nodes/event-registration/eventScope").EventRegistrationPageSurfaceSubject | null;
-                        events?: import("../..").PublicEvent[] | null;
-                        wholeSeriesOfferings?: import("../../blocks/events/whole-series").PublicWholeSeriesOffering[] | null;
-                        wholeSeriesOffering?: import("../../blocks/events/whole-series").PublicWholeSeriesOffering | null;
-                        subjectWholeSeriesOffering?: import("../../blocks/events/whole-series").PublicWholeSeriesOffering | null;
+                        events?: import("../../../../../api/src/index").PublicEvent[] | null;
+                        wholeSeriesRunEvents?: import("../../../../../api/src/index").PublicEvent[] | null;
                         className?: string | null;
                         buttonText?: string | null;
                         maxTickets?: string | null;
@@ -1803,10 +1803,8 @@ export declare const runtimeBackedBlockClientEntries: {
                     previewToken?: string | null;
                     occurrenceContext?: import("../..").OccurrenceContext | null;
                     subject?: import("../nodes/event-registration/eventScope").EventRegistrationPageSurfaceSubject | null;
-                    events?: import("../..").PublicEvent[] | null;
-                    wholeSeriesOfferings?: import("../../blocks/events/whole-series").PublicWholeSeriesOffering[] | null;
-                    wholeSeriesOffering?: import("../../blocks/events/whole-series").PublicWholeSeriesOffering | null;
-                    subjectWholeSeriesOffering?: import("../../blocks/events/whole-series").PublicWholeSeriesOffering | null;
+                    events?: import("../../../../../api/src/index").PublicEvent[] | null;
+                    wholeSeriesRunEvents?: import("../../../../../api/src/index").PublicEvent[] | null;
                     className?: string | null;
                     buttonText?: string | null;
                     maxTickets?: string | null;
@@ -1837,10 +1835,8 @@ export declare const runtimeBackedBlockClientEntries: {
                             previewToken?: string | null;
                             occurrenceContext?: import("../..").OccurrenceContext | null;
                             subject?: import("../nodes/event-registration/eventScope").EventRegistrationPageSurfaceSubject | null;
-                            events?: import("../..").PublicEvent[] | null;
-                            wholeSeriesOfferings?: import("../../blocks/events/whole-series").PublicWholeSeriesOffering[] | null;
-                            wholeSeriesOffering?: import("../../blocks/events/whole-series").PublicWholeSeriesOffering | null;
-                            subjectWholeSeriesOffering?: import("../../blocks/events/whole-series").PublicWholeSeriesOffering | null;
+                            events?: import("../../../../../api/src/index").PublicEvent[] | null;
+                            wholeSeriesRunEvents?: import("../../../../../api/src/index").PublicEvent[] | null;
                             className?: string | null;
                             buttonText?: string | null;
                             maxTickets?: string | null;
@@ -1866,10 +1862,8 @@ export declare const runtimeBackedBlockClientEntries: {
                             previewToken?: string | null;
                             occurrenceContext?: import("../..").OccurrenceContext | null;
                             subject?: import("../nodes/event-registration/eventScope").EventRegistrationPageSurfaceSubject | null;
-                            events?: import("../..").PublicEvent[] | null;
-                            wholeSeriesOfferings?: import("../../blocks/events/whole-series").PublicWholeSeriesOffering[] | null;
-                            wholeSeriesOffering?: import("../../blocks/events/whole-series").PublicWholeSeriesOffering | null;
-                            subjectWholeSeriesOffering?: import("../../blocks/events/whole-series").PublicWholeSeriesOffering | null;
+                            events?: import("../../../../../api/src/index").PublicEvent[] | null;
+                            wholeSeriesRunEvents?: import("../../../../../api/src/index").PublicEvent[] | null;
                             className?: string | null;
                             buttonText?: string | null;
                             maxTickets?: string | null;
@@ -2234,7 +2228,7 @@ export declare const clientComponentRegistryEntries: {
         component: React.ComponentType<Readonly<{
             occurrenceContext?: import("../../../contracts").EventDetailsOccurrenceContext | null;
             subject?: import("../nodes/event-registration/eventScope").EventRegistrationPageSurfaceSubject | null;
-            events?: readonly import("../..").PublicEvent[] | null;
+            events?: readonly import("../../../../../api/src/index").PublicEvent[] | null;
             showVenue?: boolean;
             showMap?: boolean;
             showOtherDates?: boolean;
@@ -2279,6 +2273,7 @@ export declare const clientComponentRegistryEntries: {
             } & Readonly<{
                 display: import("../nodes/events/EventCombined.interactive").EventCombinedDisplay;
                 hydration: Readonly<{
+                    calendarWindow?: import("../../../contracts").CalendarWindowPage;
                     siteId: string;
                     stage?: "preview" | "published";
                     prefetchedEvents: boolean;

package/dist/_dts/blocks/src/system/runtime/components/runtime-backed-blocks.d.ts

@@ -109,7 +109,7 @@ export declare const runtimeBackedBlockServerEntries: {
         definition: RuntimeBackedBlockDefinition<Readonly<{
             kind: "progressive";
             buildRender: (source: Readonly<{
-                events?: import("../..").PublicEvent[] | null;
+                events?: import("../../../../../api/src/index").PublicEvent[] | null;
                 siteId: string;
                 apiBaseUrl?: string;
                 stage?: "preview" | "published";
@@ -153,7 +153,7 @@ export declare const runtimeBackedBlockServerEntries: {
                     showMap: boolean;
                     showCapacity: boolean;
                     orientation: import("../..").CardOrientation;
-                    events: readonly import("../..").PublicEvent[];
+                    events: readonly import("../../../../../api/src/index").PublicEvent[];
                 }>;
                 hydration: Readonly<{
                     siteId: string;
@@ -176,7 +176,7 @@ export declare const runtimeBackedBlockServerEntries: {
             contracts: Readonly<{
                 source: Readonly<{
                     encode: (value: Readonly<{
-                        events?: import("../..").PublicEvent[] | null;
+                        events?: import("../../../../../api/src/index").PublicEvent[] | null;
                         siteId: string;
                         apiBaseUrl?: string;
                         stage?: "preview" | "published";
@@ -206,7 +206,7 @@ export declare const runtimeBackedBlockServerEntries: {
                         filterVenueId?: string | null;
                     }>) => unknown;
                     decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<{
-                        events?: import("../..").PublicEvent[] | null;
+                        events?: import("../../../../../api/src/index").PublicEvent[] | null;
                         siteId: string;
                         apiBaseUrl?: string;
                         stage?: "preview" | "published";
@@ -253,7 +253,7 @@ export declare const runtimeBackedBlockServerEntries: {
                             showMap: boolean;
                             showCapacity: boolean;
                             orientation: import("../..").CardOrientation;
-                            events: readonly import("../..").PublicEvent[];
+                            events: readonly import("../../../../../api/src/index").PublicEvent[];
                         }>;
                         hydration: Readonly<{
                             siteId: string;
@@ -289,7 +289,7 @@ export declare const runtimeBackedBlockServerEntries: {
                             showMap: boolean;
                             showCapacity: boolean;
                             orientation: import("../..").CardOrientation;
-                            events: readonly import("../..").PublicEvent[];
+                            events: readonly import("../../../../../api/src/index").PublicEvent[];
                         }>;
                         hydration: Readonly<{
                             siteId: string;
@@ -321,6 +321,7 @@ export declare const runtimeBackedBlockServerEntries: {
             buildRender: (source: import("../nodes/events/EventCalendar.interactive").EventCalendarSourceProps) => Readonly<{
                 display: import("../nodes/events/EventCalendar.interactive").EventCalendarDisplay;
                 hydration: Readonly<{
+                    calendarWindow?: import("../../../contracts").CalendarWindowPage;
                     siteId: string;
                     stage?: "preview" | "published";
                     prefetchedEvents: boolean;
@@ -346,6 +347,7 @@ export declare const runtimeBackedBlockServerEntries: {
                     encode: (value: Readonly<{
                         display: import("../nodes/events/EventCalendar.interactive").EventCalendarDisplay;
                         hydration: Readonly<{
+                            calendarWindow?: import("../../../contracts").CalendarWindowPage;
                             siteId: string;
                             stage?: "preview" | "published";
                             prefetchedEvents: boolean;
@@ -365,6 +367,7 @@ export declare const runtimeBackedBlockServerEntries: {
                     decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<{
                         display: import("../nodes/events/EventCalendar.interactive").EventCalendarDisplay;
                         hydration: Readonly<{
+                            calendarWindow?: import("../../../contracts").CalendarWindowPage;
                             siteId: string;
                             stage?: "preview" | "published";
                             prefetchedEvents: boolean;
@@ -850,10 +853,8 @@ export declare const runtimeBackedBlockServerEntries: {
                 previewToken?: string | null;
                 occurrenceContext?: import("../..").OccurrenceContext | null;
                 subject?: import("../nodes/event-registration/eventScope").EventRegistrationPageSurfaceSubject | null;
-                events?: import("../..").PublicEvent[] | null;
-                wholeSeriesOfferings?: import("../../blocks/events/whole-series").PublicWholeSeriesOffering[] | null;
-                wholeSeriesOffering?: import("../../blocks/events/whole-series").PublicWholeSeriesOffering | null;
-                subjectWholeSeriesOffering?: import("../../blocks/events/whole-series").PublicWholeSeriesOffering | null;
+                events?: import("../../../../../api/src/index").PublicEvent[] | null;
+                wholeSeriesRunEvents?: import("../../../../../api/src/index").PublicEvent[] | null;
                 className?: string | null;
                 buttonText?: string | null;
                 maxTickets?: string | null;
@@ -884,10 +885,8 @@ export declare const runtimeBackedBlockServerEntries: {
                         previewToken?: string | null;
                         occurrenceContext?: import("../..").OccurrenceContext | null;
                         subject?: import("../nodes/event-registration/eventScope").EventRegistrationPageSurfaceSubject | null;
-                        events?: import("../..").PublicEvent[] | null;
-                        wholeSeriesOfferings?: import("../../blocks/events/whole-series").PublicWholeSeriesOffering[] | null;
-                        wholeSeriesOffering?: import("../../blocks/events/whole-series").PublicWholeSeriesOffering | null;
-                        subjectWholeSeriesOffering?: import("../../blocks/events/whole-series").PublicWholeSeriesOffering | null;
+                        events?: import("../../../../../api/src/index").PublicEvent[] | null;
+                        wholeSeriesRunEvents?: import("../../../../../api/src/index").PublicEvent[] | null;
                         className?: string | null;
                         buttonText?: string | null;
                         maxTickets?: string | null;
@@ -913,10 +912,8 @@ export declare const runtimeBackedBlockServerEntries: {
                         previewToken?: string | null;
                         occurrenceContext?: import("../..").OccurrenceContext | null;
                         subject?: import("../nodes/event-registration/eventScope").EventRegistrationPageSurfaceSubject | null;
-                        events?: import("../..").PublicEvent[] | null;
-                        wholeSeriesOfferings?: import("../../blocks/events/whole-series").PublicWholeSeriesOffering[] | null;
-                        wholeSeriesOffering?: import("../../blocks/events/whole-series").PublicWholeSeriesOffering | null;
-                        subjectWholeSeriesOffering?: import("../../blocks/events/whole-series").PublicWholeSeriesOffering | null;
+                        events?: import("../../../../../api/src/index").PublicEvent[] | null;
+                        wholeSeriesRunEvents?: import("../../../../../api/src/index").PublicEvent[] | null;
                         className?: string | null;
                         buttonText?: string | null;
                         maxTickets?: string | null;

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

@@ -1,7 +1,8 @@
 import type { PublicEvent } from '../../blocks/events/shared/types';
 import { type BookingTimeZone } from '../../../../../core/src/index';
+import { type CalendarWindowPage, type CalendarReadProfile } from '../../blocks/events/shared/calendarWindow';
 import type { CalendarDate } from '../../../../../calendar/src/index';
-import { type CalendarViewport, type CalendarViewportKind, type WeekStart } from '../nodes/events/shared/utils';
+import { type CalendarViewport, type CalendarViewportKind, type WeekStart } from '../nodes/events/domain';
 import { type EventRuntimeFilters } from '../nodes/events/shared/listOptions';
 import { type CalendarViewLoadState } from './useCalendarEvents.state';
 export type { CalendarViewLoadState } from './useCalendarEvents.state';
@@ -9,10 +10,11 @@ type CalendarViewportFor<Kind extends CalendarViewportKind> = Extract<CalendarVi
     kind: Kind;
 }>>;
 type UseCalendarEventsOptions = {
+    readProfile?: CalendarReadProfile;
     /** @deprecated Site ID is now provided by BlockApiProvider context */
     siteId?: string;
-    /** Initial events from server-side render */
-    initialEvents?: PublicEvent[];
+    /** Server seed with explicit source-scan coverage. */
+    calendarWindow?: CalendarWindowPage;
     /** Calendar viewport kind. Controls navigation units and visible days. */
     view?: CalendarViewportKind;
     /** First day of week for week view and month-grid padding. */
@@ -74,18 +76,19 @@ type DefaultCalendarViewportOptions = Omit<UseCalendarViewportOptions, 'view'> &
 export declare function useCalendarViewport(options: DefaultCalendarViewportOptions): CalendarViewportState<'month'>;
 export declare function useCalendarViewport<Kind extends CalendarViewportKind>(options: ExplicitCalendarViewportOptions<Kind>): CalendarViewportState<Kind>;
 type UseCalendarEventCacheOptions = Readonly<{
+    readProfile?: CalendarReadProfile;
     viewDate: CalendarDate;
-    initialEvents?: PublicEvent[];
+    calendarWindow?: CalendarWindowPage;
     preloadMonths?: number;
     filters?: EventRuntimeFilters;
     stage?: 'preview' | 'published';
     timeZone: BookingTimeZone;
 }>;
 /**
- * Owns event loading and month-window caching for a supplied viewport anchor.
- * It does not decide navigation semantics or visible calendar days.
+ * 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({ viewDate, initialEvents, preloadMonths, filters, stage, timeZone, }: UseCalendarEventCacheOptions): Readonly<{
+export declare function useCalendarEventCache({ readProfile, viewDate, calendarWindow, preloadMonths, filters, stage, timeZone, }: UseCalendarEventCacheOptions): Readonly<{
     events: PublicEvent[];
     loadState: CalendarViewLoadState;
     retryCurrentView: () => void;
@@ -100,7 +103,7 @@ export declare function useCalendarEventCache({ viewDate, initialEvents, preload
  * ```tsx
  * const { events, viewDate, loading, goToPrevious, goToNext } = useCalendarEvents({
  *   siteId: 'site-123',
- *   initialEvents: serverEvents,
+ *   calendarWindow: serverWindow,
  * });
  * ```
  */