@riverbankcms/sdk 0.145.0 → 0.147.0

package/dist/_dts/api/src/siteManagementEndpoints.d.ts

@@ -1,5 +1,6 @@
+import type { SiteLifecycleAPIEndpoints } from './siteLifecycleEndpoints';
 import type { PublicProfile, RectificationHistoryPropagationPlan, RectificationIdentityBoundary, RectificationIssueUrl, RectificationSurface } from '../../core/src/index';
-import type { CamelizeKeys, DbRow, DbJson } from '../../db/src/index';
+import type { DbJson } from '../../db/src/index';
 import type { APIEndpoint } from './apiEndpointTypes';
 import type { BillingAPIEndpoints } from './billingEndpointTypes';
 import type { CustomDomainConnectionSnapshot, DomainHostingStatus } from './domainConnection';
@@ -7,15 +8,14 @@ import type { AdminListAllowedDomainsQueryOutput } from './schemas/admin-allowed
 import type { AdminListAxiomLogsQueryOutput, AdminListErrorLogsQueryOutput, AdminListSupabaseLogsQueryOutput, AdminListVercelLogsQueryOutput } from './schemas/admin-observability-logs';
 import type { AcceptAdminInviteRequest, AcceptAdminInviteResponse, AcceptSiteInvitationRequest, AcceptSiteInvitationResponse, AddCustomDomainRequest, AddCustomDomainResponse, AdminDeleteUserResponse, AuthInviteContinueRequest, AuthInviteContinueResponse, AuthInviteRegisterRequest, AuthInviteRegisterResponse, AuthResetCompleteRequest, AuthResetCompleteResponse, AuthSubmissionResult, BulkOperationResult, CreateAdminInviteRequest, CreateAdminInviteResponse, CreateAdminUserRequest, CreateAdminUserResponse, CreateAllowedDomainRequest, CreateAllowedDomainResponse, DeleteAllowedDomainResponse, DomainConfigResult, DomainSearchResultResponse, CurrentUserPractitionerLinkResponse, InviteSiteMemberRequest, InviteSiteMemberResponse, LinkCurrentUserPractitionerRequest, ListAdminInvitesResponse, ListAllowedDomainsResponse, ListSiteMembersResponse, LookupSiteDomainRequest, LookupSiteDomainResponse, MfaBackupCodesOverviewResponse, MfaBackupCodesRotateResponse, MfaOverviewResponse, MfaPhoneChallengeRequest, MfaPhoneChallengeResponse, MfaPhoneEnrollRequest, MfaPhoneEnrollResponse, MfaPhoneVerifyRequest, MfaTotpActivateRequest, MfaTotpEnrollResponse, MfaTotpVerifyRequest, MfaTotpVerifyResponse, ReauthSubmissionResult, RegisterDomainRequestPayload, RegisterDomainResponse, RegistrarBooleanMutationRequest, RegistrarLifecycleResponse, RegistrarRenewalPostureResponse, RegisterSiteDomainRequest, RegisterSiteDomainResponse, RemoveSiteMemberResponse, RevokeAdminInviteResponse, RevokeSiteInvitationResponse, ResendSiteInvitationResponse, SetHomepageRequest, SetHomepageResponse, SiteDomainContactPayload, SiteDomainRecord, TransferSiteOwnershipRequest, TransferSiteOwnershipResponse, UpdateSiteMemberRoleRequest, UpdateSiteMemberRoleResponse } from './accessAdmin';
 import type { AdminRoleMutationResponse, RevokeAdminRoleRequest, StartImpersonationRequest, StartImpersonationResponse, StopImpersonationRequest, StopImpersonationResponse, UpsertAdminRoleRequest } from './admin/types';
-import type { AccountRevokeSessionsBody, AccountRevokeSessionsResponse, AccountUpdatePasswordBody, AccountUpdatePasswordResponse, CreateManualSiteRequest, CreateManualSiteResponse } from './siteOperations';
+import type { AccountRevokeSessionsBody, AccountRevokeSessionsResponse, AccountUpdatePasswordBody, AccountUpdatePasswordResponse } from './siteOperations';
 import type { BookingSessionCancelAppointmentRequest, BookingSessionCancelAppointmentResponse, BookingSessionCreateAppointmentRequest, BookingSessionCreateAppointmentResponse, BookingSessionGetAppointmentResponse, BookingSessionListEligibleAppointmentPackagesResponse, BookingSessionGetEventResponse, BookingSessionListAppointmentsResponse, BookingSessionListEventsResponse, BookingSessionListMembershipsResponse, BookingSessionListPassesResponse, BookingSessionMeResponse, BookingSessionUpdateMeRequest, BookingSessionUpdateMeResponse, PublicBookingAppointmentStatusResponse, PublicBookingAvailabilityQuery, PublicBookingAvailableDatesResponse, PublicBookingAvailableSlotsResponse, PublicBookingService, PublicBookingServicesResponse, PublicWeeklySlotAvailabilityQuery, PublicWeeklySlotAvailabilityResponse, PublicCreateBookingAppointmentRequest, PublicCreateBookingAppointmentResponse, ReferenceOptionsResponse } from './bookingOperations';
 import type { ContentEntryOrPageResponse, ContentEntrySummary, ExportFormSubmissionsCsvQuery, ExportFormSubmissionsCsvResponse, CreateFormSubmissionRectificationAnnotationRequest, CreateFormSubmissionRectificationAnnotationResponse, FormRecord, FormSubmissionWithRectificationAnnotations, FormSummary, NavigationItemRecord, NavigationMenuWithItems, PublicFormRecord, PublishedContentEntryOrPageResponse, RunSdkWorkflowResponse, ScheduledContentEntryOrPageResponse, WorkflowRunStatusResponse } from './contentRuntime';
 import type { GetVersionHistoryResponse, ListVersionHistoryResponse, RestoreVersionHistoryRequest, RestoreVersionHistoryResponse, VersionHistoryListQuery } from './contentVersionHistory';
 import type { ApplyContentTemplateAddonRequest, ContentTemplateDetailsResponse, CreateTemplateBlockRequest, GetTransformsResponse, ReorderTemplateBlocksRequest, SerializedContentTypeSummary, UpdateContentTemplateBlockBindingsRequest, UpdateContentTemplateBlockRequest } from './contentTypes';
 import type { LinkPayload, RoutableContentItem, SitemapRouteItem } from './navigation/types';
 import type { RouteMetadataPayload, RouteMetadataResponse } from './routes';
