@riverbankcms/sdk 0.145.0 → 0.146.0

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' | 'connect_custom_domain' | 'add_first_offering' | 'add_cover_image' | 'add_public_contact';
+export type LaunchRequirementPackId = 'core' | 'bookings_appointments' | 'bookings_events' | 'bookings_courses' | 'payments' | 'domain' | 'offerings' | 'presence';
 export type LaunchRequirementPriority = 'required' | 'recommended' | 'optional';
 export type LaunchRequirementState = 'complete' | 'pending';
 export type LaunchRequirementOwner = 'admin' | 'editor' | 'either';
@@ -162,23 +162,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,6 +200,24 @@ export type LaunchCoursesPackState = {
 } | {
     kind: 'pending_setup';
 };
+/** Booking pages only: whether the site has anything people could book. */
+export type LaunchOfferingsPackState = {
+    kind: 'has_offerings';
+} | {
+    kind: 'none';
+};
+/** Booking pages only. */
+export type LaunchCoverImagePackState = {
+    kind: 'set';
+} | {
+    kind: 'missing';
+};
+/** Booking pages only: whether any contact method is published. */
+export type LaunchPublicContactPackState = {
+    kind: 'published';
+} | {
+    kind: 'missing';
+};
 export type LaunchCustomDomainPackState = {
     kind: 'connected';
     domainIds: readonly string[];
@@ -196,11 +227,28 @@ export type LaunchCustomDomainPackState = {
 } | {
     kind: 'pending_setup';
 };
-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 +256,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/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 { PublishedBlockPlacement } 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,20 @@ export type PageBlockRenderAdmissionError = Readonly<{
 }> | Readonly<{
     kind: 'manifest_unavailable';
 }>;
+export type PublishedBlockPlacement = Readonly<{
+    id: string;
+    content: Record<string, unknown>;
+}>;
+/** 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): PublishedBlockPlacement | null;
 export type RenderablePageBlock = Readonly<{
     id: Block['id'];
     kind: Block['kind'];
     purpose: Block['purpose'];
     bindings?: Block['bindings'];
     contentVersionId?: string | null;
+    draftContentId?: string | null;
+    publishedPlacement?: PublishedBlockPlacement | null;
     admission: Readonly<{
         kind: 'renderable';
         content: RenderableManifestContent;
@@ -34,6 +42,8 @@ export type PresentationAdmission = Readonly<{
 export type PresentationBlock = Block & Readonly<{
     presentationAdmission: PresentationAdmission;
     contentVersionId?: string | null;
+    draftContentId?: string | null;
+    publishedPlacement?: PublishedBlockPlacement | null;
 }>;
 export type PresentationPageOutline = Omit<PageOutline, 'blocks'> & Readonly<{
     blocks: readonly PresentationBlock[];

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;
 };
@@ -141,7 +143,7 @@ export type PageRendererDataContext = {
     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/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;

package/dist/_dts/blocks/src/system/registry.d.ts

@@ -25,7 +25,7 @@ export type SystemBlockComponentProps<TContent = Record<string, unknown>> = {
     data?: Record<string, unknown>;
     pathBase?: string;
     blockId?: string | null;
-    contentVersionId?: string | null;
+    newsletterBlockSubmission?: ResolverContext['newsletterBlockSubmission'];
     blockKind?: string;
     blockBindings?: Record<string, unknown>;
     editableRouteMetadataFieldIds?: ResolverContext['editableRouteMetadataFieldIds'];

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

@@ -36,6 +36,7 @@ export declare const eventRecoveryRequestSchema: z.ZodObject<{
     seriesSlug: z.ZodOptional<z.ZodString>;
     includeOccurrenceId: z.ZodOptional<z.ZodString>;
     readIntent: z.ZodOptional<z.ZodString>;
+    detailAdmission: z.ZodOptional<z.ZodString>;
     readProfile: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type EventRecoveryRequest = Omit<PublicEventsRequest, 'siteId'>;

package/dist/_dts/blocks/src/system/runtime/nodes/events/shared/eventCollectionContract.d.ts

@@ -488,11 +488,15 @@ export declare const eventCollectionSourceSchemaShape: {
                 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";
@@ -973,11 +977,15 @@ export declare const eventCollectionSourceSchemaShape: {
                 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";
@@ -1519,11 +1527,15 @@ export declare const eventCollectionDisplaySchemaShape: {
                 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";
@@ -2004,11 +2016,15 @@ export declare const eventCollectionDisplaySchemaShape: {
                 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/runtime/nodes/form.fields.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+import type { FormFieldDef } from './form.types';
+export declare function FormFieldControl({ field }: Readonly<{
+    field: FormFieldDef;
+}>): React.ReactElement;

package/dist/_dts/blocks/src/system/runtime/nodes/newsletter-form.block-submission.d.ts

@@ -0,0 +1,36 @@
+import { type MailingListSignupSourceRef } from '../../../../../core/src/index';
+export type NewsletterBlockSubmission = Readonly<{
+    tag: 'ready';
+    sourceRef: Extract<MailingListSignupSourceRef, {
+        tag: 'block_ref';
+    }>;
+}> | Readonly<{
+    tag: 'unpublished-form';
+}> | Readonly<{
+    tag: 'unpublished-settings';
+}> | Readonly<{
+    tag: 'unavailable';
+}>;
+type BlockPlacement = Readonly<{
+    blockId: string | null;
+    selectedContentVersionId: string | null;
+    publishedPlacement: Readonly<{
+        id: string;
+        content: Record<string, unknown>;
+    }> | null;
+    renderedContent: Record<string, unknown>;
+    stage: 'published' | 'preview' | undefined;
+}>;
+/** Authorise one block source for both public and preview rendering. */
+export declare function planNewsletterBlockSubmission(placement: BlockPlacement): NewsletterBlockSubmission;
+type PreviewPlacement = Readonly<{
+    blockId: string | null;
+    publishedContentId: string | null;
+    renderedContent: Record<string, unknown>;
+    publishedContent: Record<string, unknown> | null;
+}>;
+/** Decide whether the visible draft can safely cite the published placement. */
+export declare function planNewsletterPreviewSubmission(placement: PreviewPlacement): Exclude<NewsletterBlockSubmission, {
+    tag: 'unavailable';
+}>;
+export {};

package/dist/_dts/blocks/src/system/runtime/nodes/newsletter-form.client.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import type { NewsletterFormInteractiveIslandProps } from './newsletter-form.interactive';
+import { type NewsletterFormInteractiveIslandProps } from './newsletter-form.interactive';
 /**
  * Newsletter Form Client Component
  *

package/dist/_dts/blocks/src/system/runtime/nodes/newsletter-form.interactive.d.ts

@@ -31,7 +31,12 @@ export type NewsletterFormHydrationTarget = Readonly<{
     sourceRef: MailingListSignupSignedSourceRef;
 }> | Readonly<{
     tag: 'preview';
+}> | Readonly<{
+    tag: 'unpublished-preview';
+    reason: 'unpublished-form' | 'unpublished-settings';
 }>;
+export declare const NEWSLETTER_SIGNUPS_PAUSED_MESSAGE = "We can\u2019t accept signups right now. Please try again later.";
+export declare function newsletterBlockSubmissionMessage(target: NewsletterFormHydrationTarget): string | null;
 type MailingListSignupBlockSourceRef = Extract<MailingListSignupSourceRef, {
     tag: 'block_ref';
 }>;
@@ -42,7 +47,7 @@ type NewsletterIslandMeta = Readonly<{
     siteId?: string;
     apiBaseUrl?: string;
 }>;
-export declare function buildNewsletterDisplay(source: NewsletterFormSourceProps): NewsletterFormDisplay;
+export declare function buildNewsletterDisplay(source: Pick<NewsletterFormSourceProps, 'source' | 'mailingList' | 'targeting' | 'buttonVariant' | 'className'>): NewsletterFormDisplay;
 export type NewsletterFormInteractiveIslandProps = InteractiveIslandProps<NewsletterIslandMeta, 'newsletter-form', typeof newsletterFormBlockRuntime>;
 export declare const newsletterFormBlockRuntime: Readonly<{
     kind: "progressive";

package/dist/_dts/blocks/src/system/runtime/nodes/newsletter-form.parts.d.ts

@@ -0,0 +1,46 @@
+import React from 'react';
+import type { NewsletterButtonVariant, NewsletterFieldDef } from './newsletter-form.types';
+/**
+ * Newsletter form pieces shared by the SSR render and the hydrated island, so
+ * both produce the same markup.
+ *
+ * Labels are visually hidden: every field has a placeholder, and a visible
+ * "Email *" label over a single field reads like a generic form. Screen
+ * readers still get the label.
+ */
+export declare const TOPIC_CHOICE_FIELD_ID = "mailingListChoice";
+type FieldState = Readonly<{
+    disabled?: boolean;
+    error?: string | null;
+}>;
+/** Splits the preset's fields into the email (joined with the button) and the rest. */
+export declare function partitionNewsletterFields(fields: readonly NewsletterFieldDef[]): Readonly<{
+    email: NewsletterFieldDef | null;
+    extra: readonly NewsletterFieldDef[];
+}>;
+export declare function NewsletterExtraField({ field, disabled, error, }: Readonly<{
+    field: NewsletterFieldDef;
+}> & FieldState): React.ReactElement;
+/** The email field and submit button sharing one input-styled shell. */
+export declare function NewsletterEmailEntry({ field, buttonVariant, buttonLabel, disabled, error, }: Readonly<{
+    field: NewsletterFieldDef;
+    buttonVariant: NewsletterButtonVariant;
+    buttonLabel: string;
+}> & FieldState): React.ReactElement;
+/**
+ * The submit action: joined to the email field when the preset has one
+ * (every current preset does), otherwise a plain themed button.
+ */
+export declare function NewsletterSubmitRow({ emailField, buttonVariant, buttonLabel, disabled, error, }: Readonly<{
+    emailField: NewsletterFieldDef | null;
+    buttonVariant: NewsletterButtonVariant;
+    buttonLabel: string;
+}> & FieldState): React.ReactElement;
+/** Visitor-chosen topics as toggle chips. Real checkboxes underneath. */
+export declare function NewsletterTopicChips({ choices, disabled, error, }: Readonly<{
+    choices: readonly Readonly<{
+        id: string;
+        label: string;
+    }>[];
+}> & FieldState): React.ReactElement;
+export {};

package/dist/_dts/blocks/src/system/runtime/nodes/newsletter-form.types.d.ts

@@ -5,6 +5,7 @@
  */
 import type { MailingListGlobalForm, MailingListPlacementTargeting, MailingListRuntimeContext, MailingListSignupSourceRef } from '../../../../../core/src/index';
 import type { BlockButtonRole } from '../../constants/buttonRoles';
+import type { NewsletterBlockSubmission } from './newsletter-form.block-submission';
 export type NewsletterPreset = MailingListGlobalForm['fields']['preset'];
 export type NewsletterFieldDef = {
     id: string;
@@ -33,7 +34,7 @@ type NewsletterFormCommonProps = {
 type BlockNewsletterFormSource = Readonly<{
     source: 'block';
     blockId?: string | null;
-    contentVersionId?: string | null;
+    newsletterBlockSubmission: NewsletterBlockSubmission;
 }>;
 type SignedFooterNewsletterFormSource = Readonly<{
     source: 'signed-footer';