@riverbankcms/sdk 0.147.0 → 0.149.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;
@@ -1574,7 +1581,7 @@ export declare const runtimeBackedBlockClientEntries: {
                 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;
                 }>;
             }>;
@@ -1582,6 +1589,7 @@ export declare const runtimeBackedBlockClientEntries: {
                 source: Readonly<{
                     encode: (value: Readonly<{
                         siteId?: string;
+                        demoEmailSuppressed?: boolean;
                         apiBaseUrl?: string;
                         portalToken?: string | null;
                         previewToken?: string | null;
@@ -1613,6 +1621,7 @@ export declare const runtimeBackedBlockClientEntries: {
                     }>) => unknown;
                     decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<{
                         siteId?: string;
+                        demoEmailSuppressed?: boolean;
                         apiBaseUrl?: string;
                         portalToken?: string | null;
                         previewToken?: string | null;
@@ -1646,13 +1655,13 @@ export declare const runtimeBackedBlockClientEntries: {
                 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;
                         }>;
                     }>>;
@@ -1666,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;
@@ -1696,7 +1706,7 @@ export declare const runtimeBackedBlockClientEntries: {
                     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;
                     }>;
                 }>;
@@ -1704,6 +1714,7 @@ export declare const runtimeBackedBlockClientEntries: {
                     source: Readonly<{
                         encode: (value: Readonly<{
                             siteId?: string;
+                            demoEmailSuppressed?: boolean;
                             apiBaseUrl?: string;
                             portalToken?: string | null;
                             previewToken?: string | null;
@@ -1735,6 +1746,7 @@ export declare const runtimeBackedBlockClientEntries: {
                         }>) => unknown;
                         decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<{
                             siteId?: string;
+                            demoEmailSuppressed?: boolean;
                             apiBaseUrl?: string;
                             portalToken?: string | null;
                             previewToken?: string | null;
@@ -1768,13 +1780,13 @@ export declare const runtimeBackedBlockClientEntries: {
                     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;
                             }>;
                         }>>;
@@ -1822,13 +1834,21 @@ export declare const runtimeBackedBlockClientEntries: {
                         description: string | null;
                         priceLabel: string;
                         intervalLabel: string;
-                        actionLabel: string;
+                        action: Readonly<{
+                            kind: "purchase";
+                            label: string;
+                            product: import("../..").PurchasablePublicMembershipProduct;
+                        }> | Readonly<{
+                            kind: "unavailable";
+                            label: string;
+                        }>;
                     }>[];
                 }>;
                 hydration: Readonly<{
                     memberships: readonly import("../..").PublicMembershipProduct[];
                     passPurchaseMode: "add_to_cart" | "buy_now";
                     buttonVariant: import("../../..").BlockButtonRole;
+                    demoEmailSuppressed?: boolean;
                 }>;
             }>;
             contracts: Readonly<{
@@ -1870,13 +1890,21 @@ export declare const runtimeBackedBlockClientEntries: {
                                 description: string | null;
                                 priceLabel: string;
                                 intervalLabel: string;
-                                actionLabel: string;
+                                action: Readonly<{
+                                    kind: "purchase";
+                                    label: string;
+                                    product: import("../..").PurchasablePublicMembershipProduct;
+                                }> | Readonly<{
+                                    kind: "unavailable";
+                                    label: string;
+                                }>;
                             }>[];
                         }>;
                         hydration: Readonly<{
                             memberships: readonly import("../..").PublicMembershipProduct[];
                             passPurchaseMode: "add_to_cart" | "buy_now";
                             buttonVariant: import("../../..").BlockButtonRole;
+                            demoEmailSuppressed?: boolean;
                         }>;
                     }>) => unknown;
                     decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<{
@@ -1912,13 +1940,21 @@ export declare const runtimeBackedBlockClientEntries: {
                                 description: string | null;
                                 priceLabel: string;
                                 intervalLabel: string;
-                                actionLabel: string;
+                                action: Readonly<{
+                                    kind: "purchase";
+                                    label: string;
+                                    product: import("../..").PurchasablePublicMembershipProduct;
+                                }> | Readonly<{
+                                    kind: "unavailable";
+                                    label: string;
+                                }>;
                             }>[];
                         }>;
                         hydration: Readonly<{
                             memberships: readonly import("../..").PublicMembershipProduct[];
                             passPurchaseMode: "add_to_cart" | "buy_now";
                             buttonVariant: import("../../..").BlockButtonRole;
+                            demoEmailSuppressed?: boolean;
                         }>;
                     }>>;
                 }>;
