@riverbankcms/sdk 0.146.0 → 0.147.0

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

@@ -5,7 +5,7 @@ export type { CustomBlockConflictReason, CustomBlockManifestSource, CustomBlockR
 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 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

@@ -10,8 +10,13 @@ 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): PublishedBlockPlacement | null;
+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'];
@@ -19,7 +24,8 @@ export type RenderablePageBlock = Readonly<{
     bindings?: Block['bindings'];
     contentVersionId?: string | null;
     draftContentId?: string | null;
-    publishedPlacement?: PublishedBlockPlacement | null;
+    draftContent?: Record<string, unknown> | null;
+    publishedPlacement: PublishedBlockPlacementRead;
     admission: Readonly<{
         kind: 'renderable';
         content: RenderableManifestContent;
@@ -43,10 +49,22 @@ export type PresentationBlock = Block & Readonly<{
     presentationAdmission: PresentationAdmission;
     contentVersionId?: string | null;
     draftContentId?: string | null;
-    publishedPlacement?: PublishedBlockPlacement | 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

@@ -137,6 +137,8 @@ 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;

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/runtime/api/types/appointments.d.ts

@@ -1,3 +1,4 @@
+import type { BookingMailingListNote as BookingSignupNote } from '../../../../../../core/src/index';
 /**
  * Appointment booking, availability, service and resource types
  *
@@ -12,6 +13,7 @@ export interface BookingSubmitRequest {
     startAt: string;
     endAt: string;
     customFields: Record<string, unknown>;
+    mailingListOptIn?: boolean;
     timezone: string;
     discountCode?: string;
     selectedSlidingAmount?: number;
@@ -43,6 +45,7 @@ export type BookingSubmitResponse = {
     orderNumber: string;
     appointment: BookingAppointmentSummary;
     customer: BookingCustomerSummary;
+    mailingListSignupNote?: BookingSignupNote;
 } | {
     type: "checkout_redirect";
     orderId: string;
@@ -51,6 +54,7 @@ export type BookingSubmitResponse = {
     sessionId: string;
     appointment: BookingAppointmentSummary;
     customer: BookingCustomerSummary;
+    mailingListSignupNote?: BookingSignupNote;
 };
 export type EligibleAppointmentPackage = {
     customerPassId: string;

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

@@ -1,3 +1,4 @@
+import type { BookingMailingListNote as BookingSignupNote } from '../../../../../../core/src/index';
 /**
  * Public event, registration, checkout and eligibility types
  *
@@ -124,6 +125,7 @@ export interface EventRegisterRequest {
     notes?: string;
     formData?: Record<string, unknown>;
     consentAccepted?: boolean;
+    mailingListOptIn?: boolean;
     altchaSolution?: string | null;
     paymentMethod?: PaymentMethod;
     customerPassId?: string;
@@ -154,6 +156,7 @@ export type EventRegisterResponse = {
     kind: 'bookingComplete';
     reference: EventRegistrationStatusReference;
     summary: EventRegistrationSummary;
+    mailingListSignupNote?: BookingSignupNote;
 } | {
     kind: 'paymentDeferred';
     reference: EventRegistrationStatusReference;
@@ -162,16 +165,20 @@ export type EventRegisterResponse = {
         amountCents: number;
         currency: string;
     };
+    mailingListSignupNote?: BookingSignupNote;
 } | {
     kind: 'checkoutRequired';
     reference: EventRegistrationStatusReference;
     checkoutUrl: string;
     submissionId: string;
+    mailingListSignupNote?: BookingSignupNote;
 } | {
     kind: 'paymentStatusRequired';
     subject: EventRegistrationPaymentSubject;
+    mailingListSignupNote?: BookingSignupNote;
 } | {
     kind: 'waitlisted';
+    mailingListSignupNote?: BookingSignupNote;
     waitlist: {
         reference: {
             scope: 'occurrence';
@@ -214,6 +221,7 @@ export type EventCheckoutRequest = EventCheckoutRequestCommon & ({
     phone?: string;
     formData?: Record<string, unknown>;
     consentAccepted?: boolean;
+    mailingListOptIn?: boolean;
     altchaSolution?: string | null;
     guests?: EventRegisterGuest[];
     claimToken?: string;
@@ -226,6 +234,7 @@ type OccurrenceCheckoutResponse = Readonly<{
     checkoutUrl: string | null;
     sessionId: string | null;
     bypassed: boolean;
+    mailingListSignupNote?: BookingSignupNote;
 }>;
 type WholeSeriesCheckoutResponse = Readonly<{
     scope: 'wholeSeries';
@@ -235,12 +244,14 @@ type WholeSeriesCheckoutResponse = Readonly<{
     checkoutUrl: string | null;
     sessionId: string | null;
     bypassed: boolean;
+    mailingListSignupNote?: BookingSignupNote;
 }>;
 type WholeSeriesPaymentStatusRequired = Readonly<{
     scope: 'wholeSeries';
     status: 'paymentStatusRequired';
     checkoutAttemptId: string;
     recoverableUntil: string;
+    mailingListSignupNote?: BookingSignupNote;
 }>;
 type WholeSeriesWaitlistResponse = Readonly<{
     scope: 'wholeSeries';
@@ -248,6 +259,7 @@ type WholeSeriesWaitlistResponse = Readonly<{
     waitlistEntryId: string;
     waitlistPosition: number | null;
     alreadyRegistered?: boolean;
+    mailingListSignupNote?: BookingSignupNote;
 }>;
 export type EventCheckoutResponse = OccurrenceCheckoutResponse | WholeSeriesCheckoutResponse | WholeSeriesPaymentStatusRequired | WholeSeriesWaitlistResponse;
 export interface EligiblePass {

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

@@ -1570,6 +1570,8 @@ export declare const runtimeBackedBlockClientEntries: {
                 siteMemberships?: Readonly<{
                     memberships: readonly import("../..").PublicMembershipProduct[];
                 }> | null;
+                mailingList?: import("../../../../../core/src/index").MailingListRuntimeContext;
+                siteName?: string;
             }>) => Readonly<{
                 display: import("../nodes/event-registration.interactive").EventRegistrationDisplay;
                 hydration: Readonly<Omit<import("../nodes/event-registration").EventRegistrationClientProps, "siteId" | "stage" | "className" | "events" | "buttonText"> & {
@@ -1606,6 +1608,8 @@ export declare const runtimeBackedBlockClientEntries: {
                         siteMemberships?: Readonly<{
                             memberships: readonly import("../..").PublicMembershipProduct[];
                         }> | null;
+                        mailingList?: import("../../../../../core/src/index").MailingListRuntimeContext;
+                        siteName?: string;
                     }>) => unknown;
                     decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<{
                         siteId?: string;
@@ -1635,6 +1639,8 @@ export declare const runtimeBackedBlockClientEntries: {
                         siteMemberships?: Readonly<{
                             memberships: readonly import("../..").PublicMembershipProduct[];
                         }> | null;
+                        mailingList?: import("../../../../../core/src/index").MailingListRuntimeContext;
+                        siteName?: string;
                     }>>;
                 }>;
                 render: Readonly<{
@@ -1686,6 +1692,8 @@ export declare const runtimeBackedBlockClientEntries: {
                     siteMemberships?: Readonly<{
                         memberships: readonly import("../..").PublicMembershipProduct[];
                     }> | null;
+                    mailingList?: import("../../../../../core/src/index").MailingListRuntimeContext;
+                    siteName?: string;
                 }>) => Readonly<{
                     display: import("../nodes/event-registration.interactive").EventRegistrationDisplay;
                     hydration: Readonly<Omit<import("../nodes/event-registration").EventRegistrationClientProps, "siteId" | "stage" | "className" | "events" | "buttonText"> & {
@@ -1722,6 +1730,8 @@ export declare const runtimeBackedBlockClientEntries: {
                             siteMemberships?: Readonly<{
                                 memberships: readonly import("../..").PublicMembershipProduct[];
                             }> | null;
+                            mailingList?: import("../../../../../core/src/index").MailingListRuntimeContext;
+                            siteName?: string;
                         }>) => unknown;
                         decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<{
                             siteId?: string;
@@ -1751,6 +1761,8 @@ export declare const runtimeBackedBlockClientEntries: {
                             siteMemberships?: Readonly<{
                                 memberships: readonly import("../..").PublicMembershipProduct[];
                             }> | null;
+                            mailingList?: import("../../../../../core/src/index").MailingListRuntimeContext;
+                            siteName?: string;
                         }>>;
                     }>;
                     render: Readonly<{

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

@@ -799,6 +799,8 @@ export declare const runtimeBackedBlockServerEntries: {
                 siteMemberships?: Readonly<{
                     memberships: readonly import("../..").PublicMembershipProduct[];
                 }> | null;
+                mailingList?: import("../../../../../core/src/index").MailingListRuntimeContext;
+                siteName?: string;
             }>) => Readonly<{
                 display: import("../nodes/event-registration.interactive").EventRegistrationDisplay;
                 hydration: Readonly<Omit<import("../nodes/event-registration").EventRegistrationClientProps, "siteId" | "stage" | "className" | "events" | "buttonText"> & {
@@ -835,6 +837,8 @@ export declare const runtimeBackedBlockServerEntries: {
                         siteMemberships?: Readonly<{
                             memberships: readonly import("../..").PublicMembershipProduct[];
                         }> | null;
+                        mailingList?: import("../../../../../core/src/index").MailingListRuntimeContext;
+                        siteName?: string;
                     }>) => unknown;
                     decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<{
                         siteId?: string;
@@ -864,6 +868,8 @@ export declare const runtimeBackedBlockServerEntries: {
                         siteMemberships?: Readonly<{
                             memberships: readonly import("../..").PublicMembershipProduct[];
                         }> | null;
+                        mailingList?: import("../../../../../core/src/index").MailingListRuntimeContext;
+                        siteName?: string;
                     }>>;
                 }>;
                 render: Readonly<{

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

@@ -1,4 +1,5 @@
 import React from "react";
+import type { MailingListRuntimeContext } from "../../../../../core/src/index";
 import { type BlockApiConfig } from "../api";
 import type { AutoAppliedDiscountPreview } from "../api/types";
 import type { BookingFormConfig, BookingFormData, BookingFormService, BookingFormServiceCategory, BookingSelectedCollectionOptionKind } from "../nodes/booking-form.state";
@@ -8,6 +9,8 @@ export type { BlockApiConfig };
 export type { BookingAppointmentPackagesModel };
 export { createBookingBlockApiConfig };
 export type HeadlessBookingFlowOptions = Readonly<{
+    mailingList?: MailingListRuntimeContext;
+    siteName?: string;
     siteId: string;
     formId: string;
     form: BookingFormConfig | null;
@@ -111,6 +114,7 @@ export type BookingFlowActions = Readonly<{
     selectDate: (date: string | null) => void;
     selectSlot: (slot: BookingSlotSelection | null) => void;
     updateField: (fieldId: string, value: BookingFieldValue) => void;
+    setMailingListOptIn: (checked: boolean) => void;
     markFieldTouched: (fieldId: string) => void;
     selectPaymentOption: (kind: BookingSelectedCollectionOptionKind | null) => void;
     selectAppointmentPackage: (packageId: string | null) => void;
@@ -131,6 +135,10 @@ export type BookingFlowActions = Readonly<{
     clearFeedback: () => void;
 }>;
 export type HeadlessBookingFlow = Readonly<{
+    mailingList: Readonly<{
+        siteName: string;
+    }> | null;
+    mailingListOptIn: boolean;
     status: BookingFlowStatus;
     view: BookingFlowView;
     steps: readonly BookingFlowStep[];

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

@@ -21,6 +21,8 @@ export type HeadlessEventRegistrationFlowOptions = Readonly<{
     events?: readonly NonNullable<EventRegistrationClientProps['events']>[number][];
     maxTickets?: string | number;
     spamProtectionEnabled?: boolean;
+    mailingList?: EventRegistrationClientProps['mailingList'];
+    siteName?: string;
 }>;
 export type HeadlessEventRegistrationProviderProps = Readonly<{
     config: BlockApiConfig;

package/dist/_dts/blocks/src/system/runtime/nodes/booking-form.completion.d.ts

@@ -0,0 +1,9 @@
+import type { BookingMailingListNote as BookingSignupNote } from '../../../../../core/src/index';
+import React from "react";
+import { type BookingRedirectState } from "./booking-form.state";
+export declare function BookingFormCompletion({ resourceName, successMessage, redirectState, localNote, }: Readonly<{
+    resourceName?: string | null;
+    successMessage?: string | null;
+    redirectState: BookingRedirectState;
+    localNote: BookingSignupNote | null;
+}>): React.ReactElement;

package/dist/_dts/blocks/src/system/runtime/nodes/booking-form.headless.state.d.ts

@@ -1,3 +1,4 @@
+import type { BookingMailingListNote as BookingSignupNote } from '../../../../../core/src/index';
 import type { AppointmentResourceId, AppointmentServiceId, Brand, CustomerPassId, FormId, PassId, SiteId } from "../../../../../core/src/index";
 import type { BlockApiConfig, EligibleAppointmentPackage } from "../api/types";
 import type { TimeSlot } from "../api/types";
@@ -136,12 +137,15 @@ export type BookingSubmitActionResult = Readonly<{
         kind: "booked";
         appointmentId: string;
         resourceName: string | null;
+        mailingListSignupNote?: BookingSignupNote;
     };
 }> | Readonly<{
     ok: true;
     outcome: {
         kind: "checkout_redirect";
         checkoutUrl: string;
+        sessionId: string;
+        mailingListSignupNote?: BookingSignupNote;
     };
 }> | Exclude<BookingFlowActionResult, Readonly<{
     ok: true;
@@ -170,6 +174,7 @@ export type BookingFlowReducerState = Readonly<{
     selectedDate?: string;
     selectedSlot: BookingSlotView | null;
     fieldValues: Readonly<Record<string, BookingFieldValue>>;
+    mailingListOptIn: boolean;
     touchedFields: Readonly<Record<string, boolean>>;
     /**
      * Steps the user has tried to advance past. Step validation is derived
@@ -205,6 +210,9 @@ export type BookingFlowEvent = Readonly<{
 }> | Readonly<{
     type: "field-touched";
     fieldId: BookingFieldId;
+}> | Readonly<{
+    type: "mailing-list-opt-in-set";
+    checked: boolean;
 }> | Readonly<{
     type: "step-advance-attempted";
     stepId: BookingFlowStepId;
@@ -504,6 +512,7 @@ export declare function buildBookingSubmitPlan(input: Readonly<{
     redirect: BookingSubmitRedirectMode;
     successUrl?: string;
     cancelUrl?: string;
+    mailingListEligible?: boolean;
 }>): BookingSubmitPlan;
 export declare function getAppointmentBookingOverrideInput(props: AppointmentBookingOverridePropsLike): AppointmentBookingOverrideInputResult;
 export declare function createBookingBlockApiConfig(input: Readonly<{

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

@@ -1,3 +1,4 @@
+import { type MailingListRuntimeContext } from "../../../../../core/src/index";
 import { type InteractiveIslandProps } from "../../../contracts/islands";
 import { type BookingFormService, type BookingFormServiceCategory, type BookingFormConfig, type BookingFormServicesSource } from "./booking-form.state";
 import { type BookingFormRebookContext, type BookingFormSourceProps } from "./booking-runtime-sources";
@@ -12,6 +13,8 @@ export type BookingFormDisplay = Readonly<{
     message: string | null;
 }>;
 export type BookingFormHydration = Readonly<{
+    mailingList?: MailingListRuntimeContext;
+    siteName?: string;
     formId: string | null;
     serviceId: string | null;
     resourceId: string | null;
@@ -43,6 +46,8 @@ export declare const bookingFormBlockRuntime: Readonly<{
         siteId?: string;
         apiBaseUrl?: string;
         portalToken?: string | null;
+        mailingList?: MailingListRuntimeContext;
+        siteName?: string;
         formId?: string;
         serviceId?: string | null;
         resourceId?: string | null;
@@ -89,6 +94,8 @@ export declare const bookingFormBlockRuntime: Readonly<{
             message: string | null;
         }>;
         hydration: Readonly<{
+            mailingList?: MailingListRuntimeContext;
+            siteName?: string;
             formId: string | null;
             serviceId: string | null;
             resourceId: string | null;
@@ -168,6 +175,8 @@ export declare const bookingFormBlockRuntime: Readonly<{
                 siteId?: string;
                 apiBaseUrl?: string;
                 portalToken?: string | null;
+                mailingList?: MailingListRuntimeContext;
+                siteName?: string;
                 formId?: string;
                 serviceId?: string | null;
                 resourceId?: string | null;
@@ -209,6 +218,8 @@ export declare const bookingFormBlockRuntime: Readonly<{
                 siteId?: string;
                 apiBaseUrl?: string;
                 portalToken?: string | null;
+                mailingList?: MailingListRuntimeContext;
+                siteName?: string;
                 formId?: string;
                 serviceId?: string | null;
                 resourceId?: string | null;
@@ -258,6 +269,8 @@ export declare const bookingFormBlockRuntime: Readonly<{
                     message: string | null;
                 }>;
                 hydration: Readonly<{
+                    mailingList?: MailingListRuntimeContext;
+                    siteName?: string;
                     formId: string | null;
                     serviceId: string | null;
                     resourceId: string | null;
@@ -341,6 +354,8 @@ export declare const bookingFormBlockRuntime: Readonly<{
                     message: string | null;
                 }>;
                 hydration: Readonly<{
+                    mailingList?: MailingListRuntimeContext;
+                    siteName?: string;
                     formId: string | null;
                     serviceId: string | null;
                     resourceId: string | null;
@@ -436,6 +451,8 @@ export declare const bookingFormInteractiveIslandPropsCodec: Readonly<{
                 message: string | null;
             }>;
             hydration: Readonly<{
+                mailingList?: MailingListRuntimeContext;
+                siteName?: string;
                 formId: string | null;
                 serviceId: string | null;
                 resourceId: string | null;
@@ -528,6 +545,8 @@ export declare const bookingFormInteractiveIslandPropsCodec: Readonly<{
                 message: string | null;
             }>;
             hydration: Readonly<{
+                mailingList?: MailingListRuntimeContext;
+                siteName?: string;
                 formId: string | null;
                 serviceId: string | null;
                 resourceId: string | null;

package/dist/_dts/blocks/src/system/runtime/nodes/booking-form.mailing-list-choice.d.ts

@@ -0,0 +1,5 @@
+import React from "react";
+import type { HeadlessBookingFlow } from "../hooks/useHeadlessBookingFlow";
+export declare function BookingMailingListChoice({ booking, }: Readonly<{
+    booking: HeadlessBookingFlow;
+}>): React.ReactElement | null;

package/dist/_dts/blocks/src/system/runtime/nodes/booking-form.mailing-list-note.d.ts

@@ -0,0 +1,3 @@
+import type { BookingMailingListNote } from '../../../../../core/src/index';
+export declare function saveAppointmentMailingListNote(sessionId: string, note: BookingMailingListNote | undefined): void;
+export declare function readAppointmentMailingListNote(sessionId: string): BookingMailingListNote | null;

package/dist/_dts/blocks/src/system/runtime/nodes/booking-form.mailing-list-state.d.ts

@@ -0,0 +1,9 @@
+import type { BookingFormData } from "./booking-form.state";
+import type { BookingFlowReducerState, BookingFlowEvent } from "./booking-form.headless.state";
+export declare function bookingFormDataWithEligibleOptIn(data: BookingFormData, eligible: boolean): BookingFormData;
+type ContactEvent = Extract<BookingFlowEvent, {
+    type: "field-updated" | "field-touched" | "mailing-list-opt-in-set";
+}>;
+export declare function isBookingContactEvent(event: BookingFlowEvent): event is ContactEvent;
+export declare function applyBookingContactEvent(state: BookingFlowReducerState, event: ContactEvent): BookingFlowReducerState;
+export {};

package/dist/_dts/blocks/src/system/runtime/nodes/booking-form.reserved-fields.d.ts

@@ -1,5 +1,5 @@
 export declare const APPOINTMENT_BOOKING_BLOCK_ID: "block.appointment-booking";
-export declare const BOOKING_FORM_DATA_RESERVED_KEY_VALUES: readonly ["serviceId", "resourceId", "selectedDate", "selectedSlot", "discountCode", "selectedSlidingAmountInput", "selectedCollectionOptionKind", "selectedAppointmentPackageId"];
+export declare const BOOKING_FORM_DATA_RESERVED_KEY_VALUES: readonly ["serviceId", "resourceId", "selectedDate", "selectedSlot", "discountCode", "selectedSlidingAmountInput", "selectedCollectionOptionKind", "selectedAppointmentPackageId", "mailingListOptIn"];
 export type BookingFormDataReservedKey = (typeof BOOKING_FORM_DATA_RESERVED_KEY_VALUES)[number];
 export type BookingReservedFieldCollision = Readonly<{
     fieldId: BookingFormDataReservedKey;

package/dist/_dts/blocks/src/system/runtime/nodes/booking-form.server.d.ts

@@ -17,5 +17,5 @@ type BookingFormProps = BookingFormSourceProps & Readonly<{
  * own `.rb-reg-surface`, and leaves no stale loading state on the mounted form.
  * `event-registration.server.tsx` follows the same shape.
  */
-export declare function BookingFormSSR({ blockId, siteId, apiBaseUrl, portalToken, formId, serviceId, resourceId, initialData, noticeMessage, requiresServiceSelection, requiresResourceSelection, shouldAutoSelectSingleResource, rebookContext, submitLabel, successMessage, form, services, spamProtectionEnabled, className, children, }: BookingFormProps): React.JSX.Element;
+export declare function BookingFormSSR({ blockId, children, ...sourceProps }: BookingFormProps): React.JSX.Element;
 export default BookingFormSSR;

package/dist/_dts/blocks/src/system/runtime/nodes/booking-form.state.d.ts

@@ -83,6 +83,7 @@ export type BookingFormData<TCustomFieldId extends string = never> = Readonly<{
     selectedSlidingAmountInput?: string;
     selectedCollectionOptionKind?: BookingSelectedCollectionOptionKind;
     selectedAppointmentPackageId?: string;
+    mailingListOptIn?: boolean;
 }> & BookingCustomFieldData<TCustomFieldId>;
 type RuntimeBookingFormData = BookingFormData<string>;
 type BookingSubmissionCommon = Readonly<{
@@ -92,6 +93,7 @@ type BookingSubmissionCommon = Readonly<{
     startAt: string;
     endAt: string;
     customFields: Readonly<Record<string, unknown>>;
+    mailingListOptIn?: boolean;
     timezone: string;
 }>;
 export type BookingSubmissionData = (BookingSubmissionCommon & Readonly<{

package/dist/_dts/blocks/src/system/runtime/nodes/booking-form.submit-handler.d.ts

@@ -0,0 +1,8 @@
+import type { BookingMailingListNote as BookingSignupNote } from '../../../../../core/src/index';
+import type { HeadlessBookingFlow } from "../hooks/useHeadlessBookingFlow";
+export declare function createBookingFormSubmitHandler(input: Readonly<{
+    booking: HeadlessBookingFlow;
+    bookingAnchorId: string;
+    isPortalRebook: boolean;
+    setLocalMailingListNote: (note: BookingSignupNote | null) => void;
+}>): () => Promise<void>;

package/dist/_dts/blocks/src/system/runtime/nodes/booking-form.submit-success.d.ts

@@ -0,0 +1,9 @@
+import type { BookingSubmitResponse } from "../api/types";
+import type { BookingFlowEvent, BookingSubmitActionResult } from "./booking-form.headless.state";
+export declare function completeBookingSubmission(input: Readonly<{
+    data: BookingSubmitResponse;
+    redirect: "auto" | "manual";
+    successMessage?: string | null;
+    navigateToCheckout: (url: string) => void;
+    dispatch: (event: BookingFlowEvent) => void;
+}>): BookingSubmitActionResult;

package/dist/_dts/blocks/src/system/runtime/nodes/booking-runtime-sources.d.ts

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import type { MailingListRuntimeContext } from "../../../../../core/src/index";
 import type { PublicEvent } from "../../blocks/events/shared/types";
 import type { StandardBookingFormField, BookingFormService, BookingFormServiceCategory, BookingFormServicesSource, BookingFormSettings, BookingFormSourceRecord } from "./booking-form.state";
 import type { EventRegistrationSourceProps } from "./event-registration.interactive";
@@ -10,6 +11,8 @@ export type BookingFormSourceProps = Readonly<{
     siteId?: string;
     apiBaseUrl?: string;
     portalToken?: string | null;
+    mailingList?: MailingListRuntimeContext;
+    siteName?: string;
     formId?: string;
     serviceId?: string | null;
     resourceId?: string | null;

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

@@ -24,6 +24,9 @@ type AttendeeDetailsStepProps = {
     /** Callback when guest section shake animation ends */
     onGuestShakeEnd?: () => void;
     consent: BlockBookingConsent | null;
+    mailingListSignup?: Readonly<{
+        siteName: string;
+    }> | null;
 };
 /**
  * Attendee Details Step

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

@@ -1,8 +1,11 @@
+import type { BookingMailingListNote as BookingSignupNote } from '../../../../../../core/src/index';
 import React from 'react';
 type SuccessStepProps = {
     title?: string;
     message: string;
     variant?: 'success' | 'info';
+    mailingListSignupNote?: BookingSignupNote;
+    context?: 'booking' | 'waitlist';
 };
 /**
  * Success Step

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

@@ -122,6 +122,9 @@ export type EventRegistrationTicketsModel = Readonly<{
 export type EventRegistrationAttendeeModel = Readonly<{
     values: FormData;
     errors: Partial<Record<keyof FormData, string>>;
+    mailingListSignup: Readonly<{
+        siteName: string;
+    }> | null;
 }>;
 export type EventRegistrationGuestsModel = Readonly<{
     required: boolean;

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

@@ -1,3 +1,4 @@
+import type { BookingMailingListNote as BookingSignupNote } from '../../../../../../core/src/index';
 /**
  * SessionStorage utilities for preserving form state across Stripe redirects.
  *
@@ -22,6 +23,7 @@ type PendingRegistrationV5 = {
     paymentSelection: PaymentSelection & {
         method: Exclude<PaymentSelection['method'], null>;
     };
+    mailingListSignupNote?: BookingSignupNote;
     timestamp: number;
 };
 export type PendingRegistration = PendingRegistrationV5;