-import type { PageSurfaceEditorDocument, PublishPageSurfaceResponse } from './contentRuntime';
-import type { ContentRouteRecord } from './types';
+import type { PageSurfaceAPIEndpoints } from './pageSurfaceEndpoints';
 import type { SiteAnalyticsSettingsPayload, SiteAnalyticsSettingsResponse } from './siteAnalytics';
 import type { SiteBannerSettingsPayload, SiteBannerSettingsResponse } from './siteBanner';
 import type { GeneratedIconSetGenerateRequest, GeneratedIconSetGenerateResponse, GeneratedIconSetListRequest, GeneratedIconSetListResponse, SiteIconStyleGuideResponse, SiteIconStyleGuideUpdateRequest } from './siteIcons';
@@ -29,7 +29,6 @@ export type { FooterCompositionSnapshot, FooterCompositionUpdateRequest, FooterC
  * that still belong to the aggregate contract layer but no longer need to live inline in
  * `types.ts`.
  */
-type Site = CamelizeKeys<DbRow<'sites'>>;
 export type PublicProfileSnapshot = Readonly<{
     kind: 'ready';
     profile: PublicProfile;
@@ -57,7 +56,7 @@ export type PublicProfileUpdateResponse = Readonly<{
 type DsarRunKindApi = 'preview_export' | 'execute_actions';
 type DsarExecutionModeApi = 'preview_only' | 'confirmed_execute';
 type DsarRunStatusApi = 'running' | 'previewed' | 'completed' | 'partially_failed' | 'failed';
-type DsarSurfaceNameApi = 'booking_customer' | 'person_record' | 'appointment' | 'event_registration' | 'order' | 'form_submission' | 'portal_session' | 'email_audit' | 'newsletter_subscriber';
+type DsarSurfaceNameApi = 'booking_customer' | 'person_record' | 'appointment' | 'event_registration' | 'booking_question_answer' | 'order' | 'form_submission' | 'portal_session' | 'email_audit' | 'newsletter_subscriber';
 type DsarExecutableSurfaceNameApi = 'portal_session' | 'newsletter_subscriber' | 'form_submission';
 type DsarRunCountsApi = {
     matchedSurfaces: number;
@@ -146,20 +145,7 @@ type DsarExecutionOutcomeApi = {
     detail: string;
     message: string;
 };
-export type SiteManagementAPIEndpoints = BillingAPIEndpoints & {
-    createSite: APIEndpoint<{
-        title: string;
-    }, never, {
-        id: string;
-        title: string;
-    }>;
-    createSiteManual: APIEndpoint<CreateManualSiteRequest, never, CreateManualSiteResponse>;
-    updateSite: APIEndpoint<Partial<Site>, never, Partial<Site>>;
-    deleteSite: APIEndpoint<never, {
-        siteId: string;
-    }, {
-        ok: boolean;
-    }>;
+export type SiteManagementAPIEndpoints = BillingAPIEndpoints & SiteLifecycleAPIEndpoints & PageSurfaceAPIEndpoints & {
     listContentEntries: APIEndpoint<never, {
         siteId: string;
         type: string;
@@ -247,35 +233,6 @@ export type SiteManagementAPIEndpoints = BillingAPIEndpoints & {
         type: string;
         entryId: string;
     }, ContentEntryOrPageResponse>;
-    updatePageSurfaceDraftContent: APIEndpoint<{
-        data: Record<string, unknown>;
-        optimisticHash: string;
-    }, {
-        siteId: string;
-        pageSurfaceId: string;
-    }, {
-        document: PageSurfaceEditorDocument;
-    }>;
-    discardPageSurfaceDraftContent: APIEndpoint<{
-        optimisticHash: string;
-    }, {
-        siteId: string;
-        pageSurfaceId: string;
-    }, {
-        document: PageSurfaceEditorDocument;
-    }>;
-    updatePageSurfaceRouteMetadata: APIEndpoint<Pick<RouteMetadataPayload, 'draftSlug' | 'draftMetaTitle' | 'draftMetaDescription' | 'ogImageId'> & {
-        expectedDraftUpdatedAt: string | null;
-    }, {
-        siteId: string;
-        pageSurfaceId: string;
-    }, {
-        route: ContentRouteRecord;
-    }>;
-    publishPageSurface: APIEndpoint<never, {
-        siteId: string;
-        pageSurfaceId: string;
-    }, PublishPageSurfaceResponse>;
     runSdkWorkflow: APIEndpoint<never, {
         siteId: string;
         type: string;

package/dist/_dts/api/src/siteOnboarding.d.ts

@@ -2,7 +2,7 @@ import type { Theme } from '../../blocks/src/index';
 import type { SiteVerticalBookingConfig } from '../../core/src/index';
 import { z } from 'zod';
 import type { AiGenerateSiteEntityType, AiGenerateSitePrimaryCta, AiGenerateSiteRequest } from './siteGeneration';
-import type { AppointmentSetupTargetStep } from './appointmentSetup';
+import type { AppointmentSetupReadiness, AppointmentSetupTargetStep } from './appointmentSetup';
 import type { MacadamiaOnboardingLogoAnalysis, MacadamiaOnboardingSurfaceData, PublicOnboardingSurfaceId } from './onboarding/surfaceData';
 export type * from './onboarding/surfaceData';
 /**
@@ -89,8 +89,8 @@ export type AiBrandGuidelinesGenerateResponse = {
         stats: SiteContentSamplingStats;
     };
 };
-export type LaunchRequirementId = 'confirm_email' | 'review_generated_site' | 'configure_appointments' | 'configure_events' | 'configure_courses' | 'connect_payments' | 'connect_custom_domain';
-export type LaunchRequirementPackId = 'core' | 'bookings_appointments' | 'bookings_events' | 'bookings_courses' | 'payments' | 'domain';
+export type LaunchRequirementId = 'confirm_email' | 'review_generated_site' | 'configure_appointments' | 'configure_events' | 'configure_courses' | 'connect_payments' | 'add_first_offering' | 'add_cover_image' | 'add_public_contact';
+export type LaunchRequirementPackId = 'core' | 'bookings_appointments' | 'bookings_events' | 'bookings_courses' | 'payments' | 'offerings' | 'presence';
 export type LaunchRequirementPriority = 'required' | 'recommended' | 'optional';
 export type LaunchRequirementState = 'complete' | 'pending';
 export type LaunchRequirementOwner = 'admin' | 'editor' | 'either';
@@ -129,9 +129,6 @@ export type LaunchRequirementAction = {
     label: string;
 };
 export type LaunchRequirementEvidence = {
-    kind: 'domain_connection';
-    domainIds: readonly string[];
-} | {
     kind: 'derived';
 } | {
     kind: 'acknowledged';
@@ -162,23 +159,36 @@ export type LaunchAppointmentsPackState = {
     kind: 'disabled';
 } | {
     kind: 'ready';
-} | {
+}
+/** `missing` is the first gap in setup, so copy can name it. */
+ | {
     kind: 'pending_setup';
+    missing: LaunchAppointmentsSetupGap;
     targetStep: AppointmentSetupTargetStep;
 };
+export type LaunchAppointmentsSetupGap = Exclude<AppointmentSetupReadiness['kind'], 'not_applicable' | 'bookable'>;
+/** The event offering kinds a launch item can name (courses have their own item). */
+export declare const LAUNCH_EVENT_OFFERING_KINDS: readonly ["classes", "workshops", "retreats", "performances"];
+export type LaunchEventOfferingKind = (typeof LAUNCH_EVENT_OFFERING_KINDS)[number];
 export type LaunchEventsPackState = {
     kind: 'disabled';
 } | {
     kind: 'ready';
-} | {
+}
+/** `offeredKinds`: event kinds recorded at onboarding, in wizard order; empty when none. */
+ | {
     kind: 'pending_setup';
+    offeredKinds: readonly LaunchEventOfferingKind[];
 };
+/** Keyed on whether a Stripe account exists: `connected_pending` has one that can't take payments yet. */
 export type LaunchPaymentsPackState = {
     kind: 'not_applicable';
 } | {
     kind: 'ready';
 } | {
-    kind: 'pending_setup';
+    kind: 'not_connected';
+} | {
+    kind: 'connected_pending';
 };
 export type LaunchCoursesPackState = {
     kind: 'not_applicable';
@@ -187,20 +197,46 @@ export type LaunchCoursesPackState = {
 } | {
     kind: 'pending_setup';
 };
-export type LaunchCustomDomainPackState = {
-    kind: 'connected';
-    domainIds: readonly string[];
+/** Booking pages only: whether the site has anything people could book. */
+export type LaunchOfferingsPackState = {
+    kind: 'has_offerings';
 } | {
-    kind: 'pending_verification' | 'partially_connected' | 'check_unavailable';
-    domainIds: readonly string[];
+    kind: 'none';
+};
+/** Booking pages only. */
+export type LaunchCoverImagePackState = {
+    kind: 'set';
 } | {
-    kind: 'pending_setup';
+    kind: 'missing';
+};
+/** Booking pages only: whether any contact method is published. */
+export type LaunchPublicContactPackState = {
+    kind: 'published';
+} | {
+    kind: 'missing';
 };
-export type LaunchRequirement = {
-    id: LaunchRequirementId;
+/**
+ * The exact gap behind a pending requirement, so a presentation can name it
+ * ("Set your hours", "Finish setting up Stripe") without re-deriving facts.
+ */
+export type LaunchAppointmentsGapDetail = {
+    kind: 'appointments_gap';
+    missing: LaunchAppointmentsSetupGap;
+};
+export type LaunchPaymentsGapDetail = {
+    kind: 'payments_gap';
+    stage: 'not_connected' | 'connected_pending';
+};
+export type LaunchEventKindsDetail = {
+    kind: 'event_kinds';
+    offeredKinds: readonly LaunchEventOfferingKind[];
+};
+export type LaunchRequirementDetail = LaunchAppointmentsGapDetail | LaunchPaymentsGapDetail | LaunchEventKindsDetail;
+/** Requirements that always carry a `detail` while pending. */
+export type LaunchDetailedRequirementId = Extract<LaunchRequirementId, 'configure_appointments' | 'connect_payments' | 'configure_events'>;
+type LaunchRequirementFields = {
     packId: LaunchRequirementPackId;
     priority: LaunchRequirementPriority;
-    state: LaunchRequirementState;
     owner: LaunchRequirementOwner;
     title: string;
     description: string;
@@ -208,6 +244,24 @@ export type LaunchRequirement = {
     secondaryAction?: LaunchRequirementAction | null;
     evidence: LaunchRequirementEvidence;
 };
+type LaunchPendingWithDetail<Id extends LaunchDetailedRequirementId, Detail> = LaunchRequirementFields & {
+    id: Id;
+    state: 'pending';
+    detail: Detail;
+};
+/**
+ * One launch requirement. The three detailed items must carry their gap
+ * while pending, so a presentation never has to guess it.
+ */
+export type LaunchRequirement = LaunchPendingWithDetail<'configure_appointments', LaunchAppointmentsGapDetail> | LaunchPendingWithDetail<'connect_payments', LaunchPaymentsGapDetail> | LaunchPendingWithDetail<'configure_events', LaunchEventKindsDetail> | (LaunchRequirementFields & {
+    id: LaunchDetailedRequirementId;
+    state: 'complete';
+    detail?: never;
+}) | (LaunchRequirementFields & {
+    id: Exclude<LaunchRequirementId, LaunchDetailedRequirementId>;
+    state: LaunchRequirementState;
+    detail?: never;
+});
 export type GoLiveDecision = {
     kind: 'allowed';
     overriddenRequirementIds: LaunchRequirementId[];

package/dist/_dts/api/src/sitePlatformEndpoints.d.ts

@@ -23,7 +23,7 @@ export type SdkUpsertNavigationItemInput = Readonly<{
  * Site platform endpoints cover admin/configuration surfaces: redirects, webhooks,
  * keys, SDK management, content-type CRUD, backup flows, and site-level admin tools.
  */
-export type SitePlatformAPIEndpoints = {
+export type SitePlatformAPIEndpoints = import('./sdkEventLifecycle').SdkEventLifecycleAPIEndpoints & {
     listGscPropertiesAdmin: APIEndpoint<never, never, ListGscPropertiesAdminResponse>;
     getPublicChallenge: APIEndpoint<never, never, string>;
     checkRedirect: APIEndpoint<never, CheckRedirectQuery, CheckRedirectResponse>;

package/dist/_dts/api/src/types.d.ts

@@ -12,6 +12,7 @@ export type * from './bookingAdjustments';
 export type * from './bookingConfig';
 export type * from './event-listing-destination';
 export type * from './bookingManagementEndpoints';
+export type * from './newsletterCampaignCommandEndpoints';
 export type * from './bookingOperations';
 export { APPOINTMENT_HISTORY_STATUS_VALUES } from './bookingOperations';
 export type * from './bookingRecords';
@@ -28,6 +29,7 @@ export type * from './sdk-event-payment-terms';
 export type * from './siteInfrastructure';
 export type * from './siteGeneration';
 export type * from './siteManagementEndpoints';
+export type * from './siteAddressEndpoints';
 export type * from './siteOnboarding';
 export type * from './siteOperations';
 export type * from './siteAssets';
@@ -61,17 +63,21 @@ export type * from './accountEndpoints';
 import type { AiAndLaunchReadinessAPIEndpointDefinitions, AiAPIEndpointName, AiAPIEndpoints, LaunchReadinessAPIEndpointName, LaunchReadinessAPIEndpoints } from './aiEndpoints';
 import type { AppointmentServiceCategoryAPIEndpoints } from './appointmentServiceCategoryEndpoints';
 import type { BookingManagementAPIEndpoints } from './bookingManagementEndpoints';
+import type { NewsletterCampaignCommandAPIEndpoints } from './newsletterCampaignCommandEndpoints';
 import type { CommercePortalAPIEndpoints } from './commercePortalEndpoints';
 import type { MailchimpIntegrationAPIEndpoints } from './mailchimpIntegration';
 import type { MailingListIntegrationAPIEndpoints } from './mailingListIntegration';
 import type { PublicExperienceAPIEndpoints } from './publicExperienceEndpoints';
 import type { SeoEndpointDefinitions } from './seoEndpoints';
 import type { SiteManagementAPIEndpoints } from './siteManagementEndpoints';
+import type { SiteAddressAPIEndpoints } from './siteAddressEndpoints';
 import type { SitePlatformAPIEndpoints } from './sitePlatformEndpoints';
+import type { SdkPageDesignAPIEndpoints } from './sdkPageDesign';
 import type { SiteRuntimeAPIEndpoints } from './siteRuntimeEndpoints';
+import type { ClientErrorReportingAPIEndpoints } from './clientErrorReporting';
 type TableName = keyof DbDatabase['public']['Tables'];
 export type DTOType<K extends TableName> = Partial<CamelizeKeys<DbRow<K>>>;
-type APIEndpointsMonolith = AiAndLaunchReadinessAPIEndpointDefinitions & AccountAPIEndpoints & SeoEndpointDefinitions & SiteManagementAPIEndpoints & PublicExperienceAPIEndpoints & SiteRuntimeAPIEndpoints & SitePlatformAPIEndpoints & BookingManagementAPIEndpoints & AppointmentServiceCategoryAPIEndpoints & CommercePortalAPIEndpoints & MailchimpIntegrationAPIEndpoints & MailingListIntegrationAPIEndpoints;
+type APIEndpointsMonolith = AiAndLaunchReadinessAPIEndpointDefinitions & AccountAPIEndpoints & SeoEndpointDefinitions & SiteManagementAPIEndpoints & SiteAddressAPIEndpoints & PublicExperienceAPIEndpoints & SiteRuntimeAPIEndpoints & SitePlatformAPIEndpoints & SdkPageDesignAPIEndpoints & BookingManagementAPIEndpoints & NewsletterCampaignCommandAPIEndpoints & AppointmentServiceCategoryAPIEndpoints & CommercePortalAPIEndpoints & MailchimpIntegrationAPIEndpoints & MailingListIntegrationAPIEndpoints & ClientErrorReportingAPIEndpoints;
 type ComposeEndpointMaps<Maps extends readonly object[], Acc extends object = {}> = Maps extends readonly [
     infer Head extends object,
     ...infer Tail extends readonly object[]

package/dist/_dts/api/src/wholeSeriesRuns.d.ts

@@ -147,3 +147,17 @@ export type UpdateEventSeriesRegistrationRequest = {
 export type UpdateEventSeriesRegistrationResponse = {
     enrollment: EventSeriesRegistrationRecord;
 };
+/**
+ * Somebody on the team filling in or editing the answers of one person on a
+ * booking. A booking can hold several places and each person is asked the
+ * questions separately, so the person is named rather than assumed.
+ */
+export type SaveEventSeriesRegistrationAnswersRequest = {
+    requirementId: string;
+    participantParticipationId: string;
+    answers: Record<string, unknown>;
+};
+export type SaveEventSeriesRegistrationAnswersResponse = {
+    savedAt: string;
+    filledInByName: string;
+};

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

@@ -1,13 +1,12 @@
 import * as React from 'react';
 import type { ResolverContext } from './system';
-import type { PageOutline } from './structure/schema';
 import type { SdkCustomBlock } from './system/manifest/schema';
 import type { RouteMap } from './system/transforms';
 import { type OverrideOnlyRenderMode, type ThemedRenderMode, type TokensOnlyRenderMode } from './pageRenderingMode';
 import { type PageJoinRenderer, type PageRuntimeJoin } from './pageRendererBoundaries';
 import { type BlockOverrides, type PageRendererDataContext, type SdkConfigForRenderer } from './pageRendererContracts';
-import { type RenderablePageOutline } from './pageRenderAdmission';
-export type { PageBlockRenderAdmissionError, RenderablePageBlock, RenderablePageOutline, } from './pageRenderAdmission';
+import { type RenderablePageOutline, type EditorPageOutlineWithPlacement } from './pageRenderAdmission';
+export type { PageBlockRenderAdmissionError, RenderablePageBlock, RenderablePageOutline, EditorRenderablePageOutline, EditorPageOutlineWithPlacement, } from './pageRenderAdmission';
 export type { BlockOverrideComponent, BlockOverrideProps, BlockOverrides, EntrySubrouteContextData, OccurrenceContextData, SdkConfigForRenderer, } from './pageRendererContracts';
 export { MissingBlockOverrideError } from './pageRenderingMode';
 export type { PageBlockPosition, PageJoinRenderer, PageJoinSlot, PageRuntimeJoin, RenderedJoin, } from './pageRendererBoundaries';
@@ -30,6 +29,6 @@ type OverrideOnlyPageRendererProps<TPage> = PageRendererCommonProps<TPage> & Ove
     blockOverrides: BlockOverrides;
 };
 export type PageRendererProps = ThemedPageRendererProps<RenderablePageOutline> | TokensOnlyPageRendererProps<RenderablePageOutline> | OverrideOnlyPageRendererProps<RenderablePageOutline>;
-export type EditorPageRendererProps = ThemedPageRendererProps<PageOutline> | OverrideOnlyPageRendererProps<PageOutline>;
+export type EditorPageRendererProps = ThemedPageRendererProps<EditorPageOutlineWithPlacement> | OverrideOnlyPageRendererProps<EditorPageOutlineWithPlacement>;
 export default function PageRenderer(props: PageRendererProps): React.JSX.Element;
 export declare function EditorPageRenderer(props: EditorPageRendererProps): React.JSX.Element;

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

@@ -28,6 +28,8 @@ export declare const proofBlockIslandCodecs: {
                     message: string | null;
                 }>;
                 hydration: Readonly<{
+                    mailingList?: import("../../../core/src/index").MailingListRuntimeContext;
+                    siteName?: string;
                     formId: string | null;
                     serviceId: string | null;
                     resourceId: string | null;
@@ -116,6 +118,8 @@ export declare const proofBlockIslandCodecs: {
                     message: string | null;
                 }>;
                 hydration: Readonly<{
+                    mailingList?: import("../../../core/src/index").MailingListRuntimeContext;
+                    siteName?: string;
                     formId: string | null;
                     serviceId: string | null;
                     resourceId: string | null;
@@ -990,6 +994,8 @@ export declare const runtimeIslandCodecs: {
                     message: string | null;
                 }>;
                 hydration: Readonly<{
+                    mailingList?: import("../../../core/src/index").MailingListRuntimeContext;
+                    siteName?: string;
                     formId: string | null;
                     serviceId: string | null;
                     resourceId: string | null;
@@ -1078,6 +1084,8 @@ export declare const runtimeIslandCodecs: {
                     message: string | null;
                 }>;
                 hydration: Readonly<{
+                    mailingList?: import("../../../core/src/index").MailingListRuntimeContext;
+                    siteName?: string;
                     formId: string | null;
                     serviceId: string | null;
                     resourceId: string | null;

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

@@ -4,6 +4,8 @@ export { createCustomBlockRegistry, mergeBlockDescriptorsWithRegistry, planCusto
 export type { CustomBlockConflictReason, CustomBlockManifestSource, CustomBlockRegistry, CustomBlockRegistryConflict, CustomBlockRegistryEntry, CustomBlockRegistryResolutionPlan, CustomBlockSourcePolicy, ResolvedCustomBlockManifest, SdkConfigForBlockPicker, } from './customBlockRegistry';
 export type { BlockOverrideComponent, BlockOverrideProps, BlockOverrides, EntrySubrouteContextData, EditorPageRendererProps, PageBlockRenderAdmissionError, PageRendererProps, RenderablePageBlock, RenderablePageOutline, OccurrenceContextData, PageBlockPosition, PageJoinRenderer, PageJoinSlot, PageRuntimeJoin, RenderedJoin, SdkConfigForRenderer, } from './PageRenderer';
 export { MissingBlockOverrideError } from './pageRenderingMode';
+export { readPublishedBlockPlacement } from './pageRenderAdmission';
+export type { EditorPageOutlineWithPlacement, EditorRenderablePageOutline, PublishedBlockPlacement, PublishedBlockPlacementRead } from './pageRenderAdmission';
 export * from './subroutes';
 export * from './structure/schema';
 export { BLOCK_BUTTON_ROLES, BLOCK_BUTTON_ROLE_OPTIONS, blockButtonRoleSchema, isBlockButtonRole, type BlockButtonRole, } from './system/constants/buttonRoles';

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

@@ -6,12 +6,26 @@ export type PageBlockRenderAdmissionError = Readonly<{
 }> | Readonly<{
     kind: 'manifest_unavailable';
 }>;
+export type PublishedBlockPlacement = Readonly<{
+    id: string;
+    content: Record<string, unknown>;
+}>;
+export type PublishedBlockPlacementRead = PublishedBlockPlacement | Readonly<{
+    kind: 'incomplete';
+    id: string | null;
+    content: Record<string, unknown> | null;
+}> | null;
+/** Pair a published version with the content it authorises at the render boundary. */
+export declare function readPublishedBlockPlacement(id: string | null | undefined, content: Record<string, unknown> | null | undefined): PublishedBlockPlacementRead;
 export type RenderablePageBlock = Readonly<{
     id: Block['id'];
     kind: Block['kind'];
     purpose: Block['purpose'];
     bindings?: Block['bindings'];
     contentVersionId?: string | null;
+    draftContentId?: string | null;
+    draftContent?: Record<string, unknown> | null;
+    publishedPlacement: PublishedBlockPlacementRead;
     admission: Readonly<{
         kind: 'renderable';
         content: RenderableManifestContent;
@@ -34,9 +48,23 @@ export type PresentationAdmission = Readonly<{
 export type PresentationBlock = Block & Readonly<{
     presentationAdmission: PresentationAdmission;
     contentVersionId?: string | null;
+    draftContentId?: string | null;
+    publishedPlacement: PublishedBlockPlacementRead;
 }>;
 export type PresentationPageOutline = Omit<PageOutline, 'blocks'> & Readonly<{
     blocks: readonly PresentationBlock[];
 }>;
+export type EditorRenderablePageOutline = Omit<PageOutline, 'blocks'> & Readonly<{
+    blocks: (Block & Readonly<{
+        draftContentId: string | null;
+        publishedContentId: string | null;
+        publishedContent: Record<string, unknown> | null;
+    }>)[];
+}>;
+export type EditorPageOutlineWithPlacement = Omit<PageOutline, 'blocks'> & Readonly<{
+    blocks: readonly (Block & Readonly<{
+        publishedPlacement: PublishedBlockPlacementRead;
+    }>)[];
+}>;
 export declare function toPresentationPage(page: RenderablePageOutline | null): PresentationPageOutline | null;
-export declare function toEditorPresentationPage(page: PageOutline | null): PresentationPageOutline | null;
+export declare function toEditorPresentationPage(page: EditorPageOutlineWithPlacement | null): PresentationPageOutline | null;

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

@@ -7,6 +7,7 @@ import type { RouteMap } from './system/transforms';
 import type { BookingOfferingPresetSummary } from './system/blocks/offerings-preview/model';
 import type { BlockLoaderFailures } from './system/data/types';
 import type { BrowserReadAuthority } from './system/runtime/api/types';
+import type { NewsletterBlockSubmission } from './system/runtime/nodes/newsletter-form.block-submission';
 /**
  * Occurrence context for event pages.
  * Passed through to blocks that need occurrence information (e.g., event-registration).
@@ -76,6 +77,7 @@ export type BlockOverrideProps<TContent = Record<string, unknown>> = {
     blockId: string | null;
     /** Exact content snapshot rendered for this block. */
     contentVersionId?: string | null;
+    newsletterBlockSubmission?: NewsletterBlockSubmission;
     /** Block kind identifier (e.g., "block.hero" or "custom.my-block") */
     blockKind: string;
 };
@@ -135,13 +137,15 @@ export type SdkConfigForRenderer = {
  */
 export type PageRendererDataContext = {
     siteId?: string;
+    /** Public business name from sites.title. */
+    siteName?: string;
     pageId?: string;
     /** Canonical request pathname used by blocks when resolving same-site destinations. */
     pathname?: string;
     resolvedData?: Record<string, Record<string, unknown>>;
     /** Failed server loader requests, kept separate from successful data. */
     loaderFailures?: BlockLoaderFailures;
-    previewStage?: 'published' | 'preview';
+    previewStage: 'published' | 'preview';
     previewToken?: string | null;
     readAuthority?: BrowserReadAuthority;
     routes?: RouteMap;

package/dist/_dts/blocks/src/system/blocks/events/shared/schemas.d.ts

@@ -18,6 +18,7 @@ export declare const publicEventLoaderQuerySchemaShape: {
     readonly seriesSlug: z.ZodOptional<z.ZodString>;
     readonly includeOccurrenceId: z.ZodOptional<z.ZodString>;
     readonly readIntent: z.ZodOptional<z.ZodString>;
+    readonly detailAdmission: z.ZodOptional<z.ZodString>;
     readonly detailLevel: z.ZodOptional<z.ZodString>;
     readonly readProfile: z.ZodOptional<z.ZodString>;
 };
@@ -39,6 +40,7 @@ export declare const publicEventLoaderQuerySchema: z.ZodObject<{
     seriesSlug: z.ZodOptional<z.ZodString>;
     includeOccurrenceId: z.ZodOptional<z.ZodString>;
     readIntent: z.ZodOptional<z.ZodString>;
+    detailAdmission: z.ZodOptional<z.ZodString>;
     detailLevel: z.ZodOptional<z.ZodString>;
     readProfile: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
@@ -164,11 +166,15 @@ export declare const publicEventBookingAvailabilitySchema: z.ZodDiscriminatedUni
         series_archived: "series_archived";
         parent_archived: "parent_archived";
         parent_inconsistent: "parent_inconsistent";
-        not_public: "not_public";
         already_started: "already_started";
         enrollment_closed: "enrollment_closed";
     }>;
 }, z.core.$strip>], "kind">;
+export declare const publicEventBookingClosedDetailSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"opensSoon">;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"paused">;
+}, z.core.$strip>], "kind">;
 export declare const publicRunSessionSchema: z.ZodObject<{
     occurrenceId: z.ZodString;
     startsAt: z.ZodString;
@@ -536,11 +542,15 @@ export declare const publicEventSchema: z.ZodUnion<readonly [z.ZodObject<{
             series_archived: "series_archived";
             parent_archived: "parent_archived";
             parent_inconsistent: "parent_inconsistent";
-            not_public: "not_public";
             already_started: "already_started";
             enrollment_closed: "enrollment_closed";
         }>;
     }, z.core.$strip>], "kind">;
+    bookingClosedDetail: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"opensSoon">;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"paused">;
+    }, z.core.$strip>], "kind">>;
     deliveryMode: z.ZodEnum<{
         in_person: "in_person";
         online: "online";
@@ -1021,11 +1031,15 @@ export declare const publicEventSchema: z.ZodUnion<readonly [z.ZodObject<{
             series_archived: "series_archived";
             parent_archived: "parent_archived";
             parent_inconsistent: "parent_inconsistent";
-            not_public: "not_public";
             already_started: "already_started";
             enrollment_closed: "enrollment_closed";
         }>;
     }, z.core.$strip>], "kind">;
+    bookingClosedDetail: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"opensSoon">;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"paused">;
+    }, z.core.$strip>], "kind">>;
     deliveryMode: z.ZodEnum<{
         in_person: "in_person";
         online: "online";
@@ -1531,11 +1545,15 @@ export declare const publicEventsArraySchema: z.ZodArray<z.ZodUnion<readonly [z.
             series_archived: "series_archived";
             parent_archived: "parent_archived";
             parent_inconsistent: "parent_inconsistent";
-            not_public: "not_public";
             already_started: "already_started";
             enrollment_closed: "enrollment_closed";
         }>;
     }, z.core.$strip>], "kind">;
+    bookingClosedDetail: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"opensSoon">;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"paused">;
+    }, z.core.$strip>], "kind">>;
     deliveryMode: z.ZodEnum<{
         in_person: "in_person";
         online: "online";
@@ -2016,11 +2034,15 @@ export declare const publicEventsArraySchema: z.ZodArray<z.ZodUnion<readonly [z.
             series_archived: "series_archived";
             parent_archived: "parent_archived";
             parent_inconsistent: "parent_inconsistent";
-            not_public: "not_public";
             already_started: "already_started";
             enrollment_closed: "enrollment_closed";
         }>;
     }, z.core.$strip>], "kind">;
+    bookingClosedDetail: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"opensSoon">;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"paused">;
+    }, z.core.$strip>], "kind">>;
     deliveryMode: z.ZodEnum<{
         in_person: "in_person";
         online: "online";

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

@@ -1,7 +1,7 @@
 /**
  * Shared types for event display blocks
  */
-import type { LocationCoordinates, PublicEventPricing, PublicEventBookingAvailability, PublicEventPricingOption, PublicEventPricingOptionAvailability } from '../../../../../../core/src/index';
+import type { LocationCoordinates, PublicEventPricing, PublicEventBookingAvailability, PublicEventBookingClosedDetail, PublicEventPricingOption, PublicEventPricingOptionAvailability } from '../../../../../../core/src/index';
 import type { Media } from '../../../../lib/media';
 import type { RichTextDoc } from '../../../manifest/richTextSchema';
 import type { BlockBookingPaymentTerms } from '../../shared/bookingPaymentTerms';
@@ -140,6 +140,19 @@ export type PublicEventBase = {
     requiresRegistration: boolean;
     /** Canonical lifecycle admission; display remains independent from booking. */
     bookingAvailability: PublicEventBookingAvailability;
+    /**
+     * Why an online page is not taking bookings, when that has two readings.
+     *
+     * Only ever present alongside a closed `bookingAvailability`, and only on a
+     * read that named this event and said it was rendering the event's own page.
+     * Every listing, calendar, filter, feed and unscoped read is absent it,
+     * because a unit that is not live never appears in those at all.
+     *
+     * The page also has to be online for this unit in particular: an ordinary
+     * event or a run with its own page speaks for itself, while a run that uses
+     * the course page is only spoken for when no run of that course is live.
+     */
+    bookingClosedDetail?: PublicEventBookingClosedDetail;
     /** How people can attend this event. */
     deliveryMode: 'in_person' | 'online' | 'hybrid';
     /** Per-mode availability used by registration flows. */

package/dist/_dts/blocks/src/system/blocks/newsletter-signup.d.ts

@@ -1,9 +1,10 @@
 import type { SystemBlockDefinition } from "../registry";
-import type { SectionStylesContent } from "../fields/boxStyles";
+import type { ContainerStylesContent, SectionStylesContent } from "../fields/boxStyles";
 import { newsletterFormBlockRuntime } from "../runtime/nodes/newsletter-form.interactive";
 import type { MailingListPlacementTargeting } from '../../../../core/src/index';
 import type { RichTextDoc } from "../manifest/richTextSchema";
 import type { BlockButtonRole } from "../constants/buttonRoles";
+import type { ContentFromManifest } from '../manifest/derivedContent';
 export declare const newsletterSignupManifest: import("..").DefinedBlockManifest<import("..").BlockContentShapeInput<{
     readonly id: "block.newsletter-signup";
     readonly title: "Newsletter Signup";
@@ -120,10 +121,12 @@ export declare const newsletterSignupManifest: import("..").DefinedBlockManifest
 export type NewsletterSignupContent = {
     title?: string | null;
     subtitle?: RichTextDoc | null;
+    variant?: NonNullable<ContentFromManifest<typeof newsletterSignupManifest>['variant']>;
     targeting: MailingListPlacementTargeting;
     buttonVariant?: BlockButtonRole | null;
     mailingListSource?: 'signed-footer' | null;
     mailingListSourceToken?: string | null;
+    _containerStyles?: ContainerStylesContent;
     _sectionStyles?: SectionStylesContent;
 };
 export type NewsletterSignupAuthoringContent = NewsletterSignupContent;

package/dist/_dts/blocks/src/system/icons/social.d.ts

@@ -1,5 +1,5 @@
 import { type IconComponent } from './svg';
-export declare const SOCIAL_ICON_NAMES: readonly ["SocialFacebook", "SocialInstagram", "SocialLinkedIn", "SocialTikTok", "SocialX", "SocialYouTube"];
+export declare const SOCIAL_ICON_NAMES: readonly ["SocialFacebook", "SocialInstagram", "SocialLinkedIn", "SocialTikTok", "SocialWhatsApp", "SocialX", "SocialYouTube"];
 export type SocialIconName = (typeof SOCIAL_ICON_NAMES)[number];
 export declare function isSocialIconName(value: unknown): value is SocialIconName;
 export declare function getSocialIconComponent(value: unknown): IconComponent | null;