@@ -1962,13 +1998,21 @@ export declare const runtimeBackedBlockClientEntries: {
                             description: string | null;
                             priceLabel: string;
                             intervalLabel: string;
-                            actionLabel: string;
+                            action: Readonly<{
+                                kind: "purchase";
+                                label: string;
+                                product: import("../..").PurchasablePublicMembershipProduct;
+                            }> | Readonly<{
+                                kind: "unavailable";
+                                label: string;
+                            }>;
                         }>[];
                     }>;
                     hydration: Readonly<{
                         memberships: readonly import("../..").PublicMembershipProduct[];
                         passPurchaseMode: "add_to_cart" | "buy_now";
                         buttonVariant: import("../../..").BlockButtonRole;
+                        demoEmailSuppressed?: boolean;
                     }>;
                 }>;
                 contracts: Readonly<{
@@ -2010,13 +2054,21 @@ export declare const runtimeBackedBlockClientEntries: {
                                     description: string | null;
                                     priceLabel: string;
                                     intervalLabel: string;
-                                    actionLabel: string;
+                                    action: Readonly<{
+                                        kind: "purchase";
+                                        label: string;
+                                        product: import("../..").PurchasablePublicMembershipProduct;
+                                    }> | Readonly<{
+                                        kind: "unavailable";
+                                        label: string;
+                                    }>;
                                 }>[];
                             }>;
                             hydration: Readonly<{
                                 memberships: readonly import("../..").PublicMembershipProduct[];
                                 passPurchaseMode: "add_to_cart" | "buy_now";
                                 buttonVariant: import("../../..").BlockButtonRole;
+                                demoEmailSuppressed?: boolean;
                             }>;
                         }>) => unknown;
                         decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<{
@@ -2052,13 +2104,21 @@ export declare const runtimeBackedBlockClientEntries: {
                                     description: string | null;
                                     priceLabel: string;
                                     intervalLabel: string;
-                                    actionLabel: string;
+                                    action: Readonly<{
+                                        kind: "purchase";
+                                        label: string;
+                                        product: import("../..").PurchasablePublicMembershipProduct;
+                                    }> | Readonly<{
+                                        kind: "unavailable";
+                                        label: string;
+                                    }>;
                                 }>[];
                             }>;
                             hydration: Readonly<{
                                 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;
@@ -803,7 +807,7 @@ export declare const runtimeBackedBlockServerEntries: {
                 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;
                 }>;
             }>;
@@ -811,6 +815,7 @@ export declare const runtimeBackedBlockServerEntries: {
                 source: Readonly<{
                     encode: (value: Readonly<{
                         siteId?: string;
+                        demoEmailSuppressed?: boolean;
                         apiBaseUrl?: string;
                         portalToken?: string | null;
                         previewToken?: string | null;
@@ -842,6 +847,7 @@ export declare const runtimeBackedBlockServerEntries: {
                     }>) => unknown;
                     decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<{
                         siteId?: string;
+                        demoEmailSuppressed?: boolean;
                         apiBaseUrl?: string;
                         portalToken?: string | null;
                         previewToken?: string | null;
@@ -875,13 +881,13 @@ export declare const runtimeBackedBlockServerEntries: {
                 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;
                         }>;
                     }>>;
@@ -927,13 +933,21 @@ export declare const runtimeBackedBlockServerEntries: {
                         description: string | null;
                         priceLabel: string;
                         intervalLabel: string;
-                        actionLabel: string;
+                        action: Readonly<{
+                            kind: "purchase";
+                            label: string;
+                            product: import("../..").PurchasablePublicMembershipProduct;
+                        }> | Readonly<{
+                            kind: "unavailable";
+                            label: string;
+                        }>;
                     }>[];
                 }>;
                 hydration: Readonly<{
                     memberships: readonly import("../..").PublicMembershipProduct[];
                     passPurchaseMode: "add_to_cart" | "buy_now";
                     buttonVariant: import("../../..").BlockButtonRole;
+                    demoEmailSuppressed?: boolean;
                 }>;
             }>;
             contracts: Readonly<{
@@ -975,13 +989,21 @@ export declare const runtimeBackedBlockServerEntries: {
                                 description: string | null;
                                 priceLabel: string;
                                 intervalLabel: string;
-                                actionLabel: string;
+                                action: Readonly<{
+                                    kind: "purchase";
+                                    label: string;
+                                    product: import("../..").PurchasablePublicMembershipProduct;
+                                }> | Readonly<{
+                                    kind: "unavailable";
+                                    label: string;
+                                }>;
                             }>[];
                         }>;
                         hydration: Readonly<{
                             memberships: readonly import("../..").PublicMembershipProduct[];
                             passPurchaseMode: "add_to_cart" | "buy_now";
                             buttonVariant: import("../../..").BlockButtonRole;
+                            demoEmailSuppressed?: boolean;
                         }>;
                     }>) => unknown;
                     decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<{
@@ -1017,13 +1039,21 @@ export declare const runtimeBackedBlockServerEntries: {
                                 description: string | null;
                                 priceLabel: string;
                                 intervalLabel: string;
-                                actionLabel: string;
+                                action: Readonly<{
+                                    kind: "purchase";
+                                    label: string;
+                                    product: import("../..").PurchasablePublicMembershipProduct;
+                                }> | Readonly<{
+                                    kind: "unavailable";
+                                    label: string;
+                                }>;
                             }>[];
                         }>;
                         hydration: Readonly<{
                             memberships: readonly import("../..").PublicMembershipProduct[];
                             passPurchaseMode: "add_to_cart" | "buy_now";
                             buttonVariant: import("../../..").BlockButtonRole;
+                            demoEmailSuppressed?: boolean;
                         }>;
                     }>>;
                 }>;

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

