@riverbankcms/sdk 0.146.0 → 0.148.0

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

@@ -1306,6 +1306,7 @@ export declare const runtimeBackedBlockClientEntries: {
                 hydration: Readonly<{
                     emptyStateText: string;
                     submitButtonText: string;
+                    demoEmailSuppressed?: boolean;
                 }>;
             }>;
             contracts: Readonly<{
@@ -1326,6 +1327,7 @@ export declare const runtimeBackedBlockClientEntries: {
                         hydration: Readonly<{
                             emptyStateText: string;
                             submitButtonText: string;
+                            demoEmailSuppressed?: boolean;
                         }>;
                     }>) => unknown;
                     decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<{
@@ -1340,6 +1342,7 @@ export declare const runtimeBackedBlockClientEntries: {
                         hydration: Readonly<{
                             emptyStateText: string;
                             submitButtonText: string;
+                            demoEmailSuppressed?: boolean;
                         }>;
                     }>>;
                 }>;
@@ -1362,6 +1365,7 @@ export declare const runtimeBackedBlockClientEntries: {
                     hydration: Readonly<{
                         emptyStateText: string;
                         submitButtonText: string;
+                        demoEmailSuppressed?: boolean;
                     }>;
                 }>;
                 contracts: Readonly<{
@@ -1382,6 +1386,7 @@ export declare const runtimeBackedBlockClientEntries: {
                             hydration: Readonly<{
                                 emptyStateText: string;
                                 submitButtonText: string;
+                                demoEmailSuppressed?: boolean;
                             }>;
                         }>) => unknown;
                         decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<{
@@ -1396,6 +1401,7 @@ export declare const runtimeBackedBlockClientEntries: {
                             hydration: Readonly<{
                                 emptyStateText: string;
                                 submitButtonText: string;
+                                demoEmailSuppressed?: boolean;
                             }>;
                         }>>;
                     }>;