@@ -0,0 +1,8 @@
+/**
+ * The moment a booking or registration flow opened, as an ISO timestamp.
+ *
+ * Payment previews take this as their "now" so the pure view-model builders
+ * never read the clock themselves. It's captured once per mount, which keeps
+ * memoised previews stable across renders.
+ */
+export declare function useBookingNowIso(): string;

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

@@ -3,6 +3,7 @@ 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 };
@@ -76,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";
@@ -86,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;

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

@@ -1,9 +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, }: Readonly<{
+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

@@ -137,6 +137,8 @@ export type BookingSubmitActionResult = Readonly<{
         kind: "booked";
         appointmentId: string;
         resourceName: string | null;
+        customerEmail: string | null;
+        demoBookingPass?: string;
         mailingListSignupNote?: BookingSignupNote;
     };
 }> | Readonly<{
@@ -145,6 +147,8 @@ export type BookingSubmitActionResult = Readonly<{
         kind: "checkout_redirect";
         checkoutUrl: string;
         sessionId: string;
+        customerEmail: string | null;
+        demoBookingPass?: string;
         mailingListSignupNote?: BookingSignupNote;
     };
 }> | Exclude<BookingFlowActionResult, Readonly<{

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

@@ -13,6 +13,7 @@ export type BookingFormDisplay = Readonly<{
     message: string | null;
 }>;
 export type BookingFormHydration = Readonly<{
+    demoEmailSuppressed?: boolean;
     mailingList?: MailingListRuntimeContext;
     siteName?: string;
     formId: string | null;
@@ -44,6 +45,7 @@ export declare const bookingFormBlockRuntime: Readonly<{
     kind: "client-owned";
     buildRender: (source: Readonly<{
         siteId?: string;
+        demoEmailSuppressed?: boolean;
         apiBaseUrl?: string;
         portalToken?: string | null;
         mailingList?: MailingListRuntimeContext;
@@ -94,6 +96,7 @@ export declare const bookingFormBlockRuntime: Readonly<{
             message: string | null;
         }>;
         hydration: Readonly<{
+            demoEmailSuppressed?: boolean;
             mailingList?: MailingListRuntimeContext;
             siteName?: string;
             formId: string | null;
@@ -173,6 +176,7 @@ export declare const bookingFormBlockRuntime: Readonly<{
         source: Readonly<{
             encode: (value: Readonly<{
                 siteId?: string;
+                demoEmailSuppressed?: boolean;
                 apiBaseUrl?: string;
                 portalToken?: string | null;
                 mailingList?: MailingListRuntimeContext;
@@ -216,6 +220,7 @@ export declare const bookingFormBlockRuntime: Readonly<{
             }>) => unknown;
             decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<{
                 siteId?: string;
+                demoEmailSuppressed?: boolean;
                 apiBaseUrl?: string;
                 portalToken?: string | null;
                 mailingList?: MailingListRuntimeContext;
@@ -269,6 +274,7 @@ export declare const bookingFormBlockRuntime: Readonly<{
                     message: string | null;
                 }>;
                 hydration: Readonly<{
+                    demoEmailSuppressed?: boolean;
                     mailingList?: MailingListRuntimeContext;
                     siteName?: string;
                     formId: string | null;
@@ -354,6 +360,7 @@ export declare const bookingFormBlockRuntime: Readonly<{
                     message: string | null;
                 }>;
                 hydration: Readonly<{
+                    demoEmailSuppressed?: boolean;
                     mailingList?: MailingListRuntimeContext;
                     siteName?: string;
                     formId: string | null;
@@ -451,6 +458,7 @@ export declare const bookingFormInteractiveIslandPropsCodec: Readonly<{
                 message: string | null;
             }>;
             hydration: Readonly<{
+                demoEmailSuppressed?: boolean;
                 mailingList?: MailingListRuntimeContext;
                 siteName?: string;
                 formId: string | null;
@@ -545,6 +553,7 @@ export declare const bookingFormInteractiveIslandPropsCodec: Readonly<{
                 message: string | null;
             }>;
             hydration: Readonly<{
+                demoEmailSuppressed?: boolean;
                 mailingList?: MailingListRuntimeContext;
                 siteName?: string;
                 formId: string | null;