@@ -1544,6 +1550,7 @@ export declare const runtimeBackedBlockClientEntries: {
             kind: "client-owned";
             buildRender: (source: Readonly<{
                 siteId?: string;
+                demoEmailSuppressed?: boolean;
                 apiBaseUrl?: string;
                 portalToken?: string | null;
                 previewToken?: string | null;
@@ -1570,9 +1577,11 @@ 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"> & {
+                hydration: Readonly<Omit<import("../nodes/event-registration").EventRegistrationClientProps, "stage" | "siteId" | "className" | "events" | "buttonText"> & {
                     eventSource: import("../nodes/event-registration/eventSourceRecovery").EventRegistrationEventSource;
                 }>;
             }>;
@@ -1580,6 +1589,7 @@ export declare const runtimeBackedBlockClientEntries: {
                 source: Readonly<{
                     encode: (value: Readonly<{
                         siteId?: string;
+                        demoEmailSuppressed?: boolean;
                         apiBaseUrl?: string;
                         portalToken?: string | null;
                         previewToken?: string | null;
@@ -1606,9 +1616,12 @@ 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;
+                        demoEmailSuppressed?: boolean;
                         apiBaseUrl?: string;
                         portalToken?: string | null;
                         previewToken?: string | null;
@@ -1635,18 +1648,20 @@ export declare const runtimeBackedBlockClientEntries: {
                         siteMemberships?: Readonly<{
                             memberships: readonly import("../..").PublicMembershipProduct[];
                         }> | null;
+                        mailingList?: import("../../../../../core/src/index").MailingListRuntimeContext;
+                        siteName?: string;
                     }>>;
                 }>;
                 render: Readonly<{
                     encode: (value: Readonly<{
                         display: import("../nodes/event-registration.interactive").EventRegistrationDisplay;
-                        hydration: Readonly<Omit<import("../nodes/event-registration").EventRegistrationClientProps, "siteId" | "stage" | "className" | "events" | "buttonText"> & {
+                        hydration: Readonly<Omit<import("../nodes/event-registration").EventRegistrationClientProps, "stage" | "siteId" | "className" | "events" | "buttonText"> & {
                             eventSource: import("../nodes/event-registration/eventSourceRecovery").EventRegistrationEventSource;
                         }>;
                     }>) => unknown;
                     decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<{
                         display: import("../nodes/event-registration.interactive").EventRegistrationDisplay;
-                        hydration: Readonly<Omit<import("../nodes/event-registration").EventRegistrationClientProps, "siteId" | "stage" | "className" | "events" | "buttonText"> & {
+                        hydration: Readonly<Omit<import("../nodes/event-registration").EventRegistrationClientProps, "stage" | "siteId" | "className" | "events" | "buttonText"> & {
                             eventSource: import("../nodes/event-registration/eventSourceRecovery").EventRegistrationEventSource;
                         }>;
                     }>>;
@@ -1660,6 +1675,7 @@ export declare const runtimeBackedBlockClientEntries: {
                 kind: "client-owned";
                 buildRender: (source: Readonly<{
                     siteId?: string;
+                    demoEmailSuppressed?: boolean;
                     apiBaseUrl?: string;
                     portalToken?: string | null;
                     previewToken?: string | null;
@@ -1686,9 +1702,11 @@ 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"> & {
+                    hydration: Readonly<Omit<import("../nodes/event-registration").EventRegistrationClientProps, "stage" | "siteId" | "className" | "events" | "buttonText"> & {
                         eventSource: import("../nodes/event-registration/eventSourceRecovery").EventRegistrationEventSource;
                     }>;
                 }>;
@@ -1696,6 +1714,7 @@ export declare const runtimeBackedBlockClientEntries: {
                     source: Readonly<{
                         encode: (value: Readonly<{
                             siteId?: string;
+                            demoEmailSuppressed?: boolean;
                             apiBaseUrl?: string;
                             portalToken?: string | null;
                             previewToken?: string | null;
@@ -1722,9 +1741,12 @@ 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;
+                            demoEmailSuppressed?: boolean;
                             apiBaseUrl?: string;
                             portalToken?: string | null;
                             previewToken?: string | null;
@@ -1751,18 +1773,20 @@ export declare const runtimeBackedBlockClientEntries: {
                             siteMemberships?: Readonly<{
                                 memberships: readonly import("../..").PublicMembershipProduct[];
                             }> | null;
+                            mailingList?: import("../../../../../core/src/index").MailingListRuntimeContext;
+                            siteName?: string;
                         }>>;
                     }>;
                     render: Readonly<{
                         encode: (value: Readonly<{
                             display: import("../nodes/event-registration.interactive").EventRegistrationDisplay;
-                            hydration: Readonly<Omit<import("../nodes/event-registration").EventRegistrationClientProps, "siteId" | "stage" | "className" | "events" | "buttonText"> & {
+                            hydration: Readonly<Omit<import("../nodes/event-registration").EventRegistrationClientProps, "stage" | "siteId" | "className" | "events" | "buttonText"> & {
                                 eventSource: import("../nodes/event-registration/eventSourceRecovery").EventRegistrationEventSource;
                             }>;
                         }>) => unknown;
                         decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<{
                             display: import("../nodes/event-registration.interactive").EventRegistrationDisplay;
-                            hydration: Readonly<Omit<import("../nodes/event-registration").EventRegistrationClientProps, "siteId" | "stage" | "className" | "events" | "buttonText"> & {
+                            hydration: Readonly<Omit<import("../nodes/event-registration").EventRegistrationClientProps, "stage" | "siteId" | "className" | "events" | "buttonText"> & {
                                 eventSource: import("../nodes/event-registration/eventSourceRecovery").EventRegistrationEventSource;
                             }>;
                         }>>;
@@ -1817,6 +1841,7 @@ export declare const runtimeBackedBlockClientEntries: {
                     memberships: readonly import("../..").PublicMembershipProduct[];
                     passPurchaseMode: "add_to_cart" | "buy_now";
                     buttonVariant: import("../../..").BlockButtonRole;
+                    demoEmailSuppressed?: boolean;
                 }>;
             }>;
             contracts: Readonly<{
@@ -1865,6 +1890,7 @@ export declare const runtimeBackedBlockClientEntries: {
                             memberships: readonly import("../..").PublicMembershipProduct[];
                             passPurchaseMode: "add_to_cart" | "buy_now";
                             buttonVariant: import("../../..").BlockButtonRole;
+                            demoEmailSuppressed?: boolean;
                         }>;
                     }>) => unknown;
                     decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<{
@@ -1907,6 +1933,7 @@ export declare const runtimeBackedBlockClientEntries: {
                             memberships: readonly import("../..").PublicMembershipProduct[];
                             passPurchaseMode: "add_to_cart" | "buy_now";
                             buttonVariant: import("../../..").BlockButtonRole;
+                            demoEmailSuppressed?: boolean;
                         }>;
                     }>>;
                 }>;
@@ -1957,6 +1984,7 @@ export declare const runtimeBackedBlockClientEntries: {
                         memberships: readonly import("../..").PublicMembershipProduct[];
                         passPurchaseMode: "add_to_cart" | "buy_now";
                         buttonVariant: import("../../..").BlockButtonRole;
+                        demoEmailSuppressed?: boolean;
                     }>;
                 }>;
                 contracts: Readonly<{
@@ -2005,6 +2033,7 @@ export declare const runtimeBackedBlockClientEntries: {
                                 memberships: readonly import("../..").PublicMembershipProduct[];
                                 passPurchaseMode: "add_to_cart" | "buy_now";
                                 buttonVariant: import("../../..").BlockButtonRole;
+                                demoEmailSuppressed?: boolean;
                             }>;
                         }>) => unknown;
                         decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<{
@@ -2047,6 +2076,7 @@ export declare const runtimeBackedBlockClientEntries: {
                                 memberships: readonly import("../..").PublicMembershipProduct[];
                                 passPurchaseMode: "add_to_cart" | "buy_now";
                                 buttonVariant: import("../../..").BlockButtonRole;
+                                demoEmailSuppressed?: boolean;
                             }>;
                         }>>;
                     }>;

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

@@ -660,6 +660,7 @@ export declare const runtimeBackedBlockServerEntries: {
                 hydration: Readonly<{
                     emptyStateText: string;
                     submitButtonText: string;
+                    demoEmailSuppressed?: boolean;
                 }>;
             }>;
             contracts: Readonly<{
@@ -680,6 +681,7 @@ export declare const runtimeBackedBlockServerEntries: {
                         hydration: Readonly<{
                             emptyStateText: string;
                             submitButtonText: string;
+                            demoEmailSuppressed?: boolean;
                         }>;
                     }>) => unknown;
                     decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<{
@@ -694,6 +696,7 @@ export declare const runtimeBackedBlockServerEntries: {
                         hydration: Readonly<{
                             emptyStateText: string;
                             submitButtonText: string;
+                            demoEmailSuppressed?: boolean;
                         }>;
                     }>>;
                 }>;
@@ -773,6 +776,7 @@ export declare const runtimeBackedBlockServerEntries: {
             kind: "client-owned";
             buildRender: (source: Readonly<{
                 siteId?: string;
+                demoEmailSuppressed?: boolean;
                 apiBaseUrl?: string;
                 portalToken?: string | null;
                 previewToken?: string | null;
@@ -799,9 +803,11 @@ 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"> & {
+                hydration: Readonly<Omit<import("../nodes/event-registration").EventRegistrationClientProps, "stage" | "siteId" | "className" | "events" | "buttonText"> & {
                     eventSource: import("../nodes/event-registration/eventSourceRecovery").EventRegistrationEventSource;
                 }>;
             }>;
@@ -809,6 +815,7 @@ export declare const runtimeBackedBlockServerEntries: {
                 source: Readonly<{
                     encode: (value: Readonly<{
                         siteId?: string;
+                        demoEmailSuppressed?: boolean;
                         apiBaseUrl?: string;
                         portalToken?: string | null;
                         previewToken?: string | null;
@@ -835,9 +842,12 @@ 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;
+                        demoEmailSuppressed?: boolean;
                         apiBaseUrl?: string;
                         portalToken?: string | null;
                         previewToken?: string | null;
@@ -864,18 +874,20 @@ export declare const runtimeBackedBlockServerEntries: {
                         siteMemberships?: Readonly<{
                             memberships: readonly import("../..").PublicMembershipProduct[];
                         }> | null;
+                        mailingList?: import("../../../../../core/src/index").MailingListRuntimeContext;
+                        siteName?: string;
                     }>>;
                 }>;
                 render: Readonly<{
                     encode: (value: Readonly<{
                         display: import("../nodes/event-registration.interactive").EventRegistrationDisplay;
-                        hydration: Readonly<Omit<import("../nodes/event-registration").EventRegistrationClientProps, "siteId" | "stage" | "className" | "events" | "buttonText"> & {
+                        hydration: Readonly<Omit<import("../nodes/event-registration").EventRegistrationClientProps, "stage" | "siteId" | "className" | "events" | "buttonText"> & {
                             eventSource: import("../nodes/event-registration/eventSourceRecovery").EventRegistrationEventSource;
                         }>;
                     }>) => unknown;
                     decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<{
                         display: import("../nodes/event-registration.interactive").EventRegistrationDisplay;
-                        hydration: Readonly<Omit<import("../nodes/event-registration").EventRegistrationClientProps, "siteId" | "stage" | "className" | "events" | "buttonText"> & {
+                        hydration: Readonly<Omit<import("../nodes/event-registration").EventRegistrationClientProps, "stage" | "siteId" | "className" | "events" | "buttonText"> & {
                             eventSource: import("../nodes/event-registration/eventSourceRecovery").EventRegistrationEventSource;
                         }>;
                     }>>;
@@ -928,6 +940,7 @@ export declare const runtimeBackedBlockServerEntries: {
                     memberships: readonly import("../..").PublicMembershipProduct[];
                     passPurchaseMode: "add_to_cart" | "buy_now";
                     buttonVariant: import("../../..").BlockButtonRole;
+                    demoEmailSuppressed?: boolean;
                 }>;
             }>;
             contracts: Readonly<{
@@ -976,6 +989,7 @@ export declare const runtimeBackedBlockServerEntries: {
                             memberships: readonly import("../..").PublicMembershipProduct[];
                             passPurchaseMode: "add_to_cart" | "buy_now";
                             buttonVariant: import("../../..").BlockButtonRole;
+                            demoEmailSuppressed?: boolean;
                         }>;
                     }>) => unknown;
                     decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<{
@@ -1018,6 +1032,7 @@ export declare const runtimeBackedBlockServerEntries: {
                             memberships: readonly import("../..").PublicMembershipProduct[];
                             passPurchaseMode: "add_to_cart" | "buy_now";
                             buttonVariant: import("../../..").BlockButtonRole;
+                            demoEmailSuppressed?: boolean;
                         }>;
                     }>>;
                 }>;

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

@@ -1,13 +1,17 @@
 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";
+import { type BookingPaymentConfirmationSummary } from "../nodes/booking-form.payment-confirmation";
 import { type BookingPaymentSelectionViewModel } from "../shared/bookingPaymentOptions";
 import { createBookingBlockApiConfig, type BookingAppointmentPackagesModel, type BookingFieldValue, type BookingFieldView, type BookingFlowActionResult, type BookingFlowFeedback, type BookingFlowStatus, type BookingFlowView, type BookingResourceView, type BookingFlowStep, type BookingFlowStepId, type BookingSlotSelection, type BookingSlotView, type BookingSubmitActionResult, type BookingSubmitOptions, getBookingServiceSlidingScale, type LoadState } from "./useHeadlessBookingFlow.state";
 export type { BlockApiConfig };
 export type { BookingAppointmentPackagesModel };
 export { createBookingBlockApiConfig };
 export type HeadlessBookingFlowOptions = Readonly<{
+    mailingList?: MailingListRuntimeContext;
+    siteName?: string;
     siteId: string;
     formId: string;
     form: BookingFormConfig | null;
@@ -73,6 +77,7 @@ export type BookingPaymentModel = Readonly<{
     slidingScale: ReturnType<typeof getBookingServiceSlidingScale>;
     appointmentPackages: BookingAppointmentPackagesModel;
     errorMessage: string;
+    confirmationSummary: null;
 }> | Readonly<{
     kind: "ok";
     mode: "hidden" | "disclosure_only" | "choice_required";
@@ -83,6 +88,7 @@ export type BookingPaymentModel = Readonly<{
     selectedSlidingAmount: number | null;
     slidingScale: ReturnType<typeof getBookingServiceSlidingScale>;
     appointmentPackages: BookingAppointmentPackagesModel;
+    confirmationSummary: BookingPaymentConfirmationSummary | null;
 }>;
 export type BookingDiscountModel = Readonly<{
     code: string;
@@ -111,6 +117,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 +138,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/hooks/usePaymentVerification.d.ts

@@ -53,7 +53,8 @@ export type PaymentVerificationDeps = Readonly<{
  * Hook for polling payment status after Stripe redirects.
  *
  * Pass config to start polling, or null to stop/idle.
- * The hook handles cleanup on unmount and config changes.
+ * The hook handles cleanup on unmount and starts a new cycle when the status
+ * reference changes.
  *
  * @param config - Configuration for polling, or null to stop
  * @returns Verification result with status, data, and retry function

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

@@ -4,22 +4,10 @@
  * Provides a reusable polling mechanism with configurable intervals,
  * max attempts, and completion detection. Used by usePaymentVerification
  * and other hooks that need to poll for status changes.
- *
- * @example
- * ```tsx
- * const polling = usePolling(shouldPoll ? {
- *   pollFn: () => api.getStatus(id),
- *   isComplete: (result) => result.status === 'done',
- * } : null);
- *
- * useEffect(() => {
- *   if (polling.status === 'completed') {
- *     handleSuccess(polling.result);
- *   }
- * }, [polling.status]);
- * ```
  */
 export type UsePollingConfig<T> = {
+    /** Stable identifier for the operation being polled. Changing it starts a new cycle. */
+    restartKey: string;
     /** Function to call on each poll - should return the data to check */
     pollFn: () => Promise<T>;
     /** Returns true when polling should stop (success condition) */
@@ -28,8 +16,8 @@ export type UsePollingConfig<T> = {
     isFailed?: (result: T) => boolean;
     /** Max attempts before timeout (default: 10) */
     maxAttempts?: number;
-    /** Interval between polls in ms (default: 1000) */
-    interval?: number;
+    /** Fixed interval or delay selector receiving the one-based attempt number. */
+    interval?: number | ((attempt: number) => number);
 };
 export type UsePollingResult<T> = {
     /** Current polling status */
@@ -42,37 +30,8 @@ export type UsePollingResult<T> = {
     retry: () => void;
 };
 /**
- * Generic hook for polling an async operation until completion.
- *
- * Pass config to start polling, or null to stop/idle.
- * The hook handles cleanup on unmount and config changes.
- *
- * **IMPORTANT: Config identity stability**
- *
- * The config object is used as an effect dependency. If config identity
- * changes on every render (e.g., inline objects), polling will restart
- * continuously, causing infinite request loops.
- *
- * Always memoize the config object:
- *
- * @example
- * ```tsx
- * // BAD - inline object creates new identity every render
- * usePolling({
- *   pollFn: () => api.getStatus(id),
- *   isComplete: (result) => result.status === 'done',
- * });
- *
- * // GOOD - memoized config, stable identity
- * const pollConfig = useMemo(() => shouldPoll ? {
- *   pollFn: () => api.getStatus(id),
- *   isComplete: (result) => result.status === 'done',
- * } : null, [shouldPoll, api, id]);
- *
- * usePolling(pollConfig);
- * ```
- *
- * @param config - Configuration for polling, or null to stop
- * @returns Polling result with status, data, and retry function
+ * Polls until the operation completes, fails, times out, or becomes disabled.
+ * Config objects may be rebuilt across renders; change restartKey to begin a
+ * new operation and reset its attempt budget.
  */
 export declare function usePolling<T>(config: UsePollingConfig<T> | null): UsePollingResult<T>;

package/dist/_dts/blocks/src/system/runtime/nodes/booking-form.checkout-return-context.d.ts

@@ -0,0 +1,7 @@
+import type { BookingMailingListNote } from '../../../../../core/src/index';
+export type AppointmentCheckoutReturnContext = Readonly<{
+    customerEmail: string | null;
+    mailingListNote: BookingMailingListNote | null;
+}>;
+export declare function saveAppointmentCheckoutReturnContext(sessionId: string, context: AppointmentCheckoutReturnContext): void;
+export declare function readAppointmentCheckoutReturnContext(sessionId: string): AppointmentCheckoutReturnContext | null;

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

@@ -0,0 +1,11 @@
+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, customerEmail, demoEmailSuppressed, }: Readonly<{
+    resourceName?: string | null;
+    successMessage?: string | null;
+    redirectState: BookingRedirectState;
+    localNote: BookingSignupNote | null;
+    customerEmail: string | null;
+    demoEmailSuppressed?: boolean;
+}>): 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,19 @@ export type BookingSubmitActionResult = Readonly<{
         kind: "booked";
         appointmentId: string;
         resourceName: string | null;
+        customerEmail: string | null;
+        demoBookingPass?: string;
+        mailingListSignupNote?: BookingSignupNote;
     };
 }> | Readonly<{
     ok: true;
     outcome: {
         kind: "checkout_redirect";
         checkoutUrl: string;
+        sessionId: string;
+        customerEmail: string | null;
+        demoBookingPass?: string;
+        mailingListSignupNote?: BookingSignupNote;
     };
 }> | Exclude<BookingFlowActionResult, Readonly<{
     ok: true;
@@ -170,6 +178,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 +214,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 +516,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,9 @@ export type BookingFormDisplay = Readonly<{
     message: string | null;
 }>;
 export type BookingFormHydration = Readonly<{
+    demoEmailSuppressed?: boolean;
+    mailingList?: MailingListRuntimeContext;
+    siteName?: string;
     formId: string | null;
     serviceId: string | null;
     resourceId: string | null;
@@ -41,8 +45,11 @@ export declare const bookingFormBlockRuntime: Readonly<{
     kind: "client-owned";
     buildRender: (source: Readonly<{
         siteId?: string;
+        demoEmailSuppressed?: boolean;
         apiBaseUrl?: string;
         portalToken?: string | null;
+        mailingList?: MailingListRuntimeContext;
+        siteName?: string;
         formId?: string;
         serviceId?: string | null;
         resourceId?: string | null;
@@ -89,6 +96,9 @@ export declare const bookingFormBlockRuntime: Readonly<{
             message: string | null;
         }>;
         hydration: Readonly<{
+            demoEmailSuppressed?: boolean;
+            mailingList?: MailingListRuntimeContext;
+            siteName?: string;
             formId: string | null;
             serviceId: string | null;
             resourceId: string | null;
@@ -166,8 +176,11 @@ export declare const bookingFormBlockRuntime: Readonly<{
         source: Readonly<{
             encode: (value: Readonly<{
                 siteId?: string;
+                demoEmailSuppressed?: boolean;
                 apiBaseUrl?: string;
                 portalToken?: string | null;
+                mailingList?: MailingListRuntimeContext;
+                siteName?: string;
                 formId?: string;
                 serviceId?: string | null;
                 resourceId?: string | null;
@@ -207,8 +220,11 @@ export declare const bookingFormBlockRuntime: Readonly<{
             }>) => unknown;
             decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<{
                 siteId?: string;
+                demoEmailSuppressed?: boolean;
                 apiBaseUrl?: string;
                 portalToken?: string | null;
+                mailingList?: MailingListRuntimeContext;
+                siteName?: string;
                 formId?: string;
                 serviceId?: string | null;
                 resourceId?: string | null;
@@ -258,6 +274,9 @@ export declare const bookingFormBlockRuntime: Readonly<{
                     message: string | null;
                 }>;
                 hydration: Readonly<{
+                    demoEmailSuppressed?: boolean;
+                    mailingList?: MailingListRuntimeContext;
+                    siteName?: string;
                     formId: string | null;
                     serviceId: string | null;
                     resourceId: string | null;
@@ -341,6 +360,9 @@ export declare const bookingFormBlockRuntime: Readonly<{
                     message: string | null;
                 }>;
                 hydration: Readonly<{
+                    demoEmailSuppressed?: boolean;
+                    mailingList?: MailingListRuntimeContext;
+                    siteName?: string;
                     formId: string | null;
                     serviceId: string | null;
                     resourceId: string | null;
@@ -436,6 +458,9 @@ export declare const bookingFormInteractiveIslandPropsCodec: Readonly<{
                 message: string | null;
             }>;
             hydration: Readonly<{
+                demoEmailSuppressed?: boolean;
+                mailingList?: MailingListRuntimeContext;
+                siteName?: string;
                 formId: string | null;
                 serviceId: string | null;
                 resourceId: string | null;
@@ -528,6 +553,9 @@ export declare const bookingFormInteractiveIslandPropsCodec: Readonly<{
                 message: string | null;
             }>;
             hydration: Readonly<{
+                demoEmailSuppressed?: boolean;
+                mailingList?: MailingListRuntimeContext;
+                siteName?: string;
                 formId: string | null;
                 serviceId: string | null;
                 resourceId: string | null;